Migrating to release 2.2 To 2.2 In DITA-OT 2.2, the transformation was refactored as its own plug-in and separate plug-ins were created for each of the rendering engine-specific PDF transformations. There are likely other changes that should be noted here.
This topic provides a summary of changes in DITA-OT 2.2 that may require modifications to custom stylesheets or plug-ins. For more information on changes in this release, see the .
HTML5

The transformation introduced in release 2.0 as part of the plug-in has been moved to a separate plug-in. Customizations that extended the previous HTML5 output under the plug-in will probably need to be refactored on the new HTML5 plug-in.

Note title processing has been revised to use a common note__title class for note elements of all types. The legacy {$type}title classes (such as .notetitle, .cautiontitle, .tiptitle, etc.) are included for backwards compatibility, but are deprecated and will be removed in an upcoming release. Stylesheets that apply formatting overrides to note titles should be revised to replace the deprecated class selectors with the equivalent descendant selectors, for example .note_note .note__title, .note_caution .note__title, .note_tip .note__title, etc.

PDF

Processing specific to Apache FOP, Antenna House Formatter, and RenderX XEP has been separated into separate plug-ins for each of those rendering engines. Customizations that extended this processing might need to extend the new org.dita.pdf2.fop, org.dita.pdf2.axf, or org.dita.pdf2.xep plug-ins.

PDF customizations that are not specific to a rendering engine can continue to extend the org.dita.pdf2 plug-in as before.

The default format for page numbers in the table of contents (toc) was switched to roman to align with preface and ensure consistent numbering styles for all frontmatter components in bookmap. This prevents numbering from switching back and forth between styles in bookmaps where the Preface follows the table of contents. Earlier versions of DITA-OT produced numbering sequences like 1,2,3,4,v,vi,7,8 in this use case.

Deprecated properties

The following Ant properties have been deprecated:

  • user.input.file, use user.input.file.uri instead to specify the input file system path
  • user.input.dir, use user.input.dir.uri instead to specify the input directory system path
  • InputMapDir, use InputMapDir.uri instead to specify the input map directory system path