]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/fr/learning/fundamental.itely
Issue 4894: Remove unescaped @funindex entries
[lilypond.git] / Documentation / fr / learning / fundamental.itely
index d0a765a040a514728f8202b203f6a8cf89109c22..f0fa46ee77f5e2d30019ecf1bfad11ab060b7273 100644 (file)
@@ -1,14 +1,14 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 
 @ignore
-    Translation of GIT committish: 1d859642df3a961f6675a70387069cbaa56d8ce9
+   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..
+   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 \version "2.19.22"
 
 @c Translators: Valentin Villenave, Jean-Charles Malahieude
 @c Translation checkers: John Mandereau
@@ -76,9 +76,7 @@ Il existe de nombreuses variantes à ce schéma simpliste, mais cet
 exemple est un préambule à notre propos.
 
 @funindex \book
-@funindex book
 @funindex \score
-@funindex score
 
 @cindex book, livre, ouvrage
 @cindex livre
@@ -167,11 +165,8 @@ d'autres informations :
 @end example
 
 @funindex \header
-@funindex header
 @funindex \layout
-@funindex layout
 @funindex \midi
-@funindex midi
 
 @cindex header
 @cindex en-tête
@@ -197,14 +192,13 @@ pour effet, lorsqu'elles interviennent, de produire une sortie
 imprimable et un fichier MIDI.  Nous nous y intéressons plus
 particulièrement dans le manuel de notation, aux chapitres
 @ruser{Mise en forme de la partition} et
-@ruser{Création de fichiers MIDI}.
+@ruser{Génération de fichiers MIDI}.
 
 @cindex partitions multiples
 @cindex book,  bloc implicite
 @cindex implicite, bloc book
 
 @funindex \book
-@funindex book
 
 Vous pouvez tout à fait mentionner plusieurs blocs @code{\score}.  Ils
 seront traités comme autant de partitions indépendantes qui seront
@@ -276,7 +270,6 @@ Pour une description complète du format des fichiers d'entrée, voir
 @translationof Score is a (single) compound musical expression
 
 @funindex \score
-@funindex score
 
 @cindex partition
 @cindex bloc score, contenu
@@ -546,8 +539,8 @@ Ainsi, et bien que ce ne soit pas très musical, une liaison de phrasé
 peut débuter avant l'insertion d'une ligature manuelle et s'arrêter
 avant la fin de la ligature :
 
-@lilypond[quote,verbatim,ragged-right,relative=2]
-g8\( a b[ c b\) a] g4
+@lilypond[quote,verbatim,ragged-right]
+\relative { g'8\( a b[ c b\) a] g4 }
 @end lilypond
 
 De manière générale, différents types de crochets, notamment s'ils
@@ -558,11 +551,13 @@ prolonge sur un triolet (ligne 2) et enfin une ligature et une liaison
 qui s'étendent sur un triolet, lui-même lié à un quintolet agrémenté
 d'une liaison de phrasé se poursuivant (lignes 3 et 4).
 
-@lilypond[quote,verbatim,ragged-right,relative=1]
-r16[ g \tuplet 3/2 { r16 e'8] }
-g,16( a \tuplet 3/2 { b16 d) e }
-g,8[( a \tuplet 3/2 { b8 d) e~] } |
-\tuplet 5/4 { e32\( a, b d e } a4.\)
+@lilypond[quote,verbatim,ragged-right]
+\relative {
+  r16[ g' \tuplet 3/2 { r16 e'8] }
+  g,16( a \tuplet 3/2 { b16 d) e }
+  g,8[( a \tuplet 3/2 { b8 d) e~] } |
+  \tuplet 5/4 { e32\( a, b d e } a4.\)
+}
 @end lilypond
 
 
@@ -615,9 +610,11 @@ Si une voix unique peut tout à fait contenir plusieurs notes dans un
 accord, à partir de quand aurons-nous vraiment besoin de plusieurs
 voix ?  Considérons déjà ces quatre accords :
 
-@lilypond[quote,verbatim,ragged-right,relative=1]
-\key g \major
-<d g>4 <d fis> <d a'> <d g>
+@lilypond[quote,verbatim,ragged-right]
+\relative {
+  \key g \major
+  <d' g>4 <d fis> <d a'> <d g>
+}
 @end lilypond
 
 Nous exprimons ici chacun des accords par l'utilisation de
@@ -650,10 +647,12 @@ polyphonie.
 Voici comment éclater les accords en deux voix, avec la note de passage
 et la liaison :
 
-@lilypond[quote,verbatim,ragged-right,relative=2]
-\key g \major
-%    Voice "1"               Voice "2"
-<< { g4 fis8( g) a4 g } \\ { d4 d d d }  >>
+@lilypond[quote,verbatim,ragged-right]
+\relative {
+  \key g \major
+  %    Voice = "1"             Voice = "2"
+  << { g'4 fis8( g) a4 g } \\ { d4 d d d }  >>
+}
 @end lilypond
 
 Notez que les hampes de la seconde voix sont dirigées vers le bas.
@@ -662,7 +661,7 @@ Autre exemple :
 
 @lilypond[quote,verbatim,fragment,ragged-right,relative=2]
 \key d \minor
-%    Voice "1"             Voice "2"
+%    Voice = "1"           Voice = "2"
 << { r4 g g4. a8 }    \\ { d,2 d4 g }       >> |
 << { bes4 bes c bes } \\ { g4 g g8( a) g4 } >> |
 << { a2. r4 }         \\ { fis2. s4 }       >> |
@@ -673,19 +672,20 @@ mesure n'est pas nécessaire.  Bien qu'on y gagne en lisibilité si chaque
 mesure ne contient que quelques notes, il est plus judicieux de
 carrément séparer chaque voix :
 
-@lilypond[quote,verbatim,ragged-right,relative=2]
-\key d \minor
-<< {
-  % Voice "1"
-  r4 g g4. a8 |
-  bes4 bes c bes |
-  a2. r4 |
-} \\ {
-  % Voice "2"
-  d,2 d4 g |
-  g4 g g8( a) g4 |
-  fis2. s4 |
-} >>
+@lilypond[quote,verbatim,ragged-right]
+<<
+  \key d \minor
+  \relative { % Voice = "1"
+    r4 g' g4. a8 |
+    bes4 bes c bes |
+    a2. r4 |
+  } \\
+  \relative { % Voice = "2"
+    d'2 d4 g |
+    g4 g g8( a) g4 |
+    fis2. s4 |
+  }
+>>
 @end lilypond
 
 @cindex voix, nommage
@@ -708,7 +708,7 @@ automatiquement.
 \new Staff \relative {
   % Main voice
   c'16 d e f
-  %    Voice "1"     Voice "2"                Voice "3"
+  %    Voice = "1"   Voice = "2"              Voice = "3"
   << { g4 f e } \\ { r8 e4 d c8~ } >> |
   << { d2 e }   \\ { c8 b16 a b8 g~ 2 } \\ { s4 b c2 } >> |
 }
@@ -800,13 +800,13 @@ des différentes voix sont espacées, consiste à placer une commande
 @code{\relative} au début de chacune des voix :
 
 @example
-\relative c' @{ noteA @dots{} @}
+\relative @{ noteA @dots{} @}
 <<
-  \relative c'' @{ < noteB noteC > @dots{} @}
+  \relative @{ < noteB noteC > @dots{} @}
 \\
-  \relative g' @{ noteD @dots{} @}
+  \relative @{ noteD @dots{} @}
 >>
-\relative c' @{ noteE @dots{} @}
+\relative @{ noteE @dots{} @}
 @end example
 
 Pour finir, analysons le principe d'utilisation des voix dans une pièce
@@ -865,12 +865,12 @@ que vous ne comprendriez pas.
 @c The following should appear as music without code
 @c The three voice styles should be defined in -init
 @lilypond[quote,ragged-right]
-\new Staff \relative c'' {
+\new Staff \relative {
   \key aes \major
   <<
     {  % Voice one
       \voiceOneStyle
-      c2 aes4. bes8
+      c''2 aes4. bes8
     }
   \\  % Voice two
     { \voiceTwoStyle
@@ -961,15 +961,10 @@ Manuel de notation :
 @translationof Explicitly instantiating voices
 
 @funindex \voiceOne
-@funindex voiceOne
 @funindex \voiceTwo
-@funindex voiceTwo
 @funindex \voiceThree
-@funindex voiceThree
 @funindex \voiceFour
-@funindex voiceFour
 @funindex \oneVoice
-@funindex oneVoice
 @funindex \new Voice
 @cindex Voice, création de contextes
 
@@ -1037,18 +1032,18 @@ annotations, liaisons de prolongation ou de phrasé, et sur les nuances.
 @end lilypond
 
 @lilypond[quote,ragged-right,verbatim]
-\relative c' {
+\relative {
   \voiceOne
-  c4 d8~ 8 e4( f | g4 a) b-> c |
+  c'4 d8~ 8 e4( f | g4 a) b-> c |
   \oneVoice
   c,4 d8~ 8 e4( f | g4 a) b-> c |
 }
 @end lilypond
 
 @lilypond[quote,ragged-right,verbatim]
-\relative c' {
+\relative {
   \voiceTwo
-  c4 d8~ 8 e4( f | g4 a) b-> c |
+  c'4 d8~ 8 e4( f | g4 a) b-> c |
   \oneVoice
   c,4 d8~ 8 e4( f | g4 a) b-> c |
 }
@@ -1068,10 +1063,10 @@ maintenant dans un seul contexte de voix, ce qui permet d'ajouter une
 liaison de phrasé à l'ensemble.
 
 @lilypond[quote,ragged-right,verbatim]
-\new Staff \relative c' {
+\new Staff \relative {
   \voiceOneStyle
   % The following notes are homophonic
-  c16^( d e f
+  c'16^( d e f
   % Start simultaneous section of three voices
   <<
     % Continue the main voice in parallel
@@ -1131,11 +1126,11 @@ silences invisibles pour sauter les moments où il n'y a rien dans cette
 voix.
 
 @lilypond[quote,ragged-right,verbatim]
-\new Staff \relative c' <<
+\new Staff \relative <<
   % Initiate first voice
   \new Voice {
     \voiceOne
-    c16^( d e f g4 f e | d2 e2) |
+    c'16^( d e f g4 f e | d2 e2) |
   }
   % Initiate second voice
   \new Voice {
@@ -1163,13 +1158,9 @@ voix.
 @cindex décalage, commandes
 
 @funindex \shiftOff
-@funindex shiftOff
 @funindex \shiftOn
-@funindex shiftOn
 @funindex \shiftOnn
-@funindex shiftOnn
 @funindex \shiftOnnn
-@funindex shiftOnnn
 
 Les notes rapprochées d'un accord, ou des notes de différentes voix qui
 tombent ensemble, seront rangées sur deux colonnes, voire plus, pour
@@ -1220,7 +1211,6 @@ deux expressions différentes -- des notes et des paroles.
 
 @funindex \new Lyrics
 @funindex \lyricsto
-@funindex lyricsto
 @funindex Lyrics
 
 @cindex Lyrics, création d'un contexte
@@ -1237,10 +1227,10 @@ la voix en question.
 @lilypond[quote,verbatim]
 <<
   \new Voice = "one" {
-    \relative c'' {
+    \relative {
       \autoBeamOff
       \time 2/4
-      c4 b8. a16 | g4. f8 | e4 d | c2 |
+      c''4 b8. a16 | g4. f8 | e4 d | c2 |
     }
   }
   \new Lyrics \lyricsto "one" {
@@ -1258,7 +1248,6 @@ et @code{Voice}.
 @cindex ligatures et paroles
 
 @funindex \autoBeamOff
-@funindex autoBeamOff
 
 Si la ligature automatique que LilyPond applique par défaut est
 pleinement adaptée en matière de musique instrumentale, il n'en va pas
@@ -1271,7 +1260,6 @@ afin de désactiver les ligatures automatiques.
 @funindex \new ChoirStaff
 @funindex ChoirStaff
 @funindex \lyricmode
-@funindex lyricmode
 
 @cindex structure d'une partition vocale
 @cindex chœur, partie de
@@ -1414,8 +1402,8 @@ Imprimer de la musique impose d'ajouter un certain nombre d'éléments de
 notation.  Par exemple, voici un fragment de partition, précédé du code
 qui l'engendre :
 
-@lilypond[quote,verbatim,relative=2]
-cis4 cis2. | a4 a2. |
+@lilypond[quote,verbatim]
+\relative { cis''4 cis2. | a4 a2. | }
 @end lilypond
 
 Si le code est assez austère, dans la partition ont été ajoutés un
@@ -1485,7 +1473,6 @@ Manuel de notation :
 @translationof Creating contexts
 
 @funindex \new
-@funindex new
 
 @cindex nouveaux contextes
 @cindex contextes, création de
@@ -1697,9 +1684,7 @@ Référence des propriétés internes :
 @cindex modification des propriétés d'un contexte
 
 @funindex \set
-@funindex set
 @funindex \unset
-@funindex unset
 
 Les contextes gèrent les différentes valeurs des nombreuses
 @emph{propriétés} qui leur sont attachées.  Beaucoup d'entre elles
@@ -1782,13 +1767,13 @@ contexte n'a pas été spécifié.
 
 @lilypond[quote,verbatim,ragged-right]
 <<
-  \new Staff \relative c'' {
+  \new Staff \relative {
     \set Staff.instrumentName = #"Soprano"
-    c4 c
+    c''4 c
  }
-  \new Staff \relative c' {
+  \new Staff \relative {
   \set instrumentName = #"Alto"  % Wrong!
-  d4 d
+  d'4 d
  }
 >>
 @end lilypond
@@ -1832,9 +1817,9 @@ Voici comment supprimer les bécarres supplémentaires pour une portée :
   \new Staff \relative {
     aeses'2 aes
   }
-  \new Staff \relative c'' {
+  \new Staff \relative {
     \set Staff.extraNatural = ##f
-    aeses2 aes
+    aeses'2 aes
   }
 >>
 @end lilypond
@@ -1847,9 +1832,9 @@ et pour toutes les portées :
   \new Staff \relative {
     aeses'2 aes
   }
-  \new Staff \relative c'' {
+  \new Staff \relative {
     \set Score.extraNatural = ##f
-    aeses2 aes
+    aeses'2 aes
   }
 >>
 @end lilypond
@@ -1875,17 +1860,19 @@ grosseur des têtes de note.  Les modifications s'appliquent toujours par
 rapport à la valeur par défaut, non par rapport à la dernière valeur
 définie.
 
-@lilypond[quote,verbatim,ragged-right,relative=1]
-c4 d
-% make note heads smaller
-\set fontSize = #-4
-e4 f |
-% make note heads larger
-\set fontSize = #2.5
-g4 a
-% return to default size
-\unset fontSize
-b4 c |
+@lilypond[quote,verbatim,ragged-right]
+\relative {
+  c'4 d
+  % make note heads smaller
+  \set fontSize = #-4
+  e4 f |
+  % make note heads larger
+  \set fontSize = #2.5
+  g4 a
+  % return to default size
+  \unset fontSize
+  b4 c |
+}
 @end lilypond
 
 Nous venons de voir comment déterminer la valeur de différents types de
@@ -1901,7 +1888,6 @@ commande @code{\markup} permet aussi de spécifier du texte.
 @translationof Setting context properties with @code{\with}
 
 @funindex \with
-@funindex with
 
 @cindex propriétés d'un contexte, définition avec \with
 
@@ -1955,7 +1941,6 @@ revenir à la nouvelle valeur par défaut.
 @cindex propriétés d'un contexte, définition avec \context
 
 @funindex \context
-@funindex context
 
 Vous pouvez régler les valeurs des propriétés de contexte en une seule
 fois pour tous les contextes d'un même type, par exemple tous les
@@ -2033,9 +2018,7 @@ Référence des propriétés internes :
 @cindex graveurs, suppression
 
 @funindex \consists
-@funindex consists
 @funindex \remove
-@funindex remove
 
 Nous avons vu que chaque contexte met en œuvre plusieurs graveurs, et
 que chacun de ces graveurs est chargé de générer une composante
@@ -2092,15 +2075,15 @@ tessiture de cette voix sera calculée :
   \new Voice \with {
     \consists "Ambitus_engraver"
   } {
-    \relative c'' {
+    \relative {
       \voiceOne
-      c4 a b g
+      c''4 a b g
     }
   }
   \new Voice {
-    \relative c' {
+    \relative {
       \voiceTwo
-      c4 e d f
+      c'4 e d f
     }
   }
 >>
@@ -2117,15 +2100,15 @@ les notes de toutes les voix de la portée :
 }
 <<
   \new Voice {
-    \relative c'' {
+    \relative {
       \voiceOne
-      c4 a b g
+      c''4 a b g
     }
   }
   \new Voice {
-    \relative c' {
+    \relative {
       \voiceTwo
-      c4 e d f
+      c'4 e d f
     }
   }
 >>
@@ -2136,7 +2119,6 @@ les notes de toutes les voix de la portée :
 @translationof Changing all contexts of the same type
 
 @funindex \layout
-@funindex layout
 
 Les exemples ci-dessus nous ont montré comment ajouter ou retirer des
 graveurs à des contextes individuels.  Nous pourrions aussi ajouter ou
@@ -2289,7 +2271,7 @@ celle pour le violoncelle @code{violoncelleMusique}.  Tant qu'on y est,
 renommons @code{texte} en @code{sopranoParoles}.  Attention à bien
 renommer les deux occurrences de chacune de ces dénominations :
 c'est-à-dire la définition de départ, où l'on trouve
-@code{melodie = \relative c' @{ }, et l'endroit où cette dénomination
+@code{melodie = \relative @{ }, et l'endroit où cette dénomination
 est utilisée, dans la section @code{\score}.
 
 Et puis, toujours tant qu'on y est, mettons le violoncelle en clé de fa,
@@ -2451,18 +2433,18 @@ bassMusic = \relative {
 }
 bassWords = \sopranoWords
 
-upper = \relative a' {
+upper = \relative {
   \clef "treble"
   \global
-  r4 <a d fis>2 <a e' a>4 |
+  r4 <a' d fis>2 <a e' a>4 |
   <d fis d'>4. <d fis d'>8 <a d a'>2 |
   <g cis g'>4 <a d fis> <a cis e>2 |
 }
 
-lower = \relative c, {
+lower = \relative {
   \clef "bass"
   \global
-  <d d'>4 <d d'>2 <cis cis'>4 |
+  <d, d'>4 <d d'>2 <cis cis'>4 |
   <b b'>4. <b' b'>8 <fis fis'>2 |
   <e e'>4 <d d'> <a' a'>2 |
 }
@@ -2687,17 +2669,17 @@ bassMusic = \relative {
   r4 d'2 cis4 | b4. b8 fis2 | e4 d a'2 |
 }
 bassWords = \sopranoWords
-upper = \relative a' {
+upper = \relative {
   \clef "treble"
   \global
-  r4 <a d fis>2 <a e' a>4 |
+  r4 <a' d fis>2 <a e' a>4 |
   <d fis d'>4. <d fis d'>8 <a d a'>2 |
   <g cis g'>4 <a d fis> <a cis e>2 |
 }
-lower = \relative c, {
+lower = \relative {
   \clef "bass"
   \global
-  <d d'>4 <d d'>2 <cis cis'>4 |
+  <d, d'>4 <d d'>2 <cis cis'>4 |
   <b b'>4. <b' b'>8 <fis fis'>2 |
   <e e'>4 <d d'> <a' a'>2 |
 }
@@ -3101,9 +3083,9 @@ fthenp =_\markup {
   \dynamic f \italic \small { 2nd } \hspace #0.1 \dynamic p
 }
 
-violin = \relative c'' {
+violin = \relative {
   \repeat volta 2 {
-    c4._\dolce b8 a8 g a b |
+    c''4._\dolce b8 a8 g a b |
     \centerText
     c4.^"hi there!" d8 e f g d |
     c4.\fthenp b8 c4 c-. |
@@ -3124,9 +3106,9 @@ précédent sans aucun identificateur.  C'est beaucoup plus laborieux à
 lire, et particulièrement la dernière ligne.
 
 @example
-violin = \relative c'' @{
+violin = \relative @{
   \repeat volta 2 @{
-    c4._\markup @{ \italic \bold dolce @} b8 a8 g a b |
+    c''4._\markup @{ \italic \bold dolce @} b8 a8 g a b |
     \once \override TextScript.self-alignment-X = #CENTER
     c4.^"hi there!" d8 e f g d |
     c4._\markup @{
@@ -3147,7 +3129,7 @@ pouvez les voir comme des fonctions.
 @lilypond[quote,verbatim,ragged-right]
 padText =
 #(define-music-function
-     (parser location padding)
+     (padding)
      (number?)
    #{
      \once \override TextScript.padding = #padding