Omni Systems, Inc. Mif2Go User's Guide, Version 55

<< Prev | Next >>

> 30 Working with templates > 30.5 Deciding which configuration file to edit > 30.5.2 Editing a project configuration file

### 30.5.2 Editing a project configuration file

Mif2Go maintains a set of annotated templates for starting project configuration files, in directory %OMSYSHOME%\m2g\system\starts, to accommodate settings intended to apply only or primarily to individual conversion projects. Do not modify these templates; they will be overwritten each time you update Mif2Go. Instead, if you want to customize a starting project configuration file for your particular operating environment, copy the appropriate file to %OMSYSHOME%\m2g\local\starts and edit it there.

To modify settings for an individual conversion project, edit the project configuration file located in the project directory.

When you start a conversion project from within FrameMaker, Mif2Go copies the correct starting project configuration file for you, if one is not already present in the project directory. See §3 Converting a book or document. This new file is copied from:

• local\starts if a configuration file with the correct name is present; any files here are starting project configuration files you have customized to suit your operating environment.

• system\starts if there is no file with the correct name in the local\starts directory.

The output type you want to produce determines which starting project configuration file the Mif2Go plug-in copies to the project directory. Table 30-5 lists the names of these files.

Table 30-5 Output types and starting project configuration files

Category | Output type | Project configuration file | Ref.
HTML-based Help | Eclipse Help | _m2eclipse.ini | 12
Microsoft HTML Help | _m2htmlhelp.ini | 9
JavaHelp | _m2javahelp.ini | 11
OmniHelp | _m2omnihelp.ini | 10
Oracle Help for Java | _m2oraclehelp.ini | 11
HTML | Standard HTML 4.0 | _m2html.ini | 13
XHTML 1.0 | _m2xhtml.ini | 13
XML | DITA XML | _m2dita.ini | 15
Docbook XML | _m2docbook.ini | 17
Generic XML | _m2xml.ini | 14
RTF | WinHelp | _m2winhelp.ini | 8
Print RTF | _m2rtf.ini | 6
Intermediate | ASCII DCL | _m2dcl.ini | 38
| FrameMaker MIF | _m2mif.ini | 38

Near the top of each starting project configuration file you will find a setting that links that file to an output-specific configuration file. For example, for Word output:

[Templates]

; Where the rest of the configuration settings are:

Configs = %omsyshome%\m2g\local\config\local_m2rtf_config.ini

Avoid disturbing this setting, or you might break the chain that leads to all the other configuration settings that apply to your conversion project. If you are using a source-specific configuration file, your starting project configuration file will also include a setting that links to that file; for example:

[Templates]

Document = g:\omnisys\ug\_config\m2gug_htm_document.ini

See §30.5.3 Editing a document-specific configuration file and §30.5.4 Editing an output-specific configuration file.