Merge branch 'master' of /home/jcharles/GIT/Lily/. into translation

[lilypond.git] / Documentation / fr / notation / ancient.itely

@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-

@ignore
    Translation of GIT committish: 53cff5245f682708a6c77d580f418ece2923c2e4

    When revising a translation, copy the HEAD committish of the
    version that you are working on.  For details, see the Contributors'
    Guide, node Updating translation committishes..
@end ignore


@c \version "2.19.21"

@c Translators: Jean-Charles Malahieude

@node Notations anciennes
@section Notations anciennes
@translationof Ancient notation

@lilypondfile[quote]{ancient-headword.ly}

@cindex Vaticana, Editio
@cindex Medicaea, Editio
@cindex hufnagel
@cindex Petrucci
@cindex mensural

@menu
* Formes de notation ancienne prises en charge::
* Considérations communes aux musiques anciennes::
* Typographie de musique ancienne::
* Typographie du chant grégorien::
* Typographie de notation kiévienne::
* Réédition de musique ancienne::
@end menu

La gestion par LilyPond des formes de notation ancienne inclut des
fonctionnalités spécifiques à la notation mensurale, au chant
grégorien et à la notation de style kievien.  Ces fonctionnalités sont
accessibles en modifiant les propriétés de style des objets graphiques
tels que tête de note ou silence, ou bien grâce aux contextes prédéfinis
à cet effet.

De nombreux objets graphiques -- « grobs » dans le jargon de LilyPond
-- disposent d'une propriété @code{style}.  Manipuler cette propriété
permet d'adapter l'aspect typographique des @emph{grobs} à une forme de
notation particulière, ce qui évite la création de nouveaux concepts de
notation.  Voir à ce sujet

@itemize
@item @ref{Têtes de note anciennes},
@item @ref{Altérations et armures anciennes},
@item @ref{Silences anciens},
@item @ref{Clefs anciennes},
@item @ref{Clefs grégoriennes},
@item @ref{Crochets anciens},
@item @ref{Métriques anciennes}.
@end itemize

D'autres aspects de la notation ancienne ne peuvent pas être gérés
aussi simplement qu'en jouant sur les propriétés d'un style appliqué à
un objet graphique ou en lui ajoutant des articulations.  Certains
concepts sont spécifiques à la notation ancienne.

@itemize
@item @ref{Guidons},
@item @ref{Divisions},
@item @ref{Ligatures}.
@end itemize

@seealso
Glossaire musicologique :
@rglos{custos},
@rglos{ligature},
@rglos{mensural notation}.

Manuel de notation :
@ref{Têtes de note anciennes},
@ref{Altérations et armures anciennes},
@ref{Silences anciens},
@ref{Clefs grégoriennes},
@ref{Crochets anciens},
@ref{Métriques anciennes},
@ref{Guidons},
@ref{Divisions},
@ref{Ligatures}.


@node Formes de notation ancienne prises en charge
@unnumberedsubsubsec Formes de notation ancienne prises en charge
@translationof Overview of the supported styles

En matière de chant grégorien, LilyPond dispose de trois différents
styles :

@itemize
@item @emph{Editio Vaticana} constitue un style à part entière dédié au
chant grégorien, le plus approchant possible des éditions de Solesmes,
éditeur officiel du Vatican depuis 1904. LilyPond dispose de tous les
signes de notation propres à ce style, y compris les ligatures, custodes
et certaines spécificités comme le quilisma et l'oriscus.

@cindex Solesmes
@cindex Vaticana, Editio

@item @emph{Editio Medicaea} dispose d'un certain nombre de
spécificités des éditions qui faisaient autorité avant Solesmes.  On
le connaît aussi sous le nom de Ratisbone.  Ce qui le distingue le
plus du style @emph{Vaticana} réside dans les clefs, en forme de barres
obliques, et les têtes de note, plus carrées et régulières.

@cindex Ratisbona, Editio
@cindex Medicaea, Editio

@item Le style @emph{Hufnagel} (« clou de fer à cheval ») ou
@emph{gothique} imite le style des manuscrits médiévaux d'Allemagne et
d'Europe centrale.  Il tire son nom de l'allure des notes (en virgule ou
@emph{virga}) qui ressemblent à des têtes de clou.

@cindex hufnagel
@end itemize

LilyPond dispose de trois styles imitant les manuscrits du Bas Moyen Âge
et de la Renaissance ainsi que les premières impressions de musique
mesurée.

@itemize
@item Le style @emph{Mensural} est celui qui se rapproche le plus des
manuscrits de la période allant de la fin du Moyen Âge au début de la
Renaissance, avec ses petites têtes de note en forme de losange étroit
et ses silences comme dessinés à main levée.

@cindex mensural

@item Le style @emph{Neomensural} est une version moderne et stylisée du
style mensural : les têtes de note sont un peu plus galbées et les
silences plus rectilignes.  Ce style est tout à fait approprié à
l'incipit d'une transcription de musique ancienne.

@cindex neomensural

@item Le style @emph{Petrucci} tire son nom du fameux graveur vénitien
Ottaviano Petrucci (1466-1539), premier imprimeur à utiliser des
caractères amovibles pour la musique dans son édition du @emph{Harmonice
musices odhecaton} en 1501.  Les têtes de notes de ce style sont plus
larges que pour les autres styles mensuraux.

@cindex Petrucci

@end itemize

Bien qu'il ne soient pas complets, les styles @emph{Baroque} et
@emph{Classical} diffèrent du style par défaut par quelques détails --
certaines têtes de note pour le @emph{Baroque} et le soupir pour le
@emph{Classical}.

Seul le style mensural dispose de signes alternatifs couvrant tous les
aspects de la notation.  Ainsi, les silences et les crochets sont
absents du style grégorien puisqu'ils ne sont pas utilisés dans la
notation du plain-chant ; le style Petrucci ne dispose en propre
d'aucun crochet ni d'altération.

Chacun des éléments de notation peut donc être modifié de manière
indépendante jusqu'à, pourquoi pas, utiliser dans une même partition des
crochet en @emph{Mensural}, des têtes de note de @emph{Petrucci}, des
silences du @emph{Classical} et des clefs du style @emph{Vaticana}.

@seealso
Glossaire musicologique :
@rglos{mensural notation},
@rglos{flag}.


@node Considérations communes aux musiques anciennes
@subsection Considérations communes aux musiques anciennes
@translationof Ancient notation---common features

@menu
* Contextes prédéfinis::
* Ligatures::
* Guidons::
@end menu


@node Contextes prédéfinis
@unnumberedsubsubsec Contextes prédéfinis
@translationof Pre-defined contexts

LilyPond dispose, en matière de musique ancienne et de grégorien, de
contextes prédéfinis.  Ceux-ci contiennent tout ce qui est nécessaire à
la gestion d'une voix ou d'une portée selon le style adopté.  Si tout
cela vous dépasse et que vous désirez plonger dans le vif du sujet sans
trop vous préoccuper d'ajuster des contextes, consultez les pages
dédiées aux contextes prédéfinis.  Ils vous permettront d'adapter vos
contextes de voix et de portée, et vous n'aurez plus qu'à saisir les
notes dans un contexte @code{VaticanaVoice}, @code{VaticanaStaff},
@code{MensuralVoice} ou @code{MensuralStaff}.  Vous trouverez des
détails sur ces contextes aux rubriques

@itemize
@item @ref{Contextes du chant grégorien},
@item @ref{Contextes de musique mensurale}.
@end itemize

@seealso
Glossaire musicologique :
@rglos{mensural notation}.

Manuel de notation :
@ref{Contextes de musique mensurale},
@ref{Contextes du chant grégorien}.


@node Ligatures
@unnumberedsubsubsec Ligatures
@translationof Ligatures

@cindex ligature

@c TODO: Should double check if I recalled things correctly when I wrote
@c down the following paragraph by heart.

Une ligature est un symbole graphique qui représente un groupe d'au
moins deux notes distinctes.  Les ligatures ont commencé à apparaître
dans les manuscrits de chant grégorien, pour indiquer des suites
ascendantes ou descendantes de notes.

Les ligatures s'indiquent par un bornage entre @code{\[} et  @code{\]}.
Certains styles de ligature peuvent demander un complément de syntaxe
spécifique.  Par défaut, le graveur @code{LigatureBracket} place un
simple crochet au dessus de la ligature :

@lilypond[quote,ragged-right,verbatim]
\relative {
  \[ g' c, a' f d' \]
  a g f
  \[ e f a g \]
}
@end lilypond

Deux autres styles de ligature sont accessibles : vatican pour le
grégorien et mensural pour la musique ancienne (seules sont disponibles
les ligatures mensurales blanches, avec quelques limitations).  Selon le
style de ligature désiré, il faut remplacer, dans le contexte
@code{Voice} approprié, le graveur @code{Ligature_bracket_engraver} par
le graveur de ligature qui convient -- voir les rubriques
@ref{Ligatures mensurales} et @ref{Neumes et ligatures grégoriennes} à
ce sujet.

@seealso
Glossaire musicologique :
@rglos{ligature}.

Manuel de notation :
@ref{Ligatures mensurales},
@ref{Neumes et ligatures grégoriennes}.

@knownissues
La gestion de l'espacement spécifique aux ligatures n'est à ce jour
pas implémentée.  En conséquence, les ligatures sont trop espacées les
unes des autres et les sauts de ligne mal ajustés. De plus, les
paroles ne s'alignent pas de manière satisfaisante en présence de ligatures.

Les altérations ne pouvant être imprimées à l'intérieur d'une
ligature, il faut les rassembler et les imprimer juste avant.

La syntaxe utilisée correspond à l'ancienne convention de préfixage
@code{\[ expression musicale\]}.  Pour des raisons d'uniformité,
nous opterons probablement pour le style en suffixe (postfix)
@code{note\[ @dots{} note\]}.

@c En attendant, vous pouvez inclure le fichier
@c @file{gregorian-init.ly}, qui fournit une fonction Scheme
@c @example
@c \ligature @var{music expr}
@c @end example
@c qui produit le même résultat, et dont la pérennité est assurée.

@c TODO: this does not seem to work at the moment.
@c -- eo


@node Guidons
@unnumberedsubsubsec Guidons
@translationof Custodes

@cindex guidon
@cindex custos
@cindex custodes

Un guidon --- @emph{custos}, pluriel @emph{custodes} en latin --- est un
symbole qui apparaît à la fin d'une portée.  Il montre la hauteur de la
ou des premières notes de la portée suivante, donnant une indication
judicieuse à l'exécutant.

Les guidons étaient couramment utilisés jusqu'au XVIIe siècle.  De nos
jours, on les retrouve uniquement dans quelques formes particulières de
notation telles que les éditions contemporaines de chant grégorien comme
les @emph{editio vaticana}.  Différents glyphes existent selon le style
de notation.

L'impression de guidons s'obtient en affectant, dans un bloc
@code{\layout}, le @rinternals{Custos_engraver} au contexte
@code{Staff}, comme le montre l'exemple suivant.

@lilypond[quote,ragged-right]
\score {
  \relative {
    a'1
    \break
    g
  }
  \layout {
    \context {
      \Staff
      \consists "Custos_engraver"
      \override Custos.style = #'mensural
    }
  }
}
@end lilypond

Le glyphe du guidon est déterminé par la propriété @code{style}.  Les
styles disponibles sont @code{vaticana}, @code{medicaea},
@code{hufnagel} et @code{mensural}.  En voici un aperçu :

@lilypond[quote,ragged-right,fragment]
\new Lyrics \lyricmode {
  \markup { \column {
    \typewriter "vaticana "
    \line { " " \musicglyph #"custodes.vaticana.u0" }
  } }
  \markup { \column {
    \typewriter "medicaea "
    \line { " " \musicglyph #"custodes.medicaea.u0" }
  }}
  \markup { \column {
    \typewriter "hufnagel "
    \line { " " \musicglyph #"custodes.hufnagel.u0" }
  }}
  \markup { \column {
    \typewriter "mensural "
    \line { " " \musicglyph #"custodes.mensural.u0" }
  }}
}
@end lilypond

@seealso
Glossaire musicologique :
@rglos{custos}.

Référence des propriétés internes :
@rinternals{Custos}.

Morceaux choisis :
@rlsrnamed{Ancient notation, Musiques anciennes}.


@node Typographie de musique ancienne
@subsection Typographie de musique ancienne
@translationof Typesetting mensural music

@menu
* Contextes de musique mensurale::
* Clefs anciennes::
* Métriques anciennes::
* Têtes de note anciennes::
* Crochets anciens::
* Silences anciens::
* Altérations et armures anciennes::
* Altérations suggérées (musica ficta)::
* Ligatures mensurales::
@end menu


@node Contextes de musique mensurale
@unnumberedsubsubsec Contextes de musique mensurale
@translationof Mensural contexts

@cindex MensuralVoiceContext
@cindex MensuralStaffContext

Les contextes @code{MensuralVoice} et @code{MensuralStaff} permettent de
graver des chants dans le style mesuré.  Ces contextes initialisent les
propriétés de tous les autres contextes et objets graphiques à des
valeurs adéquates, de telle sorte que vous pouvez tout de suite vous
lancer dans la saisie de votre chant comme ci-après :

@lilypond[quote,ragged-right,verbatim]
\score {
  <<
    \new MensuralVoice = "discantus" \relative {
      \hide Score.BarNumber {
        c''1\melisma bes a g\melismaEnd
        f\breve
        \[ f1\melisma a c\breve d\melismaEnd \]
        c\longa
        c\breve\melisma a1 g1\melismaEnd
        fis\longa^\signumcongruentiae
      }
    }
    \new Lyrics \lyricsto "discantus" {
      San -- ctus, San -- ctus, San -- ctus
    }
  >>
}
@end lilypond

@seealso
Glossaire musicologique :
@rglos{mensural notation}.


@node Clefs anciennes
@unnumberedsubsubsec Clefs anciennes
@translationof Mensural clefs

@cindex clefs
@cindex clés
@cindex anciennes, clefs

Avec LilyPond, de nombreuses clés sont disponibles, dont certaines sont
dédiées à la musique ancienne.

Le tableau suivant présente les différentes clés anciennes que vous
pouvez sélectionner avec la commande @code{\clef}.  Certaines de ces
clés utilisent le même glyphe, attaché à l'une ou l'autre des lignes
de la portée.  Le chiffre porté en suffixe permet alors de les
différencier.  Vous pouvez forcer le positionnement du glyphe sur une
ligne, comme expliqué à la section @ref{Clefs}.  Dans la colonne
exemple, la note suivant la clé est un do médium.

Les clés d'ut de Petrucci avaient une hampe gauche différente selon
leur ligne de rattachement.

@multitable @columnfractions .4 .4 .2
@item
@b{Description}
@tab
@b{Clef disponible}
@tab
@b{Exemple}

@item
Clef d'ut, style mensural historique
@tab
@code{mensural-c1}, @code{mensural-c2},@*
@code{mensural-c3}, @code{mensural-c4},@*
@code{mensural-c5}
@tab
@lilypond[relative=1,notime]
  \clef "mensural-c2"
  \override NoteHead.style = #'mensural
  c1
@end lilypond

@item
Clef de fa, style mensural historique
@tab
@code{mensural-f}
@tab
@lilypond[relative=1,notime]
  \clef "mensural-f"
  \override NoteHead.style = #'mensural
  c1
@end lilypond

@item
Clef de sol, style mensural historique
@tab
@code{mensural-g}
@tab
@lilypond[relative=1,notime]
  \clef "mensural-g"
  \override NoteHead.style = #'mensural
  c1
@end lilypond

@item
Clef d'ut, style mensural noirci
@tab
@code{blackmensural-c1}, @code{blackmensural-c2},@*
@code{blackmensural-c3}, @code{blackmensural-c4},@*
@code{blackmensural-c5}
@tab
@lilypond[relative=1,notime]
  \clef "blackmensural-c2"
  \override NoteHead.style = #'mensural
  c1
@end lilypond

@item
Clef d'ut, style mensural moderne
@tab
@code{neomensural-c1}, @code{neomensural-c2},@*
@code{neomensural-c3}, @code{neomensural-c4}
@tab
@lilypond[relative=1,notime]
  \clef "neomensural-c2" c1
@end lilypond

@item
Clef d'ut, style mensural Petrucci, positionnable sur différentes
lignes (clef d'ut seconde pour l'exemple)
@tab
@code{petrucci-c1}, @code{petrucci-c2},@*
@code{petrucci-c3}, @code{petrucci-c4},@*
@code{petrucci-c5}
@tab
@lilypond[relative=1,notime]
  \clef "petrucci-c2"
  \override NoteHead.style = #'mensural
  c1
@end lilypond

@item
Clef de fa, style mensural Petrucci, positionnable sur différentes
lignes (clef de fa troisième pour l'exemple)
@tab
@code{petrucci-f3}, @code{petrucci-f4},@*
@code{petrucci-f5}
@tab
@lilypond[relative=1,notime]
  \clef "petrucci-f3"
  \override NoteHead.style = #'mensural
  c1
@end lilypond

@item
Clef de sol, style mensural Petrucci
@tab
@code{petrucci-g}
@tab
@lilypond[relative=1,notime]
  \clef "petrucci-g"
  \override NoteHead.style = #'mensural
  c1
@end lilypond
@end multitable

@emph{Moderne} signifie @qq{gravé comme dans les transcriptions
contemporaines de musique mesurée.}

@emph{Petrucci} signifie @qq{inspiré des éditions réalisées par le
maître graveur Petrucci (1466-1539).}

@emph{Historique} signifie @qq{gravé comme dans les éditions
historiques, manuscrites ou non, autres que celles de Petrucci.}

@seealso
Glossaire musicologique :
@rglos{mensural notation},
@rglos{clef}.

Manuel de notation :
@ref{Clefs}.

@knownissues
La clef de sol mensurale est calquée sur celle de Petrucci.


@node Métriques anciennes
@unnumberedsubsubsec Métriques anciennes
@translationof Mensural time signatures

@cindex signe de mensuration
@cindex mensuration, signe
@cindex ancienne, métrique
@cindex métrique, style

Les chiffrages de métrique mensurale sont partiellement pris en charge.
Les glyphes ne font que représenter des métriques particulières.  En
d'autres termes, pour obtenir le glyphe correspondant à une métrique
mensurale particulière à l'aide de la commande @code{\time n/m},
vous devez choisir la paire @w{@code{(n,m)}} parmi les valeurs
suivantes :

@lilypond[quote,ragged-right]
\layout {
  indent = 0.0
  \context {
    \Staff
    \remove "Staff_symbol_engraver"
    \remove "Clef_engraver"
    \remove "Time_signature_engraver"
  }
}
{
  \set Score.timing = ##f
  \set Score.barAlways = ##t
  \textLengthOn
  s^\markup { "\\time 4/4" }_\markup { "       " \musicglyph
#"timesig.neomensural44" }
  s
  s^\markup { "\\time 2/2" }_\markup { "       " \musicglyph
#"timesig.neomensural22" }
  s
  s^\markup { "\\time 6/4" }_\markup { "       " \musicglyph
#"timesig.neomensural64" }
  s
  s^\markup { "\\time 6/8" }_\markup { "       " \musicglyph
#"timesig.neomensural68" }
  \break
  s^\markup { "\\time 3/2" }_\markup { "       " \musicglyph
#"timesig.neomensural32" }
  s
  s^\markup { "\\time 3/4" }_\markup { "       " \musicglyph
#"timesig.neomensural34" }
  s
  s^\markup { "\\time 9/4" }_\markup { "       " \musicglyph
#"timesig.neomensural94" }
  s
  s^\markup { "\\time 9/8" }_\markup { "       " \musicglyph
#"timesig.neomensural98" }
  \break
  s^\markup { "\\time 4/8" }_\markup { "       " \musicglyph
#"timesig.neomensural48" }
  s
  s^\markup { "\\time 2/4" }_\markup { "       " \musicglyph
#"timesig.neomensural24" }
}
@end lilypond

La propriété @code{style} de l'objet @code{TimeSignature} permet
d'accéder aux indicateurs de métrique anciens.  Les styles
@code{neomensural} et @code{mensural} sont disponibles.  Vous avez vu
ci-dessus le style @code{neomensural}, particulièrement utilisé pour
l'incipit des transcriptions.  Le style @code{mensural} imite l'aspect
de certaines éditions du XVIe siècle.

Voici les différences entre les styles :

@lilypond[ragged-right,relative=1,quote]
{
  \textLengthOn

  \time 2/2
  c1^\markup { \hspace #-2.0 \typewriter default }

  \override Staff.TimeSignature.style = #'numbered
  \time 2/2
  c1^\markup { \hspace #-2.0 \typewriter numbered }

  \override Staff.TimeSignature.style = #'mensural
  \time 2/2
  c1^\markup { \hspace #-2.0 \typewriter mensural }

  \override Staff.TimeSignature.style = #'neomensural
  \time 2/2
  c1^\markup { \hspace #-2.0 \typewriter neomensural }
  \override Staff.TimeSignature.style = #'single-digit
  \time 2/2
  c1^\markup { \hspace #-2.0 \typewriter single-digit }
}
@end lilypond

La rubrique @ref{Métrique} expose les principes généraux sur
l'utilisation des indications de métrique.

@seealso
Glossaire musicologique :
@rglos{mensural notation}.

Manuel de notation :
@ref{Métrique}.

@knownissues
Les équivalences de durées de note ne sont pas modifiées par un
changement de métrique.  Par exemple, l'équivalence une brève pour trois
semi-brèves (@emph{tempus perfectum}) doit s'effectuer à la main en
entrant :

@example
breveTP = #(ly:make-duration -1 0 3/2)
@dots{}
@{ c\breveTP f1 @}
@end example

@noindent
Ce qui définira @code{breveTP} à 3/2 fois 2 = 3 fois une ronde.

Les symboles @code{mensural68alt} et @code{neomensural68alt} --
alternatives à la métrique 6/8 -- ne sont pas accessibles par la
commande @code{\time}.  Utilisez alors un
@code{\markup @{\musicglyph #"timesig.mensural68alt" @}}.


@node Têtes de note anciennes
@unnumberedsubsubsec Têtes de note anciennes
@translationof Mensural note heads

@cindex note, têtes anciennes
@cindex anciennes têtes de note

Pour de la musique ancienne, vous disposez de plusieurs styles de tête
de note, en plus du style par défaut @code{default}.  Vous pouvez
affecter à la propriété @code{style} de l'objet @code{NoteHead}
les valeurs @code{baroque}, @code{neomensural}, @code{mensural},
@code{petrucci}, @code{blackpetrucci} ou @code{semipetrucci}.

Le style @code{baroque} diffère du style @code{default} par

@itemize
@item la disponibilité de la @code{maxima}, et
@item la @code{\breve} qui sera carrée et non pas ovoïde.
@end itemize

Les styles @code{neomensural}, @code{mensural} et @code{petrucci}
diffèrent du @code{baroque} par ceci :

@itemize
@item les notes de durée inférieure ou égale à une ronde sont en forme
de losange, et
@item les hampes sont centrées sur la tête.
@end itemize

Le style @code{blackpetrucci} permet d'obtenir, en notation mensurale
blanche, des têtes noircies.  Cependant, et dans la mesure où le style
de tête n'influence en rien le nombre des crochets, une
@emph{semiminima} devrait alors se noter @code{a8*2} plutôt que
@code{a4}, de telle sorte qu'elle ne se confonde pas avec une
@emph{minima}.  Le multiplicateur peut varier, pour indiquer par exemple
un triolet.

Le style @code{semipetrucci} permet de partiellement noircir certaines
têtes, comme la brève, la longue et la maxime.

L'exemple suivant illustre le style @code{petrucci}.

@c Renaissance music doesn't use bar lines ...  but they do help to
@c separate the notes for easier identification.

@lilypond[quote,fragment,ragged-right,verbatim]
\set Score.skipBars = ##t
\autoBeamOff
\override NoteHead.style = #'petrucci
a'\maxima a'\longa a'\breve a'1 a'2 a'4 a'8 a'16 a'
\override NoteHead.style = #'semipetrucci
a'\breve*5/6
\override NoteHead.style = #'blackpetrucci
a'8*4/3 a'
\override NoteHead.style = #'petrucci
a'\longa
@end lilypond

La rubrique @ref{Têtes de note} présente tous les styles de notes
disponibles.

@seealso
Glossaire musicologique :
@rglos{mensural notation},
@rglos{note head}.

Manuel de notation :
@ref{Têtes de note}.


@node Crochets anciens
@unnumberedsubsubsec Crochets anciens
@translationof Mensural flags

@cindex crochets
@cindex ancien, crochet

Le réglage de la propriété @code{flag-style} de l'objet hampe
(@code{Stem}) donne accès aux crochets de style ancien.  Les seuls
styles actuellement pris en charge sont @code{default} et
@code{mensural}.

@lilypond[quote,fragment,ragged-right,verbatim,relative=1]
\override Flag.style = #'mensural
\override Stem.thickness = #1.0
\override NoteHead.style = #'mensural
\autoBeamOff
c8 d e f c16 d e f c32 d e f s8
c'8 d e f c16 d e f c32 d e f
@end lilypond

Notez que, pour chaque crochet mensural, l'extrémité la plus proche de
la tête de note sera attachée à une ligne de la portée.

Il n'existe pas de crochet spécifique au style néomensural.

Les crochets n'existent pas en notation grégorienne.

@seealso
Glossaire musicologique :
@rglos{mensural notation},
@rglos{flag}.

@knownissues
L'alignement vertical des crochets par rapport aux lignes de la portée
sous-entend que les hampes se terminent toujours soit sur une ligne,
soit à l'exact milieu d'un interligne.  Ceci n'est pas toujours
réalisable, surtout si vous faites appel à des fonctionnalités avancées
de présentation de la notation classique qui, par définition, ne sont
pas prévues pour être appliquées à la notation mensurale.


@node Silences anciens
@unnumberedsubsubsec Silences anciens
@translationof Mensural rests

@cindex anciens silences

La propriété @code{style} de l'objet @code{Rest} permet d'obtenir des
silences de type ancien.  Vous disposez des styles @code{classical},
@code{neomensural} et @code{mensural}.  Le style @code{classical} ne se
distingue du style @code{default} que par le soupir (demi-soupir en
miroir). Le style @code{neomensural} convient tout à fait à l'incipit
lors de la transcription de musique mensurale.  Le style
@code{mensural}, enfin, imite la gravure des silences dans certaines
éditions du XVIe siècle.

L'exemple suivant illustre les styles @code{mensural} et
@code{neomensural}.

@lilypond[quote,fragment,ragged-right,verbatim]
\set Score.skipBars = ##t
\override Rest.style = #'classical
r\longa^"classical" r\breve r1 r2 r4 r8 r16 s \break
\override Rest.style = #'mensural
r\longa^"mensural" r\breve r1 r2 r4 r8 r16 s \break
\override Rest.style = #'neomensural
r\longa^"neomensural" r\breve r1 r2 r4 r8 r16
@end lilypond

Les styles @code{mensural} et @code{neomensural} ne disposent pas des
huitième et seizième de soupir ; LilyPond utilise dans de tels cas
le style par défaut.

@seealso
Glossaire musicologique :
@rglos{mensural notation}.

Manuel de notation :
@ref{Silences}.

Morceaux choisis :
@rlsrnamed{Ancient notation,Notations anciennes}.

@knownissues
En style mensural, LilyPond utilise pour un silence correspondant à une
@emph{maxima}, le même glyphe que pour un @emph{longa} ; il faut
donc les multiplier pour obtenir la durée @emph{ad hoc}.  Des silences
correspondant à une @emph{longa} ne sont pas groupés automatiquement ;
utilisez en pareil cas des @qq{notes silencieuses}.


@node Altérations et armures anciennes
@unnumberedsubsubsec Altérations et armures anciennes
@translationof Mensural accidentals and key signatures

@cindex altération
@cindex armure
@cindex anciennes altérations

Le style @code{mensural} dispose d'un dièse et d'un bémol différents du
style par défaut ; en cas de besoin, le bécarre sera emprunté au
style @code{vaticana}.

@lilypond[quote,ragged-right,staffsize=26]
\markup {
  \column {
    "mensural"
    \line { " " \musicglyph #"accidentals.mensural-1"
      " " \musicglyph #"accidentals.mensural1" }
  }
}
@end lilypond

Pour disposer des formes anciennes d'altération, utilisez la propriété
@code{glyph-name-alist} des objets graphiques @code{Accidental}
et @code{KeySignature}, comme ceci :

@example
\override Staff.Accidental.glyph-name-alist =
  #alteration-mensural-glyph-name-alist
@end example

@seealso
Glossaire musicologique :
@rglos{mensural notation},
@rglos{Pitch names},
@rglos{accidental},
@rglos{key signature}.

Manuel de notation :
@ref{Hauteurs},
@ref{Altérations},
@ref{Altérations accidentelles automatiques},
@ref{Armure}.

Référence des propriétés internes :
@rinternals{KeySignature}.


@node Altérations suggérées (musica ficta)
@unnumberedsubsubsec Altérations suggérées (@emph{musica ficta})
@translationof Annotational accidentals (musica ficta)

Dans la pratique ancienne, avant le XVIIe siècle, les altérations
accidentelles de l’échelle modale n’étaient pas systématiquement notées
et il incombait aux chanteurs, en fonction de certaines règles, de
décider s’ils devaient chanter tel degré bémol, bécarre ou dièse.  Cette
technique est appelée @notation{musica ficta}.  Les transcriptions
modernes de telles œuvres font apparaître ces altérations en surplomb de
la note.

@cindex altération et musica ficta
@cindex musica ficta
@cindex MensuralVoiceContext
@cindex MensuralStaffContext

La reproduction de ces altérations suggérées est assurée par l'activation
de la fonction @code{suggestAccidentals}.

@funindex suggestAccidentals

@lilypond[verbatim,relative=1]
fis gis
\set suggestAccidentals = ##t
ais bis
@end lilypond

Cette fonction considérera @strong{toute} altération comme étant de la
@emph{musica ficta}, ce tant qu'elle n'aura pas été désactivée par un
@code{\set suggestAccidentals = ##f}.  Il est de ce fait plus pratique
de recourir à une clause @code{\once \set suggestAccidentals = ##t}, qui
peut tout à fait faire l'objet d'un raccourci :

@lilypond[quote,verbatim]
ficta = { \once \set suggestAccidentals = ##t }
\score { \relative
  \new MensuralVoice  {
    \once \set suggestAccidentals = ##t
    bes'4 a2 g2 \ficta fis8 \ficta e! fis2 g1
  }
}
@end lilypond

@seealso
Référence des propriétés internes :
@rinternals{Accidental_engraver},
@rinternals{AccidentalSuggestion}.


@node Ligatures mensurales
@unnumberedsubsubsec Ligatures mensurales
@translationof White mensural ligatures

@cindex ligatures anciennes
@cindex ligatures blanches
@cindex anciennes ligatures

Les ligatures mensurales blanches sont prises en charge, avec des
limitations.

La gravure des ligatures mensurales blanches s'obtient après avoir
remplacé, dans le contexte @code{Voice}, le
@code{Ligature_bracket_engraver} par le
@code{Mensural_ligature_engraver}, comme ici :

@example
\layout @{
  \context @{
    \Voice
    \remove "Ligature_bracket_engraver"
    \consists "Mensural_ligature_engraver"
  @}
@}
@end example

Lorsque le code ci-dessus est employé, l'aspect d'une ligature mensurale
blanche est déterminé à partir des hauteurs et durées des notes qui la
composent.  Bien que cela demande un temps d'adaptation au nouvel
utilisateur, cette méthode offre l'avantage que toute l'information
musicale incluse dans la ligature est connue en interne.  Ceci est non
seulement important pour le rendu MIDI, mais aussi pour des questions de
transcription automatisée d'une ligature.

Il se peut que deux notes consécutives puissent être représentées aussi
bien par deux carrées que par un parallélogramme oblique (en forme de
flexe).  Par défaut, LilyPond présentera deux carrés ; l'impression
d'une flexe s'obtient par affectation, pour la @strong{deuxième} note,
de la propriété @code{ligature-flexa}.  Le réglage de la longueur d'une
flexe se gère par la propriété de tête de note @code{flexa-width}.

Par exemple,

@c @example
@c \set Score.timing = ##f
@c \set Score.defaultBarType = "-"
@c \override NoteHead.style = #'neomensural
@c \override Staff.TimeSignature.style = #'neomensural
@c \clef "petrucci-g"
@c \[ c'\maxima g \]
@c \[ d\longa c\breve f e d \]
@c \[ c'\maxima d'\longa \]
@c \[ e'1 a g\breve \]
@c @end example
@lilypond[quote,ragged-right,verbatim]
\score {
  \relative {
    \set Score.timing = ##f
    \set Score.defaultBarType = "-"
    \override NoteHead.style = #'petrucci
    \override Staff.TimeSignature.style = #'mensural
    \clef "petrucci-g"
    \[ c''\maxima g \]
    \[ d\longa
       \override NoteHead.ligature-flexa = ##t
       \once \override NoteHead.flexa-width = #3.2
       c\breve f e d \]
    \[ c'\maxima d\longa \]
    \[ e1 a, g\breve \]
  }
  \layout {
    \context {
      \Voice
      \remove "Ligature_bracket_engraver"
      \consists "Mensural_ligature_engraver"
    }
  }
}
@end lilypond

Si on ne remplace pas le @code{Ligature_bracket_engraver}
par le @code{Mensural_ligature_engraver}, on obtient

@lilypond[quote,ragged-right]
\relative {
  \set Score.timing = ##f
  \set Score.defaultBarType = "-"
  \override NoteHead.style = #'petrucci
  \override Staff.TimeSignature.style = #'mensural
  \clef "petrucci-g"
  \[ c''\maxima g \]
  \[ d\longa
     \override NoteHead.ligature-flexa = ##t
     \once \override NoteHead.flexa-width = #3.2
     c\breve f e d \]
  \[ c'\maxima d\longa \]
  \[ e1 a, g\breve \]
}
@end lilypond

@seealso
Glossaire musicologique :
@rglos{ligature}.

Manuel de notation :
@ref{Neumes et ligatures grégoriennes},
@ref{Ligatures}.

@knownissues
L'espacement horizontal n'est pas des meilleurs.
Les altérations peuvent se chevaucher avec les notes précédentes.


@node Typographie du chant grégorien
@subsection Typographie du chant grégorien
@translationof Typesetting Gregorian chant

@menu
* Contextes du chant grégorien::
* Clefs grégoriennes::
* Altérations et armures grégoriennes::
* Divisions::
* Articulations grégoriennes::
* Points d'augmentation (morae)::
* Neumes et ligatures grégoriennes::
@end menu

Si vous écrivez en notation grégorienne, le
@code{Vaticana_ligature_engraver} se chargera de sélectionner les têtes
de note appropriées ; il est donc inutile de spécifier le style à
utiliser.  Vous pouvez cependant spécifier par exemple le style
@code{vaticana_punctum} pour obtenir des neumes punctums.  De même,
c'est le @code{Mensural_ligature_engraver} qui se chargera des ligatures
mensurales.

@seealso
Glossaire musicologique :
@rglos{ligature}.

Manuel de notation :
@ref{Ligatures mensurales},
@ref{Ligatures}.


@node Contextes du chant grégorien
@unnumberedsubsubsec Contextes du chant grégorien
@translationof Gregorian chant contexts

@cindex VaticanaVoiceContext
@cindex VaticanaStaffContext

Les contextes prédéfinis @code{VaticanaVoiceContext} et
@code{VaticanaStaffContext} permettent de graver le chant grégorien
dans le style des éditions vaticanes.  Ces contextes initialisent
les propriétés de tous les autres contextes et objets graphiques à des
valeurs adéquates, de telle sorte que vous pouvez tout de suite vous
lancer dans la saisie de votre chant, comme ci-dessous :

@lilypond[quote,ragged-right,verbatim]
\include "gregorian.ly"
\score {
  <<
    \new VaticanaVoice = "cantus" {
      \[ c'\melisma c' \flexa a \]
      \[ a \flexa \deminutum g\melismaEnd \]
      f \divisioMinima
      \[ f\melisma \pes a c' c' \pes d'\melismaEnd \]
      c' \divisioMinima \break
      \[ c'\melisma c' \flexa a \]
      \[ a \flexa \deminutum g\melismaEnd \] f \divisioMinima
    }
    \new Lyrics \lyricsto "cantus" {
      San- ctus, San- ctus, San- ctus
    }
  >>
}
@end lilypond

@c @seealso
@c TODO: nothing here yet ...


@node Clefs grégoriennes
@unnumberedsubsubsec Clefs grégoriennes
@translationof Gregorian clefs

@cindex clefs

Le tableau suivant présente les différentes clefs grégoriennes que vous
pouvez sélectionner avec la commande @code{\clef}.  Certaines de ces
clefs utilisent le même glyphe, attaché à l'une ou l'autre des lignes
de la portée.  Le chiffre porté en suffixe permet alors de les
différencier ; la numérotation des lignes va de bas en haut.  Vous
pouvez néanmoins forcer le positionnement du glyphe sur une ligne, comme
expliqué à la section @ref{Clefs}.  Dans la colonne exemple, la note
suivant la clef est un do médium.

@multitable @columnfractions .4 .4 .2
@item
@b{Description}
@tab
@b{Clef disponible}
@tab
@b{Exemple}

@item
Clef d'ut, style des éditions vaticanes
@tab
@code{vaticana-do1}, @code{vaticana-do2},@*
@code{vaticana-do3}
@tab
@lilypond[relative=1,notime]
  \override Staff.StaffSymbol.line-count = #4
  \override Staff.StaffSymbol.color = #red
  \override Staff.LedgerLineSpanner.color = #red
  \hide Voice.Stem
  \override NoteHead.style = #'vaticana.punctum
  \clef "vaticana-do2"
  c
@end lilypond

@item
Clef de fa, style des éditions vaticanes
@tab
@code{vaticana-fa1}, @code{vaticana-fa2}
@tab
@lilypond[relative=1,notime]
  \override Staff.StaffSymbol.line-count = #4
  \override Staff.StaffSymbol.color = #red
  \override Staff.LedgerLineSpanner.color = #red
  \hide Voice.Stem
  \override NoteHead.style = #'vaticana.punctum
  \clef "vaticana-fa2"
  c
@end lilypond

@item
Clef d'ut, style Editio Medicaea
@tab
@code{medicaea-do1}, @code{medicaea-do2},@*
@code{medicaea-do3}
@tab
@lilypond[relative=1,notime]
  \override Staff.StaffSymbol.line-count = #4
  \override Staff.StaffSymbol.color = #red
  \override Staff.LedgerLineSpanner.color = #red
  \hide Voice.Stem
  \override NoteHead.style = #'medicaea.punctum
  \clef "medicaea-do2"
  c
@end lilypond

@item
Clef de fa, style Editio Medicaea
@tab
@code{medicaea-fa1}, @code{medicaea-fa2}
@tab
@lilypond[relative=1,notime]
  \override Staff.StaffSymbol.line-count = #4
  \override Staff.StaffSymbol.color = #red
  \override Staff.LedgerLineSpanner.color = #red
  \hide Voice.Stem
  \override NoteHead.style = #'medicaea.punctum
  \clef "medicaea-fa2"
  c
@end lilypond

@item
Clef d'ut, style historique Hufnagel
@tab
@code{hufnagel-do1}, @code{hufnagel-do2},@*
@code{hufnagel-do3}
@tab
@lilypond[relative=1,notime]
  \override Staff.StaffSymbol.line-count = #4
  \override Staff.StaffSymbol.color = #red
  \override Staff.LedgerLineSpanner.color = #red
  \hide Voice.Stem
  \override NoteHead.style = #'hufnagel.punctum
  \clef "hufnagel-do2"
  c
@end lilypond

@item
Clef de fa, style historique Hufnagel
@tab
@code{hufnagel-fa1}, @code{hufnagel-fa2}
@tab
@lilypond[relative=1,notime]
  \override Staff.StaffSymbol.line-count = #4
  \override Staff.StaffSymbol.color = #red
  \override Staff.LedgerLineSpanner.color = #red
  \hide Voice.Stem
  \override NoteHead.style = #'hufnagel.punctum
  \clef "hufnagel-fa2"
  c
@end lilypond

@item
Clef combinée ut/fa, style historique Hufnagel
@tab
@code{hufnagel-do-fa}
@tab
@lilypond[relative=1,notime]
  \override Staff.StaffSymbol.color = #red
  \override Staff.LedgerLineSpanner.color = #red
  \hide Voice.Stem
  \override NoteHead.style = #'hufnagel.punctum
  \clef "hufnagel-do-fa"
  c
@end lilypond
@end multitable

@seealso
Glossaire musicologique :
@rglos{clef}.

Manuel de notation :
@ref{Clefs}.


@node Altérations et armures grégoriennes
@unnumberedsubsubsec Altérations et armures grégoriennes
@translationof Gregorian accidentals and key signatures

@cindex altérations
@cindex armure

LilyPond dispose d'altérations pour les trois styles grégoriens :

@lilypond[quote,ragged-right,staffsize=26]
\markup {
  \column {
    "vaticana"
    \line { " " \musicglyph #"accidentals.vaticana-1"
      " " \musicglyph #"accidentals.vaticana0" }
  }
  \column {
    "medicaea"
    \line { " " \musicglyph #"accidentals.medicaea-1" }
  }
  \column {
    "hufnagel"
    \line { " " \musicglyph #"accidentals.hufnagel-1" }
  }
}
@end lilypond

Vous noterez que chacun de ces styles ne comporte pas toutes les
altérations.  LilyPond changera de style s'il est besoin d'une
altération indisponible dans le style utilisé.

@c @lilypondfile[verbatim,quote,texidoc,doctitle]
@c {ancient-accidentals.ly}

Pour disposer des formes anciennes d'altération, utilisez la propriété
@code{glyph-name-alist} des objets graphiques @code{Accidental}
et @code{KeySignature}, comme ceci :

@example
\override Staff.Accidental.glyph-name-alist =
  #alteration-mensural-glyph-name-alist
@end example

@seealso
Glossaire musicologique :
@rglos{accidental},
@rglos{key signature}.

Manuel de notation :
@ref{Hauteurs},
@ref{Altérations},
@ref{Altérations accidentelles automatiques},
@ref{Armure}.

Référence des propriétés internes :
@rinternals{KeySignature}.


@node Divisions
@unnumberedsubsubsec Divisions
@translationof Divisiones

@cindex divisio
@cindex divisiones
@cindex finalis
@cindex césures

Il n'existe pas de silence en notation grégorienne.  On y parle plutôt
de @emph{divisions, pauses} ou @emph{coupes}.

Une division -- @emph{divisio}, pluriel @emph{divisiones} en latin --
est un symbole ajouté à la portée et utilisé en chant grégorien pour
séparer les phrases ou parties.  @emph{Divisio minima}, @emph{divisio
maior} et @emph{divisio maxima} peuvent respectivement s'interpréter
comme une pause courte, moyenne ou longue, à l'image des marques de
respiration --- cf. @ref{Signes de respiration}.  Le signe
@emph{finalis} n'est pas uniquement une marque de fin de chant ; il
sert aussi à indiquer la fin de chaque partie dans une structure
verset/répons.

Les divisions sont disponibles après inclusion du fichier
@file{gregorian-init.ly}.  Ce fichier définit les commandes
@code{\divisioMinima}, @code{\divisioMaior}, @code{\divisioMaxima} et
@code{\finalis}.  Certaines éditions utilisent @emph{virgula} ou
@emph{caesura} en lieu et place de @emph{divisio minima} ; c'est
pourquoi @file{gregorian-init.ly} définit aussi @code{\virgula} et
@code{\caesura}.

@lilypond[quote,ragged-right]
\include "gregorian.ly"
\score {
  <<
    \context VaticanaVoice {
      \override TextScript.padding = #3
      g a g
      s^\markup { "divisio minima" }
      \divisioMinima
      g a g
      s^\markup { "divisio maior" }
      \divisioMaior
      g a g
      s^\markup { "divisio maxima" }
      \divisioMaxima
      \break
      g a g
      s^\markup { "finalis" }
      \finalis
      g a g
      s^\markup { "virgula" }
      \virgula
      g a g
      s^\markup { "caesura" }
      \caesura
      g a g
    }
  >>
}
@end lilypond

@predefined
@funindex \virgula
@code{\virgula},
@funindex \caesura
@code{\caesura},
@funindex \divisioMinima
@code{\divisioMinima},
@funindex \divisioMaior
@code{\divisioMaior},
@funindex \divisioMaxima
@code{\divisioMaxima},
@funindex \finalis
@code{\finalis}.
@endpredefined

@seealso
Glossaire musicologique :
@rglos{caesura},
@rglos{divisio}.

Manuel de notation :
@ref{Signes de respiration}.

Fichiers d'initialisation :
@file{gregorian.ly}.


@node Articulations grégoriennes
@unnumberedsubsubsec Articulations grégoriennes
@translationof Gregorian articulation signs

@cindex grégorien, articulations

En plus des signes d'articulation standards décrits à la section
@ref{Articulations et ornements}, LilyPond fournit des articulations
spécifiquement destinées au style des éditions vaticanes.

@lilypond[quote,ragged-right,verbatim]
\include "gregorian.ly"
\score {
  \new VaticanaVoice {
    \override TextScript.font-family = #'typewriter
    \override TextScript.font-shape = #'upright
    \override Script.padding = #-0.1
    a\ictus_"ictus " \bar "" \break
    a\circulus_"circulus " \bar "" \break
    a\semicirculus_"semicirculus " \bar "" \break
    a\accentus_"accentus " \bar "" \break
    \[ a_"episema" \episemInitium \pes b \flexa a b \episemFinis \flexa a \]
  }
}
@end lilypond

@seealso
Manuel de notation :
@ref{Articulations et ornements}.

Morceaux choisis :
@rlsrnamed{Ancient notation,Musiques anciennes}.

Référence des propriétés internes :
@rinternals{Episema},
@rinternals{EpisemaEvent},
@rinternals{Episema_engraver},
@rinternals{Script},
@rinternals{ScriptEvent},
@rinternals{Script_engraver}.

@knownissues
Certaines articulations sont verticalement trop proches de leurs têtes
de note.


@node Points d'augmentation (morae)
@unnumberedsubsubsec Points d'augmentation (@emph{morae})
@translationof Augmentum dots (morae)

Les points d'@emph{augmentum}, ou @emph{morae}, s'obtiennent avec la
fonction @code{\augmentum}.  Notez que cette fonction @code{\augmentum}
est implémentée en tant que fonction unaire plutôt que comme un préfixe
de note.  Par conséquent, @code{\augmentum \virga c} ne donnera rien de
particulier.  Il faut l'utiliser avec la syntaxe
@code{\virga \augmentum c} ou @code{\augmentum @{\virga c@}}.  Par
ailleurs, l'expression @code{\augmentum @{a g@}} constitue une forme
abrégée de @code{\augmentum a \augmentum g}.

@lilypond[quote,ragged-right,verbatim]
\include "gregorian.ly"
\score {
  \new VaticanaVoice {
    \[ \augmentum a \flexa \augmentum g \]
    \augmentum g
  }
}
@end lilypond

@seealso
Manuel de notation :
@ref{Signes de respiration}.

Référence des propriétés internes :
@rinternals{BreathingSign}.

Morceaux choisis :
@rlsrnamed{Ancient notation,Musiques anciennes}.


@node Neumes et ligatures grégoriennes
@unnumberedsubsubsec Neumes et ligatures grégoriennes
@translationof Gregorian square neume ligatures

@cindex neumes carrés et ligatures
@cindex grégorien, ligatures de neumes carrés
@cindex ligatures et neumes

Les neumes grégoriens conformément au style des éditions vaticanes sont
pris en charge de façon assez limitée.  Les ligatures élémentaires sont
déjà disponibles, mais beaucoup de règles typographiques ne sont pas
encore implémentées, notamment l'espacement horizontal des enchaînements
de ligatures, l'alignement des paroles ou une gestion convenable des
altérations.

La prise en charge des neumes grégoriens est activée par l'inclusion, en
début de votre fichier source, du fichier d'initialisation
@file{gregorian.ly}.  Ceci aura pour effet de rendre disponible un
certain nombre de commandes dans le but de reproduire les symboles de
neumes tels qu'ils apparaissent dans la notation du plain-chant.

Les têtes de note peuvent être @emph{modifiées} ou @emph{jointes}.

@itemize
@item L'aspect d'une tête de note se modifie en @emph{préfixant} le nom
d'une hauteur par l'une des commandes suivantes :
@funindex \virga
@code{\virga},
@funindex \stropha
@code{\stropha},
@funindex \inclinatum
@code{\inclinatum},
@funindex \auctum
@code{\auctum},
@funindex \descendens
@code{\descendens},
@funindex \ascendens
@code{\ascendens},
@funindex \oriscus
@code{\oriscus},
@funindex \quilisma
@code{\quilisma},
@funindex \deminutum
@code{\deminutum},
@funindex \cavum
@code{\cavum},
@funindex \linea
@code{\linea}.

@item Une ligature, autrement dit la juxtaposition de notes,
s'obtient en plaçant une commande de jointure @code{\pes} ou
@code{\flexa} pour marquer une ligne mélodique respectivement ascendante
ou descendante, entre les notes qui la composent.
@end itemize

Une hauteur sans qualificatif sera considérée comme un @emph{punctum}.
Tout autre neume, y compris ceux d'une seule note d'aspect particulier
comme la @emph{virga}, sera considéré en tant que ligature et devra
répondre à la syntaxe @code{\[@dots{}\]}.
@c Regarding the @emph{punctum}, @code{b} and @code{\[ b \]} are
@c equivalent.

@noindent
Neumes simples :

@itemize
@item Le @emph{punctum} représente l'aspect standard d'une note -- dans
le style @emph{Vaticana}, il s'agit d'un carré plein légèrement incurvé
pour une question d'esthétique.  Existe aussi le @emph{punctum
inclinatum} -- carré penché qui s'obtient grâce au préfixe
@code{\inclinatum}.  Un @emph{punctum} standard peut se modifier par le
préfixe @code{\cavum} qui l'évidera, ou le préfixe @code{\linea}, qui
lui adjoindra une ligne verticale de part et d'autre.

@item La @emph{virga} dispose d'une hampe sur la droite.  Elle s'obtient
à l'aide du modificateur @code{\virga}.
@end itemize

@noindent
Ligatures

Contrairement à la majorité des autres systèmes de notation neumatique,
la manière de saisir les neumes n'a rien à voir avec leur apparence
typographique ; elle se concentre plutôt sur le sens musical.
Ainsi, @code{\[ a \pes b \flexa g \]} produit un @emph{torculus}
constitué de trois @emph{punctums}, alors que
@code{\[ a \flexa g \pes b \]} produit un @emph{porrectus} avec une
flexe incurvée et un seul @emph{punctum}.  Il n'existe pas de commande à
proprement parler qui permette de spécifier la courbe d'une flexe ;
c'est la source musicale qui va le déterminer.  Le fondement d'une telle
approche réside dans la distinction que nous faisons entre les aspects
musicaux de la source et le style de notation que nous voulons obtenir.
De ce fait, la même source pourra être utilisée pour imprimer dans un
autre style de notation grégorienne.

@noindent
Neumes liquescents

Autre grande catégorie de notes que l'on trouve en grégorien, les neumes
liquescents.  Ils s'utilisent dans certaines circonstances, quand
l'articulation d'une syllabe avec la suivante se fait par une
@qq{consonne liquide}, sur la dernière note du groupe : M (omnis,
summo), L, N, Y (ejus), NG (sanctus), W (autem, laudat). Ces consonnes
ou semi-consonnes sont chantées à la hauteur correspondante, comme le
seraient des voyelles, mais le chant est entravé par leur prononciation.
De fait, les neumes liquescents ne sont jamais utilisés isolément (bien
que rien ne l'interdise) et tombent toujours à la fin d'une ligature.

Les neumes liquescents peuvent se présenter graphiquement de deux façons
différentes et relativement interchangeables : une note plus
petite, ou une @qq{bascule} verticale de la note principale.  La
première option s'obtient en créant un @code{pes} ou une @code{flexa}
puis une modification de l'aspect de la deuxième note :
@code{\[ a \pes \deminutum b \]}.  La seconde option consiste à
modifier l'aspect d'un neume sur note unique avec un @code{\auctum} tout
en lui affectant une direction @code{\descendens} ou
@code{\ascendens} : @code{\[ \auctum \descendens a \]}.

@noindent
Signes spéciaux

Une troisième catégorie regroupe quelques signes dont la signification
particulière diverge selon la source : la  @emph{quilisma},
l'@emph{oriscus} et le @emph{strophicus}.  Ils s'obtiennent en préfixant
la hauteur d'un @code{\quilisma}, @code{\oriscus} ou @code{\stropha}.

Il est virtuellement possible d'agglutiner autant de notes que voulu, y
compris en les mélangeant avec des @code{\pes}, @code{\flexa},
@code{\virga}, @code{\inclinatum}, et de borner le tout par  @code{\[}
et @code{\]} pour produire une seule ligature.  C'est d'ailleurs de
cette manière que nous avons procédé pour générer le tableau qui suit.
La création de ligatures est donc sans limite.

Notez bien que l'utilisation de ces signes en musique suit un certain
nombre de règles, et que LilyPond n'effectue aucun contrôle à ce niveau.
Par exemple, une @emph{quilisma} se trouve toujours être la note
intermédiaire d'une ligature ascendante et tombe habituellement sur un
demi ton ; bien que cela soit tout à fait possible, mais
parfaitement incorrect, rien ne vous empêche de créer une quilisma sur
une seule note.

En plus des signes propres à la notation, le fichier @file{gregorian.ly}
contient la définition des commandes @code{\versus}, @code{\responsum},
@code{\ij}, @code{\iij}, @code{\IJ} et @code{\IIJ}, qui permettent par
exemple d'indiquer dans les paroles des repères de section.  Ces
commandes font appel à des caractères unicode spécifiques qui ne seront
reproduits que si vous utilisez une fonte qui en dispose.

@c table des neumes

Le tableau ci-dessous inventorie, bien que dans une certaine limite, les
différents neumes contenus dans le second tome de l'Antiphonale Romanum
(@emph{Liber Hymnarius}) publié par l'abbaye de Solesmes en 1983.
La première colonne énumère le nom des ligatures -- forme normale en
gras et forme liquescente en italique. La troisième colonne contient le
code ayant permis de générer la ligature, se basant ici sur sol, la, si.

@b{Neumes simples}

@multitable @columnfractions .4 .2 .4

@item
Formes @b{Normale} et @emph{Liquescente}
@tab
@b{Rendu}
@tab
@b{Code@*
LilyPond}

@c TODO: \layout block is identical in all of the below examples.
@c Therefore, it should somehow be included rather than duplicated all
@c the time.  --jr

@c why not make variables in ly/engraver-init.ly? --hwn

@c Because it's just used to typeset plain notes without
@c a staff for demonstration purposes rather than something
@c special of Gregorian chant notation.  --jr

@item
@b{Punctum}
@tab
@lilypond[staffsize=26,line-width=1.5\cm]
\include "gregorian.ly"
\score {
  \relative {
    % Punctum
    \[ b' \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ b \]}

@item
@tab
@lilypond[staffsize=26,line-width=1.5\cm]
\include "gregorian.ly"
\score {
  \relative {
    % Punctum
    \[ \cavum b' \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ \cavum b \]}

@item
@tab
@lilypond[staffsize=26,line-width=1.5\cm]
\include "gregorian.ly"
\score {
  \relative {
    % Punctum
    \[ \linea b' \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ \linea b \]}

@item
@emph{Punctum Auctum Ascendens}
@tab
@lilypond[staffsize=26,line-width=2.5\cm]
\include "gregorian.ly"
\score {
  \relative {
    % Punctum Auctum Ascendens
    \[ \auctum \ascendens b' \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ \auctum \ascendens b \]}

@item
@emph{Punctum Auctum Descendens}
@tab
@lilypond[staffsize=26,line-width=2.5\cm]
\include "gregorian.ly"
\score {
  \relative {
    % Punctum Auctum Descendens
    \[ \auctum \descendens b' \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ \auctum \descendens b \]}

@item
@b{Punctum inclinatum}
@tab
@lilypond[staffsize=26,line-width=1.5\cm]
\include "gregorian.ly"
\score {
  \relative {
    % Punctum Inclinatum
    \[ \inclinatum b' \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ \inclinatum b \]}

@item
@emph{Punctum Inclinatum Auctum}
@tab
@lilypond[staffsize=26,line-width=2.5\cm]
\include "gregorian.ly"
\score {
  \relative {
    % Punctum Inclinatum Auctum
    \[ \inclinatum \auctum b' \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ \inclinatum \auctum b \]}

@item
@emph{Punctum Inclinatum Parvum}
@tab
@lilypond[staffsize=26,line-width=1.0\cm]
\include "gregorian.ly"
\score {
  \relative {
    % Punctum Inclinatum Parvum
    \[ \inclinatum \deminutum b' \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ \inclinatum \deminutum b \]}

@item
@b{Virga}
@tab
@lilypond[staffsize=26,line-width=1.0\cm]
\include "gregorian.ly"
\score {
  \relative {
    % Virga
    \[ \virga b' \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab

@end multitable

@noindent
@b{Ligatures sur deux notes}

@multitable @columnfractions .4 .2 .4

@item
@b{Clivis vel Flexa}
@tab
@lilypond[staffsize=26,line-width=1.0\cm]
\include "gregorian.ly"
\score {
  \relative {
    % Clivis vel Flexa
    \[ b' \flexa g \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ b \flexa g \]}

@item
@emph{Clivis Aucta Descendens}
@tab
@lilypond[staffsize=26,line-width=2.0\cm]
\include "gregorian.ly"
\score {
  \relative {
    % Clivis Aucta Descendens
    \[ b' \flexa \auctum \descendens g \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ b \flexa \auctum \descendens g \]}
@item
@emph{Clivis Aucta Ascendens}
@tab
@lilypond[staffsize=26,line-width=2.0\cm]
\include "gregorian.ly"
\score {
  \relative {
    % Clivis Aucta Ascendens
    \[ b' \flexa \auctum \ascendens g \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ b \flexa \auctum \ascendens g \]}

@item
@emph{Cephalicus}
@tab
@lilypond[staffsize=26,line-width=2.0\cm]
\include "gregorian.ly"
\score {
  \relative {
    % Cephalicus
    \[ b' \flexa \deminutum g \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ b \flexa \deminutum g \]}

@item
@b{Podatus/Pes}
@tab
@lilypond[staffsize=26,line-width=1.0\cm]
\include "gregorian.ly"
\score {
  \relative {
    % Podatus vel Pes
    \[ g' \pes b \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ g \pes b \]}

@item
@emph{Pes Auctus Descendens}
@tab
@lilypond[staffsize=26,line-width=1.0\cm]
\include "gregorian.ly"
\score {
  \relative {
    % Pes Auctus Descendens
    \[ g' \pes \auctum \descendens b \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ g \pes \auctum \descendens b \]}

@item
@emph{Pes Auctus Ascendens}
@tab
@lilypond[staffsize=26,line-width=1.0\cm]
\include "gregorian.ly"
\score {
  \relative {
    % Pes Auctus Ascendens
    \[ g' \pes \auctum \ascendens b \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ g \pes \auctum \ascendens b \]}

@item
@emph{Epiphonus}
@tab
@lilypond[staffsize=26,line-width=1.0\cm]
\include "gregorian.ly"
\score {
  \relative {
    % Epiphonus
    \[ g' \pes \deminutum b \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ g \pes \deminutum b \]}

@item
@emph{Pes Initio Debilis}
@tab
@lilypond[staffsize=26,line-width=1.0\cm]
\include "gregorian.ly"
\score {
  \relative {
    % Pes Initio Debilis
    \[ \deminutum g' \pes b \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ \deminutum g \pes b \]}

@item
@emph{Pes Auctus Descendens Initio Debilis}
@tab
@lilypond[staffsize=26,line-width=1.0\cm]
\include "gregorian.ly"
\score {
  \relative {
    % Pes Auctus Descendens Initio Debilis
    \[ \deminutum g' \pes \auctum \descendens b \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ \deminutum g \pes \auctum \descendens b \]}

@end multitable

@noindent
@b{Ligatures sur plusieurs notes}

@multitable @columnfractions .4 .2 .4

@item
@b{Torculus}
@tab
@lilypond[staffsize=26,line-width=1.0\cm]
\include "gregorian.ly"
\score {
  \relative {
    % Torculus
    \[ a' \pes b \flexa g \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ a \pes b \flexa g \]}

@item
@emph{Torculus Auctus Descendens}
@tab
@lilypond[staffsize=26,line-width=1.0\cm]
\include "gregorian.ly"
\score {
  \relative {
    % Torculus Auctus Descendens
    \[ a' \pes b \flexa \auctum \descendens g \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ a \pes b \flexa \auctum \descendens g \]}

@item
@emph{Torculus Deminutus}
@tab
@lilypond[staffsize=26,line-width=1.0\cm]
\include "gregorian.ly"
\score {
  \relative {
    % Torculus Deminutus
    \[ a' \pes b \flexa \deminutum g \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ a \pes b \flexa \deminutum g \]}

@item
@emph{Torculus Initio Debilis}
@tab
@lilypond[staffsize=26,line-width=1.0\cm]
\include "gregorian.ly"
\score {
  \relative {
    % Torculus Initio Debilis
    \[ \deminutum a' \pes b \flexa g \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ \deminutum a \pes b \flexa g \]}

@item
@emph{Torculus Auctus Descendens Initio Debilis}
@tab
@lilypond[staffsize=26,line-width=1.0\cm]
\include "gregorian.ly"
\score {
  \relative {
    % Torculus Auctus Descendens Initio Debilis
    \[ \deminutum a' \pes b \flexa \auctum \descendens g \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ \deminutum a \pes b \flexa \auctum \descendens g \]}

@item
@emph{Torculus Deminutus Initio Debilis}
@tab
@lilypond[staffsize=26,line-width=1.0\cm]
\include "gregorian.ly"
\score {
  \relative {
    % Torculus Deminutus Initio Debilis
    \[ \deminutum a' \pes b \flexa \deminutum g \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ \deminutum a \pes b \flexa \deminutum g \]}

@item
@b{Porrectus}
@tab
@lilypond[staffsize=26,line-width=1.0\cm]
\include "gregorian.ly"
\score {
  \relative {
    % Porrectus
    \[ a' \flexa g \pes b \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ a \flexa g \pes b \]}

@item
@emph{Porrectus Auctus Descendens}
@tab
@lilypond[staffsize=26,line-width=1.0\cm]
\include "gregorian.ly"
\score {
  \relative {
    % Porrectus Auctus Descendens
    \[ a' \flexa g \pes \auctum \descendens b \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ a \flexa g \pes \auctum \descendens b \]}

@item
@emph{Porrectus Deminutus}
@tab
@lilypond[staffsize=26,line-width=1.0\cm]
\include "gregorian.ly"
\score {
  \relative {
    % Porrectus Deminutus
    \[ a' \flexa g \pes \deminutum b \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ a \flexa g \pes \deminutum b \]}

@item
@b{Climacus}
@tab
@lilypond[staffsize=26,line-width=1.0\cm]
\include "gregorian.ly"
\score {
  \relative {
    % Climacus
    \[ \virga b' \inclinatum a \inclinatum g \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ \virga b \inclinatum a \inclinatum g \]}

@item
@emph{Climacus Auctus}
@tab
@lilypond[staffsize=26,line-width=1.0\cm]
\include "gregorian.ly"
\score {
  \relative {
    % Climacus Auctus
    \[ \virga b' \inclinatum a \inclinatum \auctum g \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ \virga b \inclinatum a \inclinatum \auctum g \]}

@item
@emph{Climacus Deminutus}
@tab
@lilypond[staffsize=26,line-width=1.0\cm]
\include "gregorian.ly"
\score {
  \relative {
    % Climacus Deminutus
    \[ \virga b' \inclinatum a \inclinatum \deminutum g \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ \virga b \inclinatum a \inclinatum \deminutum g \]}

@item
@b{Scandicus}
@tab
@lilypond[staffsize=26,line-width=1.0\cm]
\include "gregorian.ly"
\score {
  \relative {
    % Scandicus
    \[ g' \pes a \virga b \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ g \pes a \virga b \]}

@item
@emph{Scandicus Auctus Descendens}
@tab
@lilypond[staffsize=26,line-width=1.0\cm]
\include "gregorian.ly"
\score {
  \relative {
    % Scandicus Auctus Descendens
    \[ g' \pes a \pes \auctum \descendens b \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ g \pes a \pes \auctum \descendens b \]}

@item
@emph{Scandicus Deminutus}
@tab
@lilypond[staffsize=26,line-width=1.0\cm]
\include "gregorian.ly"
\score {
  \relative {
    % Scandicus Deminutus
    \[ g' \pes a \pes \deminutum b \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ g \pes a \pes \deminutum b \]}

@end multitable

@noindent
@b{Signes spéciaux}

@multitable @columnfractions .4 .2 .4

@item
@b{Quilisma}
@tab
@lilypond[staffsize=26,line-width=1.0\cm]
\include "gregorian.ly"
\score {
  \relative {
    % Quilisma
    \[ g' \pes \quilisma a \pes b \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ g \pes \quilisma a \pes b \]}

@item
@emph{Quilisma Pes Auctus Descendens}
@tab
@lilypond[staffsize=26,line-width=1.0\cm]
\include "gregorian.ly"
\score {
  \relative {
    % Quilisma Pes Auctus Descendens
    \[ g' \quilisma a \pes \auctum \descendens b \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ \quilisma g \pes \auctum \descendens b \]}

@item
@b{Oriscus}
@tab
@lilypond[staffsize=26,line-width=1.0\cm]
\include "gregorian.ly"
\score {
  \relative {
    % Oriscus
    \[ \oriscus b' \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ \oriscus b \]}

@item
@emph{Pes Quassus}
@tab
@lilypond[staffsize=26,line-width=1.0\cm]
\include "gregorian.ly"
\score {
  \relative {
    % Pes Quassus
    \[ \oriscus g' \pes \virga b \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ \oriscus g \pes \virga b \]}

@item
@emph{Pes Quassus Auctus Descendens}
@tab
@lilypond[staffsize=26,line-width=1.0\cm]
\include "gregorian.ly"
\score {
  \relative {
    % Pes Quassus Auctus Descendens
    \[ \oriscus g' \pes \auctum \descendens b \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ \oriscus g \pes \auctum \descendens b \]}

@item
@b{Salicus}
@tab
@lilypond[staffsize=26,line-width=1.0\cm]
\include "gregorian.ly"
\score {
  \relative {
    % Salicus
    \[ g' \oriscus a \pes \virga b \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ g \oriscus a \pes \virga b \]}

@item
@emph{Salicus Auctus Descendens}
@tab
@lilypond[staffsize=26,line-width=1.0\cm]
\include "gregorian.ly"
\score {
  \relative {
    % Salicus Auctus Descendens
    \[ g' \oriscus a \pes \auctum \descendens b \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ g \oriscus a \pes \auctum \descendens b \]}

@item
@b{(Apo)stropha}
@tab
@lilypond[staffsize=26,line-width=1.0\cm]
\include "gregorian.ly"
\score {
  \relative {
    % Stropha
    \[ \stropha b' \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ \stropha b \]}

@item
@emph{Stropha Aucta}
@tab
@lilypond[staffsize=26,line-width=1.0\cm]
\include "gregorian.ly"
\score {
  \relative {
    % Stropha Aucta
    \[ \stropha \auctum b' \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ \stropha \auctum b \]}

@item
@b{Bistropha}
@tab
@lilypond[staffsize=26,line-width=1.0\cm]
\include "gregorian.ly"
\score {
  \relative {
    % Bistropha
    \[ \stropha b' \stropha b \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ \stropha b \stropha b \]}

@item
@b{Tristropha}
@tab
@lilypond[staffsize=26,line-width=1.0\cm]
\include "gregorian.ly"
\score {
  \relative {
    % Tristropha
    \[ \stropha b' \stropha b \stropha b \]
  }
\layout { \neumeDemoLayout }}
@end lilypond
@tab
@code{\[ \stropha b \stropha b \stropha b \]}

@item
@emph{Trigonus}
@tab
@lilypond[staffsize=26,line-width=1.0\cm]
\include "gregorian.ly"
\score {
  \relative {
    % Trigonus
    \[ \stropha b' \stropha b \stropha a \]
  }
  \layout { \neumeDemoLayout }
}
@end lilypond
@tab
@code{\[ \stropha b \stropha b \stropha a \]}

@end multitable

@predefined
LilyPond dispose des préfixes suivants :
@funindex \virga
@code{\virga},
@funindex \stropha
@code{\stropha},
@funindex \inclinatum
@code{\inclinatum},
@funindex \auctum
@code{\auctum},
@funindex \descendens
@code{\descendens},
@funindex \ascendens
@code{\ascendens},
@funindex \oriscus
@code{\oriscus},
@funindex \quilisma
@code{\quilisma},
@funindex \deminutum
@code{\deminutum},
@funindex \cavum
@code{\cavum},
@funindex \linea
@code{\linea}.
@endpredefined

Les préfixes de note peuvent s'agglutiner, modulo quelques restrictions.
Par exemple, on peut appliquer un @code{\descendens} ou un
@code{\ascendens} à une note, mais pas les deux simultanément à une même
note.

@funindex \pes
@funindex \flexa

Deux notes adjacentes peuvent être reliées grâce aux commandes
@code{\pes} ou @code{\flexa} pour marquer une ligne mélodique
respectivement ascendante ou descendante.

@funindex \augmentum

Utilisez la fonction musicale unaire @code{\augmentum} pour ajouter
des points d'augmentum.

@seealso
Glossaire musicologique :
@rglos{ligature}.

Manuel de notation :
@ref{Ligatures mensurales},
@ref{Ligatures}.

@knownissues
Lorsqu'un @code{\augmentum} apparaît dans une ligature en fin de
portée, son placement vertical peut être erroné.  Pour y remédier,
ajoutez un silence invisible, @code{s8} par exemple, comme dernière note de
cette portée.

L'@code{\augmentum} devrait être implémenté en tant que préfixe plutôt
qu'en tant que fonction unaire, afin qu'@code{\augmentum} puisse
s'intégrer avec d'autres préfixes dans n'importe quel ordre.


@node Typographie de notation kiévienne
@subsection Typographie de notation kiévienne
@translationof Typesetting Kievan square notation

@cindex kiévien
@cindex Kievan

@menu
* Contextes de notation kiévienne::
* Clefs kiéviennes::
* Notes kiéviennes::
* Altérations kiéviennes::
* Barre de mesure kiévienne::
* Mélismes kiéviens::
@end menu


@node Contextes de notation kiévienne
@unnumberedsubsubsec Contextes de notation kiévienne
@translationof Kievan contexts

@cindex KievanVoiceContext
@cindex KievanStaffContext

Tout comme pour les notations grégorienne et mensurale, les contextes
prédéfinis @code{KievanVoice} et @code{KievanStaff} permettent de
générer une partition en notation carrée.  Ces contextes initialisent
les propriétés de tous les autres contextes et objets graphiques à des
valeurs adéquates, de telle sorte que vous pouvez tout de suite vous
lancer dans la saisie de votre chant, comme ci-dessous :

@lilypond[quote,ragged-right,verbatim]
\score {
  <<
    \new KievanVoice = "melody" \relative c' {
      \cadenzaOn
        c4 c c c c2 b\longa
        \bar "k"
    }
    \new Lyrics \lyricsto "melody" {
      Го -- спо -- ди по -- ми -- луй.
    }
  >>
}
@end lilypond

@seealso
Glossaire musicologique :
@rglosnamed{kievan notation, notation kiévienne}.

@knownissues
LilyPond prend en charge la notation kiévienne du style synodal,
correspondant au corpus du Saint Synode russe des années 1910, récemment
réédité par les éditions du patriarcat de Moscou.  LilyPond ne prend pas
en charge les formes plus anciennes et moins répandues de notation
kiévienne que l'on trouvait en Galicie pour noter le plain-chant ruthène.


@node Clefs kiéviennes
@unnumberedsubsubsec Clefs kiéviennes
@translationof Kievan clefs

@cindex kiévienne, clef

La notation kiévienne n'utilise qu'une seule clef -- la clef
« Tse-fa-ut » -- qui indique la position du do :

@lilypond[quote,relative=1,notime,verbatim]
  \clef "kievan-do"
  \kievanOn
  c
@end lilypond

@seealso
Glossaire musicologique :
@rglosnamed{kievan notation, notation kiévienne},
@rglos{clef}.

Manuel de notation :
@ref{Clefs}.


@node Notes kiéviennes
@unnumberedsubsubsec Notes kiéviennes
@translationof Kievan notes

@cindex kiéviennnes, têtes de note

La notation kiévienne requiert l'utilisation d'un style de tête de
note particulier et la désactivation des hampes et crochets
classiques.  La fonction @code{\kievanOn} se charge d'affecter à
les propriétés adéquates aux têtes de note, hampes et crochets.
Un simple @code{\kievanOff} permet de retrouver le comportement
par défaut de LilyPond.

En notation kiévienne, la note finale d'une pièce apparaît souvent sous
la forme d'une @code{\longa}.  L'indication d'un récitatif -- plusieurs
syllabes sont chantées sur une même hauteur -- s'effectue à l'aide d'une
@code{\breve}.  Voici ce à quoi ressemblent les différentes notes
kiéviennes :

@lilypond[quote,fragment,ragged-right,verbatim]
\autoBeamOff
\cadenzaOn
\kievanOn
b'1 b'2 b'4 b'8 b'\breve b'\longa
\kievanOff
b'2
@end lilypond

@seealso
Glossaire musicologique :
@rglosnamed{kievan notation, notation kiévienne},
@rglosnamed{note head, tête de note}.

Manuel de notation :
@ref{Styles de tête de note}.

@knownissues
LilyPond détermine automatiquement l'orientation des hampes.  Il est
cependant d'usage, en notation carrée, que les hampes des différentes
notes d'un même mélisme aillent toutes dans le même sens ; il faudra
donc en pareil cas définir manuellement la propriété @code{direction} de
l'objet @code{Stem}.


@node Altérations kiéviennes
@unnumberedsubsubsec Altérations kiéviennes
@translationof Kievan accidentals

@cindex kiéviennes, altérations

Le style d'altération propre à la notation kiévienne est accessible au
travers de la propriété @code{glyph-name-alist} de l'objet
@code{Accidental}.  Le style @code{kievan} dispose d'un dièse et d'un
bémol, tous deux différents du style par défaut ; il n'y a pas de
bécarre en notation kiévienne.  Bien que le dièse soit pas utilisé en
notation synodale, on peut le trouver dans certains manuscrits plus
anciens.

@lilypond[quote,relative=1,notime,verbatim]
\clef "kievan-do"
\override Accidental.glyph-name-alist =
 #alteration-kievan-glyph-name-alist
bes' dis,
@end lilypond

@seealso
Glossaire musicologique :
@rglosnamed{kievan notation, notation kiévienne},
@rglosnamed{accidental, altération}.

Manuel de notation :
@ref{Altérations},
@ref{Altérations accidentelles automatiques},
@ref{La fonte Feta}


@node Barre de mesure kiévienne
@unnumberedsubsubsec Barre de mesure kiévienne
@translationof Kievan bar line

Les pièces en notation kiévienne sont habituellement terminées par une
décoration qui fait office de barre finale.  Elle s'obtient à l'aide
d'un @code{\bar "k"}.

@lilypond[quote,relative=1,notime,verbatim]
  \kievanOn
  \clef "kievan-do"
  c \bar "k"
@end lilypond

@seealso
@ref{Barres de mesure},
@ref{La fonte Feta}

@node Mélismes kiéviens
@unnumberedsubsubsec Mélismes kiéviens
@translationof Kievan melismata

@cindex ligatures

Les notes formant un mélisme kiévien sont habituellement rapprochées les
unes des autres, les mélismes étant espacés les uns des autres.  Ceci
permet au chantre d'identifier aisément les structures mélodiques d'un
chant @emph{Znamenny}.  Les mélismes sont traites par LilyPond comme des
ligatures dont l'espacement est géré par le
@code{Kievan_ligature_engraver}.

Le @code{Kievan_ligature_engraver} est activé par défaut pour les
contextes @code{KievanVoice} et @code{KievanStaff}.  Pour les autres
contextes, il s'active au sein d'un bloc @code{layout} dans lequel est
désactivé le @code{Ligature_bracket_engraver}.

@example
\layout @{
  \context @{
    \Voice
    \remove "Ligature_bracket_engraver"
    \consists "Kievan_ligature_engraver"
  @}
@}
@end example

L'espacement des notes d'une ligature kiévienne se gère à l'aide de la
propriété @code{padding} de @code{KievanLigature}.

Voici comment générer des ligatures en notation kiévienne :

@lilypond[quote,ragged-right,verbatim]
\score {
  <<
    \new KievanVoice = "melody" \relative c' {
      \cadenzaOn
        e2 \[ e4( d4 ) \] \[ c4( d e  d ) \] e1 \bar "k"
    }
    \new Lyrics \lyricsto "melody" {
      Га -- врі -- и -- лу
    }
  >>
}
@end lilypond

@seealso
Glossaire musicologique :
@rglos{ligature}.

Manuel de notation :
@ref{Ligatures},
@ref{Ligatures mensurales},
@ref{Neumes et ligatures grégoriennes}.

@knownissues
L'espacement des ligatures n'est pas des meilleurs.


@node Réédition de musique ancienne
@subsection Réédition de musique ancienne
@translationof Working with ancient music---scenarios and solutions

@menu
* Des incipits::
* Mise en forme de la musique mensurale::
* Transcription de chant grégorien::
* Éditions ancienne et moderne à partir d'une même source::
* Notation éditoriale::
@end menu

Travailler sur de la musique ancienne requiert bien souvent des tâches
particulières et qui s'éloignent fortement de la notation moderne pour
laquelle LilyPond est conçu.  Nous allons aborder, au fil des
paragraphes qui suivent, un certain nombre de cas particuliers et vous
proposer des suggestions, voire des solutions aux problèmes que vous
ne manquerez pas de rencontrer.  Ceci inclut entre autres :

@itemize
@item comment réaliser un incipit, autrement dit un court extrait
montrant ce à quoi ressemblait l'original, en introduction à la
transcription d'une œuvre médiévale ;
@item comment obtenir une présentation @emph{Mensurstriche} comme on
peut le voir dans nombre de transcriptions de musique
polyphonique ;
@item comment transcrire du grégorien en notation moderne ;
@item comment obtenir à la fois une reproduction en notation ancienne et
une édition en notation moderne à partir d'une même source.
@end itemize


@node Des incipits
@unnumberedsubsubsec Des incipits
@translationof Incipits

@cindex incipit
@cindex ajout d'incipit

@funindex \incipit
@funindex incipit

Il est d'usage, lorsque l'on transcrit de la musique ancienne en
notation moderne, d'indiquer aussi comment apparaissaient les silences
ou notes initiaux dans la version originale, y compris la clef.  Ceci
s'appelle un @emph{incipit}.  La commande @code{\incipit} utilise le
@code{indent} de la portée principale pour déterminer la place occupée
par l'incipit, et @code{incipit-width} pour déterminer la longueur de la
portée d'incipit.

@lilypond[verbatim,quote,ragged-right]
\score {
  \new Staff <<
    \new Voice = Tenor {
      \set Staff.instrumentName = #"Tenor"
      \override Staff.InstrumentName.self-alignment-X = #RIGHT
      \incipit { \clef "mensural-c4" \key f \major r\breve r1 c'1 }
      \clef "treble_8"
      \key f \major
      R1 r2 c'2 |
      a4. c'8
    }
    \new Lyrics \lyricsto Tenor { Cyn -- thia your }
  >>
  \layout
  {
    indent = 5\cm
    incipit-width = 3\cm
  }
}
@end lilypond

@knownissues
La propriété @code{instrumentName} doit se placer au sein de la musique
de l'incipit à produire.  Lorsqu'il n'y a pas de nom d'instrument, il
faut cependant le définir avec @code{\set Staff.instrumentName = #""}.

@seealso
@c ... and reference to other sections ...
Morceaux choisis:
@rlsrnamed{Ancient notation, Notations anciennes}.


@node Mise en forme de la musique mensurale
@unnumberedsubsubsec Mise en forme de la musique mensurale
@translationof Mensurstriche layout

@emph{Mensurstriche}, pour @qq{lignes de mensuration}, est le terme
consacré lorsque les barres de mesure apparaissent uniquement entre les
portées d'un système.  Cette présentation permet de préserver l'aspect
rythmique de l'original -- par exemple sans couper une syncope par
l'apparition d'une barre -- tout en procurant l'aide que peuvent
constituer les barres de mesure.

@lilypondfile[verbatim,quote,texidoc]
{mensurstriche-layout-bar-lines-between-the-staves.ly}

@c This simple setup will take care of the
@c TODO Add text about lyrics to the lowest line, to be placed
@c outside the StaffGroup.
@c from lsr and -user
@c TBC

@c @seealso
@c ... and reference to other sections ...


@node Transcription de chant grégorien
@unnumberedsubsubsec Transcription de chant grégorien
@translationof Transcribing Gregorian chant

Une transcription d'un chant grégorien en notation moderne s'obtient
grâce à quelques simples artifices.

@b{Hampes}.  La gravure des hampes s'annule en supprimant le graveur
@code{Stem_engraver} du contexte de voix :

@example
\layout @{
  @dots{}
  \context @{
    \Voice
      \remove "Stem_engraver"
  @}
@}
@end example

@b{Temps}.  En matière de chant non mesuré, plusieurs alternatives
s'offrent à vous.

La suppression du @code{Time_signature_engraver} du contexte
@code{Staff} ne produit aucun effet négatif.  Une alternative serait de
rendre la métrique transparente, ce qui par contre préservera l'espace
qu'elle occupe.

Dans de nombreux cas, une clause @code{\set Score.timing = ##f} donne de
bons résultats.  On pourrait aussi utiliser @code{\cadenzaOn} et
@code{\cadenzaOff}.

Rien de plus radical que de supprimer du contexte @code{Staff} le
@code{Bar_engraver} pour ne pas voir de barre de mesure.  Là aussi, une
clause @code{\hide BarLine} vous permettra d'en afficher une au besoin.

Dans de nombreuses transcriptions, le récitatif fait apparaître une
brève au lieu de la répétition d'une même note.  Le texte psalmodié se
présente alors sous la forme d'une unique syllabe alignée à
gauche :

@lilypond[verbatim,ragged-right]
\include "gregorian.ly"
chant = \relative {
  \clef "G_8"
  c'\breve c4 b4 a c2 c4  \divisioMaior
  c\breve c4 c f, f \finalis
}

verba = \lyricmode {
  \once \override LyricText.self-alignment-X = #-1
  "Noctem quietam et" fi -- nem per -- fec -- tum
  \once \override LyricText.self-alignment-X = #-1
  "concedat nobis Dominus" om -- ni -- po -- tens.
}
\score {
  \new Staff <<
  \new Voice = "melody" \chant
  \new Lyrics = "one" \lyricsto melody \verba
  >>
  \layout {
    \context {
      \Staff
      \remove "Time_signature_engraver"
      \remove "Bar_engraver"
    }
    \context {
      \Voice
      \remove "Stem_engraver"
    }
  }
}
@end lilypond

Ceci fonctionne bien tant que le texte ne risque pas de déborder de la
ligne.  Si tel était le cas, on pourrait plutôt ajouter des notes
masquées comme ci dessous.

Certaines transcriptions laissent néanmoins apparaître
occasionnellement des hampes, notamment pour indiquer la transition
entre un récitatif monodique et une phrase mélodique.  Il suffit en
pareil cas d'utiliser plutôt @code{\hide Stem}
ou @code{\override Stem.length = #0} puis, en cas de besoin, recourir
à une clause @code{\once \override Stem.transparent = ##f}.

@lilypond[verbatim,ragged-right]
\include "gregorian.ly"
chant = \relative {
  \clef "G_8"
  \set Score.timing = ##f
  \hide Stem
  c'\breve \hide NoteHead  c c c c c
  \undo \hide NoteHead
  \undo \hide Stem \stemUp c4 b4 a
  \hide Stem c2 c4  \divisioMaior
  c\breve \hide NoteHead c c c c c c c
  \undo \hide NoteHead c4 c f, f \finalis
}

verba = \lyricmode {
  No -- ctem qui -- e -- tam et fi -- nem per -- fec -- tum
  con -- ce -- dat no -- bis Do -- mi -- nus om -- ni -- po -- tens.
}

\score {
  \new Staff <<
    \new Voice = "melody" \chant
    \new Lyrics \lyricsto "melody" \verba
  >>
  \layout {
    \context {
      \Staff
      \remove "Time_signature_engraver"
      \hide BarLine
    }
  }
}
@end lilypond

Autre situation courante, la transcription de chant neumatique contenant
des mélismes, autrement dit, une psalmodie dans laquelle le nombre de
syllabes varie selon les notes.  Vous pourriez alors avoir envie
d'indiquer clairement le découpage des groupes de syllabes ainsi que
les subdivisions d'un mélisme.  Le moyen pour y parvenir consiste à
utiliser une métrique fixe, mettons @code{\time 1/4}, et de faire
en sorte que chaque syllabe ou groupe de notes tienne dans une mesure, à
l'aide de triolets ou de durées inférieures.  Tant que les barres de
mesure et autres éléments rythmiques restent transparents, et que
l'espacement en regard des barres est accru, la représentation en
notation moderne devrait être tout à fait satisfaisante.

Pour une répartition plus homogène de syllabes de longueur différente --
telles que @qq{-ri} et @qq{-rum} -- selon les groupes de note, une
solution consiste à figer la propriété @code{'X-extent} de l'objet
@code{LyricText}.  Ceci s'avère moins fastidieux que d'ajouter des
syllabes sous forme de @emph{markup}.  Des ajustements supplémentaires
peuvent se réaliser avec des @qq{notes silencieuses} (@code{s}).

@lilypond[verbatim,quote]
spiritus = \relative {
  \time 1/4
  \override Lyrics.LyricText.X-extent  = #'(0 . 3)
  d'4 \tuplet 3/2 { f8 a g } g a a4 g f8 e
  d4 f8 g g8 d f g a g f4 g8 a a4  s
  \tuplet 3/2 { g8 f d } e f g a g4
}

spirLyr = \lyricmode {
  Spi -- ri -- _ _ tus  _ Do -- mi -- ni  _ re -- ple -- _ vit _
  or -- _ bem _  ter -- ra -- _ rum, al -- _ _ le -- _ lu
  -- _ ia.
}
\score {
  \new Staff <<
    \new Voice = "chant" \spiritus
    \new Lyrics = "one" \lyricsto "chant" \spirLyr
  >>
  \layout {
    \context {
      \Staff
      \remove "Time_signature_engraver"
      \override BarLine.X-extent = #'(-1 . 1)
      \hide Stem
      \hide Beam
      \hide BarLine
      \hide TupletNumber
    }
  }
}
@end lilypond

@c extract from 1.6.1.1

@c @seealso
@c ... and reference to other sections ...


@node Éditions ancienne et moderne à partir d'une même source
@unnumberedsubsubsec Éditions ancienne et moderne à partir d'une même source
@translationof Ancient and modern from one source

@c TODO Add text
@c Here among others the snippets about reducing note length
@emph{En cours de rédaction}

@c @seealso
@c ... and reference to other sections ...


@node Notation éditoriale
@unnumberedsubsubsec Notation éditoriale
@translationof Editorial markings

@emph{En cours de rédaction}


@c @node Baroque rhythmic notation
@c @unnumberedsubsubsec Baroque rhythmic notation

@c TODO Add text
@c try Till Rettig
@c Add example of white note heads:
@c In the french baroque some composers used white note heads in slow pieces,
@c mainly in 3/2-time.  A quarter looks there like an eighth with a white
@c note head.  (Franz-Rudolf Kuhnen)

@c TODO Add example of this:
@c I was referring to e.g. notated a8. a16, which should, if I
@c remember correctly, be interpreted more like a8.. a32 (in the french
@c style).  The editor might want to show that rythmic figure above the
@c staff as an hint to performers.  (Karl Hammer)


@c TBC

@c @seealso
@c ... and reference to other sections ...