Release Notes: Version 0.9.19RC12

Version 0.9.19 (Under development)

Theme for the Release

The 0.9.19 release is primarily about finishing out and generalizing the map-based processing used in the EPUB, Kindle, HTML2, and HTML5 transforms.

The transforms should work with the 1.6, 1.7, and 1.8 versions of the Open Toolkit.

There is the start of vocabulary reference document, developed by Steven Calderwood of Human Kinetics.

Significant improvements to Word-to-DITA transformation framework. The markup for style-to-tag maps has been enhanced to be more complete and hopefully easier to work with. A migration utility is provided in org.dita4publishers.word2dita/utils/style2tagmapMigrator.xsl. It should produce working style-to-tag maps from most existing style-to-tag maps. A few may require manual adjustment, especially if you are trying to generate maps and topics at the same time.

The release also includes additions and refinements to the vocabulary, numerous bug fixes and whatnot.

Word to DITA

New features:

  • Feature 32: Capture type for break elements and filter out page and column breaks by default (avoids blank paragraphs caused by manual page breaks).
  • Feature 31: Enable generation of nested inlines by supporting @containerType on inline elements. Lets you generate e.g. <sup><b>A</b></sup>.
  • Feature 30: Completely reworked how maps are generating, making it possible to generate complex systems of maps and topicrefs. Includes ability to specify @containerType for topicrefs (e.g., "frontmatter" for topicrefs within a book map).
  • Feature 28: Can now specify map and topic generation details on <output> elements since these are usually the same for all instances of a given topic or map type. Values specified on specific style mappings override the values on <output>.
  • Feature 27: Added ability to generate @type attribute on <data> elements via new @typeAttValue attribute on style maps.
  • Feature 18, Feature 24: Added handling of Symbols and Wingdings fonts in Word documents. Result is correct Unicode characters in the generated XML.
  • Feature 8, Feature 23: Generally improved capturing of Word table details in DITA. DITA result should now reflect the Word table as completely as is possible within the limits of CALS tables.
  • Feature 17: Capture literal MathML markup in Word documents as MathML in the generated DITA. Literal MathML is created by the Design Science MathType Word plugin from binary MathType equations.
  • Feature 16: Capture the data behind charts as CALS tables. Note that the chart itself is not captured.
  • Feature 14: Implemented ability to set @toc attribute on generated topicrefs.
  • Feature 1: Implement support for footnotes.


  • Issue 45, Issue 46, Issue 58, Issue 152, Issue 159, Issue 161, Issue 162, Issue 166: Reimplemented map and topic generation to correct errors in map generation. Made the intermediate simpleWP XML reflect the map and topic hierarchy to make DITA generation easier. This change could affect custom preprocessing applied to the simpleWP XML. Also adds a number of new attributes to style mapping definitions as required to fully specify map and topicref generation.
  • Issue 156: Correctly handle character styles within hyperlinks.
  • Issue 153: Correctly handle metadata paragraphs after map-generating paragraph.
  • Issue 83, Issue 110, Issue 152: Broke out map and topic filename generation code into separate XSLT modules to make it easier to override or extend: modeMapUrl.xsl and modeTopicUrl.xsl
  • Issue 121, Issue 129, Issue 143, Issue 148: Improved table generation to capture all table geometry, including horizontal and vertical alignment within cells.
  • Issue 139: Fixed issue with hyperlinks not being generated when @xtrc attributes were filtered out.
  • Handle characters in non-Unicode, Word-specific Symbol and Wingdings fonts. These characters should be translated to the correct Unicode character when there is a Unicode character to use.
  • Issue 63: Improved generation of hyperlinks.
  • Issue 33: Implemented generation of footnotes from Word footnotes.
  • Issue 135: Corrected handling of nbsp references in inline MathML markup.
  • Issue 120: Enable capturing of MathML from "inline" MathML created by MathType from MathType equations.
  • Issue 114: Capture width and height of embedded images as sized in the Word doc.
  • Feature 6, Issue 103: Enable generation of globally unique filenames by providing parameter for filename prefix.
  • Issue 101: Provide parameter to use filenames of linked graphics when there is a linked graphic.

DITA to InCopy

New features:

  • Feature 20: Include map resolution library in base DITA-to-InCopy transform.

Fixed bugs:

  • Issue 133: Corrected generation of ICML table markup, various improvements in generated table geometry.
  • Issue 119: Corrected handling of table titles with non-numeric numbers.
  • Issue 72, Issue 113: Correctly escape grouped style names in style catalog.
  • Issue 94, Issue 107: Handle outputPath correctly in topic2articleIcml.xsl
  • Issue 85: Corrected order of imports in dita2indesign_template.xsl module.

Transformation Types

New features:

  • Feature 7: Implemented support for generating HTML5 video and audio markup. Uses new d4p_mediaDomain specialization module.

Fixed bugs:

  • Added XSLT parameter extension points to all transform types
  • Issue 165: Correctly include descendants of sections in enumerables.
  • Issue 164: Correct issue with extra vertical space for <br> in PDF.
  • Issue 155: Correct generation of EPUB list of tables only process list of tables once.
  • Issue 151: Corrected name of parameter extension point for EPUB transformation type.
  • Issue 150: Corrected resolveTopicElementRef() to trap and report case where containing document can't be resolved.
  • Issue 149: Corrected duplicate capturing of enumerables when @chunk is "to-content".
  • Issue 147: Corrected xs:int to xs:integer is dita-support-lib.xsl.
  • Issue 146: Correctly handle toc="no" in HTML2 transform.
  • Issue 142: Corrected generation of duplicate IDs for enumerables.
  • Issue 140: Corrected handling of @locktitle for navtitles on topicrefs
  • Issue 124: Include @type attribute on <link> elements in generated HTML for EPUB and Kindle transforms.
  • Issue 123: Include references to OT catalog in all XSLT calls from D4P transforms.
  • Issue 112: Corrected duplication of index entries in collected index data.
  • Issue 111: Added XSLT parameter extension point to all transforms as for base XHTML transform.
  • Issue 91: Correctly detect failure to resolve topicref in resolve-map.xsl.
  • Issue 89: Corrected failures in graphviz transform.
  • Issue 86: Use base-uri() for resolving relative URI references. Affects DITA support library.
  • Issue 73: Corrected generation of HTML5 video and audio markup. Copying of referenced media objects not yet implemented.
  • Issue 48: Resolve keyrefs in df:getEffectiveTopicUri() function (dita-support-lib.xsl)
  • Issue 43: Generate @type attribute in HTML for EPUB and Kindle.
  • Issue 42: Corrected setting of generateStaticTocBoolean parameter.
  • Issue 39: Correctly handle flagging parameters in HTML2. Issue with copying flagging graphics not yet addressed.
  • Issue 37: Use simple enumeration extensions in EPUB transform.


New features:

  • Feature 7: New specialization domain, d4p_mediaDomain, that provides specializations of <object> that mirror the HTML5 <video> and <audio> elements.

Fixed bugs:

  • Issue 72, Issue 168: Use a D4P-specific URN for the reference to the MathML module. This avoids problems where two different DTDs both include MathML.
  • Issue 136: Added missing @class attribute for <d4pPageRange>.
  • Issue 99: Added missing catalog inclusion for xmlDomain.
  • Issue 98: Corrected case and spelling of system IDs for d4p_commonDomainIntegrations external parameter entities.