Documentation Center

The DITA-OT files

Some important DITA Open Toolkit files and their locations are described. You can use this as starting point to change your XSL-FO renderer or add layout options.

Installation locations and options, config.psm1
The \App\Utilities\DITA-OT\InfoShare\config.psm1 file contains the installation locations and configuration for various applications and JAVA classes that are used when you run DITA-OT. An initial value for the configuration folder was provided at installation time. For example the default pdf formatter is Antenna House ($ENV:PDF_FORMATTER="ah"), but for example if you want to use RenderX XEP you can do so by
  • Uncommenting $ENV:XEP_DIR and setting it's value to the folder that contains the RenderX formatter executable.
  • Setting the value of $ENV:PDF_FORMATTER to xep
. The values set in the config.psm1 file are taken into account in \App\Utilities\DITA-OT\InfoShare\SupportedSoftware.xml in order to build the pdf.
Content Manager PDF plugin into DITA-OT, plugin.xml
The \App\Utilities\DITA-OT\InfoShare\plugins\ishPdf\plugin.xml file registers the Content Manager PDF plugin into DITA-OT.
Generic resources for publish operation, integrator.xml
The \App\Utilities\DITA-OT\InfoShare\plugins\ishPdf\integrator.xml file specifies generic resources always required during a publishing operation of the ishPDF type, such as generic images.

The file also indicates that the main shell XSL transform file, responsible for converting the DITA source files to the desired FO file, is located in \App\Utilities\DITA-OT\Infoshare\plugins\ishpdf\xsl\xslfo\infoshare.dita2fo.shell.xsl

The Content Manager XSL transformation routines
The Content Manager XSL transformation routines are located in \App\Utilities\DITA-OT\Infoshare\plugins\ishpdf\xsl. If you do your own stylesheet development, we advise you to put a folder next to this folder containing your customer and/or project name. If you apply changes to the Tridion Docs stylesheets, you must ensure that any patches you apply do not negatively affect your rendering.