Colophon

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 open source 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.[1]

Commands Used in Preparation. This book was prepared with

openjade 1.3.2
TeX 3.14159

The PDF version was generated from artbook.xml to artbook.pdf by the following series of command-line arguments using Mandrake Linux 10.1 (64 bit Community):

First, the index was prepared with…



#  collateindex.pl -N -o index.xml


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


#  collateindex.pl -o index.xml HTML.index

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



#  openjade -V tex-backend -t tex -d artbook.dsl\
	/usr/share/sgml/docbook/dsssl-stylesheets/\
	dtds/decls/xml.dcl \
	artbook.xml


#  pdftex "&pdfjadetex" artbook.tex


#  pdftex "&pdfjadetex" artbook.tex


#  pdftex "&pdfjadetex" introbook.tex

Processing to artbook.html had the command line argument…



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

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

As additional features are developing, emphasis in DocBook has shifted 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, 3rd. Ed. Santa Cruz, CA: Sagehill. 2005.[5]

Notes

[1]

DocBook Open Repository

[2]

docbook-apps

[3]

DocBook: The Definitive Guide

[4]

OASIS—XML

[5]

DocBook XSL, 3rd Ed.