1 @c -*- coding: utf-8; mode: texinfo; -*-
4 Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. For details, see the Contributors'
8 Guide, node Updating translation committishes..
16 This section of the manual contains templates with the LilyPond score
17 already set up for you. Just add notes, run LilyPond, and enjoy
18 beautiful printed scores!
21 * Built-in templates::
22 * Single staff templates::
24 * String quartet templates::
25 * Vocal ensembles templates::
26 * Orchestral templates::
27 * Ancient notation templates::
32 @node Built-in templates
33 @appendixsec Built-in templates
35 A template, suitable for a range of choral music, is built into
36 LilyPond. This may be used to create simple choral music, with or
37 without piano accompaniment, in two or four staves. Unlike other
38 templates, this template is @q{built-in}, which means it does not
39 need to be copied and edited: instead it is simply
40 @code{\include}'d in the input file.
42 @warning {Unlike most included files, this built-in template must be
43 @code{\include}'d at the @emph{end} of the input file.}
45 The required music expressions are entered by defining values for
46 specific variables. These definition must come before the
47 @code{\include}'d file.
49 The music may be set out with one or two voices per staff by setting
50 @code{TwoVoicesPerStaff} to @code{##f} or @code{##t} respectively.
52 Here's the complete input file for producing a full four-part SATB
53 arrangement with individual lyrics and piano accompaniment:
55 @lilypond[verbatim, quote]
56 SopranoMusic = \relative { a'4\f a8 a a4 a }
57 SopranoLyrics = \lyricmode { Sop -- ra -- no ly -- rics }
58 AltoMusic = \relative { d'4\f d d d }
59 AltoLyrics = \lyricmode { Al -- to ly -- rics }
60 TenorMusic = \relative { a4\p a a a }
61 TenorLyrics = \lyricmode { Te -- nor ly -- rics }
62 BassMusic = \relative { c2\p c4 c }
63 BassLyrics = \lyricmode { Bass ly -- rics }
64 PianoRHMusic = \relative { c' e g c }
65 PianoDynamics = { s2\mp s4 s4 }
66 PianoLHMusic = \relative { c e g c }
70 The same input can be used to produce a score with two voices
71 per staff just by setting @code{TwoVoicesPerStaff} to @code{##t}.
72 Again, each voice has individual lyrics.
75 @lilypond[verbatim, quote]
76 SopranoMusic = \relative { a'4\f a8 a a4 a }
77 SopranoLyrics = \lyricmode { Sop -- ra -- no ly -- rics }
78 AltoMusic = \relative { d'4\f d d d }
79 AltoLyrics = \lyricmode { Al -- to ly -- rics }
80 TenorMusic = \relative { a4\p a a a }
81 TenorLyrics = \lyricmode { Te -- nor ly -- rics }
82 BassMusic = \relative { c2\p c4 c }
83 BassLyrics = \lyricmode { Bass ly -- rics }
84 PianoRHMusic = \relative { c' e g c }
85 PianoDynamics = { s2\mp s4 s4 }
86 PianoLHMusic = \relative { c e g c }
87 TwoVoicesPerStaff = ##t
91 When @code{TwoVoicesPerStaff} is set to false or allowed to default,
92 any of the music variables may be omitted to produce arrangements
93 with fewer voices. Here, for example, is how the input file for a
94 Soprano/Bass duet might be written:
96 @lilypond[verbatim,quote]
97 SopranoMusic = \relative { c'' c c c }
98 SopranoLyrics = \lyricmode { High voice ly -- rics }
99 BassMusic = \relative { a a a a }
100 BassLyrics = \lyricmode { Low voice ly -- rics }
104 A second verse or alternative lyrics may be added to each of the
107 @lilypond[verbatim, quote]
108 SopranoMusic = \relative { a'4 a a a }
109 SopranoLyricsOne = \lyricmode {
113 SopranoLyricsTwo = \lyricmode {
120 When the lyrics and rhythms are the same for every part, the vocal
121 music is best arranged on two staves with two voices in each. Up to
122 nine verses may be provided. Here's an unaccompanied example with
125 @lilypond[verbatim, quote]
126 SopranoMusic = \relative { a' a a a }
127 AltoMusic = \relative { f' f f f }
128 VerseOne = \lyricmode {
132 VerseTwo = \lyricmode {
136 VerseThree = \lyricmode {
140 TenorMusic = \relative { a a a a }
141 BassMusic = \relative { f f f f }
142 TwoVoicesPerStaff = ##t
146 Other variables may be given values. The key signature and
147 the time signature may be changed from the default:
149 @lilypond[verbatim, quote]
153 \tempo "Allegro" 4 = 144
155 SopranoMusic = \relative { gis' gis gis gis gis }
156 AltoMusic = \relative { cis' cis cis cis cis }
157 VerseOne = \lyricmode { Words to this du -- et }
158 TwoVoicesPerStaff = ##t
162 The instrument names and/or the short instrument names may be
165 @lilypond[verbatim,quote]
166 SopranoMusic = \relative { c'' c c c }
167 SopranoLyrics = \lyricmode { High voice ly -- rics }
168 SopranoInstrumentName = "Soprano 1"
169 SopranoShortInstrumentName = "S1"
170 AltoMusic = \relative { a' a a a }
171 AltoLyrics = \lyricmode { Low voice ly -- rics }
172 AltoInstrumentName = "Soprano 2"
173 AltoShortInstrumentName = "S2"
177 A descant may be added by defining values for the variable
178 @code{DescantMusic} and descant lyrics may be provided by
179 defining values for @code{DescantLyrics}.
181 @code{\header} and @code{\paper} blocks may be added as normal.
182 A @code{\layout} block may be provided as the value of the
183 @code{Layout} variable:
186 Layout = \layout @{ ... @}
189 The complete set of variables which may be changed can be seen by
190 examining the file @file{ly/satb.ly}.
194 @ref{Organizing pieces with variables},
195 @ref{Vocal ensembles templates},
196 @ref{Extending the templates}.
199 More complex arrangements of SATB choral music are not possible with
200 these simple built-in templates.
203 @node Single staff templates
204 @appendixsec Single staff templates
210 * Notes lyrics and chords::
214 @appendixsubsec Notes only
216 @lilypondfile[verbatim,quote,ragged-right,texidoc,addversion]
217 {single-staff-template-with-only-notes.ly}
219 @node Notes and lyrics
220 @appendixsubsec Notes and lyrics
222 @lilypondfile[verbatim,quote,ragged-right,texidoc,addversion]
223 {single-staff-template-with-notes-and-lyrics.ly}
225 @node Notes and chords
226 @appendixsubsec Notes and chords
228 @lilypondfile[verbatim,quote,ragged-right,texidoc]
229 {single-staff-template-with-notes-and-chords.ly}
231 @node Notes lyrics and chords
232 @appendixsubsec Notes, lyrics, and chords
234 @lilypondfile[verbatim,quote,ragged-right,texidoc]
235 {single-staff-template-with-notes,-lyrics,-and-chords.ly}
238 @node Piano templates
239 @appendixsec Piano templates
243 * Piano and melody with lyrics::
244 * Piano centered lyrics::
248 @appendixsubsec Solo piano
250 @lilypondfile[verbatim,quote,ragged-right,texidoc]
251 {piano-template-simple.ly}
253 @node Piano and melody with lyrics
254 @appendixsubsec Piano and melody with lyrics
256 @lilypondfile[verbatim,quote,ragged-right,texidoc]
257 {piano-template-with-melody-and-lyrics.ly}
259 @node Piano centered lyrics
260 @appendixsubsec Piano centered lyrics
262 @lilypondfile[verbatim,quote,ragged-right,texidoc]
263 {piano-template-with-centered-lyrics.ly}
266 @node String quartet templates
267 @appendixsec String quartet templates
271 * String quartet parts::
275 @appendixsubsec String quartet
277 @lilypondfile[verbatim,quote,ragged-right,texidoc]
278 {string-quartet-template-simple.ly}
280 @node String quartet parts
281 @appendixsubsec String quartet parts
283 @lilypondfile[verbatim,quote,ragged-right,texidoc]
284 {string-quartet-template-with-separate-parts.ly}
287 @node Vocal ensembles templates
288 @appendixsec Vocal ensembles templates
290 The templates shown below should be copied into your score and edited
291 there. If you have a relatively simple SATB layout you may prefer to
292 use the built-in templates, which can simply be @code{\include}'d, see
293 @ref{Built-in templates}.
297 * SATB vocal score and automatic piano reduction::
298 * SATB with aligned contexts::
299 * SATB on four staves::
300 * Solo verse and two-part refrain::
305 @node SATB vocal score
306 @appendixsubsec SATB vocal score
308 @lilypondfile[verbatim,quote,ragged-right,texidoc]
309 {vocal-ensemble-template.ly}
311 @node SATB vocal score and automatic piano reduction
312 @appendixsubsec SATB vocal score and automatic piano reduction
314 @lilypondfile[verbatim,quote,ragged-right,texidoc]
315 {vocal-ensemble-template-with-automatic-piano-reduction.ly}
317 @node SATB with aligned contexts
318 @appendixsubsec SATB with aligned contexts
320 @lilypondfile[verbatim,quote,ragged-right,texidoc]
321 {vocal-ensemble-template-with-lyrics-aligned-below-and-above-the-staves.ly}
323 @node SATB on four staves
324 @appendixsubsec SATB on four staves
326 @lilypondfile[verbatim,quote,ragged-right,texidoc]
327 {satb-choir-template---four-staves.ly}
329 @node Solo verse and two-part refrain
330 @appendixsubsec Solo verse and two-part refrain
332 @lilypondfile[verbatim,quote,ragged-right,texidoc]
333 {vocal-ensemble-template-with-verse-and-refrain.ly}
336 @appendixsubsec Hymn tunes
338 @lilypondfile[verbatim,quote,ragged-right,texidoc]
342 @appendixsubsec Psalms
344 @lilypondfile[verbatim,quote,ragged-right,texidoc]
345 {anglican-psalm-template.ly}
348 @node Orchestral templates
349 @appendixsec Orchestral templates
352 * Orchestra choir and piano::
355 @node Orchestra choir and piano
356 @appendixsubsec Orchestra, choir and piano
358 @lilypondfile[verbatim,quote,ragged-right,texidoc]
359 {orchestra,-choir-and-piano-template.ly}
362 @node Ancient notation templates
363 @appendixsec Ancient notation templates
366 * Transcription of mensural music::
367 * Gregorian transcription template::
370 @node Transcription of mensural music
371 @appendixsubsec Transcription of mensural music
373 @lilypondfile[verbatim,quote,ragged-right,texidoc]
376 @node Gregorian transcription template
377 @appendixsubsec Gregorian transcription template
379 @lilypondfile[verbatim,quote,ragged-right,texidoc]
380 {ancient-notation-template----modern-transcription-of-gregorian-music.ly}
383 @node Other templates
384 @appendixsec Other templates
391 @appendixsubsec Jazz combo
393 @lilypondfile[verbatim,quote,ragged-right,texidoc]
394 {jazz-combo-template.ly}
400 This isn't very useful, and only duplicates material in
401 "global issues". And if this info changes, this section often
404 @no de Other templates
405 @se ction Other templates
406 @su bsection All headers
408 This template displays all available headers. Some of them are only
409 used in the Mutopia project; they don't affect the printed output at
410 all. They are used if you want the piece to be listed with different
411 information in the Mutopia database than you wish to have printed on the
412 music. For example, Mutopia lists the composer of the famous D major
413 violin concerto as TchaikovskyPI, whereas perhaps you wish to print
414 "Petr Tchaikowski" on your music.
416 @ The `line-width' is for \header.
417 @li lypond[quote,verbatim,ragged-right,line-width]
420 dedication = "dedication"
422 subtitle = "Subtitle"
423 subsubtitle = "Subsubtitle"
424 composer = "Composer (xxxx-yyyy)"
428 instrument = "Instrument"
429 arranger = "Arranger"
431 texttranslator = "Translator"
432 copyright = "public domain"
434 % These are headers used by the Mutopia Project
435 % http://www.mutopiaproject.org/
439 mutopiainstrument = ""
440 date = "composer's dates"
442 maintainer = "your name here"
443 maintainerEmail = "your email here"
444 maintainerWeb = "your home page"
445 lastupdated = "2004/Aug/26"