Maintenance Release 2.5.1
DITA Open Toolkit Release 2.5.1 includes the following bug fixes.
In DITA-OT 2.5 and earlier, key resolution did not comply with the DITA specification's requirement to use
<linktext>from a key definition as valid replacement text for all uses of that key. #1590, #2014, #2719In addition, several less common cases are fixed:
- Previously, a
<keyword>anywhere within the key definition was used as the first choice for link text, even if that keyword was located within
<linktext>. As defined by the DITA specification, the replacement keyword is taken only from within
- Previously, the
@navtitleattribute was used as fallback text in some cases, while
<navtitle>was ignored. The
<navtitle>element is now used before checking the deprecated
@navtitlevalue for all cases.
@navtitlewas used as link text even for local DITA topics where that value was ignored in favor of a navigation title in the topic. Now
<navtitle>are only used when locked or when the topic is not local DITA.
- Previously, a
- In some cases, invalid DITA content resulted in build crashes from PDF, XHTML, or HTML5
processing modules that expect required elements to be present. For example, this could happen when an
element such as
<ol>(which requires at least one list item) used DITAVAL filtering to exclude all items from the list. The code has been updated to more gracefully handle elements that are missing required children. #2701, #2712
- One DITA 1.3 RNG module from the OASIS DITA Standard contained a typo in a default attribute value. The typo will be corrected in the next DITA 1.3 errata, and is now fixed in the DITA-OT copy. #2705
- On Windows only, chunking a DITA document using the "by-topic" method would lose the root chunk and result in processing errors. The chunking process has been updated to handle Windows file paths correctly; the chunking process now produces the same results on all systems. #2706, #2728
- HTML5 output restores support for the
<simpletable>elements and for the
<stentry>elements. Support for those attributes was missing after the HTML5 and XHTML code bases split in release 2.4. #2714
- In the original 2.5 release, a
<topicref>that included a reference to a local topic ID (such as
href="file.dita#root") could cause build failures when another element in the document used the same ID. The reference is now handled properly. #2716
For the complete list of changes since the previous release, see the changelog on GitHub.