From f0f04aa3c236e9ad60ca0a3f4bf40716940b57a2 Mon Sep 17 00:00:00 2001 From: Trevor Daniels Date: Thu, 14 Oct 2010 23:30:21 +0100 Subject: [PATCH] Doc: NR 2.1 Vocal: Reposition Placement of lyrics - this is a higher level concept and should be earlier --- Documentation/notation/vocal.itely | 239 ++++++++++++++--------------- 1 file changed, 118 insertions(+), 121 deletions(-) diff --git a/Documentation/notation/vocal.itely b/Documentation/notation/vocal.itely index d18e96817d..4ecaacfdfd 100644 --- a/Documentation/notation/vocal.itely +++ b/Documentation/notation/vocal.itely @@ -673,11 +673,11 @@ Internals Reference: @menu * Working with lyrics and variables:: +* Placement of lyrics:: * Lyrics and repeats:: * Divisi lyrics:: * Lyrics independent of notes:: * Spacing out syllables:: -* Placement of lyrics:: @end menu @@ -744,6 +744,122 @@ Internals Reference: @rinternals{Lyrics}. +@node Placement of lyrics +@unnumberedsubsubsec Placement of lyrics + +@cindex placement of lyrics +@cindex lyrics, positioning + +Lyrics are positioned above the staff, below the staff, or between +staves, depending on the type of music. To place lyrics below the +associated staff simply define the Lyrics context below the Staff +context: + +@lilypond[quote,verbatim] +\score { + << + \new Staff { + \new Voice = "melody" { + \relative c'' { c4 c c c } + } + } + \new Lyrics { + \lyricsto "melody" { + Here are the words + } + } + >> +} +@end lilypond + +To position lyrics above the staff, place the declaration of the +Lyrics context before the Staff and Voice contexts, but the +@code{\lyricsto} command must come after the Voice declaration it +references, like this: + +@lilypond[quote,verbatim] +\score { + << + \new Lyrics = "lyrics" + \new Staff { + \new Voice = "melody" { + \relative c'' { c4 c c c } + } + } + \context Lyrics = "lyrics" { + \lyricsto "melody" { + Here are the words + } + } + >> +} +@end lilypond + +Alternatively, the position of the lyrics may be specified +explicitly: + +@lilypond[quote,verbatim] +\score { + << + \new Staff = "staff" { + \new Voice = "melody" { + \relative c'' { c4 c c c } + } + } + \new Lyrics \with { alignAboveContext = "staff" } { + \lyricsto "melody" { + Here are the words + } + } + >> +} +@end lilypond + +When there are two voices on separate staves the lyrics may be +placed between the staves using either of these methods. Here +is an example of the first method: + +@lilypond[quote,verbatim] +\score { + \new ChoirStaff << + \new Staff { + \new Voice = "sopranos" { + \relative c'' { c4 c c c } + } + } + \new Lyrics = "sopranos" + \new Lyrics = "contraltos" + \new Staff { + \new Voice = "contraltos" { + \relative c'' { a4 a a a } + } + } + \context Lyrics = "sopranos" { + \lyricsto "sopranos" { + Sop -- ra -- no words + } + } + \context Lyrics = "contraltos" { + \lyricsto "contraltos" { + Con -- tral -- to words + } + } + >> +} +@end lilypond + +Other combinations of lyrics and staves may be generated by +elaborating these examples, or by examining the SATB templates in +the Learning Manual. + +@seealso +Learning Manual: +@rlearning{Vocal ensembles}. + +Notation Reference: +@ref{Aligning contexts}, +@ref{Creating contexts}. + @node Lyrics and repeats @unnumberedsubsubsec Lyrics and repeats @@ -1225,12 +1341,11 @@ the implicit melismata get ignored. @c Conclusion: do not use devnull for lyrics -FV @c this clarifies http://code.google.com/p/lilypond/issues/detail?id=248 +@c see also feature request 777 - show how to do this in manual durations @node Spacing out syllables @unnumberedsubsubsec Spacing out syllables -@c TODO move to second item - @cindex Spacing lyrics @cindex Lyrics, increasing space between @@ -1314,124 +1429,6 @@ To make lyrics avoid bar lines as well, use @end ignore -@node Placement of lyrics -@unnumberedsubsubsec Placement of lyrics - -@cindex placement of lyrics -@cindex lyrics, positioning - -@c TODO Add text from -user - -Lyrics are positioned above the staff, below the staff, or between -staves, depending on the type of music. To place lyrics below the -associated staff simply define the Lyrics context below the Staff -context: - -@lilypond[quote,verbatim] -\score { - << - \new Staff { - \new Voice = "melody" { - \relative c'' { c4 c c c } - } - } - \new Lyrics { - \lyricsto "melody" { - Here are the words - } - } - >> -} -@end lilypond - -To position lyrics above the staff, place the declaration of the -Lyrics context before the Staff and Voice contexts, but the -@code{\lyricsto} command must come after the Voice declaration it -references, like this: - -@lilypond[quote,verbatim] -\score { - << - \new Lyrics = "lyrics" - \new Staff { - \new Voice = "melody" { - \relative c'' { c4 c c c } - } - } - \context Lyrics = "lyrics" { - \lyricsto "melody" { - Here are the words - } - } - >> -} -@end lilypond - -Alternatively, the position of the lyrics may be specified -explicitly: - -@lilypond[quote,verbatim] -\score { - << - \new Staff = "staff" { - \new Voice = "melody" { - \relative c'' { c4 c c c } - } - } - \new Lyrics \with { alignAboveContext = "staff" } { - \lyricsto "melody" { - Here are the words - } - } - >> -} -@end lilypond - -When there are two voices on separate staves the lyrics may be -placed between the staves using either of these methods. Here -is an example of the first method: - -@lilypond[quote,verbatim] -\score { - \new ChoirStaff << - \new Staff { - \new Voice = "sopranos" { - \relative c'' { c4 c c c } - } - } - \new Lyrics = "sopranos" - \new Lyrics = "contraltos" - \new Staff { - \new Voice = "contraltos" { - \relative c'' { a4 a a a } - } - } - \context Lyrics = "sopranos" { - \lyricsto "sopranos" { - Sop -- ra -- no words - } - } - \context Lyrics = "contraltos" { - \lyricsto "contraltos" { - Con -- tral -- to words - } - } - >> -} -@end lilypond - -Other combinations of lyrics and staves may be generated by -elaborating these examples, or by examining the SATB templates in -the Learning Manual. - -@seealso -Learning Manual: -@rlearning{Vocal ensembles}. - -Notation Reference: -@ref{Aligning contexts}, -@ref{Creating contexts}. - @node Stanzas @subsection Stanzas -- 2.39.2