7.1.5 Accommodating platform differences

You must specify a few [HelpOptions] settings according to the platform on which your WinHelp file will be used:

[HelpOptions]

; HelpVersion = 3 for Win 3.1 compatible or 4 for Windows 9x/NT

HelpVersion=4

; Altura = No (default) or Yes (Altura QuickHelp for Mac)

Altura=No

; HyperHelp = No (default) or Yes (Bristol HyperHelp for UNIX)

HyperHelp=No

; ForceBmc = No (default) or Yes (use bmc, not bml, for HyperHelp)

ForceBmc=No

; HelpSectionBreaks = Yes (default) for sect break before each topic,

; or No for Altura (filter strips table format from topic titles)

HelpSectionBreaks=Yes

Windows 9x/ME/NT/2000

The default settings work for all 32-bit Windows platforms:

[HelpOptions]

HelpVersion=4

Altura=No

HyperHelp=No

ForceBmc=No

HelpSectionBreaks=Yes

Windows 3.x

If you intend to support Windows 3.1 or Word for Windows 3.11 without Win32s, set HelpVersion=3 to reset defaults so the topic file will work with the old HC help compiler. WinHelp 3 does not support ALink or KLink references, nor hypertext links to external documents. If your FrameMaker document includes markers for these features, you will have to do one or both of the following:

• use conditional text to hide these markers in your FrameMaker document (see §2.4 Importing formats from a conversion template)

• redefine marker types in your Mif2Go configuration file, to exclude from conversion any markers that produce !AL, !KLink, or !EF WinHelp macros in RTF output.

Macintosh

If you are targeting the Macintosh platform, and you are using Altura QuickHelp, set Altura=Yes. This setting does not work for regular Windows versions, so expect to run Mif2Go twice to produce both forms. However, you might find that Altura QuickHelp does work when you set HelpSectionBreaks=No and Altura=No, in which case you can get by with one version instead of two.

UNIX

For UNIX users, Mif2Go has a setting for Bristol HyperHelp: HyperHelp=Yes. Unfortunately, HyperHelp has trouble with WMF graphics. You must use a graphics conversion program (see §4.10.2.3 Using third-party graphics converters) to convert all WMF graphics to BMP graphics. If you choose to do this, Mif2Go can change the file names for the graphics in the .rtf accordingly:

[Graphics]

NameWMFsAsBMPs=Yes

Also set [HelpOptions] ForceBmc=Yes, to change all bml references to bmc.

If you are using HyperHelp you might need to prevent multiple interword spacing when there are index markers in text. If you see extra space at index markers, try EndFtnWithSpace=No:

[HelpOptions]

; EndFtnWithSpace = Yes (Help default) or No (HyperHelp default)

EndFtnWithSpace=Yes

; FootnoteSpace = After (the } after the symbol, default),

; Before, or None

FootnoteSpace=After

---

> 7 Generating WinHelp > 7.1 Setting up a WinHelp project > 7.1.5 Accommodating platform differences