12.4.4.2 Specifying a starting topic

To specify which topic file to display when Eclipse Help opens:

[EclipseHelpOptions]

; TocTopic = name of opening topic file (required)

TocTopic = startingtopic.htm

The default starting topic is the first HTML file listed in the generated contents. That is, if you do not include any setting for TocTopic, Mif2Go generates an entry of the following form in toc.xml:

<toc label="Title of your Help system" topic="firsttopiclisted.htm">

When an explicit file is named as a topic attribute, Eclipse does not generate a default help page. To allow Eclipse (at least later versions) to generate a default help page, you can avoid specifying an opening topic by giving TocTopic an empty value:

[EclipseHelpOptions]

TocTopic =

When you specify an empty value, Mif2Go omits the topic attribute and generates an entry of the following form in toc.xml:

<toc label="Title of your Help system">

In this case, Eclipse generates a default opening page with the following content:

Title of your Help system

Contents

Link to the first top-level topic

Link to the second top-level topic

. . .

Link to the last top-level topic

---

> 12 Generating Eclipse Help > 12.4 Configuring contents and index for Eclipse Help > 12.4.4 Configuring contents properties for Eclipse Help > 12.4.4.2 Specifying a starting topic