108 lines
3.7 KiB
Plaintext
108 lines
3.7 KiB
Plaintext
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, <ndw@nwalsh.com>.
|