(register)   username:   password:  

Community KB :: DITA / FrameMaker

A collection of tips and troubleshooting information. Feel free to register and add your own items.


FMN DITA .. refers to the DITA support that is provided by default in FM9 and FM8.

DITA-FMx .. is a plugin that provides extended DITA authoring support for FM9, FM8, FM7.2 and FM7.1. More info...

Submitted by: Scott Prentice (2008-01-19)
Last updated: 2008-06-19

TAGS:  Installation, OpenToolkit, DITA-FMx 0.0, DITA-FMx 1.0, FM 7.1, FM 7.2, FM 8.0
SUMMARY:  Setting up DITA-FMx with OT 1.4.x
ISSUE:  If you've been having trouble getting the OT setup with DITA-FMx, this might help .. this assumes that you've got the latest version of DITA-FMx installed (0.02 or 1.00). (http://leximation.com/dita-fmx/) ..
SOLUTION:  1) Download the "DITA-OT1.4.1_fullpackage_bin.zip" file from SourceForge (http://sourceforge.net/project/showfiles.php?group_id=132728&package_id=145774&release_id=556111). Unzip this file to your local file system.

2) Download and install the Java Development Kit (JDK) version 5 or higher (http://java.sun.com/javase/downloads/index.jsp). (Yes the install instructions say JDK1.4.2, but that won't work with OT 1.4 it appears .. ***you must use version 5 or higher!***)

3) Set your JAVA_HOME environment variable to the path to the newly installed JDK (perhaps "C:\Program Files\Java\jdk1.6.0_04").

4) Copy the "ditafmx-ant.xml" file from the DITA-FMx folder to your DITA-OT folder.

5) In the DITA-OT folder, copy the "startcmd.bat" file to "ditafmx-startcmd.bat"

6) Open the "ditafmx-startcmd.bat" file in Notepad (or other text editor) and comment out the last line (add a "REM " in front of the line). If you don't comment out this line, it will still work, you'll just get an empty shell that hangs around each time you build. It should look like this ..

    REM start "DITA-OT" cmd.exe

7) Open the ditafmx-ini file in Notepad and add the "EnvironmentSetup" parameter to the BuildFile section. This parameter should point to the "ditafmx-startcmd.bat" file. For example ..


8) If you make use of the "Selected Target" option with the Generate Output command in Frame, you'll need to add this parameter to the associated "ANT:<targetname>" sections as well.

This *should* let you generate output through the default OT 1.4.1 targets, without requiring you to set up the system environment. If you use the PDF2 transform, you may need to do some additional gymnastics such as starting Frame from a shell in the OT directory (or adding a "cd %DITA_DIR%" line to the ditafmx-startcmd.bat file.

Alternatively, you may want to start FM from the DITA-OT directory. To do this just create a shortcut to FrameMaker.exe, and in the "Start In" field of the Shortcut tab, set this value to the path to your DITA-OT directory.