History | Edit

The requirements of the Oxygen XML WebHelp plugin for the DITA Open Toolkit are as follows:
  • Java Virtual Machine 1.6 or newer if you want to use DITA-OT 1.8.5 or Java Virtual Machine 1.8 or newer if you want to use DITA-OT 2.4.4.
  • DITA Open Toolkit 1.8.5 or 2.4.4 (includes Saxon 9.x libraries).
    Note: The Oxygen XML WebHelp Plugin has been tested with these two specific versions (DITA-OT 1.8.5 or DITA-OT 2.4.4) and therefore they are the recommended versions.

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

  1. Download and install a Java Virtual Machine version compatible with the DITA-OT version.
  2. Download and unpack the DITA Open Toolkit version 1.8.5 or 2.4.4.
  3. Go to Oxygen XML WebHelp website, download the latest DITA-OT version of the installation kit, and unzip it.
  4. Copy all plugin directories from the unpacked archive to the plugins directory of the DITA OT distribution. This is necessary to enable certain functionality. For example, the com.oxygenxml.highlight directory adds syntax highlight capabilities to your WebHelp output for codeblock sections that contain source code snippets (XML, Java, JavaScript).
  5. If you have not already done so, copy your license key into a licensekey.txt file and place it in the DITA-OT-DIR/plugins/com.oxygenxml.webhelp directory.
  6. In the home directory of the DITA Open Toolkit, run ant -f integrator.xml.