Customizing DITA Transformations

Oxygen XML Author plugin includes a bundled copy of the DITA-OT as an Oxygen XML Author plugin framework. That framework includes a number of transformation scenarios for common output formats. This section includes topics about customizing DITA transformations, such as using a custom build file, customizing PDF output, and using DITA OT plugins to customize your needs.

Customizing Output Transformations

You can customize the appearance of any of the output types by customizing the output transformations. There are several ways to do this:

  • Most transformations are configurable by passing parameters to the transformation script. Oxygen XML Author plugin allows you to set parameters on a transformation scenario and you can save and share them with others. You can also use the ${ask} editor variable in the Parameters tab to instruct Oxygen XML Author plugin to prompt you for a particular parameter whenever a transformation scenario is run. You can set up multiple transformation scenarios for a given output type, allowing you to maintain several customized transformation scenarios for multiple types of output configurations.
  • If you want to customize an output in a way not supported by the customization options, you can create a modified version of the transformation code. Some transformation scripts export specific forms of extension or customization. You should consult the DITA Open Toolkit for the transformation type that you are interested in to see what customization options it supports.

You can also write your own output transformation scripts to produce a type of output not supported by the DITA Open Toolkit. You can create Oxygen XML Author plugin transformation scenarios to run these scripts once they are complete.