 |
Page breaking primitives |
 |
| Operator |
Arity |
Accessible |
|
Process |
Usage |
|
|
border |
children |
|
|
| no-page-break |
0 |
Yes |
- |
Typesetting |
Physical |
| no-page-break* |
0 |
Yes |
- |
Typesetting |
Physical |
| new-page |
0 |
Yes |
- |
Typesetting |
Physical |
| new-page* |
0 |
Yes |
- |
Typesetting |
Physical |
| page-break |
0 |
Yes |
- |
Typesetting |
Physical |
| page-break* |
0 |
Yes |
- |
Typesetting |
Physical |
|
|
Table 1. Page breaking primitives
|
The paragraphs in a document are broken in pages in a way similar to how
paragraphs are hyphenated in soft lines. The page breaker performs
page filling, it tries to distribute page items
evenly so text runs to the bottom of every page. It also tries to avoid
orphans and widows, which are single or pairs of
soft lines separated from the rest of their paragraph by a page break,
but these can be produced when there is no better solution.
(prevent automatic page breaking
after this paragraph)
Prevent the occurrence of an automatic page break after the current
paragraph. Set an infinite page breaking penalty for the current
paragraph, similarly to no-break.
Forbidden page breaking points are overridden by
“new page” and “page break”
primitives.
(prevent automatic page breaking
before this paragraph)
Similar to no-page-break,
but set the page breaking penalty of the previous
paragraph.
(start a new page after this
paragraph)
Cause the next paragraph to appear on a new page,
without filling the current page. The page breaker will not try to
position the current paragraph at the bottom of the page.
(start a new page before this
paragraph)
Similar to new-page,
but start the new page before the current paragraph. This directive
is appropriate to use in chapter headings.
(force a page break after this
paragraph)
Force a page break after the current paragraph. A forced page break
is different from a new page, the page breaker will try to position
the current paragraph at the bottom of the page.
Use only to fine-tune the automatic page breaking.
Ideally, this should be a hint similar to line-break,
but this is implemented as a directive, use only with extreme
caution.
(force a page break before this
paragraph)
Similar to page-break,
but force a page break before the current paragraph.
When several “new page” and “page break”
directives apply to the same point in the document, only the first one
is effective. Any new-page or
page-break after the first one
in a paragraph is ignored. Any new-page
or page-break in a paragraph
overrides any new-page* or
page-break* in the following
paragraph. Any new-page* or
page-break* after the first
one in a paragraph is ignored.
© 2004 David Allouche
Permission is
granted to copy, distribute and/or modify this document under the terms of
the GNU Free Documentation License, Version 1.1 or any later version
published by the Free Software Foundation; with no Invariant Sections,
with no Front-Cover Texts, and with no Back-Cover Texts. A copy of the
license is included in the section entitled "GNU Free Documentation
License".