This document lists major changes and new features by release.
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 CLASSPATHEnvironment 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.