Omni Systems, Inc.

  

Mif2Go User's Guide, Version 55

  

Valid HTML 4.01!

 

Made with Mif2Go

33 Overriding configuration settings > 33.2 Overriding settings with markers or macros > 33.2.8 Overriding fixed-key configuration settings


33.2.8 Overriding fixed-key configuration settings

An override to a fixed-key configuration setting stays in effect until the end of the current FrameMaker file, or until changed again by another configuration marker or configuration-variable assignment to the same setting. You can override some (but not all) settings in the configuration sections listed in Table 33-2. For example, to switch mid-file to turning on revision tracking in Word: 

[spacer]

Configuration setting

RTFConfig override

[WordOptions]

RevTrack = No

[WordOptions]RevTrack=Yes

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 FrameMaker 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 Mif2Go processes the file content. Other settings such as [WordOptions]SideHeads affect margins, and must apply to an entire file.

For example, suppose your document contains white text that you do not want to display in HTML output; so, in the configuration file you include the following setting:

[HTMLOptions]

HideWhiteText=Yes

But suppose your document also includes some white headings, in paragraph format Head1, that are displayed inside a black box provided in a Frame Below with negative space. You could use macros to override the HideWhiteText setting for these headings:

[ParaStyleCodeBefore]

Head1=<$$[HTMLOptions]HideWhiteText=0>

[ParaStyleCodeAfter]

Head1=<$$[HTMLOptions]HideWhiteText=1>

If you are producing HTML output, the only way to specify attributes for <body> is with a configuration override. For example, placing a marker at the beginning of the second topic in a FrameMaker file:

[Attributes]body= onload='prettyPrint()'

Then at the beginning of the fourth topic:

[Attributes]body=

The effect would appear in HTML output for the second and third topics, but not the fourth. The marker affects the output file for the topic in which it is included, and continues until set otherwise.

You can also override a fixed-key setting with a configuration-variable assignment in a regular Mif2Go macro instead of in a marker. See §28.9.3 Surrounding or replacing text with code or macros.

Table 33-2 Fixed-key configuration sections subject to overrides

Fixed-key configuration section *

HTML/XML

Word

WinHelp

* Some settings cannot be overridden in these sections; you might have to experiment.

[Attributes]

Yes

 

 

[Base]

Yes

 

 

[CharClasses]

Yes

 

 

[Defaults]

 

Yes

Yes

[Setup]

Yes

Yes

Yes

[GraphExport]

Yes

Yes

Yes

[Graphics]

Yes

Yes

Yes

[HelpBrowse]

 

 

Yes

[HelpContents]

 

 

Yes

[HelpOptions]

 

 

Yes

[HTMLOptions]

Yes

 

 

[Inserts]

Yes

Yes

Yes

[JavaHelpOptions]

Yes

 

 

[LocalTOC]

Yes

 

 

[Macros]

Yes

 

 

[MSHtmlHelpOptions]

Yes

 

 

[NavigationMacros]

Yes

 

 

[OmniHelpOptions]

Yes

 

 

[Options]

Yes

Yes

Yes

[ParaClasses]

Yes

 

 

[Tables]

Yes

 

 

[Trails]

Yes

 

 

[WordOptions]

 

Yes

 



33 Overriding configuration settings > 33.2 Overriding settings with markers or macros > 33.2.8 Overriding fixed-key configuration settings