This repository tracks the source files for the DITA Open Toolkit documentation.
We welcome contributions to the DITA-OT documentation. Please review the guidelines for contributing to this repository before creating issues or opening pull requests.
- Test before committing
- Commit related changes
- Commit often
- Write good commit messages
- Sign your work
Building the documentation output
To generate additional topics and build the HTML and PDF versions of the documentation as included in DITA-OT releases, run the Ant build script from the root level of the
docs repository by entering
ant on the command line.
You can also specify a single output format. To build HTML output, enter the following on the command line:
Output will be generated in the
/out folder of the
docs repository. This folder is created automatically if it doesn't exist. (Git ignores the contents of this folder so you don't inadvertently commit these transient files.)
NOTE: The build script assumes that the
$DITA_HOME environment variable or the
dita.home Ant property points to a working DITA-OT installation. If neither is set or you need to override the value, you can also set it on the command line.
export DITA_HOME=/path/to/dita-ot ant ...