Command/pagebreak
< Command
Jump to navigation
Jump to search
Contents
\pagebreak
Summary
The command \pagebreak (or it's more commonly used alias \page) is used for inserting a page break.
Settings
| \pagebreak[...,...] | |
| [...,...] | empty header footer dummy frame number +number default reset disable yes no makeup blank preference bigpreference left right even odd quadruple last lastpage start stop xy name |
| Option | Explanation |
|---|---|
| empty | insert a blank page (even without headers and footers) |
| header | set header off temporarily |
| footer | set footer off temporarily |
| dummy | inserts one blank page |
| frame | shows the page frame on the next following (empty) page |
| number | jump to the page with this number |
| +number | add this many page breaks (inserting blank pages) |
| default | same as yes |
| reset | reset the disable command |
| disable | ignore the next \page command |
| yes | force a new page |
| no | when possible, avoid page break (This only works in vertical mode, so you might need to insert a paragraph break or \par before the \page command) |
| makeup | force a new page, without filling the current page with whitespace |
| blank | insert a blank page (no page numbers, but with headers and footers); (sometimes \page[yes, blank] is required?) |
| preference | allow page break (i.e. when possible, force page break) |
| bigpreference | allow page break (i.e. when possible, force page break), trying harder |
| left | force a left page |
| right | force a right page |
| even | force an even page |
| odd | force and odd page |
| quadruple | force a quadruple page |
| last | add last page(s), useful for arrangements |
| lastpage | add last page |
| start | enable pagebreak commands ? |
| stop | disable pagebreak commands ? |
| xy | add last page(s), useful for the XY fake arrangement |
| name | a keyword defined with \definepagebreak |
Description
Insert a page break and possibly some extra empty pages.
The page-breaking behaviour of most structural commands is specified with the page keyword, which takes the same arguments.
Examples
Example 1
\setuppapersize[A10, landscape][A8, landscape] \setuppagenumbering[alternative=singlesided, location={header,inright}] \setuppaper[nx=2, ny=2] \setuparranging[XY] \showframe[cut=true] \subject{One} Mary, Mary, Mary, \page[odd] \subject{Two} Had a, had a, had a, \page[yes] lamb, lamb, lamb
Notes
See also
- page-brk.mkiv
- \definepagebreak to define a page breaking keyword that combines the properties of several existing keywords
- \page is an alias of this command
- \screen is an alias of this command
- \column to insert a column break
- \setuparranging
