Word-to-DITA Ant Parameters
Ant parameters for the Word-to-DITA transformation type
To run the Word-to-DITA transformation using the Open Toolkit plugin, specify the following Ant parameters.
Required Parameters
- args.input
- The absolute filename and path of the DOCX file to process.
- word.doc
- The path and filename of the Word DOCX file to process.
Optional Parameters
- output.dir
- Specifies the absolute path of of the directory to contain the generated output.
- w2d.clean.output.dir
- Set to "true" to have the output directory cleaned out before running the transform. The default is "false".
- w2d.debug.xslt
- Turns on debugging of the XSLT transform. Default is "false".
- w2d.defaultStyleToTagMap
- Specifies the location of the style-to-tag map to use as the default if no style-to-tag-map is specified. The default is the word-builtin-styles-style2tagmap.xml file. This parameter is mostly useful for setting as a default in installation-specific properties files. You would not normally specify it for a specific document.
- w2d.filename.prefix
- The prefix to use for generated files other than submaps. The default is no prefix.
- w2d.filter.br
- Control whether or not
<br>elements generated from the Word data will be filtered out of the result DITA. Set to "true" to filter out<br>elements. The default is "false" (<br>elements are included in the result DITA). The<br>element is provided by the DITA for Publishers formatting vocabulary domain module. - w2d.filter.tabs
- Control whether or not
<tab>elements generated from the Word data will be filtered out of the result DITA. Set to "true" to filter out<tab>elements. The default is "false" (<tab>elements are included in the result DITA). The<tab>element is provided by the DITA for Publishers formatting vocabulary domain module. - w2d.generate.navtitles
- When set to "true", use topic titles as navigation titles in generated topicrefs.
- w2d.include.word.backpointers
- Set to "false" to turn off inclusion of
@attributes in the generated DITA files that point back to the original paragraphs in the Word document. Default is "true" (@xtrc@attributes are generated).@xtrc - w2d.include.word.bookmarks
- Set to "true" to turn inclusion of
<data>elements reflecting any Word bookmark start and end markers. Default is "false". - w2d.language
- Specifies the value of the
@atribute for generated maps and topics. If not specified, the@xml:lang@attribute is set to "en-US" by default. If you specify@xml:lang@for@langAttValue<mapProperties>or<topicProperties>in a style-to-tag map, that value will override the w2d.language value. - w2d.root.map.name
- The filename (without extension) to use for the root map if one is generated. By default uses the filename of the input DOCX file. Only specify this property if the style-to-tag mapping will result in a map. If the style-to-tag mapping only produces topics, then do not specify this property.
- w2d.root.output.filename
- Specifies the complete filename (including extension), of the root output file, whether it's a topic or a map. You would not normally specify this property unless the behavior of w2d.root.map.name or w2d.root.topic.name doesn't give you the result you want.
- w2d.root.topic.name
- The filename (without extension) to use for the root topic. By default, uses the filename of the input DOCX file. This property is ignored if w2d.root.topic.name is also specified.
- w2d.style-to-tag-map
- The absolute filename and path of the style-to-tag mapping to use. If not specified, the built-in mapping file org.dita4publishers.word2dita/xsl/word-builtin-styles-style2tagmap.xml is used.
- w2d.submap.name.prefix
- The prefix to use for generated submaps. The default is "map".
- w2d.table.widths.proportional
- When set to "true" generates tables with proportional column widths rather than absolute measurements. The default is "false", which uses the actual column width measurements from the Word table.
- w2d.temp.dir
- The temporary directory to use for word2dita process. Default is ${basedir}/temp.
- w2d.topic.extension
- The extension to use for generated topic files. The default is ".dita".
- w2d.word2dita.xslt
- 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.