DITA release notes

DITA OT release 1.5

Release 1.5 is a major release based on the new DITA 1.2 draft standard. It contains full support for DITA 1.2 draft as defined in the fall of 2009 (prior to public review).

In addition to DITA 1.2 support, release 1.5 contains the following updates, which are available in Milestone 21 or earlier of the DITA-OT test builds:

[General Enhancements]

  1. New parameter to generate output for only the topics referenced in a map
  2. Use fileparameter in Ant 1.7 to replace processing instruction in intermediate dita files
  3. Determine the version of DITA-OT via the class org.dita.dost.util.Version
  4. Remove duplicate ids in PDF topicmerge
  5. Move Notices before the TOC, suppress in the TOC and suppress the second copy after the TOC
  6. Include @scope="peer" condition when creating rel-links.

[SourceForge Enhancements Added]

  1. 2859612 Add support for Serbian (Latin)
  2. 2845278 Add Ant parameters for XSLT parameters
  3. 2824371 Support Hindi and Urdu for XHTML output
  4. 2790755 Process in unique temp directories (Designed to allow multiple builds to take place at once)
  5. 2780998 startcmd.sh: Run the user's shell, not sh
  6. 2698921 Add a way to set attributes on <body>
  7. 2120219 Add PDF to the supported image
  8. 2002857 homeID in javahelp .hs file is not set
  9. 1725284 add support for headings for sections within task (XHTML only)
  10. 1623246 Support RFC4646 language tags in Index modules
  11. 1367897 Xref content generation enforces formatting choices
  12. 2882109 Convert named PDF templates to mode template
  13. 2883406 Add extension point for modifying PDF link text
  14. 2882870 Add parameter to control PDF Chapter style
  15. 2882103 Provide hook for specializations to add custom headers
  16. 2882072 Add parameter to control PDF bookmarks (default collapsed)

[93 SourceForge Bugs Fixed]

  1. 2860433 Keyref on <image> fails to resolve
  2. 2860199 Chunk to-content in submap resulting in missing output
  3. 2860168 Suppress data and data-about in PDF output
  4. 2857167 conrefImpl.xsl 1.6.4.13 has duplicate variable decls
  5. 2856742 Problem of keys attribute in nested topicref elements
  6. 2854546 Peer xref leads to invalid destination error in PDF
  7. 2849200 Style on ditaval prop or revprop is ignored
  8. 2846111 Unnecessary text generated for external xref
  9. 2845598 1.5-M18-demo/fo/Customization pdf.formatter
  10. 2842753 catalog-dita.xml has invalid entries
  11. 2839035 Chunk code cannot parse xref with &
  12. 2832696 Move meta module pushes content into non-DITA file
  13. 2829350 Build_demo.xml places files in incorrect directory
  14. 2826143 Move meta module discards link text
  15. 2824907 1.5 M17 Bug - FileNotFoundException export.xml eclipsehelp
  16. 2819853 missing nested indexterm after 3rd
  17. 2815492 PDF: keep-with-next on shortdesc
  18. 2815485 Prolog indexterm not processed properly for PDF
  19. 2813082 Eclipse help MANIFEST.MF filename wrong case, needs CRLF
  20. 2811980 pdf2: japanese translate for generated page number of a ref
  21. 2811358 Incorrect entry@colname in middle file at PDF generation
  22. 2804442 Bad param name in prereq-fmt template's call to sect-heading
  23. 2799543 Child links in HTML Help output are wrong
  24. 2797030 Chunking fails with bookmap
  25. 2796614 Leading slash breaks PLUGINS_ROOT usage for Eclipse help
  26. 2791696 reltable DITA 1.2 (#12048)
  27. 2791345 Topicmeta searchtitles in map not used in topic
  28. 2791278 Keyref Resolution Fails for Non-Descendant Topics
  29. 2790807 Demo code should use new PDF output
  30. 2788069 Topicmerge does not handle copy-to properly
  31. 2788069 Topicmerge does not handle copy-to properly
  32. 2782503 Extra space before bullet list in xhtml output DITA-OT 1.4.3
  33. 2774128 startcmd.sh is encoded with DOS line endings in v1.5 M13
  34. 2759964 HTML outputs filters conditional topics poorly
  35. 2759964 HTML outputs filters conditional topics poorly
  36. 2748371 Revision + ID gives XSL error
  37. 2739236 plus-allhtml-svgobject handles <alt> badly
  38. 2724090 XHTML: conreffed by-reference footnotes break w/ chunking
  39. 2723928 gen-toc template not matching properly
  40. 2723715 Itemgroup sets @id when element is not open
  41. 2712074 XHTML: chunk=to-content on map breaks by-reference footnotes
  42. 2706725 Single quote inserted in empty table cells in FO
  43. 2696229 FO plugin code incompatible with Saxon 9 (OT1.4.3 default)
  44. 2696191 Java libraries missing from 1.4.3 distributions
  45. 2647292 HTML stylesheets should style <wintitle> and <filepath>
  46. 2629271 maplink: should not modify href if scope=external
  47. 2629256 mapref: should not modify href if scope=external
  48. 2573681 Move link module does extra processing
  49. 2547437 zh_TW.properties and zh_CN.properties contents are mixed up
  50. 2418932 toc attribute does not work for references to ditamaps
  51. 2317681 Extra files generated when many topics are chunked to one
  52. 2317581 inline formatting in shortdesc
  53. 1931457 Need to identify transtype during XHTML output step
  54. 1629094 docbook creates empty simplelists
  55. 1628936 transtype=docbook does not handle publisher and copyright element
  56. 2849078 Problems using keyrefs with DITA OT 1.5 M19 - ID: 2849078
  57. 2875373 tm in linktext is dropped
  58. 2870935 keyref within topics ignore @copy-to attributes
  59. 2873560 SWF flash not defined as resources to be copied
  60. 2872954 Conref push not working at map level
  61. 2871009 Temp directory leaves behind single directory and file
  62. 2866322 Generated links have bad URLs
  63. 2873654 PDF missing rules for new DITA 1.2 content elements
  64. 2872988 Bad relcolwidth crashes PDF output
  65. 2866204 Topicref with keyref fails to produce output
  66. 2878446 Issue with ampersand in xrefs in attributes
  67. 1629096 docbook creates invalid varlistentry
  68. 2871326 Cannot use different TOC titles for same topic in PDF
  69. 1880097 PDF2 ingnores contents of <xref> elements
  70. 1815571 Invalid property in fo:table-body
  71. 2879171 Shortdesc & Abstract formatting is incorrect for PDF
  72. 2882085 Obsolete code in PDF plug-in should be removed
  73. 2661418 make the TOC in pdf2 output link to topics in pdf
  74. 2871017 eclipsehelp plugin.xml invalid in 1.5M20
  75. 2887331 chunk="to-content" on a sub-map causes path error
  76. 2891736 indexterm in topicref level are copied into topic/prolog
  77. 2893316 This is a bug in the integrator.xml
  78. 2893493 ${clean.temp} is not set to true per documentation
  79. 2893664 ampersand entity with conref actions causes build to fail
  80. 2893924 htmlhelp transtype requires video plugin
  81. 1628937 Rename supportingboth.ditaand.xmlinaditamap.dita
  82. 1771123 Inappropriate Message 018 On type= value
  83. 1819660 Eclipse Help issue producing toc file.
  84. 1848313 ditaval file sent to XSLT not URL
  85. 1897542 Chunk to-content may need to rewrite topic IDs
  86. 2875946 PDF: table @pgwide semantics not implemented
  87. 2893745 missing fop's file/directory in standard package
  88. 2900047 map2htmtoc.xsl doesn't allow for extension of root template
  89. 2900417 html transform does not use image/@scale properly
  90. 2906957 Update Eclipse plugin DTDs and packaging
  91. 2796964 Use xml:lang for generated text in PDF
  92. 2860596 PullPrologIndexTerms selection too wide, Removed spurious pullPrologIndexTerms in section/title
  93. 1852733 Image "scale" attribute is ignored

[4 SourceForge Patches Added]

  1. 2790337 Add extension points to related-links code
  2. 2778178 Flagging code duplicates XSL
  3. 2715750 plus-transtype-htmlhelp: support alternate compilers
  4. 2804311 Feature value trim test bug
Note: SourceForge bugs, patches, and RFEs listed above can be found in SourceForge Bugs, Patches, and RFE tracker pages:
  • Bugs tracker:
    http://sourceforge.net/tracker/?group_id=132728&atid=725074
            
  • Patches tracker:
    http://sourceforge.net/tracker/?group_id=132728&atid=725076
            
  • RFE tracker:
    http://sourceforge.net/tracker/?group_id=132728&atid=725077
            

DITA OT release 1.4.3

Release 1.4.3 is a maintenance release and is intended to be the last released based fully on DITA 1.1. It contains a significant amount of preview function for the upcoming DITA 1.2 standard, but the DITA 1.2 document types must be specifically referenced in order to use this capability.

The 1.4.3 release contains the following major updates:

  1. The PDF codebase switched from the older deprecated code to the plugin previously known as PDF2. Running a build with the transform type PDF or PDF2 will now run the new code. To continue using the older code, set your transform type to "legacypdf".
  2. The PDF plugin now runs with FOP, as well as with the latest version of Saxon.
  3. The Full Easy Install package now ships with Saxon 9B instead of with Xalan, and code in the DITA-OT package has been updated to work with Saxon 9B.
  4. The Full Easy Install package updates the versions of many open source libraries (including Ant and FOP)
  5. RFE 1982567 Allow spaces in DITA file names
  6. Preview function for the majority of the upcoming OASIS DITA 1.2 standard, including everything from milestone builds one through twelve of DITA-OT 1.5

[10 SF Enhancements Added]

  1. 1982567 Allow spaces in DITA file names
  2. 2631145 dita2htmlImpl.xsl should not define doctype
  3. 2562718 Rename the ant directory to avoid naming collisions with ant
  4. 2314086 Let maplink generate <linklist> elements
  5. 2258659 Extend integrator to allow addition of messages.
  6. 2117337 Customize Integrator to integrate custom directories
  7. 2074933 Make index output for new transtypes more extensible
  8. 1995667 Add plugin extension points to preprocess pipeline
  9. 1972537 Let users specify reloadstylesheet on xslt tasks
  10. 1803199 Allow ability to include class ancestry in XHTML class attribute

[4 SourceForge Patches Added]

  1. 1996733 Structure Ant <pipeline> better
  2. 1796007 Refactor of related links HTML for specialized processing
  3. 1947566 pdf2: allow XEP to be installed elsewhere
  4. 2477370 Refactor of conrefImpl.xsl

[31 SF Bugs Fixed]

  1. 2008294 End flag does not work in ditaval
  2. 2078563 Keyref not working for external links
  3. 2027170 maprefImpl.xsl removes part of class attr from topichead
  4. 2027058 Topichead element stops map processing in ChunkMapReader
  5. 2001268 DITA-OT documentation wants JDK 1.4
  6. 2008317 Chunking one topic from a large file hogs memory
  7. 2219479 <prodinfo> subelement associations are lost in HTML output
  8. 2340727 No link in TOC to topics in ditabase
  9. 2317627 Chunking map to create one file should use map file name
  10. 2143078 Relcolwidth not respected in choicetable
  11. 1995223 bookmap: bookmeta->bookrights information is not generated
  12. 1990167 reltable doesn't generate external links correctly
  13. 1953553 FO 1.4.2 plugin: Inconsistent display of "on page" in xref
  14. 1951879 Link generation is disabled for bookmaps
  15. 1997171 topic body suppressed in chapter topics
  16. 2417980 Toolkit should support both versions of Serbian lang code
  17. 1947817 Extra topics appear in PDF output when using reltables
  18. 2004588 Image alt text needs space normalized
  19. 1954463 Conditional processing multiple PDFs in the same JVM
  20. 2061301 Useless import of xslt4j stops dost.jar being built
  21. 2317659 Chunking "by-topic" does not work
  22. 1955211 Footnotes-by-reference rendered naively
  23. 2010062 Spaces dropped in indexterm that has keyword
  24. 2607496 USEINDEX=no breaks HTML Help HHP
  25. 2570118 <xref> without href drops content
  26. 2414891 Map contains wrong reference after chunking
  27. 2010092 example or section title can be orphaned in PDF2
  28. 1999117 Ubuntu 8.04 | startcmd.sh doesn't work
  29. 2020317 Many duplicated id in xxx_MERGED.xml in PDF2 output.
  30. 2614006 Conref processing ignores -dita-use-conref-target
  31. 1727863 <groupchoice> has an extra "|" character
Note: SourceForge bugs, patches, and RFEs listed above can be found in SourceForge Bugs, Patches, and RFE tracker pages:
  • Bugs tracker:
    http://sourceforge.net/tracker/?group_id=132728&atid=725074
            
  • Patches tracker:
    http://sourceforge.net/tracker/?group_id=132728&atid=725076
            
  • RFE tracker:
    http://sourceforge.net/tracker/?group_id=132728&atid=725077
            

DITA OT release 1.4.2.1

Release 1.4.2.1 is a full build to provide an urgent fix to fix the following critical problem which users found in release 1.4.2.

  1. SF Bug 1956231 OSGI Manifest for eclipsehelp transtype contains spaces.

For this fix, we have updated xsl/map2pluginImpl.xsl to prevent generating extra spaces at the head of every line in OSGI manifest file of eclipse help output.

DITA OT release 1.4.2

Release 1.4.2 is a maintenance release to fix defects and make patches based on release 1.4.1

Release 1.4.2 comes in three versions:

  1. Minimal package contains only the core processing code.
  2. Standard package contains the core processing code, plus demos, documentation, and samples.
  3. Full "easy install" package contains the standard package plus external libraries useful for many toolkit processes (such as Xalan and ANT), plus a batch file to setup a local environment.

[39 SF Bugs Fixed]

  1. 1945824 Index-see works for "ru-ru" but not for "ru"
  2. 1944245 Null pointer error with complex filename
  3. 1923519 Conrefs in nested, conreffed topics don't work
  4. 1911285 files.txt is not up-to-date
  5. 1906954 Constants.ANT_INVOKER_EXT_PARAM_OUTPUTDIR resulted in null ...
  6. 1903830 Error when collection-type=sequence in map
  7. 1903626 Topicref to Glossentry With Topicmeta Throws Null Pointer
  8. 1900907 Documentation of generateouter command-line param is incorrect
  9. 1900427 TIFF file format not a supported type
  10. 1898810 Problem running ant with DITA-OT in path with Latin char
  11. 1897358 Compiling CHM's in sequence results in errant index entries
  12. 1894561 wordrtf not correctly handling p inside li
  13. 1893234 Java TopicMerge removes processing instruction
  14. 1868423 Null pointer exception when a PI is at the end of the file
  15. 1857405 chunk processing fails when no section element
  16. 1855047 startup.sh fails under OS X
  17. 1849346 FO file generated from DITA MAP not valid
  18. 1843652 Image referenced in map is not found, topicmerge breaks
  19. 1843583 Extra bullet in TOC for topicref with no href or navtitle
  20. 1839765 index-sort-as not used, content appears in index
  21. 1908306 Index entry for external resource is ignored
  22. 1908293 HTML Help index contains extra anchor
  23. 1900916 Pointer to CSS is Incorrect in index.html
  24. 1898451 HTML titles should be space-normalized for CHM consumption
  25. 1898228 Table desc not being processed
  26. 1897551 maplink is unawareof chunk to-content
  27. 1893461 map file href handling
  28. 1889918 Index link goes with wrong entry
  29. 1883907 IndexTermReader class doesn't handle specialized titles
  30. 1873401 XHTML: colsep in last column when @frame=none
  31. 1872434 _merge.xml missing metadata
  32. 1868047 htmlhelp path in demo ant script is fixed
  33. 1864247 PIs missing from ditamaps in temp dir
  34. 1857282 path to css output is not correct
  35. 1848355 gen-list wants class on <foreign> descendants
  36. 1843693 Bad XREF syntax gives confusing message about unique_193
  37. 1841175 Need to clean up doc/ directory (remove invalid items)
  38. 1832800 Empty end-range indexterm causes eclipse error
  39. 1606387 Shortdesc & Abstract formatting is incorrect for XHTML

[3 SF Patches Added]

  1. 1930220 Simplify flag templates
  2. 1876118 Add plug-in support for string resource-files
  3. 1818318 Path to HTML Help compiler on x64 Windows

[6 SF Enhancements Added]

  1. 1855523 Pass dost.class.path to XSLT tasks
  2. 1827322 Let plugins add their own template files
  3. 1825843 Let plugins add dependencies to Ant targets
  4. 1824466 Subclass ImportAction
  5. 1782256 Let plugins not have to choose to go in "demo" or "plugins"
  6. 1859421 Add plug-in support for string resource-files
Note: SourceForge bugs, patches, and RFEs listed above can be found in SourceForge Bugs, Patches, and RFE tracker pages:
  • Bugs tracker:
    http://sourceforge.net/tracker/?group_id=132728&atid=725074
            
  • Patches tracker:
    http://sourceforge.net/tracker/?group_id=132728&atid=725076
            
  • RFE tracker:
    http://sourceforge.net/tracker/?group_id=132728&atid=725077
            
Related concepts
DITA futures
Building DITA output with Ant
Building DITA output with Java command line
Migrating HTML to DITA
DITA to Word output transform
Related reference
Problem determination and log analysis
Known Limitations
Troubleshooting
Related information
DITA release history
Tested platforms and tools
Using DITA transforms