]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/user/examples.itely
Fix some bugs in the dynamic engraver and PostScript backend
[lilypond.git] / Documentation / user / examples.itely
index 0aec22978186b74376a250864903ce00687bbeb7..9bb3dede2af22e9ff3bc89035c8a1f3962271d54 100644 (file)
@@ -1,6 +1,6 @@
 @c -*- coding: utf-8; mode: texinfo; -*-
 @node Example templates
-@chapter Example templates
+@appendix Example templates
 
 This section of the manual contains templates with the LilyPond score
 already set up for you.  Just add notes, run LilyPond, and enjoy
@@ -14,21 +14,20 @@ beautiful printed scores!
 * Vocal ensembles::             
 * Ancient notation templates::  
 * Jazz combo::                  
-* Other templates::             
 * Lilypond-book templates::     
 @end menu
 
 
 @node Single staff
-@section Single staff
-@subsection Notes only
+@appendixsec Single staff
+@appendixsubsec Notes only
 
 The first example gives you a staff with notes, suitable for a solo
 instrument or a melodic fragment.  Cut and paste this into a file,
 add notes, and you're finished!
 
 @lilypond[quote,verbatim,ragged-right]
-\version "2.7.32"
+\version "2.7.39"
 melody = \relative c' {
    \clef treble
    \key c \major
@@ -44,7 +43,7 @@ melody = \relative c' {
 }
 @end lilypond
 
-@subsection Notes and lyrics
+@appendixsubsec Notes and lyrics
 
 The next example demonstrates a simple melody with lyrics.  Cut and
 paste, add notes, then words for the lyrics.  This example turns off
@@ -53,7 +52,7 @@ automatic beaming, you'll have to change or comment out the relevant
 line.
 
 @lilypond[quote,verbatim,ragged-right]
-\version "2.7.32"
+\version "2.7.39"
 melody = \relative c' {
    \clef treble
    \key c \major
@@ -79,12 +78,12 @@ text = \lyricmode {
 }
 @end lilypond
 
-@subsection Notes and chords
+@appendixsubsec Notes and chords
 
 Want to prepare a lead sheet with a melody and chords?  Look no further!
 
 @lilypond[quote,verbatim,ragged-right]
-\version "2.7.32"
+\version "2.7.39"
 melody = \relative c' {
    \clef treble
    \key c \major
@@ -112,12 +111,12 @@ harmonies = \chordmode {
 }
 @end lilypond
 
-@subsection Notes, lyrics, and chords.
+@appendixsubsec Notes, lyrics, and chords.
 
 This template allows you to prepare a song with melody, words, and chords.
 
 @lilypond[quote,verbatim,ragged-right]
-\version "2.7.32"
+\version "2.7.39"
 melody = \relative c' {
    \clef treble
    \key c \major
@@ -152,13 +151,13 @@ harmonies = \chordmode {
 @end lilypond
 
 @node Piano templates
-@section Piano templates
-@subsection Solo piano
+@appendixsec Piano templates
+@appendixsubsec Solo piano
 
 Here is a simple piano staff.
 
 @lilypond[quote,verbatim,ragged-right]
-\version "2.7.32"
+\version "2.7.39"
 upper = \relative c'' {
    \clef treble
    \key c \major
@@ -186,13 +185,13 @@ lower = \relative c {
 }
 @end lilypond
 
-@subsection Piano and melody with lyrics
+@appendixsubsec Piano and melody with lyrics
 
 Here is a typical song format: one staff with the melody and lyrics, with
 piano accompaniment underneath.
 
 @lilypond[quote,verbatim,ragged-right]
-\version "2.7.32"
+\version "2.7.39"
 melody = \relative c'' {
    \clef treble
    \key c \major
@@ -242,13 +241,13 @@ lower = \relative c {
 @end lilypond
 
 
-@subsection Piano centered lyrics
+@appendixsubsec Piano centered lyrics
 
 Instead of having a full staff for the melody and lyrics, you can place
 the lyrics between the piano staff (and omit the separate melody staff).
 
 @lilypond[quote,verbatim,ragged-right]
-\version "2.7.32"
+\version "2.7.39"
 upper = \relative c'' {
    \clef treble
    \key c \major
@@ -287,7 +286,7 @@ text = \lyricmode {
 @end lilypond
 
 
-@subsection Piano centered dynamics
+@appendixsubsec Piano centered dynamics
 
 Many piano scores have the dynamics centered between the two
 staffs.  This requires a bit of tweaking to implement, but
@@ -295,7 +294,7 @@ since the template is right here, you don't have to do the
 tweaking yourself.
 
 @lilypond[quote,verbatim,ragged-right]
-\version "2.7.32"
+\version "2.7.39"
 upper = \relative c'' {
   \clef treble
   \key c \major
@@ -385,14 +384,14 @@ pedal = {
 
 
 @node String quartet
-@section String quartet
-@subsection String quartet
+@appendixsec String quartet
+@appendixsubsec String quartet
 
 This template demonstrates a string quartet.  It also uses a @code{\global}
 section for time and key signatures.
 
 @lilypond[quote,verbatim,ragged-right]
-\version "2.7.32"
+\version "2.7.39"
 
 global= {
   \time 4/4
@@ -438,7 +437,7 @@ cello = \new Voice { \relative c' {
 }
 @end lilypond
 
-@subsection String quartet parts
+@appendixsubsec String quartet parts
 
 The previous example produces a nice string quartet, but what if you
 needed to print parts?  This template demonstrates how to use the
@@ -452,7 +451,7 @@ contains all the music definitions.  The other files -- @code{score.ly},
 
 @verbatim
 %%%%% piece.ly
-\version "2.7.32"
+\version "2.7.39"
 
 global= {
   \time 4/4
@@ -488,17 +487,17 @@ Cello = \new Voice { \relative c' {
 
 music = {
   <<
-    \tag #'(score vn1) \new Staff { << \global \Violinone >> }
-    \tag #'(score vn2) \new Staff { << \global \Violintwo>> }
-    \tag #'(score vla) \new Staff { << \global \Viola>> }
-    \tag #'(score vlc) \new Staff { << \global \Cello>> }
+    \tag #'score \tag #'vn1 \new Staff { << \global \Violinone >> }
+    \tag #'score \tag #'vn2 \new Staff { << \global \Violintwo>> }
+    \tag #'score \tag #'vla \new Staff { << \global \Viola>> }
+    \tag #'score \tag #'vlc \new Staff { << \global \Cello>> }
   >>
 }
 
 
 
 %%%%% score.ly
-\version "2.7.32"
+\version "2.7.39"
 \include "piece.ly"
 #(set-global-staff-size 14)
 \score {
@@ -509,36 +508,36 @@ music = {
 
 
 %%%%% vn1.ly
-\version "2.7.32"
+\version "2.7.39"
 \include "piece.ly"
-\score { 
+\score {
   \keepWithTag #'vn1 \music
   \layout { }
 }
 
 
 %%%%% vn2.ly
-\version "2.7.32"
+\version "2.7.39"
 \include "piece.ly"
-\score { 
+\score {
   \keepWithTag #'vn2 \music
   \layout { }
 }
 
 
 %%%%% vla.ly
-\version "2.7.32"
+\version "2.7.39"
 \include "piece.ly"
-\score { 
+\score {
   \keepWithTag #'vla \music
   \layout { }
 }
 
 
 %%%%% vlc.ly
-\version "2.7.32"
+\version "2.7.39"
 \include "piece.ly"
-\score { 
+\score {
   \keepWithTag #'vlc \music
   \layout { }
 }
@@ -546,9 +545,9 @@ music = {
 
 
 @node Vocal ensembles
-@section Vocal ensembles
+@appendixsec Vocal ensembles
 
-@subsection SATB vocal score
+@appendixsubsec SATB vocal score
 
 Here is a standard four-part SATB vocal score.  With larger ensembles,
 it's often useful to include a section which is included in all
@@ -556,7 +555,7 @@ parts.  For example, the time signature and key signatures are almost
 always the same for all parts.
 
 @lilypond[quote,verbatim,ragged-right]
-\version "2.7.32"
+\version "2.7.39"
 global = {
    \key c \major
    \time 4/4
@@ -628,7 +627,7 @@ bassWords = \lyricmode {
 @end lilypond
 
 
-@subsection SATB vocal score and automatic piano reduction
+@appendixsubsec SATB vocal score and automatic piano reduction
 
 This template adds an automatic piano reduction to the SATB vocal
 score.  This demonstrates one of the strengths of LilyPond -- you
@@ -637,7 +636,7 @@ to the vocal notes (say, tenorMusic), then the changes will also
 apply to the piano reduction.
 
 @lilypond[quote,verbatim,ragged-right]
-\version "2.7.32"
+\version "2.7.39"
 global = {
    \key c \major
    \time 4/4
@@ -727,9 +726,9 @@ bassWords = \lyricmode {
 
 @c bad node name to avoid node name confict
 @node Ancient notation templates
-@section Ancient notation templates
+@appendixsec Ancient notation templates
 
-@subsection Transcription of mensural music
+@appendixsubsec Transcription of mensural music
 
 When transcribing mensural music, an incipit at the beginning of the
 piece is useful to indicate the original key and tempo.  While today
@@ -740,7 +739,7 @@ notes.  As a compromise, bar lines are often printed between the
 staves rather than on the staves.
 
 @lilypond[quote,verbatim,line-width=11.0\cm]
-\version "2.7.32"
+\version "2.7.39"
 
 global = {
   \set Score.skipBars = ##t
@@ -926,7 +925,7 @@ bassusLyrics = \lyricmode {
 
 \score {
   \new StaffGroup = choirStaff <<
-    \Voice =
+    \new Voice =
       "discantusNotes" << \global \discantusNotes >>
     \new Lyrics =
       "discantusLyrics" \lyricsto discantusNotes { \discantusLyrics }
@@ -958,9 +957,57 @@ bassusLyrics = \lyricmode {
 @end lilypond
 
 
+@appendixsubsec Gregorian transcription template
+
+This example demonstrates how to do modern transcription of Gregorian
+music.  Gregorian music has no measure, no stems; it uses only half and
+quarter noteheads, and special marks, indicating rests of different length.
+
+@lilypond[quote,verbatim,ragged-right]
+\include "gregorian-init.ly"
+\version "2.8.0"
+
+chant = \relative c' {
+  \set Score.timing = ##f
+  f4 a2 \divisioMinima
+  g4 b a2 f2 \divisioMaior
+  g4( f) f( g) a2 \finalis
+}
+
+verba = \lyricmode {
+  Lo -- rem ip -- sum do -- lor sit a -- met
+}
+
+\score {
+  \new Staff <<
+    \new Voice = "melody" {
+      \chant
+    }
+    \new Lyrics = "one" \lyricsto melody \verba
+  >>
+
+  \layout {
+    \context {
+      \Staff
+      \remove "Time_signature_engraver"
+      \remove "Bar_engraver"
+      \override Stem #'transparent = ##t
+    }
+    \context {
+      \Voice
+      \override Stem #'length = #0
+    }
+    \context {
+      \Score
+      barAlways = ##t
+    }
+  }
+}
+@end lilypond
+
 
 @node Jazz combo
-@section Jazz combo
+@appendixsec Jazz combo
 
 This is a much more complicated template, for a jazz ensemble.  Note that all
 instruments are notated in @code{\key c \major}.  This refers to the key in
@@ -978,15 +1025,19 @@ is within a @code{\transpose} section.
 @c The `line-width' argument is for the \header.
 
 @lilypond[quote,verbatim,ragged-right,line-width]
-\version "2.7.32"
+\version "2.7.39"
 \header {
   title = "Song"
   subtitle = "(tune)"
   composer = "Me"
   meter = "moderato"
   piece = "Swing"
-  tagline = "LilyPond example file by Amelie Zapf,
-             Berlin 07/07/2003"
+  tagline = \markup {
+    \column {
+      "LilyPond example file by Amelie Zapf,"
+      "Berlin 07/07/2003"
+    }
+  }
   texidoc = "Jazz tune for combo
              (horns, guitar, piano, bass, drums)."
 }
@@ -1034,7 +1085,7 @@ trumpet = {
   \global
   \set Staff.instrument = #"Trumpet"
   \clef treble
-  \new Staff <<
+  <<
     \trpt
   >>
 }
@@ -1051,7 +1102,7 @@ altosax = {
   \global
   \set Staff.instrument = #"Alto Sax"
   \clef treble
-  \new Staff <<
+  <<
     \alto
   >>
 }
@@ -1068,7 +1119,7 @@ barisax = {
   \global
   \set Staff.instrument = #"Bari Sax"
   \clef treble
-  \new Staff <<
+  <<
     \bari
   >>
 }
@@ -1085,7 +1136,7 @@ trombone = {
   \global
   \set Staff.instrument = #"Trombone"
   \clef bass
-  \new Staff <<
+  <<
     \tbone
   >>
 }
@@ -1105,7 +1156,7 @@ guitar = {
   \global
   \set Staff.instrument = #"Guitar"
   \clef treble
-  \new Staff <<
+  <<
     \gtr
   >>
 }
@@ -1137,7 +1188,7 @@ PianoRH = {
   \clef treble
   \global
   \set Staff.midiInstrument = "acoustic grand"
-  \new Staff <<
+  <<
     \new Voice = "one" \rhUpper
     \new Voice = "two" \rhLower
   >>
@@ -1146,14 +1197,14 @@ PianoLH = {
   \clef bass
   \global
   \set Staff.midiInstrument = "acoustic grand"
-  \new Staff <<
+  <<
     \new Voice = "one" \lhUpper
     \new Voice = "two" \lhLower
   >>
 }
 
 piano = {
-  \new PianoStaff <<
+  <<
     \set PianoStaff.instrument = #"Piano"
     \new Staff = "upper" \PianoRH
     \new Staff = "lower" \PianoLH
@@ -1169,7 +1220,7 @@ bass = {
   \global
   \set Staff.instrument = #"Bass"
   \clef bass
-  \new Staff <<
+  <<
     \Bass
   >>
 }
@@ -1210,7 +1261,7 @@ drumContents = {
     \new StaffGroup = "rhythm" <<
       \new ChordNames = "chords" \gtrharmony
       \new Staff = "guitar" \guitar
-      \new PianoStaff = piano" \piano
+      \new PianoStaff = "piano" \piano
       \new Staff = "bass" \bass
       \new DrumStaff { \drumContents }
     >>
@@ -1230,9 +1281,15 @@ drumContents = {
 }
 @end lilypond
 
-@node Other templates
-@section Other templates
-@subsection All headers
+@ignore
+
+This isn't very useful, and only duplicates material in
+"global issues".  And if this info changes, this section often
+gets forgotten.
+
+@no de Other templates
+@se ction Other templates
+@su bsection All headers
 
 This template displays all available headers.  Some of them are only
 used in the Mutopia project; they don't affect the printed output at
@@ -1243,8 +1300,8 @@ violin concerto as TchaikovskyPI, whereas perhaps you wish to print
 "Petr Tchaikowski" on your music.
 
 @ The `line-width' is for \header.
-@lilypond[quote,verbatim,ragged-right,line-width]
-\version "2.7.32"
+@li lypond[quote,verbatim,ragged-right,line-width]
+\version "2.7.39"
 \header {
   dedication = "dedication"
   title = "Title"
@@ -1290,43 +1347,16 @@ violin concerto as TchaikovskyPI, whereas perhaps you wish to print
   }
 }
 @end lilypond
-
-@subsection Gregorian template
-
-This example demonstrates how to do modern transcriptions of Gregorian
-music.  Gregorian music has no measure, no stems; it uses only half and
-quarter notes, and two types of barlines, a short one indicating a rest,
-and a second one indicating a breath mark.
-
-@lilypond[quote,verbatim,ragged-right]
-barOne = { \once \override Staff.BarLine #'bar-size = #2
-  \bar "|" }
-barTwo = { \once \override Staff.BarLine #'extra-offset = #'(0 . 2)
-  \once \override Staff.BarLine #'bar-size = #2
-  \bar "|" }
-chant = \relative c' {
-  \set Score.timing = ##f
-  \override Staff.Stem #'transparent = ##t
-
-  f4 a2 \barTwo
-  g4 a2 f2 \barOne
-  g4( f) f( g) a2
-}
-\score {
-  \chant
-  \layout{ }
-  \midi { \tempo 4=60 }
-}
-@end lilypond
+@end ignore
 
 
 @node Lilypond-book templates
-@section Lilypond-book templates
+@appendixsec Lilypond-book templates
 
 These templates are for use with @code{lilypond-book}.  If you're not familiar
 with this program, please refer to @ref{LilyPond-book}.
 
-@subsection LaTeX
+@appendixsubsec LaTeX
 
 You can include LilyPond fragments in a LaTeX document.
 
@@ -1353,7 +1383,7 @@ d4 c b a
 \end@{document@}
 @end example
 
-@subsection Texinfo
+@appendixsubsec Texinfo
 
 You can include LilyPond fragments in Texinfo; in fact, this entire manual
 is written in Texinfo.