DITA Open Toolkit Resources

The DITA Open Toolkit is an implementation of the OASIS DITA Technical Committee's specification for Darwin Information Typing Architecture (DITA) DTDs and Schemas. The Toolkit transforms DITA content (maps and topics) into deliverable formats.

The DITA Open Toolkit, or dita-ot for short, is a set of Ant- and Java-based, open source tools that provide a "reference implementation" for processing DITA maps and topical content.

The home page of the DITA Open Toolkit project on SourceForge is http://sourceforge.net/projects/dita-ot/.

The main DITA Open Toolkit download page is DITA Open Toolkit.

The jump page for the latest version of the DITA Open Toolkit Users Guide is DITA Open Toolkit Users Guide.

Due to continual updating of various packages on that page, we link only to the page, not to files themselves. However, there is a logic to what you might be looking for on that page!

DITA Open Toolkit package options

You may choose either of these DITA Open Toolkit options:
  • "fullpackage," the larger of the two, in which this term is part of the filename. Choose this version if you want to evaluate the DITA Open Toolkit for the first time and want the easiest possible installation. All you do is unzip it to a handy directory and then read the EvaluateOT.html file that is in the new directory. This file is larger because it contains most of the supplemental files needed to make the Toolkit function.
  • standard, the smaller of the two. Choose this version if you already have a DITA OT installation that you just want to update, or if you are installing a production system or need to install other add-on processing tools such as help compilers.

For each option, there is a version for Linux and one for Windows. The Linux packages have a ".tar.gz" extension; those for Windows have a ".zip" extension.

For each platform, there are two versions: "src" in the filename indicates a Source version for developers only, and "bin"in the filename indicates the actual executable version that you are probably most interested in if you are an end user.

DITA Open Toolkit Plugins

The DITA Open Toolkit package itself provides only the core transforms into common deliverable format, such as HTML and review-quality-only PDF. A plugin architecture allows developers to provide new services independently of the schedules of the core package. Plugins may introduce new processing, new specializations, or both. Plugins are listed further down on the Sourceforge downloads page, and have "Plug-in" as part of the name on the header bar for each plugin.

Popular plugins here include:
  • APIRef - a set of specializations that define common documentation conventions for most programs.
  • CShelp - a specialization for Context Sensitive Help applications. A reference output transform is provided.
  • DocBook2DITA - a transform from Docbook to DITA and some proof-of-concept examples of interoperability.
  • FrameMaker Adapter - a transform that creates a single book file from a map that can be imported into FrameMaker for final printing using that editor's high quality print engine.
  • javaapiref - a further specialization of the APIRef specialization that supports the specific documentation conventions of the Java programming language.
  • music - a sample plugin that you can study for best practices on how to create a specialization, associated transforms and language localization files, and transforms. The overall package demonstrates best practice for combining these parts as a Toolkit plugin (the easiest way to distribute ANY specialization or code intended to work with the DITA Open Toolkit!).
  • Thesaurus - a specialization that defines formal subjects and the relationships between those subjects so you can classify what your content is about.
  • Troubleshooting - a specialization that provides a new DITA topic type that is well-suited for problem-solution information.
For all of these packages, you can click on the Release Notes link to read more about a particular plugin.

Test Builds

For Toolkit developers only. Beta releases of the Toolkit may be found here as each test build is released.