Previous: Multiple scores in a book, Up: Input structure
A .ly file may contain any number of toplevel expressions, where a
toplevel expression is one of the following:
\paper, \midi, and
\layout. Such a definition at the toplevel changes the default
book-wide settings. If more than one such definition of
the same type is entered at the top level any definitions in the later
expressions have precedence.
#(set-default-paper-size "a7" 'landscape) or
#(ly:set-option 'point-and-click #f).
\header block. This sets the global header block. This
is the block containing the definitions for book-wide settings, like
composer, title, etc.
\score block. This score will be collected with other
toplevel scores, and combined as a single \book.
This behavior can be changed by setting the variable
toplevel-score-handler at toplevel. The default handler is
defined in the init file ../scm/lily.scm.
\book block logically combines multiple movements
(i.e., multiple \score blocks) in one document. If there
are a number of \scores, one output file will be created
for each \book block, in which all corresponding movements
are concatenated. The only reason to explicitly specify
\book blocks in a .ly file is if you wish to create
multiple output files from a single input file. One exception is
within lilypond-book documents, where you explicitly have to add
a \book block if you want more than a single \score
or \markup in the same example. This behavior can be
changed by setting the variable toplevel-book-handler at
toplevel. The default handler is defined in the init file
../scm/lily.scm.
{ c'4 d' e'2 }
This will add the piece in a \score and format it in a
single book together with all other toplevel \scores and music
expressions. In other words, a file containing only the above
music expression will be translated into
\book {
\score {
\new Staff {
\new Voice {
{ c'4 d' e'2 }
}
}
}
\layout { }
\header { }
}
This behavior can be changed by setting the variable
toplevel-music-handler at toplevel. The default handler is
defined in the init file ../scm/lily.scm.
\markup {
2. The first line verse two.
}
Markup texts are rendered above, between or below the scores or music expressions, wherever they appear.
foo = { c4 d e d }
This can be used later on in the file by entering \foo. The
name of an variable should have alphabetic characters only; no
numbers, underscores or dashes.
The following example shows three things that may be entered at toplevel
\layout {
% Don't justify the output
ragged-right = ##t
}
\header {
title = "Do-re-mi"
}
{ c'4 d' e2 }
At any point in a file, any of the following lexical instructions can be entered:
\version
\include
\sourcefilename
\sourcefileline
% sign.
%{ .. %}.
Learning Manual: How LilyPond input files work.
Cette page documente LilyPond-2.11.58 (branche de développement).
Rapportez toute anomalie en français à lilypond-user-fr@gnu.org ou en anglais à http://post.gmane.org/post.php?group=gmane.comp.gnu.lilypond.bugs
Vos suggestions à propos de la documentation sont les bienvenues.