1
README for the DocBook Stylesheets
3
These are XSL stylesheets for the DocBook XML DTD. (They would
4
also work for the DocBook DTD, modulo certain namecase problems
5
and the fact that there aren't (yet) any XSL implementations
6
that work with SGML source documents.)
8
As of version 1.0, most of the elements in DocBook are handled
9
in some way or another, usually reasonably, but there's still
10
lots of work to be done.
12
For more information, see http://docbook.sourceforge.net/
18
TODO planned features not yet implemented (may be incomplete :-)
19
BUGS known problems (may also be incomplete :-)
20
VERSION the current version number (note that this is an XSL stylesheet,
21
included by both fo/docbook.xsl and html/docbook.xsl)
22
WhatsNew changes since the last public release (for a complete list
23
of changes, see the ChangeLog file(s))
24
common/ contains code common to both stylesheets
26
docsrc/ documentation sources
27
extensions/ Java extensions
28
fo/ stylesheets that produce XSL FO
29
html/ stylesheets that produce HTML
30
htmlhelp/ stylesheets that produce HTML Help
32
javahelp/ stylesheets that produce Java Help
33
lib/ contains schema-independent functions
34
template/ contains templates for building stylesheet customization layers
35
xhtml/ stylesheets that produce XHTML
40
See the ChangeLog in each directory for additional information
41
about the specific changes.
43
See WhatsNew for changes since the last release.
48
Unpack the distribution somewhere.
53
Process your DocBook documents with one of the following stylesheets
54
using your favorite XSLT processor:
56
xhtml/docbook.xsl produces an XHTML result tree
57
html/docbook.xsl produces an HTML result tree
58
fo/docbook.xsl produces an FO result tree
63
Copyright (C) 1999, 2000, 2001 Norman Walsh
65
Permission is hereby granted, free of charge, to any person
66
obtaining a copy of this software and associated documentation
67
files (the ``Software''), to deal in the Software without
68
restriction, including without limitation the rights to use,
69
copy, modify, merge, publish, distribute, sublicense, and/or
70
sell copies of the Software, and to permit persons to whom the
71
Software is furnished to do so, subject to the following
74
The above copyright notice and this permission notice shall be
75
included in all copies or substantial portions of the Software.
77
Except as contained in this notice, the names of individuals
78
credited with contribution to this software shall not be used in
79
advertising or otherwise to promote the sale, use or other
80
dealings in this Software without prior written authorization
81
from the individuals in question.
83
Any stylesheet derived from this Software that is publically
84
distributed will be identified with a different name and the
85
version strings in any derived Software will be changed so that
86
no possibility of confusion between the derived package and this
92
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
93
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
94
OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
95
NONINFRINGEMENT. IN NO EVENT SHALL NORMAN WALSH OR ANY OTHER
96
CONTRIBUTOR BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
97
WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
98
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
99
OTHER DEALINGS IN THE SOFTWARE.
101
Contacting the Author
102
---------------------
104
These stylesheets are maintained by Norman Walsh, <ndw@nwalsh.com>.