Omni Systems, Inc. Mif2Go User's Guide, Version 55
> 8 Generating WinHelp > 8.13 Configuring contents for WinHelp > 8.13.1 Naming and configuring Help files and titles
Mif2Go creates a WinHelp contents file for you, unless you specify no contents. Whether the contents file is created from a single topic file or from multiple files, and how the contents file and Help file are named, depend on the following settings:
; the optional .cnt file for HelpVer 4 is always named after the rtf
; CntType = None, Full (single file), or Body (headings, topics only)
; the Body type is used when combining .cnt files in a .bat file
; CntBase = helpfile.hlp (default is rtfname.hlp; specify for Body)
; CntName = helpfile.cnt (default is rtfname.cnt; specify for Body)
; CntStartFile = helpfile.bct (default is to use CntBase and CntTitle)
; CntTitle = Title for Contents (for Full .cnt)
; CntTopic = starting topic for .hpj (default: book or chapter name)
; CntTopHead = 1 Text for Optional Top Head (Full .cnt, for a H1)
If you have only one topic file in your Help
project, in the [HelpContents]
section leave
the default value, CntType=Full
; Mif2Go creates the .cnt
file
for you.
If you have more than one topic file in your
Help project, set CntType=Body
; Mif2Go creates part of the .cnt
file for each topic file, and also produces a file named after your topic
file, with extension .bct
, which contains only
the header and topic lines. If you specify CntType=Body
,
you can also specify the name of the contents file and the base name
of the help file. If you do not specify a base name, Mif2Go uses your topic file name for the help file
base name.
Alternatively, for multiple topic files you can
set the first topic file to CntType=Full
, so
it contains the Base, Title, and Top Head (if any). Or you can just prepare
the first bit of the final .cnt
separately,
in a text editor.
Use CntTitle
to specify
the text of the title for the contents file; to specify a starting topic,
set CntTopic
. If you do not specify a value
for CntTitle
, Mif2Go uses the help file title (in the .hpj
file). The value you specify (if any) for CntTopHead
is added before the actual .cnt
entry lines.
You can also create a .cnt
heading for a topic file even though that heading is not in the topic
file itself:
myfile=Text for optional top head