First build with the dita command Publishing with the dita command
You can publish output using the dita command-line tool. Build parameters can be specified on the command line, with .properties files, or in project files that define multiple deliverables.
About this task
The DITA-OT client is a command-line tool with no graphical user interface. To verify that your installation works correctly, you can build the HTML version of the documentation you are reading now.
Procedure
Example
For example, from dita-ot-dir/docsrc, run:
dita --input=userguide.ditamap --format=html5 \
--output=out/docs-html5 \
--args.input.dir=/absolute/path/to/dita-ot-dir/docsrc \
--propertyfile=properties/docs-build-html5.properties
This builds userguide.ditamap to HTML5 output in out/docs-html5 using the following additional parameters specified in the properties/docs-build-html5.properties file:
# Copy the custom .css file to the output directory:
args.copycss = yes
# Custom .css file used to style output:
args.css = dita-ot-doc.css
# Location of the copied .css file relative to the output:
args.csspath = css
# Directory that contains the custom .css file:
args.cssroot = ${args.input.dir}/resources
# Generate headings for sections within task topics:
args.gen.task.lbl = YES
# File that contains the running header content:
args.hdr = ${args.input.dir}/resources/header.xml
# Which related links to include in the output
args.rellinks = noparent
# Skip Table of Contents file generation:
html5.toc.generate = no
# Generate a partial navigation TOC in topic pages:
nav-toc = partial
What to do next
Most builds require you to specify more options than are described in this topic. For more information, see Publishing with the dita command.
Usually, you will want to specify a set of reusable build parameters in a .properties file, or or create a project file that defines multiple deliverables.