README for the Website DTD V1.7

Website is an XML DTD for building, er, web sites.

Manifest
--------

README                - This readme file
COPYRIGHT             - Copyright statement
VERSION               - The version number
ChangeLog             - Summary of changes from previous versions
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
xsl/VERSION           - A stylesheet module (used automatically by website.xsl)
xsl/chunk-tabular.xsl - A self-chunking version of tabular.xsl
xsl/chunk-website.xsl - A self-chunking version of website.xsl
xsl/chunk.xml         - A chunk control file for website.xsl
xsl/chunklib.pl       - Perl library code for chunk.pl
xsl/chunktab.xml      - A chunk control file for tabular.xsl
xsl/head.xsl          - A stylesheet module (used automatically by website.xsl)
xsl/hrefencode.pl     - Perl library code for chunk.pl
xsl/tabular.xsl       - A stylesheet for generating two-column, tabular HTML 
xsl/website.xsl       - A stylesheet for generating flat, text-only HTML
xsl/xbel.xsl          - A stylesheet for Python XBEL Bookmarks

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.7//EN"

For example:

  <!DOCTYPE website PUBLIC "-//Norman Walsh//DTD Website V1.7//EN"
                    "http://nwalsh.com/website/xml/1.7/website.dtd" [
  ...
  ]>

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 Norman Walsh

See COPYRIGHT for more information

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, <ndw@nwalsh.com>.

The best way to reach norm is by email.  You will find additional
contact information at http://nwalsh.com/~ndw/contact.html
