#### 17.12.1 Naming and configuring Help files and titles

DITA2Go 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:

[HelpContents]
; 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
CntType=Full
; CntBase = helpfile.hlp (default is rtfname.hlp; specify for Body)
CntBase=myfile.hlp
; CntName = helpfile.cnt (default is rtfname.cnt; specify for Body)
CntName=myfile.cnt
; CntStartFile = helpfile.bct (default is to use CntBase and CntTitle)
CntStartFile=myfile.bct
; CntTitle = Title for Contents (for Full .cnt)
;CntTitle=Project Name
; CntTopic = starting topic for .hpj (default: book or chapter name)
;CntTopic=myfile
; CntTopHead = 1 Text for Optional Top Head (Full .cnt, for a H1)
;CntTopHead=1 Book Title

If you have only one topic file in your Help project, in the [HelpContents] section leave the default value, CntType=Full; DITA2Go creates the .cnt file for you.

If you have more than one topic file in your Help project, set CntType=Body; DITA2Go 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, DITA2Go 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, DITA2Go 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:

[HelpContents]
CntType=Body

[BctFileHeads]
myfile=Text for optional top head

Previous Topic: 17.12 Configuring contents for WinHelp

Next Topic: 17.12.2 Specifying heading formats and levels for contents

Parent Topic: 17.12 Configuring contents for WinHelp

Sibling Topics:

17.12.2 Specifying heading formats and levels for contents

17.12.3 Assembling WinHelp contents from the command line

Table of Contents • Index