Common parametersCommon
args.debugSpecifies whether debugging information is included in the log. The allowed values are and ; the default value is .args.draftSpecifies whether the content of <draft-comment> and <required-cleanup> elements is included in the output. The allowed values are and ; the default value is .args.figurelink.styleSpecifies how cross references to figures are styled in output. The allowed values are , , and .args.filterSpecifies a filter file to be used to include, exclude, or flag content.args.gen.task.lblSpecifies whether to generate headings for sections within task topics. The allowed values are and .args.grammar.cacheSpecifies whether the grammar-caching feature of the XML parser is used. The allowed values are and ; the default value is .args.inputSpecifies the master file for your documentation project.args.input.dirSpecifies the base directory for your documentation project.args.logdirSpecifies the location where the DITA-OT places log files for your project.args.rellinksSpecifies which links to include in the output. The following values are supported:
  • – No links are included.
  • – All links are included.
  • – Parent links are not included.
  • – Parent, child, next, and previous links are not included.
args.tablelink.styleSpecifies how cross references to tables are styled. The allowed values are , , and .clean.tempSpecifies whether the DITA-OT deletes the files in the temporary directory after it finishes a build. The allowed values are and ; the default value is .conserve-memoryConserve memory at the expense of processing speed The allowed values are and ; the default value is .dita.dirSpecifies where the DITA-OT is installed.dita.input.valfileSpecifies a filter file to be used to include, exclude, or flag content.dita.preprocess.reloadstylesheet.topicpullSpecifies whether the DITA-OT reloads the XSL style sheets that are used for the transformation. The allowed values are and ; the default value is .dita.temp.dirSpecifies the location of the temporary directory.filter-stageSpecifies whether filtering is done before all other processing, or after key and conref processing. The allowed values are and ; the default value is .force-uniqueGenerate copy-to attributes to duplicate topicref elements. The allowed values are and ; the default value is .generate-debug-attributesSpecifies whether the @xtrf and @xtrc debugging attributes are generated in the temporary files. The following values are supported:
  • (default) – Enables generation of debugging attributes
  • – Disables generation of debugging attributes
generate.copy.outerSpecifies whether to generate output files for content that is not located in or beneath the directory containing the DITA map file. The following values are supported:
  • (default) – Do not generate output for content that is located outside the DITA map directory.
  • – Shift the output directory so that it contains all output for the publication.
onlytopic.in.mapSpecifies whether files that are linked to, or referenced with a @conref attribute, generate output. The allowed values are and ; the default value is .outer.controlSpecifies how the DITA-OT handles content files that are not located in or below the directory containing the master DITA map. The following values are supported:
  • – Fail quickly if files are going to be generated or copied outside of the directory.
  • (default) – Complete the operation if files will be generated or copied outside of the directory, but log a warning.
  • – Quietly finish without generating warnings or errors.
output.dirSpecifies the name and location of the output directory.processing-modeSpecifies how the DITA-OT handles errors and error recovery. The following values are supported:
  • – When an error is encountered, the DITA-OT stops processing
  • (default) – When an error is encountered, the DITA-OT attempts to recover from it
  • – When an error is encountered, the DITA-OT continues processing but does not attempt error recovery
root-chunk-overrideOverride for map chunk attribute value.transtypeSpecifies the output format (transformation type).validateSpecifies whether the DITA-OT validates the content. The allowed values are and ; the default value is .