Configure DITA-OT version for transformation scenarios

You can configure the DITA Open Toolkit 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.

The following assumptions pertain:

  1. The DITA-OT is stored in %OutputGenDir%/data.
  2. The directory name follows this naming convention where version is the DITA-OT version number.
    1. DITA-OT 1.x family: DITA-OTversion
    2. DITA-OT 2.x family: dita-ot-version
      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 uses the current version of the DITA-OT.
    For targets that use the 3.4.1 DITA-OT, open 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 DITA-OT version.
    Sample string that comes after DITA-OT in the directory name. 
    <?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 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 you use the actual folder name for the DITA-OT you just installed.
    3. Comment out the previous DITA-OT catalog.
      Note: 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.