30.7.1 Specifying conversion-template settings

To have Mif2Go apply a FrameMaker template to your document, your configuration file must include values for three template settings: ApplyTemplateFile, TemplateFileName, and AppliedTemplateFlags. For example:

[Templates]

; ApplyTemplateFile = No (default) or Yes (save and restore document)

ApplyTemplateFile=Yes

; TemplateFileName = filename.fm (FrameMaker template for export)

TemplateFileName="G:\Omnisys\UG\UGTplHlp.fm"

; AppliedTemplateFlags = 0 (default) or bitfield spec of properties

AppliedTemplateFlags=147

Unless the template to be applied is in the same directory as the document you are converting, specify a full absolute path (not a relative path) for TemplateFileName. Enclose the entire path in quotes if the path includes any spaces (and see §2.1 Naming files, directories, and paths).

FrameMaker uses the value of AppliedTemplateFlags to determine which items to import. This number is a representation of the choices you make via Import Formats: the decimal sum of the values (listed in Table 30-9) of all the options you check. For example, if you check paragraph formats, cross-reference settings, and conditional-text settings, the value of AppliedTemplateFlags would be 1+128+16=145.

Note:  A value of zero (AppliedTemplateFlags=0) means import everything. To import nothing, you must set ApplyTemplateFile=No.

Table 30-9 Template flag values for importing formats

Import Formats option	Import formats flag value
	Decimal	Hexadecimal
Paragraph formats	1	0x0001
Character formats	2	0x0002
Page layouts	4	0x0004
Table formats	8	0x0008
Conditional text settings	16	0x0010
Reference pages	32	0x0020
Variable definitions (both System and User)	64	0x0040
Cross-reference settings	128	0x0080
Color definitions	256	0x0100
Math definitions	512	0x0200
Document properties (at your own risk)	1024	0x0400
Remove manual page breaks	16384	0x4000
Remove overrides	32768	0x8000

If absolutely necessary, you can also specify the following template option:

[Templates]

; ImportDocProps = No (default) or Yes (include doc props in import)

ImportDocProps=Yes

By default, Mif2Go instructs FrameMaker not to import document properties, which include the following:

• custom marker types

• footnote properties

• volume, chapter, page, paragraph, footnote, and table footnote number styles

• text options “allow line breaks” settings

• line layout “feather” settings

Note:  A defect in FrameMaker can cause numerous document settings to change unexpectedly when you import document properties, even from the same file. Unless you have a very good reason to import document properties, use only the default setting: ImportDocProps=No.

---