[ << Spacing issues ]	[Top][Contents][Index][ ? ]			[ Changing defaults >> ]
[ < \paper variables for shifts and indents ]		[  Up : Page layout ]	[ \paper variables for line breaking > ]

4.1.6 Other \paper variables

\paper variables for line breaking
\paper variables for page breaking
\paper variables for page numbering
Miscellaneous \paper variables

---

[ << Spacing issues ]	[Top][Contents][Index][ ? ]			[ Changing defaults >> ]
[ < Other \paper variables ]		[  Up : Other \paper variables ]	[ \paper variables for page breaking > ]

\paper variables for line breaking

max-systems-per-page

The maximum number of systems that will be placed on a page. This is currently supported only by the ly:optimal-breaking algorithm. Default: unset.

min-systems-per-page

The minimum number of systems that will be placed on a page. This may cause pages to be overfilled if it is made too large. This is currently supported only by the ly:optimal-breaking algorithm. Default: unset.

systems-per-page

The number of systems that should be placed on each page. This is currently supported only by the ly:optimal-breaking algorithm. Default: unset.

system-count

The number of systems to be used for a score. Default: unset. This variable can also be set in a \layout block.

See also

Notation Reference: Line breaking.

---

[ << Spacing issues ]	[Top][Contents][Index][ ? ]			[ Changing defaults >> ]
[ < \paper variables for line breaking ]		[  Up : Other \paper variables ]	[ \paper variables for page numbering > ]

\paper variables for page breaking

Default values not listed here are defined in ‘ly/paper-defaults-init.ly’

blank-after-score-page-force

The penalty for having a blank page after the end of one score and before the next. By default, this is smaller than blank-page-force, so that we prefer blank pages after scores to blank pages within a score.

blank-last-page-force

The penalty for ending the score on an odd-numbered page.

blank-page-force

The penalty for having a blank page in the middle of a score. This is not used by ly:optimal-breaking since it will never consider blank pages in the middle of a score.

page-breaking

The page-breaking algorithm to use. Choices are ly:minimal-breaking, ly:page-turn-breaking, and ly:optimal-breaking.

page-breaking-system-system-spacing

Tricks the page breaker into thinking that system-system-spacing is set to something different than it really is. For example, if page-breaking-system-system-spacing #'padding is set to something substantially larger than system-system-spacing #'padding, then the page-breaker will put fewer systems on each page. Default: unset.

page-count

The number of pages to be used for a score, unset by default.

See also

Notation Reference: Page breaking, Optimal page breaking, Optimal page turning, Minimal page breaking.

Installed Files: ‘ly/paper-defaults-init.ly’.

---

[ << Spacing issues ]	[Top][Contents][Index][ ? ]			[ Changing defaults >> ]
[ < \paper variables for page breaking ]		[  Up : Other \paper variables ]	[ Miscellaneous \paper variables > ]

\paper variables for page numbering

Default values not listed here are defined in ‘ly/paper-defaults-init.ly’

auto-first-page-number

The page breaking algorithm is affected by the first page number being odd or even. If set to true, the page breaking algorithm will decide whether to start with an odd or even number. This will result in the first page number remaining as is or being increased by one. Default: #f.

first-page-number

The value of the page number on the first page.

print-first-page-number

If set to true, a page number is printed on the first page.

print-page-number

If set to false, page numbers are not printed.

See also

Installed Files: ‘ly/paper-defaults-init.ly’.

Known issues and warnings

Odd page numbers are always on the right. If you want the music to start on page 1 there must be a blank page on the back of the cover page so that page 1 is on the right hand side.

---

[ << Spacing issues ]	[Top][Contents][Index][ ? ]			[ Changing defaults >> ]
[ < \paper variables for page numbering ]		[  Up : Other \paper variables ]	[ Score layout > ]

Miscellaneous \paper variables

page-spacing-weight

The relative importance of page (vertical) spacing and line (horizontal) spacing. High values will make page spacing more important. Default: #10.

print-all-headers

If set to true, this will print all headers for each \score in the output. Normally only the piece and opus header variables are printed. Default: #f.

system-separator-markup

A markup object that is inserted between systems, often used for orchestral scores. Default: unset. The \slashSeparator markup, defined in ‘ly/titling-init.ly’, is provided as a sensible default, for example:

#(set-default-paper-size "a8")

\book {
  \paper {
    system-separator-markup = \slashSeparator
  }
  \header {
    tagline = ##f
  }
  \score {
    \relative c'' { c1 \break c1 \break c1 }
  }
}

See also

Installed Files: ‘ly/titling-init.ly’.

Snippets: Spacing.

Known issues and warnings

The default page header puts the page number and the instrument field from the \header block on a line.

---

[ << Spacing issues ]	[Top][Contents][Index][ ? ]			[ Changing defaults >> ]
[ < \paper variables for page numbering ]		[  Up : Other \paper variables ]	[ Score layout > ]

Other languages: deutsch, español, français.

<< Back to Documentation Index

LilyPond — Notation Reference