Documentation Center

Launching DITA-OT post-processing

Describes the steps that must be executed when running DITA-OT as part of the publish post-processing.

Before running DITA-OT the following actions must be done:
  • The file extension of a map must be "ditamap"

    If the parameter UseDitaMapExtensionForMaps is "yes", maps are saved with the file extension "ditamap" while exporting them to the file system.

  • The file must have a DOCTYPE declaration with a resolved DTD path

    When the publish exports the files to the file system, the DTD is resolved using the catalog. However, during the export, the DOCTYPE declaration is removed and saved as a processing instruction for performance reasons. In order to run DITA-OT the DOCTYPE declaration must be restored using the publish plugin ISHRESTOREDOCTYPE.

When these prerequisites are met, the publish plugin IshRunDITAOT can be used to start the DITA-OT process. When the IshRunDITAOT plugin runs, it triggers the PowerShell script App\Utilities\DITA-OT\InfoShare\ishrunditaot.ps1 that runs DITA-OT.