Integrating DTDs

into the DITA CMS

Leigh White, DITA Specialist, IXIASOFT

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

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…

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

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

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

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

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

DEMO: Add custom catalog to

master catalog

• Add new <nextCatalog> entry

<nextCatalog

catalog="../plugins/com.company.dita.dtd/catalog.xml"/>

DEMO: Verify oXygen pointing to

master catalog

• Window> Preferences> oXygen XML Author (or

Editor)

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"/>

DEMO: Edit topic template

DOCTYPE

• Repository/system/templates/topics (and maps)

<!DOCTYPE concept PUBLIC "-//COMPANY//DTD DITA

Composite//EN" "CompanyDitabase.dtd">

DEMO: Add custom plugin to

Output Generator

• Copy to OutGen/data/%DITA-OT%/plugins

• Run integrator

DISCUSSION: Add plugin to

Web Author framework

Questions?

Time permitting

• DEMO: Integrate topic specialization

• DEMO: Integrate domain specialization

• DEMO: Integrate attribute specialization

More questions?