DITA Map MS Office Word Transformation
Oxygen XML Developer Eclipse plugin 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:
- Open the DITA map.
- Click the Configure Transformation Scenario(s) button.
- Select DITA Map MS Office Word.
- 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.
- 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).