[ << 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

The next example demonstrates all printed \header variables. Note that the vertical spacing between the various header elements in the default layout is optimized for single-line entries. If you need multi-line elements, say, a two-line composer entry, try to append \vspace to the field if necessary to adjust the vertical spacing. An alternative is to define your own, custom layout, see section Custom layout for titles.

\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 is 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 produce no output 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 section Custom layout for titles.

If a \book block starts immediately with a \bookpart block, no book title gets 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 page.

\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.15 (development-branch).