eerohele / dottask

Ant task for running DITA Open Toolkit

DITA-OT Ant Task

A simple Ant task for publishing things with DITA Open Toolkit.

Features

• No need to set classpath.
• You can use Ant filesets to publish many files at once.
• Platform-independent.

Installation

NOTE: Java 7+ and Ant required.

$ git clone https://github.com/eerohele/dottask.git
$ cd dottask
$ ant
$ cp target/jar/dotTask-0.1.0.jar /your/dita/ant/project/path/lib

Sample Ant buildfile

See samples/build.xml.

To run it:

$ cd samples
$ ant -Ddita.home=/path/to/your/dita-ot/installation

Optional attributes

You can set these optional attributes on the <dita-ot> element.

• workdir

  The directory where to store temporary and output files. The default is ${java.io.tmpdir}.

• inheritAll

  Inherit (almost) all properties from the parent project. The args.input, output.dir, and dita.temp.dir parameters aren't inherited because that wouldn't make sense. The default is false.

• verbose

  Run Ant in verbose mode. The default is false.

Caveats

• Only very cursorily tested on Java 7+, DITA-OT 1.8.x, DITA-OT 2.x, and default DITA-OT plugins at the moment. Help appreciated.
• I resemble a Java programmer about as closely as I resemble George Clooney.

TODO

• Publish to Maven Central (if there's interest)