This document lists major changes and new features by release.
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]
- New parameter to generate output for only the topics referenced in a map
- Use fileparameter in Ant 1.7 to replace processing instruction in intermediate dita files
- Determine the version of DITA-OT via the class org.dita.dost.util.Version
- Remove duplicate ids in PDF topicmerge
- Move Notices before the TOC, suppress in the TOC and suppress the second copy after the TOC
- Include @scope="peer" condition when creating rel-links.
[SourceForge Enhancements Added]
- 2859612 Add support for Serbian (Latin)
- 2845278 Add Ant parameters for XSLT parameters
- 2824371 Support Hindi and Urdu for XHTML output
- 2790755 Process in unique temp directories (Designed to allow multiple builds to take place at once)
- 2780998 startcmd.sh: Run the user's shell, not sh
- 2698921 Add a way to set attributes on <body>
- 2120219 Add PDF to the supported image
- 2002857 homeID in javahelp .hs file is not set
- 1725284 add support for headings for sections within task (XHTML only)
- 1623246 Support RFC4646 language tags in Index modules
- 1367897 Xref content generation enforces formatting choices
- 2882109 Convert named PDF templates to mode template
- 2883406 Add extension point for modifying PDF link text
- 2882870 Add parameter to control PDF Chapter style
- 2882103 Provide hook for specializations to add custom headers
- 2882072 Add parameter to control PDF bookmarks (default collapsed)
[93 SourceForge Bugs Fixed]
- 2860433 Keyref on <image> fails to resolve
- 2860199 Chunk to-content in submap resulting in missing output
- 2860168 Suppress data and data-about in PDF output
- 2857167 conrefImpl.xsl 1.6.4.13 has duplicate variable decls
- 2856742 Problem of keys attribute in nested topicref elements
- 2854546 Peer xref leads to invalid destination error in PDF
- 2849200 Style on ditaval prop or revprop is ignored
- 2846111 Unnecessary text generated for external xref
- 2845598 1.5-M18-demo/fo/Customization pdf.formatter
- 2842753 catalog-dita.xml has invalid entries
- 2839035 Chunk code cannot parse xref with &
- 2832696 Move meta module pushes content into non-DITA file
- 2829350 Build_demo.xml places files in incorrect directory
- 2826143 Move meta module discards link text
- 2824907 1.5 M17 Bug - FileNotFoundException export.xml eclipsehelp
- 2819853 missing nested indexterm after 3rd
- 2815492 PDF: keep-with-next on shortdesc
- 2815485 Prolog indexterm not processed properly for PDF
- 2813082 Eclipse help MANIFEST.MF filename wrong case, needs CRLF
- 2811980 pdf2: japanese translate for generated page number of a ref
- 2811358 Incorrect entry@colname in middle file at PDF generation
- 2804442 Bad param name in prereq-fmt template's call to sect-heading
- 2799543 Child links in HTML Help output are wrong
- 2797030 Chunking fails with bookmap
- 2796614 Leading slash breaks PLUGINS_ROOT usage for Eclipse help
- 2791696 reltable DITA 1.2 (#12048)
- 2791345 Topicmeta searchtitles in map not used in topic
- 2791278 Keyref Resolution Fails for Non-Descendant Topics
- 2790807 Demo code should use new PDF output
- 2788069 Topicmerge does not handle copy-to properly
- 2788069 Topicmerge does not handle copy-to properly
- 2782503 Extra space before bullet list in xhtml output DITA-OT 1.4.3
- 2774128 startcmd.sh is encoded with DOS line endings in v1.5 M13
- 2759964 HTML outputs filters conditional topics poorly
- 2759964 HTML outputs filters conditional topics poorly
- 2748371 Revision + ID gives XSL error
- 2739236 plus-allhtml-svgobject handles <alt> badly
- 2724090 XHTML: conreffed by-reference footnotes break w/ chunking
- 2723928 gen-toc template not matching properly
- 2723715 Itemgroup sets @id when element is not open
- 2712074 XHTML: chunk=to-content on map breaks by-reference footnotes
- 2706725 Single quote inserted in empty table cells in FO
- 2696229 FO plugin code incompatible with Saxon 9 (OT1.4.3 default)
- 2696191 Java libraries missing from 1.4.3 distributions
- 2647292 HTML stylesheets should style <wintitle> and <filepath>
- 2629271 maplink: should not modify href if scope=external
- 2629256 mapref: should not modify href if scope=external
- 2573681 Move link module does extra processing
- 2547437 zh_TW.properties and zh_CN.properties contents are mixed up
- 2418932 toc attribute does not work for references to ditamaps
- 2317681 Extra files generated when many topics are chunked to one
- 2317581 inline formatting in shortdesc
- 1931457 Need to identify transtype during XHTML output step
- 1629094 docbook creates empty simplelists
- 1628936 transtype=docbook does not handle publisher and copyright element
- 2849078 Problems using keyrefs with DITA OT 1.5 M19 - ID: 2849078
- 2875373 tm in linktext is dropped
- 2870935 keyref within topics ignore @copy-to attributes
- 2873560 SWF flash not defined as resources to be copied
- 2872954 Conref push not working at map level
- 2871009 Temp directory leaves behind single directory and file
- 2866322 Generated links have bad URLs
- 2873654 PDF missing rules for new DITA 1.2 content elements
- 2872988 Bad relcolwidth crashes PDF output
- 2866204 Topicref with keyref fails to produce output
- 2878446 Issue with ampersand in xrefs in attributes
- 1629096 docbook creates invalid varlistentry
- 2871326 Cannot use different TOC titles for same topic in PDF
- 1880097 PDF2 ingnores contents of <xref> elements
- 1815571 Invalid property in fo:table-body
- 2879171 Shortdesc & Abstract formatting is incorrect for PDF
- 2882085 Obsolete code in PDF plug-in should be removed
- 2661418 make the TOC in pdf2 output link to topics in pdf
- 2871017 eclipsehelp plugin.xml invalid in 1.5M20
- 2887331 chunk="to-content" on a sub-map causes path error
- 2891736 indexterm in topicref level are copied into topic/prolog
- 2893316 This is a bug in the integrator.xml
- 2893493 ${clean.temp} is not set to true per documentation
- 2893664 ampersand entity with conref actions causes build to fail
- 2893924 htmlhelp transtype requires video plugin
- 1628937 Rename supportingboth.ditaand.xmlinaditamap.dita
- 1771123 Inappropriate Message 018 On type= value
- 1819660 Eclipse Help issue producing toc file.
- 1848313 ditaval file sent to XSLT not URL
- 1897542 Chunk to-content may need to rewrite topic IDs
- 2875946 PDF: table @pgwide semantics not implemented
- 2893745 missing fop's file/directory in standard package
- 2900047 map2htmtoc.xsl doesn't allow for extension of root template
- 2900417 html transform does not use image/@scale properly
- 2906957 Update Eclipse plugin DTDs and packaging
- 2796964 Use xml:lang for generated text in PDF
- 2860596 PullPrologIndexTerms selection too wide, Removed spurious pullPrologIndexTerms in section/title
- 1852733 Image "scale" attribute is ignored
[4 SourceForge Patches Added]
- 2790337 Add extension points to related-links code
- 2778178 Flagging code duplicates XSL
- 2715750 plus-transtype-htmlhelp: support alternate compilers
- 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:
- 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".
- The PDF plugin now runs with FOP, as well as with the latest version
of Saxon.
- 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.
- The Full Easy Install package updates the versions of many open
source libraries (including Ant and FOP)
- RFE 1982567 Allow spaces in DITA file names
- 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]
- 1982567 Allow spaces in DITA file names
- 2631145 dita2htmlImpl.xsl should not define doctype
- 2562718 Rename the ant directory to avoid naming collisions with ant
- 2314086 Let maplink generate <linklist> elements
- 2258659 Extend integrator to allow addition of messages.
- 2117337 Customize Integrator to integrate custom directories
- 2074933 Make index output for new transtypes more extensible
- 1995667 Add plugin extension points to preprocess pipeline
- 1972537 Let users specify reloadstylesheet on xslt tasks
- 1803199 Allow ability to include class ancestry in XHTML class attribute
[4 SourceForge Patches Added]
- 1996733 Structure Ant <pipeline> better
- 1796007 Refactor of related links HTML for specialized processing
- 1947566 pdf2: allow XEP to be installed elsewhere
- 2477370 Refactor of conrefImpl.xsl
[31 SF Bugs Fixed]
- 2008294 End flag does not work in ditaval
- 2078563 Keyref not working for external links
- 2027170 maprefImpl.xsl removes part of class attr from topichead
- 2027058 Topichead element stops map processing in ChunkMapReader
- 2001268 DITA-OT documentation wants JDK 1.4
- 2008317 Chunking one topic from a large file hogs memory
- 2219479 <prodinfo> subelement associations are lost in HTML output
- 2340727 No link in TOC to topics in ditabase
- 2317627 Chunking map to create one file should use map file name
- 2143078 Relcolwidth not respected in choicetable
- 1995223 bookmap: bookmeta->bookrights information is not generated
- 1990167 reltable doesn't generate external links correctly
- 1953553 FO 1.4.2 plugin: Inconsistent display of "on page" in xref
- 1951879 Link generation is disabled for bookmaps
- 1997171 topic body suppressed in chapter topics
- 2417980 Toolkit should support both versions of Serbian lang code
- 1947817 Extra topics appear in PDF output when using reltables
- 2004588 Image alt text needs space normalized
- 1954463 Conditional processing multiple PDFs in the same JVM
- 2061301 Useless import of xslt4j stops dost.jar being built
- 2317659 Chunking "by-topic" does not work
- 1955211 Footnotes-by-reference rendered naively
- 2010062 Spaces dropped in indexterm that has keyword
- 2607496 USEINDEX=no breaks HTML Help HHP
- 2570118 <xref> without href drops content
- 2414891 Map contains wrong reference after chunking
- 2010092 example or section title can be orphaned in PDF2
- 1999117 Ubuntu 8.04 | startcmd.sh doesn't work
- 2020317 Many duplicated id in xxx_MERGED.xml in PDF2 output.
- 2614006 Conref processing ignores -dita-use-conref-target
- 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.
- 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:
- Minimal package contains only the core processing code.
- Standard package contains the core processing code, plus demos,
documentation, and samples.
- 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]
- 1945824 Index-see works for "ru-ru" but not for "ru"
- 1944245 Null pointer error with complex filename
- 1923519 Conrefs in nested, conreffed topics don't work
- 1911285 files.txt is not up-to-date
- 1906954 Constants.ANT_INVOKER_EXT_PARAM_OUTPUTDIR resulted in null ...
- 1903830 Error when collection-type=sequence in map
- 1903626 Topicref to Glossentry With Topicmeta Throws Null Pointer
- 1900907 Documentation of generateouter command-line param is incorrect
- 1900427 TIFF file format not a supported type
- 1898810 Problem running ant with DITA-OT in path with Latin char
- 1897358 Compiling CHM's in sequence results in errant index entries
- 1894561 wordrtf not correctly handling p inside li
- 1893234 Java TopicMerge removes processing instruction
- 1868423 Null pointer exception when a PI is at the end of the file
- 1857405 chunk processing fails when no section element
- 1855047 startup.sh fails under OS X
- 1849346 FO file generated from DITA MAP not valid
- 1843652 Image referenced in map is not found, topicmerge breaks
- 1843583 Extra bullet in TOC for topicref with no href or navtitle
- 1839765 index-sort-as not used, content appears in index
- 1908306 Index entry for external resource is ignored
- 1908293 HTML Help index contains extra anchor
- 1900916 Pointer to CSS is Incorrect in index.html
- 1898451 HTML titles should be space-normalized for CHM consumption
- 1898228 Table desc not being processed
- 1897551 maplink is unawareof chunk to-content
- 1893461 map file href handling
- 1889918 Index link goes with wrong entry
- 1883907 IndexTermReader class doesn't handle specialized titles
- 1873401 XHTML: colsep in last column when @frame=none
- 1872434 _merge.xml missing metadata
- 1868047 htmlhelp path in demo ant script is fixed
- 1864247 PIs missing from ditamaps in temp dir
- 1857282 path to css output is not correct
- 1848355 gen-list wants class on <foreign> descendants
- 1843693 Bad XREF syntax gives confusing message about unique_193
- 1841175 Need to clean up doc/ directory (remove invalid items)
- 1832800 Empty end-range indexterm causes eclipse error
- 1606387 Shortdesc & Abstract formatting is incorrect for XHTML
[3 SF Patches Added]
- 1930220 Simplify flag templates
- 1876118 Add plug-in support for string resource-files
- 1818318 Path to HTML Help compiler on x64 Windows
[6 SF Enhancements Added]
- 1855523 Pass dost.class.path to XSLT tasks
- 1827322 Let plugins add their own template files
- 1825843 Let plugins add dependencies to Ant targets
- 1824466 Subclass ImportAction
- 1782256 Let plugins not have to choose to go in "demo" or "plugins"
- 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
DITA OT release 1.4.1
Release 1.4.1 is a maintenance release to fix defects and make patches
based on release 1.4.
[23 SF Bugs Fixed]
- 1833801 Infinite loop in MapMetaReader
- 1833796 move-meta-entries creates invalid XML
- 1827055 Dita 1.4 move metadata method failing
- 1819663 XHTML processing add in output files.
- 1815155 Using xref moves output directory
- 1807808 Java TopicMerge calling XSLT transformer with URL not file
- 1806728 Merge doesn't normalize filenames
- 1806130 chunk module wraps long lines
- 1806081 <dita> without class attribute triggers warning
- 1803190 XHTML: processing <xref> to <a title="">
- 1803183 XHTML: <b> and <xref> within <pre>
- 1796207 topicmeta in ditamap causes build failure
- 1782109 Title input to Help Compiler invalid for taskbook example
- 1779066 [DOTX031E] Errors
- 1770571 Chunk "to-content" on map not implemented
- 1732678 Map without DOCTYPE declaration produces odd error
- 1675195 No Error Location for Titleless Topic
- 1639672 The Toolkit does not properly support valid xml:lang values.
- 1639344 Xref : topicpull : the spectitle not used as linktext
- 1628937 Rename supportingboth.ditaand.xmlinaditamap.dita
- 1584187 Bookmap 1.1: <title> element breaks topicmerge
- 1563093 Difficult to find location of error
- 1505172 foimgext Considered Harmful
[5 SF Patches Added]
- 1741302 Prevent indexterm crash with two-letter language codes
- 1630214 HTML Help HHP generator: Language tag
- 1498936 Failure when moving links with embedded mathml
- 1481586 CSS for ditamap-to-HTML TOC
- 1457541 xref to elements fails within topics in PDF
[5 SF RFE Added]
- 1764910 Allow greater control over the output directory
- 1764905 Allow option to build only topics listed in the map
- 1725280 Improve error reporting in general
- 1686939 Make dita.list into an XML file
- 1676947 Integration points for passing params to XSL
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
Release 1.4 is a major release to add new functions, fulfill new
requirements, make some function enhancements and fix bugs over release
1.3.1. Available since August 1, 2007
The DITA-OT Release 1.4 contains full support for the OASIS DITA 1.1 standard.
This completes the preliminary support added in the 1.3 and 1.3.1 versions of
the toolkit. New and improved items for 1.1 are listed under [Improvements]
below. Support for the new bookmap standard is available in the latest version
of the FO plug-in, which uses the "pdf2" transform type; it will be released
together with or soon after the release of DITA-OT 1.4. The deprecated "pdf"
transform type has not been updated for the new bookmap.
Together with DITA 1.1 support, the toolkit development team has improved
error reporting so that build failures are more accurately reported at the end
of the build. Error handling will continue to improve in future releases.
Release 1.4 comes in two versions. The full version contains several external
packages that are useful or critical to running the toolkit, such as Xalan and
the XML Catalog resolver. The smaller package contains only core toolkit code.
NOTE ABOUT DEPRECATED CODE: changes for the new DITAVAL standard required
a change to code in dita2htmlImpl.xsl. The "flagit" named template is deprecated
and will not work with the new ditaval format. Overrides to this step should be
updated to use "start-flagit" and "end-flagit". The flagit template will continue
to work with the old ditaval but will generate a warning for each call.
Changes:
-
Release 1.4 improves the processing of DITA documents using XML Schemas.
One was able to process these type of documents in Release 1.3.1 but it
meant that the schema location had to have the ablsolute location of the
schema in order for the Toolkit properly.
DITA 1.1 introduces the use of URNs to normatively identify the schemas
used for validation. The URNs have the following desing pattern
"urn:oasis:names:tc:dita:xsd:<schemaDocument>:1.1". You should use these in
as the value for the attribute xsi:noNamespaceSchemaLocation.
[13 Improvements]
- Support <title> in map
- Ignore Index-base in default processing
- Retrieve the link text from abstract element.
- Format shortdesc in abstract appropriately
- Add standard code to allow overrides to easily process generalized version of unknown and foreign element
- Support @dir on every element
- Refactor mapref resolution
- Support generalization and re-specialization of unknown/foreign elements
- Replace Move Index module with new Move Metadata module
- New DITAVAL standard support
- New chunk attribute support
- Support XML Schema validated instance document processing using XML Catalogs
[17 SF Bugs Fixed]
- 1700561 Null Pointer Exception on Missing domain= Attribute
- 1733264 pretty.xsl is broken
- 1619074 table in step screws up following steps for HTML generation
- 1728700 GenMapAndTopicList keeps filtering when called a second time
- 1732562 DitaWriter.java can duplicate @xtrf and @xtrc
- 1733108 Update Bookmap sample files to DITA 1.1
- 1706263 Conrefing from a map to topic is not working properly
- 1677620 Non-DITA file is treated as DITA in pre-process
- 1717471 Links show up more than once
- 1712543 gen-list-without-flagging : NullPointerException
- 1652892 Invalid hdr/ftr arg value causes build failure
- 1647950 PIs in DITA source are dropped in the processing pipeline
- 1644559 Force Toolkit to use private catalog to allow schemas to work properly
- 1642138 Move javamerge target out of build_template.xml
- 1643155 Map TOC is HTML even for transtype="xhtml"
- 1637564 topicpull breaks specializations of xref
- 1676968 Plugins adding to classpath break when basedir != dita.dir
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.3.1
Release 1.3.1 is a maintenance release to fix defects and make patches based on release 1.3.
[15 SF Bugs Fixed]
- SF Bug 1385642 docbook/topic2db.xsl - shortdesc
- SF Bug 1528638 wordrtf does not correctly number steps
- SF Bug 1562518 Flag is confusing when a list is mixed with text
- SF Bug 1563665 Should use CSS to honor rowsep and colsep in table entries
- SF Bug 1567117 Xref to footnote is not resolved correctly
- SF Bug 1569671 <reltable> in nested map creates bogus TOC entries
- SF Bug 1573996 Plugins do not work in plugins directory
- SF Bug 1574011 Spaces in a file name prevent XHTML output
- SF Bug 1584186 Bookmap 1.1: <title> element duplicated in mappull
- SF Bug 1588039 Conref domain checking is sub-par
- SF Bug 1588624 OT v1.3 map2hhc.xsl error
- SF Bug 1597444 Java topicmerge breaks when text contains less-than
- SF Bug 1597473 Nothing references common.css
- SF Bug 1598109 Java topicmerge does not rewrite image/@href
- SF Bug 1598230 jhindexer of JavaHelp breaks Search Index for DITAOT content
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.3
OASIS DITA 1.1 support
Things to know about OASIS DITA 1.1 support in this release:
- DITA-OT 1.3 provides preliminary processing support for the upcoming OASIS DITA 1.1 specification (see http://wiki.oasis-open.org/dita/Roadmap_for_DITA_development). Because the proposed OASIS DITA 1.1 DTDs and Schemas are fully backwards compatible with the latest DITA 1.0.1 DTDs and Schemas, the 1.3 Toolkit provides the proposed 1.1 materials as the default DTDs for processing. The XML Catalog resolution maps any references for DITA 1.0 doctypes to the 1.1 DTDs, for example. All processing ordinarily dependent on the 1.0 definition continues to work as usual, and any documents that make use of the newer 1.1-based elements or attributes will be supported with specific new processing function (such as base support for the new <data> element). Documents created with the proposed OASIS DITA 1.1 DTDs are the only ones ever likely to have features that invoke the specific new 1.1-based processing support.
Important: Because this support is based on a yet-to-be-approved version of the proposed OASIS DITA 1.1 specification, if you choose to investigate any1.1-based function, be aware that the 1.1 implementation in this version of the Toolkit is preliminary and very much forward-looking. Upon final approval of the DITA 1.1 standard, Toolkit developers will, of course, review our implementation to make certain that it conforms to the defined level of reference implementation.
- Related to the DITA 1.1 preliminary implementation, the much-discussed bookmap updates for DITA 1.1 will be provided as override capabilities for the FO plugin (Idiom's donation). Note that:
- The FO demo transform code at the 1.2.2 level is still included in the DITA 1.3 package, but is now deprecated.
- To get the FO updates for 1.3, grab the FO plug-in at its next update, which should be shortly after the 1.3 core Toolkit code is released.
- The updated FO plug-in will be usable with FOP as well as with XEP.
Changes
The DITA Open Toolkit team understands the need for stability in essential APIs in the Toolit. This verson of the toolkit provides some strategic updates that correct some long-overdue faults in the original implementation. Necessarily, there are some changes to note:
- Change to build.xml: To make the DITA processing environment more like other Ant-driven build environments, the original build.xml has been renamed as build_demo.xml. The current build.xml in this release is now the normal ANT script entrance for starting a transformation. If you have created Ant tasks that tried to work around the former build.xml architecture, those might need to be revised to take advantage of the separated function.
- Change to command line invocations: The "Ant refactoring" exercise for this release has changed some previously documented Ant calls for running demos. This change enables better use of the Ant modules for power users who need to integrate the Toolkit into programming build environments such as Eclipse, but the change affects some documentation. This is a permanent change that should remain stable from now on. Wherever you see an older instruction like "c:\dita-ot>ant all", you now need to indicate the component that contains the demos, so you would type "c:\dita-ot>ant all -f build_demo.xml".
- Separation of demo targets from formal component targets: Another effect of the Ant refactoring is that the internal programming targets will now be displayed when you type "ant -p". To see both those programmings targets and the demos that are part of this component, type "c:\dita-ot>ant -p -f build_demo.xml". To run just one of the demos that you see in the resulting list, dita.faq for example, type "c:\dita-ot>ant dita.faq -f build_demo.xml".
- Classpath update to enable catalog resolver: This release now includes the Apache catalog resolver for improved lookup of DTDs by any of the Toolkit components. The fullpackage version of the Toolkit sets up these variables for each session. For the regular (smaller) version of the Toolkit, you need to include lib and lib\resource\resolver.jar into your classpath. For example if your CLASSPATH is like:
c:\dita-ot\lib\dost.jar
you need to change it to:
c:\dita-ot\lib;c:\dita-ot\lib\dost.jar;c:\dita-ot\lib\resolver.jar
At any time, the full version can be used like a normal installation as long as you update the system variables either in the evironment settings or in a batch file that sets up the shell environment.
- License bundling: To reduce the duplication of builds on Sourceforge in which the only difference was the license provided in each, both the Apache and CPL licenses are included in root directory of the Toolkit. Use the one that applies to your situation.
- Two install options: Two download versions are now offered. The smaller one is for updating existing installations or for reuse in embedded applications that already provide the other processing components--business as usual. A new package with "fullpackage" in the name now incorporates the essential processing modules to create a processing environment for new users and evaluators that requires nothing more than to unzip the file into an appropriate directory and then click on a "start" batch file. A new document in its root directory (an output of doc/EvaluateOT.dita, "Evaluating the DITA Open Toolkit (fullpackage version)") informs new users how to install and use the Toolkit for the first time.
- Other enhancements: The public design discussions that fed into the final selection and architectures for this release are documented at the DITA Focus Area in a topic called "DITA OT 1.3 Issues tracking" (http://dita.xml.org/node/1282).
[7 Improvements]
- Preliminary support for OASIS DITA 1.1
- Support ICU in index sorting
- Integrate with Eclipse
- Refactor Ant script for easy override
- Topicmerge reimplementation in JAVA
- Enable XML Catalog Resolver
- Full package distribution (was GUI/usability)
[21 SF Bugs Fixed]
- SF Bug 1582506 Docbook cannot handle <author>
- SF Bug 1548189 Sections should not jump to <h4> for Accessibility reasons
- SF Bug 1548180 Spaces dropped from index terms
- SF Bug 1548154 XHTML index links should go to the topic
- SF Bug 1545038 CommandLineInvoker is unfriendly towards spaces
- SF Bug 1541055 topicref @id incorrectly uses NMTOKEN type
- SF Bug 1530443 dost.jar relies on the incorrect behavior of Xerces
- SF Bug 1473029 Syntax code makes overrides difficult
- SF Bug 1470101 Metadata in topics is left out of XHTML headers
- SF Bug 1470077 Choicetable headers create attribute inside attribute
- SF Bug 1470057 Step template creates attributes after creating tags
- SF Bug 1465947 <topichead> without children the whole branch to disappear
- SF Bug 1465941 Keywords defined in map are ignored if <topicref> contains t
- SF Bug 1465866 Problems in catalog-dita.txt
- SF Bug 1460447 <morerows> not well supported in pdf tranformation.
- SF Bug 1457187 'copy-to' doesn't actually copy files
- SF Bug 1454835 OT renders files referenced via conref only
- SF Bug 1427808 Should be easier to modify link attributes in XHTML
- SF Bug 1422182 @colname renaming needs to apply to @namest and @nameend
- SF Bug 1417820 fo and docbook outputs can\'t handle deep topic dirs
- SF Bug 1368997 PDF Vertical list of author redundancy
[1 SF Patch Added]
- SF Patch 1503296 Refactor of HTMLHelp inifiles creation
[1 SF RFE Added]
- SF RFE 1160960 Enh: Toolkit should work with both both *.dita and *.xml
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.2.2
Release 1.2.2 is a maintenance release to fix defects and make patches based on release 1.2.1.
Improvements
- Chinese support in WORD RTF
- Improve plug-in architecture in plug-in dependency handling
SF Changes
- SF Bug 1461642 Relative paths in toolkit.
- SF Bug 1463756 TROFF output is not usable
- SF Bug 1459527 Properties elements should generate default headings
- SF Bug 1457552 FO gen-toc does not work right for ditamaps and bookmaps
- SF Bug 1430983 Specialized indexterm does not generate entries in index
- SF Bug 1363055 Shortdesc disappears when optional body is removed
- SF Bug 1368403 The dita2docbook transformation lacks support for args.xsl
- SF Bug 1405184 Note template for XHTML should be easier to override
- SF Bug 1407646 Map titles are not used in print outputs
- SF Bug 1409960 No page numbers in PDF toc
- SF Bug 1459790 Related Links omitted when map references file#topicid
- SF Bug 1428015 Topicmerge.xsl should leave indentation alone
- SF Bug 1429400 FO output should allow more external links
- SF Bug 1405169 Space inside XHTML note title affects CSS presentation
- SF Bug 1402377 Updated translations for Icelandic
- SF Bug 1366845 XRefs do not generate page numbers
- SF Patch 1326450 Make ${basedir} mine
- SF Patch 1328264 FOP task userconfig file
- SF Patch 1385636 Tweaks to docbook/topic2db.xsl
- SF Patch 1435584 Recognize more image extensions
- SF Patch 1444900 Add template for getting input file URI
- SF Patch 1460419 Add a new parameter /cssroot:{args.cssroot}
- SF Patch 1460441 map2hhp [FILES] include
- SF RFE 1400140 Add a new parameter /cssroot:{args.cssroot}
DITA OT release 1.2.1
Release 1.2.1 is a maintenance release to fix defects and make patches based on release 1.2.
Improvements
- Corrupt table generated in WORD RTF is fixed
- Pictures are merged into the WORD RTF instead of creating links to them
- lq element is supported in WORD RTF
- Generated text can be translated to different languages in WORD RTF
- In WORD RTF, if no <choptionhd> given, head will be generated in table
SF Changes
- SF Bug 1460451 Spaces preserving methods are different among tags.
- SF Bug 1460449 Nested list can not be well supported.
- SF Bug 1460445 h2d stylesheet cannot handle HTML files within namespace.
- SF Bug 1431229 hardcoded path in MessageUtils.java
- SF Bug 1408477 <desc> element is not handled inside xref for XHTML
- SF Bug 1398867 ampersands in hrefs (on xref and link) cause build to fail
- SF Bug 1326439 filtered-out indexterms leak into index through dita.list
- SF Bug 1408487 Short description is not retrieved for <xref> element
- SF Bug 1407454 XHTML processing for <alt> is incomplete
- SF Bug 1405221 Some table frames ignored in dita->xhtml
- SF Bug 1414398 Cannot set provider for Eclipse help transformation
- SF RFE 1448712 add support for /plugins directory in plug-in architecture
DITA OT release 1.2
DITA open toolkit Release 1.2 is a major release to add new functions, fulfill new requirements, make some function enhancements and fix bugs over release 1.1.2.1.
Important Change DITA-OT 1.2 offers new error handling and logging system. If you invoke your transformation by using java command line where new error handling and logging system is mandatory, you need to set the CLASSPATH Environment Variable for dost.jar. If you invoke your transformation by using an ant script, you need to do one more step after the setting above. That is adding a parameter in your command to invoke an ant script. For example, use ant -f ant\sample_xhtml.xml -logger org.dita.dost.log.DITAOTBuildLogger instead of ant -f ant\sample_xhtml.xml to start a transformation defined in ant script file ant\sample_xhtml.xml.
New Functions
-
New plugin archiecture
DITA Open Toolkit 1.2 provides a new function to help users to download, install and use plug-ins and help developers create new plug-ins for DITA Open Toolkit.
-
Transformation to wordrtf
DITA Open Toolkit 1.2 provides DITA to Word transforming function to transform DITA source files to output in Microsoft® Word RTF file.
-
HTML to DITA migration tool
DITA Open Toolkit 1.2 provides a HTML to DITA migration tool, which migrates HTML files to DITA files. This migration tool originally comes from the developerWorks publication of Robert D. Anderson's how-to articles with the original h2d code.
-
Problem determination and log analysis
In DITA Open Toolkit 1.2, a new logging method is supported to log messages both on the screen and into the log file. The messages on the screen present user with the status information, warning, error, and fatal error messages. The messages in the log file present user with more detailed information about the transformation process. By analyzing these messages, user can know what cause the problem and how to solve it.
-
Open DITA User Guide for conditional processing
In DITA Open Toolkit 1.2, a new user guide which can help users to use conditional processing is added to toolkit document.
-
Include the OASIS version langref
In DITA Open Toolkit 1.2, a new OASIS version of language reference for DITA standard is added to toolkit document.
-
Document adapt to OASIS DITA 1.0.1 DTDs
DITA DTD files are updated to 1.0.1 version in DITA Open Toolkit 1.2.
Other Changes
- SF Bug 1304545 Some folders were copied to DITA-OT's root directory
- SF Bug 1328689 Stylesheet links in HTML emitted with local filesystem paths
- SF Bug 1333481 Mapref function does not work for maps in another directory
- SF Bug 1343963 Blank index.html generated for ditamap contains only reltabe
- SF Bug 1344486 java.io.EOFException thrown out when reading ditaval file
- SF Bug 1347669 Path Spec. in nested DITA maps
- SF Bug 1357139 filtering behavior doesn't conform to spec
- SF Bug 1358619 The property.temp file gets cleaned out by default
- SF Bug 1366843 XRefs do not generate proper links in FO/PDF
- SF Bug 1367636 dita2fo-elems.xsl has strange line breaks
- SF RFE 1296133 Enable related-links in PDF output
- SF RFE 1326377 Add a /dbg or /debug flag for diagnostic info
- SF RFE 1331727 Toolkit need to run on JDK 1.5.x(only support to run under Sun JDK 1.5 with saxon in normal case)
- SF RFE 1357054 Be more friendly towards relative directories
- SF RFE 1357906 Provide a default output directory
- SF RFE 1368073 Enable plugins for DITA open toolkit
- SF RFE 1379518 Clearer error messages and improved exception handling
- SF RFE 1379523 DITA to Rich Text Format (.rtf) file
- SF RFE 1382482 plugin architecture of DITA-OT
DITA OT release 1.1.2.1
Release 1.1.2.1 is a full build to provide an urgent fix to fix the following critical problem which users found in release 1.1.2.
- SF Bug 1345600 The build process failed when run "Ant all" in release 1.1.2
For this fix, we have restored all the source DITA files in 'doc' and directories in the binary packages.
Note that the original parameter "args.eclipse.toc" in "Ant tasks and script" was separated to "args.eclipsehelp.toc" for DITA-to-Eclipse help transformation, and "args.eclipsecontent.toc" for DITA-to-dynamic Eclipse content transformation.
Another issue is that we found there is a mismatch in the document and the toolkit behavior when you are trying to use the following command
ant -f conductor.xml -propertyfile ${dita.temp.dir}/property.temp.
Now we have updated the documentation. Please refer to the topic 'Building DITA output with Java command line' on our website for more details.
These updates do not affect standard operation of the toolkit. The main goal of this minor release to enable new users of the toolkit to run the installation verification tests without failure.
DITA OT release 1.1.2
Release 1.1.2 is a maintenance release to fix defects and make patches based on release 1.1.1.
But there are certain limitations and unfixed bugs in this release, such as,
- Bug 1343963 Blank index.html generated for ditamap contains only reltabe
- Bug 1344486 java.io.EOFException thrown out when reading ditaval file
Please check the current 'open' bugs on the SourceForge bugs tracker.
Changes
- SF Bug 1297355: Multilevel HTML Help popup shows filenames
- SF Bug 1297657: Update for Supported Parameters page
- SF Bug 1304859: Toolkit disallows repetition of topic ID within map
- SF Bug 1306361: Fatal error in published ditamap example
- SF Bug 1306363: common.css not compiled with htmlhelp
- SF Bug 1311788: DTD references not resolved
- SF Bug 1314081: Fix catalog entries in catalag-ant.xml for OASIS DTDs
- SF Bug 1323435: wrong system id for html output used in validation
- SF Bug 1323486: HTML Help subterm indexes not sorted
- SF Bug 1325290: JavaHelp output does not work for Russian
- SF Bug 1325277: File missing from the map causes abend
- SF Patch 1253783: dita2fo-links relative hrefs
- SF Patch 1324387: In xslfo, groupchoice var prints extra | delimiter
- SF RFE 1324990: Installation Guide
Parameter Changes
- The original parameter "args.eclipse.toc" in "Ant tasks and script" was separated to "args.eclipsehelp.toc" for dita2eclipsehelp transformation, and "args.eclipsecontent.toc" for dita2eclipsecontent transformation.
- Several parameters were added to the java command line interface, including "/javahelptoc","/javahelpmap","/eclipsehelptoc","/eclipsecontenttoc","/xhtmltoc".
Other Changes
Change to the "doc" directory, except "doc\langref" directory:
- The source dita files and the generated HTML, CHM, and PDF files were separated into separate downloads.
- The source package contains the source dita files.
- The binary package contains the generated HTML, CHM, and PDF files.
DITA OT release 1.1.1
Release 1.1.1 is a maintenance release to fix defects and make patches based on release 1.1.
For patch 1284023, we are changing the name of the jar lib file from dost1.0.jar back to dost.jar because we believe we need to keep the jar file name consistent through various releases.
Changes
- SF Bug 1196409: HTMLHelp output does not reference CSS
- SF Bug 1272687: extra "../" link generated by topicgroup
- SF Bug 1273751: revision flag using unavailable pictures
- SF Bug 1273816: Index generation doesn't cope with multilevel well
- SF Bug 1281900: Unnecessary comment and href typo
- SF Bug 1283600: unecessary space in document cause invalid parameter of Ant
- SF Bug 1283644: multipul document($FILTERFILE,/) doesn't work (XALAN)
- SF Patch 1251609: pretargets xsl directory needs to use ${dita.script.dir}
- SF Patch 1252441: Files in temp directory not deleted before build
- SF Patch 1253785: Inline images in dita2fo-elems
- SF Patch 1284023: change the name of jar file and remove the version name
DITA OT release 1.1
Release 1.1 is a major release to add new functions, fulfill new requirements, make some function enhancements and fix bugs over release 1.0.2.
-
Adaptation to the new OASIS DITA standard
Release 1.1 implements the new OASIS DITA 1.0 standard for DITA DTDs and Schemas.
DTDs of the previous release locate in the directory dtd/dita132 and schemas of the previous release locate in the directory schema/dita132.
-
Transformation to troff
Release 1.1 supports new troff output. Troff output looks like Linux man page output.
-
XML catalog support
An XML catalog, which can consist of several catalog entry files, is a logical structure that describes mapping information between public IDs and URLs of DTD files. A catalog entry file is an XML file that includes a group of catalog entries. If you want to know more about XML catalog, please referXML Catalog.
A catalog entry can be used to locate a unified resource identifier (URI) reference for a certain resource such as a DTD file. An external entity's public identifier is used for mapping to the URI reference. The URI of any system identifier can be ignored.
-
Topicref referring to a nested topic
The href attribute of the topicref is extended to quote a nested topic in a dita file.
For example, in previous releases, href attribute is set like: href = "xxx.dita"; in release 1.1, href attribute can be set like: href = "xxx.dita#abc.dita".
-
Globalization support
Release 1.1 supports over 20 popular languages within the content of dita files. And it also provides translation function for DITA keywords to over 20 languages. Currently this globalization support fully applies to Eclipse Help and XHTML transformations, and partially applies to other transformations.
-
Accessibility support
Accessibility support is now partially applies to PDF and XHTML transformations.
-
Eclipse Content Provider Support
Please refer to Eclipse Content Provider for detail information.
-
Index information in output
The output of HTML Help and Java Help transformations contain index information now.
-
Mapref function
Mapref refers to a special usage of the <topicref> element as a reference to another ditamap file. This allows you to manage the overall ditamap file more easily. A large ditamap file can thus be broken down into several ditamap files, making it easier for the user to manage the overall logical structure. On the other hand, this mechanism also increases the reusability of those ditamap files. If you want to know more about mapref, please refer Mapref.
-
TOC generation for Eclipse Help transformation
TOC generation now supported in transformation to Eclipse Help. Eclipse.
-
Helpset generation for Java Help transformation
Helpset generation now supported in transformation to Java Help.
-
New parameters supported in Java commands
In Java commands: /indexshow, /outext, /copycss, /xsl, /tempdir.
-
New parameters supported in Ant scripts
In Ant scripts: args.indexshow, args.outext, args.copycss, args.xsl, dita.temp.dir
Other Changes
- SF bug 1220569: Add XML Schema processing to DITA-OT
- SF bug 1220644: Prompted ant--image does not link for single topic to PDF
- SF bug 1229058: Add schema validation loading file for processing
- SF RFE 1176855: Ant must be run from toolkit directory
- SF RFE 1183482: Copy pre-existing html to output dir
- SF RFE 1183490: Provide argument to specify the location of temp dir
- SF RFE 1201242: override capability
DITA OT release 1.0.2
Release 1.0.2 is a maintenance release to fix defects and adds some minor enhancements in release 1.0.1.
Changes
- SF Bug 1181950: format attribute should be set to 'dita' for dita topic
- SF RFE 1183487: Document the usage of footer property
- SF RFE 1198847: command line interface support
- SF RFE 1198850: architecture document update
- SF RFE 1200410: need explanation for dita.list
- SF RFE 1201175: XML catalog support
- SF Patch 1176909: Add template for getting image URI
DITA OT release 1.0.1
Release 1.0.1 is a maintenance release to fix defects and adds some minor enhancements in release 1.0.
Changes
- Committer: maplink.xsl doesn't generate related links for second level referred topic
- Committer: avoid infinite loop of conref
- SF Bug 1160964: Can't point above the directory which contains the map file
- SF Bug 1163523: Broken XPath expression in mappull.xsl
- SF Bug 1168974: useless DRAFT param in FO transformation
- SF Bug 1173162: generate null internal link destination in fo transformation
- SF Bug 1173164: Not correctly use document() in dita2fo-links.xsl
- SF Bug 1173663: All base directories are DITA-OT 1.0
- SF Patch 1163561: XLST match patterns test for element names
- SF Patch 1165068: FO hyperlinks and FOP-generated PDF bookmarks
- SF Patch 1174012: Modification to sequence.ditamap
DITA OT release 1.0
The initial release of the Open Sourced DITA Toolkit introduces major architectural changes from the previous, developerWorks version of the Toolkit.
New features
- A new, Java-based processing architecture that supports single-threaded execution throughout.
- Ant-based orchestration of the processing environment, from preprocessing to transformation to any required post-processing.
- A pre-processor core that supports conditional processing and conref resolution.
- Map-driven processing that generates links for transformed topics.
- A new DITA to HTML transform that replaces the previous topic2html_Impl.xsl core transform. This new core is based on requirements for high-volume usage within IBM for the past several years.
Ant-driven processing means that you can integrate the DITA processing tools into a seamless pipeline within supportive environments such as Eclipse.
The DTDs and Schemas in this version are based on those in the previous dita132 package with bug fixes. The DITA OS Toolkit will later support the OASIS 1.0 specification in its public review form.
DITA history on developerWorks (pre-Open Source)
Versions of the toolkit prior to Open Source are in the developerWorks XML Zone at this address: DITA Downloads Change logs for those versions are within the Readme files in each distribution.