The DITA Open Toolkit, or DITA-OT for short, is an open-source tool that provides processing for OASIS DITA content. See dita-ot.sf.net for documentation, information about releases, and download packages.
To build and use DITA-OT, you’ll need:
-
Java Development Kit 6 or newer
-
Apache Ant 1.8.2 or newer
If Ant throws an error like
unknown protocol: plugin
orunknown protocol: cfg
, your Ant installation may be outdated. Try installing a newer version of Ant.
-
Clone the DITA-OT Git repository:
git clone git://github.com/dita-ot/dita-ot.git
-
In the root directory, compile the Java code:
ant jar jar.plug-ins
-
Add these files into the
CLASSPATH
environment variable:src/main/lib/icu4j.jar
src/main/lib/resolver.jar
-
Install plugins:
ant -f src/main/integrator.xml
-
Add these files and directories into the
CLASSPATH
environment variable:src/main/
src/main/lib/
src/main/lib/dost.jar
src/main/lib/xercesImpl.jar
src/main/lib/xml-apis.jar
src/main/lib/commons-codec-1.4.jar
src/main/lib/saxon/saxon9-dom.jar
src/main/lib/saxon/saxon9.jar
src/main/lib/resolver.jar
src/main/lib/icu4j.jar
-
Change the directory to
src/main
. -
Run DITA-OT:
ant [options]
See the documentation for arguments and options.
-
In the root directory, compile the Java code:
ant jar jar.plug-ins
-
Add these files and directories into the
CLASSPATH
environment variable:src/main/
src/main/lib/
src/main/lib/dost.jar
src/main/lib/xercesImpl.jar
src/main/lib/xml-apis.jar
src/main/lib/commons-codec-1.4.jar
src/main/lib/saxon/saxon9-dom.jar
src/main/lib/saxon/saxon9.jar
src/main/lib/resolver.jar
src/main/lib/icu4j.jar
-
Install plugins:
ant -f src/main/integrator.xml
-
Build distribution packages:
ant dist
Distribution packages are build into the
target
directory.If Ant throws an error like
java.lang.OutOfMemoryError: Java heap space
, you probably need to increase the maximum Java heap size. One way to do this is to set theANT_OPTS
environment variable to a value like-Xmx1024m
.For more information on the
-Xmx
option, see Java SE Documentation.
The DITA Open Toolkit is licensed for use, at the user's election, under the Common Public License 1.0 (CPL) or Apache License 2.0.