Configure DITA-OT version for transformation scenarios

This procedure describes how to configure the DITA Open Toolkit (DITA-OT) version for all the transformation scenarios in a conductor file.

Note: You can also configure a default DITA-OT version by setting the outgen.ot.version property in the outgen-init.properties file. See Configure the version of the DITA-OT used by default for more information.
The procedure below assumes that the DITA-OT is stored in the following location:
%OutputGenDir%/data
And that the directory name follows this naming convention:
  • DITA-OT 1.x family: DITA-OTversion
  • DITA-OT 2.x family: dita-ot-version
Where version is the DITA-OT version number. For example:
C:\Ixiasoft\OutputGenerators\OutputGen_Prod\data\DITA-OT1.8.5
C:\Ixiasoft\OutputGenerators\OutputGen_Prod\data\dita-ot-2.3.1
C:\Ixiasoft\OutputGenerators\OutputGen_Prod\data\dita-ot-3.4.1

This directory name is automatically created when you unzip the DITA-OT. Do not change it.

To configure the DITA-OT version for transformation scenarios:

  1. Open the conductor file containing the targets that will use this version of the DITA-OT.

    For example, for targets that will use the 3.4.1 DITA-OT, open the following file:

    C:\ixiasoft\OutputGenerators\Prod\data\conductor-client-3.4.1.xml
    Note: If the conductor file does not exist, create it using the conductor-client.xml.orig template.
  2. Set the outgen.ot.version attribute to the version of the DITA-OT.
    This is the string that comes after DITA-OT in the directory name. For example:
    <?xml version="1.0" encoding="UTF-8"?>
    
    <project name="conductor-ixia" default="" basedir=".">
    
    	<!-- Set the version of the OT that will be used -->
    	<property name="outgen.ot.version" value="3.4.1"/>
  3. (Optional) Configure the location of the DITA-OT catalog:
    1. Open the %OutputGenDir%/data/catalogs/catalog-dita-outgen.xml file.
    2. Set the <nextCatalog> value to the location of the DITA-OT catalog-dita.xml file for the DITA-OT you installed.
      If the catalog-dita.xml file is referring to a DITA-OT that is still present in your Output Generator, you don't have to change it. The folder naming convention used by the DITA-OT changed between versions 1.8 and 2.x, so make sure to use the actual folder name for the DITA-OT you just installed.
    3. Comment out the previous DITA-OT catalog.
      Only one catalog can be specified at any time.
    4. Save and close the file.
  4. To test your installation, generate an output using this version of the DITA-OT.