]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/notation/ancient.itely
Merge branch 'stable/2.16' into staging
[lilypond.git] / Documentation / notation / ancient.itely
index 0e7d043e61be9fda52a3a46d3f48be505a76bec4..b673c586254644d6d5c0d3a4b24d14de491e7ce7 100644 (file)
@@ -8,7 +8,7 @@
     Guide, node Updating translation committishes..
 @end ignore
 
-@c \version "2.15.10"
+@c \version "2.16.0"
 
 
 @node Ancient notation
 * Ancient notation---common features::
 * Typesetting mensural music::
 * Typesetting Gregorian chant::
+* Typesetting Kievan square notation::
 * Working with ancient music---scenarios and solutions::
 @end menu
 
 
 Support for ancient notation includes features for mensural
-notation and Gregorian chant notation.  These features can be
-accessed either by modifying style properties of graphical objects
-such as note heads and rests, or by using one of the pre-defined
-contexts for mensural or Gregorian notation.
+notation, Gregorian chant notation, and Kievan square notation.
+These features can be accessed either by modifying style
+properties of graphical objects such as note heads and rests,
+or by using one of the pre-defined contexts for these styles.
 
 Many graphical objects, such as note heads and flags, accidentals,
 time signatures, and rests, provide a @code{style} property, which
@@ -444,7 +445,7 @@ mensural C clef
 @code{mensural-c1}, @code{mensural-c2},@*
 @code{mensural-c3}, @code{mensural-c4}
 @tab
-@lilypond[fragment,relative=1,notime]
+@lilypond[relative=1,notime]
   \clef "mensural-c2"
   \override NoteHead #'style = #'mensural
   c
@@ -455,7 +456,7 @@ mensural F clef
 @tab
 @code{mensural-f}
 @tab
-@lilypond[fragment,relative=1,notime]
+@lilypond[relative=1,notime]
   \clef "mensural-f"
   \override NoteHead #'style = #'mensural
   c
@@ -466,7 +467,7 @@ mensural G clef
 @tab
 @code{mensural-g}
 @tab
-@lilypond[fragment,relative=1,notime]
+@lilypond[relative=1,notime]
   \clef "mensural-g"
   \override NoteHead #'style = #'mensural
   c
@@ -478,7 +479,7 @@ neomensural C clef
 @code{neomensural-c1}, @code{neomensural-c2},@*
 @code{neomensural-c3}, @code{neomensural-c4}
 @tab
-@lilypond[fragment,relative=1,notime]
+@lilypond[relative=1,notime]
   \clef "neomensural-c2" c
 @end lilypond
 
@@ -490,7 +491,7 @@ petrucci style C clefs, for use on different staff lines
 @code{petrucci-c3}, @code{petrucci-c4},@*
 @code{petrucci-c5}
 @tab
-@lilypond[fragment,relative=1,notime]
+@lilypond[relative=1,notime]
   \clef "petrucci-c2"
   \override NoteHead #'style = #'mensural
   c
@@ -503,7 +504,7 @@ petrucci style F clefs, for use on different staff lines
 @code{petrucci-f3}, @code{petrucci-f4},@*
 @code{petrucci-f5}
 @tab
-@lilypond[fragment,relative=1,notime]
+@lilypond[relative=1,notime]
   \clef "petrucci-f3"
   \override NoteHead #'style = #'mensural
   c
@@ -514,7 +515,7 @@ petrucci style G clef
 @tab
 @code{petrucci-g}
 @tab
-@lilypond[fragment,relative=1,notime]
+@lilypond[relative=1,notime]
   \clef "petrucci-g"
   \override NoteHead #'style = #'mensural
   c
@@ -595,7 +596,7 @@ to select ancient time signatures.  Supported styles are
 @code{neomensural} style.  The following examples show the
 differences in style:
 
-@lilypond[ragged-right,fragment,relative=1,quote]
+@lilypond[ragged-right,relative=1,quote]
 {
   \textLengthOn
 
@@ -833,8 +834,10 @@ The style for accidentals and key signatures is controlled by the
 @code{glyph-name-alist} property of the grobs @code{Accidental} and
 @code{KeySignature}, respectively; e.g.:
 
-@code{\override Staff.Accidental #'glyph-name-alist =
-#alteration-mensural-glyph-name-alist}
+@example
+\override Staff.Accidental #'glyph-name-alist =
+  #alteration-mensural-glyph-name-alist
+@end example
 
 @seealso
 Music Glossary:
@@ -870,7 +873,7 @@ switched on by setting @code{suggestAccidentals} to true.
 
 @funindex suggestAccidentals
 
-@lilypond[verbatim,fragment,relative=1]
+@lilypond[verbatim,relative=1]
 fis gis
 \set suggestAccidentals = ##t
 ais bis
@@ -1106,7 +1109,7 @@ Editio Vaticana style do clef
 @code{vaticana-do1}, @code{vaticana-do2},@*
 @code{vaticana-do3}
 @tab
-@lilypond[fragment,relative=1,notime]
+@lilypond[relative=1,notime]
   \override Staff.StaffSymbol #'line-count = #4
   \override Staff.StaffSymbol #'color = #red
   \override Staff.LedgerLineSpanner #'color = #red
@@ -1122,7 +1125,7 @@ Editio Vaticana style fa clef
 @tab
 @code{vaticana-fa1}, @code{vaticana-fa2}
 @tab
-@lilypond[fragment,relative=1,notime]
+@lilypond[relative=1,notime]
   \override Staff.StaffSymbol #'line-count = #4
   \override Staff.StaffSymbol #'color = #red
   \override Staff.LedgerLineSpanner #'color = #red
@@ -1139,7 +1142,7 @@ Editio Medicaea style do clef
 @code{medicaea-do1}, @code{medicaea-do2},@*
 @code{medicaea-do3}
 @tab
-@lilypond[fragment,relative=1,notime]
+@lilypond[relative=1,notime]
   \override Staff.StaffSymbol #'line-count = #4
   \override Staff.StaffSymbol #'color = #red
   \override Staff.LedgerLineSpanner #'color = #red
@@ -1155,7 +1158,7 @@ Editio Medicaea style fa clef
 @tab
 @code{medicaea-fa1}, @code{medicaea-fa2}
 @tab
-@lilypond[fragment,relative=1,notime]
+@lilypond[relative=1,notime]
   \override Staff.StaffSymbol #'line-count = #4
   \override Staff.StaffSymbol #'color = #red
   \override Staff.LedgerLineSpanner #'color = #red
@@ -1172,7 +1175,7 @@ hufnagel style do clef
 @code{hufnagel-do1}, @code{hufnagel-do2},@*
 @code{hufnagel-do3}
 @tab
-@lilypond[fragment,relative=1,notime]
+@lilypond[relative=1,notime]
   \override Staff.StaffSymbol #'line-count = #4
   \override Staff.StaffSymbol #'color = #red
   \override Staff.LedgerLineSpanner #'color = #red
@@ -1188,7 +1191,7 @@ hufnagel style fa clef
 @tab
 @code{hufnagel-fa1}, @code{hufnagel-fa2}
 @tab
-@lilypond[fragment,relative=1,notime]
+@lilypond[relative=1,notime]
   \override Staff.StaffSymbol #'line-count = #4
   \override Staff.StaffSymbol #'color = #red
   \override Staff.LedgerLineSpanner #'color = #red
@@ -1204,7 +1207,7 @@ hufnagel style combined do/fa clef
 @tab
 @code{hufnagel-do-fa}
 @tab
-@lilypond[fragment,relative=1,notime]
+@lilypond[relative=1,notime]
   \override Staff.StaffSymbol #'color = #red
   \override Staff.LedgerLineSpanner #'color = #red
   \override Voice.Stem #'transparent = ##t
@@ -1260,8 +1263,10 @@ The style for accidentals and key signatures is controlled by the
 @code{glyph-name-alist} property of the grobs @code{Accidental} and
 @code{KeySignature}, respectively; e.g.:
 
-@code{\override Staff.Accidental #'glyph-name-alist =
-#alteration-mensural-glyph-name-alist}
+@example
+\override Staff.Accidental #'glyph-name-alist =
+  #alteration-mensural-glyph-name-alist
+@end example
 
 @seealso
 Music Glossary:
@@ -2404,6 +2409,162 @@ of the staff.
 unary music function, such that @code{\augmentum} can be intermixed
 with head prefixes in arbitrary order.
 
+@node Typesetting Kievan square notation
+@subsection Typesetting Kievan square notation
+
+@menu
+* Kievan contexts::
+* Kievan clefs::
+* Kievan note heads::
+* Kievan accidentals::
+* Kievan bar line::
+@end menu
+
+@node Kievan contexts
+@unnumberedsubsubsec Kievan contexts
+
+@cindex KievanVoiceContext
+@cindex KievanStaffContext
+
+As with Mensural and Gregorian notation, the predefined
+@code{KievanVoice} and @code{KievanStaff} contexts can be used
+to engrave a piece in square notation.  These contexts initialize
+all relevant context properties and grob properties to proper
+values, so you can immediately go ahead entering the chant:
+
+@lilypond[quote,ragged-right,verbatim]
+\score {
+  <<
+    \new KievanVoice = "melody" \transpose c c' {
+      \cadenzaOn
+       c4 c c c c2 b,\longa
+       \bar "kievan"
+    }
+    \new Lyrics \lyricsto "melody" {
+      Го -- спо -- ди по -- ми -- луй.
+    }
+  >>
+}
+@end lilypond
+
+@seealso
+Music Glossary:
+@rglos{kievan notation}.
+
+@knownissues
+LilyPond supports Kievan notation of the Synodal style, as used in
+the corpus of chantbooks printed by the Russian Holy Synod in the
+1910's and recently reprinted by the Moscow Patriarchate Publishing
+House.  LilyPond does not support the older (less common) forms of
+Kievan notation that were used in Galicia to notate Rusyn plainchant.
+
+@node Kievan clefs
+@unnumberedsubsubsec Kievan clefs
+
+@cindex clefs
+
+There is only one clef used in Kievan notation (the Tse-fa-ut Clef).
+It is used to indicate the position of @code{c}:
+
+@lilypond[quote,relative=1,notime,verbatim]
+  \clef "kievan-do"
+  \override NoteHead #'style = #'kievan
+  c
+@end lilypond
+
+@seealso
+Music Glossary:
+@rglos{kievan notation},
+@rglos{clef}.
+
+Notation Reference:
+@ref{Clef}.
+
+@node Kievan note heads
+@unnumberedsubsubsec Kievan note heads
+
+@cindex note heads, ancient
+
+For Kievan square notation, the appropriate note head style needs
+to be chosen.  This is accomplished by setting the @code{style}
+property of the @code{NoteHead} object to @code{kievan}.
+
+The Kievan final note, which usually comes at the end of a piece
+of music, may be selected by setting the duration to
+@code{\longa}.  The Kievan recitative mark, used to indicate
+the chanting of several syllables on one note, may be selected by
+setting the duration to @code{\breve}.  The following example
+demonstrates the various Kievan note heads:
+
+@lilypond[quote,fragment,ragged-right,verbatim]
+\autoBeamOff
+\cadenzaOn
+\override NoteHead #'style = #'kievan
+b'1 b'2 b'4 b'8 b'\breve b'\longa
+@end lilypond
+
+@seealso
+Music Glossary:
+@rglos{kievan notation},
+@rglos{note head}.
+
+Notation Reference:
+@ref{Note head styles}.
+
+@knownissues
+LilyPond automatically determines if the stem up or stem down
+form of a note is drawn.  When setting chant in square notation,
+however, it is customary to have the stems point in the same
+direction within a single melisma.  This can be done manually by
+setting the @code{direction} property of the @code{Stem} object.
+
+@node Kievan accidentals
+@unnumberedsubsubsec Kievan accidentals
+
+@cindex accidentals
+
+The @code{kievan} style for accidentals is selected with the
+@code{glyph-name-alist} property of the grob @code{Accidental}.
+The @code{kievan} style provides a sharp and a flat sign
+different from the default style.  There is no natural sign
+in Kievan notation.  The sharp sign is not used in Synodal music
+but may occur in earlier manuscripts.  It has been included
+primarily for the sake of compatibility.
+
+@lilypond[quote,relative=1,notime,verbatim]
+\clef "kievan-do"
+\override NoteHead #'style = #'kievan
+\override Accidental #'glyph-name-alist =
+ #alteration-kievan-glyph-name-alist
+bes' dis,
+@end lilypond
+
+@seealso
+Music Glossary:
+@rglos{kievan notation},
+@rglos{accidental}.
+
+Notation Reference:
+@ref{Accidentals},
+@ref{Automatic accidentals},
+@ref{The Feta font}
+
+@node Kievan bar line
+@unnumberedsubsubsec Kievan bar line
+
+A decorative figure is commonly placed at the end of a piece of
+Kievan notation, which may be called the Kievan final bar line.
+It can be invoked as @code{\bar "kievan"}.
+
+@lilypond[quote,relative=1,notime,verbatim]
+  \clef "kievan-do"
+  \override NoteHead #'style = #'kievan
+  c \bar "kievan"
+@end lilypond
+
+@seealso
+@ref{Bars},
+@ref{The Feta font}
 
 @node Working with ancient music---scenarios and solutions
 @subsection Working with ancient music---scenarios and solutions