Adobe 65030089 User Guide - Page 65

USING ROBOHELP HTML 9 59 Projects Set pagination for online Help topics When you import a Word document, you define how the contents of the Word file appear as topics in RoboHelp. For example, suppose your Word file contains ten topics. If each topic contains subtopics, definition lists, tasks, and tables, you can have each topic appear as a separate HTML file. If each of these topic headings is in Heading 1 style, you can have each Heading 1 topic created as a separate HTML topic. If, however, you set the pagination at Heading 2, separate HTML files are created for each Heading 2 topic. You can select multiple paragraph styles for pagination. For example, selecting Heading 1 and Heading 2 for pagination, causes RoboHelp to start a new topic at every instance of Heading 1 as well as Heading 2. Note: Pagination is based on the Word paragraph styles and not on RoboHelp styles. Even though you can set pagination for any Word paragraph style, the topic generated must contain relevant, complete information for the reader. For example, if you set pagination for Heading 3, you run the risk of creating topics with only task-level instructions. In this case, the required contextual information required to complete the task is isolated in another Heading 3 level topic. To avoid such disjointed, incomplete topics, set the pagination at a higher level. 1 Do one of the following: • Select File > Import > Word Document. • Select File > Link > Word Document. • Select File > Project Settings. 2 Click Edit under Word Document. 3 In the Conversion Settings dialog box, in the Paragraph group, select the paragraph style on which to base pagination. 4 Select the option marked Pagination (Split into topics based on this style) and click OK. RoboHelp splits the documents into topics using the specified pagination styles. Convert context-sensitive Help markers in Word to map IDs You can convert the context-sensitive Help markers that you insert in your Microsoft Word documents and reuse them as map IDs. You insert the context-sensitive markers using the Custom Footnote option in Word. You insert context-sensitive Help markers using the Insert Footnotes And Endnotes dialog box in Word. To insert contextsensitive Help markers, enter a custom string such as TopicAlias and then insert the map ID as the marker text. The custom string must not contain spaces or any other invalid characters. See Microsoft Word Help for more information about inserting custom footnote markers. Sometimes Word documents that you are linking to or importing have context-sensitive Help markers. If so, you can incorporate them in the map ID header file that you generate. In the project header file, add the map IDs that you assigned to topics in your Word documents. The context-sensitive marker string is a project-wide parameter. Ensure that all Word documents that you link to or import contain the same string as the context-sensitive marker text. 1 Do one of the following: • Select File > Import > Word Document. • Select File > Link > Word Document. • Select File > Project Settings. 2 Click Edit under Word Document. 3 In the Conversion Settings dialog box, in the Other Settings group, enter the context-sensitive Help marker string and click OK. Last updated 12/14/2011