Merge branch 'lilypond/translation' of ssh://git.sv.gnu.org/srv/git/lilypond into...

[lilypond.git] / Documentation / fr / notation / fretted-strings.itely

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

@ignore
    Translation of GIT committish: 3f4496001441e0b1b27d7bc5395c4520f4f2088c

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

@c Translators: Matthieu Jacquot
@c Translation checkers: Jean-Charles Malahieude

@node Instruments à cordes frettées
@section Instruments à cordes frettées
@translationof Fretted string instruments

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

Cette section traite de différents aspects de la notation propre aux
instruments à cordes frettées.

@cindex tablature
@cindex guitare, tablature pour
@cindex banjo, tablature pour
@cindex tablature pour guitare
@cindex tablature pour banjo

@menu
* Vue d'ensemble des cordes frettées::
* Guitare::
* Banjo::
@end menu

@node Vue d'ensemble des cordes frettées
@subsection Vue d'ensemble des cordes frettées
@translationof Common notation for fretted strings

Vue d'ensemble de la notation pour les instruments à cordes frettées.

@menu
* Références en matière de cordes frettées::
* Indications du numéro de corde::
* Tablatures par défaut::
* Tablatures personnalisées::
* Tablatures sous forme d'étiquette::
* Tablatures prédéfinies::
* Tablatures automatiques::
* Doigtés pour la main droite::
@end menu

@node Références en matière de cordes frettées
@unnumberedsubsubsec Références en matière de cordes frettées
@translationof References for fretted strings

La musique pour instruments à cordes frettées est généralement notée sur
une seule portée, en notation traditionnelle ou en tablature, les deux
étant parfois combinées.  Il est aussi courant en musique populaire
d'utiliser des diagrammes d'accord au-dessus de la portée
traditionnelle.  La guitare et le banjo sont des instruments
transpositeurs, sonnant une octave au-dessous de ce qui est écrit.  Les
partitions pour ces instruments utilisent donc la clé de sol ottava
bassa @code{"treble_8"}.  Vous pourrez trouver ailleurs dans la
documentation d'autres éléments aussi utilisés par les instruments à
cordes frettées@tie{}:

@itemize
@item Les doigtés s'obtiennent comme indiqué au chapitre
@ref{Doigtés}.

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

@item Des indications quant au support polyphonique se trouvent au
chapitre @ref{Résolution des collisions}.

@item La notation des sons harmoniques se trouve à la section
@ref{Harmoniques}.

@end itemize


@seealso
Manuel de notation :
@ref{Doigtés},
@ref{Liaisons de prolongation},
@ref{Résolution des collisions},
@ref{Noms d'instrument},
@ref{Saisie de musique en parallèle},
@ref{Arpèges},
@ref{Liste des signes d'articulation},
@ref{Clefs}.


@node Indications du numéro de corde
@unnumberedsubsubsec Indications du numéro de corde
@translationof String number indications

@cindex cordes numérotées
@cindex numéro de corde
@cindex numéros de corde et doigtés
@cindex doigtés et numéros de corde

Une corde sur laquelle une note doit être jouée peut être indiquée
en attachant @code{\@var{numéro}} à cette note prise dans une
construction de type accord @code{<>}.

@warning{Les numéros de cordes @strong{doivent} être définis dans une
construction de type accord même s'il n'y a qu'une seule note.}

@lilypond[verbatim,quote,relative=0]
\clef "treble_8"
<c\5>4 <e\4> <g\3>2
<c,\5 e\4 g\3>1
@end lilypond

Quand les indications de doigté et de numéro de corde sont attachées à
une même note, leur positionnement se fera en fonction de l'ordre dans
lequel ils apparaissent dans le code@tie{}:


@lilypond[verbatim,quote,relative=1]
\clef "treble_8"
<g\3-0>2
<g-0\3>
@end lilypond

@snippets

@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
{controlling-the-placement-of-chord-fingerings.ly}

@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
{allowing-fingerings-to-be-printed-inside-the-staff.ly}


@seealso
Manuel de notation :
@ref{Doigtés}.

Morceaux choisis :
@rlsrnamed{Fretted strings,Cordes frettées}.

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


@node Tablatures par défaut
@unnumberedsubsubsec Tablatures par défaut
@translationof Default tablatures

@cindex tablatures, bases
@cindex tablatures par défaut

@funindex TabStaff
@funindex TabVoice

La notation en tablature est utilisée pour certains instruments à cordes
pincées.  Les hauteurs n'y sont pas indiquées par des têtes de note,
mais par des chiffres ou autres symboles, qui indiquent sur quelle
corde, et à quelle case chaque note doit être jouée.  Dans certaines
limites, LilyPond vous permet d'écrire des tablatures.

Chaque numéro de corde associé à une note doit être précédé d'une barre
oblique inverse (ou @qq{antislash}) suivi d'un nombre.  Par défaut, la
première corde est la plus aiguë, et les cordes suivent l'accordage
traditionnel d'une guitare (à six cordes).  Les notes sont imprimées
sous forme de tablature, dans les contextes @code{TabStaff} et
@code{TabVoice}.

@lilypond[quote,ragged-right,fragment,verbatim]
\new TabStaff \relative c' {
        a,8 a' <c e> a
        d, a' <d f> a
}
@end lilypond

Par défaut, les tablatures ne comportent aucune marque de durée ni de
symbole musical tel que des nuances.

@lilypond[quote,ragged-right,verbatim]
symbols = {
  \time 3/4
  c4-.^"Allegro" d( e)
  f4-.\f g a^\fermata
  \mark \default
  c8_.\<\( c16 c ~ c2\!
  c'2.\prall\)
}

\score {
  <<
    \new Staff { \clef "G_8" \symbols }
    \new TabStaff   { \symbols }
  >>
}
@end lilypond

@funindex \tabFullNotation

Pour obtenir les symboles de notation habituelle dans une tablature, il
faut appliquer la commande @code{\tabFullNotation} au contexte
@code{TabStaff}.  Vous noterez par ailleurs que les blanches sont
affublées d'une double hampe afin de ne pas les confondre avec des
noires.

@lilypond[quote,ragged-right,verbatim]
symbols = {
  \time 3/4
  c4-.^"Allegro" d( e)
  f4-.\f g a^\fermata
  \mark \default
  c8_.\<\( c16 c ~ c2\!
  c'2.\prall\)
}

\score {
  \new TabStaff {
    \tabFullNotation
    \symbols
  }
}
@end lilypond

@funindex minimumFret

@cindex cases
@cindex frets

Quand aucune corde n'est précisée, LilyPond choisit automatiquement la
corde pour laquelle la position est la moins élevée et qui donne un
numéro de case supérieur ou égal à la valeur de la propriété
@code{minimumFret}.  La valeur par défaut de cette propriété est fixée à
0, ce qui correspond aux cordes à vide.


@lilypond[quote,ragged-right,verbatim]
\new StaffGroup <<
   \new Staff \relative c {
     \clef "treble_8"
     \time 2/4
     c16 d e f g4
     c,16\5 d\5 e\4 f\4 g4\4
     c,16 d e f g4
   }
   \new TabStaff \relative c {
     c16 d e f g4
     c,16\5 d\5 e\4 f\4 g4\4
     \set TabStaff.minimumFret = #5
     c,16 d e f g4
   }
>>
@end lilypond

Lorsqu'un liaison de prolongation intervient lors d'un saut de ligne, la
note est répétée, entre parenthèses.  Il en va de même pour la seconde
alternative d'une répétition.

@lilypond[quote,ragged-right,verbatim]
ties = \relative c' {
        \repeat volta 2 {
        e2. f4~
        f2 g2~ }
        \alternative {
                { g4 f2. }
                { g4\repeatTie c,2. }
        }
        b1~\break
        b1  \bar "|."
}

\score {
  <<
    \new StaffGroup  <<
    \context Staff  {
        \clef "treble_8"
        \ties
    }
      \context TabStaff  {
        \ties
      }
    >>
  >>
  \layout {
  indent = #0
  ragged-right = ##t
  }
}
@end lilypond

@funindex \hideSplitTiedTabNotes

La commande @code{\hideSplitTiedTabNotes} permet d'éviter d'imprimer
ces cases entre parenthèses.

@lilypond[quote,ragged-right,verbatim]
ties = \relative c' {
        \repeat volta 2 {
        e2. f4~
        f2 g2~ }
        \alternative {
                { g4 f2. }
                { g4\repeatTie c,2. }
        }
        b1~\break
        b1  \bar "|."
}

\score {
  <<
    \new StaffGroup  <<
    \context Staff  {
        \clef "treble_8"
        \ties
    }
      \context TabStaff  {
      \hideSplitTiedTabNotes
        \ties
      }
    >>
  >>
  \layout {
  indent = #0
  ragged-right = ##t
  }
}
@end lilypond

@cindex harmoniques, indication en tablature
@cindex tablature et indication d'harmoniques
@cindex glissando, indication en tablature
@cindex tablature et glissando

Les indications de sons harmoniques ainsi que les glissandi
peuvent être ajoutés aux tablatures.


@lilypond[fragment, verbatim, quote, relative=1]
\new TabStaff {
  \new TabVoice {
    <c g'\harmonic> d\2\glissando e\2
  }
}
@end lilypond


@snippets

@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
{stem-and-beam-behavior-in-tablature.ly}

@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
{polyphony-in-tablature.ly}


@seealso
Manuel de notation :
@ref{Hampes}.

Morceaux choisis :
@rlsrnamed{Fretted strings,Cordes frettées}.

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


@knownissues

Les accords ne subissent aucun traitement particulier@tie{}; de ce fait,
la sélection automatique des cordes peut attribuer une même corde pour
deux notes différentes de l'accord.

Afin que @code{\partcombine} fonctionne avec des tablatures, on doit
ajouter au contexte @code{TabStaff} des voix fantômes@tie{}:

@lilypond[quote,ragged-right,verbatim]
melodia = \partcombine { e4 g g g }{ e4 e e e }
<<
  \new TabStaff <<
    \new TabVoice = "one" s1
    \new TabVoice = "two" s1
    \new TabVoice = "shared" s1
    \new TabVoice = "solo" s1
    { \melodia }
  >>
>>
@end lilypond

Le support des modes de jeu propres à la guitare se limite aux sons
harmoniques et aux glissandi.

@node Tablatures personnalisées
@unnumberedsubsubsec Tablatures personnalisées
@translationof Custom tablatures

@cindex tablatures personnalisées
@cindex banjo, tablature
@cindex mandoline, tablature
@cindex guitare basse, tablature
@cindex tablature, accordages prédéfinis
@cindex cordes frettés et accordages prédéfinis
@cindex accordages prédéfinis et cordes frettées

@funindex StringTunings

Sous LilyPond, la case correspondant à une note jouée sur une corde
donnée est calculée automatiquement.  Pour ce faire, l'accordage doit
être spécifié.  L'accordage des cordes est donné par la propriété
@code{StringTunings}.

LilyPond possède des accordages prédéfinis pour banjo, mandoline, guitare
et guitare basse.  Lilypond calcule automatiquement la transposition
correspondant à ces accordages.  L'exemple ci-dessous est pour guitare
basse, il sonnera donc une octave en dessous de ce qui est écrit.

@lilypond[quote,ragged-right,verbatim]
<<
  \new Staff {
    \clef "bass_8"
    \relative c, {
      c4 d e f
    }
  }
  \new TabStaff {
    \set TabStaff.stringTunings = #bass-tuning
    \relative c, {
      c4 d e f
    }
  }
>>
@end lilypond

L'accordage par défaut est @code{guitar-tuning}@tie{}; il correspond à
l'accordage standard d'une guitare@tie{}: mi la ré sol si mi (EADGBE).
D'autres accordages prédéfinis sont disponibles@tie{}:
@code{guitar-open-g-tuning}, @code{mandolin-tuning} et
@code{banjo-open-g-tuning}.  Les accordages prédéfinis sont répertoriés
dans le fichier @file{scm/output-lib.scm}.

L'accordage est constitué par une liste Scheme des hauteurs de notes
correspondant aux cordes à vide, une note pour chaque corde, classée par
numéro de corde de 1 à n, où la corde 1 est la plus haute dans la
tablature et n la plus basse.  Cela revient généralement à classer les
cordes de la plus aiguë à la plus grave, mais certains instruments
(comme le ukulele) n'ont pas les cordes classées par hauteur.

Dans cette liste, la hauteur des notes est représentée par l'intervalle,
exprimé en demi-tons, du do central jusqu'à la note de la corde à vide.
Elle doit donc être représentée par un nombre entier.  LilyPond calcule
la note correspondant à chaque corde en ajoutant cet intervalle au do
central.

Lilypond calcule automatiquement le nombre de cordes à représenter dans
la tablature (@code{TabStaff}) en comptant le nombre d'éléments définis
dans le @code{stringTunings}.

N'importe quel accordage peut donc être créé.  Par exemple, nous pouvons
définir l'accordage d'un instrument à quatre cordes accordées do sol ré
la, donc de la plus aiguë à la plus grave et en anglais@tie{}:
@code{a''},  @code{d''},  @code{g'}, et @code{c'}@tie{}:


@lilypond[quote,verbatim]
mynotes = {
    c'4 e' g' c'' |
    e'' g'' b'' c'''
}

<<
  \new Staff {
    \clef treble
    \mynotes
  }
  \new TabStaff {
    \set TabStaff.stringTunings = #`(,(ly:make-pitch 1 5 0)
                                     ,(ly:make-pitch 1 1 0)
                                     ,(ly:make-pitch 0 4 0)
                                     ,(ly:make-pitch 0 0 0))
    \mynotes
  }
>>
@end lilypond


@seealso
Fichiers d'initialisation :
@file{scm/output-lib.scm}.

Morceaux choisis :
@rlsrnamed{Fretted strings,Cordes frettées}.

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

@knownissues
Le calcul automatique des tablatures se révèle inapproprié pour les
instruments dont l'ordre des cordes ne correspond pas à l'ordre des
hauteurs, comme le ukulele.


@node Tablatures sous forme d'étiquette
@unnumberedsubsubsec Tablatures sous forme d'étiquette
@translationof Fret diagram markups

@cindex fret, diagrammes
@cindex accord, diagrammes
@cindex diagrammes de fret
@cindex diagrammes d'accord pour instrument fretté
@cindex fret, diagrammes personnalisés
@cindex diagrammes personnalisés de fret

On peut ajouter des diagrammes d'accords au-dessus de n'importe quelle
note, en tant qu'objets @code{\markup}.  Ces objets contiennent toutes
les informations du diagramme d'accord.  Il y a pour les définir trois
interfaces "diagramme d'accord" (@emph{fret-diagram} en anglais)@tie{}:
@var{standard}, @var{terse} et @var{verbose}.
Ces trois interfaces produiront des diagrammes similaires mais
permettent des niveaux de personnalisation différents.  Des détails à
propos des interfaces de type @code{\markup}
peuvent être trouvés dans @ref{Text markup commands}.

Dans l'interface standard des diagrammes d'accords, on indiquera le
numéro de corde et le numéro de case pour chaque point placé sur une corde.
Les cordes à vide et étouffées peuvent aussi être indiquées.

@lilypond[quote, verbatim]
<<
  \context ChordNames {
     \chordmode {
       c1 d:m
     }
  }
  \context Staff {
    \clef "treble_8"
    < c e g c' e' > 1 ^\markup
      \fret-diagram #"6-x;5-3;4-2;3-o;2-1;1-o;"
    < d a d' f'> ^\markup
      \fret-diagram #"6-x;5-x;4-o;3-2;2-3;1-1;"
  }
>>
@end lilypond

@cindex barré, indication de
@cindex indication du barré

Les indications de barré peuvent aussi être ajoutées au diagramme
d'accord dans l'interface standard@tie{}:

@lilypond[quote, verbatim]
<<
  \context ChordNames {
     \chordmode {
       f1 g
     }
  }
  \context Staff {
    \clef "treble_8"
    < f, c f a c' f'>1 ^\markup
      \fret-diagram #"c:6-1-1;6-1;5-3;4-3;3-2;2-1;1-1;"
    < g, d g b d' g'> ^\markup
      \fret-diagram #"c:6-1-3;6-3;5-5;4-5;3-4;2-3;1-3;"
  }
>>
@end lilypond

@cindex fret-diagram et markup
@cindex markup et fret-diagram

@funindex fret-diagram
@funindex \fret-diagram

La taille du diagramme d'accord ainsi que le nombre de cases
représentées peuvent aussi être modifiés dans l'interface standard.

@lilypond[quote, verbatim]
<<
  \context ChordNames {
     \chordmode {
       f1 g
     }
  }
  \context Staff {
    \clef "treble_8"
    < f, c f a c' f'>1 ^\markup
      \fret-diagram #"s:1.5;c:6-1-1;6-1;5-3;4-3;3-2;2-1;1-1;"
    < g, b, d g b g'> ^\markup
      \fret-diagram #"h:6;6-3;5-2;4-o;3-o;2-o;1-3;"
  }
>>
@end lilypond

Le nombre de cordes dans les diagrammes d'accord peut être modifié dans
l'interface standard pour s'adapter à différents instruments tels que le
banjo et le ukulele.

@lilypond[quote, verbatim]
<<
  \context ChordNames {
     \chordmode {
       a1
     }
  }
  \context Staff {
        %% A chord for ukulele
    a'1 ^\markup \fret-diagram #"w:4;4-2-2;3-1-1;2-o;1-o;"
  }
>>
@end lilypond

Des indications de doigtés peuvent être ajoutées, et le positionnement
de ces doigtés peut être modifié dans l'interface standard.

@lilypond[quote, verbatim]
<<
  \context ChordNames {
     \chordmode {
       c1 d:m
     }
  }
  \context Staff {
    \clef "treble_8"
    < c e g c' e' > 1 ^\markup
      \fret-diagram #"f:1;6-x;5-3-3;4-2-2;3-o;2-1-1;1-o;"
    < d a d' f'> ^\markup
      \fret-diagram #"f:2;6-x;5-x;4-o;3-2-2;2-3-3;1-1-1;"
  }
>>
@end lilypond

La taille ainsi que la position des points peuvent être contrôlées dans
l'interface standard.

@lilypond[quote, verbatim]
<<
  \context ChordNames {
     \chordmode {
       c1 d:m
     }
  }
  \context Staff {
    \clef "treble_8"
    < c e g c' e' > 1 ^\markup
      \fret-diagram #"d:0.35;6-x;5-3;4-2;3-o;2-1;1-o;"
    < d a d' f'> ^\markup
      \fret-diagram #"p:0.2;6-x;5-x;4-o;3-2;2-3;1-1;"
  }
>>
@end lilypond

@cindex fret-diagram-terse markup

@funindex fret-diagram-terse
@funindex \fret-diagram-terse

Dans l'interface @code{fret-diagram-terse}, les numéros de cordes sont
omis@tie{}; les numéros de cordes sont induits par la présence de
points-virgules.  Il y a un point-virgule pour chaque corde du
diagramme.  Le premier point-virgule correspondant au plus haut numéro
de corde, le dernier à la première corde.  Les cordes étouffées, les
cordes à vide ainsi que les numéros de case peuvent y être indiqués.

@lilypond[quote, verbatim]
<<
  \context ChordNames {
     \chordmode {
       c1 d:m
     }
  }
  \context Staff {
    \clef "treble_8"
    < c e g c' e' > 1 ^\markup
      \fret-diagram-terse #"x;3;2;o;1;o;"
    < d a d' f'> ^\markup
      \fret-diagram-terse #"x;x;o;2;3;1;"
  }
>>
@end lilypond

Les indications de barré peuvent être incluses dans l'interface
@code{fret-diagram-terse}.

@lilypond[quote, verbatim]
<<
  \context ChordNames {
     \chordmode {
       f1 g
     }
  }
  \context Staff {
    \clef "treble_8"
    < f, c f a c' f'>1 ^\markup
      \fret-diagram-terse #"1-(;3;3;2;1;1-);"
    < g, d g b d' g'> ^\markup
      \fret-diagram-terse #"3-(;5;5;4;3;3-);"
  }
>>
@end lilypond

Les indications de doigtés peuvent être inclus dans l'interface
@code{fret-diagram-terse}.

@c Need to use override to enable fingerings to show this -- can we do so?
@lilypond[quote, verbatim]
<<
  \context ChordNames {
     \chordmode {
       c1 d:m
     }
  }
  \context Staff {
    \override Voice.TextScript
      #'(fret-diagram-details finger-code) = #'below-string
    \clef "treble_8"
    < c e g c' e' > 1 ^\markup
      \fret-diagram-terse #"x;3-3;2-2;o;1-1;o;"
    < d a d' f'> ^\markup
      \fret-diagram-terse #"x;x;o;2-2;3-3;1-1;"
  }
>>
@end lilypond

Les autres propriétés des diagrammes d'accord doivent être ajustées en
utilisant la commande @code{\override} dans l'interface
@code{fret-diagram-terse}.

@cindex fret-diagram-verbose markup

@funindex fret-diagram-verbose
@funindex \fret-diagram-verbose

L'interface @code{fret-diagram-verbose} est au format d'une liste
Scheme.  Chaque élément de la liste décrit un objet devant être placé
dans le diagramme d'accord.

@lilypond[quote, verbatim]
<<  \context ChordNames {
     \chordmode {
       c1 d:m
     }
  }
  \context Staff {
    \clef "treble_8"
    < c e g c' e' > 1 ^\markup
      \fret-diagram-verbose #'(
        (mute 6)
        (place-fret 5 3)
        (place-fret 4 2)
        (open 3)
        (place-fret 2 1)
        (open 1)
      )
    < d a d' f'> ^\markup
      \fret-diagram-verbose #'(
        (mute 6)
        (mute 5)
        (open 4)
        (place-fret 3 2)
        (place-fret 2 3)
        (place-fret 1 1)
      )
  }
>>
@end lilypond

Les indications de doigté et de barré peuvent être décrits dans
l'interface @code{fret-diagram-verbose}.  Particularité propre à
l'interface @code{fret-diagram-verbose}@tie{}: l'indication
de capodastre dans le diagramme d'accord.  L'indication de capodastre
est une petite ligne transversale aux cordes.  La case avec le
capodastre est la case la plus basse du diagramme d'accord.

@c \override is necessary to make fingering visible
@lilypond[quote, verbatim]
<<
  \context ChordNames {
     \chordmode {
       f1 g c
     }
  }
  \context Staff {
    \clef "treble_8"
    \override Voice.TextScript
      #'(fret-diagram-details finger-code) = #'below-string

    < f, c f a c' f'>1 ^\markup
      \fret-diagram-verbose #'(
        (place-fret 6 1)
        (place-fret 5 3)
        (place-fret 4 3)
        (place-fret 3 2)
        (place-fret 2 1)
        (place-fret 1 1)
        (barre 6 1 1)
      )
    < g, b, d g b g'> ^\markup
      \fret-diagram-verbose #'(
        (place-fret 6 3 2)
        (place-fret 5 2 1)
        (open 4)
        (open 3)
        (open 2)
        (place-fret 1 3 3)
      )
    < c e g c' e'> ^\markup
      \fret-diagram-verbose #'(
        (capo 3)
        (mute 6)
        (place-fret 4 5 1)
        (place-fret 3 5 2)
        (place-fret 2 5 3)
      )
   }
>>
@end lilypond

Toutes les autres propriétés du diagramme d'accord doivent être
indiquées en utilisant la commande @code{\override} lorsque l'on utilise
l'interface @code{fret-diagram-verbose}.

@ignore
The following example shows the three fret-diagram markup
interfaces, along with examples of common tweaks.  For example,
the size of the verbose fret diagram is reduced to 0.75, and the
finger indications are specified to appear below the diagram.  The
terse diagram includes tweaks to specify placement of finger code
and color of dots.

@lilypond[verbatim,ragged-right,quote]
\new Voice {
  \clef "treble_8"
  d^\markup \fret-diagram #"6-x;5-x;4-o;3-2;2-3;1-2;"
  d d d
  fis^\markup \override #'(size . 0.75) {
    \override #'(finger-code . below-string) {
      \fret-diagram-verbose #'((place-fret 6 2 1) (barre 6 1 2)
                               (place-fret 5 4 3)
                               (place-fret 4 4 4)
                               (place-fret 3 3 2)
                               (place-fret 2 2 1)
                               (place-fret 1 2 1))
    }
  }
  fis fis fis
  c^\markup \override #'(dot-radius . 0.35) {
    \override #'(finger-code . in-dot) {
      \override #'(dot-color . white) {
        \fret-diagram-terse #"x;3-1-(;5-2;5-3;5-4;3-1-);"
      }
    }
  }
  c c c
}
@end lilypond
@end ignore

@cindex diagrammes de fret personnalisés
@cindex fret, diagrammes personnalisés
@cindex diagrammes personnalisés de fret

@funindex fret-diagram-interface

La disposition graphique d'un diagramme d'accord peut être modifiée
suivant les préférences de l'utilisateur grâce aux propriétés de
l'interface @code{fret-diagram-interface}.
Des détails se trouvent dans @rinternals{fret-diagram-interface}.  Pour
un diagramme d'accord, les propriétés de l'interface dépendent de
@code{Voice.TextScript}.

@snippets

@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
{customizing-markup-fret-diagrams.ly}


@seealso
Manuel de notation :
@ref{Text markup commands}.

Morceaux choisis :
@rlsrnamed{Fretted strings,Cordes frettées}.

Référence des propriétés internes :
@rinternals{fret-diagram-interface}.


@node Tablatures prédéfinies
@unnumberedsubsubsec Tablatures prédéfinies
@translationof Predefined fret diagrams


@cindex fret, diagrammes
@cindex accord, diagrammes

@funindex FretBoards
@funindex stringTunings

Les diagrammes d'accords peuvent être affichés en utilisant le contexte
@code{FretBoards}.  Par défaut le contexte @code{FretBoards} affichera
des diagrammes d'accords stockés dans une table de correspondance@tie{}:

@lilypond[verbatim, ragged-right, quote]
\include "predefined-guitar-fretboards.ly"
\context FretBoards {
  \chordmode {
    c1 d
  }
}
@end lilypond

Les diagrammes d'accord définis par défaut sont dans le fichier
@file{predefined-guitar-fretboards.ly}.  Les diagrammes d'accord sont
stockés en fonction des notes de l'accord ainsi que de l'accordage
(@code{stringTunings}) utilisé.
@file{predefined-guitar-fretboards.ly} contient les diagrammes d'accord
prédéfinis uniquement pour l'accordage standard (@code{guitar-tuning}).
Des diagrammes d'accords peuvent être définis pour d'autres instruments
ou d'autres accordages en suivant les exemples du fichier
@file{predefined-guitar-fretboards.ly}.

Les diagrammes de fret propres au ukulele se trouvent dans le fichier
@file{predefined-ukulele-fretboards.ly}.

@lilypond[verbatim, ragged-right, quote]
\include "predefined-ukulele-fretboards.ly"

myChords = \chordmode { a1 a:m a:aug }

\new ChordNames {
  \myChords
}

\new FretBoards {
  \set stringTunings = #ukulele-tuning
  \myChords
}
@end lilypond

Les notes des accords peuvent être entrées aussi bien comme musique
simultanée qu'en utilisant le mode accord (voir
@ref{Généralités sur le mode accords}).

@lilypond[verbatim, ragged-right,quote]
\include "predefined-guitar-fretboards.ly"
\context FretBoards {
  \chordmode {c1}
  <c' e' g'>1
}
@end lilypond

@cindex accord nommés et diagrammes de fret
@cindex fret, diagrammes avec noms d'accord

@funindex ChordNames
@funindex chordmode
@funindex \chordmode

Il est courant d'afficher simultanément le nom des accords et les
diagrammes d'accords correspondants.
Ceci s'obtient en mettant en parallèle un contexte @code{ChordNames} avec
un contexte @code{FretBoards} et en affectant aux deux la même musique.

@lilypond[verbatim, ragged-right, quote]
\include "predefined-guitar-fretboards.ly"
mychords = \chordmode{
  c1 f g
}

<<
  \context ChordNames {
    \mychords
  }
  \context FretBoards {
    \mychords
  }
>>
@end lilypond

@cindex transposition et diagramme de fret
@cindex fret et transposition
@cindex diagrammes de fret et transposition

Les diagrammes d'accords prédéfinis sont transposables tant qu'il y a
un diagramme correspondant à l'accord transposé dans la base des
diagrammes d'accords.

@lilypond[verbatim, ragged-right, quote]
\include "predefined-guitar-fretboards.ly"
mychords = \chordmode{
  c1 f g
}

mychordlist = {
  \mychords
  \transpose c e { \mychords}
}
<<
  \context ChordNames {
    \mychordlist
  }
  \context FretBoards {
    \mychordlist
  }
>>
@end lilypond

La table des diagrammes d'accord contient sept types d'accord (majeur,
mineur, augmenté, diminué, septième de dominante, majeur sept, mineur
sept) pour chacune des 17 fondamentales possibles.  Une liste complète
des diagrammes d'accords prédéfinis se trouve dans
@ref{Tablatures prédéfinies}.   S'il n'y a pas d'entrée dans la table
pour un accord donné, le graveur @code{Fretboard_engraver} calculera le
diagramme d'accord en utilisant la fonctionnalité automatique  décrite
dans @ref{Tablatures automatiques}.

@lilypond[verbatim, ragged-right, quote]
\include "predefined-guitar-fretboards.ly"
mychords = \chordmode{
  c1 c:9
}

<<
  \context ChordNames {
    \mychords
  }
  \context FretBoards {
    \mychords
  }
>>
@end lilypond

@cindex fret, ajout de diagrammes personnalisés
@cindex diagrammes de fret personnalisés, ajout

Des diagrammes d'accord peuvent être ajoutés à la table des diagrammes
d'accord.  Pour ajouter un diagramme d'accord, il faut spécifier
l'accord correspondant au diagramme, l'accord utilisé et la définition
du diagramme.  Cette définition de diagramme peut être
aussi bien de type @var{terse} que @var{verbose}.

@lilypond[verbatim, ragged-right, quote]
\include "predefined-guitar-fretboards.ly"

\storePredefinedDiagram #default-fret-table \chordmode {c:9}
                        #guitar-tuning
                        #"x;3-2;2-1;3-3;3-4;x;"

mychords = \chordmode{
  c1 c:9
}

<<
  \context ChordNames {
    \mychords
  }
  \context FretBoards {
    \mychords
  }
>>
@end lilypond

On peut enregistrer différents diagrammes pour un même accord
en les définissant à des octaves différentes.   Notez qu'il faut un
intervalle de deux octaves, le premier servant à la transposition.

@lilypond[verbatim, ragged-right, quote]
\include "predefined-guitar-fretboards.ly"

\storePredefinedDiagram #default-fret-table \chordmode { c'' }
                        #guitar-tuning
                        #(offset-fret 2 (chord-shape 'bes guitar-tuning))

mychords = \chordmode{
  c1 c''
}

<<
  \context ChordNames {
    \mychords
  }
  \context FretBoards {
    \mychords
  }
>>
@end lilypond

@cindex cordes frettées, carrures d'accord
@cindex accord, carrures pour cordes frettées

@funindex \addChordShape
@funindex add ChordShape
@funindex storePredefinedDiagram
@funindex \storePredefinedDiagram

En plus des  diagrammes d'accord, LilyPond possède une liste interne de
carrures d'accord.
Les carrures d'accords sont des diagrammes d'accord qui peuvent être
transposés le long du manche.  Les carrures d'accords peuvent être
ajoutées à la liste interne et être ensuite utilisées pour définir des
accords prédéfinis.  Puisqu'elles sont transposables le long du
manche, les carrures d'accord ne contiennent généralement pas de corde
à vide.  Tout comme les diagrammes d'accord, les carrures d'accord sont
définies grâce aux interfaces @code{fret-diagram-terse} ou
@code{fret-diagram-verbose}.


@lilypond[verbatim, ragged-right, quote]
\include "predefined-guitar-fretboards.ly"

% add a new chord shape

\addChordShape #'powerf #guitar-tuning #"1-1;3-3;3-4;x;x;x;"

% add some new chords based on the power chord shape

\storePredefinedDiagram #default-fret-table \chordmode {f'}
                        #guitar-tuning
                        #(chord-shape 'powerf guitar-tuning)
\storePredefinedDiagram #default-fret-table \chordmode {g'}
                        #guitar-tuning
                        #(offset-fret 2 (chord-shape 'powerf guitar-tuning))

mychords = \chordmode{
  f1 f' g g'
}

<<
  \context ChordNames {
    \mychords
  }
  \context FretBoards {
    \mychords
  }
>>
@end lilypond

La disposition graphique d'un diagramme d'accord peut être modifiée
suivant les préférences de l'utilisateur grâce aux propriétés de
l'interface @code{fret-diagram-interface}. Pour plus d'information,
consultez @rinternals{fret-diagram-interface}.  Pour un diagramme
d'accord donné, les propriétés de l'interface dépendent de
@code{FretBoards.FretBoard}.

@snippets

@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
{customizing-fretboard-fret-diagrams.ly}

@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
{defining-predefined-fretboards-for-other-instruments.ly}


@seealso
Manuel de notation :
@ref{Tablatures personnalisées},
@ref{Tablatures automatiques},
@ref{Généralités sur le mode accords},
@ref{Tablatures prédéfinies}.

Fichiers d'initialisation :
@file{ly/predefined-guitar-fretboards.ly},
@file{ly/predefined-guitar-ninth-fretboards.ly}.

Morceaux choisis :
@rlsrnamed{Fretted strings,Cordes frettées}.

Référence des propriétés internes :
@rinternals {fret-diagram-interface}.


@node Tablatures automatiques
@unnumberedsubsubsec Tablatures automatiques
@translationof Automatic fret diagrams

@cindex fret, diagrammes automatiques
@cindex accord, diagrammes automatiques
@cindex automatique, diagramme de fret
@cindex automatique, diagramme d'accord

Les diagrammes d'accord peuvent être créés automatiquement@tie{}; il
suffit d'affecter les notes à un contexte @code{FretBoards}.  Si aucun
diagramme prédéfini n'est disponible pour les notes entrées avec
l'accordage actuel (@code{stringTunings}), les cordes et cases
correspondant aux notes seront automatiquement calculées.

@lilypond[quote,ragged-right,verbatim]
<<
  \context ChordNames {
     \chordmode {
       f1 g
     }
  }
  \context FretBoards {
    < f, c f a c' f'>1
    < g,\6 b, d g b g'>
  }
  \context Staff {
    \clef "treble_8"
    < f, c f a c' f'>1
    < g, b, d g b' g'>
  }
>>
@end lilypond

@funindex predefinedFretboardsOff
@funindex \predefinedFretboardsOff
@funindex predefinedFretboardsOn
@funindex \predefinedFretboardsOn

Dans la mesure où aucun diagramme prédéfini n'est chargé par défaut, le
calcul automatique des diagrammes d'accord est le comportement par
défaut.  Dès que les diagrammes par défaut sont chargés, le calcul
automatique peut être activé ou désactivé par des commandes
prédéfinies@tie{}:

@lilypond[quote,ragged-right,verbatim]

\storePredefinedDiagram #default-fret-table <c e g c' e'>
                        #guitar-tuning
                        #"x;3-1-(;5-2;5-3;5-4;3-1-1);"
<<
  \context ChordNames {
     \chordmode {
       c1 c c
     }
  }
  \context FretBoards {
    <c e g c' e'>1
    \predefinedFretboardsOff
    <c e g c' e'>
    \predefinedFretboardsOn
    <c e g c' e'>
  }
  \context Staff {
    \clef "treble_8"
    <c e g c' e'>1
    <c e g c' e'>
    <c e g c' e'>
  }
>>
@end lilypond

Parfois le calculateur se trouvera incapable de trouver un diagramme
d'accord convenable.  On peut souvent y remédier en assignant les notes
aux cordes.  Dans bien des cas, il suffit de placer manuellement une
seule note pour que les autres soient alors placées de maniére
appropriée par le contexte @code{FretBoards}.

@cindex fret, ajout de doigtés aux diagrammes
@cindex doigtés, ajout à des diagrammes de fret

Il est possible d'ajouter des indications de doigté aux diagrammes de
fret.

@lilypond[quote, verbatim]
<<
  \context ChordNames {
     \chordmode {
       c1 d:m
     }
  }
  \context FretBoards {
    < c-3 e-2 g c'-1 e' > 1
    < d a-2 d'-3 f'-1>
  }
  \context Staff {
    \clef "treble_8"
    < c e g c' e' > 1
    < d a d' f'>
  }
>>
@end lilypond

La propriété @code{minimumFret} permet de définir la case minimale qui
servira à calculer les cordes et les cases du contexte @code{FretBoard}.

@lilypond[quote, verbatim]
<<
  \context ChordNames {
     \chordmode {
       d1:m d:m
     }
  }
  \context FretBoards {
    < d a d' f'>
    \set FretBoards.minimumFret = #5
    < d a d' f'>
  }
  \context Staff {
    \clef "treble_8"
    < d a d' f'>
    < d a d' f'>
  }
>>
@end lilypond

Les cordes et les cases du contexte @code{FretBoards} sont liées à la
propriété @code{stringTunings}, qui a là même signification que dans le
contexte @code{TabStaff}.
Voir @ref{Tablatures personnalisées} pour plus d'information sur la
propriété @code{stringTunings}.

La disposition graphique d'un diagramme d'accord peut être modifiée
suivant les préférences de l'utilisateur au travers des propriétés de
l'interface @code{fret-diagram-interface}.  Pour un diagramme
d'accord, les propriétés de l'interface dépendent de
@code{FretBoards.FretBoard}.


@predefined
@code{\predefinedFretboardsOff},
@code{\predefinedFretboardsOn}.
@endpredefined


@seealso
Manuel de notation :
@ref{Tablatures personnalisées}.

Morceaux choisis :
@rlsrnamed{Fretted strings,Cordes frettées}.

Référence des propriétés internes :
@rinternals {fret-diagram-interface}.

@knownissues
Le calcul automatique des diagrammes de fret se révèle inapproprié pour
les instruments dont l'ordre des cordes ne correspond pas à l'ordre des
hauteurs.


@node Doigtés pour la main droite
@unnumberedsubsubsec Doigtés pour la main droite
@translationof Right-hand fingerings

@cindex cordes frettées, doigtés main droite
@cindex doigtés main droite et cordes frettées
@cindex main droite, doigtés pour cordes frettées

@funindex rightHandFinger
@funindex \rightHandFinger

Les doigtés de main droite @var{p-i-m-a} doivent être entrés dans une
construction de type accord @code{<>} même s'il n'y a qu'une seule note.

@warning{Un trait d'union @strong{doit} suivre la note et une espace
@strong{doit} précéder la fermeture de la construction par un @code{>}.}


@lilypond[quote,verbatim,relative=0]
\clef "treble_8"
<c-\rightHandFinger #1 >4
<e-\rightHandFinger #2 >
<g-\rightHandFinger #3 >
<c-\rightHandFinger #4 >
<c,-\rightHandFinger #1 e-\rightHandFinger #2
  g-\rightHandFinger #3 c-\rightHandFinger #4 >1
@end lilypond

Pour plus de clarté, vous pouvez traduire ou abréger la commande
@code{\rightHandFinger}, par exemple en @code{\doigtMainDroite} ou
même @code{\MD}@tie{}:

@example
#(define MD rightHandFinger)
@end example


@snippets

@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
{placement-of-right-hand-fingerings.ly}

@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
{fingerings,-string-indications,-and-right-hand-fingerings.ly}


@seealso
Morceaux choisis :
@rlsrnamed{Fretted strings,Cordes frettées}.

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


@node Guitare
@subsection Guitare
@translationof Guitar

La plupart des aspects en matière de notation pour guitare sont traités
dans la partie commune aux instruments frettés.  Il subsiste cependant
quelques particularités que nous allons maintenant examiner.  Parfois
l'utilisateur aimerait créer des documents de type recueil de chansons,
où l'on ne trouve que des accords au-dessus des paroles.  Dans la mesure
où LilyPond est un éditeur de partitions, il n'est pas l'outil optimal
pour des documents sans partition.  Une meilleure alternative serait de
recourrir à un traitement de texte, un éditeur de texte ou, pour les
utilisateurs experimentés, un logiciel typographique tel que GuitarTex.

@menu
* Indication de la position et du barré::
* Indication des harmoniques et notes étouffées::
@end menu

@node Indication de la position et du barré
@unnumberedsubsubsec Indication de la position et du barré
@translationof Indicating position and barring

@cindex indication de la position et du barré pour cordes frettées
@cindex cordes frettées, indication de la position et du barré

Cet exemple montre comment indiquer les positions et les barrés@tie{}:

@lilypond[quote,ragged-right,fragment,verbatim,relative=0]
\clef "treble_8"
b16 d g b e
\textSpannerDown
\override TextSpanner #'(bound-details left text) = #"XII "
  g16\startTextSpan
  b16 e g e b g\stopTextSpan
e16 b g d
@end lilypond


@seealso
Manuel de notation :
@ref{Indication textuelle avec extension}.

Morceaux choisis :
@rlsrnamed{Fretted strings,Cordes frettées},
@rlsrnamed{Expressive marks,Signes d'interprétation}.


@node Indication des harmoniques et notes étouffées
@unnumberedsubsubsec Indication des harmoniques et notes étouffées
@translationof Indicating harmonics and dampened notes

@cindex cordes frettées, notes étouffées
@cindex cordes frettées, harmoniques
@cindex notes étouffées et cordes frettées
@cindex harmoniques et cordes frettées

Des têtes de note spéciales peuvent servir à indiquer les
notes étouffées et les sons harmoniques.  Les sons harmoniques sont
souvent détaillés grâce à des indications textuelles.

@lilypond[quote,ragged-right,fragment,verbatim]
\relative c' {
  \clef "treble_8"
  \override Staff.NoteHead #'style = #'cross
  g8 a b c b4
  \override Staff.NoteHead #'style = #'harmonic-mixed
  d^\markup { \italic { \fontsize #-2 { "harm. 12" }}} <g b>1
}
@end lilypond


@seealso
Morceaux choisis :
@rlsrnamed{Fretted strings,Cordes frettées}.

Manuel de notation :
@ref{Têtes de note spécifiques},
@ref{Têtes de note}.


@node Banjo
@subsection Banjo
@translationof Banjo

@menu
* Tablatures pour banjo::
@end menu

@node Tablatures pour banjo
@unnumberedsubsubsec Tablatures pour banjo
@translationof Banjo tablatures

@cindex banjo, tablatures
@cindex tablatures pour banjo

LilyPond permet d'écrire des tablatures de base pour le banjo à cinq
cordes.  Pour ce faire, pensez à utiliser le format de tablature pour
banjo, afin d'avoir le bon nombre de cordes et le bon accordage@tie{}:

@c due to crazy intervals of banjo music, absolute pitch is recommended

@lilypond[quote,ragged-right,verbatim]
\new TabStaff <<
  \set TabStaff.tablatureFormat = #fret-number-tablature-format-banjo
  \set TabStaff.stringTunings = #banjo-open-g-tuning
  {
    \stemDown
    g8 d' g'\5 a b g e d' |
    g4 d''8\5 b' a'\2 g'\5 e'\2 d' |
    g4
  }
>>
@end lilypond

@cindex banjo, accordages
@cindex accordages de banjo

@funindex banjo-c-tuning
@funindex banjo-modal-tuning
@funindex banjo-open-d-tuning
@funindex banjo-open-dm-tuning
@funindex four-string-banjo

LilyPond prend en charge un certain nombre d'accordages courants pour
banjo@tie{}: @code{banjo-c-tuning} sol,do,sol,si,ré (gCGBD),
@code{banjo-modal-tuning} sol,ré,sol,do,ré (gDGCD),
@code{banjo-open-d-tuning} la,ré,fa#,la,ré (aDF#AD) et
@code{banjo-open-dm-tuning} la,ré,fa,la,ré (aDFAD).

Ces accordages peuvent être convertis pour banjo à quatre cordes au
moyen de la fonction @code{four-string-banjo}@tie{}:

@example
\set TabStaff.stringTunings = #(four-string-banjo banjo-c-tuning)
@end example


@seealso
Morceaux choisis :
@rlsrnamed{Fretted strings,Cordes frettées}.

Les accordages prédéfinis du banjo sont contenus dans le fichier
@file{scm/output-lib.scm}.