Previous: Horizontal dimensions, Up: Page formatting


Other layout variables

These variables can be used to adjust page layout in general.

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.

blank-last-page-force

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

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. Default: 5.

first-page-number

The value of the page number on the first page. Default: #1.

page-breaking-between-system-padding

Tricks the page breaker into thinking that between-system-padding is set to something different than it really is. For example, if this variable is set to something substantially larger than between-system-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. Default: unset.

page-limit-inter-system-space

If set to true, limits space between systems on a page with a lot of space left. Default: ##f. For details, see Vertical spacing between systems.

page-limit-inter-system-space-factor

The factor used by page-limit-inter-system-space. Default: 1.4. For details, see Vertical spacing between systems.

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.

print-first-page-number

If set to true, a page number is printed on the first page. Default: ##f.

print-page-number

If set to false, page numbers are not printed. Default: ##t.

ragged-bottom

If set to true, systems will not spread vertically across the page. This does not affect the last page. Default: ##f.

This should be set to true for pieces that have only two or three systems per page, for example orchestral scores.

ragged-last

If set to true, the last system in the score will not fill the line width. Instead the last system ends at its natural horizontal length. Default: ##f.

ragged-last-bottom

If set to false, systems will spread vertically across the last page. Default: ##t.

Pieces that amply fill two pages or more should have this set to true.

It also affects the last page of book parts, ie parts of a book created with \bookpart blocks.

ragged-right

If set to true, systems will not fill the line width. Instead, systems end at their natural horizontal length. Default: ##f.

If the score has only one system, the default value is ##t.

system-separator-markup

A markup object that is inserted between systems. This is often used for orchestral scores. Default: unset.

The markup command \slashSeparator is provided as a sensible default, for example

[image of music]


system-count

The number of systems to be used for a score. Default: unset.

See also

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.

The titles (from the \header{} section) are treated as a system, so ragged-bottom and ragged-last-bottom will add space between the titles and the first system of the score.

Autres langues : español.