Issue 4894: Remove unescaped @funindex entries

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

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

@ignore
   Translation of GIT committish: 3ff93fbd01133506d14c929740bd26b34f59c5b4

   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.25"

@c Translators: Valentin Villenave, Jean-Charles Malahieude
@c Translation checkers: Jean-Charles Malahieude, John Mandereau

@node Instruments utilisant des portées multiples
@section Instruments utilisant des portées multiples
@translationof Keyboard and other multi-staff instruments

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

Ce chapitre traite des différents aspects de la notation que l'on
rencontre particulièrement avec les instruments qui ont recours à
plusieurs portées, tels que ceux disposant de claviers, la harpe ou
le vibraphone.  Pour les besoins du discours, et pour simplifier, nous
parlerons ici de « clavier » bien que le recours à des portées
multiples concerne aussi des instruments qui en sont dépourvus.

@menu
* Vue d'ensemble des claviers::
* Piano::
* Accordéon::
* Harpe::
@end menu


@node Vue d'ensemble des claviers
@subsection Vue d'ensemble des claviers
@translationof Common notation for keyboards

Nous allons examiner ici les problèmes qui peuvent survenir en matière
de notation pour la plupart des instrument à cordes multiples.

@menu
* Généralités sur les instruments à clavier::
* Changement de portée manuel::
* Changement de portée automatique::
* Lignes de changement de portée::
* Hampes et changements de portée::
@end menu


@node Généralités sur les instruments à clavier
@unnumberedsubsubsec Généralités sur les instruments à clavier
@translationof References for keyboards

@cindex piano, système pour
@cindex portées pour piano
@cindex portées pour instrument à clavier
@cindex portées pour instrument à clés
@cindex clavier, portées pour instrument à
@cindex clés, portées pour instrument à
@cindex claviers, centrage des nuances
@cindex nuances entre les portées d'un système pianistique
@cindex piano, nuances entre les portées
@cindex centrage des nuances entre deux portées de piano

@funindex PianoStaff

La notation pour instrument à clavier est en règle générale présentée
sous la forme d'un système pour piano, autrement dit deux portées
normales ou plus réunies par une accolade. Cette notation sert également
à la harpe ou à d'autres instruments à clés.  L'organiste, quant à lui,
lira une partition composée de deux portées au sein d'un système
pianistique auquel vient s'adjoindre une portée normale pour le pédalier.

Les portées sont largement autonomes, mais il arrive que des voix
passent de l'une à l'autre.  Le contexte @code{PianoStaff} est
précisément conçu pour gérer la notation spécifique au piano et autres
instruments à clavier, notamment ces croisements.

Certaines particularités de la notation pour claviers sont abordées dans
d'autres chapitres :

@itemize

@item
Les claviers ont régulièrement recours à plusieurs voix dont le
nombre peut varier. Voir à ce sujet @ref{Résolution des collisions}.

@item
On peut écrire la musique pour claviers de façon parallèle, comme
l'explique @ref{Saisie de musique en parallèle}.

@item
Les nuances peuvent se gérer dans un contexte @code{Dynamics} qu'il
suffira d'insérer entre les deux contextes @code{Staff} pour qu'elles
apparaissent sur leur propre ligne centrée entre les deux portées.  Voir
à ce sujet @ref{Nuances}.

@item
Les indications de doigté sont abordées dans @ref{Doigtés}.

@item
Les indications en matière de pédalier d'orgue sont traitées comme
des articulations. Voir à ce sujet
@ref{Liste des signes d'articulation}.

@item
Pour générer des repères verticaux, voir @ref{Quadrillage temporel}.

@item
En plus des @notation{Laissez vibrer}, les liaisons en matière de
clavier peuvent intervenir sur des accords arpégés ou des trémolos.
Reportez-vous au chapitre @ref{Liaisons de prolongation}.

@item
Le traitement des arpèges couvrant plusieurs voix ou portées est
abordé au chapitre @ref{Arpèges}.

@item
Une description des indications de trémolo est disponible au
chapitre @ref{Répétitions en trémolo}.

@item
Certaines retouches particulières au monde des claviers sont
abordées au chapitre @rlearning{Exemple concret}.

@item
Des notes fantômes permettent d'introduire des liaisons de tenue
qui passent d'une voix à l'autre, comme le montre
@rlearning{Autres utilisations des retouches}.

@end itemize


@c @snippets
@c @lilypondfile[verbatim,quote,texidoc,doctitle]
@c {forcing-visibility-of-systems-with-multi-bar-rests-when-using-\RemoveEmptyStaffContext.ly}
@c http://lsr.di.unimi.it/LSR/Item?u=1&id=312


@seealso
Manuel d'initiation :
@rlearning{Autres utilisations des retouches},
@rlearning{Exemple concret}.

Manuel de notation :
@ref{Arpèges},
@ref{Doigtés},
@ref{Liaisons de prolongation},
@ref{Liste des signes d'articulation},
@ref{Noms d'instrument},
@ref{Quadrillage temporel},
@ref{Regroupement de portées},
@ref{Répétitions en trémolo},
@ref{Résolution des collisions},
@ref{Saisie de musique en parallèle}.

Morceaux choisis :
@rlsrnamed{Keyboards, Claviers}.

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


@node Changement de portée manuel
@unnumberedsubsubsec Changement de portée manuel
@translationof Changing staff manually

@cindex changements de portée manuels
@cindex changement de portée forcé
@cindex inter-portée, notes
@cindex notes inter-portée
@cindex inter-portée, ligatures
@cindex ligature inter-portée

@funindex \change

Il est possible de passer d'une portée à l'autre de façon manuelle, au
moyen de la commande

@example
\change Staff = @var{nomDeLaPortee}
@end example

@noindent
La valeur @var{nomDeLaPortee} est le nom de la portée sur laquelle va se
déplacer la voix courante.  Pour des raisons pratiques, on nomme la
portée supérieure @code{"haut"} et la portée inférieure @code{"bas"},
donc @var{nomDeLaPortee} désigne habituellement @code{"haut"},
@code{"bas"}, @code{"MD"} ou @code{"MG"}.

Dans tous les cas, le contexte de portée ainsi utilisé doit exister au
préalable.  Le cas échéant, vous devrez @qq{garder actives} certaines
portées -- voir @ref{Conservation d'un contexte} à ce propos.

Pour ligaturer automatiquement des notes entre deux portées, procédez
ainsi :

@lilypond[verbatim,quote]
\new PianoStaff <<
  \new Staff = "up" {
    <e' c'>8
    \change Staff = "down"
    g8 fis g
    \change Staff = "up"
    <g'' c''>8
    \change Staff = "down"
    e8 dis e
    \change Staff = "up"
  }
  \new Staff = "down" {
    \clef bass
    % keep staff alive
    s1
  }
>>
@end lilypond

Si les ligatures demandaient à être retouchées, commencez par
modifier la direction des hampes.  L'emplacement des ligatures sera
alors calculé à partir du centre de la portée la plus proche -- voir
@rlearning{Correction des collisions d'objets} pour un exemple de
retouche sur des ligatures.

@cindex changement de portée et collision
@cindex collision et changement de portée

Une voix qui change de portée peut entraîner des collisions :

@lilypond[verbatim,quote]
\new PianoStaff <<
  \new Staff = "up" {
    \voiceOne
    % Make space for fingering in the cross-staff voice
    \once\override DynamicLineSpanner.staff-padding = #4
    e''2\p\< d''\>
    c1\!
  }
  \new Staff = "down" <<
    {
      \clef bass
      s4. e,8\rest g,2\rest
      c1
    } \\ {
      c8\( g c'
      \change Staff = "up"
      e' g' b'-3 a' g'\)
      f'1
    }
  >>
>>
@end lilypond

Hampes et liaisons viennent en surimpression sur la ligne des nuances
parce que la résolution automatique des collisions est inactivée pour
ce qui relie les notes de différentes portées ainsi que pour les hampes
ou extenseurs affectés à des notes incluses dans un changement de
portée.  Lorsque des collisions surviennent en pareil cas, il vous
faudra les résoudre, en suivant les directives du chapitre
@rlearning{Correction des collisions d'objets}.

@seealso
Manuel d'initiation :
@rlearning{Correction des collisions d'objets}.

Manuel de notation :
@ref{Barres de ligature automatiques},
@ref{Conservation d'un contexte},
@ref{Hampes}.

Morceaux choisis :
@rlsrnamed{Keyboards,Claviers}.

Référence des propriétés internes :
@rinternals{Beam},
@rinternals{ContextChange}.

@knownissues
Dans la mesure où l'évitement de collision des ligatures ne fonctionne
pas lorsqu'une ligature automatique prend fin juste avant un changement
de portée, utilisez alors une ligature manuelle.


@node Changement de portée automatique
@unnumberedsubsubsec Changement de portée automatique
@translationof Changing staff automatically

@cindex Changement de portée automatique
@cindex Automatique, changement de portée

@funindex \autochange
@funindex PianoStaff

Les voix peuvent passer automatiquement d'une portée à l'autre, au moyen
de la syntaxe suivante :

@example
\autochange @dots{}@var{musique}@dots{}
@end example

@noindent
Deux portées seront alors créées au sein du contexte @code{PianoStaff},
nommées respectivement @code{"up"} et @code{"down"}.  La portée du bas
sera par défaut en clef de fa.  La commande @code{\autochange} bascule
les notes d'une portée à l'autre en fonction de leur hauteur (le do du
milieu servant de pivot), et place les silences en fonction des notes
qui les suivront. Ainsi :

@lilypond[quote,verbatim]
\new PianoStaff {
  \autochange {
    g4 a b c'
    d'4 r a g
  }
}
@end lilypond

@noindent
Il est tout à fait possible de déterminer une autre hauteur charnière.
Dès lors qu'aucune portée n'a été spécifiquement instanciée, d'autres
clefs peuvent être utilisées.

@lilypond[quote,verbatim]
music = {
  g8 b a c' b8 d' c'8 e'
  d'8 r f' g' a'2
}

\autochange d' \music
\autochange b \with { \clef soprano } \music
\autochange d' \with { \clef alto } \with { \clef tenor } \music
@end lilypond

@cindex mode relatif et autochange
@cindex autochange et mode relatif

@funindex \relative

Une section en mode @code{\relative} se situant en dehors de la commande
@code{\autochange} n'aura pas d'effet sur les hauteurs de l'expression
@var{musique}.  Il est donc préférable d'introduire la directive
@code{\relative} @strong{après} @code{\autochange}.

Lorsque des contrôles particuliers doivent s'appliquer aux portées,
mieux vaut les nommer explicitement -- attention : sous peine
d'effet indésirable quant au résultat, la portée supérieure doit
s'appeler @code{"up"} et l'inférieure @code{"down"} ; @emph{ceci
est à notre connaissance le seul cas où ces noms de variable sont
figés}.  Cette procédure sert, entre autres, à indiquer l'armure sur la
portée inférieure :

@c Keep Ly needed, otherwise 'up' and 'down' get
@c incorrectly translated in verbatim output
@c KEEP LY
@lilypond[quote,verbatim,nogettext]
\new PianoStaff <<
  \new Staff = "up" {
    \new Voice = "melodieUn" {
      \key g \major
      \autochange \relative {
        g8 b a c b d c e
        d8 r fis, g a2
      }
    }
  }
  \new Staff = "down" {
    \key g \major
    \clef bass
  }
>>
@end lilypond

@seealso
Manuel de notation :
@ref{Changement de portée manuel}.

Morceaux choisis :
@rlsrnamed{Keyboards, Claviers}.

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


@knownissues

@cindex accords, répartition sur plusieurs portées avec \autochange

Les changements de portée automatiques n'interviennent pas toujours à
l'endroit le plus opportun.  Pour un résultat de meilleure qualité, il
vaut mieux indiquer soi-même ces changements.

Un accord ne peut se répartir sur plusieurs portées ; sa portée
d'affectation sera déterminée par la première hauteur mentionnée dans la
construction de cet accord.

@code{\autochange} ne peut intervenir à l'intérieur d'une commande
@code{\tuplet}.


@node Lignes de changement de portée
@unnumberedsubsubsec Lignes de changement de portée
@translationof Staff-change lines

@cindex voix entre deux portées
@cindex changements de portée
@cindex mélodie d'une portée à une autre

@funindex followVoice
@funindex \showStaffSwitch
@funindex \hideStaffSwitch

Lorsqu'une voix change de portée, il est possible d'imprimer
automatiquement une ligne reliant les notes, en faisant appel à la
commande @code{\showStaffSwitch} :

@lilypond[quote,verbatim]
\new PianoStaff <<
  \new Staff = "one" {
    \showStaffSwitch
    c'1
    \change Staff = "two"
    b2 a
  }
  \new Staff = "two" {
    \clef bass
    s1*2
  }
>>
@end lilypond

@predefined
@code{\showStaffSwitch},
@code{\hideStaffSwitch}.
@endpredefined

@seealso
Morceaux choisis :
@rlsrnamed{Keyboards, Claviers}.

Référence des propriétés internes :
@rinternals{Note_head_line_engraver},
@rinternals{VoiceFollower}.


@node Hampes et changements de portée
@unnumberedsubsubsec Hampes et changements de portée
@translationof Cross-staff stems

@cindex hampe, enjambement portées
@cindex distance entre deux portées de piano

@funindex Stem
@funindex \crossStaff
@funindex \autoBeamOff
@funindex Span_stem_engraver

Pour écrire des accords qui enjambent deux portées, on allonge, à l'aide
du @code{Span_stem_engraver}, la hampe de l'accord de l'une des deux
portées de façon à ce qu'elle rejoigne celle de l'autre portée.  La
gestion des ligatures automatiques requiert alors une attention
particulière ; en effet, une seule portée devrait alors comporter des
ligatures.

@lilypondfile[verbatim,quote]
{cross-staff-stems.ly}

Il n'est pas possible à l'heure actuelle, en raison de la manière
dont il a été implémenté, de spécifier ce graveur en le mettant entre
guillements ; il faut le mentionner en faisant précéder son nom d'un
symbole @emph{hash} (un @code{#}).

@snippets
@lilypondfile[verbatim,quote,texidoc,doctitle]
{indicating-cross-staff-chords-with-arpeggio-bracket.ly}

@seealso
Morceaux choisis :
@rlsrnamed{Keyboards, Claviers}.

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


@node Piano
@subsection Piano
@translationof Piano

Ce chapitre traite des aspects de la notation directement liés au piano.

@menu
* Pédales de piano::
@end menu


@node Pédales de piano
@unnumberedsubsubsec Pédales de piano
@translationof Piano pedals

@cindex piano et pédales
@cindex pédales de piano
@cindex sustain, pédale
@cindex pédale sustain
@cindex sostenuto, pédale
@cindex pédale sostenuto
@cindex una corda
@cindex tre corde
@cindex sos.
@cindex U.C.

@funindex \sustainOn
@funindex \sustainOff
@funindex \sostenutoOn
@funindex \sostenutoOff
@funindex \unaCorda
@funindex \treCorde

Le piano possède deux pédales, parfois trois, permettant de modifier
l'émission du son : une pédale de @notation{tenue} (@emph{sustain}), une
pédale de @notation{sourdine} (@emph{una corda} ou @emph{U.C.}) et une
pédale @notation{tonale} (@emph{sostenuto} ou @emph{sos.}).  La pédale
@emph{sustain} se rencontre aussi sur les vibraphones et celestas.

@lilypond[quote,verbatim]
\relative {
  c''4\sustainOn d e g
  <c, f a>1\sustainOff
  c4\sostenutoOn e g c,
  <bes d f>1\sostenutoOff
  c4\unaCorda d e g
  <d fis a>1\treCorde
}
@end lilypond

@cindex pédale, styles d'indications de
@cindex pédale, indication textuelle de
@cindex pédale, indication graphique de
@cindex pédale, indication combinée de
@cindex pédale sustain, style
@cindex sustain, style de pédale

@funindex pedalSustainStyle
@funindex mixed
@funindex bracket
@funindex text

Trois styles sont à votre disposition pour imprimer les indications de
pédale : sous forme de texte, de crochet, ou une combinaison des
deux.  @code{text} est le style de notation par défaut pour les pédales
de tenue ou de sourdine --- le traditionnel « *Ped. ».  La pédale
tonale, en revanche, utilise @code{mixed} par défaut.

@lilypond[quote,verbatim]
\relative {
  c''4\sustainOn g c2\sustainOff
  \set Staff.pedalSustainStyle = #'mixed
  c4\sustainOn g c d
  d\sustainOff\sustainOn g, c2\sustainOff
  \set Staff.pedalSustainStyle = #'bracket
  c4\sustainOn g c d
  d\sustainOff\sustainOn g, c2
  \bar "|."
}
@end lilypond

Le placement des commandes de pédale correspond au mouvement de la
pédale de tenue pendant le jeu.  Garder une pédale enclenchée jusqu'à la
barre finale s'obtient tout simplement en omettant la commande de
relâcher.

Les indication de pédale peuvent s'inscrire dans un contexte
@code{Dynamics}, ce qui aura pour effet de leur attribuer une ligne en
propre.

@seealso
Manuel de notation :
@ref{Liaisons de prolongation}.

Morceaux choisis :
@rlsrnamed{Keyboards, Claviers}.

Référence des propriétés internes :
@rinternals{SustainPedal},
@rinternals{SustainPedalLineSpanner},
@rinternals{SustainEvent},
@rinternals{SostenutoPedal},
@rinternals{SostenutoPedalLineSpanner},
@rinternals{SostenutoEvent},
@rinternals{UnaCordaPedal},
@rinternals{UnaCordaPedalLineSpanner},
@rinternals{UnaCordaEvent},
@rinternals{PianoPedalBracket},
@rinternals{Piano_pedal_engraver}.


@node Accordéon
@subsection Accordéon
@translationof Accordion

@menu
* Symboles de jeux::
@end menu


@node Symboles de jeux
@unnumberedsubsubsec Symboles de jeux
@translationof Discant symbols

@cindex accordéon, symboles de registre
@cindex registres, symboles pour accordéon
@cindex accordéon, tirettes
@cindex tirettes d'accordéon, symboles

De nombreux accordéons possèdent plusieurs jeux d'anches capables de
jouer à l'unisson ou bien à l'octave inférieure ou supérieure par
rapport aux notes écrites.  Chaque facteur d'accordéon donne des noms
différents aux @notation{tirettes} (@emph{shifts}) qui permettent de
sélectionner les différents jeux d'anches tels que @notation{hautbois},
@notation{musette} ou @notation{bandonéon}, de telle sorte qu'un système
de symbole a fini par voir le jour afin de faciliter les instructions
pour exécuter un morceau.

@snippets
@lilypondfile[verbatim,quote,texidoc,doctitle]
{accordion-register-symbols.ly}

@seealso
Morceaux choisis :
@rlsr{Keyboards, Claviers}.


@node Harpe
@subsection Harpe
@translationof Harp

Cette partie s'intéresse aux particularités en matière de notation pour
la harpe.

@menu
* Généralités sur la harpe::
* Pédales de harpe::
@end menu


@node Généralités sur la harpe
@unnumberedsubsubsec Généralités sur la harpe
@translationof References for harps
@cindex harpes
@cindex bisbigliando

Certaines caractéristiques de la musique pour harpes sont abordées dans
d'autres chapitres, tels que :

@itemize

@item Les glissandos, l'une des techniques spécifique à la harpe,
@ref{Glissando}.

@item Le @notation{bisbigliando}, qui s'écrit comme un trémolo,
@ref{Répétitions en trémolo}.

@item Les harmoniques naturelles sont présentées dans @ref{Harmoniques}.

@item L'interprétation des arpeggios est abordée dans @ref{Arpèges}.

@end itemize

@seealso
Manuel de notation :
@ref{Arpèges},
@ref{Glissando},
@ref{Harmoniques},
@ref{Répétitions en trémolo}.


@node Pédales de harpe
@unnumberedsubsubsec Pédales de harpe
@translationof Harp pedals

@cindex harpe, pédales
@cindex harpe, diagrammes de pédales
@cindex pédales de harpe
@cindex pédales, diagrammes pour harpe

Les harpes comportent sept cordes par octave qui peuvent sonner
naturel, dièse ou bémol.  Si chacune des cordes de la harpe celtique
(@emph{lever harp}) est accordée individuellement, celles d'une harpe à
pédalier ayant la même note de base sont contrôlées par une seule
pédale.  De gauche à droite, elles correspondent aux notes ré, do, si,
et mi, fa, sol, la pour la grande harpe. Les trois premières pédales
sont réservées au pied gauche, les quatre dernières au pied droit.  Leur
position peut être indiquée par une marque textuelle :

@lilypond[quote,verbatim,fragment]
\textLengthOn
cis''1_\markup \concat \vcenter {
  [D \flat C \sharp B|E \sharp F \sharp G A \flat] }
c''!1_\markup \concat \vcenter {
  [ C \natural ]}
@end lilypond

ou bien sous forme de diagramme :

@lilypond[quote,verbatim,fragment]
\textLengthOn
cis''1_\markup { \harp-pedal #"^v-|vv-^" }
c''!1_\markup { \harp-pedal #"^o--|vv-^" }
@end lilypond

Bémol si la pédale est relâchée (ou en haut), bécarre si elle est
bloquée sur le cran du milieu, et dièse si elle est tout à fait
enfoncée.  La commande @code{\harp-pedal} prend en argument une chaîne
de caractères, où @code{^} indique que la pédale est relâchée ou en haut
(bémol), @code{-} qu'elle est bloquée sur le cran du milieu (bécarre),
@code{v} qu'elle est tout à fait enfoncée (dièse) et @code{|} représente
le séparateur (entre gauche et droite de l'instrumentiste). Faire
précéder un symbole par un @code{o} permet de l'inscrire dans un cercle.

@seealso
Manuel de notation :
@ref{Commentaires textuels},
@rusernamed{Instrument Specific Markup,
Markups spécifiques aux instruments (en anglais)}.