42.2.1 Determining the extent of a configuration override

An override to a configuration setting can affect either a single item in your document (a temporary override), or a series of items (a persistent override), depending on the syntax you use for the override; see §42.2.4 Assigning values to configuration variables. DITA2Go does not store either persistent or temporary overrides in your configuration file. The configuration file always retains the original values of the settings.

Persistent overrides

A persistent override stays in effect until changed by another override of the same setting, or until the end of the DITA file in which the override occurs, whichever comes first. To apply a persistent override, insert a PI marker in your document just before the place where you want the override to take effect; and (optionally) later, another PI marker to reverse the effect. For certain fixed-key settings, you can include a configuration override in a regular DITA2Go macro instead of in a PI marker; see §42.2.3 Overriding settings with macros.

Temporary overrides

A temporary override affects only one instance of the item (text, table, or graphic) to which the setting applies. To apply a temporary override, you insert a PI marker just before the item to which the override should apply. Temporary overrides can be applied only to variable-key settings; see §42.2.7 Understanding fixed-key vs. variable-key settings.

Previous Topic:  42.2 Overriding settings with PI markers or macros

Next Topic:  42.2.2 Overriding settings with configuration PI markers

Parent Topic:  42.2 Overriding settings with PI markers or macros

Sibling Topics:

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.7 Understanding fixed-key vs. variable-key settings

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