Documentation Center

Configuring a custom DITA-OT environment

Content Manager installs with a number of pre-configured output formats. Custom DITA-OT stylesheets can be added to the system as well.

Setting up a custom DITA-OT environment

Customizing publishing in Tridion Docs is mostly based on publish post-process plugins customization. Some layout aspects however can be changed through the use of custom stylesheets for DITA-OT.

If you want to integrate your own stylesheets into the DITA-OT delivered with Content Manager, or if you want to create custom output formats, it is advised to clone the DITA-OT. This has the following advantages: upgrades of Content Manager has no effect on your DITA-OT implementation, you have full control over which version is used of the DITA-OT, SAXON, ANT, etc.

DITA-OT can be found in the following location: <drive>:\InfoShare\App<project>\Utilities\DITA-OT\InfoShare

where
  • <drive>: drive letter on which the Content Manager CMS is installed
  • <project>: project suffix as defined during installation
The following steps must be executed:
  1. Copy the existing DITA-OT\InfoShare directory as <drive>:\InfoShare\App<project>\Utilities\DITA-OT\<company name>
  2. Copy your stylesheets into the plugins folder of the custom DITA-OT directory (<drive>:\InfoShare<project>\App<project>\Utilities\DITA-OT\<company name>\plugins\).

Changing the metadata configuration file

Make the following changes to the MetadataConfig.xml file:
  • Add a StyleProcessor (ishfrmfield with id = StyleProcessorField)

    <item>
       <value>DITA-OT\<company name></value>
       <label>Your own DITA-OT implementation</label>
    </item>							
  • Optional: Add a TransType in case you need to define additional plug-ins (ishfrmfield with id = DitaOTTransactionTypeField)

    <item>
       <value>pdf2</value>
       <label>Idiom plugin</label>
    </item>