CHM-to-Namespace Map File
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.

See Also



© 2016 Microsoft