Known Limitations

Below are some known limitations categoried by module within the current release of the DITA Open Toolkit.

Transformation to PDF and Word RTF

  1. You can change the styles of the output file by using tools in Microsoft® Word rather than specifying the styles before transforming.
  2. If there is a cross reference referring to an URL in the DITA source file, the link should be completed defined with the proper internet protocol. For example, specify http://www.ibm.com instead of www.ibm.com.
  3. Flagging, revision bar and filtering are not supported in PDF and Word RTF output.
  4. Morerows attribute of the table element used to generating vertically merged cell is not supported in PDF output.
  5. Style attributes for table are not supported in Word RTF output.
  6. Complex cases dealing with table in list are not supported in Word RTF.
  7. There might be no output style applied on contents of some tags in Word RTF output compared with other output.

HTML to DITA migration

  1. Since Xalan doesn't allow to set the public and system IDs dynamically using a variable, when Xalan is used as the default XSLT processor, the output will contain:
    <!DOCTYPE topic PUBLIC "{$publicid}" "{$systemid}">

    Suggest to use Saxon as the processor to fix this problem. For other information on this problem, see the section "Other general migration notes" in the first developerWorks article.

  2. Currently, the stylesheet can't handle HTML files within namespace like below:
    <html xmlns="http://www.w3.org/1999/xhtml">
    Note: This limitation has been fixed in release 1.2.1, please refer to the Migrating HTML to DITA for detail information.
Related concepts
DITA futures
Building DITA output with Ant
Building DITA output with Java command line
Migrating HTML to DITA
DITA to Word output transform
Related reference
DITA release notes
Problem determination and log analysis
Troubleshooting
Related information
DITA release history
Tested platforms and tools
Using DITA transforms