##### 20.3.7.2 Specifying a default starting topic for the helpset

To specify the helpset starting topic:

    [JavaHelpOptions] or [OracleHelpOptions]
    ; DefaultTopic = starting topic ID (not file name)
    ;DefaultTopic =

This setting specifies an identifier for the first topic to display. This is a JavaHelp-specific target name rather than a file name. Typically it is the internally generated object ID of the first heading in the file; for example, Xaa123456. The default-topic identifier appears in a helpset file entry such as the following:

    <homeID>Xaa123456</homeID>

The helpset entry identifies the map-file URL that points to the topic file; for example:

    <mapID target="Xaa123456" url="html/dita2go.htm" />

If you do not specify a value for DefaultTopic, DITA2Go tries to autodetect the target name; however, this works only if DITA2Go is rewriting the helpset file after the first time you ran the conversion. DITA2Go uses the first topic ID in the first file in the book. If all else fails, DITA2Go uses the base name of the .bookmap or .ditamap file.

Previous Topic: 20.3.7.1 Specifying helpset file name and title

Next Topic: 20.3.7.3 Deciding whether to rewrite the helpset file

Parent Topic: 20.3.7 Configuring the helpset file

Sibling Topics:

20.3.7.1 Specifying helpset file name and title

20.3.7.3 Deciding whether to rewrite the helpset file

20.3.7.4 Providing a “favorites” option for JavaHelp 2

20.3.7.5 Adding custom helpset sections for JavaHelp 2

20.3.7.6 Requiring full paths in the helpset file