30.3.1 Understanding document-specific configuration files

When you set up a conversion project, Mif2Go creates a document-specific configuration file for you, and places a reference to that file in your project configuration file; see §3.5. To establish a document-specific configuration, Mif2Go looks in this file:

%omsyshome%\m2g\local\config\local_m2g_config.ini

or, if the required settings are not there, in this file:

%omsyshome%\m2g\system\config\m2g_config.ini

for the following settings:

[Setup]

. . .

; used when creating document-specific configuration files

LocalConfigPath = ..\_config\

WinHelpDocName = winhelp_doc.ini

WordDocName = word_doc.ini

HTMLDocName = html_doc.ini

These are default values; see §1.3.6 Establish system-wide configuration settings.

If the directory named by LocalConfigPath is not already present, Mif2Go creates this directory.

If not already present in the directory named by LocalConfigPath, Mif2Go creates a configuration file there with one of the following names (or other names if you have changed the defaults), depending on the output type of the project: 

html_doc.ini	for HTML, HTML-based Help, or XML projects
word_doc.ini	for Word or WordPerfect projects
winhelp_doc.ini	for WinHelp projects

This document-specific configuration file is intended for settings that are likely to apply only to the current FrameMaker document, and that will be the same for most outputs. Initially this file includes settings in the following sections:  

html_doc.ini	[HTMLParaStyles], [HelpContentsLevels]
word_doc.ini	[WordSectionFiles], [WordCntStyles]
winhelp_doc.ini	[HelpStyles], [HelpCntStyles], [BrowseStart]

Also included is a comment to show that this file is referenced from the project configuration file. For example:

; Document-specific configuration for HTML outputs

; Referenced by _m2htm.ini

If a document-specific configuration file for the current output type is already present in the directory named by LocalConfigPath, Mif2Go does not overwrite that file, nor add a comment. For additional conversions from the same document you might want to add “referenced by” comments yourself, so you can keep track of which of your project configuration files reference the document-specific configuration file.

---

> 30 Working with templates > 30.3 Including document-specific configuration files > 30.3.1 Understanding document-specific configuration files