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
directory.
FOP
/lib