• HelpCenter
• Tips
• DITA
• Release Specific
• ePublisher 9.3
• Using_DITA-OT_1.3.1

Using DITA-OT 1.3.1

ePublisher 9.3 is shipped with DITA-OT 1.2.2.

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 DITA-OT1.3.1_bin.zip.

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

   4. Extract DITA-OT1.3.1_bin.zip into the "Helpers" folder.

   5. Rename "DITA-OT1.3.1" to "dita-ot".

   6. Delete DITA-OT1.3.1_bin.zip.

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

    <project directory>
      Adapters
        xml
          scripts
            dita
              xsl

• NOTE: This hierarchy matches the hierarchy found in the ePublisher 9.3 application installation directory.

1. Download batch-files.zip to the "xsl" directory.

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

3. Delete batch-files.zip.

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.3.1 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.3.1 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.3.1".

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

Add your comment Markup