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

> 9 Generating Microsoft HTML Help > 9.15 Mapping and merging CHM files > 9.15.1 Interlinking multiple CHM files > 9.15.1.2 Mapping FrameMaker files to CHM files

#### 9.15.1.2 Mapping FrameMaker files to CHM files

For CHM files other than the default file (see §9.15.1.1 Specifying the default CHM file), specify how FrameMaker files should be mapped to the other CHM files:

[ChmFiles]

; Original or remapped filename (no ext) = chm filename (no ext)

; overrides default set by [MSHtmlHelpOptions]DefaultChmFile

D:/MyBook/Chapter1 = MyProj

These mappings takes precedence over any default mapping of the same FrameMaker files to the default CHM file.

No file extensions

Do not include file extensions in mappings.

Specify paths to FrameMaker files

It is best to include a path to each FrameMaker file, because you could have several files with the same name in different books or projects from which you generate different CHM files. Without file paths, you would have no way to differentiate these files. Although you can use either forward slashes or backslashes in paths to FrameMaker files, forward slashes are preferred. FrameMaker stores cross-reference paths with forward slashes, and Mif2Go uses those cross-reference paths to find the referenced files. See §9.15.1.3 Requiring Mif2Go to use paths for mapped FrameMaker files.

Multiple paths to a single FrameMaker file

To handle several possible paths to the same FrameMaker file, add a line for each path. For example:

[ChmFiles]

MyDoc1 = CHMa

MyDoc2 = CHMb

.../GroupB/MyDoc2 = CHMb

G:/test/GroupB/MyDoc2 = CHMb

Avoid paths to CHM files

It is best not to specify paths for CHM files mapped in [ChmFiles], because Microsoft does not allow relative paths to CHM files. Although you can specify an absolute path, absolute paths are not a good idea. You cannot predict where the file will be placed on every system. When no path is specified, HTML Help uses the Windows Registry entry to find the CHM file, provided one of the following is true:

• the CHM file has been used at least once

• the installer created the correct Registry entry for the CHM file.

Multiple FrameMaker books

To link CHM files generated from multiple FrameMaker books in different Mif2Go projects, consider using a configuration template; see §4.1 Working with Mif2Go configuration files. Specify [ChmFiles] mappings for all books in the template. If a given FrameMaker file appears in more than one book, the project configuration file for each such book must include a [ChmFiles] mapping for that file. The project-specific mapping takes precedence over the mapping in the configuration template.

> 9 Generating Microsoft HTML Help > 9.15 Mapping and merging CHM files > 9.15.1 Interlinking multiple CHM files > 9.15.1.2 Mapping FrameMaker files to CHM files

| Mif2Go User's Guide: 9.15.1.1 Specifying the default CHM file |  | Mif2Go User's Guide: 9.15.1.3 Requiring Mif2Go to use paths for mapped FrameMaker files |