When Help Producer converts your Word document to HTML, Help producer uses the styles in your Word document to obtain information about the table of contents, where to split the document into topic pages, what HTML elements to use, etc. This process is called style mapping.

For each style that you use in your Word document, you can create a style mapping entry that tells Help Producer how to handle the style. For instance, you can instruct Help Producer to create a new topic page or apply a formatting property to the HTML code when a certain paragraph style is found.

Help Producer allows you to map paragraph styles, character styles, and table styles.

Paragraph Style Mapping

Paragraph styles can be mapped to the following elements:

• Topic: The paragraph indicates the start of a new topic page. No HTML code is actually generated. The paragraph text determines the topic title and the filename of the topic page.
• HTML Elements: The paragraph will be mapped to a HTML element. The list of supported elements includes Paragraphs <P>, Headings <H1> to <H6>, Numbered Lists <OL>, Bulleted Lists <UL>, Definition Lists <DL>, Block‑Quotes <BQ>, and Preformatted <PRE> elements. You can specify a class name and other attributes that will be applied to the HTML element.
• Popup: The paragraph is mapped to a text popup. No HTML code is generated. The paragraph text determines the popup text. This is a feature found in Microsoft HTML Help 1.x only.
• Hidden: The paragraph will be excluded from the topic page.

Depending on the element you select, you can further specify the level in the table of contents, the list level, and the tab width. The table of contents level (TOC level) determines the level at which the paragraph is referenced in the table of contents. The list level determines whether the paragraph is embedded within a preceding list, and at what level. A list level of zero indicates that the paragraph is not part of a list. The tab width determines the number of spaces needed to replace a tab with equivalent width. A tab width of zero indicates that tabs should not be converted to spaces.

Character Style Mapping

Character styles can be mapped to the following elements:

• HTML Elements: The character range will be mapped to a HTML element. The list of supported elements includes Spans <SPAN>, Bold <B>, Italic <I>, Bold/Italic combined <B><I>, Strong <STRONG>, Strikethrough <STRIKE>, Subscript <SUB>, Superscript <SUP>, and Code <CODE>. You can specify a class name and other attributes that will be applied to the HTML element.
• LINK - Link Text: The character range indicates the link text of a topic link.
• LINKID - Associative Link: The character range indicates the link target of a topic link. The link target must follow a character range formatted with a style mapped to a 'LINKID - Link ID' style.
• RAW - HTML (raw): The character range is emitted as raw HTML text, i.e. special characters, such as the ampersand sign '&', are not escaped.
• HTML - HTML (parsed): The character range is emitted as HTML text. The HTML is fully parsed, and must be well-formed HTML.
• X - Hidden: The character range is excluded from the topic page.

Table Style Mapping

Table styles cannot be mapped to other HTML elements. Instead, the table style can be mapped to a class name that calls out a specific style from the theme’s CSS.

See Also

Styles and Mappings | Understanding Styles | Working with Styles