Edit online

Creating a DITA-OT Plugin

Oxygen XML 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.

Note:

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

Create a new folder in the plugins folder located in your DITA-OT directory (for example, if you are using DITA , the path would look like this: /frameworks/dita//plugins/MyNewPlugin).
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 (from the New document wizard New from templates wizard you can find this template in Framework templates > DITA > plugin.
Example:
```
<plugin id="org.metadita.specialization.music">
  <feature extension="dita.specialization.catalog.relative" 
           file="catalog-dita.xml"/>
  <feature extension="dita.xsl.xhtml" file="xsl/music2xhtml.xsl"/>
  <feature extension="dita.xsl.html5" file="xsl/music2xhtml.xsl"/>
</plugin>
```
Tip:
Oxygen XML includes special editing support when adding extension points in the plugin.xml file. If you place the cursor in the value of the @extension attribute and press Ctrl+Space, a list of possible extension points is presented with links to the DITA-OT documentation. For more information about extension points that are available to use in the plugin.xml file, see: http://www.dita-ot.org/dev/extension-points/extension-points-by-plugin.html.
Install the newly created DITA-OT plugin by running the built-in transformation scenario called Integrate/Install DITA-OT Plugins 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.