#### 42.2.3 Overriding settings with macros

To change a configuration setting mid-document with a macro, you must include a configuration-variable assignment either in a code-type PI marker or (for persistent overrides only) in a configuration macro included in your configuration file or macro library.

The macro override choices apply as follows:

HTML Code PI marker | HTML output only; ignored for RTF output
Code PI marker | HTML or RTF output, wherever the setting is applicable
DITA2Go macro | HTML or RTF output, wherever the setting is applicable, but only for persistent overrides.

To change the value of a configuration setting with a macro in a PI marker, insert a PI marker of type Code or HTML Code at the place where you want the value to change, and supply as content for the marker a configuration-variable assignment constructed as described in §42.2.4 Assigning values to configuration variables.

For persistent overrides only, you can include the configuration-variable assignment in a configuration macro that applies the directive based on some condition; see §42.2.1 Determining the extent of a configuration override.

Previous Topic: 42.2.2 Overriding settings with configuration PI markers

Next Topic: 42.2.4 Assigning values to configuration variables

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.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