Configure the custom map shell DTD for DITA 1.2

Important: Follow these instructions only if you are not using the Dynamic Release Module (DRM). If you are using DRM, use the following topic, Configure the custom map shell DTD (DRM) for DITA 1.2.

Even if you don't anticipate needing a custom map shell at this point, it's very likely that you will. For example, if you specialize any conditional/profiling attributes, you will probably want to be able to use them on topicref elements within maps as well as on elements within topics. To make sure you have the environment you need from the start, it's a good idea to go ahead and create a custom map shell.

  1. Copy IxiaMap.dtd from com.ixiasoft.dita.dtd/dtd to com.company.dtd/dtd.

    You will probably need to export IxiaMap.dtd to your desktop, then add it to your plugin using Insert Documents.

  2. Rename IxiaMap.dtd to CompanyMap.dtd.
  3. Check out and open CompanyMap.dtd.
  4. At the beginning of the file, edit the header to reflect an appropriate name, version, and date for the DTD.

    <!-- ============================================================= -->
    <!--                    HEADER                                     -->
    <!-- ============================================================= -->
    <!--  MODULE:    COMPANY DITA Maps DTD                             -->
    <!--  VERSION:   1.0                                               -->
    <!--  DATE:      October 2016                                      -->
    <!--                                                               -->
    <!-- ============================================================= -->
  5. Just after that, edit the public identifier to be something unique, and change the file name to match your file name.
    <!-- ============================================================= -->
    <!--                    PUBLIC DOCUMENT TYPE DEFINITION            -->
    <!--                    TYPICAL INVOCATION                         -->
    <!--                                                               -->
    <!--  Refer to this file by the following public identifier or an 
          appropriate system identifier 
    PUBLIC "-//COMPANY//DTD DITA Map//EN"
          Delivered as file "CompanyMap.dtd"                           -->
  6. Optional: Delete the following section altogether, or use it to keep a revision history of the file.
    <!-- ============================================================= -->
    <!-- SYSTEM:     Darwin Information Typing Architecture (DITA)     -->
    <!--                                                               -->
    <!-- PURPOSE:    DTD to describe DITA Book Maps                    -->
    <!--                                                               -->
    <!-- ORIGINAL CREATION DATE:                                       -->
    <!--             March 2004                                        -->
    <!--                                                               -->
    <!--             (C) Copyright OASIS Open 2006.                    -->
    <!--             (C) Copyright IBM Corporation 2004, 2005.         -->
    <!--             All Rights Reserved.                              -->
    <!--                                                               -->
    <!--  UPDATES:                                                     -->
    <!-- ============================================================= -->
  7. At the end of CompanyMap.dtd, change the "End" comment as shown:
    <!-- ============= End Customer DITA Maps DTD  ============= -->
  8. Save and check in CompanyMap.dtd.

Next, you need to edit the catalog in your custom DTD plugin to point to your two shell DTDs.