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