= HTML Help: Custom TOC =

This page details an customization that allows an end user
to define a custom *.hhc file to be used in a given HTML Help
project.

== Files ==

[[attachment:html_htlp.custom_toc.zip]]

== Details ==

The attached zip file includes a sample project along with the
override files which are necessary to implement the custom TOC
feature.  Also included in the zip is a custom TOC file (foo.hhc),
and a sample book.

To test the project:

 * Copy {{{foo.hhc}}} into the '''User Files''' area.
 * In '''Format > Settings''', scroll to the TOC section at the bottom
 of the dialog window.
 * For the Setting labeled toc-custom-file, click in the value column,
 and then click the button on the right side of the cell.  This action
 will present a window with all of the files in the User Files area. 
 * Select {{{foo.hhc}}}.
 * Save changes to the project and generate output.

The TOC should have some customized text, consistent with the entries
in foo.hhc.

== Files ==

To use this customization in your own project or stationery, add the XSL and FTI
overrides defined in {{{{project-folder}\Formats\Microsoft HTML Help 1.x\Transforms}}}.