30.6.2 Deciding what to include in a general configuration template

A configuration template should include settings and values that you normally use in most or all projects for a given type of output. The settings in the template file apply to any configuration file that references that template, reducing the need to add the same settings to every project configuration file.

Mif2Go supplies an extensive collection of templates already chained together. You can insert other templates in this chain, between your starting project configuration file and the the first Mif2Go-supplied file in the chain. However, you might prefer to add settings to the appropriate editable configuration file supplied in the existing chain; see §30.5 Deciding which configuration file to edit.

Books that share a FrameMaker template probably can share the same Mif2Go configuration template. You might want different configuration templates for TOC, IX, and regular chapters. Configuration templates for different books might all reference a company-wide configuration template that specifies logos and other boilerplate items.

Project overrides template

If a setting has a value in a template file that is different from its value in the project configuration file, the value in the project configuration file takes precedence, allowing you to override the template when necessary; see §33.1.2 Understanding precedence of configuration settings.

Define macros elsewhere

Do not include macro definitions in a general configuration template; keep macro definitions in a separate library file; see §28.2.4 Including macro definitions in your own macro library and §30.1.4 Understanding how macro libraries are organized.

Specify run-time values elsewhere

Do not include [UserVars] or [UserVarPrompts] in a configuration template; these two sections must be in your project configuration file. See §34.5 Supplying run-time values for user variables.

Specify condition settings elsewhere

Do not include [ConditionsShown] in a configuration template; this section must be in your project configuration file. See §5.4.1 Applying condition Show/Hide settings.

Some settings are duplicated

Although the settings in Table 30-8 can be included in a configuration template, some will end up in the project configuration file anyway; either because Mif2Go originates them, or because their values can be changed at run time via Choose Project dialog or Export dialog (or by Mif2Go). If you remove one of these settings from the project configuration file, Mif2Go will put it back in, at the end of the section where it belongs. If the section itself is missing, Mif2Go places the section and the setting near the end of the project configuration file.

Table 30-8 Configuration options determined at run time

Configuration section	Option	Reference
Automation	CompileHelp	35.10
	WrapAndShip	35.2
Setup	IDFileName	5.3.4.1
	PluginVersion	D.2.9
	PrjFileName	C.3
	UseExistingDCL	5.1.4
	UseExistingMIF	5.1.3
	WriteAllGraphics	5.7.2.1
	WriteEquations	5.7.2.1
Graphics	UseGraphicPreviews	5.7.2.2
	UseOriginalGraphicNames	5.7.2.3
HelpOptions	MakeCombinedCnt	8.2.8

---