Use a New DITA Open Toolkit in Oxygen

Oxygen comes bundled with a DITA Open Toolkit, located in the [Oxygen-install-folder]/frameworks/dita/DITA-OT directory. To use a new DITA Open Toolkit, follow these steps:

  1. Edit your transformation scenarios and in the Parameters tab change the value for the dita.dir directory to point to the new directory.
  2. If you want to use exclusively the libraries that come with the new DITA Open Toolkit you have to go to the Advanced tab, click the Libraries button, uncheck the checkbox Allow Oxygen to add high priority libraries to classpath and configure all libraries that will be used by the ANT process.
  3. If there are also changes in the DTD's and you want to use the new versions for content completion and validation, go to the Oxygen preferences in the Document Type Association page, edit the DITA and DITA Map document types and modify the catalog entry in the Catalogs tab to point to the custom catalog file catalog-dita.xml.

If the transformation fails after completing these steps please also take a look at this note about upgrading the DITA OT which comes bundled with Oxygen.