Integrating the Oxygen XML WebHelp Plugin with the DITA Open Toolkit

This topic includes the procedure for integrating the Oxygen XML WebHelp plugin with the DITA Open Toolkit.

The requirements of the Oxygen XML WebHelp plugin for the DITA Open Toolkit are as follows:

• Java Virtual Machine 1.6 or later
• DITA Open toolkit 1.8 or 2.0 (Full Easy Install, includes Saxon 9.1.0.8 libraries)
• Saxon 9.1.0.8

To integrate the Oxygen XML WebHelp plugin with the DITA Open Toolkit, follow these steps:

1. Download and install a Java Virtual Machine 1.6 or later.
2. Download and install DITA Open Toolkit 1.8.x or 2.x.
3. Go to Oxygen XML WebHelp website, download the latest installation kit, and unzip it.
4. Copy the com.oxygenxml.webhelp and com.oxygenxml.highlight directories inside the plugins directory of the DITA OT distribution. The com.oxygenxml.highlight directory adds syntax highlight capabilities to your WebHelp output for codeblock sections that contain source code snippets (XML, Java, JavaScript etc.).
5. If you are using DITA-OT version 2.x, the WebHelp plugin contains a plugin_2.x.xml that needs to be renamed to plugin.xml.
6. In the home directory of the DITA Open Toolkit, run ant -f integrator.xml.