Integrate DTDs into custom topic and map shells (DITA 1.3)

In this second method, you create your own DTD plugin and then integrated into custom topic and map shells. This approach is likely to benefit most deployments.

1. Open your topic shell in com.company.dtd, such as CompanyDitabase.dtd.
2. Open the first custom DTD you want to integrate into CompanyDitabase.dtd.

   For this example, use learningSummary.dtd, defined in DITA-OT\plugins\org.oasis-open.dita.v1_3\dtd\learning\dtd.

3. In learningSummary.dtd, scroll to the TOPIC ENTITY DECLARATIONS section.

   <!ENTITY % learningBase-dec
     PUBLIC "-//OASIS//ENTITIES DITA 1.3 Learning Base//EN"
            "learningBase.ent"
   >%learningBase-dec;
   
   <!ENTITY % learningSummary-dec
     PUBLIC "-//OASIS//ENTITIES DITA 1.3 Learning Summary//EN"
            "learningSummary.ent"
   >%learningSummary-dec;

4. Copy and paste the two entities at the end of the list in the TOPIC ENTITY DECLARATIONS section of CompanyDitabase.dtd.
5. Change the paths of both entities to correctly point to the locations of the learningBase.ent and learningSummary.ent files relative to CompanyDitabase.dtd.
   Use the correct paths. In this example, both plugins are located in the system/plugins folder of the CCMS system configuration.

   <!ENTITY % learningBase-dec
     PUBLIC "-//OASIS//ENTITIES DITA 1.3 Learning Base//EN"
            "../../org.oasis-open.dita.v1_3/dtd/learning/dtd/learningBase.ent"
   >%learningBase-dec;
   
   <!ENTITY % learningSummary-dec
     PUBLIC "-//OASIS//ENTITIES DITA 1.3 Learning Summary//EN"
            "../../org.oasis-open.dita.v1_3/dtd/learning/dtd/learningSummary.ent"
   >%learningSummary-dec;

   Important: It is critical to get these paths correct.
6. In learningSummary.dtd, scroll to the DOMAIN ENTITY DECLARATIONS section.
7. Look for any entities that are unique to learningSummary.dtd.
   There are five unique entities.

   <!ENTITY % learningInteractionBase-d-dec
     PUBLIC "-//OASIS//ENTITIES DITA 1.3 Learning Interaction Base Domain//EN"
            "learningInteractionBaseDomain.ent"
   >%learningInteractionBase-d-dec;
   
   <!ENTITY % learningInteractionBase2-d-dec
     PUBLIC "-//OASIS//ENTITIES DITA 1.3 Learning Interaction Base 2 Domain//EN"
            "learningInteractionBase2Domain.ent"
   >%learningInteractionBase2-d-dec;
   
   <!ENTITY % learning-d-dec
     PUBLIC "-//OASIS//ENTITIES DITA 1.3 Learning Domain//EN"
            "learningDomain.ent"
   >%learning-d-dec;
   
   <!ENTITY % learning2-d-dec
     PUBLIC "-//OASIS//ENTITIES DITA 1.3 Learning 2 Domain//EN"
            "learning2Domain.ent"
   >%learning2-d-dec;
   
   <!ENTITY % learningmeta-d-dec
     PUBLIC "-//OASIS//ENTITIES DITA 1.3 Learning Metadata Domain//EN"
            "learningMetadataDomain.ent"
   >%learningmeta-d-dec;

   Note: The other entities in this section are not unique to learningSummary.dtd and are already integrated into CompanyDitabase.dtd. You don't need to integrate them again.
8. Copy and paste the five entities at the end of the list in the DOMAIN ENTITY DECLARATIONS section of CompanyDitabase.dtd.
9. Change the paths of all entities to correctly point to the locations of these files relative to CompanyDitabase.dtd.
10. In learningSummary.dtd, scroll to the DOMAIN EXTENSIONS section.
11. Look through each of the entities defined there to locate any extensions that are specific to the learningSummary.dtd.

    In this case, there are quite a few:

    <!ENTITY % index-base   "index-base |
                             %indexing-d-index-base;
                            ">
    <!ENTITY % ph           "ph |
                             %hi-d-ph;
                            ">
    <!ENTITY % fig          "fig |
                             %ut-d-fig; |
                             %learningInteractionBase-d-fig; |
                             %learning-d-fig;
                            ">
    <!ENTITY % data         "data |
                             %ut-d-data;
                            ">
    <!ENTITY % metadata     "metadata |
                             %relmgmt-d-metadata; |
                             %learningmeta-d-metadata;
                            ">
    <!ENTITY % div          "div |
                             %learningInteractionBase2-d-div; |
                             %learning2-d-div;
                            ">
    <!ENTITY % note         "note |
                             %learning-d-note; |
                             %learning2-d-note;
                            ">
    <!ENTITY % lcInteractionBase "lcInteractionBase |
                             %learning-d-lcInteractionBase;
                            ">
    <!ENTITY % lcInteractionBase2 "lcInteractionBase2 |
                             %learning2-d-lcInteractionBase2;
                            ">

    Note: There are additional extensions within existing entities, such as fig, metadata, div, or note, while some are entirely new entities, such as lcInteractionBase and lcInteractionBase2. Treat the two types as distinct.
12. Copy and paste the additional extensions within the existing entities and paste them into the same entity in CompanyDitabase.dtd.
    For example, copy %learningInteractionBase-d-fig; and and paste it into the existing fig entity in CompanyDitabase.dtd.

    <!ENTITY % fig          "fig | 
                             %pr-d-fig; | 
                             %ut-d-fig; |
                             %equation-d-fig; |
    						 %learningInteractionBase-d-fig; |
    			%learning-d-fig;
                            ">

    Note: Make sure you add the | after %equation-d-fig; and %learningInteractionBase-d-fig;.
13. Repeat step 11 to add the remaining extensions to the existing entities, such as metadata, div, and note.
14. Copy the lcInteractionBase and lcInteractionBase2 entities as-is from learningSummary.dtd to CompanyDitabase.dtd.
15. In learningSummary.dtd, scroll to the DOMAIN ATTRIBUTE OVERRIDE section.
16. Look through the list for any domains that are unique to learningSummary.dtd.
    In this case, there are six unique included domains

    <!ENTITY included-domains
                              "&learningBase-att;
                               &learningSummary-att;
                               &deliveryTargetAtt-d-att;
                               &hi-d-att;
                               &indexing-d-att;
                               &relmgmt-d-att;
                               &ut-d-att;
                               &learningInteractionBase-d-att;
                               &learningInteractionBase2-d-att;
                               &learning-d-att;
                               &learning2-d-att;
                               &learningmeta-d-att;
      "
    >

17. Copy these six domains and paste them into the DOMAIN ATTRIBUTE OVERRIDE section in CompanyDitabase.dtd.
18. In learningSummary.dtd, scroll to the TOPIC ELEMENT INTEGRATION section to locate the unique entities.

    <!ENTITY % learningBase-type
      PUBLIC "-//OASIS//ELEMENTS DITA 1.3 Learning Base//EN"
             "learningBase.mod"
    >%learningBase-type;
    
    <!ENTITY % learningSummary-type
      PUBLIC "-//OASIS//ELEMENTS DITA 1.3 Learning Summary//EN"
             "learningSummary.mod"
    >%learningSummary-type;

    Note: The other entities in this section are not unique to learningSummary.dtd and are already integrated into CompanyDitabase.dtd. You don't need to integrate them again.
19. Copy and paste the last two entities, learningBase-type and learning-Summary-type, at the end of the list in the TOPIC ELEMENT INTEGRATION section of CompanyDitabase.dtd.
20. Change the paths of both entities to correctly point to the locations of the learningBase.mod and learningSummary.mod files relative to CompanyDitabase.dtd.
21. In learningSummary.dtd, scroll to the DOMAIN ELEMENT INTEGRATION section.
22. Look for any entities that are unique to learningSummary.dtd.

    <!ENTITY % learningInteractionBase-d-def
      PUBLIC "-//OASIS//ELEMENTS DITA 1.3 Learning Interaction Base Domain//EN"
             "learningInteractionBaseDomain.mod"
    >%learningInteractionBase-d-def;
    
    <!ENTITY % learningInteractionBase2-d-def
      PUBLIC "-//OASIS//ELEMENTS DITA 1.3 Learning Interaction Base 2 Domain//EN"
             "learningInteractionBase2Domain.mod"
    >%learningInteractionBase2-d-def;
    
    <!ENTITY % learning-d-def
      PUBLIC "-//OASIS//ELEMENTS DITA 1.3 Learning Domain//EN"
             "learningDomain.mod"
    >%learning-d-def;
    
    <!ENTITY % learning2-d-def
      PUBLIC "-//OASIS//ELEMENTS DITA 1.3 Learning 2 Domain//EN"
             "learning2Domain.mod"
    >%learning2-d-def;
    
    <!ENTITY % learningmeta-d-def
      PUBLIC "-//OASIS//ELEMENTS DITA 1.3 Learning Metadata Domain//EN"
             "learningMetadataDomain.mod"
    >%learningmeta-d-def;

    Note: The other entities in this section are not unique to learningSummary.dtd and are already integrated into CompanyDitabase.dtd. You don't need to integrate them again.
23. Copy and paste these five entities at the end of the list in the DOMAIN ELEMENT INTEGRATION section of CompanyDitabase.dtd.
24. Change the paths of all entities to correctly point to the locations of these files relative to CompanyDitabase.dtd.
25. Save CompanyDitabase.dtd.