|Hermann Hesse's Siddhartha: An Open Source Reader|
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|
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/collateindex.pl -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 \ siddhartha.xml # perl /usr/bin/collateindex.pl -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 \ siddhartha.xml # 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
Lectures notes and related readings are available at the same site.
Further Information about DocBook. Stylesheets, formatting, and help are available with the
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
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.