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