Omni Systems, Inc. Mif2Go User's Guide, Version 55
> 9 Generating Microsoft HTML Help > 9.6 Creating links and hypertext jumps in HTML Help > 9.6.2 Specifying href link syntax for HTML Help
Links in HTML Help can be of two forms: generic
HTML href
links for jumps within a single CHM
file, or href
links with a special syntax that
includes the target.chm
name for jumps to locations
in other CHM files. If you are using framesets in HTML Help, target content
might be displayed differently for these two forms of links.
By default, Mif2Go uses both forms for HTML Help:
For links to non-CHM files, see §9.6.3 Linking to external files from compiled HTML Help.
If your configuration file lists other CHM files
in section [ChmFiles]
, jumps to those files
use the special syntax that includes the .chm
name. Unless you specify otherwise, jumps within the default CHM file
are of the generic form. (If you are using multiple CHM files, this file
is the DefaultChmFile
listed in section [MSHtmlHelpOptions]
;
see §9.15.1 Interlinking multiple CHM files.)
Force all links to use special syntax
To force all links
to use the special syntax that includes the .chm
name:
; UseChmInLinks = No (default, for same .chm or for uncompiled help,
; where normal links are needed)
; or Yes (always use ChmFormat at start of links)
Use generic form for single .chm, uncompiled Help
When UseChmInLinks=No
(the default), links to destinations within the default CHM file are
of the generic HTML href
form; use this setting
to produce either of the following:
href
links to other CHM files
Use special syntax for links to other CHM files
When UseChmInLinks=Yes
,
by default all links are of the form:
<a href="mk:@MSITStore:Helpfile.chm::/topicfile.htm#anchor">
<a href="mk:@MSITStore:ugmif2go.chm::/z12x1391027.htm#Rz12x18218">
Specify format for special syntax
To specify a format for the start of the link:
; ChmFormat = format to use when UseChmInLinks is set, where
; the first %s is the chm name and the second %s is the filename
ChmFormat=mk:@MSITStore:%s.chm::/%s
For example, if all users of your compiled HTML Help system will be running Internet Explorer 4.0 or a later version, you can direct Mif2Go to use the following form for all links instead of the default special syntax:
See HTML Help Workshop for more information.