2. Download the Packages

2.1. OpenJade

OpenJade is an actively maintained open-source software project based on the Jade package by James Clark. Download the lastest stable release (1.3?) at:

http://openjade.sourceforge.net/

OpenJade also includes the OpenSP package and the TeX macros, jadetex and pdfjadetex for converting files to dvi and pdf. The following programs are provided by this package:

• openjade

• onsgmls

• osgmlnorm

• ospam

• ospent

• osx

To use jadetex and pdfjadetex for making dvi, ps, and pdf, you must have a working TeX (tex) installation. If you do not have TeX, check with your Linux distribution for a binary package that can be downloaded and installed. Otherwise, you can download the teTeX distribution of TeX from:

http://www.tug.org/tetex/

2.2. DocBook SGML DTD

The DocBook DTD for SGML and XML are maintained by a technical committee at Oasis-Open.ORG. Download the current version (and any old versions you might need) of DocBook SGML at:

http://www.oasis-open.org/docbook/sgml/index.html

2.3. ISO8879 ENTITY SGML

The entities define representations for special or untypeable symbols or characters, including mathematical symbols, and the entities that you may be familiar with from HTML. These entity files need to be installed for a proper configuration.

• Resources at OASIS:

  • http://www.oasis-open.org/cover/topics.html#entities

  • http://www.oasis-open.org/cover/ISOEnts.zip

  • http://www.oasis-open.org/cover/isoENT-tar.gz

ISOEnts.zip can simply be unzipped into the directory where the DocBook DTD is unzipped without requiring anything else but the files in isoENT-tar.gz are also needed. Again, the files in isoENT-tar.gz are to be unzipped into the DocBook DTD directory (see next section on installing for details), but the filenames end with ".ent" suffix. These will need to be renamed to a ".gml" ending. You can do this manually, or you can download and use the file below, made by this author, which contains the files of both ISOEnts.zip and isoENT-tar.gz:

http://www.comptechnews.com/~reaster/iso8879-entities.tar.gz

2.4. DocBook DSSSL

The Document Style Semantics and Specification Language (DSSSL) files for the DocBook DTD (SGML/XML) is provided by Norm Walsh. These files, called the Modular DocBook Stylesheets, tell openjade what to do when converting your DocBook SGML file into other formats. A dsl file specifies things such as the mappings from one DTD's tags to another DTD's tags and other programmatic conversions, programmed in a language called the Core Expression Language which is derived from Scheme. The DocBook DSSSL package and documentation can be downloaded from Norm Walsh:

http://nwalsh.com/docbook/dsssl/

The Linux Documentation Project has a stylesheet customization file that turns on some nice style features. It can be downloaded at:

http://www.linuxdoc.org/authors/tools/ldp.dsl

2.5. Sgmltools-lite

Sgmltools is a frontend for openjade, jadetex, pdfjadex, dvips, and other programs. It provides a single command for generating all the formats possible with these tools. The lastest release, v1.3 as of writing, can be downloaded at:

http://www.sgmltools.org/

http://sourceforge.net/projects/sgmltools-lite/

This package is optional, but does make things easier sometimes.

2.6. HTMLdoc

Htmldoc is a free program for converting websites into Portable Document Format (pdf) or Postscript (ps). For pdf, it creates a tree of bookmarks that make navigation easy. Both htmldoc and pdfjadetex output pdf files, but in slightly different formats. Try both and see which turns out best for a particular docbook file. See quick links below for download site.

2.7. DocBook2X

DocBook2X requires perl5 and the SGMLS.pm perl module, available at CPAN. SGMLS.pm provides libraries and a program called sgmlspl which translates DocBook files into other formats by using specification files. The specification files are perl files that provide the logic for the translation to a particular format.

http://www.cpan.org/

http://docbook2x.sourceforge.net/

2.8. Quick Download Links

The files below are the latest versions as of this writing: