##### 3.2.1.5 Correcting configuration errors

If any of the configuration files open for a given session contain settings that appear not to be valid in their section, or sections that appear not to be valid in their file, the Configuration Manager displays the names of those settings or sections in red. You will need to delete the items, rename them, or move them to a valid location.

Note: Format names (other than paragraph format names) that do not end with the required suffix always show red in the Configuration Manager. You cannot use the Configuration Manager to rename formats, because renaming a format can affect many other types of settings.

Format names without a valid suffix

If a format name is displayed in red on the Section page, usually this is because either the name lacks an appropriate suffix, or the name ends in a suffix that is not valid in the file where the format is defined. Table 7-1 shows valid suffixes for format names.

The Configuration Manager assumes any format in a Formats configuration file is a paragraph format, unless its name ends in Char. Any format in a Tables configuration file is assumed to be a table format, unless its name ends in Row or Cell.

To correct an improperly named format that is already in use, besides renaming the format, also assign the new name to the old in [FormatAliases]; see §7.3.2 Mapping legacy names to defined formats. In the Configuration Manager, select the top-level category for the type of format: Text Formats, Table Formats, Page Formats, or Format Components.

For example, if you are changing the name of a special table-row format so it ends in Row, select category Table Formats, action Add new setting to section, and section FormatAliases; add a setting such as the following:

    [FormatAliases]
    ; Old format name = new name with proper suffix
    MyTableRow1 = MyTableFirstRow

This will ensure DITA2Go substitutes the new name for the old, in case the old name persists in some settings.

Previous Topic: 3.2.1.4 Providing help for your own format and macro definitions

Next Topic: 3.2.2 Starting the Configuration Manager

Parent Topic: 3.2.1 Understanding how to use the Configuration Manager

Sibling Topics:

3.2.1.1 Drilling down to find a section or setting

3.2.1.2 Heeding status and result messages

3.2.1.3 Getting help with controls and configuration data

3.2.1.4 Providing help for your own format and macro definitions

Table of Contents • Index