History | Edit

A DITA specialization usually includes:

  • DTD definitions for new elements as extensions of existing DITA elements.
  • Optional specialized processing that is new XSLT template rules that match the extension part of the class attribute values of the new elements and thus extend the default processing available in the DITA Open Toolkit.

To integrate a DITA specialization into Oxygen XML Editor, use one of these methods:

DITA-OT Plugin Method

If the DITA specialization is available as a DITA Open Toolkit plugin, follow this procedure:
  1. Copy the plugin to the location of the DITA OT you are using (by default DITA-OT-DIR\plugins).
    Important: The application needs to have full write access permissions to the DITA OT directory.
  2. If Oxygen XML Editor was installed in the default location, you may need to restart and run it as an administrator.
  3. Select the Configure Transformation Scenario(s) action from the DITA Maps Manager toolbar (you could also use the same action on the main toolbar or open the Transformation Scenarios view).
  4. Select the Run DITA OT Integrator transformation scenario.
    Tip: If you don't see that scenario in the Configure Transformation Scenario(s) dialog box or Transformation Scenarios view, click the Settings button and select the Show all scenarios option, but don't forget to change it back to Show only the scenarios available for the editor after you are finished with this procedure.
  5. Apply the scenario.
  6. Check the Results panel at the bottom of the application to make sure the build was successful.
  7. Restart Oxygen XML Editor with your normal permissions.
Tip: Oxygen XML Editor detects new document templates contributed by the DITA OT plugin as long as you do the following:
  1. Create a new folder called template_folders inside the DITA-OT-DIR\plugins directory.
  2. Create one or more subfolders inside the template_folders directory that contain the new file templates. The new document templates found in those subfolders will be available in the New document wizard.

Alternative Options

If the DITA specialization is not available as a DITA OT plugin, you have the following options:
  • If the DTDs that define the extension elements are located in a folder outside the DITA Open Toolkit folder, add new rules to the DITA OT catalog file. These rules are meant for resolving the DTD references from the DITA files that use the specialized elements to that folder. This allows for correct resolution of DTD references to your local DTD files and is needed for both validation and transformation of the DITA maps or topics. The DITA OT catalog file is called catalog-dita.xml and is located in the root folder of the DITA Open Toolkit.
  • If there is specialized processing provided by XSLT stylesheets that override the default stylesheets from DITA OT, these new stylesheets must be called from the DITA OT Ant build scripts.
    Important: If you are using DITA specialization elements in your DITA files, it is recommended that you activate the Enable DTD/XML Schema processing in document type detection option in the Document Type Association preferences page.
  • You could create your own document templates, store them in a custom direction, then add that directory to the list of template directories that Oxygen XML Editor uses by adding the directory to the list in the Document Templates Preferences.