Configure your Content Store 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.

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.
These changes are required because when IXIASOFT integrated MathML into previous versions of the DITA CMS, the integration was based on a non-final version of the DITA 1.3 specification. The final integration, available in the DITA-OT 2.3.1, is very slightly different from the original IXIASOFT integration and may not be compatible with your MathML content.
Note: To use DITA-OT 2.3.1 with DITA 1.2, you will also need to upgrade the Output Generator, as described in Configure the Output Generator to use the DITA-OT 2.3.1 with DITA 1.2.

To use DITA-OT 2.3.1 with DITA 1.2:

  1. Change the public IDs for the MathML integration to point to the IXIASOFT integration of the MathML DTDs in the IxiaDitabase.dtd file:
    1. In the /system/plugins/com.ixiasoft.dita.dtd/dtd folder, right-click the IxiaDitabase.dtd file and select Check Out.
    2. Open the file.
    3. 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.
    4. 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;
      
    5. 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.
    6. 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;
      
      
    7. Save and check in the file.
  2. Change the catalog for the MathML plugins to reflect the new public IDs:
    1. In the /system/plugins/org.oasis-open.dita.mathml.doctypes folder, right-click the catalog.xml file and select Check Out.
    2. Open the file.
    3. 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>
  3. Perform the previous steps in your own shell DTDs (for example, by modifying CompanyDitabase.dtd in your com.company.dita.dtd plugin).