certain effect.
The controls available for tuning are described in a separate
-document, the @internalsref{Program reference} manual. This manual
+document, the @internalsref{Program reference} manual. That manual
lists all different variables, functions and options available in
LilyPond. It is written as a HTML document, which is available
@uref{http://lilypond.org/doc/Documentation/user/out-www/lilypond-internals/,on-line},
@item An @code{\addquote} statement. See @ref{Quoting other voices}
for more information.
-@item A @code{\score} block. This score will be formatted as a book
-containing a single movement.
+@item A @code{\score} block. This score will be collected with other
+toplevel scores, and combined as a single @code{\book}.
This behavior can be changed by setting the variable
@code{toplevel-score-handler} at toplevel. The default handler is
defined in the init file @file{scm/lily.scm}.
-
@item A @code{\book} block formats the block
This behavior can be changed by setting the variable
@{ c'4 d' e'2 @}
@end example
- This will format the piece as a book with a single movement.
-
+This will add the piece in a @code{\score}, and formats it into a
+single book together with all other toplevel @code{\score}s and music
+expressions.
This behavior can be changed by setting the variable
@code{toplevel-music-handler} at toplevel. The default handler is
input, which is often bare bones. For example, compare the input and
output of the following example:
-@lilypond[verbatim,relative=2]
+@lilypond[verbatim,relative=2,fragment]
cis4 cis2. g4
@end lilypond
staves. Each part that should be on its own staff, is preceded with
@code{\new Staff}.
-@lilypond[verbatim,relative=2,raggedright]
+@lilypond[verbatim,relative=2,raggedright,fragment]
<< \new Staff { c4 c }
\new Staff { d4 d }
>>
@verbatim
music = \notes { c4 c4 }
-arts = \notes { s4-. s4-> }
+arts = \notes { s4-. s4-> }
@end verbatim
They are combined by sending both to the same @context{Voice} context,
>>
@end verbatim
@lilypond[raggedright]
-music = \notes { c4 c4 }
+music = \notes { c4 c4 }
arts = \notes { s4-. s4-> }
\score {
\notes \relative c'' << \new Staff \context Voice = "A" \music
@end quotation
For example,
-@lilypond[verbatim,relative=2]
+@lilypond[verbatim,relative=2,fragment]
R1*2
\set Score.skipBars = ##t
R1*2
context (typically @context{ChordNames}, @context{Voice}, or
@context{Lyrics}) is used. In this example,
-@lilypond[verbatim,relative=2]
+@lilypond[verbatim,relative=2,fragment]
c8 c c c
\set autoBeaming = ##f
c8 c c c
Settings that should only apply to a single time-step can be entered
easily with @code{\once}, for example in
-@lilypond[verbatim,relative=2]
+@lilypond[verbatim,relative=2,fragment]
c4
\once \set fontSize = #4.7
c4
example which removes @code{Time_signature_engraver} and
@code{Clef_engraver} from a @code{Staff} context,
-@lilypond[relative=1, verbatim]
+@lilypond[relative=1, verbatim,fragment]
<< \new Staff {
f2 g
}
@cindex polymetric scores
-@lilypond[relative=1,raggedright,verbatim]
+@lilypond[relative=1,raggedright,verbatim,fragment]
\new Score \with {
\remove "Timing_engraver"
} <<
applies to the current staff. Other staves will keep their normal
appearance. Here we see the command in action:
-@lilypond[verbatim,relative=2]
+@lilypond[verbatim,relative=2,fragment]
c4
\override Staff.Stem #'thickness = #4.0
c4
causing it to default to @context{Voice}, and adding @code{\once} applies
the change during one timestep only
-@lilypond[verbatim,relative=2]
+@lilypond[fragment,verbatim,relative=2]
c4
\once \override Stem #'thickness = #4.0
c4
the object is created. In this example,
-@lilypond[verbatim,relative=2]
+@lilypond[fragment,verbatim,relative=2]
\override Slur #'thickness = #3.0
c8[( c
\override Beam #'thickness = #0.6
@cindex setting object properties
-@lilypond[relative=1,verbatim]
+@lilypond[fragment,relative=1,verbatim]
\stemUp
f-5
\once \override Fingering
example; a more elaborate explanation is in @ref{Constructing a
tweak}:
-@lilypond[relative=1,verbatim]
+@lilypond[fragment,relative=1,verbatim]
c2\fermata
\override Script #'padding = #3
b2\fermata
Suppose we want to move the fingering indication in the fragment
below:
-@lilypond[relative=2,verbatim]
+@lilypond[fragment,relative=2,verbatim]
c-2
\stemUp
f
Recall that we wanted to change the position of the @b{2} in
-@lilypond[relative=2,verbatim]
+@lilypond[fragment,relative=2,verbatim]
c-2
\stemUp
f
Distance between top-most music system and the page header
@item foot-sep
Distance between bottom-most music system and the page footer
+@item raggedbottom
+ If set to true, systems will not be spread across the page.
+@item raggedlastbottom
+ If set to true, systems will not be spread to fill the last page.
@end table
The default page header puts the page number and the @code{instrument}
field from the @code{\header} block on a line.
+
+
+
@cindex copyright
@cindex tagline
and @code{make-header}, defined in @code{\bookpaper}. The default
implementations are in @file{scm/page-layout.scm}.
+The following settings influence the header and footer layout.
+
+@table @code
+@item printpagenumber
+ this boolean controls whether a pagenumber is printed.
+@end table
+
+
+
The page layout itself is done by two functions:
@code{page-music-height} and @code{page-make-stencil}. The former
tells the line-breaking algorithm how much space can be spent on a
projects / lilypond.git / blobdiff