DITA Open Toolkit, or DITA-OT for short, is an open-source publishing engine for XML content authored in the Darwin Information Typing Architecture.
For information on additional DITA and DITA-OT resources, see SUPPORT. To report a bug or suggest a feature, create an issue. For more information on how you can help contribute to the project, see CONTRIBUTING.
You can download the Oracle JRE or JDK from oracle.com/technetwork/java.
On macOS, you can also install DITA-OT using the Homebrew package manager:
brew install dita-ot
Homebrew will automatically download the latest version of the toolkit, install it in a subfolder of the local package Cellar and symlink the
dita command to
You can generate output using the
dita command-line tool included with DITA Open Toolkit.
On the command line, change to the
bin folder of the DITA-OT installation directory:
dita command to generate output:
dita --input=input-file --format=format [options]
input-fileis the DITA map or DITA file that you want to process
formatis the output format (or “transformation type”)
Clone the DITA-OT Git repository:
git clone git://github.com/dita-ot/dita-ot.git
Change to the DITA-OT directory:
Fetch the submodules:
git submodule update --init --recursive
In the root directory, run Gradle to compile the Java code and install plugins:
In the root directory, set up the build environment:
Build the distribution packages:
Distribution packages are built in the
If Gradle 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 the
GRADLE_OPTS environment variable to a value like
For more information on the
-Xmx option, see the Java SE Documentation.
DITA Open Toolkit is licensed for use under the Apache License 2.0.