Using DITA-OT 1.4

ePublisher 9.3 is shipped with DITA-OT 1.2.2.


Complete support for all features of DITA-OT 1.4 is not included in this article.
The following instructions will allow you to use DITA-OT 1.4 with ePublisher 9.3. Support for new elements found in DITA-OT 1.4 require additional configuration changes.

Master Project Setup

As with any ePublisher modification, start with a working Master Project.

  1. Install the new "dita-ot" in the project "Helpers" folder.
    1. Download

    2. Create a "Formats" folder in the project directory.
    3. Create a "Helpers" folder inside the newly created "Formats" folder.
    4. Extract into the "Helpers" folder.

    5. Rename "DITA-OT1.4" to "dita-ot".
    6. Delete

  2. Create an Adapter override to enable DITA-OT 1.4 operation.
    1. Inside the "Formats" folder of the project directory, create the following hierarchy:

    <project directory>
  1. Download to the "xsl" directory.

  2. Extract to get "batch-files.xsl".

  3. Delete

Test Master Project

At this point, you should be able to add DITA content to your project and it will be processed with DITA-OT 1.4 instead of the default DITA-OT 1.2.2.

Create Stationery

To distribute your changes for use by Express and AutoMap users, perform the following actions:

  1. Update ePublisher Stationery normally.
    1. In your Master Project, select File --> Save as Stationery.

    2. Specify a location and name for your new stationery.
  2. Insert your "Adapters" and "Helpers" overrides manually.
    1. Locate and open your newly created Stationery.
    2. Open the "Formats" folder.
    3. Copy your "Adapters" and "Helpers" folders from your Master Project into your Stationery's "Formats" folder. NOTE: This step must be performed manually as we do not wish to include all possible helper programs.

Use It

All Express and AutoMap projects tied to this new version of the Stationery will be processed with DITA-OT 1.4 following project synchronization.

Target Overrides

Following the instructions above, it is also possible to override DITA-OT versions on a target by target basis. Simply replace reference to the "Formats" folder in the above instructions with a specific target folder name, such as "Targets\DITA-OT_1.4".

Such a configuration would allow a single project to generate the same source content using different versions of the DITA-OT.

:) :)) :( ;) :\ |) X-( B) Markup

HelpCenter/Tips/DITA/Release Specific/ePublisher 9.3/Using_DITA-OT_1.4 (last edited 2008-09-02 13:58:37 by BenAllums)