Generating DITA from Word Using the Toolkit Plugin
How to use the Word-to-DITA Toolkit Plugin to generate DITA content from Word documents.
To use the transformation as a Toolkit plugin simply deploy the DITA for Publishers Toolkit plugins to your Open Toolkit directory. The Word-to-DITA transformation type is "word2dita".
- The absolute filename and path of the DOCX file to process.
- The absolute filename and path of the style-to-tag mapping to use.
- Specifies the absolute path of of the directory to contain the generated output.
- When set to "true" deletes any files in the output directory before running the generation.
- When set to any value (e.g., "true"), filters out literal break characters, which are otherwise preserved in the DITA output as
- When set to any value (e.g. "true"), filters out literal tab characters, which are otherwise preserved in the DITA output as
- The filename to use for the root output file (the root map or root topic depending on how your mapping is set up), e.g. "rootmap.ditamap".
- Specifies the name of the XSLT transform to use to convert the DOCX file to DITA. Default is the docx2dita.xsl transform in the word2dita Toolkit plugin.
- Turns on debugging of the XSLT transform. Default is "false".
- Name of the directory to put any media objects extracted from the Word document.
- The name for the root map, e.g. "myPubRootmap". Do not include any file extension.
- The name for the root topic, e.g. "myPubRootTopic". Do not include any file extension. This value will be used for the root topic filename and @id value.
- The prefix to use for the names of generated submaps. Default is "map".
- When set to "true", include @xtrf and @xtrc attributes with the locations of the Word paragraphs that generated each element. Default is "true".
- When set to "true", reflect Word bookmark start and end boundaries in the generated DITA output as <data> elements. Default is "false".
- The prefix to use for all generated filenames, e.g. "pub1234_". Default is no prefix. Use a prefix to ensure that generated map and topic filenames are unique outside the scope of the files generated for a single Word document.
- The prefix to use for generated submaps, e.g., "submap_". Default is no prefix.
- The value to use for the @xml:lang attribute in generated maps and topics. Default is "en-US".
- When set to "true" generates navigation titles for topicrefs, using the title of the referenced topic. Default is "true".