About the Test Home Page

What is a Website? - -xt website.xml website.xsl - +A website is a collection of pages organized, for the purposes of +navigation, into one or more hierarchies. In Website, each page is a +separate XML document authored according to the Website DTD, a customization +of DocBook. -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. +Website imposes the following additional constraints: - -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. + +Each webpage must have an ID and +the IDs must be unique across the entire website. - -29 Mar 2000 - -Updated description of XSL support. +No page can occur in more than one location in the +navigational hierarchy of the website. Note, however, that you can have +pages, such as the about page, +that don't appear in the navigational hierarchy at all. - -28 Feb 2000 - -Updated to mention XSL. + +

Changes from Website 1.x + +I've completely redesigned the way the Website doctype works for +V2. In version 1, all of the pages in a website were part of a single, +monolithic XML document. + +Making all of the pages part of a single document had a number +of drawbacks: + + +It wasn't convenient to update only part of a website +(only the pages that had been changed, for example). + +For very large websites, there were memory issues associated +with parsing and formatting the whole thing. + +There was no practical way to publish the XML content of +a site. + +It was difficult to share pages across different web sites. + +It was very tedious to setup a system that allowed +the same content to be published +with different navigational hierarchies. + + + +Website overcomes all of these difficulties. + +In fairness, the old style had some advantages: + + +There was only a single source document to maintain. + +Navigation was derived automatically from the structure +of the source document. + +Link checking was cheap and easy. + + +