Use a different DITA-OT package

Learn how to publish DITA files with DITA Open Toolkit and Adobe FrameMaker.

Bu default, FrameMaker uses DITA Open Toolkit 3.3. However, DITA-OT 3.0 and 2.3 packages are also installed when you install FrameMaker. If you already have a different version of DITA Open Toolkit installed, you can customize the DITA Open Toolkit path by either editing the dita initialization file or from Customize DITA-OT dialog.

For a one-time change, you can change the directory path when you generate the output using the DITA Open Toolkit.

To change the FrameMaker default DITA-OT directory through the dita initialization file:

  1. Open the ditafm.ini file in the current user profile folder:

    %appdata%\Adobe\FrameMaker\17\ditafm.ini
  2. Locate the following text in the file:

    DitaDir=%FMHOME%\fminit\ditafm\DITA-OT
  3. Modify the value of DitaDir to point to the alternative DITA-OT folder.

    For example:

    DitaDir=C:\DITA-OT_3.2.1
  4. Restart FrameMaker.

    The new DITA OT path is populated in the DITA Generate Output dialog.

To change the FrameMaker default DITA-OT directory through Customize DITA-OT dialog:

  1. Choose Structure > DITA > Generate DITA-OT Output to pen the Generate DITA-OT Output dialog.

  2. Click the Customize button to open Customize DITA-OT dialog.

  3. Change the parameters as per your configuration and click OK.

Figure 1. Customize DITA-OT dialog
Customize DITA-OT dialog in FrameMaker

The following parameters can be specified in the Customize DITA-OT dialog:

DITA-OT Directory (%DITA_DIR%)

Specify the path to the custom DITA-OT. You can use the %FMHOME% variable, which refers to the FrameMaker install location. This path is saved in DITA_DIR variable, which can be used to specify the path of other related folders.

Ant Command

Specify the path of the Ant script folder. This path is relative to the DITA-OT directory on your file system.

Ant Home

Specify the path of the Ant installation folder.

Classpath

Specify the path of the Java libraries.

Build File

Specify the path of the Ant Build script file build.xml. This path is relative to the DITA-OT directory.

Extra Params

Specify any additional parameters required by your custom DITA-OT plug-in.