Re: [docbook-apps] ANT script

[Oliver Horn <oliver.horn@gmx.net>]

Hi!

Dave Pawson has documented how to use Ant 1.5 with DocBook [1].

Since Ant 1.6 it is possible to use directly the XML catalog resolver 
library [2,3] from xml-commons.

However, using Ant for XSLT processing causes a lot of classloader 
problems, in particular if you want to use a specific XSLT processor or 
some extension libraries.  Have a look at the Ant 1.6 xmlcatalog 
documentation [3] and the FAQ entry "<style> or <junit> ignores my 
<classpath>" [4]:

a) XML catalog resolver library must be on the (system) classpath
b) SAXON (or your XSLT processor of choice) must be on the same 
classpath as the Ant TraX liasion (lib/ant-trax.jar)
c) Extension libraries for XSLT processing must be on the same classpath 
as the XSLT processor

I think the easiest way is to put all those libraries on the system 
classpath.

However, I use a slight different approach: I've set up a minimal Ant 
1.6 environment (only ant.jar, ant-nodeps.jar, ant-launcher.jar and 
resolver.jar on the system classpath) and load all other libraries 
(ant-trax.jar, SAXON and various DocBook XSL extension jars) at run-time 
by the Ant buildfile.  This works fine, too.

Regards
Oliver

[1] http://www.dpawson.co.uk/docbook/ant.html
[2] http://www.apache.org/dist/xml/commons/xml-commons-resolver-1.1.zip
[3] http://ant.apache.org/manual/CoreTypes/xmlcatalog.html
[4] http://ant.apache.org/faq.html#delegating-classloader