Omni Systems, Inc. Mif2Go User's Guide, Version 55
> 9 Generating Microsoft HTML Help > 9.12 Setting up CSH for HTML Help > 9.12.2 Determining whether you need map and alias files
Whether you need map and alias files depends on the following:
Table 9
Table 9
If you use markers for CSH destinations, you need both a map file and an alias file:
When you use markers, developers should use the HH_HELP_CONTEXT
API, and specify topics by numeric ID. You need the map and alias files
to associate their numeric IDs with your symbolic IDs. Each time you
convert your FrameMaker document to HTML Help, Mif2Go uses the symbolic IDs to generate an alias file;
see §9.12.4 Creating an alias file for CSH links.
Usually the developers provide the map file.
When developers use the HH_HELP_CONTEXT
API, the application must send a numeric ID, and you must have the map
file in your project to interpret the numeric ID. The developers need
only the map file. You need only to add to your HTML Help project file
the name of the map file and the name of the alias file, before compiling.
You can do this via configuration setting; see §9.12.3 Specifying and generating a map file for CSH links.
If you use special paragraphs for CSH destinations,
developers should use the HH_DISPLAY_TOPIC
API, and specify topics by file name. You do not need an alias file or
a map file. Calls from the application program reference the file names
you put in the special paragraphs directly, via the compiled help file;
check HTML Help Workshop for the correct syntax.