|Important||This document may not represent best practices for current development, links to downloads and other resources may no longer be valid. Current recommended version can be found here. ArchiveDisclaimer|
CHM-to-Namespace Map File
Specifies the namespace to which each HTML Help 1.x compiled Help (.chm) file should map when converted to Microsoft Help 2 compiled Help (.HxS) files. The primary purpose of the map file is to specify the relationships between links within a set of compiled Help files, ensuring that cross-collection links are translated properly.
The map file is a standard text file, which should be saved using the .txt file extension. The following example shows the format to use for a map file.
myHelp_1.chm myNamespace/myHelp_1 myHelp_2.chm ../myHelp_2
This example shows the two ways to map a .chm to a namespace. In the first line, the file myHelp_1.chm is mapped to an .HxS file named myHelp_1, which is registered under the namespace myNamespace. This direct mapping only works if myNamespace is always the parent. If myNamespace is registered as a child of another namespace, all mappings will be broken.
In the second line, the file myHelp_2.chm is mapped to an .HxS file named myHelp_2 using relative mapping. Relative mapping is more general, and always finds the sibling collection with the specified ID (in this example, myHelp_2) relative to the current .HxS file. Because of this, relative mapping is recommended in most cases.