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: 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.6.x, 1.7.x, 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 which needs to be renamed to plugin.xml.
  6. In the home directory of the DITA Open Toolkit, run ant -f integrator.xml.
  7. Go to http://sourceforge.net/projects/saxon/files/Saxon-B/9.1.0.8/, download the processor.saxonb9-1-0-8j.zip file (contains the Saxon 9.1.0.8), and unzip it to a destination of your choosing.