Integrate an attribute specialization

You might have specialized attributes that you need to integrate into IXIASOFT CCMS Desktop. For example, you might need to color some of your code samples and therefore you have specialized a color attribute from the existing base attribute. In these steps, we assume you have created the specialization in a file named companyAttDomain.ent (included as an appendix). These steps use the same CompanyDitabase.dtd file name as in the previous instructions.
  1. Copy companyAttDomain.ent into the dtd subfolder of your DTD plugin.
  2. Check out and open CompanyDitabase.dtd.
  3. Scroll to the DOMAIN ATTRIBUTE DECLARATIONS section.
  4. Add an entity definition similar to the following to that section:
    <!ENTITY % company-d-dec
      PUBLIC "-//COMPANY//ENTITIES DITA Company Attribute Domain//EN" 
             "companyAttDomain.ent"
    >%company-d-dec;

    Where the public identifier matches the one you assigned in companyAttDomain.ent and the system identifier matches the file name. Note that because companyAttDomain.ent lives in the same folder as CompanyDitabase.dtd, the system identifier path is flat.

  5. Scroll to the DOMAIN ATTRIBUTE EXTENSIONS section.
  6. Edit the base-attribute-extensions entity to include the entity (color-d-attribute) that defines your new attribute in companyAttDomain.ent, similar to the following example:
    <!ENTITY % base-attribute-extensions 
               "%localization-loc-d-attribute;
                %color-d-attribute;"                                     >
  7. Locate the DOMAINS ATTRIBUTE OVERRIDE section.
  8. Add the color-d-att entity to the list of included domains.
    <!ENTITY included-domains 
                              "&concept-att;
                               &glossentry-att;
                               &glossgroup-att;
                               &reference-att;
                               ...
                               &equation-d-att;
                               &localization-loc-d-att;
                               &xml-d-att;
                               &color-d-att;
      "
    >
  9. Save, close, and check in CompanyDitabase.dtd.

    You do not need to make any changes to catalog.xml.

  10. Restart the IXIASOFT CCMS Desktop.
  11. 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 existing copy.

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

    2. Run the integrator to integrate the plugin.

You can now include the color attribute in your content.