Edit online

Oxygen XML Editor provides the ability to install additional DITA Open Toolkit plugins that can be found from various sources (for example, Oxygen's public GitHub repository includes some DITA-OT plugins). It is also possible to create your own plugin.

To create a DITA-OT plugin, follow these steps:

  1. Create a new folder in the plugins folder located in your DITA OT directory (for example, if you are using DITA 2.5.4, the path would look like this: [OXYGEN_INSTALL_DIR]/frameworks/dita/DITA-OT2.x/plugins/MyNewPlugin).
  2. Create a plugin.xml file in that same folder. This file will contain the extension points for the plugin. For example, references to the XSLT stylesheets that will be used to style the output.
    Note: You can easily create this file by using the DITA OT Plugin new document template that is included in Oxygen XML Editor (from the New document wizard you can find this template in Framework templates > DITA > plugin.
    Example: A plugin.xml file for a syntax highlighting plugin.
    <plugin id="com.oxygenxml.highlight">
      <feature extension="package.support.name" value="Oxygen XML Editor Support"/>
      <feature extension="package.support.email" value="support@oxygenxml.com"/>
      <feature extension="package.version" value="20.0"/>
      <feature extension="dita.xsl.xhtml" value="xhtmlHighlight.xsl" type="file"/>
      <feature extension="dita.xsl.xslfo" value="pdfHighlight.xsl" type="file"/>
      <feature extension="dita.conductor.lib.import" file="lib/xslthl-2.1.1.jar"/>
    </plugin>
    Tip: For more information about extension points that are available to use in the plugin.xml file, see: http://dita-ot.sourceforge.net/1.5.3/dev_ref/extension-points.html.
  3. Install the newly created DITA-OT plugin by running the predefined transformation scenario called Run DITA-OT Integrator from the Apply Transformation Scenario(s) or Configure Transformation Scenario(s) dialog box.
    Note: If the integrator is not visible, select the Show all scenarios option in the Settings drop-down menu.

You can share your new plugin with other users who have the same DITA-OT distribution by sending them your newly created folder along with the installation instructions.