# 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".

## Required Parameters

args.input
The absolute filename and path of the DOCX file to process.
w2d.style-to-tag-map
The absolute filename and path of the style-to-tag mapping to use.

## Optional Parameters

output.dir
Specifies the absolute path of of the directory to contain the generated output.
w2d.clean.output.dir
When set to "true" deletes any files in the output directory before running the generation.
w2d.filter.br
When set to any value (e.g., "true"), filters out literal break characters, which are otherwise preserved in the DITA output as <br> elements.
w2d.filter.tabs
When set to any value (e.g. "true"), filters out literal tab characters, which are otherwise preserved in the DITA output as <tab> elements.
w2d.root.output.filename
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".
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.
w2d.debug.xslt
Turns on debugging of the XSLT transform. Default is "false".
w2d.media.dir
Name of the directory to put any media objects extracted from the Word document.
w2d.root.map.name
The name for the root map, e.g. "myPubRootmap". Do not include any file extension.
w2d.root.topic.name
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.
w2d.submap.name.prefix
The prefix to use for the names of generated submaps. Default is "map".
w2d.include.word.backpointers
When set to "true", include @xtrf and @xtrc attributes with the locations of the Word paragraphs that generated each element. Default is "true".
w2d.include.word.bookmarks
When set to "true", reflect Word bookmark start and end boundaries in the generated DITA output as <data> elements. Default is "false".
w2d.filename.prefix
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.
w2d.submap.name.prefix
The prefix to use for generated submaps, e.g., "submap_". Default is no prefix.
w2d.language
The value to use for the @xml:lang attribute in generated maps and topics. Default is "en-US".
w2d.generate.navtitles
When set to "true" generates navigation titles for topicrefs, using the title of the referenced topic. Default is "true".