Configure the Output Generator to use the DITA-OT 2.3.1 with DITA 1.2

In DITA CMS 4.3, the Output Generator supports version 2.3.1 of the DITA-OT, which includes the DITA 1.3 DTDs. To use DITA 1.2 with the DITA-OT 2.3.1, you must update your DTDs in the Output Generator.

Note: If you are still using ixiaditabase.dtd and not your own shell plugin to generate the output, IXIASOFT does not recommend using the DITA-OT 2.3.1.
  1. Copy your plugin to the DITA-OT 2.3.1 directory.
    For example, assuming that your plugin is called com.company.dita.dtd and you are currently using DITA-OT 1.8.5, move the following directory:

    C:\ixiasoft\OutputGenerators\Prod_4.3\data\DITA-OT1.8.5\plugins\com.company.dita.dtd

    To the following location:

    C:\ixiasoft\OutputGenerators\Prod_4.3\data\dita-ot-2.3.1\plugins\com.company.dita.dtd

  2. Change the public IDs for the MathML integration to point to the IXIASOFT integration of the MathML DTDs in your CompanyDitabase.dtd file:
    1. Open the %OutputGenDir%/data/dita-ot-2.3.1/plugins/com.company.dita.dtd/dtd/CompanyDitabase.dtd file with a text editor.
    2. Look for the first MathML Integration section.
      For example:
      <!-- ================== MathML Integration ======================= -->
      <!--                    Un-comment the following block to enable
                              MathML elements directly inside topics     -->
      
      <!ENTITY % mathml-d-dec 
        PUBLIC "-//OASIS//ENTITIES DITA 1.3 MathML Domain//EN" 
               "../../org.oasis-open.dita.mathml.doctypes/dtd/mathmlDomain.ent"
      >%mathml-d-dec;
      
      <!ENTITY % equation-d-dec 
        PUBLIC "-//OASIS//ENTITIES DITA 1.3 Equation Domain//EN" 
               "../../org.oasis-open.dita.mathml.doctypes/dtd/equationDomain.ent"
      >%equation-d-dec;
      
      Note: This section may be commented out if you are not using MathML in your deployment.
    3. Change OASIS to IXIA in the public ID and remove the 1.3.
      For example:
      <!-- ================== MathML Integration ======================= -->
      <!--                    Un-comment the following block to enable
                              MathML elements directly inside topics     -->
      
      <!ENTITY % mathml-d-dec 
        PUBLIC "-//IXIA//ENTITIES DITA MathML Domain//EN" 
               "../../org.oasis-open.dita.mathml.doctypes/dtd/mathmlDomain.ent"
      >%mathml-d-dec;
      
      <!ENTITY % equation-d-dec 
        PUBLIC "-//IXIA//ENTITIES DITA Equation Domain//EN" 
               "../../org.oasis-open.dita.mathml.doctypes/dtd/equationDomain.ent"
      >%equation-d-dec;
      
    4. Look for the second MathML Integration section.
      For example:
      <!-- ================== MathML Integration ======================= -->
      <!--                    Un-comment the following block to enable
                              MathML elements directly inside topics     -->
      <!ENTITY % mathml-d-def 
        PUBLIC "-//OASIS//ELEMENTS DITA 1.3 MathML Domain//EN" 
               "../../org.oasis-open.dita.mathml.doctypes/dtd/mathmlDomain.mod"
      >%mathml-d-def;
      
      <!ENTITY % equation-d-def 
        PUBLIC "-//OASIS//ELEMENTS DITA 1.3 Equation Domain//EN" 
               "../../org.oasis-open.dita.mathml.doctypes/dtd/equationDomain.mod"
      >%equation-d-def;
      
      Note: This section may be commented out if you are not using MathML in your deployment.
    5. Change OASIS to IXIA in the public ID and remove the 1.3.
      For example:
      <!-- ================== MathML Integration ======================= -->
      <!--                    Un-comment the following block to enable
                              MathML elements directly inside topics     -->
      <!--
      <!ENTITY % mathml-d-def 
        PUBLIC "-//IXIA//ELEMENTS DITA MathML Domain//EN" 
               "../../org.oasis-open.dita.mathml.doctypes/dtd/mathmlDomain.mod"
      >%mathml-d-def;
      
      <!ENTITY % equation-d-def 
        PUBLIC "-//IXIA//ELEMENTS DITA Equation Domain//EN" 
               "../../org.oasis-open.dita.mathml.doctypes/dtd/equationDomain.mod"
      >%equation-d-def;
      
      
    6. Save and close the file.
  3. Copy the IXIASOFT integration of the MathML plugin to the DITA-OT 2.3.1 directory.
    For example, if you are using DIT-OT 1.8.5, copy the following directory:

    C:\ixiasoft\OutputGenerators\Prod_4.3\data\DITA-OT1.8.5\plugins\org.oasis-open.dita.mathml.doctypes

    To the following location:

    C:\ixiasoft\OutputGenerators\Prod_4.3\data\dita-ot-2.3.1\plugins\

  4. Change the catalog for the MathML plugins to reflect the new public IDs:
    1. Open the %OutputGenDir%/data/dita-ot-2.3.1/plugins/org.oasis-open.dita.mathml.doctypes/catalog.xml file with a text editor.
    2. In the public IDs, change OASIS for IXIA and remove the 1.3.
      The resulting file should be as follows:
      <?xml version="1.0" ?> 
      
      <catalog xmlns="urn:oasis:names:tc:entity:xmlns:xml:catalog" prefer="public">
      
      	<group>
      		<public publicId="-//IXIA//ENTITIES DITA MathML Domain//EN" uri="dtd/mathmlDomain.ent"/>
      		<public publicId="-//IXIA//ELEMENTS DITA MathML Domain//EN" uri="dtd/mathmlDomain.mod"/>
      		<public publicId="-//IXIA//ENTITIES DITA Equation Domain//EN" uri="dtd/equationDomain.ent"/>
      		<public publicId="-//IXIA//ELEMENTS DITA Equation Domain//EN" uri="dtd/equationDomain.mod"/>
      	</group>
      
      </catalog>