Migrating to release 2.1
In DITA-OT 2.1, the
insertVariable template was deprecated for PDF transformations and
should be replaced with the
getVariable template. Various
targets have been deprecated in favor of updated
The customFileUtils code used to handle input and output in earlier versions of DITA-OT has been replaced with the Apache Commons IO utilities library.
The following build targets have been deprecated and will be removed in an upcoming release:
helptarget that includes a reference to the current DITA-OT version during the build process.
The following Ant properties and generated list files have been deprecated:
- imagefile property and
- htmlfile property and
The following pre-processing targets and extension points have been deprecated:
copy-subsidiarytarget used to copy subsidiary files
copy-subsidiary-checktarget used to check for subsidiary files
- The depend.preprocess.copy-subsidiary.pre extension point used to insert an Ant target
copy-subsidiarystep in the pre-processing stage.
A newdita.parser extension point has been added to allow plug-ins to contribute a custom parser for DITA files. If a custom DITA parser is defined, the preprocessing routines will use it during the gen-list and debug-filter stages to output DITA XML.
The following template has been deprecated:
Calls to that template will result in warnings in the build log.
To update your plug-in, make the following changes:
<xsl:call-template name="insertVariablegetVariable"> <xsl:with-param name="theVariableIDid" select="var-id"/> <xsl:with-param name="theParametersparams"> params </xsl:with-param> </xsl:call-template>
HTML-based output formats
dita.out.map.xhtml.toc target has been deprecated and should be replaced with the
Keydef processing has been removed from the XHTML rendering code. Keys are now resolved in one preprocessing step, whereas in earlier versions of DITA-OT, the XHTML code returned to the keydef.xml file to look up targets for phrase elements and pull in text when needed.
This change affects non-linking elements that can't take
@href attributes, such as
$INDEXSHOW is active).
dita.out.map.htmlhelp.* targets have been deprecated and should be replaced with
dita.out.map.javahelp.* targets have been deprecated and should be replaced with
Support for the args.odt.img.embed parameter has been removed from OpenDocument Text transformations. The previous default behavior was to embed images as Base64-encoded text, but editors do not use this as a default. Instead, office packages such as LibreOffice will convert embedded images into linked images on opening and saving an ODT file.