Omni Systems, Inc. Mif2Go User's Guide, Version 55

<< Prev | Next >>

> 18 Splitting and extracting files > 18.2 Splitting files > 18.2.1 Designating split points

### 18.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

Paragraph formats in tables

Page breaks

FrameMaker markers

Hypertext alert markers

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.)

Note: 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 [HTMLParaStyles] 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:

[HTMLParaStyles]

; Paragraph format = Split starts a new HTML page at the start of the

; paragraph.

HeadingPara = Split

If you use this method to designate split points you will almost certainly want to add the Title property too, maybe others:

[HTMLParaStyles]

HeadingPara = Split Title NoFrameBelow

Note: In your FrameMaker document, if you separate the HeadingPara paragraph from following text with an empty paragraph in the same HeadingPara format (perhaps for spacing), you will get two split files: one containing only the heading, the other containing only the text. See §18.2.2 Managing split points.

Paragraph formats in tables

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:

[Tables]

; AllowTbSplit = No (default)

; or Yes (allow file split for head in table)

AllowTbSplit=Yes

When AllowTbSplit=Yes, the actual split is made at the paragraph containing the table anchor, not at the paragraph in the table.

Page breaks

You can designate whether “hard” page breaks in your FrameMaker document result in a new HTML page, a horizontal bar, or neither:

[HTMLOptions]

; PageBreaks = Rule (<hr>), None, or Split

PageBreaks=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.

FrameMaker marker s

You can add FrameMaker marker type Split to your FrameMaker document, and insert a Split marker wherever you want a split point. However, f you insert a Split marker in a paragraph whose format is also assigned the Split property, the Split marker is ignored.

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:

[MarkerTypes]

Splitmark = Split

Subject = Split

Note: If you also assign one or more of marker type properties Cross-Ref, Title, or FileName, those properties must be specified after the Split property; for example:

[MarkerTypes]

Filespec = Split FileName

Topicmark = Split Title

See §29.4.2 Observing restrictions on redefining marker behavior.

A Split marker can be placed before the title element in the topic. It must be placed to the left of any Title, FileName, or Cross-Ref marker that occurs in the same paragraph.

See §29 Working with FrameMaker markers for more information.

Hypertext alert markers

You can mark a split point in your document by inserting a hypertext alert marker that contains only the word “split”. See §34.1.2 Using markers to add links and instructions.