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 <Hn> tags
as the source of the line items. This has two consequences:
- For
HTML Help Workshop to accept them, DITA2Go must treat differently
the <Hn> 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 <Hn> 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
Table of Contents • Index