Adding specializations to DITA CMS by Leigh White, DITA Specialist at IXIASOFT Specialization allows you to define new elements or attributes within DITA by following a very uniform process. You might want to integrate an existing specialization, such as the FAQ specialization, into DITA CMS, or you might have created your own specialization that you want to integrate. This presentation demonstrates the basic steps you need to follow, from creating and customizing your own shell DTD and catalog, to making the necessary changes to the system configuration, to the actual integration of topic, domain, and attribute specializations into both DITA CMS and the Output Generator.

1. Integrating DTDs
into the DITA CMS
Leigh White, DITA Specialist, IXIASOFT

2. Introduction
Leigh White
DITA Specialist
• Writer, Information Architect, Speaker
• Been with IXIASOFT since Sept 2013
• DITA CMS user since 2011
• Implement and support DITA CMS
• Author of DITA for Print
• Contributor to The Language of Content Strategy

3. Have you seen the documentation?
• http://www.ixiasoft.com/en/products/dita-cms/
documentation/3-4/integrating-dtds-dita-cms
• Fuhgeddabout!
• It’s all different (and better) now
• New documentation forthcoming
• In the meantime…

4. Come out of your shell
• First step in any integration…create your own DTD
shell
• Why?
 Lots of reasons
 The biggest (CMS-wise): so you don’t edit any files that
IXIASOFT supplies and might update in the future,
overwriting your changes

5. The process in a nut…shell
1. Create a new DTD plugin
2. Copy files to custom plugin & rename
3. Edit relative paths in shell DTD
4. Edit custom catalog
5. Add custom catalog to CMS master catalog
6. Verify oXygen points to master catalog
7. Edit system id’s
8. Edit topic template DOCTYPE’s
9. Integrate DTD plugin into Output Generator
10.Add DTD plugin to Web Author framework

6. DEMO: Create new DTD plugin
• Create new plugin folder
• Add dtd collection
• Copy plugin.xml, catalog.xml, IxiaDitabase.xml
• Rename IxiaDitabase.xml, optionally rename
catalog.xml
• Edit plugin.xml

7. DEMO: Edit shell DTD
• Edit header
• Edit public id
• Edit relative path for localizationDomain.ent
 (Domain Attribute Declaration section)
• Edit system id path for referable-content-typemod
 (Topic Element Integration section)
• Change end comment

8. DEMO: Edit custom catalog
• Delete everything inside <group></group> except
line referencing IxiaDitabase.dtd
• Change that public id and URI to match public id
and URI of shell DTD

9. DEMO: Add custom catalog to
master catalog
• Add new <nextCatalog> entry
 <nextCatalog
catalog="../plugins/com.company.dita.dtd/catalog.xml"/>

10. DEMO: Verify oXygen pointing to
master catalog
• Window> Preferences> oXygen XML Author (or
Editor)

11. DEMO: Edit system id’s
• Repository/system/conf/systemid.xml
• Change topicdefault
 <id mapdefault="-//IXIA//DTD IXIA DITA Map//EN"
topicdefault="-//COMPANY//DTD DITA Composite//EN">
• Change first reference’s public id
 <reference public="-//COMPANY//DTD DITA
Composite//EN"
system="../../system/dtd/ixia/IxiaDitabase.dtd"/>

12. DEMO: Edit topic template
DOCTYPE
• Repository/system/templates/topics (and maps)
 <!DOCTYPE concept PUBLIC "-//COMPANY//DTD DITA
Composite//EN" "CompanyDitabase.dtd">

13. DEMO: Add custom plugin to
Output Generator
• Copy to OutGen/data/%DITA-OT%/plugins
• Run integrator

14. DISCUSSION: Add plugin to
Web Author framework

15. Questions?

16. Time permitting
• DEMO: Integrate topic specialization
• DEMO: Integrate domain specialization
• DEMO: Integrate attribute specialization

17. More questions?