Paragraph Styles

Basic

Name The name of the style or topic type.
HTML Name This applies only to HTML source documents from legacy projects. It defines the name to be used to identify the style as a cascading stylesheet style in legacy HTML source documents. Every style specified in a Doc-To-Help project has two names: its name and its HTML name that identifies it as a CSS style, or selector. When you use a style in an HTML document, make sure you use its HTML name. According to the standard CSS rules, the HTML name can have one of three forms:

<stylename> The style can be used with any HTML tag.
<tag> The specified tag (for example, H1 for style Heading 1) is considered by Doc-To-Help as having this style, even if the user did not format this tag with any particular CSS style.
<tag>.<stylename> The style can be used only with the specified tag; it is ignored if used in other tags.

Type Determines the authoring behavior associated with a paragraph style at compile time.

Body Text Topic body.
Heading Text Topic with no outline level.
Level 1 Topic at outline level 1.
Level 2 Topic at outline level 2.
Level 3 Topic at outline level 3.
Level 4 Topic at outline level 4.
Level 5 Topic at outline level 5.
Level 6 Topic at outline level 6.
Level 7 Topic at outline level 7.
Level 8 Topic at outline level 8.
Level 9 Topic at outline level 9.

Hidden If selected, any text formatted with this paragraph or character style is omitted from the target. If a topic heading is formatted with this style, the whole topic is omitted from the target.
Auto Glossary Links If selected, during compilation Doc-To-Help examines the project documents for text that matches glossary entries (in the glossary document) and converts these matches into hyperlinks. When the user clicks on one of the hyperlinks, a DHTML pop-up opens containing the corresponding glossary entry description.
Online Only If selected, paragraphs formatted with this style are omitted from the printed manual target only. This setting has no effect on online targets.
Preformatted This check box affects how text formatted with this style appears in HTML-based targets. It is especially useful for source code examples where you don’t want text wrap and white space adjustments. If selected, the text formatted with this style is enclosed in a <pre> tag in the resulting HTML. This ensures that there is no text wrap and white spaces are treated literally. This check box can only be selected for paragraph styles where Type=Body text.
Section Break This option applies to Manual targets only. It is used to set the type of section break at the beginning of each chapter of the master document. It can be used to set book chapters to begin on an odd page (a typical scenario). To do so, choose the paragraph style for the first style in each chapter (usually Heading 1) and set this property to Odd Page. In new projects this property is set to "Odd Page" for the Heading 1 style by default; in existing projects it is set to "None" by default.
Section Orientation This option lets you specify a portrait or landscape configuration for pages within a given section break in a Word document. See Setting Page Orientation.
Topic Type Specifies the named set of display, navigation, and indexing characteristics to be associated with this style (such as what window the Help topic appears in, how the Help topic is accessed, and whether it gets a map number). There are eight predefined topic types in the Styles dialog that may be edited, or you can create new ones.

Navigation

Auto Subtopic Links If selected, subtopic buttons and links will be displayed automatically for this paragraph style, if this heading style has topics below it in the hierarchy. For example, if a topic with a Heading 1 style has topics with the Heading 2 style following it (these are subtopics), then in the online output the Heading 1 topic will automatically have links to the Heading 2 topics at the bottom.
Auto Link When selected, creates a unique link tag for topics formatted with this paragraph style or topic type. Link tags created in this manner are identical to the topic title except that spaces, hyphens, and periods are converted into underscores.
Auto Navigate If selected, this paragraph style or topic types will be included in the navigation sequence.
Auto Next If selected, enables the next topic button for this paragraph style or topic type. A next topic button is displayed at the end of each associated topic that links it to the next topic.
Explicit Access If selected, defines this paragraph style or topic type as accessible only through a hyperlink. Paragraph styles and topic types defined as explicit are not accessible from the Help contents, the index list, or the text search.
Mid-topic If selected, defines this paragraph style or topic type as an "in topic" jump location similar to an HTML anchor. By defining a paragraph style or topic type as mid-topic and defining a character style as a jump, you can create jump functionality within a lengthy topic.

Display

Contents Only If this check box is selected for this paragraph style or topic type, the topics formatted with this paragraph style or topic type are omitted from the Help target, but are used as book titles in the Help contents.
Popup If this check box is selected for this paragraph style or topic type, any topic formatted with this paragraph style or topic type will appear in a pop-up window on top of the Help window.
Use Comments Comments are displayed in the text when this check box is selected.
Suppress Empty Topics If selected, omits empty topics (those with a title and no text) defined with this paragraph style or topic type from online output. These topics will still be included in the TOC. This check box can be selected for a Contents topic type that is commonly used for the top-level style, such as Heading 1. If this style usually contains no text, it may be preferable that these empty topics are not shown in the Help window when the user selects the corresponding book title in the TOC.
Untitled If selected, the topic title is not displayed in the Help window.
Replacement In certain cases, returns a string that overrides the generated default text. For paragraph styles and topic types with the "Auto next" check box selected, this string is used instead of the topic title next to the generated button. For character styles with the "Include page number in reference" check box selected, this string specifies the format of page number references in printed manual targets. This string is ignored unless it contains a pound sign, which is replaced with a PAGEREF field.
Window The name of the window in which topics formatted in this style are displayed.

Behavior

Auto Context ID If selected, Context IDs are automatically created for all topics using this paragraph style or topic type.
Auto Keyword If selected, index keywords will automatically be created from topic titles formatted with this paragraph style or topic type. The keywords will be associated with the appropriate topic.
Script Displays the script to be run during compilation whenever text formatted with this style is encountered.