#### 24.2.5 Substituting document format names for default names

When DITA2Go creates a configuration file for a new DITA project, the default settings in all configuration sections that involve assigning a property to a format are based on the format names in a standard template.

If you want format names different from those in the standard template, you must change these settings. You must also add settings for other formats that you want to map to other than the default block and inline elements, which are <p> and <ph>, respectively.

Note: It is best not to delete any default settings until you know what you are doing.

Default settings in the following configuration sections are based on formats in the standard template:

[DITAParaTags]

[DITACharTags]

[DITACharTypographics]

[DITALevels]

[DITAParents]

[DITAParaTags]

Only a few paragraph formats are automatically mapped to DITA elements:

    [DITAParaTags]
    ; para format (wildcards OK) = DITA element
    Body=p
    Heading*=title
    Numbered=li
    Numbered1=li
    Bulleted=li
    FigureTitle=title
    CellBody=p
    CellHeading=p

See §24.4.3 Mapping paragraph formats to DITA block elements.

[DITACharTags]

Only one character format is automatically mapped to a DITA element:

    [DITACharTags]
    Emphasis=i

See §24.4.4 Mapping character formats to DITA inline elements.

[DITACharTypographics]

The only character format automatically included here is Emphasis; combined with its default mapping in [DITACharTags], this setting makes Emphasis both bold and italic:

    [DITACharTypographics]
    ; char format (wildcards OK) = DITA typographic
    ;  elements (any or all of b, i, u, tt, sup, or sub) to use in
    ;  addition to the element to which the format is mapped in
    ;  [DITACharTags].
    Emphasis=b

See §24.4.5 Assigning multiple typographic elements to a format.

[DITALevels]

By default, a paragraph format named Title that is not explicitly mapped in [DITAParaTags] becomes a <title> element, which is always at level 1 in its DITA topic:

    [DITALevels]
    ; format (para or char, wildcards OK) = level in DITA
    ; file required for the DITATag specified for this element.
    Title=1
    Heading*=3

See §24.5.12 Specifying DITA element levels.

[DITAParents]

Only a few paragraph formats are automatically assigned DITA parents:

    [DITAParents]
    ; format (para or char, wildcards OK) = required parents
    Title=topic
    Heading*=section
    Numbered1=ol
    Numbered=ol
    Bulleted=ul
    FigureTitle=fig

See §24.5.2 Designating DITA ancestor elements.

Previous Topic: 24.2.4 Configuring the DITA DTD SYSTEM identifier

Next Topic: 24.3 Specifying general options for DITA

Parent Topic: 24.2 Setting up a DITA XML project

Sibling Topics:

24.2.1 Creating a DITA XML project

24.2.2 Specifying DITA output options

24.2.3 Specifying DITA version

24.2.4 Configuring the DITA DTD SYSTEM identifier

Table of Contents • Index