Ant4docbook let you process docbook step by step to debug errors :
- docbook to xml, to process xinclude
- docbook to fo
- fo to pdf
Example :
<project name="docbook-debugging" default="debug-pdf"><taskdef name="dbk"classname="net.sourceforge.ant4docbook.taskdefs.DocbookTask"classpath="PATH/TO/ant4docbook.jar"/><target name="validate-dtd-or-not"><property name="ant4docbook.dtd.validating" value="true*|false"/><dbk file="docbook.xml" tofile="docbook.xinclude.xml" /></target><target name="debug-pdf"><dbk file="docbook.xml" tofile="docbook.xinclude.xml" /><dbk file="docbook.xinclude.xml" tofile="docbook.fo" /><dbk file="docbook.fo" tofile="docbook.pdf" /></target><target name="debug-html"><dbk file="docbook.xml" tofile="docbook.xinclude.xml" /><dbk file="docbook.xinclude.xml" tofile="docbook.html" /></target><target name="debug-with-your-xsl-stylesheet"><dbk file="docbook.xml" tofile="custom-docbook.xml"stylesheet="/path/to/your/xsl/stylesheet" /></target>__</project>