42.2.7 Understanding fixed-key vs. variable-key settings

The settings in some DITA2Go configuration sections are global in scope, and use fixed keys: predefined keywords to which you can assign values. The settings in other configuration sections use variable keys: the names of formats, tables, or graphics in your document. You can override some settings in most fixed-key sections, and all settings in most variable-key sections.

Fixed-key configuration sections

Configuration sections such as [HTMLOptions] have a set of predefined keywords, and the value you assign to a given keyword usually applies to the entire document. You can change the value of a fixed-key setting only with a persistent override, where you name the key whose value is to be overridden. Temporary overrides do not apply to fixed-key settings; see §42.2.1 Determining the extent of a configuration override. Table 42-2 lists the fixed-key configuration sections that include settings subject to override.

Variable-key configuration sections

Configuration sections such as [HelpStyles] use format names or object identifiers as keys, where the key name is one of the following:

You can use either persistent overrides or temporary overrides for most variable-key settings. You can override settings in the variable-key sections listed in the following tables:

Table 42-3 Text configuration sections subject to overrides

Table 42-4 Cross-reference sections subject to overrides

Table 42-5 HTML table sections subject to overrides

Table 42-6 HTML graphic sections subject to overrides

Previous Topic:  42.2.6 Assigning a macro or variable to a configuration variable

Next Topic:  42.2.8 Overriding fixed-key configuration settings

Parent Topic:  42.2 Overriding settings with PI markers or macros

Sibling Topics:

42.2.1 Determining the extent of a configuration override

42.2.2 Overriding settings with configuration PI markers

42.2.3 Overriding settings with macros

42.2.4 Assigning values to configuration variables

42.2.5 Adding a new configuration setting on the fly

42.2.6 Assigning a macro or variable to a configuration variable

42.2.8 Overriding fixed-key configuration settings

42.2.9 Overriding variable-key configuration settings

42.2.10 Assigning HTML table and graphic groups with overrides

Table of ContentsIndex