17.2.6 Handling page breaks and section breaks

WinHelp uses page and section breaks for a radically different purpose from print RTF. Page breaks are reinterpreted to mean “start of topic”, and a definite sequence of codes must follow the topic start in the prescribed order. DITA2Go creates this sequence automatically when you specify [HelpStyles]ParaFmt=Topic (see §17.7.2 Assigning properties to formats for topics and hotspots).

Section breaks are used as an undocumented modifier to page breaks; they permit the help compiler to avoid going into convulsions if the first thing after a page break is a table. Unless you are converting to WinHelp on an Altura system, use the default setting for section breaks:

[HelpOptions]
; HelpSectionBreaks = Yes (default) for sect break before each topic,
;  or No for Altura (filter strips table format from topic titles)
HelpSectionBreaks=Yes

The following options have no use in WinHelp; set them as indicated (the WinHelp defaults):

[HelpOptions]
PageBreaks=Remove
KeepSectBreaks=No

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

Next Topic:  17.2.7 Providing multiple .hlp files

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.4 Accommodating platform differences

17.2.5 Setting basic WinHelp options in the configuration file

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