Migrating to release 2.2

In DITA-OT 2.2, the HTML5 transformation was refactored as its own plugin and separate plugins were created for each of the rendering engine-specific PDF transformations.

Note: 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 DITA-OT 2.2 Release Notes.


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

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.


Processing specific to Apache FOP, Antenna House Formatter, and RenderX XEP has been separated into separate plugins 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 plugins.

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

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