DITA Attribute Specialization Configuration

Post here questions and problems related to editing and publishing DITA content.
Sano
Posts: 11
Joined: Mon Jan 19, 2015 11:11 am

DITA Attribute Specialization Configuration

Post by Sano »

I have build up a props-specialization but it doesn´t work in Oxygen.
Tried online tutorials and the output generated by the online DITA generator to build the PlugIn.

The PlugIn is integrated in the Oxygen16.1 build-in DITA-OT (without error message).
Is there any aditional Oxygen configuration required to "lern" the new attributes?
Is it required to set another <doctype>-declaration in the dita-topic-file as for topic specialization? How should a proper <doctype> look like?
I tried some <doctype> variations without success.

Thanks for your support!
Radu
Posts: 9018
Joined: Fri Jul 09, 2004 5:18 pm

Re: DITA Attribute Specialization Configuration

Post by Radu »

Hi Sano,

If the props attribute specialization is properly implemented and properly installed then yes, your DITA topics should refer to particular DOCTYPE public and system IDs in order for Oxygen and for the publishing engine (DITA Open Toolkit) to properly know what DTD specialization to use for that topic.
Usually a proper DITA DTD specialization plugin contributes via its plugin.xml catalog entries which map the specialization public and system IDs to the specialization DTDs.
As an example you can look at a very simple MathML specialization plugin we added to the DITA OT bundled with Oxygen:

OXYGEN_INSTALL_DIR\frameworks\dita\DITA-OT\plugins\mathml

The plugin.xml refers to a catalog.xml which in its turn maps the new specialization public ID to a DTD from the plugin:

Code: Select all

<catalog xmlns="urn:oasis:names:tc:entity:xmlns:xml:catalog">
<public publicId="-//FIRELAB//DTD DITA Composite Plus MathML//EN" uri="dtd/ditabase.dtd"/>
</catalog>
When the plugin is integrated, its catalog mapping will be added to the global catalog mapping from the DITA Open Toolkit distribution and both editing and publishing will work for topics having the Public ID something like this:

Code: Select all

<!DOCTYPE dita PUBLIC "-//FIRELAB//DTD DITA Composite Plus MathML//EN" "ditabase.dtd">
Regards,
Radu
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
Post Reply