21.4.3.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, DITA2Go 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, DITA2Go 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

Previous Topic:  21.4.3.1 Providing a title for the TOC

Next Topic:  21.4.3.3 Enabling mid-topic links from the TOC

Parent Topic:  21.4.3 Configuring contents properties for Eclipse Help

Sibling Topics:

21.4.3.1 Providing a title for the TOC

21.4.3.3 Enabling mid-topic links from the TOC

21.4.3.4 Directing TOC links to top of topic page