Project files can be designed in a modular fashion to create reusable configuration structures that allow you to
define settings in one file and refer to them in other projects to publish multiple deliverables at once.
For example, /project-files/html.xml defines
a single HTML deliverable.
Sample project file for HTML output
This file can be used to generate the HTML version of the DITA-OT documentation by running the following command
from the docsrc folder of the DITA-OT installation directory:
dita --project=samples/project-files/html.xml
The project file for HTML output imports the common html context from a shared project context
defined in the /project-files/common.xml file,
which includes the input map file and the DITAVAL file used to filter the output.
Sample shared context for HTML-based output
The same common html context is also referenced in the project file for HTMLHelp output, as
illustrated in /project-files/htmlhelp.xml.
Sample project file for HTMLHelp output
The /project-files/pdf.xml file defines a
single PDF deliverable.
Sample project file for PDF output
This file can be used to generate the PDF version of the DITA-OT documentation by running the following command
from the docsrc folder of the DITA-OT installation directory:
dita --project=samples/project-files/pdf.xml
The /project-files/distribution-docs.xml file
includes both the HTML and PDF projects as follows:
To build both the HTML and PDF versions of the documentation as included in the distribution package, run the
following command from the docsrc folder of the DITA-OT installation directory:
dita --project=samples/project-files/distribution-docs.xml
The /project-files/all.xml file includes all
three project deliverables as follows: