Upgrading WebHelp Responsive

To upgrade your version of the Oxygen XML WebHelp Responsive plugin for the DITA Open Toolkit, follow these steps:

  1. Navigate to the plugins directory of your DITA-OT distribution and delete the old Oxygen XML WebHelp Responsive plugin files and directories (com.oxygenxml.highlight, com.oxygenxml.html.custom, com.oxygenxml.media, com.oxygenxml.webhelp.classic, com.oxygenxml.webhelp.common, com.oxygenxml.webhelp.responsive).
  2. Go to Oxygen XML WebHelp website, download the latest DITA-OT version of the Oxygen XML WebHelp Responsive plugin installation kit, and unzip it.
  3. 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).
  4. Open the DITA-OT-DIR/plugins/com.oxygenxml.webhelp.responsive directory, create a file called licensekey.txt, and copy your license key that you purchased for your Oxygen XML WebHelp Responsive plugin.
    When you execute a WebHelp Responsive transformation script, the process reads the Oxygen XML WebHelp Responsive plugin license key from this file. If the file does not exist, or it contains an invalid license, an error message will be displayed.
  5. In the DITA-OT-DIR/bin directory of the DITA-OT, run one of the following scripts, depending on your operating system: