Building output using the dita command

You can generate output using the DITA Open Toolkit dita command-line tool. Build parameters can be specified on the command line or with .properties files.

1. Open a terminal window by typing the following in the search bar:
   • On OS X and Linux, type Terminal.
   • On Windows, type Command Prompt.
2. At the command-line prompt, enter the following command:

   dita-ot-dir/bin/dita --input=input-file --format=format options

   where:

   • dita-ot-dir is the DITA-OT installation directory.
   • input-file is the DITA map or DITA file that you want to process.

   • format is the output format (transformation type). Use the same values available for the transtype build parameter, for example, html5 or pdf.

   • dita-ot-dir is the DITA-OT installation directory.
   • input-file is the DITA map or DITA file that you want to process.

   • format is the output format (transformation type). Use the same values available for the transtype build parameter, for example, html5 or pdf.

     You can create plug-ins to add new output formats; by default, the following values are available:

     • eclipsehelp
     • html5
     • htmlhelp
     • javahelp
     • pdf
     • tocjs
     • troff
     • xhtml
   • options include the following optional build parameters:

     --output=dir

     -o dir

     Specifies the path of the output directory; the path can be absolute or relative to the current directory. By default, the output is written to the out subdirectory of the current directory.

     --filter=file

     Specifies filter file(s) used to include, exclude, or flag content.

     Relative paths are resolved against the current directory and internally converted to absolute paths.

     --temp=dir

     -t dir

     Specifies the location of the temporary directory.

     --verbose

     -v

     Verbose logging.

     --debug

     -d

     Debug logging.

     --logfile=file

     -l file

     Write logging messages to a file.

     --parameter=value

     -Dparameter=value

     Specify a value for a DITA-OT or Ant build parameter.

     The GNU-style --parameter=value form is only available for parameters that are configured in the plug-in configuration file; the Java-style -D form can also be used to specify additional non-configured parameters or set system properties.

     Parameters not implemented by the specified transformation type or referenced in a .properties file are ignored.

     Tip: If you are building in different environments where the location of the input files is not consistent, set args.input.dir with the dita command and reference its value with ${args.input.dir} in your .properties file.

     --propertyfile=file

     Use build parameters defined in the referenced .properties file.

     Build parameters specified on the command line override those set in the .properties file.

   If processing is successful, nothing is printed in the terminal window. The built output is written to the specified output directory (by default, in the out subdirectory of the current directory).

   Tip: Add the absolute path for dita-ot-dir/bin to the PATH environment variable to run the dita command from any location on the file system without typing the path.

dita-ot-dir/bin/dita --input=sequence.ditamap --format=html5

dita --input=sequence.ditamap --format=html5 \
     --output=output/sequence \
     --args.input.dir=dita-ot-dir/docsrc/samples \
     --propertyfile=properties/sequence-html5.properties

# Don't generate headings for sections within task topics:
args.gen.task.lbl = NO

# Directory that contains the custom .css file:
args.cssroot = ${args.input.dir}/css/

# Custom .css file used to style output:
args.css = style.css

# Copy the custom .css file to the output directory:
args.copycss = yes

# Location of the copied .css file relative to the output:
args.csspath = branding

# Generate a full navigation TOC in topic pages:
nav-toc = full

# Base name of the Table of Contents file:
args.xhtml.toc = toc