17.2.1 Designating split points
You can designate places to split a FrameMaker file based on the occurrence of any of the following:
Paragraph or character formats in text
Although you can use all these methods in the same FrameMaker document, usually the paragraph-format method alone is adequate. (Do not use any of these methods if you are producing DITA XML output; files are split another way for DITA.)
If you are using the Mif2Go plug-in, Mif2Go tries to determine automatically the most likely split points; see §1.5 How Mif2Go works. Mif2Go lists under [HtmlStyles] the paragraph formats it chooses for split points. Be sure you inspect these proposed assignments, and correct any that are inappropriate. If you are generating HTML-based help, also check the matching list under [HelpContentsLevels]. |
Paragraph or character formats in text
You can assign the Split property to a paragraph or character format, so a new HTML page begins wherever an instance of the format appears in your FrameMaker document:
; doc format (para or char) = keywords for functions and properties
; Split starts new HTML page at the start of its paragraph.
If you use this method to designate split points you will almost certainly want to add the Title property too, maybe others:
ChapTitle=Split Title NoFrameBelow
Normally Mif2Go does not allow a file split when a paragraph for which you have specified the Split property occurs within a table. However, you can override this prohibition with the following setting:
; or Yes (allow file split for head in table)
When AllowTbSplit=Yes, the actual split is made at the paragraph containing the table anchor, not at the paragraph in the table.
You can designate whether "hard" page breaks in your FrameMaker document result in a new HTML page, a horizontal bar, or neither:
; PageBreaks = Rule (<hr>), None, or Split
Setting PageBreaks=Split does not cause splitting at page breaks that are automatically generated by FrameMaker (in the middle of a paragraph, for example), but only at page breaks specified as part of a paragraph format, either by definition (start at top of page) or as an override.
You can add custom marker type Split to your FrameMaker document, and insert a Split marker wherever you want a split point. You can also invent a new marker type (for example, SplitMark) to use for split points, or you can add the Split property to an existing marker:
A Split marker must be placed to the left of any Title, FileName, or Cross-Ref marker that occurs in the same paragraph.
See §28 Working with FrameMaker markers for more information.
You can mark a split point in your document by inserting a hypertext alert marker that contains only the word "split". See §32.1.2 Using markers to add links and instructions.
> 17 Splitting and extracting files > 17.2 Splitting files > 17.2.1 Designating split points