README for the DocBook Stylesheets These are XSL stylesheets for the DocBook XML DTD. (They would also work for the DocBook DTD, modulo certain namecase problems and the fact that there aren't (yet) any XSL implementations that work with SGML source documents.) As of version 1.0, most of the elements in DocBook are handled in some way or another, usually reasonably, but there's still lots of work to be done. For more information, see http://docbook.sourceforge.net/ Manifest -------- README this file TODO planned features not yet implemented (may be incomplete :-) BUGS known problems (may also be incomplete :-) VERSION the current version number (note that this is an XSL stylesheet, included by both fo/docbook.xsl and html/docbook.xsl) WhatsNew changes since the last public release (for a complete list of changes, see the ChangeLog file(s)) common/ contains code common to both stylesheets doc/ documentation docsrc/ documentation sources extensions/ Java extensions fo/ stylesheets that produce XSL FO html/ stylesheets that produce HTML htmlhelp/ stylesheets that produce HTML Help images/ images javahelp/ stylesheets that produce Java Help lib/ contains schema-independent functions template/ contains templates for building stylesheet customization layers xhtml/ stylesheets that produce XHTML Changes ------- See the ChangeLog in each directory for additional information about the specific changes. See WhatsNew for changes since the last release. Installation ------------ Unpack the distribution somewhere. Use --- Process your DocBook documents with one of the following stylesheets using your favorite XSLT processor: xhtml/docbook.xsl - for XHTML html/docbook.xsl - for HTML (as a single file) html/chunk.xsl - for HTML (multiple files) fo/docbook.xsl - for XSL FO htmlhelp/htmlhelp.xsl - for HTML Help javahelp/javahelp.xsl - for JavaHelp Copyright --------- Copyright (C) 1999, 2000, 2001, 2002 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. 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 --------------------- These stylesheets are maintained by Norman Walsh, .