Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
When revising a translation, copy the HEAD committish of the
- version that you are working on. See TRANSLATION for details.
+ version that you are working on. For details, see the Contributors'
+ Guide, node Updating translation committishes..
@end ignore
-@c \version "2.12.0"
+@c \version "2.17.25"
@ignore
Tutorial guidelines: (different from policy.txt!)
on one staff.
@menu
+* Bar lines and bar checks::
* Accidentals and key signatures::
* Ties and slurs::
* Articulation and dynamics::
@end menu
+@node Bar lines and bar checks
+@subsection Bar lines and bar checks
+
+@subheading Bar lines
+
+Single bar lines are automatically placed in the music so
+there is no need to add them manually. Other types of bar
+lines are added using @code{\bar}, for example
+@code{\bar "||"} for a double bar line, or @code{\bar "|."}
+for an ending bar line. For a full list of bar lines see
+the @ruser{Bar lines}.
+
+@lilypond[verbatim,quote,relative=2]
+g1 e1 \bar "||" c2. c'4 \bar "|."
+@end lilypond
+
+@subheading Bar checks
+
+Though not strictly necessary, @emph{bar checks} should be
+used in the input code to show where bar lines are expected
+to fall. They are entered using the bar symbol, @code{|}.
+With bar checks, the program can verify that you've entered
+durations that make each measure add up to the correct
+length. Bar checks also make your input code easier to
+read, since they help to keep things organized.
+
+@lilypond[verbatim,quote,relative=2]
+g1 | e1 | c2. c'4 | g4 c g e | c4 r r2 |
+@end lilypond
+
+@seealso
+Notation Reference:
+@ruser{Bar and bar number checks}.
+
+
@node Accidentals and key signatures
@subsection Accidentals and key signatures
@notation{accidentals}, see @ruser{Note names in other languages}.
@lilypond[verbatim,quote,relative=2]
-cis1 ees fisis, aeses
+cis4 ees fisis, aeses
@end lilypond
@cindex key signature, setting
@lilypond[verbatim,quote,relative=2]
\key d \major
-a1
+a1 |
\key c \minor
-a
+a1 |
@end lilypond
@smallspace
Music Glossary: @rglos{accidental}, @rglos{key signature},
@rglos{pitch}, @rglos{flat}, @rglos{natural}, @rglos{sharp},
-@rglos{transposition}.
+@rglos{transposition}, @rglos{Pitch names}.
To determine whether to print an @notation{accidental}, LilyPond
examines the pitches and the @notation{key signature}. The key
note's @notation{pitch}! This is a feature that often causes
confusion to newcomers, so let us explain it in more detail.
-LilyPond makes a sharp distinction between musical content and
+LilyPond makes a clear distinction between musical content and
layout. The alteration (@notation{flat}, @notation{natural sign} or
@notation{sharp}) of a note is part of the pitch, and is therefore
musical content. Whether an accidental (a @emph{printed} flat,
@lilypond[verbatim,quote,relative=2]
\key d \major
-d cis fis
+cis4 d e fis
@end lilypond
@noindent
@lilypond[verbatim,quote,relative=2]
\key aes \major
-b
+aes4 c b c
@end lilypond
If the above seems confusing, consider this: if you were playing a
piano, which key would you hit? If you would press a black key,
-then you @emph{must} add @code{-is} or @code{-es} to the note
+then you @emph{must} add @w{@code{-is}} or @w{@code{-es}} to the note
name!
Adding all alterations explicitly might require a little more
@seealso
-Notation Reference: @ruser{Note names in other languages},
-@ruser{Accidentals}, @ruser{Automatic accidentals},
+Notation Reference:
+@ruser{Note names in other languages},
+@ruser{Accidentals},
+@ruser{Automatic accidentals},
@ruser{Key signature}.
-Music Glossary: @rglos{Pitch names}.
-
@node Ties and slurs
@subsection Ties and slurs
first note being tied.
@lilypond[verbatim,quote,relative=2]
-g4~ g c2~
-c4 ~ c8 a8 ~ a2
+g4~ g c2~ | c4~ c8 a~ a2 |
@end lilypond
@subheading Slurs
simultaneous slurs or simultaneous phrasing slurs.
@lilypond[verbatim,quote,relative=2]
-a8(\( ais b c) cis2 b'2 a4 cis,\)
+g4\( g8( a) b( c) b4\)
@end lilypond
@smallspace
larger groups of notes. Slurs and ties can be nested.
@lilypond[verbatim,quote,relative=2]
-c2~( c8 fis fis4 ~ fis2 g2)
+c4~( c8 d~ d4 e)
@end lilypond
@seealso
-Notation Reference: @ruser{Ties}, @ruser{Slurs},
+Notation Reference:
+@ruser{Ties},
+@ruser{Slurs},
@ruser{Phrasing slurs}.
dash @code{-} and a single character:
@lilypond[verbatim,quote,relative=2]
-c-. c-- c-> c-^ c-+ c-_
+c4-^ c-+ c-- c-!
+c4-> c-. c2-_
@end lilypond
@subheading Fingerings
using a dash (@code{-}) and the digit to be printed:
@lilypond[verbatim,quote,relative=2]
-c-3 e-5 b-2 a-1
+c4-3 e-5 b-2 a-1
@end lilypond
Articulations and fingerings are usually placed automatically, but
to let LilyPond determine the articulation directions.
@lilypond[verbatim,quote,relative=2]
-c_-^1 d^. f^4_2-> e^-_+
+c4_-^1 d^. f^4_2-> e^-_+
@end lilypond
@subheading Dynamics
backslash) to the note:
@lilypond[verbatim,quote,relative=2]
-c\ff c\mf c\p c\pp
+c4\ff c\mf c\p c\pp
@end lilypond
@code{\!} can be used:
@lilypond[verbatim,quote,relative=2]
-c2\< c2\ff\> c2 c2\!
+c4\< c\ff\> c c\!
@end lilypond
@seealso
-Notation Reference: @ruser{Articulations and ornamentations},
-@ruser{Fingering instructions}, @ruser{Dynamics}.
+Notation Reference:
+@ruser{Articulations and ornamentations},
+@ruser{Fingering instructions},
+@ruser{Dynamics}.
@node Adding text
Text may be added to your scores:
@lilypond[verbatim,quote,relative=2]
-c1^"espr" a_"legato"
+c2^"espr" a_"legato"
@end lilypond
Extra formatting may be added with the @code{\markup} command:
@lilypond[verbatim,quote,relative=2]
-c1^\markup{ \bold espr}
-a1_\markup{
+c2^\markup { \bold espr }
+a2_\markup {
\dynamic f \italic \small { 2nd } \hspace #0.1 \dynamic p
}
@end lilypond
@seealso
-Notation Reference: @ruser{Writing text}.
+Notation Reference:
+@ruser{Writing text}.
@node Automatic and manual beams
to be beamed with @code{[} and the last one with @code{]}.
@lilypond[verbatim,quote,relative=2]
-a8[ ais] d[ ees r d] a b
+a8[ ais] d[ ees r d] c16 b a8
@end lilypond
If you want to turn off automatic beaming entirely or for an
@lilypond[verbatim,quote,relative=2]
\autoBeamOff
-a8 c b4 d8. c16 b4
+a8 c b4 d8. c16 b4 |
\autoBeamOn
-a8 c b4 d8. c16 b4
+a8 c b4 d8. c16 b4 |
@end lilypond
@seealso
-Notation Reference: @ruser{Automatic beams}, @ruser{Manual beams}.
+Notation Reference:
+@ruser{Automatic beams},
+@ruser{Manual beams}.
@node Advanced rhythmic commands
is a quarter note pickup and @code{\partial 8} an eighth note.
@lilypond[verbatim,quote,relative=2]
-\partial 8
-f8 c2 d
+\partial 8 f8 |
+c2 d |
@end lilypond
@subheading Tuplets
@cindex tuplets
@cindex triplets
-@funindex \times
-@funindex times
+@funindex \tuplet
+@funindex tuplet
Music Glossary: @rglos{note value}, @rglos{triplet}.
-@notation{Tuplets} are made with the @code{\times} keyword. It
+@notation{Tuplets} are made with the @code{\tuplet} keyword. It
takes two arguments: a fraction and a piece of music. The
-duration of the piece of music is multiplied by the fraction.
-Triplets make notes occupy 2/3 of their notated duration, so a
-@notation{triplet} has 2/3 as its fraction
+fraction is the number of tuplet notes over the number
+of notes normally filling the same duration.
+For triplets, there are three notes instead of two, so
+@notation{triplets} have 3/2 as their fraction.
@lilypond[verbatim,quote,relative=2]
-\times 2/3 { f8 g a }
-\times 2/3 { c r c }
-\times 2/3 { f,8 g16[ a g a] }
-\times 2/3 { d4 a8 }
+\tuplet 3/2 { f8 g a }
+\tuplet 3/2 { c8 r c }
+\tuplet 3/2 { f,8 g16[ a g a] }
+\tuplet 3/2 { d4 a8 }
@end lilypond
@subheading Grace notes
with the keyword @code{\appoggiatura} or @code{\acciaccatura}:
@lilypond[verbatim,quote,relative=2]
-c2 \grace { a32[ b] } c2
-c2 \appoggiatura b16 c2
-c2 \acciaccatura b16 c2
+c2 \grace { a32[ b] } c2 |
+c2 \appoggiatura b16 c2 |
+c2 \acciaccatura b16 c2 |
@end lilypond
@seealso
-Notation Reference: @ruser{Grace notes}, @ruser{Tuplets},
+Notation Reference:
+@ruser{Grace notes},
+@ruser{Tuplets},
@ruser{Upbeats}.
one). The result is another music expression:
@lilypond[verbatim,quote,relative=2]
-{ { a4 g } f g }
+{ { a4 g } f4 g }
@end lilypond
@subheading Analogy: mathematical expressions
@lilypond[verbatim,quote]
\relative c'' {
<<
- { a4 g }
- { f e }
- { d b }
+ { a2 g }
+ { f2 e }
+ { d2 b }
>>
}
@end lilypond
little) space there is at the beginning of a line, but indenting
LilyPond code like this makes it much easier for humans to read.
-@warning{each note is relative to the previous note in
-the input, not relative to the @code{c''} in the initial
+@warning{each note is relative to the previous note in the input,
+only the first is relative to the @code{c''} in the initial
@code{@bs{}relative} command.}
@lilypond[verbatim,quote]
\relative c'' {
- c2 <<c e>>
- << { e f } { c <<b d>> } >>
+ c2 <<c e>> |
+ << { e2 f } { c2 <<b d>> } >> |
}
@end lilypond
@lilypond[verbatim,quote]
\relative c'' {
<<
- \new Staff { \clef treble c }
- \new Staff { \clef bass c,, }
+ \new Staff { \clef "treble" c4 }
+ \new Staff { \clef "bass" c,,4 }
>>
}
@end lilypond
@lilypond[verbatim,quote]
\relative c'' {
<<
- \new Staff { \clef treble \key d \major \time 3/4 c }
- \new Staff { \clef bass c,, }
+ \new Staff { \clef "treble" \key d \major \time 3/4 c4 }
+ \new Staff { \clef "bass" c,,4 }
>>
}
@end lilypond
@funindex GrandStaff
@funindex ChoirStaff
-Music Glossary: @rglos{brace}.
+Music Glossary:
+@rglos{brace},
+@rglos{staff},
+@rglos{system}.
Piano music is typeset in two staves connected by a
@notation{brace}.
@lilypond[verbatim,quote]
\relative c'' {
\new PianoStaff <<
- \new Staff { \time 2/4 c4 e g g, }
- \new Staff { \clef bass c,, c' e c }
+ \new Staff { \time 2/4 c4 e | g g, | }
+ \new Staff { \clef "bass" c,,4 c' | e c | }
>>
}
@end lilypond
@seealso
-Notation Reference: @ruser{Keyboard and other multi-staff
-instruments},
+Notation Reference:
+@ruser{Keyboard and other multi-staff instruments},
@ruser{Displaying staves}.
@node Combining notes into chords
@subsection Combining notes into chords
+Music Glossary: @rglos{chord}
+
@cindex chords
@cindex note durations in chords
@funindex >
@funindex < ... >
-Music Glossary: @rglos{chord}.
-
We saw earlier how notes can be combined into @notation{chords} by
indicating they are simultaneous by enclosing them in double angle
brackets. However, the normal way of indicating a chord is to
duration is placed after the closing bracket.
@lilypond[verbatim,quote,relative=2]
-r4 <c e g>4 <c f a>2
+r4 <c e g> <c f a>2
@end lilypond
Think of chords as almost equivalent to single notes:
ties with chords. They must be placed outside the angle brackets.
@lilypond[verbatim,quote,relative=2]
-r4 <c e g>8[ <c f a>]~ <c f a>2
-r4 <c e g>8( <c e g>\> <c e g>4 <c f a>\!)
+r4 <c e g>~ <c f a>2 |
+<c e g>8[ <c f a> <c e g> <c f a>]
+ <c e g>8\>[ <c f a> <c f a> <c e g>]\! |
+r4 <c e g>8.\p <c f a>16( <c e g>4-. <c f a>) |
@end lilypond
+@seealso
+Notation Reference:
+@ruser{Chorded notes}.
+
@node Single staff polyphony
@subsection Single staff polyphony
Polyphonic music in lilypond, while not difficult, uses concepts
that we haven't discussed yet, so we're not going to introduce
-them here. Instead, the following sections introduce these concepts
+them here. Instead, the following sections introduce these concepts
and explain them thoroughly.
@seealso
-Learning Manual: @ref{Voices contain music}.
+Learning Manual:
+@ref{Voices contain music}.
-Notation Reference: @ruser{Simultaneous notes}.
+Notation Reference:
+@ruser{Simultaneous notes}.
@node Songs
@section Songs
\relative c'' {
\key g \major
\time 6/8
- d4 b8 c4 a8 d4 b8 g4
+ d4 b8 c4 a8 | d4 b8 g4
}
@end lilypond
\relative c'' {
\key g \major
\time 6/8
- d4 b8 c4 a8 d4 b8 g4
+ d4 b8 c4 a8 | d4 b8 g4
}
\addlyrics {
- Girls and boys come out to play,
+ Girls and boys come | out to play,
}
>>
@end lilypond
-Note the curly brackets delimiting both the music and the lyrics.
-It is essential that the final syllable is separated from the
-terminating curly bracket by a space or a newline, or it will be
-assumed to be part of the syllable, giving rise to an obscure
-error, see @rprogram{Apparent error in ../ly/init.ly}.
-
-Note also the double angle brackets @w{@code{<< ... >>}} around the
+Note the double angle brackets @w{@code{<<@dots{}>>}} around the
whole piece to show that the music and lyrics are to occur at the
same time.
\relative c'' {
\key g \major
\time 6/8
- d4 b8 c4 a8 d4 b8 g4
- g8 a4 b8 c b a d4 b8 g4.
+ d4 b8 c4 a8 | d4 b8 g4 g8 |
+ a4 b8 c b a | d4 b8 g4. |
}
\addlyrics {
- Girls and boys come out to play,
- The moon doth shine as bright as day;
+ Girls and boys come | out to play,
+ The | moon doth shine as | bright as day; |
}
>>
@end lilypond
-We see the extra lyrics do not align properly with the notes. The
-word @notation{shine} should be sung on two notes, not one. This
-is called a @notation{melisma}, a single syllable sung to more
-than one note. There are several ways to spread a syllable over
-multiple notes, the simplest being to add a slur across them, for
-details, see @ref{Ties and slurs}:
+If you compile the code in the example above, you should see some
+warnings in the console output:
+
+@example
+song.ly:12:29: warning: barcheck failed at: 5/8
+ The | moon doth shine as
+ | bright as day; |
+song.ly:12:46: warning: barcheck failed at: 3/8
+ The | moon doth shine as | bright as day;
+ |
+@end example
+
+This is a good example of the usefulness of bar checks. Now,
+looking at the music, we see that the extra lyrics do not align
+properly with the notes. The word @notation{shine} should be sung
+on two notes, not one. This is called a @notation{melisma}, a
+single syllable sung to more than one note. There are several
+ways to spread a syllable over multiple notes, the simplest being
+to add a slur across them, for details, see @ref{Ties and slurs}:
@lilypond[verbatim,quote]
<<
\relative c'' {
\key g \major
\time 6/8
- d4 b8 c4 a8 d4 b8 g4
- g8 a4 b8 c( b) a d4 b8 g4.
+ d4 b8 c4 a8 | d4 b8 g4 g8 |
+ a4 b8 c( b) a | d4 b8 g4. |
}
\addlyrics {
- Girls and boys come out to play,
- The moon doth shine as bright as day;
+ Girls and boys come | out to play,
+ The | moon doth shine as | bright as day; |
}
>>
@end lilypond
\relative c'' {
\key g \major
\time 6/8
- d4 b8 c4 a8 d4 b8 g4
- g8 a4 b8 c([ b]) a d4 b8 g4.
+ d4 b8 c4 a8 | d4 b8 g4 g8 |
+ a4 b8 c([ b]) a | d4 b8 g4. |
}
\addlyrics {
- Girls and boys come out to play,
- The moon doth shine as bright as day;
+ Girls and boys come | out to play,
+ The | moon doth shine as | bright as day; |
}
>>
@end lilypond
\relative c'' {
\key g \major
\time 6/8
- d4 b8 c4 a8 d4 b8 g4
- g8 a4 b8 c[ b] a d4 b8 g4.
+ d4 b8 c4 a8 | d4 b8 g4 g8 |
+ a4 b8 c[ b] a | d4 b8 g4. |
}
\addlyrics {
- Girls and boys come out to play,
- The moon doth shine _ as bright as day;
+ Girls and boys come | out to play,
+ The | moon doth shine _ as | bright as day; |
}
>>
@end lilypond
\relative c'' {
\key g \minor
\time 3/2
- g2 a bes bes( a)
- b c4.( bes8 a4. g8 fis4.) g8 fis1
+ g2 a bes | bes2( a) b2 |
+ c4.( bes8 a4. g8 fis4.) g8 | fis1
}
\addlyrics {
- When I am laid,
- am laid __ in earth,
+ When I am | laid,
+ am | laid __ in | earth,
}
>>
@end lilypond
\key g \major
\time 3/4
\partial 4
- d4 g4 g a8( b) g4 g4
- b8( c) d4 d e4 c2
+ d4 | g4 g a8( b) | g4 g b8( c) |
+ d4 d e | c2
}
\addlyrics {
- A -- way in a __ man -- ger,
- no __ crib for a bed, __
+ A -- | way in a __ | man -- ger,
+ no __ | crib for a | bed, __
}
>>
@end lilypond
@lilypond[verbatim,quote,noragged-right]
<<
\relative c' {
- \clef bass
+ \clef "bass"
\key c \major
\time 6/8
- c4.~ c8 d b c([ d]) b c d b c
+ c4.~ c8 d b | c8([ d]) b c d b | c8
}
\addlyrics {
- Lar -- go_al fac -- to -- tum del -- la cit -- tà
+ Lar -- go_al fac -- | to -- tum del -- la cit -- | tà
}
>>
@end lilypond
@seealso
-Notation Reference: @ruser{Vocal music}.
+Notation Reference:
+@ruser{Vocal music}.
@node Lyrics to multiple staves
\key f \major
\time 6/8
\partial 8
- c8 c([ bes]) a a([ g]) f f'4. b, c4.~ c4
+ c8 | c8([ bes]) a a([ g]) f | f'4. b, | c4.~ c4
}
\addlyrics {
- Let flee -- cy flocks the hills a -- dorn, __
+ Let | flee -- cy flocks the | hills a -- | dorn, __
}
\relative c' {
\key f \major
\time 6/8
\partial 8
- r8 r4. r4 c8 a'([ g]) f f([ e]) d e([ d]) c bes'4
+ r8 | r4. r4 c8 | a'8([ g]) f f([ e]) d | e8([ d]) c bes'4
}
\addlyrics {
- Let flee -- cy flocks the hills a -- dorn,
+ Let | flee -- cy flocks the | hills a -- dorn,
}
>>
@end lilypond
@seealso
-Notation Reference: @ruser{Vocal music}.
+Notation Reference:
+@ruser{Vocal music}.
@node Final touches
a4 b c b
}
}
+
cello = \new Staff {
\relative c {
- \clef bass
+ \clef "bass"
e2 d
}
}
+
{
<<
\violin
section of music is repeated many times.
@lilypond[verbatim,quote]
-tripletA = \times 2/3 { c,8 e g }
+tripletA = \tuplet 3/2 { c,8 e g }
barA = { \tripletA \tripletA \tripletA \tripletA }
\relative c'' {
- \barA \barA
+ \barA \barA
}
@end lilypond
\aFivePaper
line-width = \width
@}
+
@{
c4^\name
@}
@example
\version @w{"@version{}"}
+
\header @{
title = "Symphony"
composer = "Me"
When the file is processed, the title and composer are printed
above the music. More information on titling can be found in
-@ruser{Creating titles}.
+@ruser{Creating titles headers and footers}.
@node Absolute note names
@cindex absolute note names
So far we have always used @code{\relative} to define pitches.
-This is the easiest way to enter most music, but another way of
-defining pitches exists: absolute mode.
+This is usually the fastest way to enter most music. Without
+@code{\relative}, pitches are interpreted in absolute mode.
-If you omit the @code{\relative}, LilyPond treats all pitches as
-absolute values. A @code{c'} will always mean middle C, a
-@code{b} will always mean the note one step below middle C, and a
-@code{g,} will always mean the note on the bottom staff of the
-bass clef.
+In this mode, LilyPond treats all pitches as absolute values. A
+@code{c'} will always mean middle C, a @code{b} will always mean
+the note one step below middle C, and a @code{g,} will always mean
+the note on the bottom staff of the bass clef.
@lilypond[verbatim,quote]
{
- \clef bass
- c' b g, g,
- g, f, f c'
+ \clef "bass"
+ c'4 b g, g, |
+ g,4 f, f c' |
}
@end lilypond
@lilypond[verbatim,quote]
{
- \clef bass
- c, d, e, f,
- g, a, b, c
- d e f g
- a b c' d'
- \clef treble
- e' f' g' a'
- b' c'' d'' e''
- f'' g'' a'' b''
- c'''1
+ \clef "bass"
+ c,4 d, e, f, |
+ g,4 a, b, c |
+ d4 e f g |
+ a4 b c' d' |
+ \clef "treble"
+ e'4 f' g' a' |
+ b'4 c'' d'' e'' |
+ f''4 g'' a'' b'' |
+ c'''1 |
}
@end lilypond
{
\key a \major
\time 6/8
- cis''8. d''16 cis''8 e''4 e''8
- b'8. cis''16 b'8 d''4 d''8
+ cis''8. d''16 cis''8 e''4 e''8 |
+ b'8. cis''16 b'8 d''4 d''8 |
}
@end lilypond
\relative c'' {
\key a \major
\time 6/8
- cis8. d16 cis8 e4 e8
- b8. cis16 b8 d4 d8
+ cis8. d16 cis8 e4 e8 |
+ b8. cis16 b8 d4 d8 |
}
@end lilypond
However, absolute mode is useful for music which has large
intervals, and is extremely useful for computer-generated LilyPond
-files.
+files. When cutting and pasting melody fragments, absolute mode
+preserves the original octave.
+
+Sometimes music is arranged in more complex ways. If you are
+using @code{\relative} inside of @code{\relative}, the outer and
+inner relative sections are independent:
+
+@lilypond[verbatim,quote]
+\relative c { c'4 \relative c'' { f g } c }
+@end lilypond
+@funindex \absolute
+If you are using absolute music inside of relative, you'll need to
+mark the absolute music explicitly with @code{\absolute} to stop
+it from becoming part of the relative music:
+@lilypond[verbatim,quote]
+\relative c { c'4 \absolute { f'' g'' } c }
+@end lilypond
@node After the tutorial
@subsection After the tutorial
Learning Manual, you may want to read some sections again and follow
cross-references for further reading.
-If you have not done so already, @emph{please} read
-FIXME FIXME FIXME
-@c @ref{About the documentation}.
-There is a lot of information about LilyPond, so
+If you have not done so already, @emph{please} read @ref{Overview
+of manuals}. There is a lot of information about LilyPond, so
newcomers often do not know where they should look for help. If
you spend five minutes reading that section carefully, you might
save yourself hours of frustration looking in the wrong places!
projects / lilypond.git / blobdiff