Documentation Center

Build DITA output using DITA-OT and ishwebhelp

The batch file DITA-OT-ISHWEBHELP.cmd is responsible for launching the DITA Open Toolkit when using an output format which has the transtype property set to ishwebhelp.

ParameterDescription
Working directoryThe path of the working directory for transformations, it is the base of relative paths specified by other parameters.
Input fileThe path and name of the input file. This argument is case sensitive; case must match case on the filesystem.
Output DirectoryThe path of the output directory.
Transformation typeThe transformation type (output format) as selected in the user interface.
DraftAn indicator whether or not the draft-comment (and required-cleanup) element need to be preserved/rendered in the output.
CleanupAn indicator whether or not the temp location used (and created by DITA-OT) needs to be cleaned/removed at the end of the DITA-OT process
ValidateAn indicator whether or not DITA-OT needs to validate the intermediate topics/ditamaps against the DITA, assuring valid DITA content.
The DITA-OT-ISHWEBHELP.cmd launches DITA-OT using the Ant command line interface using the following parameters:
"ant" 
-Dtranstype=%4 
-Dargs.input=%1/%2 
-Doutput.dir=%3 
-Ddita.temp.dir=%1/temp 
-Dargs.draft=%5 
-Dclean.temp=%6 
-Dvalidate=%7 
-Dargs.logdir=%3 
-logfile %3/%2_%4.log

with 
			%1: Working directory
			%2: Input file
			%3: Output directory
			%4: Transformation type
   %5: Draft parameter. Either "yes" or "no"
   %6: Clean temp location of DITA-OT process. Either "yes" or "no"
   %7: Validate DITA content against DITA DTD. Either "true" or "false"

Result

The requested output is saved to the output directory (%3, or as shown above, specified in the third parameter for outdir).