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
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:
[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 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.
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.
You can mark a split point in your document by inserting a HyperAlert PI marker that contains only the word “split”.