9.12.4 Creating an alias file for CSH links

When you use markers for CSH destinations, by default Mif2Go generates an alias file for you, named after your document, with extension .hha; for example, MyDoc.hha. Mif2Go also creates an entry for the alias file in the HTML Help project file; for example:

[ALIAS]

#include "MyDoc.hha"

The alias file must be located in or below the directory that contains your .hhp file. The alias file contains an entry for each symbolic ID in your document that:

• occurs in a newlink marker, and

• begins with one of the prefixes you specify in the configuration file.

Alias prefixes

To specify prefixes for symbolic IDs:

[MSHtmlHelpOptions]

; AliasPrefix = all prefixes wanted in alias file, comma or space

; delimited; if omitted, all newlinks are included

; NOTE: wildcards do not work in prefixes

AliasPrefix=HIDC_, IDH_

With this setting, the alias file would include the content of every newlink marker in your document that contains a name prefixed with HIDC_ or IDH_. See §9.12.5 Understanding alias-file entries for examples.

No alias file

To prevent Mif2Go from creating an alias file:

[MSHtmlHelpOptions]

; MakeAliasFile = Yes (default, make list of newlinks and files) or No

MakeAliasFile=No

When MakeAliasFile=No, Mif2Go does not generate an alias file. In that case, if you are using markers for CSH destinations, you must create the alias file manually, and manually insert the corresponding entry in the HTML Help project file.

When MakeAliasFile=Yes, but your document contains no newlink markers that qualify, Mif2Go does not generate an alias file.

---

> 9 Generating Microsoft HTML Help > 9.12 Setting up CSH for HTML Help > 9.12.4 Creating an alias file for CSH links