Integrate an attribute specialization

You might have specialized attributes that you need to integrate into IXIASOFT CCMS. 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.

You can now include the color attribute in your content. Next, you must integrate it into the Output Generator, to ensure you can successfully generate output from content that includes the specialized attribute. Refer to Integrate a specialization into the Output Generator for instructions.