Edit online

DITA Map MS Office Word Transformation

Oxygen XML Editor comes bundled with a transformation scenario that allows you to convert DITA maps to Microsoft Office Word documents. It utilizes the DITA to Word plugin created by Jarno Elovirta. This plugin contains a Word document named Normal.docx (located in: [OXYGEN_INSTALL_DIR]/frameworks/dita/DITA-OT/plugins/com.elovirta.ooxml/resources) that is used by the transformation scenario as a template to generate the final Word document.
Tip: You can make general modifications to the Normal.docx template file to alter the published output. The Word application used to edit the Normal.docx should be configured with English locale as the style names for each Word element must be in English.

Configuring the Transformation Scenario

To configure a DITA Map to MS Office Word transformation scenario, follow these steps:
  1. Open the DITA map in the DITA Maps Manager.
  2. Click the Configure Transformation Scenario(s) button from the DITA Maps Manager toolbar.
  3. Select DITA Map MS Office Word.
  4. For advanced customizations, in the Parameters tab you can use any of the following parameters that are unique to this transformation scenario to specify paths to files that affect the output in various ways:
    • dotx.file - Specifies the path to a Word template file (.docx) that will be used in the transformation to generate the final Word document. Set this parameter if you want to use a different template file other than the Normal.docx file that is used by default.
    • document.flat.xsl - Specifies the path to a pre-process clean-up stylesheet.
    • core.xsl - Specifies the path to a core metadata stylesheet.
    • custom.xsl - Specifies the path to a custom metadata stylesheet.
    • document.xsl - Specifies the path to a main document stylesheet.
    • comments.xsl - Specifies the path to a comments stylesheet.
    • numbering.xsl - Specifies the path to a list and title numbering stylesheet.
    • footnotes.xsl - Specifies the path to a footnote stylesheet.
    • document.xml.xsl - Specifies the path to a document relations metadata stylesheet.
    • inkscape.exec - Specifies the path to an Inkscape (open-source vector graphics editor) executable file.
  5. Click OK and run the transformation scenario.

Result: The result of the transformation will automatically be opened in your system's default word processing application (such as Microsoft Word).