Step 1 (optional): Download another version of the Open Toolkit

The DITA Open Toolkit website provides all the Open Toolkit versions.

When you download a new version of the DITA Open Toolkit, it must be stored in the %OutputGenDir%/data directory, with the following naming convention:
  • DITA-OT 1.x family: DITA-OTversion
  • DITA-OT 2.x family: dita-ot-version
Where version is the Open Toolkit version number. For example:
C:\Ixiasoft\OutputGenerators\OutputGen_Prod_[version]\data\DITA-OT1.8.5
C:\Ixiasoft\OutputGenerators\OutputGen_Prod_[version]\data\DITA-OT1.5.4
C:\Ixiasoft\OutputGenerators\OutputGen_Prod_[version]\data\dita-ot-2.1.1

Where [version] is replaced by the release version number.

To download another version of the Open Toolkit:

  1. Go to the DITA Open Toolkit download website:
  2. Download the package for the version of the Open Toolkit that you need.
    The Open Toolkit is packaged as a .zip (Windows) or .tar.gz (Unix) file.
  3. Extract the file to the %OutputGenDir%/data directory.
    For example, for the 1.5.4 DITA-OT:
    C:\Ixiasoft\OutputGenerators\OutputGen_Prod_[version]\data\DITA-OT1.5.4

    Where [version] is replaced by the release version number.

    Note: Keep the directory name as defined by the Open Toolkit (for example, DITA-OT1.5.4 or dita-ot-2.1.0). The Output Generator assumes that the DITA Open Toolkit files are stored in a directory that follows this naming convention.
  4. Copy the following plugins from the %OutputGenDir%/data/DITA-OT1.8.5/plugins directory to the %OutputGenDir%/data/%NewOT_Dir%/plugins directory (for example, %OutputGenDir%/data/DITA-OT1.5.4/plugins):
    • com.ixiasoft.dita.dtd: Includes the IXIASOFT DITA DTD specializations
    • com.ixiasoft.images: Handles the .image file extension for the image objects
    • com.ixiasoft.pdf.review: Handles the PDF-based review process.
      Note: You need to copy this plugin only if you want to change the ReviewPDF and RedlinePDF transformation scenarios to a different version of the DITA-OT.
    • org.w3c.mathml3: MathML 3 DTDs
    • org.oasis-open.dita.mathml.doctypes: MathML DITA integration
    • org.w3c.svg1.0: SVG 1.0 DTDs
    • org.w3c.svg1.1: SVG 1.1 DTDs
  5. If you added plugins to the previous Open Toolkit, copy them to the plugins directory of the new Open Toolkit (for example, %OutputGenDir%/data/DITA-OT1.5.4/plugins).
  6. Copy any custom DITA-OT changes from %OutputGenDir%/data/%OldOT_Dir%/resource to %OutputGenDir%/data/%NewOT_Dir%/resource.
    Note: See the DITA-OT documentation for more information.
  7. Run the DITA-OT integrator.
    This step depends on the DITA-OT family:
    DITA-OT 1.x family:
    • On Windows: In the %OutputGenDir%/data/ directory, double-click the _DITA-OT-1.8.5-integrator.bat file.
    • On Linux:
      1. In the %OutputGenDir%/data/%OT_Dir%/ directory, run startcmd.sh.
      2. At the command prompt, enter:
        ant -f integrator.xml

    The integration build runs and you should soon see BUILD SUCCESSFUL.

    DITA-OT 2.x family:
    • On Windows: In the %OutputGenDir%/data/ directory, double-click the _DITA-OT-2.3.1-integrator.bat file.
    • On Linux: In the %OutputGenDir%/data/%OT_Dir%/bin directory, enter the following command:
      ./ant -f ../integrator.xml (Linux)

    The integration build runs and you should soon see BUILD SUCCESSFUL.

    Note: If a message similar to the following is displayed:
    Unable to locate tools.jar. Expected to find it in C:\Program Files\Java\jre6\lib\tools.jar
    This message means that you are using a JRE instead of a JDK to run the Output Generator. You can ignore this message if you do not need to compile Java classes in your plugin. Otherwise, you must configure the Output Generator to run the JDK instead of the JRE. Update this information in the wrapper.conf file. See the Installation Guide for Output Generator for more information.