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 location, build_init.xml
The \Utilities\DITA-OT\InfoShare\build_init.xml file contains the installation locations for the PDFCompiler and HTMLHelpCompiler, initially provided at installation time. At the time of this writing there are no other locations to change if you have altered your installation paths for these programs, or are switching the render engine. An example from this file is:
<available file="C:\Program Files\Antenna\XSLFormatterV41\XSLCmd.exe" property="PDFCompiler" value="C:\Program Files\Antenna\XSLFormatterV41\XSLCmd.exe"/>
<available file="C:\Program Files\HTML Help Workshop\hhc.exe" property="HTMLHelpCompiler" value="C:\Program Files\HTML Help Workshop\hhc.exe"/>

Changing the PDFCompiler value attribute to C:\Program Files\RenderX\XEPWin\XslDriver.exe specifies that RenderX XEP is your XSL-FO renderer.

Command line options for PDFCompiler, build_dita2pdf.xml
The \Utilities\DITA-OT\InfoShare\build_dita2pdf.xml file contains the command line options for your PDFCompiler entry. For a typical AntennaHouse XSL Formatter installation, an example from this file is:
<!-- Build PDF from FO using AntennaHouse -->
<target name="dita.fo2pdf" if="PDFCompiler" description="Build PDF from FO using a FO processor">
  <echo>Builing PDF using: ${PDFCompiler}</echo>
  <echo>Input parameter     : ${input}</echo>
  <echo>output parameter    : ${output}</echo>
  <echo>Option Setting file : C:\InfoShare\App\Utilities\AntennaHouse\XSLFormatter\XfoSettings.xml</echo>
  <exec executable="${PDFCompiler}" failonerror="${failonerror}" failifexecutionfails="${failonerror}">
    <arg line='-d ${input} -o ${output} -i "C:\InfoShare\App\Utilities\AntennaHouse\XSLFormatter\XfoSettings.xml" -extlevel 4'/>
  </exec>
</target>
By replacing the above target block in the file to the following, you will specify the RenderX XEP command line arguments:
<!--  Build PDF from FO using RenderX -->
<target name="dita.fo2pdf" if="PDFCompiler" description="Build PDF from FO using a FO processor">
  <echo>Builing PDF using: ${PDFCompiler}</echo>
  <echo>Input parameter     : ${input}</echo>
  <echo>output parameter    : ${output}</echo>
  <exec executable="${PDFCompiler}">
    <arg line='${input} -pdf ${output}'/>
  </exec>
</target>
SDL LiveContent Architect PDF plugin into DITA-OT, plugin.xml
The \Utilities\DITA-OT\InfoShare\plugins\ishPdf\plugin.xml file registers the SDL LiveContent Architect PDF plugin into DITA-OT.
Generic resources for publish operation, integrator.xml
The \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<project-suffix>\Utilities\DITA-OT\Infoshare\plugins\ishpdf\xsl\xslfo\infoshare.dita2fo.shell.xsl

The SDL LiveContent Architect xsl transformation routines
The SDL LiveContent Architect xsl transformation routines are located in <drive-letter>:\Infoshare\app<project-suffix>\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 Trisfot InfoShare stylesheets, you must ensure that any patches you apply do not negatively affect your rendering.