[ << General input and output ]	[Top][Contents][Index]	[ Spacing issues >> ]
[ < Titles explained ]	[ Up : Creating titles headers and footers ]	[ Default layout of headers and footers > ]

Default layout of bookpart and score titles

This example demonstrates all printed \header variables:

\book {
  \header {
    % The following fields are centered
    dedication = "Dedication"
    title = "Title"
    subtitle = "Subtitle"
    subsubtitle = "Subsubtitle"

    % The following fields are evenly spread on one line;
    % the field "instrument" also appears on following pages
    instrument = \markup \with-color #green "Instrument"
    poet = "Poet"
    composer = "Composer"

    % The following fields are placed at opposite ends
    %of the same line
    meter = "Meter"
    arranger = "Arranger"

    % The following fields are centered at the bottom
    tagline = "The tagline goes at the bottom of the last page"
    copyright = "The copyright goes at the bottom of the first page"
  }
  \score {
    \header {
      % The following fields are placed at opposite ends
      % of the same line
      piece = "Piece 1"
      opus = "Opus 1"
    }
    { s1 }
  }
  \score {
    \header {
      % The following fields are placed at opposite ends
      % of the same line
      piece = "Piece 2 on the same page"
      opus = "Opus 2"
    }
    { s1 }
  }
  \pageBreak
  \score {
    \header {
      % The following fields are placed at opposite ends
      % of the same line
      piece = "Piece 3 on a new page"
      opus = "Opus 3"
    }
    { s1 }
  }
}

Note that

• The instrument name will be repeated on every page.
• Only piece and opus are printed in a \score when the paper variable print-all-headers is set to #f (the default).
• Text fields left unset in a \header block are replaced with \null markups so that the space is not wasted.
• The default settings for scoreTitleMarkup place the piece and opus text fields at opposite ends of the same line.

To change the default layout see Custom layout for titles.

If a \book block starts immediately with a \bookpart block, no Book Title will be printed, as there is no page on which to print it. If a Book Title is required, begin the \book block with some markup material or a \pageBreak command.

Use the breakbefore variable inside a \header block that is itself in a \score block, to make the higher-level \header block titles appear on the first page on their own, with the music (defined in the \score block) starting on the next.

\book {
  \header {
    title = "This is my Title"
    subtitle = "This is my Subtitle"
    copyright = "This is the bottom of the first page"
  }
  \score {
    \header {
      piece = "This is the Music"
      breakbefore = ##t
    }
    \repeat unfold 4 { e'' e'' e'' e'' }
  }
}

See also

Learning Manual: How LilyPond input files work,

Notation Reference: Custom layout for titles, File structure.

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

---

[ << General input and output ]	[Top][Contents][Index]	[ Spacing issues >> ]
[ < Titles explained ]	[ Up : Creating titles headers and footers ]	[ Default layout of headers and footers > ]

<< Back to Documentation Index

LilyPond — Notation Reference v2.25.4 (development-branch).