DITA release history

Improvements

1. Chinese support in WORD RTF
2. Improve plug-in architecture in plug-in dependency handling

SF Changes

1. SF Bug 1461642 Relative paths in toolkit.
2. SF Bug 1463756 TROFF output is not usable
3. SF Bug 1459527 Properties elements should generate default headings
4. SF Bug 1457552 FO gen-toc does not work right for ditamaps and bookmaps
5. SF Bug 1430983 Specialized indexterm does not generate entries in index
6. SF Bug 1363055 Shortdesc disappears when optional body is removed
7. SF Bug 1368403 The dita2docbook transformation lacks support for args.xsl
8. SF Bug 1405184 Note template for XHTML should be easier to override
9. SF Bug 1407646 Map titles are not used in print outputs
10. SF Bug 1409960 No page numbers in PDF toc
11. SF Bug 1459790 Related Links omitted when map references file#topicid
12. SF Bug 1428015 Topicmerge.xsl should leave indentation alone
13. SF Bug 1429400 FO output should allow more external links
14. SF Bug 1405169 Space inside XHTML note title affects CSS presentation
15. SF Bug 1402377 Updated translations for Icelandic
16. SF Bug 1366845 XRefs do not generate page numbers
17. SF Patch 1326450 Make ${basedir} mine
18. SF Patch 1328264 FOP task userconfig file
19. SF Patch 1385636 Tweaks to docbook/topic2db.xsl
20. SF Patch 1435584 Recognize more image extensions
21. SF Patch 1444900 Add template for getting input file URI
22. SF Patch 1460419 Add a new parameter /cssroot:{args.cssroot}
23. SF Patch 1460441 map2hhp [FILES] include
24. SF RFE 1400140 Add a new parameter /cssroot:{args.cssroot}

Improvements

1. Corrupt table generated in WORD RTF is fixed
2. Pictures are merged into the WORD RTF instead of creating links to them
3. lq element is supported in WORD RTF
4. Generated text can be translated to different languages in WORD RTF
5. In WORD RTF, if no <choptionhd> given, head will be generated in table

SF Changes

1. SF Bug 1460451 Spaces preserving methods are different among tags.
2. SF Bug 1460449 Nested list can not be well supported.
3. SF Bug 1460445 h2d stylesheet cannot handle HTML files within namespace.
4. SF Bug 1431229 hardcoded path in MessageUtils.java
5. SF Bug 1408477 <desc> element is not handled inside xref for XHTML
6. SF Bug 1398867 ampersands in hrefs (on xref and link) cause build to fail
7. SF Bug 1326439 filtered-out indexterms leak into index through dita.list
8. SF Bug 1408487 Short description is not retrieved for <xref> element
9. SF Bug 1407454 XHTML processing for <alt> is incomplete
10. SF Bug 1405221 Some table frames ignored in dita->xhtml
11. SF Bug 1414398 Cannot set provider for Eclipse help transformation
12. SF RFE 1448712 add support for /plugins directory in plug-in architecture

New Functions

1. 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.

2. 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.

3. 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.

4. 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.

5. 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.

6. 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.

7. 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

1. SF Bug 1304545 Some folders were copied to DITA-OT's root directory
2. SF Bug 1328689 Stylesheet links in HTML emitted with local filesystem paths
3. SF Bug 1333481 Mapref function does not work for maps in another directory
4. SF Bug 1343963 Blank index.html generated for ditamap contains only reltabe
5. SF Bug 1344486 java.io.EOFException thrown out when reading ditaval file
6. SF Bug 1347669 Path Spec. in nested DITA maps
7. SF Bug 1357139 filtering behavior doesn't conform to spec
8. SF Bug 1358619 The property.temp file gets cleaned out by default
9. SF Bug 1366843 XRefs do not generate proper links in FO/PDF
10. SF Bug 1367636 dita2fo-elems.xsl has strange line breaks
11. SF RFE 1296133 Enable related-links in PDF output
12. SF RFE 1326377 Add a /dbg or /debug flag for diagnostic info
13. 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)
14. SF RFE 1357054 Be more friendly towards relative directories
15. SF RFE 1357906 Provide a default output directory
16. SF RFE 1368073 Enable plugins for DITA open toolkit
17. SF RFE 1379518 Clearer error messages and improved exception handling
18. SF RFE 1379523 DITA to Rich Text Format (.rtf) file
19. SF RFE 1382482 plugin architecture of DITA-OT

• SF Bug 1345600 The build process failed when run "Ant all" in release 1.1.2

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.

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

1. SF Bug 1297355: Multilevel HTML Help popup shows filenames
2. SF Bug 1297657: Update for Supported Parameters page
3. SF Bug 1304859: Toolkit disallows repetition of topic ID within map
4. SF Bug 1306361: Fatal error in published ditamap example
5. SF Bug 1306363: common.css not compiled with htmlhelp
6. SF Bug 1311788: DTD references not resolved
7. SF Bug 1314081: Fix catalog entries in catalag-ant.xml for OASIS DTDs
8. SF Bug 1323435: wrong system id for html output used in validation
9. SF Bug 1323486: HTML Help subterm indexes not sorted
10. SF Bug 1325290: JavaHelp output does not work for Russian
11. SF Bug 1325277: File missing from the map causes abend
12. SF Patch 1253783: dita2fo-links relative hrefs
13. SF Patch 1324387: In xslfo, groupchoice var prints extra | delimiter
14. SF RFE 1324990: Installation Guide

1. 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.
2. Several parameters were added to the java command line interface, including "/javahelptoc","/javahelpmap","/eclipsehelptoc","/eclipsecontenttoc","/xhtmltoc".

Change to the "doc" directory, except "doc\langref" directory:

1. The source dita files and the generated HTML, CHM, and PDF files were separated into separate downloads.
2. The source package contains the source dita files.
3. The binary package contains the generated HTML, CHM, and PDF files.

Changes

1. SF Bug 1196409: HTMLHelp output does not reference CSS
2. SF Bug 1272687: extra "../" link generated by topicgroup
3. SF Bug 1273751: revision flag using unavailable pictures
4. SF Bug 1273816: Index generation doesn't cope with multilevel well
5. SF Bug 1281900: Unnecessary comment and href typo
6. SF Bug 1283600: unecessary space in document cause invalid parameter of Ant
7. SF Bug 1283644: multipul document($FILTERFILE,/) doesn't work (XALAN)
8. SF Patch 1251609: pretargets xsl directory needs to use ${dita.script.dir}
9. SF Patch 1252441: Files in temp directory not deleted before build
10. SF Patch 1253785: Inline images in dita2fo-elems
11. SF Patch 1284023: change the name of jar file and remove the version name

1. 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.

2. Transformation to troff

   Release 1.1 supports new troff output. Troff output looks like Linux man page output.

3. 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.

4. 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".

5. 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.

6. Accessibility support

   Accessibility support is now partially applies to PDF and XHTML transformations.

7. Eclipse Content Provider Support

   Please refer to Eclipse Content Provider for detail information.

8. Index information in output

   The output of HTML Help and Java Help transformations contain index information now.

9. 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.

10. TOC generation for Eclipse Help transformation

    TOC generation now supported in transformation to Eclipse Help. Eclipse.

11. Helpset generation for Java Help transformation

    Helpset generation now supported in transformation to Java Help.

12. New parameters supported in Java commands

    In Java commands: /indexshow, /outext, /copycss, /xsl, /tempdir.

13. New parameters supported in Ant scripts

    In Ant scripts: args.indexshow, args.outext, args.copycss, args.xsl, dita.temp.dir

Other Changes

1. SF bug 1220569: Add XML Schema processing to DITA-OT
2. SF bug 1220644: Prompted ant--image does not link for single topic to PDF
3. SF bug 1229058: Add schema validation loading file for processing
4. SF RFE 1176855: Ant must be run from toolkit directory
5. SF RFE 1183482: Copy pre-existing html to output dir
6. SF RFE 1183490: Provide argument to specify the location of temp dir
7. SF RFE 1201242: override capability

Changes

1. SF Bug 1181950: format attribute should be set to 'dita' for dita topic
2. SF RFE 1183487: Document the usage of footer property
3. SF RFE 1198847: command line interface support
4. SF RFE 1198850: architecture document update
5. SF RFE 1200410: need explanation for dita.list
6. SF RFE 1201175: XML catalog support
7. SF Patch 1176909: Add template for getting image URI

Changes

1. Committer: maplink.xsl doesn't generate related links for second level referred topic
2. Committer: avoid infinite loop of conref
3. SF Bug 1160964: Can't point above the directory which contains the map file
4. SF Bug 1163523: Broken XPath expression in mappull.xsl
5. SF Bug 1168974: useless DRAFT param in FO transformation
6. SF Bug 1173162: generate null internal link destination in fo transformation
7. SF Bug 1173164: Not correctly use document() in dita2fo-links.xsl
8. SF Bug 1173663: All base directories are DITA-OT 1.0
9. SF Patch 1163561: XLST match patterns test for element names
10. SF Patch 1165068: FO hyperlinks and FOP-generated PDF bookmarks
11. SF Patch 1174012: Modification to sequence.ditamap

New features

1. A new, Java-based processing architecture that supports single-threaded execution throughout.
2. Ant-based orchestration of the processing environment, from preprocessing to transformation to any required post-processing.
3. A pre-processor core that supports conditional processing and conref resolution.
4. Map-driven processing that generates links for transformed topics.
5. 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.