Page breaking - GNU LilyPond
Description: GNU LilyPond

Next: Optimal page breaking, Previous: Line breaking, Up: Breaks

#### 11.3.2 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. LilyPond provides two algorithms for computing page breaks, `ly:optimal-breaking` and `ly:page-turn-breaking`. The default is `ly:optimal-breaking`, but the value can be changed in the `\paper` block:

    \paper{
      #(define page-breaking ly:page-turn-breaking)
    }

The old page breaking algorithm is called `optimal-page-breaks`. If you are having trouble with the new page breakers, you can enable the old one as a workaround.

##### Predefined commands

`\pageBreak` `\noPageBreak`

Next: Optimal page breaking, Previous: Line breaking, Up: Breaks

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