18.9.1 Choosing how to generate HTML Help contents and index

To specify whether contents, index, or both should be generated for HTML Help:

[MSHtmlHelpOptions]
; ListType = Both (default), Contents, or Index

After you set up your HTML Help project, you can choose whether contents and index will be generated by DITA2Go or by HTML Help Workshop, or by neither. This choice is governed by the following setting:

[MSHtmlHelpOptions]
; RefFileType = HHW (for HH Workshop), Full, 
; or None (do not generate).
RefFileType = Full

When RefFileType=Full, DITA2Go generates contents and index for HTML Help.

When RefFileType=HHW, DITA2Go removes attributes (including class) from <Hn> tags, and leaves the task of generating contents and index to HTML Help Workshop. You can edit the configuration file to change the value of RefFileType.

If you remove all settings for RefFileType from the HTML Help configuration chain, the default becomes RefFileType=HHW; therefore, if you specified that you want contents or index generated, they will be generated by HTML Help Workshop.

See also:

§16.3.1 Modifying contents or index production for HTML-based Help

§18.9.3 Generating contents and index with HTML Help Workshop.

Previous Topic:  18.9 Generating contents and index for HTML Help

Next Topic:  18.9.2 Choosing whether to generate binary contents or index

Parent Topic:  18.9 Generating contents and index for HTML Help

Sibling Topics:

18.9.2 Choosing whether to generate binary contents or index

18.9.3 Generating contents and index with HTML Help Workshop

18.9.4 Generating contents and index with DITA2Go

18.9.5 Configuring contents entries for HTML Help

18.9.6 Providing mid-topic contents links in HTML Help

18.9.7 Making the TOC track index links in HTML Help

18.9.8 Customizing contents and index for HTML Help