Adobe 65030089 User Manual - Page 82

USING ROBOHELP HTML 10 76 Projects Follow these guidelines for paginating a document: Completeness of content in the topic Ensure that the topic generated contains relevant and complete information for the reader. For example, if you set pagination for Heading 3 level paragraph, it is possible that the topic contains only the task information, without the required contextual information that is covered in another Heading 3 level topic. To avoid such disconnected topics, set the pagination at a higher level so that complete information is available in a single Help topic. Drop-down text Ensure that the paragraph format for the drop-down text body is not set for pagination. The paragraphs applied with this format must accompany the drop-down text caption paragraph format. See "Optimizing for online output before conversion" on page 63. Topic name basics When you set heading styles for pagination, the heading text becomes the default filename for the topic file created in RoboHelp. For example, suppose you define Heading 2 for pagination, and the FrameMaker document has two Heading 2 topics, "Introduction" and "Beyond basics." In this case, RoboHelp creates the topics Introduction and Beyound basics with filenames introduction.htm and beyond_basics.htm. Thus, you get intuitively named HTML files that indicate the topic title. RoboHelp supports various ways to customize topic names in the following scenarios: Style-based pagination Topics are named according to the pattern you select in the Other Settings tab of the Conversion Settings dialog box. You can select one of the following or create a topic name pattern using the Topic Name Pattern building blocks provided by RoboHelp. In addition, you can add static text, such as "HelpTopic," followed by to create topics such as HelpTopic 1, HelpTopic 2, and so on. Topic name pattern default - - Description HTML topic generated has the paragraph text as the topic title and the filename. HTML topic generated has the filename consisting of the filename of the FrameMaker document without the .fm extension and the paragraph text, separated by a hyphen. For example, the FrameMaker document named "Chapter.fm" with "1-Introduction" as paragraph text is converted to an HTML topic with the title "Chapter-1-Introduction" and the filename "Chapter-1-Introduction.htm" HTML topic generated has the filename consisting of the filename of the FrameMaker document without the .fm extension and the paragraph number separated by a hyphen. For example, the FrameMaker document "Chapter.fm" is converted to an HTML topic with the title "Chapter-1" and the filename "Chapter-1.htm" HTML topic generated has the filename consisting of the paragraph text of the paragraph format at which pagination is set, without the paragraph number. For example, a heading 1 paragraph "1. Introduction" is converted to an HTML topic with the title "Introduction" and the filename "Introduction.htm" HTML topic generated has the filename consisting of the paragraph text of the paragraph format on which pagination is set. For example, a heading 1 paragraph "Introduction" is converted to an HTML topic with the same title and the filename "Introduction.htm" Marker-based pagination To name topics based on the marker used for pagination, configure each marker in the FrameMaker document and specify the filename and title as marker text in the filename | title format. Note: Both filename and title are optional. If you do not specify a filename (for example, you specify | ), RoboHelp creates a valid filename from the title. If you do not specify a title (for example, you specify ), RoboHelp creates the title from the topic name pattern. If marker text is empty, RoboHelp uses the topic name pattern to create the topic title and a valid filename. Last updated 7/13/2012