Transforming DITA Maps

<oXygen/> uses the DITA Open Toolkit (DITA-OT) to transform XML content into an output format. For this purpose both the DITA Open Toolkit 1.5 M24 and ANT 1.7 come bundled in <oXygen/>.

More informations about the DITA Open Toolkit are available at http://dita-ot.sourceforge.net/.

Available Output Formats

You can publish DITA-based documents in any of the following formats:

XHTML

DITA Map to XHTML

PDF - DITA OT

DITA Map to PDF using the DITA OT default PDF target

PDF2 - IDIOM FO Plugin

DITA Map to PDF using the DITA OT IDIOM PDF plugin

HTML Help (CHM)

DITA Map to HTML Help. If HTML Help Workshop is installed on your computer then oXygen will detect it and use it to perform the transformation. When the transformation fails, the hhp (HTML Help Project) file is already generated and it needs to be compiled to obtain the chm file. Note that HTML Help Workshop fails when the files used for transformation contain diacritics in their names, due to different encodings used when writing the hhp and hhc files.

JavaHelp

DITA Map to JavaHelp

Eclipse Help

DITA Map to Eclipse Help

Eclipse Content

DITA Map to Eclipse Content

TocJS

A JavaScript file that can be included in an HTML file to display in a tree-like manner the table of contents of the transformed DITA map.

RTF

DITA Map to Rich Text Format

TROFF

DITA Map to Text Processor for Typesetters

Docbook

DITA Map to Docbook

Because the TocJS transformation does not generate all the files needed to display the tree-like table of contents, you need to follow this procedure:

  1. Run the XHTML transformation on the same DITA map. Make sure the output gets generated in the same output folder;

  2. Copy the content of ${frameworks}/dita/DITA-OT/demo/tocjs/basefiles folder in the transformation's output folder;

  3. Copy the ${frameworks}/dita/DITA-OT/demo/tocjs/sample/basefiles/frameset.html file in the transformation's output folder;

  4. Edit frameset.html and locate element <frame name="contentwin" src="concepts/about.html">. Replace "concepts/about.html" with "index.html".