17.2.7 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.6 Setting basic WinHelp options in the configuration file

Next Topic:  17.2.8 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 Deciding whether to regenerate the WinHelp project file

17.2.5 Accommodating platform differences

17.2.6 Setting basic WinHelp options in the configuration file

17.2.8 Providing multiple .hlp files

17.2.9 Integrating WinHelp from RoboHelp

17.2.10 Compiling a WinHelp project

17.2.11 Checking WinHelp RTF files for DITA2Go version

Table of ContentsIndex