Command-line tool parameters: All transformations

Certain parameters apply to all transformations that are supported by the DITA Open Toolkit.

Figure 1. Command-line tool parameters: All transformations
The directory where your project's ant build script resides. The DITA-OT will look for your .dita files relative to this directory. DITA-OT's default build script sets this as an attribute of the project, but you can also define it as a project property.
Specifies whether the DITA-OT deletes the files in the temporary directory after it finishes a build. The allowed values are yes and no; the default value is yes.
Specifies whether debugging information is included in the log. The allowed values are yes and no; the default value is no.
Specifies where the DITA-OT is installed.
Specifies the language locale file to use for sorting index entries.
Note: This parameter is not available for the XHTML transformation.
Specifies whether the content of <draft-comment> and <required-cleanup> elements is included in the output. The allowed values are yes and no; the default value is no. Corresponds to XSLT parameter DRAFT in most XSLT modules.
Tip: For PDF output, setting the args.draft parameter to yes causes the contents of the <titlealts> element to be rendered below the title.
Specifies a filter file to be used to include, exclude, or flag content.
Note: Deprecated in favor of the args.filter parameter.
Specifies whether the grammar-caching feature of the XML parser is used. The allowed values are yes and no; the default value is no.
Note: This option dramatically speeds up processing time. However, there is a known problem with using this feature for documents that use XML entities. If your build fails with parser errors about entity resolution, set this parameter to no.
Specifies the master file for your documentation project. Typically this is a DITA map, however it also can be a DITA topic if you want to transform a single DITA file. The path can be absolute, relative to args.input.dir, or relative to the directory where your project's ant build script resides if args.input.dir is not defined.
Specifies the location where the DITA-OT places log files for your project.
Specifies the name and location of the output directory. By default, the output is written to DITA-dir\out.
Specifies the location of the temporary directory. The temporary directory is where the DITA-OT writes temporary files that are generated during the transformation process.
Specifies the output format. You can create plug-ins to add new values for this parameter; by default, the following values are available:
  • docbook
  • eclipsehelp
  • eclipsecontent
  • html5
  • htmlhelp
  • javahelp
  • odt
  • pdf
  • wordrtf
  • troff
  • xhtml
Specifies whether the DITA-OT validates the content. The allowed values are true and false; the default value is true.