17.2.4 Accommodating platform differences

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

[HelpOptions]
; 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]
Altura=No
HyperHelp=No
ForceBmc=No
HelpSectionBreaks=Yes

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 DITA2Go 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, DITA2Go has a setting for Bristol HyperHelp: HyperHelp=Yes. Unfortunately, HyperHelp has trouble with WMF graphics. You must use a graphics conversion program to convert all WMF graphics to BMP graphics. 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

Previous Topic:  17.2.3 Preparing a document for conversion to WinHelp

Next Topic:  17.2.5 Setting basic WinHelp options in the configuration file

Parent Topic:  17.2 Setting up a WinHelp project

Sibling Topics:

17.2.1 Setting up a WinHelp project

17.2.2 Deciding where to locate configuration settings

17.2.3 Preparing a document for conversion to WinHelp

17.2.5 Setting basic WinHelp options in the configuration file

17.2.6 Handling page breaks and section breaks

17.2.7 Providing multiple .hlp files

17.2.8 Integrating WinHelp from RoboHelp

17.2.9 Compiling a WinHelp project

17.2.10 Checking WinHelp RTF files for DITA2Go version