Adobe 65030089 - Robohelp - PC Using Manual page 124

USING ROBOHELP HTML 10
Working with topics
A master page is a template for HTML topics. You define the placement of headers, footers, and placeholders for the
body, breadcrumbs, and topic TOC. Master pages can include snippets and user-defined variables. You can create a
topic using a master page or associate an existing topic with a master page. When you create a topic using a master
page, the body content is placed in the resulting topic. If you apply a master page to an existing topic, the body content
is ignored.
The layout information defined in the master pages is not visible in Design view. However, you do see the CSS of the
master page in Design view. You can see the layout when you generate output or a preview. The topic content is placed
in the body placeholder, and the layout is inherited from the master page. All placeholders defined in the master page
are also populated with relevant information when you generate output.
You can use tables to create a precise layout where each placeholder is placed in a table cell.
When you create a topic from a master page, the topic includes content from the master page.
Body placeholder
Copyright information is an example. When you apply a master page to a topic, actual content of the topic replaces the
body placeholder at the time of preview and generation.
Note: When you apply a master page to a topic, the header and footer of the topic are overridden by those of master pages.
Shows the automatically generated topic TOC at the time of generation or preview of Help
Topic TOC placeholder
topic. Define the exact location and format of the topic TOC by designing the layout of the master page. By default,
the levels allowed for a TOC layout are heading 2 to heading 6.
Shows the automatically generated breadcrumbs at the time of generation of Help topic.
Breadcrumbs placeholder
The breadcrumbs are generated based on the TOC. When you preview a topic, actual breadcrumbs links are not
generated and only the layout of breadcrumbs is visible.
You can apply conditional build tags to the topic TOC and breadcrumbs placeholders but not to the body placeholder.
However, you can apply a conditional build tag to the content inside or outside the body placeholder.
Create a master page
1 Do one of the following:
• Select File > New > Master Page.
• Select and right-click Master Pages in the Project Set-up pod.
Select New Master Page.
2
3 Enter a name for the new master page in the General tab.
Note: Master pages have the filename extension .htt.
4 Click the Appearance tab.
Select a style sheet to apply to the master page.
5
6 (Optional) Select the Background Sound options.
7 Click OK.
A new master page shows the body placeholder by default. You can insert topic TOCs by clicking the Topic TOC icon
and breadcrumb placeholders by clicking the Breadcrumbs icon
pages. But this toolbar does not appear for normal pages. You can insert any number of topic TOCs or breadcrumbs
at any location in the master page.
Create a master page from a topic
Open a topic.
1
from the toolbar in the Design editor of master
Last updated 7/13/2012
118