Creating an Ant build script
Instead of typing the DITA-OT parameters at the command prompt, you might want to create an Ant build script that contains all of the parameters.
Procedure
-
Create an XML file that contains the following content:
<?xml version="1.0" encoding="UTF-8" ?> <project name="@project-name@" default="@default-target@" basedir="."> <property name="dita.dir" location="@path-to-DITA-OT@"/> <target name="@target-name@"> <ant antfile="${dita.dir}${file.separator}build.xml"> <property name="args.input" value="@DITA-input@"/> <property name="transtype" value="html5"/> </ant> </target> </project>You will replace the placeholder content (indicated by the @ signs) with content applicable to your environment. -
Specify project information:
- Set the value of the @name attribute to X.
-
Set the value of the @default attribute to the name of a target in the
build script.
If the build script is invoked without specifying a target, this target will be run.
-
Set the value of the dita.dir property to the location of
the DITA-OT.
This can be a fully qualified path, or you can specify it relative to the location of the Ant build script that you are writing.
-
Create the Ant target:
- Set the value of the @name attribute.
- Specify the value for the args.input property.
- Specify the value of the transtype property.
- Save the build script.
Example
The following Ant build script generates CHM and PDF output for the
userguide.ditamap
file.
<?xml version="1.0" encoding="UTF-8" ?>
<project name="Toolkit-documentation" default="all" basedir=".">
<property name="dita.dir" location="C:\DITA-OT1.6.M5"/>
<target name="all" description="build CHM and PDF" depends="chm,pdf"/>
<target name="chm" description="build CHM">
<ant antfile="${dita.dir}\build.xml">
<property name="args.input" value="C:\dita-ot\src\main\doc\userguide.ditamap"/>
<property name="args.gen.task.lbl" value="YES"/>
<property name="output.dir" value="C:\kje\temp\out"/>
<property name="transtype" value="htmlhelp"/>
</ant>
</target>
<target name="pdf" description="build PDF">
<ant antfile="${dita.dir}\build.xml">
<property name="args.input" value="C:\dita-ot\src\main\doc\userguide.ditamap"/>
<property name="args.gen.task.lbl" value="YES"/>
<property name="args.rellinks" value="nofamily"/>
<property name="output.dir" value="C:\kje\temp\out"/>
<property name="transtype" value="pdf"/>
</ant>
</target>
</project>
In addition to the mandatory parameters (args.input and
transtype), the chm and pdf targets each specify some
optional parameters:
- The args.gen.task.lbl property is set to YES, which ensures that headings are automatically generated for the sections of task topics.
- The output.dir property specifies where the DITA OT writes the output of the transformations.
The pdf target also specifies that related links should be generated in the PDF, but only those links that are created by relationship tables and <link> elements.
Finally, the all target simply specifies that both the chm and pdf target should be run.