About the Test Home Page

From: Norman Walsh Date: Sun, 15 Apr 2001 19:52:27 +0000 (+0000) Subject: Initial checkin of V1.10 sources X-Git-Tag: release/1.79.1~6^2~6608 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=d761aedcd997e05e80a565b92729a047244c7782;p=docbook-dsssl Initial checkin of V1.10 sources --- diff --git a/website/README b/website/README new file mode 100644 index 000000000..3d61b9be3 --- /dev/null +++ b/website/README @@ -0,0 +1,125 @@ +README for the Website DTD V1.10 + +Website is an XML DTD for building, er, web sites. + +Manifest +-------- + +README - This readme file +VERSION - The version number +website.dtd - The DTD, a customization layer on top of DocBook XML +example/ - An example website +xsl/ - XSL stylesheets for converting the Website DTD to HTML + +DTD Installation +---------------- + +Place the files in this distribution somewhere on your machine. Adjust +your catalog(s) if appropriate (XML tools frequently do not support +catalogs, so this may be irrelevant for you). + +Please use the following formal public identifier to identify this DTD: + + "-//Norman Walsh//DTD Website V1.10//EN" + +For example: + + + +XSL Installation +---------------- + +Place the XSL files in this distribution somewhere on your machine. + +Use +--- + +Process your Website documents with one of the following stylesheets +using your favorite XSLT processor: + + website.xsl produces a flat-text website + tabular.xsl produces a tabular website with navigation in the + left-hand column and page contents in the right-hand + column. + + Both of these stylesheets produce a monolithic file that must be + chunked. The chunk control files and libraries included in this + distribution simplify this process, if you are using the chunk.pl + file included in the DocBook XSL Stylesheet distribution. + + chunk-website.xsl produces a flat-text website, chunked by XSLT + chunk-tabular.xsl produces a tabular website, chunked by XSLT + + In order for the chunking process to succeed, all necessary + subdirectories must be created before you begin running the + XSLT engine. The chunking versions support XT, Saxon, and Xalan. + +Copyright +--------- + +Copyright (C) 1999, 2000, 2001 Norman Walsh + +Permission is hereby granted, free of charge, to any person +obtaining a copy of this software and associated documentation +files (the ``Software''), to deal in the Software without +restriction, including without limitation the rights to use, +copy, modify, merge, publish, distribute, sublicense, and/or +sell copies of the Software, and to permit persons to whom the +Software is furnished to do so, subject to the following +conditions: + +The above copyright notice and this permission notice shall be +included in all copies or substantial portions of the Software. + +Except as contained in this notice, the names of individuals +credited with contribution to this software shall not be used in +advertising or otherwise to promote the sale, use or other +dealings in this Software without prior written authorization +from the individuals in question. + +Any stylesheet derived from this Software that is publically +distributed will be identified with a different name and the +version strings in any derived Software will be changed so that +no possibility of confusion between the derived package and this +Software will exist. + +You may distribute this software under the same terms as DocBook. +This software is a customization of the DocBook XML V4.1.2, which +is governed by the following copyright: + + [DocBook is] Copyright 1992, 1993, 1994, 1995, 1996, 1998, + 1999 HaL Computer Systems, Inc., O'Reilly & Associates, Inc., + ArborText, Inc., Fujitsu Software Corporation, and the + Organization for the Advancement of Structured Information + Standards (OASIS). + + Permission to use, copy, modify and distribute the DocBook + DTD and its accompanying documentation for any purpose and + without fee is hereby granted in perpetuity, provided that + the above copyright notice and this paragraph appear in all + copies. The copyright holders make no representation about + the suitability of the DTD for any purpose. It is provided + "as is" without expressed or implied warranty. + +For more information about the DocBook DTD, see +http://www.oasis-open.org/docbook/ + +Warranty +-------- + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES +OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND +NONINFRINGEMENT. IN NO EVENT SHALL NORMAN WALSH OR ANY OTHER +CONTRIBUTOR BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, +WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING +FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR +OTHER DEALINGS IN THE SOFTWARE. + +Contacting the Author +--------------------- + +This DTD is maintained by Norman Walsh, . diff --git a/website/VERSION b/website/VERSION new file mode 100644 index 000000000..c044b1a32 --- /dev/null +++ b/website/VERSION @@ -0,0 +1 @@ +1.10 diff --git a/website/example/Makefile b/website/example/Makefile new file mode 100644 index 000000000..032b7a483 --- /dev/null +++ b/website/example/Makefile @@ -0,0 +1,26 @@ +PROC=saxon +PROCOPT= + +.PHONY : clean + +all: test + +test: + xjparse website.xml +ifeq ($(PROC),xt) + $(PROC) $(PROCOPT) website.xml ../xsl/xtchunk-website.xsl +else + $(PROC) $(PROCOPT) website.xml ../xsl/chunk-website.xsl +endif + +tabular: + xnsgmls -sv -c /share/doctypes/catalog website.xml +ifeq ($(PROC),xt) + $(PROC) $(PROCOPT) website.xml ../xsl/xtchunk-tabular.xsl +else + $(PROC) $(PROCOPT) website.xml ../xsl/chunk-tabular.xsl +endif + +clean: + rm -f *.html subdir/*.html + diff --git a/website/example/about.xml b/website/example/about.xml new file mode 100644 index 000000000..8237b8070 --- /dev/null +++ b/website/example/about.xml @@ -0,0 +1,40 @@ + + + +About the Test Home Page +

+ +This collection of pages is built from a single SGML +document using +Jade and a +customization of the DSSSL +DocBook Stylesheet +for HTML. + +Why? +There are a number of compelling reasons to maintain these pages in +SGML rather than HTML. + +First and foremost, they provide a test environment for the +HTML stylesheet. Ok, maybe that's not compelling to you, but it's compelling +to me ;-). + +Traditional printed documents are desirable for several of +these pages. +Using a more structurally rich format to represent the documents makes +it possible to produce print as well as online versions. + +All of the intra-document linking is automatic. +The SGML system provides validation for the inra-document links, so +there is no danger of broken links. (Links to external pages still have to +be validated by an external program.) + +Migrating these pages to XML and/or future versions of HTML +will only require a new or updated style sheet. No pages will have to be recoded. +And the pages will conform to whatever output format is required, with no +possibility of random human error. + + + + + diff --git a/website/example/bookmark/bookmark.xml b/website/example/bookmark/bookmark.xml new file mode 100644 index 000000000..fa5ab16ba --- /dev/null +++ b/website/example/bookmark/bookmark.xml @@ -0,0 +1,12 @@ + + + +Perl +Perl.com +ActiveState Tool Corp. (Perl +for Win32) +dada meets Perl! + + diff --git a/website/example/bookmark/catalog b/website/example/bookmark/catalog new file mode 100644 index 000000000..1711f382e --- /dev/null +++ b/website/example/bookmark/catalog @@ -0,0 +1 @@ +SGMLDECL xml.dcl diff --git a/website/example/bookmark/xml.dcl b/website/example/bookmark/xml.dcl new file mode 100644 index 000000000..fed210309 --- /dev/null +++ b/website/example/bookmark/xml.dcl @@ -0,0 +1,179 @@ +" + PIC "?>" + SHORTREF NONE + + NAMES + SGMLREF + + QUANTITY NONE + + ENTITIES + "amp" 38 + "lt" 60 + "gt" 62 + "quot" 34 + "apos" 39 + + FEATURES + MINIMIZE + DATATAG NO + OMITTAG NO + RANK NO + SHORTTAG + STARTTAG + EMPTY NO + UNCLOSED NO + NETENABL IMMEDNET + ENDTAG + EMPTY NO + UNCLOSED NO + ATTRIB + DEFAULT YES + OMITNAME NO + VALUE NO + EMPTYNRM YES + IMPLYDEF + ATTLIST NO + DOCTYPE NO + ELEMENT NO + ENTITY NO + NOTATION NO + LINK + SIMPLE NO + IMPLICIT NO + EXPLICIT NO + OTHER + CONCUR NO + SUBDOC NO + FORMAL NO + URN NO + KEEPRSRE YES + VALIDITY TYPE + ENTITIES + REF ANY + INTEGRAL YES + APPINFO NONE + SEEALSO "ISO 8879:1986//NOTATION + Extensible Markup Language (XML) 1.0//EN" +> diff --git a/website/example/dynxbel.js b/website/example/dynxbel.js new file mode 100644 index 000000000..a23f68545 --- /dev/null +++ b/website/example/dynxbel.js @@ -0,0 +1,8 @@ +function toggleList(list) { + var display = eval("document.all." + list + ".style.display"); + if (display == "none") { + eval("document.all." + list + ".style.display = \"\""); + } else { + eval("document.all." + list + ".style.display = \"none\""); + } +} diff --git a/website/example/example.css b/website/example/example.css new file mode 100644 index 000000000..9a1430da3 --- /dev/null +++ b/website/example/example.css @@ -0,0 +1,46 @@ +.navhomehead { padding-top: 0; + margin-bottom: 0; + padding-bottom: 0; + font-size: 80% + } + +.navhomehead { color: black; } +.navhomehead a:link { color: black; } +.navhomehead a:visited { color: black; } + +.navhead { padding-top: 0; + margin-bottom: 0; + padding-bottom: 0; + font-size: 80% + } + +.navhead { color: black; } +.navhead a:link { color: black; } +.navhead a:visited { color: black; } + +.navfoot { color: black; + font-size: 70%; + } + +.navfoot a:link { color: black; } +.navfoot a:visited { color: black; } + +span.footdate { color: black; + font-size: 70%; + font-family: Arial, sans-serif; + } + +span.foothome { color: black; + font-size: 70%; + font-family: Arial, sans-serif; + } + +span.footfeed { color: black; + font-size: 70%; + font-family: Arial, sans-serif; + } + +span.footcopy { color: black; + font-size: 70%; + font-family: Arial, sans-serif; + } diff --git a/website/example/graphics/banner.png b/website/example/graphics/banner.png new file mode 100644 index 000000000..4772bd558 Binary files /dev/null and b/website/example/graphics/banner.png differ diff --git a/website/example/graphics/homebanner.png b/website/example/graphics/homebanner.png new file mode 100644 index 000000000..78fb18091 Binary files /dev/null and b/website/example/graphics/homebanner.png differ diff --git a/website/example/graphics/icons/iconat.gif b/website/example/graphics/icons/iconat.gif new file mode 100644 index 000000000..87659b0fc Binary files /dev/null and b/website/example/graphics/icons/iconat.gif differ diff --git a/website/example/graphics/icons/iconhome.gif b/website/example/graphics/icons/iconhome.gif new file mode 100644 index 000000000..d8ac11993 Binary files /dev/null and b/website/example/graphics/icons/iconhome.gif differ diff --git a/website/example/graphics/icons/iconsmallrightarrow.gif b/website/example/graphics/icons/iconsmallrightarrow.gif new file mode 100644 index 000000000..7f930f9eb Binary files /dev/null and b/website/example/graphics/icons/iconsmallrightarrow.gif differ diff --git a/website/example/subdir/.cvskeepemptydir b/website/example/subdir/.cvskeepemptydir new file mode 100644 index 000000000..e69de29bb diff --git a/website/example/test1.xml b/website/example/test1.xml new file mode 100644 index 000000000..e6dc353a7 --- /dev/null +++ b/website/example/test1.xml @@ -0,0 +1,13 @@ + + + +Test 1 +

Test 1 Page

+ +This is just a test page. + + +&test1a; +&test1b; + + diff --git a/website/example/test1a.xml b/website/example/test1a.xml new file mode 100644 index 000000000..bf4237fce --- /dev/null +++ b/website/example/test1a.xml @@ -0,0 +1,16 @@ + + + + + +Test 1a +

Test 1a Page

+ +This is just a test page. + +But it contains a broken inlinegraphic: +. + + + + diff --git a/website/example/test1b.xml b/website/example/test1b.xml new file mode 100644 index 000000000..c0b6dc9cf --- /dev/null +++ b/website/example/test1b.xml @@ -0,0 +1,11 @@ + + + + + +Test 1b +

Test 1b Page

+ +This is just a test page. + + diff --git a/website/example/test2.xml b/website/example/test2.xml new file mode 100644 index 000000000..f289841d7 --- /dev/null +++ b/website/example/test2.xml @@ -0,0 +1,21 @@ + + + +Form Test +

Form Test Page

+ +This is just a form test page. + +An input field: . +A label: label. +A button: This Button. +Selection: +foo +bar +baz +. + +. + + + diff --git a/website/example/test3.xml b/website/example/test3.xml new file mode 100644 index 000000000..3f4b28c21 --- /dev/null +++ b/website/example/test3.xml @@ -0,0 +1,23 @@ + + + +XBEL Bookmarks +

XBEL Bookmark test

+ +This test page demonstrates how to incorporate XBEL bookmarks into +your web pages. Use an xlink as follows: + + +]]> + + + + +You can use dynamic HTML for your bookmarks, if you specify +role="dynamic" on the xlink: + + + + + diff --git a/website/example/website.xml b/website/example/website.xml new file mode 100644 index 000000000..585740002 --- /dev/null +++ b/website/example/website.xml @@ -0,0 +1,159 @@ + + + + + + +]> + + + + + + + + + +Test Home Page +

The Test Site

+Norman Walsh, DSSSL, SGML, XML, DocBook, Website +19992000 +Norman Walsh + + + +Hello, and Welcome! + + +This website demonstrates the Website DTD. In order to generate HTML +web pages from documents using this DTD, you must format them with +an XSLT processor (well, you could do it with any tool you wanted, +I suppose, but XSLT is the popular choice :-). + + + + +XSLT +To format this website using XSLT, use +the website.xsl +or tabular.xsl stylesheets from the +Website distribution: + + +xt website.xml website.xsl + + +You must chunk the resulting document yourself. The XSL stylesheet +distribution includes a chunking configuration file suitable for use +with chunk.pl from the +DocBook stylesheet +distribution. + + +XSLT With Chunking + +Alternatively, you can use chunk-website.xsl +or chunk-tabular.xsl and let the XSLT +processor do the chunking for you. + +The XT, Saxon, and Xalan processors are supported by the chunking +stylesheets. If you're using a alternate processor, you'll have to do +the chunking with another tool. + + + +Customizing the Stylesheets + +You can customize the stylesheets for your particular website +by making a driver like this: + + + + + + + +]]> + +If you use the tabular processors, you'll discover that the +Website home page has two ugly features: "home.navhead" and +"home.navhead.upperright". + +In order to remove these, you have to write a custom stylesheet +that puts the text you want on the homepage in those locations. Your +stylesheet should look like this: + + + + + + + + + + +home.navhead + + + +home.navhead.upperright + + + +]]> + +You will also want to change some of the <config> +parameters (to select different banner graphics, etc.). + + + + +What's New + +24 Aug 2000 + +Improved documentation, merged distribution of stylesheets +and the DTD. + + +29 Mar 2000 + +Updated description of XSL support. + + +28 Feb 2000 + +Updated to mention XSL. + + +24 Feb 1999 + +First release. + + + + + + +&about; + + + +&test1; +&test2; +&test3; + + + + diff --git a/website/forms.mod b/website/forms.mod new file mode 100644 index 000000000..6cd3cca88 --- /dev/null +++ b/website/forms.mod @@ -0,0 +1,129 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/website/website.dtd b/website/website.dtd new file mode 100644 index 000000000..038301bd1 --- /dev/null +++ b/website/website.dtd @@ -0,0 +1,106 @@ + + + + + + + + + + + + +]]> + + +%docbook; + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +%forms.mod; +]]> + + + diff --git a/website/xsl/VERSION b/website/xsl/VERSION new file mode 100644 index 000000000..c5b729079 --- /dev/null +++ b/website/xsl/VERSION @@ -0,0 +1,5 @@ + + +1.7 + diff --git a/website/xsl/chunk-tabular.xsl b/website/xsl/chunk-tabular.xsl new file mode 100644 index 000000000..a93d499ce --- /dev/null +++ b/website/xsl/chunk-tabular.xsl @@ -0,0 +1,268 @@ + + + + + + + + + + + + +0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

+ + + + + +		+ +	+ +
		+ +
		+ + +
	+ +

+ + + + +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

+ + + + + + + + + + + + + +

+ + + +

+ + + +
+

+ + +

+ + + + + + + + + + + + + + + + + + + + + + + + / + + + + + + + + + + index.html + + + + + + + + + + + + 1 + 0 + + + + + + + + + + # + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/website/xsl/chunk-website-common.xsl b/website/xsl/chunk-website-common.xsl new file mode 100644 index 000000000..a738c9cc7 --- /dev/null +++ b/website/xsl/chunk-website-common.xsl @@ -0,0 +1,197 @@ + + + + + + + + + + + +0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

+ + + + + + + + + + + +

+ + + + + + + + + + + + + + + + +

+ + + + + + + + + + + + + + + + + +

+ + + + + + + + + + + +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

+ + + + + +		+ +	+ +
		+ +
		+ + +
	+ +

+ + + + +

+ + + + + + + + + + + + + +

+ + + + + + + + + + + + + + + + +

+ + + +

+ + + +
+

+ + +

+ + + + + + + + + + + + + + + + + + + + + + {$homebanneralt}

+
+
+ + + + + + + + +

+ +
+
+ + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + shrink + + + + + + + + + + + + + + + + + {$toc.pointer.text}

+ + + + + + + +
+ + + + + + navtoc + + + ynavtoc + + + + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + + + + + + 0 + + + + + + + + + + 1 + + + + + + + 0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/website/xsl/website.xsl b/website/xsl/website.xsl new file mode 100644 index 000000000..f034fdaaf --- /dev/null +++ b/website/xsl/website.xsl @@ -0,0 +1,658 @@ + + + + + + + + + + + + +1 + + + + + + + + + + + +Toggle <HR> before footer + +If non-zero, an <HR> is generated at the bottom of each web page, +before the footer. + + + + + + + + +HREF for feedback link + +The feedback.href value is used as the value +for the href attribute on the feedback +link, if it is not the empty string. If feedback.href +is empty, no feedback link is generated. + + + + + + +Toggle use of titles in feedback + +If feedback.title is non-zero, the title of the +current page will be added to the feedback link. This can be used, for +example, if the feedback.href is a CGI script. + + + +Feedback + + +The text of the feedback link + +The contents of this variable is used as the text of the feedback +link if feedback.href is not empty. If +feedback.href is empty, no feedback link is +generated. + + + + + + + + + + + note.gif + warning.gif + caution.gif + tip.gif + important.gif + note.gif + + + + +Select appropriate admonition graphic + +Selects the appropriate admonition graphic file and returns the +fully qualified path to it. + + + +node + +The source node to use for the purpose of selection. It should +be one of the admonition elements (note, +warning, etc.). The default node is the context +node. + + + + + +The fully qualified path to the admonition graphic. If the +node is not an admonition element, the + note graphic is returned. + + + + + + + + + nothing matters here since the chunker reworks the head + + + + + + + + + + + + + + + + +

+ +

+ + + + + + + +

+ + + + + + + + + + + + + + +

+ + + +

+ +

+ + + + + + + + + + + + + + +

+ + + + + + + + + + - + + + + + + + + + + + + + + + + + + + + + + @ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

+ + + + + + + + + +

+ +	+ + + + + + + + + + + + + Home + + + + +	+ + + + + + + + + + + + + + + + + + + + +
+ + + +

+ + + + + | +

+ + + + + + + + + + + copyright + + + + + + + + + + + , + + + + + + + + + + + + + + + + + + + + + + + + + + + + filename=" + + / + + " + + + + + filename=" + + " + + + + + + + + + + + + +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ../ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

+ +

+ + + + + + + + + + + + + +

+ + + + + + + + + + - + + +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

+ +

+ + + + + + + + + + + + + + + + + + + + +

+ + +

+ + + + + + + + + + </p> + + <p> + + + + + + + + + + + + + + + + + + diff --git a/website/xsl/xbel.xsl b/website/xsl/xbel.xsl new file mode 100644 index 000000000..c8259c58c --- /dev/null +++ b/website/xsl/xbel.xsl @@ -0,0 +1,107 @@ + + + + + + + + + + + + +

+ + + + + + +

+ + + + + + + +

+ + + +

+ + + + + + + + + +

+ + + + + + +

+ + + + + + + + + + toggleList(' + + ') + + exlist + color: blue + + + + + + + + + + + +

+ + + +

+ + + + + + + + + diff --git a/website/xsl/xtchunk-tabular.xsl b/website/xsl/xtchunk-tabular.xsl new file mode 100644 index 000000000..c0b013ab2 --- /dev/null +++ b/website/xsl/xtchunk-tabular.xsl @@ -0,0 +1,268 @@ + + + + + + + + + + + + +0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

+ + + + + +		+ +	+ +
		+ +
		+ + +
	+ +

+ + + + +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

+ + + + + + + + + + + + + +

+ + + +

+ + + +
+

+ + +

+ + + + + + + + + + + + + + + + + + + + + + + + / + + + + + + + + + + index.html + + + + + + + + + + + + 1 + 0 + + + + + + + + + + # + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/website/xsl/xtchunk-website.xsl b/website/xsl/xtchunk-website.xsl new file mode 100644 index 000000000..3e8090ae0 --- /dev/null +++ b/website/xsl/xtchunk-website.xsl @@ -0,0 +1,19 @@ + + + + + + + + + + +