An override to a fixed-key configuration setting stays in effect until the end of the current DITA file, or until changed again by another configuration PI marker or configuration-variable assignment to the same setting. You can override some (but not all) settings in the configuration sections listed in Table 42-2. For example, to switch mid-file to turning on revision tracking in Word:
Only persistent overrides work for fixed-key settings; temporary overrides do not work. Also, persistent overrides work only for fixed-key settings that do not have to apply to an entire DITA file. For instance, it would make no sense to try to change, in the middle of a file, the value of [Setup]ApplyTemplateFile; applying a conversion template is a one-time function that takes place before DITA2Go processes the file content. Other settings such as [WordOptions]SideHeads affect margins, and must apply to an entire file.
If you are producing HTML output, the only way to specify attributes for <body> is with a configuration override. For example, placing a PI marker at the beginning of the second topic:
<?dthtm config="[Attributes]body=
onload='prettyPrint()'" ?>
Then at the beginning of the fourth topic:
<?dthtm config="[Attributes]body="
?>
The effect would appear in HTML output for the second and third topics, but not the fourth. The PI marker affects the output file for the topic in which it is included (right after the root), and continues until set otherwise.
You can also override a fixed-key setting with a configuration-variable assignment in a regular DITA2Go macro instead of in a PI marker. See §37.9.3 Surrounding or replacing text with code or macros.
* Some settings cannot be overridden in these sections; you might have to experiment. |
|||