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.
In order to build and use DITA-OT, you’ll need:
-
Java Development Kit 6 or newer
-
Apache Ant 1.8.2 or newer.
Please note that if you receive errors like
unknown protocol: plugin
orunknown protocol: cfg
then you may have some missing libraries from yourant
installation. In that case please download a recent distribution ofant
and use that instead.
-
Clone DITA-OT Git repository.
-
On root directory, compile Java code:
ant jar
-
Make sure the following files and directories are added to your
CLASSPATH
system variable:src/main/lib/
-
Run plug-in installation:
ant -f src/main/integrator.xml
-
Add the following files and directories to
CLASSPATH
system 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 directory to
src/main
. -
Run DITA-OT with:
ant [options]
See documention for arguments and options.
-
On root directory, compile Java code:
ant jar
-
Add the following files and directories to
CLASSPATH
system 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
-
Run plug-in installation:
ant -f src/main/integrator.xml
-
Build distribution packages:
ant dist
Distribution packages are build into
target
directory.On some systems you may encounter an
java.lang.OutOfMemoryError: Java heap space
. In that case you need to provide more memory to theant
process. One way of doing that is by setting theANT_OPTS
system variable to specify more memory, for example setting that to-Xmx1000m
should be enough.
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.