DocBook debugging task

Posted on One min read

Ant4docbook let you process docbook step by step to debug errors :

  1. docbook to xml, to process xinclude
  2. docbook to fo
  3. fo to pdf
<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>