Types of HTML templates

<< Click to Display Table of Contents >>

Navigation:  More Advanced Procedures > HTML Output and HTML Templates >

Types of HTML templates

There are two categories of HTML templates: The HTML topic page templates that define your topic pages in all HTML-based output formats and an additional group of HTML templates used to define the additional components of WebHelp output, which are also used for EWriter eBooks.

If you are using an HTML skin you must edit your templates and settings in the skin!

Nowadays you will almost always choose an HTML skin to publish your project to WebHelp or HTML Help/CHM. A skin is a special kind of Help+Manual project without topics that only stores your HTML templates and all the settings relevant for HTML output to these two formats. When you choose a skin, the templates and settings in the skin completely replace those in your project.

Normally, a skin is pre-designed and you don't need to change anything. However, if you do want to change something, you must do all your editing in the .hmskin skin file. Editing in your Help+Manual project won't have any effect because those templates and settings are not used.

To edit a skin, make a copy of the .hmskin skin file in your project folder and then open it in Help+Manual by selecting .hmskin as the file type to open in the Open dialog. All the templates and settings are in the same places as in a normal Help+Manual project.

Exception: HTML Export Options

The HTML Export Options section is not stored in skins and needs to be edited in your project.

HTML topic page templates:

These are the templates for your topics and they are used for all HTML-based output formats. They define everything in your topic pages except the topic content. They are stored in Configuration > HTML Page Templates.

Additional templates for WebHelp:

In addition to this there are also separate templates for the main index.html page and the Table of Contents, Keyword Index and Full-text Search pages used in WebHelp to emulate the HTML Help viewer user interface. These templates are stored in Configuration > Publishing Options > WebHelp.

Special script and CSS components information for experts:

If you are experienced in HTML, CSS and JavaScript coding please refer to Script and CSS components for experts. This topic contains important information on how the references to important script and other components in the templates are managed and how you can manipulate them.

 

Click to expand/collapseWhich HTML templates are used where and when...