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

perl 5.8.5 built for x86_64
openjade 1.3.2
jadetex 3.4.5

The PDF version was processed from siddhartha.xml by the following series of command line arguments using Mandrakelinux 10.1:

First, the index was prepared with…

#  perl /usr/bin/ -N -o index.sgml

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

#  perl /usr/bin/ -o index.sgml HTML.index

Second, the document was processed to siddhartha.pdf in a multi-step process with siddhartha.dsl as a local stylesheet…

#  openjade -V tex-backend -t tex -d siddhartha.dsl \
    /usr/share/sgml/xml.dcl \

#  pdftex "&pdfjadetex" siddhartha.tex

#  pdftex "&pdfjadetex" siddhartha.tex

#  pdftex "&pdfjadetex" siddhartha.tex

Processing to siddhartha.html had the command line argument…

#  openjade  \
    -d  /usr/share/sgml/docbook/stylesheet/ \
    dsssl-stylesheets-1.78/html/docbook.dsl \
    /usr/share/sgml/xml.dcl \
    -t sgml siddhartha.xml

Additional Resources for Siddhartha: An Open Source Reader. Archived source files, tarballs, and the Makefile used to construct this book in its HTML and PDF forms are available from

Oriental Philosophy.

Lectures notes and related readings are available at the same site.

Further Information about DocBook. 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


Norman Walsh's published O'Reilly text is useful but outdated, so check the more recent version on the Web at

DocBook: The Definitive Guide.

As additional features are developing, emphasis in DocBook has shifted to the XSL-FO language 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.