[Biojava-l] New Ant target 'docbook'

[Keith James]

Anyone with Ant 1.5+ should now be able to build the DocBook XML docs
into XHTML by typing 'ant docbook'. The build now degrades properly on
Ant 1.3/1.4 without causing it to choke.

To avoid a Catch 22 situation, here's the build
requirements/instructions reproduced from the rendered version:

Obtain the DocBook XML DTD from
http://www.oasis-open.org/committees/docbook/xml/4.2/index.shtml

Obtain the XSL stylesheets from
http://unc.dl.sourceforge.net/sourceforge/docbook/docbook-xsl-1.44.tar.gz

Unpack both of these anywhere you like.

Edit the DOCTYPE of the file doc/biojava-doc-main.xml to point to your
installation of the DocBook XML DTD. The file to reference is
docbookx.dtd

Edit build.xml to point to the same DTD and to the your installation
of the DocBook XSL stylesheets. The file to reference is
xhtml/chunk.xsl

and you're ready.

There are known problems with using certain versions of the DocBook
XSL stylesheets in combination with certain XSLT processors. In
particular, the version of Xalan shipped with JDK 1.4 is known to be
incompatible with DocBook XSL stylesheet versions higher than
1.44. (The latest version at the time of writing is 1.57.0) This
appears to due to the stylesheet exposing bugs in Xalan. I currently
recommend using version 1.44 but will continue to evaluate new
stylesheet releases and revise this advice when appropriate.

BTW, the newer chapters are incomplete as they are being worked on.

-- 

- Keith James <kdj@sanger.ac.uk> bioinformatics programming support -
- Pathogen Sequencing Unit, The Wellcome Trust Sanger Institute, UK -