Integrate the Localization domain for DITA 1.2

IXIASOFT CCMS Desktop uses a specialized Localization domain. This domain consists of one attribute, @ixia_locid, which is used to uniquely identify segments for translation. CCMS Desktop includes a system trigger that adds this attribute to nearly all elements when an object is released.

If you integrate your own DTDs into CCMS Desktop, you need to integrate the Localization domain into them; otherwise, you cannot release locked objects because the CMS cannot add @ixia_locid as required.

These steps assume you have already added your DTDs to the system configuration, and made all necessary changes to your DTD plugin, master-catalog.xml, and other applicable files.

  1. Check out and open your DTD.
  2. Scroll to the DOMAIN ATTRIBUTE DECLARATIONS section.
  3. Add the following.
    <!ENTITY % localizationAtt-d-dec 
      PUBLIC "-//IXIA//ENTITIES DITA Localization Domain//EN" 
             "../../com.ixiasoft.dita.dtd/dtd/localizationDomain.ent"
    >%localizationAtt-d-dec;
    Note: The pathing shown here assumes your DTD is part of a DTD plugin that you have created following the structure described in Creating a custom DTD plugin in the system configuration and that its relative path is therefore as shown in this example. If you have not followed that recommended convention, you must edit this path so that it correctly reflects the relative path between your DTD and the localizationDomain.ent file.
  4. Scroll to the DOMAIN ATTRIBUTE EXTENSIONS section.
  5. Add %localization-loc-d-attribute; to the list of base attribute extensions.

    For example, if this is the only extension to the base attribute, then the end result looks like this:

    <!ENTITY % base-attribute-extensions
            "%localization-loc-d-attribute;"                          >

    On the other hand, if there are already extensions to the base attribute, then the end result might look something like this, with the new extension added at the end of the list:

    <!ENTITY % base-attribute-extensions 
               "%region-d-attribute;
                %module-d-attribute;
                %localization-loc-d-attribute;"                          >
  6. Scroll to the DOMAINS ATTRIBUTE OVERRIDE section.
  7. Add &localization-loc-d-att; to the list of included domains.
    <!ENTITY included-domains 
                    "&concept-att;
                     &glossentry-att;
                     &glossgroup-att;
                     &reference-att;
                     &task-att;
                     &hi-d-att;
                     &ut-d-att;
                     &indexing-d-att;
                     &hazard-d-att;
                     &abbrev-d-att;
                     &pr-d-att;
                     &sw-d-att;
                     &ui-d-att;
                     &taskbody-constraints;
                     &localization-loc-d-att;"
    >
  8. Save, close, and check in your DTD.
  9. To add the specialization to IXIASOFT CCMS Output Generator, do the following:
    1. Copy the entire com.company.dtd plugin folder into the %OutputGenDir%/data/%OT_Dir%/plugins folder, overwriting the previous copy.

      Depending on your CCMS Output Generator configuration, the DITA-OT path might vary.

    2. Run the integrator to integrate the plugin.