Guide, node Updating translation committishes..
@end ignore
-@c \version "2.13.36"
+@c \version "2.17.6"
@node Vocal music
@section Vocal music
Snippets:
@rlsr{Vocal music}.
+
@node Entering lyrics
@unnumberedsubsubsec Entering lyrics
\lyricmode @{ lah lah lah @}
@end example
-@cindex overrides in lyric mode
-@funindex \override in \lyricmode
-
-Similarly, in lyric mode, a period will be included in the
-alphabetic sequence that it follows. As a consequence, spaces
-must be inserted around the period in @code{\override} commands.
-Do @emph{not} write
-
-@example
-\override Score.LyricText #'font-shape = #'italic
-@end example
-
-@noindent
-but instead use
-
-@example
-\override Score . LyricText #'font-shape = #'italic
-@end example
-
Punctuation, lyrics with accented characters, characters from
non-English languages, or special characters (such as the heart
symbol or slanted quotes), may simply be inserted directly
into the input file, providing it is saved with UTF-8 encoding.
-For more information, see @ref{Text encoding}.
+For more information, see @ref{Special characters}.
@lilypond[quote,verbatim]
\relative c'' { d8 c16 a bes8 f e' d c4 }
@snippets
-@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
+@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
{formatting-lyrics-syllables.ly}
@ref{Formatting text},
@ref{Input modes},
@ref{Manual syllable durations},
-@ref{Text encoding}.
+@ref{Special characters}.
Internals Reference:
@rinternals{LyricText}.
Snippets:
-@rlsr{Text}
+@rlsr{Text}.
+
@node Aligning lyrics to a melody
@unnumberedsubsubsec Aligning lyrics to a melody
Notation Reference:
@ref{Contexts explained},
-@ref{Automatic syllable durations}.
+@ref{Automatic syllable durations},
@ref{Stanzas},
@ref{Manual syllable durations},
@ref{Dialogue over music},
Internals Reference:
@rinternals{Lyrics}.
+
@node Automatic syllable durations
@unnumberedsubsubsec Automatic syllable durations
@ref{Keeping contexts alive},
@ref{Placing lyrics vertically}.
+
@node Manual syllable durations
@unnumberedsubsubsec Manual syllable durations
In order to assign more than one syllable to a single note with
spaces between the syllables, you can surround the phrase with
quotes or use a @code{_} character. Alternatively, you can use
-code the tilde symbol (@code{~}) to get a lyric tie. The lyric
-tie is implemented with the Unicode character U+203F, so be
-sure to use a font for this glyph which actually contains it.
-Freely available fonts with a lyric tie are, for example,
-`FreeSerif' (a Times clone), `DejaVuSans' (but not
-`DejaVuSerif'), or `TeXGyreSchola' (a Century Schoolbook
-clone).
+the tilde symbol (@code{~}) to get a lyric tie.
@lilypond[quote,ragged-right,verbatim]
{
- \time 3/4
- \relative c' { c2 e4 g2 e4 }
- \addlyrics { gran- de_a- mi- go }
- \addlyrics { pu- "ro y ho-" nes- to }
- \addlyrics { pu- ro~y~ho- nes- to }
+ \relative c'' { \autoBeamOff
+ r8 b c fis, fis c' b e, }
+ \addlyrics { Che_in ques -- ta_e_in quel -- l'al -- tr'on -- da }
+ \addlyrics { "Che in" ques -- "ta e in" quel -- l'al -- tr'on -- da }
+ \addlyrics { Che~in ques -- ta~e~in quel -- l'al -- tr'on -- da }
}
@end lilypond
-
@seealso
Internals Reference:
@rinternals{LyricCombineMusic}.
When a melisma occurs on a syllable other that the last one in a
word, that syllable is usually joined to the following one with a
hyphenated line. This is indicated by placing a double hyphen,
-@code{--}, immediately after the syllable.
+@w{@code{--}}, immediately after the syllable.
Alternatively, when a melisma occurs on the last or only syllable in
a word an extender line is usually drawn from the end of the syllable
>>
@end lilypond
+Note that phrasing slurs do not affect the creation of melismata.
+
@item
Notes are considered a melisma if they are manually beamed,
providing automatic beaming is switched off. See
>>
@end lilypond
-Note that this method cannot be used to indicate two melismata if
-the first one is immediately followed by another.
-
@item
A melisma can be defined entirely in the lyrics by entering a
single underscore character, @code{_}, for every extra note that has
@rinternals{Tunable context properties}.
@knownissues
-
Extender lines under melismata are not created automatically; they
must be inserted manually with a double underscore.
(threshold below which hyphens are removed) properties of
@code{LyricHyphen}.
-
@seealso
Internals Reference:
@rinternals{LyricExtender},
}
@end lilypond
-
@seealso
Notation Reference:
@ref{Placing lyrics vertically}.
<<
\new Lyrics = "lyrics" \with {
% lyrics above a staff should have this override
- \override VerticalAxisGroup #'staff-affinity = #DOWN
+ \override VerticalAxisGroup.staff-affinity = #DOWN
}
\new Staff {
\new Voice = "melody" {
\new Lyrics = "sopranos"
\new Lyrics = "contraltos" \with {
% lyrics above a staff should have this override
- \override VerticalAxisGroup #'staff-affinity = #DOWN
+ \override VerticalAxisGroup.staff-affinity = #DOWN
}
\new Staff {
\new Voice = "contraltos" {
@end lilypond
Other combinations of lyrics and staves may be generated by
-elaborating these examples, or by examining the
-@rlearning{Vocal ensembles} templates in the Learning Manual.
+elaborating these examples, or by examining the templates in the
+Learning Manual, see @rlearning{Vocal ensembles templates}.
@snippets
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
-{lyrics-old-spacing-settings.ly}
+@lilypondfile[verbatim,quote,texidoc,doctitle]
+{obtaining-2.12-lyrics-spacing-in-newer-versions.ly}
@seealso
Learning Manual:
-@rlearning{Vocal ensembles}.
+@rlearning{Vocal ensembles templates}.
Notation Reference:
-@ref{Aligning contexts},
+@ref{Context layout order},
@ref{Creating contexts}.
+
@node Placing syllables horizontally
@unnumberedsubsubsec Placing syllables horizontally
@lilypond[relative=1,verbatim,quote,ragged-right]
{
c c c c
- \override Lyrics.LyricSpace #'minimum-distance = #1.0
+ \override Lyrics.LyricSpace.minimum-distance = #1.0
c c c c
}
\addlyrics {
\layout {
\context {
\Lyrics
- \override LyricSpace #'minimum-distance = #1.0
+ \override LyricSpace.minimum-distance = #1.0
}
}
}
@end lilypond
@snippets
-@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
+@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
{lyrics-alignment.ly}
@c TODO: move to LSR -vv
feature can be disabled:
@example
-\override Score.PaperColumn #'keep-inside-line = ##f
+\override Score.PaperColumn.keep-inside-line = ##f
@end example
To make lyrics avoid bar lines as well, use
\Lyrics
\consists "Bar_engraver"
\consists "Separating_line_group_engraver"
- \override BarLine #'transparent = ##t
+ \override BarLine.transparent = ##t
@}
@}
@end example
-@c TODO Create and add lsr example of lyricMelismaAlignment
-@c It's used like this to center-align all lyric syllables,
-@c even when notes are tied. -td
-
-@ignore
-\layout
-{
- \context { \Score lyricMelismaAlignment = #0 }
-}
-@end ignore
-
-
@node Lyrics and repeats
@unnumberedsubsubsec Lyrics and repeats
}
@end lilypond
+@cindex alignBelowContext
+@funindex alignBelowContext
+
+However, if this construct is embedded within a multi-staved
+context such as a @code{ChoirStaff} the lyrics of the second and
+third verses will appear beneath the bottom staff.
+
+To position them correctly use @code{alignBelowContext}:
+
+@lilypond[verbatim,quote]
+\score {
+ <<
+ \new Staff {
+ \new Voice = "melody" {
+ \relative c'' {
+ a4 a a a
+ \repeat volta 3 { b4 b b b }
+ c4 c c c
+ }
+ }
+ }
+ \new Lyrics = "firstVerse" \lyricsto "melody" {
+ Not re -- peat -- ed.
+ <<
+ { The first time words. }
+ \new Lyrics = "secondVerse"
+ \with { alignBelowContext = #"firstVerse" } {
+ \set associatedVoice = "melody"
+ Sec -- ond time words.
+ }
+ \new Lyrics = "thirdVerse"
+ \with { alignBelowContext = #"secondVerse" } {
+ \set associatedVoice = "melody"
+ The third time words.
+ }
+ >>
+ The end sec -- tion.
+ }
+ \new Voice = "harmony" {
+ \relative c' {
+ f4 f f f \repeat volta 2 { g8 g g4 g2 } a4 a8. a16 a2
+ }
+ }
+ >>
+}
+@end lilypond
+
+
@c TODO positioning a common line of lyrics
\voiceOne
\times 2/3 {
% show associations clearly.
- \override NoteColumn #'force-hshift = #-3
+ \override NoteColumn.force-hshift = #-3
f8 f g
}
}
@lilypond[ragged-right,quote,verbatim]
melody = \relative c' {
- c c c c | d d d d
+ c4 c c c | d d d d
}
text = \lyricmode {
\markup {
\fill-line {
\hspace #0.1 % moves the column off the left margin;
- % can be removed if space on the page is tight
+ % can be removed if space on the page is tight
\column {
\line { \bold "2."
\column {
"It has two lines."
}
}
- \hspace #0.1 % adds vertical spacing between verses
+ \vspace #0.1 % adds vertical spacing between verses
\line { \bold "3."
\column {
"This is verse three."
}
}
}
- \hspace #0.1 % adds horizontal spacing between columns;
- % if they are still too close, add more " " pairs
- % until the result looks good
- \column {
+ \hspace #0.1 % adds horizontal spacing between columns;
+ \column {
\line { \bold "4."
\column {
"This is verse four."
"It has two lines."
}
}
- \hspace #0.1 % adds vertical spacing between verses
+ \vspace #0.1 % adds vertical spacing between verses
\line { \bold "5."
\column {
"This is verse five."
}
}
\hspace #0.1 % gives some extra space on the right margin;
- % can be removed if page space is tight
+ % can be removed if page space is tight
}
}
@end lilypond
Snippets:
@rlsr{Vocal music}.
+
@node Lead sheets
@unnumberedsubsubsec Lead sheets
@q{chord mode}; this syntax is explained in @ref{Chord notation}.
@snippets
-@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
+@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
{simple-lead-sheet.ly}
@seealso
@item
Several templates suitable for various styles of choral music can
also be found in the Learning Manual, see
-@rlearning{Vocal ensembles}.
+@rlearning{Vocal ensembles templates}.
@item
For information about @code{ChoirStaff} and @code{PianoStaff} see
@seealso
Learning Manual:
@rlearning{Four-part SATB vocal score},
-@rlearning{Vocal ensembles}.
+@rlearning{Vocal ensembles templates}.
Notation Reference:
@ref{Context layout order},
@rinternals{Lyrics},
@rinternals{PianoStaff}.
+
@node Score layouts for choral
@unnumberedsubsubsec Score layouts for choral
\layout {
\context {
\Score
- \override DynamicText #'direction = #UP
- \override DynamicLineSpanner #'direction = #UP
+ \override DynamicText.direction = #UP
+ \override DynamicLineSpanner.direction = #UP
}
}
}
@cindex voices, divided
-@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
+@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
{using-arpeggiobracket-to-make-divisi-more-visible.ly}
@seealso
@ref{Page layout}.
@item
-Dialogue cues and stage directions can be inserted with markup.
-See @ref{Text}. Extensive stage directions can be inserted with
-a section of stand-alone markup between two @code{\score} blocks.
-See @ref{Separate text}.
+Dialogue cues, stage directions and footnotes can be inserted, see
+@ref{Creating footnotes} and @ref{Text}. Extensive stage directions
+can also be added with a section of stand-alone markups between two
+@code{\score} blocks, see @ref{Separate text}.
@end itemize
@rglos{transposing instrument}.
Notation Reference:
+@ref{Creating footnotes},
@ref{Grouping staves},
@ref{Hiding staves},
@ref{Instrument transpositions},
Extending LilyPond:
@rextend{Markup construction in Scheme}.
+
@node Musical cues
@unnumberedsubsubsec Musical cues
c4. g8
% position name of cue-ing instrument just before the cue notes,
% and above the staff
- s1*0^\markup { \right-align { \tiny "Flute" } }
+ \new CueVoice {
+ \override InstrumentSwitch.self-alignment-X = #RIGHT
+ \set instrumentCueName = "Flute"
+ }
\cueDuring "flute" #UP { g4 bes4 }
}
pianoLH = \relative c { c4 <c' e> e, <g c> }
specify its key so the conversion of its cue notes will be done
automatically. The example below shows this transposition for a
B-flat clarinet. The notes in this example are low on the staff so
-@code{#DOWN} is specified in @code{\cueDuring} (so the stems are
+@code{DOWN} is specified in @code{\cueDuring} (so the stems are
down) and the instrument name is positioned below the staff. Note
also that the piano right-hand voice is explicitly declared. This
is because the cue notes in this example begin at the start of the
pianoRH = \relative c'' {
\transposition c'
% position name of cue-ing instrument below the staff
- s1*0_\markup { \right-align { \tiny "Clar." } }
+ \new CueVoice {
+ \override InstrumentSwitch.self-alignment-X = #RIGHT
+ \override InstrumentSwitch.direction = #DOWN
+ \set instrumentCueName = "Clar."
+ }
\cueDuring "clarinet" #DOWN { c4. g8 }
g4 bes4
}
and to make the piano notes clearer.
@snippets
-@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
+@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
{adding-orchestral-cues-to-a-vocal-score.ly}
@seealso
\score {
<<
\new Lyrics \with {
- \override LyricText #'font-shape = #'italic
- \override LyricText #'self-alignment-X = #LEFT
+ \override LyricText.font-shape = #'italic
+ \override LyricText.self-alignment-X = #LEFT
}
{ \dialogue }
\new Staff {
with the rhythm being taken from the spoken rhythm of the words.
@lilypond[verbatim,quote]
-stemOff = { \override Staff.Stem #'transparent = ##t }
+stemOff = { \override Staff.Stem.transparent = ##t }
\relative c' {
\stemOff
\layout {
\context {
\Staff
- \remove Bar_engraver
+ \remove "Bar_engraver"
}
}
}
\score {
\new ChoirStaff <<
\new Staff
- \with { \remove Bar_engraver } {
+ \with { \remove "Bar_engraver" } {
\relative c'' {
a4 b c2 |
a4 b c2 |
\bar "'"
a4 b c2
a4 b c2
-\bar ":"
+\bar ";"
a4 b c2
-\bar "dashed"
+\bar "!"
a4 b c2
\bar "||"
@end lilypond
@lilypond[verbatim,quote]
divisioMinima = {
- \once \override BreathingSign #'stencil = #ly:breathing-sign::divisio-minima
- \once \override BreathingSign #'Y-offset = #0
+ \once \override BreathingSign.stencil = #ly:breathing-sign::divisio-minima
+ \once \override BreathingSign.Y-offset = #0
\breathe
}
divisioMaior = {
- \once \override BreathingSign #'stencil = #ly:breathing-sign::divisio-maior
- \once \override BreathingSign #'Y-offset = #0
+ \once \override BreathingSign.stencil = #ly:breathing-sign::divisio-maior
+ \once \override BreathingSign.Y-offset = #0
\breathe
}
divisioMaxima = {
- \once \override BreathingSign #'stencil = #ly:breathing-sign::divisio-maxima
- \once \override BreathingSign #'Y-offset = #0
+ \once \override BreathingSign.stencil = #ly:breathing-sign::divisio-maxima
+ \once \override BreathingSign.Y-offset = #0
\breathe
}
finalis = {
- \once \override BreathingSign #'stencil = #ly:breathing-sign::finalis
- \once \override BreathingSign #'Y-offset = #0
+ \once \override BreathingSign.stencil = #ly:breathing-sign::finalis
+ \once \override BreathingSign.Y-offset = #0
\breathe
}
\layout {
\context {
\Staff
- \remove Bar_engraver
+ \remove "Bar_engraver"
}
}
}
\layout {
\context {
\Staff
- \remove Bar_engraver
- \remove Time_signature_engraver
- \remove Clef_engraver
+ \remove "Bar_engraver"
+ \remove "Time_signature_engraver"
+ \remove "Clef_engraver"
}
}
}
\layout {
\context {
\Score
- \override SpacingSpanner
- #'base-shortest-duration = #(ly:make-moment 1 2)
+ \override SpacingSpanner.base-shortest-duration = #(ly:make-moment 1 2)
}
\context {
\Staff
@snippets
-@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
+@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
{chant-or-psalms-notation.ly}
Canticles and other liturgical texts may be set more freely, and
are spaced in accordance with the syllables rather than the notes'
durations.
-@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
+@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
{ancient-notation-template----modern-transcription-of-gregorian-music.ly}
@seealso
Learning Manual:
@rlearning{Visibility and color of objects},
-@rlearning{Vocal ensembles}.
+@rlearning{Vocal ensembles templates}.
Notation Reference:
@ref{Ancient notation},
described in @ref{Formatting text}.
Most of these elements are shown in one or other of the two verses
-in the template, see @qq{Psalms} in @rlearning{Vocal ensembles}.
+in the template, see @rlearning{Psalms}.
@seealso
Learning Manual:
-@rlearning{Vocal ensembles}.
+@rlearning{Psalms},
+@rlearning{Vocal ensembles templates}.
Notation Reference:
@ref{Fonts},
the start of the music and @code{\bar "|"} or @code{\bar "||"}
commands at the end of each line.
-@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
+@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
{hymn-template.ly}