Running a DITA Transformation Using the Oxygen XML WebHelp Plugin

To run a DITA to WebHelp (webhelp, webhelp-feedback, webhelp-mobile) transformation using the Oxygen XML WebHelp plugin, use:

• The dita.bat script file for Windows based systems.
• The dita.sh script file for Unix/Linux based systems.
  Note: You can call these files in an automated process or from the command line.

The dita.bat and the dita.sh files are located in the home directory of the Oxygen XML WebHelp Plugin. Before using them to generate an WebHelp system, customize them to match the paths to the JVM, DITA Open Toolkit and Saxon engine, and also to set the transformation type. To do this, open a script file and edit the following variables:

• JVM_INSTALL_DIR - specifies the path to the Java Virtual Machine installation directory on your disk.
• DITA_OT_INSTALL_DIR - specifies the path to DITA Open Toolkit installation directory on your disk.
• SAXON_9_DIR - specifies the path to the directory on your disk where you unzipped the Saxon 9 archive files.
• TRANSTYPE - specifies the type of the transformation you want to execute. You can set it to webhelp, webhelp-feedback and webhelp-mobile.
• DITA_MAP_BASE_DIR - specifies the path to the directory where the input DITA Map file is located.
• DITAMAP_FILE - specifies the input DITA Map file.
• DITAVAL_FILE - specifies the .ditaval input filter that the transformation process applies to the input DITA Map file.
• DITAVAL_DIR - specifies the path to the directory where the .ditaval file is located.
• Doutput.dir - specifies the output directory of the transformation.