Page breaking - GNU LilyPond
Description: GNU LilyPond

Previous: Line breaking, Up: Music layout

#### 10.5.9 Page breaking

The default page breaking may be overriden by inserting `\pageBreak` or `\noPageBreak` commands. These commands are analogous to `\break` and `\noBreak`. They should be inserted at a bar line. These commands force and forbid a page-break from happening. Of course, the `\pageBreak` command also forces a line break.

Page breaks are computed by the `page-breaking` function in the `\paper` block.

To force a new page for a new piece (in a collection of pieces or a piece in several movements), use `breakbefore` in the header.

    \header{
      breakbefore = ##t
      piece = ""
    }

##### Predefined commands

`\pageBreak` `\noPageBreak`

##### Bugs

The `breakbefore=##t` header requires that there is a `piece` header as well. It may be used as a normal header, or left blank (`=""`) as in the example above, but it must be present.

This page is for LilyPond-2.8.8 (stable-branch).

Other languages: English.
Using automatic language selection.