Adobe 65030089 User Manual - Page 124

USING ROBOHELP HTML 10 118 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. Body placeholder When you create a topic from a master page, the topic includes content from the master page. 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. Topic TOC placeholder Shows the automatically generated topic TOC at the time of generation or preview of Help 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. Breadcrumbs placeholder Shows the automatically generated breadcrumbs at the time of generation of Help topic. 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. 2 Select New Master Page. 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. 5 Select a style sheet to apply to the master page. 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 from the toolbar in the Design editor of master 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 1 Open a topic. Last updated 7/13/2012