| [ << General input and output ] | [Top][Contents][Index][ ? ] | [ Spacing issues >> ] | ||
| [ < Titles and headers ] | [ Up : Titles and headers ] | [ Custom titles > ] | ||
3.2.1 Creating titles
Titles are created for each \score block, as well as for the full
input file (or \book block) and book parts (created by
\bookpart blocks).
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 subsubtitle.
-
instrument Name of the instrument, centered below the subsubtitle. Also centered at the top of pages (other than the first page).
-
composer Name of the composer, flush-right below the subsubtitle.
-
meter Meter string, flush-left below the poet.
-
arranger Name of the arranger, flush-right below the composer.
-
piece Name of the piece, flush-left below the meter.
-
opus Name of the opus, flush-right below the arranger.
-
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 Formatting text, commands in the header.
\paper {
line-width = 9.0\cm
paper-height = 10.0\cm
}
\book {
\header {
dedication = "dedicated to me"
title = \markup \center-column { "Title first line" "Title second line,
longer" }
subtitle = "the subtitle,"
subsubtitle = #(string-append "subsubtitle LilyPond version "
(lilypond-version))
poet = "Poet"
composer = \markup \center-column { "composer" \small "(1847-1973)" }
texttranslator = "Text Translator"
meter = \markup { \teeny "m" \tiny "e" \normalsize "t" \large "e" \huge
"r" }
arranger = \markup { \fontsize #8.5 "a" \fontsize #2.5 "r" \fontsize
#-2.5 "r" \fontsize #-5.3 "a" \fontsize #7.5 "nger" }
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"
}
}
}
As demonstrated before, you can use multiple \header blocks.
When same fields appear in different blocks, the latter is used.
Here is a short example.
\header {
composer = "Composer"
}
\header {
piece = "Piece"
}
\score {
\new Staff { c'4 }
\header {
piece = "New piece" % overwrite previous one
}
}
If you define the \header inside the \score block, then
normally only the piece and opus headers will be printed.
Note that the music expression must come before the \header.
\score {
{ c'4 }
\header {
title = "title" % not printed
piece = "piece"
opus = "opus"
}
}
You may change this behavior (and print all the headers when defining
\header inside \score) by using
\paper{
print-all-headers = ##t
}
The default footer is empty, except for the first page, where the
copyright field from \header is inserted, and the last
page, where tagline from \header is added. The default
tagline is “Music engraving by LilyPond (version)”.1
Headers may be completely removed by setting them to false.
\header {
tagline = ##f
composer = ##f
}
| [ << General input and output ] | [Top][Contents][Index][ ? ] | [ Spacing issues >> ] | ||
| [ < Titles and headers ] | [ Up : Titles and headers ] | [ Custom titles > ] | ||