Creating a new transformation scenario

To transform a DITA object, you create a transformation scenario.

Many transformation scenarios use the DITA Open Toolkit, which is a set of open source tools that provide processing for DITA objects, but you can use any other tool or script to transform your content.

The process for creating a transformation scenario with the Output Generator, whether you are using the DITA Open Toolkit or another build script, is always the same:
  1. Create a new output type in the file outputtypes.xml: This file defines the types of output into which users can transform their DITA files (for example, PDF, HTML, etc.). If the transformation scenario is visible to the end user, then the output type is displayed in the Output Generator dialog, and users can select it when generating their outputs. The outputtypes.xml file points to one or more processors to execute, stored in the preprocessors.xml file.
  2. Create one or more processors for the output type in the file preprocessors.xml: This file links the output type selected by the user to the conductor file used to transform the content. Processors also define system and user parameters that apply to the transformation process.
  3. Add targets to the conductor file: The conductor file contains the sets of Apache Ant tasks (called targets) to execute for the transformation scenario. This is where the transformation occurs. You can write a target using any standard Apache Ant tasks and properties or you can use the IXIASOFT custom Ant properties, targets, and tasks.
This is shown in the diagram below:
Create a transformation scenario