Overview

What is it ?

Ant4docbook is an ant task for processing docbook xml documents.
Docbook is a semantic markup language for writing technical documentation :


<?xml version="1.0" encoding="utf-8"?>
<article xml:lang="en" xmlns:xi="http://www.w3.org/2001/XInclude">

	<title>My first docbook article</title>
	<section id="section1">
		<title>Section level 1</title>
		<para>
			write your documentation
		</para>
	</section>

</article>  	

Apache Ant is a xml tool for writing scripts :

<project name="ant-project" default="todo"> 

  <target name="todo"> 
    <!-- define ant task here, such as <dbk> task -->
    <dbk file="docbook.xml" tofile="file.html">
  </target> 

</project>  	

Please see : documentation for descriptions and samples.

Why ?

Why another docbook processing tool when there are already many ones ?
Even if these tools do their jobs as they have to do, it is sometimes quiet difficult to install/use/customize them.
Ant4docbook aims to be :

  • easy to use.
  • easy to install.
    Ant4docbook package contains all tools and dependencies
  • easy to customize
  • cross platform

News

  • [next release] ant for docbook V0.6.

    Features : dbk to epub processing
    dbk to docx processing
    fop v1.1
    [BUG#011] XInclude fails when using DOCTYPE in included xml files
    ...

  • [2012-12-16] ant for docbook V0.5 released.
    Features : dbk preprocessing with freemarker engine
  • [2012-07-01] ant for docbook V0.4 released.

    Features : dbk to pdf images processing
    Bugs :
    [BUG#005] Image not available. Reason: org.apache.xmlgraphics.image.loader. ImageException: The file format is not supported
    [BUG#006] Release fix for "The file format is not supported. No ImagePreloader found

  • [2011-09-25] ant for docbook V0.3 released.
    Features : dbk to pdf customization with parameters
  • [2011-03-27] ant for docbook V0.2 released.

    Features : dbk to html and pdf processing
    Bugs :
    [BUG#004] Xslt processing failed with default JRE (thanks to Susanne Wunsch)
    [BUG#003] fo processing failure, due to windows directory permissions
    [BUG#002] xinclude failure on windows
    [BUG#001] java.lang.NoClassDefFoundError: org/jdom/Document