Tapestry documentation, including this manual, is also generated using Ant. Documentation source is in DocBook XML format, and uses XSL transformation to generate readable HTML. Tapestry uses Saxon to generate HTML documentation, and FOP to generate PDF documentation.
Download and unpack the Saxon distribution, release 6.5.2 exactly (later versions do not work).
Obtain the latest copies of the two DocBook distributions and place the files in the ext-dist directory. Details are in the file doc/src/common/Readme.html.
Copy saxon.jar into the Ant lib directory.
Update your ANT_OPTS environment variable to add the following two system properties:
-Djavax.xml.parsers.DocumentBuilderFactory=org.apache.crimson.jaxp.DocumentBuilderFactoryImpl
-Djavax.xml.parsers.SAXParserFactory=org.apache.crimson.jaxp.SAXParserFactoryImpl
Download FOP 0.20.4 and unpack into a permanent directory.
Update config/build.properties and add a fop.dir entry, identifying the directory into which you unpacked FOP. Be sure to use an absolute path name, and only forward slashes.
Get a copy of JIMI (an imaging package from Sun, needed by FOP to process PNG image files), and unpack it to temporary directory.
Copy JimiProClasses.zip into the FOP/lib directory.