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

Table of ContentsIndex