18.3.7 Specifying a starting topic file for HTML Help

By default, DITA2Go puts the name of your DITA document in the .hhp as the name of the first page. If the first page really should be the first split file (see §27. Splitting and extracting files), you must edit the .hhp (either in Notepad or in HTML Help Workshop) to insert the actual name of the first-page file (which might be something like aa123456.htm):

[OPTIONS]
Default topic=realfilename.htm

Also specify the starting topic in configuration file d2htmlhelp.ini:

[MSHtmlHelpOptions]
; DefaultTopicFile = starting topic file name (no extension)
DefaultTopicFile=realfilename

Then if your .hhp is rewritten, it will have the correct value.

After compiling your project, if you open the .chm in HTML Help and the first page produces an error such as “This page cannot be displayed”, you might have to edit the .hhp to specify the correct name for the first-page file.

Previous Topic:  18.3.6 Naming project and compiled files for HTML Help

Next Topic:  18.3.8 Regenerating the HTML Help project file

Parent Topic:  18.3 Setting up an HTML Help project

Sibling Topics:

18.3.1 Creating an HTML Help project

18.3.2 Deciding where to locate configuration settings

18.3.3 Organizing source files for HTML Help

18.3.4 Specifying a project title for HTML Help

18.3.5 Deciding whether to compile HTML Help

18.3.6 Naming project and compiled files for HTML Help

18.3.8 Regenerating the HTML Help project file

18.3.9 Locating graphics files for HTML Help