44.13 Postprocessing separately from converting

If you have already converted a document and the results are still in the project directory, you can have DITA2Go carry out postprocessing steps without going through the entire conversion again. These steps can include:

To postprocess conversion results independently of conversion:

[Automation]
WrapAndShip=Yes
; OnlyAuto = No (default) or Yes (run only automation commands,
; rather than the full conversion)
OnlyAuto = Yes

When OnlyAuto=Yes, DITA2Go processes options specified in the [Automation] section of the configuration file, without first performing any document conversion.

Note:  Commands assigned to SystemStartCommand are not run when OnlyAuto=Yes; see §43.1 Executing operating-system commands.

OnlyAuto=Yes takes effect only when at least one of the following is true:

When OnlyAuto=No, DITA2Go runs the conversion before processing options specified in the [Automation] section.

Compilation is included for WinHelp, HTML Help

If the output type is WinHelp or HTML Help and you set CompileHelp=Yes (or you check Compile Help on the Export dialog), DITA2Go runs the appropriate compiler before placing the deliverable(s) in a shipping directory; see §44.10 Gathering and processing Help-system files.

Note:  If you set CompileHelp=No when OnlyAuto=Yes (because you compiled your Help system in a previous run), be sure to set EmptyWrapPath=No; otherwise, your compiled Help system will be swept away before anything else happens.

Indexing search terms is included for JavaHelp, Oracle Help

If the output type is JavaHelp or Oracle Help and you specify a value for FTSCommand in the configuration file, DITA2Go runs the designated indexer before archiving the deliverables and placing them in a shipping directory; see §20.5 Providing full-text search for JavaHelp / Oracle Help.

Previous Topic:  44.12.3 Choosing whether to copy or move deliverables

Next Topic:  45. Converting via DCL

Parent Topic:  44. Producing deliverable results

Sibling Topics:

44.1 Understanding DITA2Go pre- and post-processing

44.2 Activating and logging production of deliverables

44.3 Understanding path values for deliverables

44.4 Clearing out old files before converting

44.5 Gathering additional files before converting

44.6 Assembling files for distribution

44.7 Placing graphics files for distribution

44.8 Placing CSS or XSL files for assembly

44.9 Gathering files for an HTML project: an example

44.10 Gathering and processing Help-system files

44.11 Archiving deliverables

44.12 Placing deliverables in a shipping directory

Table of ContentsIndex