27.3.1 Designating split points

You can designate places to split a DITA file based on the occurrence of any of the following:

Paragraph or character formats in text

HeadingPara = Split Title Paragraph formats in tables

DITA PI markers

Hypertext alert markers

Although you can use all these methods in the same DITA 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.)

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 element mapped to that format appears in your DITA document:

[HtmlStyles]
; doc format (para or char) = keywords for functions and properties
;   Split starts new HTML page at the start of its 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:

[HtmlStyles]

HeadingPara = Split Title Paragraph formats in tables

Normally DITA2Go 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 element, not at the paragraph in the table.

DITA PI markers

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


A Split PI marker must be placed to the left of any Title, FileName, or Cross-Ref marker that occurs in the same paragraph.

See §38. Working with processing instructions for more information.

Hypertext alert markers

You can mark a split point in your document by inserting a HyperAlert PI marker that contains only the word “split”.

Previous Topic:  27.3 Splitting files

Next Topic:  27.3.2 Managing split points

Parent Topic:  27.3 Splitting files

Sibling Topics:

27.3.2 Managing split points