Adobe 65030089 User Manual - Page 63

USING ROBOHELP HTML 10 57 Projects 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. Define the topic name pattern for generated topics When you set heading styles for pagination, the heading text is included by default in the filename of the topic file created in RoboHelp. For example, suppose you define Heading 2 for pagination. If the Word document has two Heading 2 topics, "Introduction" and "Beyond basics," the topics are created as files named introduction.htm and beyond_basics.htm. The result is intuitively named HTML files that indicate the topic title. In addition to this default scheme, you can define more naming conventions. If, however, the Help system uses sequentially numbered files, such as helptopic001.html, helptopic002.html, and so on, you can define the pattern to support that convention. 1 Do one of the following: • Select File > Import > Word Document. Last updated 7/13/2012