DITA specializations support

 Integration of a DITA specialization

A DITA specialization includes DTD definitions for new elements as extensions of existing DITA elements and optionally 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 DITA Open Toolkit. A specialization can be integrated in <oXygen/> XML Author with minimum effort.

If the DTDs that define the extension elements are located in a folder outside the DITA Open Toolkit folder you should add new rules to the DITA OT catalog file for resolving the DTD references from the DITA files that use the specialized elements to that folder. This allows 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 Ant build scripts of DITA OT.

[Important]Important

If you are using DITA specialization elements in your DITA files it is recommended that you activate the Enable DTD processing in document type detection checkbox in the Document Type Association page.