DocBook. This publication is based on Open Source DocBook, a system of writing structured documents using SGML or XML in a presentation-neutral form using free programs. The functionality of DocBook is such that the same file can be published on the Web, printed as a standalone report, reprinted as part of a journal, processed into an audio file, changed into Braille, or converted to most other media types. More information about DocBook can be found at DocBook Open Repository.

Commands Used in Preparation. This book was prepared with

openjade 1.3.2
TeX 3.14159

The PDF version was generated from reader.xml to reader.pdf by the following series of command line arguments using Mandrake Linux 9.2:

First, the index was prepared with…

# -N -o index.xml
#  openjade -t sgml \
	-d /usr/share/sgml/docbook/dsssl-stylesheets/\
html/docbook.dsl -V html-index \
decls/xml.dcl \
# -o index.xml HTML.index

The xml.dcl file is used as a preamble to the actual xml document. Perhaps, in future, jade will have a "-t xml" option that would map to "-t sgml" internally and add the xml.dcl declaration implicitly.

Second, the document was processed to reader.pdf (where eastern.dsl is a local stylesheet) with a multi-step process…

#  openjade -V tex-backend -t tex -d eastern.dsl  \
dtds/decls/xml.dcl  \
#  pdftex "&pdfjadetex" reader.tex
#  pdftex "&pdfjadetex" reader.tex
#  pdftex "&pdfjadetex" reader.tex

Processing to reader.html had the command line argument…

#  openjade  \
    -d  /usr/share/sgml/docbook/dsssl-stylesheets/html/\
docbook.dsl \
decls/xml.dcl \
    -t sgml reader.xml

Stylesheets, formatting, and help are available with the docbook-apps mailing list and Norman Walsh's DocBook: The Definitive Guide published by O'Reilly. DocBook XML is available at OASIS—XML. Norman Walsh's text is a bit outdated, so check the more recent version on the Web at DocBook: The Definitive Guide.

As additional features are developing, emphasis in DocBook is shifting to using the XSL-FO language to create PDF from XML, instead of the process used here. See Dave Pawson's XSL-FO, Sebastopol, CA: O'Reilly, 2002, and Bob Stayton's DocBook XSL: The Complete Guide, Santa Cruz, CA: Sagehill, 2003.