#### 18.9.3 Generating contents and index with HTML Help Workshop

Contents

If you specify RefFileType=HHW, HTML Help Workshop constructs the Contents panel, and uses your <H n> tags as the source of the line items. This has two consequences:

- For HTML Help Workshop to accept them, DITA2Go must treat differently the <H n> tags in the body file from which the .hhc file is created, by omitting all attributes, including CSS style; therefore you lose control over much of their appearance in the body file.
- The sequence in which HTML Help Workshop uses the <H n> tags is determined by the sequence of the files listed in the .hhp file; if a file is out of order in the list, its contents appear out of order in the .hhc file. When many of your files are created by splitting, keeping the .hhp list up to date becomes a maintenance nightmare.

Index

When HTML Help Workshop creates the index, DITA2Go embeds DITA index entries (minus the parts that HTML Help does not understand) as K-type index entries in the .htm files. This has two consequences:

- Selecting an index item does not take you to the place in the file where that item is used; instead, it puts you at the start of the HTML file, even if the item sought is at the end.
- You have no way to control sort order.

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

Next Topic: 18.9.4 Generating contents and index with DITA2Go

Parent Topic: 18.9 Generating contents and index for HTML Help

Sibling Topics:

18.9.1 Choosing how to generate HTML Help contents and index

18.9.2 Choosing whether to generate binary contents or index

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