41.7.1 Creating a content model for a specialized topic type

To create a content model for a specialized DITA topic type:

  1. Run utility program dtd2ini with the DTD file for your specialized type as input. Specify for output a content-model configuration file with a name of the form DITAnewtype.ini, where newtype is the name of the new topic type you are defining. See §41.2.2 Generating a content model from a DTD.
  2. Add the following settings to DITAnewtype.ini:

    [Topic]
    ; TopicStart = name of element that starts topic, such as
    ;  "glossterm" (for glossary) or "title" (for every other type).
    TopicStart = title
    ; TopicBody = name for its body element, such as conbody for
    ;  concept.
    TopicBody = conbody

    The required starting element is <title> for all built-in DITA topic types (including map), except for glossary. For glossary topics, the starting element is <glossterm>. For a specialized topic type, your DTD specifies the starting element.

    When the format mapped to the TopicStart element in [DITAParaTags] is also mapped to level 1 in [DITALevels], that format always starts a new topic of the specialized type. See §24.5.12 Specifying DITA element levels.

  3. In your project configuration file, list the name of your new topic type:

    [DITAContentModels]
    DITAnewtype = any text here (ignored)

    See §41.7.5 Listing DITA topic type configuration files.

  4. Place DITAnewtype.ini where DITA2Go can find it; see §41.7.6 Locating DITA topic type configuration files.

Previous Topic:  41.7 Specializing or modifying DITA topic types

Next Topic:  41.7.2 Overriding settings in a DITA content model

Parent Topic:  41.7 Specializing or modifying DITA topic types

Sibling Topics:

41.7.2 Overriding settings in a DITA content model

41.7.3 Eliminating elements from a DITA content model

41.7.4 Overriding declarations in a DITA map content model

41.7.5 Listing DITA topic type configuration files

41.7.6 Locating DITA topic type configuration files

Table of ContentsIndex