Previous: Multiple movements, Up: Paper output



10.1.13 Creating titles

Titles are created for each \score block, and over a \book.

The contents of the titles are taken from the \header blocks. The header block for a book supports the following

dedication
The dedicatee of the music, centered at the top of the first page.
title
The title of the music, centered just below the dedication.
subtitle
Subtitle, centered below the title.
subsubtitle
Subsubtitle, centered below the subtitle.
poet
Name of the poet, flush-left below the subtitle.
composer
Name of the composer, flush-right below the subtitle.
meter
Meter string, flush-left below the poet.
opus
Name of the opus, flush-right below the composer.
arranger
Name of the arranger, flush-right below the opus.
instrument
Name of the instrument, centered below the arranger. Also centered at the top of pages (other than the first page).
piece
Name of the piece, flush-left below the instrument.


breakbefore
This forces the title to start on a new page (set to ##t or ##f).
copyright
Copyright notice, centered at the bottom of the first page. To insert the copyright symbol, see Text encoding.
tagline
Centered at the bottom of the last page.

Here is a demonstration of the fields available. Note that you may use any Text markup commands in the header.

\paper {
  linewidth = 9.0\cm
  vsize = 10.0\cm
}

\book {
  \header {
    dedication = "dedicated to me"
    title = \markup \center-align { "Title first line" "Title second line, longer" }
    subtitle = "the subtitle,"
    subsubtitle = #(string-append "subsubtitle LilyPond version " (lilypond-version))
    poet = "Poet"
    composer =  \markup \center-align { "composer" \small "(1847-1973)" }
    texttranslator = "Text Translator"
    meter = \markup { \teeny "m" \tiny "e" \normalsize "t" \large "e" \huge "r" }
    arranger = "Arranger"
    opus = \markup { \fontsize #8.5 "o" \fontsize #2.5 "p" \fontsize #-2.5 "u" \fontsize #-5.3 "s" \fontsize #7.5 "       " }
    instrument = \markup \bold \italic "instrument"
    piece = "Piece"
  }

  \score {
    { c'1 }
    \header {
      piece = "piece1"
      opus = "opus1"
    }
  }
  \markup {
      and now...
  }
  \score {
    { c'1 }
    \header {
      piece = "piece2"
      opus = "opus2"
    }
  }
}

[image of music]

A more advanced option is to change the definitions of the following variables in the \paper block. The init file ly/titling-init.ly lists the default layout.

bookTitleMarkup
This is the title put over an entire \book block. Typically, it has the composer and the title of the piece
scoreTitleMarkup
This is the title put over a \score block within a \book. Typically, it has the name of the movement (piece field).
oddHeaderMarkup
This is the page header for odd-numbered pages.
evenHeaderMarkup
This is the page header for even-numbered pages. If unspecified, the odd header is used instead.

By default, headers are defined such that the page number is on the outside edge, and the instrument is centered.

oddFooterMarkup
This is the page footer for odd-numbered pages.
evenFooterMarkup
This is the page footer for even-numbered pages. If unspecified, the odd header is used instead.

By default, the footer has the copyright notice on the first, and the tagline on the last page.

The following definition will put the title flush left, and the composer flush right on a single line.

\paper {
  bookTitleMarkup = \markup {
   \fill-line {
     \fromproperty #'header:title
     \fromproperty #'header:composer
   }
  }
}

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

Report errors to <bug-lilypond@gnu.org>.

Other languages: English.
Using automatic language selection.