Every title should have a contents topic to act as a starting point. The contents topic is the first topic displayed for the title. Users can return to the contents topic at any time by choosing the Contents button in Viewer. The sample application uses the “usa_main” topic in the STATES_W.RTF file as the contents topic. This topic shows a map of the United States, with buttons that jump to each state described in the title, as shown in the following illustration:
See “Coding Multiple Hot Spots in Bitmaps,” in Chapter 7, “Advanced Bitmap Techniques,” for a description of how to include bitmaps that contain hot spots in your title.
Use the CONTENTS option in the [OPTIONS] section of the project file to define the contents topic. The [OPTIONS] section must be the first section of the project file.
The CONTENTS option uses the following syntax:
CONTENTS = context string
The context string identifies the topic you've chosen as the contents topic. If
you look in the sample project file, the following topic is the contents topic in
the [OPTIONS] section:
[OPTIONS]
CONTENTS=usa_mainIf you don't include a CONTENTS option in the [OPTIONS] section, the compiler uses the first topic it encounters in the first listed topic file as the contents topic.