]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/fr/learning/fundamental.itely
Merge branch 'master' into translation
[lilypond.git] / Documentation / fr / learning / fundamental.itely
index bf2775517ccaa8a8b74787f27ba095a16af81cd9..307daf8b3e7225cf9c2ae7b5731cf798afe83f75 100644 (file)
@@ -1,11 +1,11 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 
 @ignore
-    Translation of GIT committish: 958e95822083954cad00e0a598eb9f12ceba67b9
+   Translation of GIT committish: 64c8064154e24ff2a07e553ecdbda409f1726487
 
-    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.22"
@@ -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
@@ -204,7 +199,6 @@ particulièrement dans le manuel de notation, aux chapitres
 @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 } >> |
 }
@@ -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
 
@@ -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
@@ -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
@@ -1773,32 +1758,33 @@ Avant de déterminer l'une de ces propriétés, nous devons savoir dans
 quel contexte elle intervient.  Si cela est bien souvent évident, il
 peut arriver que cela tourne au cauchemar.  Lorsque vous ne spécifiez
 pas le bon contexte, aucun message d'erreur ne s'affiche et l'effet
-attendu n'est pas au rendez-vous.  Par exemple, le @code{instrumentName}
-est de manière incontestable membre du contexte @code{Staff}, puisque
-c'est bien la portée que l'on va nommer.
-Dans l'exemple suivant, la première portée affiche effectivement un nom,
-alors que ce n'est pas le cas pour la deuxième dans la mesure où le
-contexte n'a pas été spécifié.
+attendu n'est pas au rendez-vous.  Par exemple, le @code{clefGlyph} est
+de manière incontestable membre du contexte @code{Staff}, puisque c'est
+bien le glyphe de clef de la portée qui doit être changé.
+Dans l'exemple suivant, la première portée affiche effectivement la
+bonne clef, alors que ce n'est pas le cas pour la deuxième -- qui porte
+la clef de sol par défaut au lieu d'une clef de basse (clef de fa) --
+dans la mesure où le contexte n'a pas été spécifié.
 
 @lilypond[quote,verbatim,ragged-right]
 <<
   \new Staff \relative {
-    \set Staff.instrumentName = #"Soprano"
+    \set Staff.clefGlyph = "clefs.C"
     c''4 c
  }
   \new Staff \relative {
-  \set instrumentName = #"Alto"  % Wrong!
+    \set clefGlyph = "clefs.F"  % Wrong!
   d'4 d
  }
 >>
 @end lilypond
 
 Dans la mesure où le nom de contexte par défaut est @code{Voice}, la
-deuxième commande @code{\set} a défini @qq{Alto} comme propriété
-@code{instrumentName} du contexte de voix.  Puisque LilyPond n'ira pas
-chercher une telle propriété dans le contexte @code{Voice}, celle-ci ne
-sera pas interprétée.  Il ne s'agit pas d'une erreur, aucun message
-d'erreur ne sera ni émis ni enregistré.
+deuxième commande @code{\set} a défini la propriété @code{clefGlyph}
+dans le contexte de voix.  Puisque LilyPond n'ira pas chercher une telle
+propriété dans le contexte @code{Voice}, celle-ci ne sera pas
+interprétée.  Il ne s'agit pas d'une erreur, aucun message d'erreur ne
+sera ni émis ni enregistré.
 
 De la même manière, une faute d'orthographe dans le nom de la propriété
 ne générera aucun message d'erreur et l'action escomptée ne se produira
@@ -1815,7 +1801,7 @@ recommandons de vérifier le nom des propriétés que vous manipulez dans
 la Référence des propriétés internes -- voir
 @rinternals{Tunable context properties}, ou @rinternals{Contexts}.
 
-La propriété @code{instrumentName} ne sera prise en compte que si elle
+La propriété @code{clefGlyph} ne sera prise en compte que si elle
 est définie dans un contexte @code{Staff} ; d'autres propriétés
 peuvent par contre être définies dans plusieurs contextes différents.
 C'est le cas de la propriété @code{extraNatural} qui est définie par
@@ -1875,17 +1861,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 +1889,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 +1942,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 +2019,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
@@ -2136,7 +2120,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
@@ -2470,8 +2453,9 @@ lower = \relative {
 \score {
   <<  % combine ChoirStaff and PianoStaff in parallel
     \new ChoirStaff <<
-      \new Staff = "sopranos" <<
-        \set Staff.instrumentName = #"Soprano"
+      \new Staff = "sopranos"
+      \with { instrumentName = #"Soprano" }
+      <<
         \new Voice = "sopranos" {
           \global
           \sopranoMusic
@@ -2480,24 +2464,31 @@ lower = \relative {
       \new Lyrics \lyricsto "sopranos" {
         \sopranoWords
       }
-      \new Staff = "altos" <<
-        \set Staff.instrumentName = #"Alto"
+      \new Staff = "altos"
+      \with { instrumentName = #"Alto" }
+      <<
         \new Voice = "altos" {
           \global
           \altoMusic
         }
       >>
-      \new Lyrics \lyricsto "altos" { \altoWords }
-      \new Staff = "tenors" <<
-        \set Staff.instrumentName = #"Tenor"
+      \new Lyrics \lyricsto "altos" {
+        \altoWords
+      }
+      \new Staff = "tenors"
+      \with { instrumentName = #"Tenor" }
+      <<
         \new Voice = "tenors" {
           \global
           \tenorMusic
         }
       >>
-      \new Lyrics \lyricsto "tenors" { \tenorWords }
-      \new Staff = "basses" <<
-        \set Staff.instrumentName = #"Bass"
+      \new Lyrics \lyricsto "tenors" {
+        \tenorWords
+      }
+      \new Staff = "basses"
+      \with { instrumentName = #"Bass" }
+      <<
         \new Voice = "basses" {
           \global
           \bassMusic
@@ -2507,8 +2498,8 @@ lower = \relative {
         \bassWords
       }
     >>  % end ChoirStaff
-    \new PianoStaff <<
-      \set PianoStaff.instrumentName = #"Piano"
+    \new PianoStaff \with { instrumentName = #"Piano" }
+    <<
       \new Staff = "upper" \upper
       \new Staff = "lower" \lower
     >>
@@ -2548,47 +2539,51 @@ Une fois tout ceci accompli, voici notre @code{ChoirStaff} :
 
 @example
 \new ChoirStaff <<
-  \new Staff = "sopranos" <<
-    \set Staff.instrumentName = #"Soprano"
+  \new Staff = "sopranos"
+  \with @{ instrumentName = #"Soprano" @}
+  <<
     \new Voice = "sopranos" @{
       \global
-      \sopranoMusique
+      \sopranoMusic
     @}
   >>
   \new Lyrics \lyricsto "sopranos" @{
-    \sopranoParoles
+    \sopranoWords
   @}
-  \new Staff = "altos" <<
-    \set Staff.instrumentName = #"Alto"
+  \new Staff = "altos"
+  \with @{ instrumentName = #"Alto" @}
+  <<
     \new Voice = "altos" @{
       \global
-      \altoMusique
+      \altoMusic
     @}
   >>
   \new Lyrics \lyricsto "altos" @{
-    \altoParoles
+    \altoWords
   @}
-  \new Staff = "tenors" <<
-    \set Staff.instrumentName = #"Tenor"
+  \new Staff = "tenors"
+  \with @{ instrumentName = #"Tenor" @}
+  <<
     \new Voice = "tenors" @{
       \global
-      \tenorMusique
+      \tenorMusic
     @}
   >>
   \new Lyrics \lyricsto "tenors" @{
-    \tenorParoles
+    \tenorWords
   @}
-  \new Staff = "basses" <<
-    \set Staff.instrumentName = #"Bass"
+  \new Staff = "basses"
+  \with @{ instrumentName = #"Bass" @}
+  <<
     \new Voice = "basses" @{
       \global
-      \bassMusique
+      \bassMusic
     @}
   >>
   \new Lyrics \lyricsto "basses" @{
-    \bassParoles
+    \bassWords
   @}
->>  % fin du ChoirStaff
+>>  % end ChoirStaff
 @end example
 
 Il nous faut maintenant nous occuper de la partie de piano.  Nous allons
@@ -2596,8 +2591,8 @@ nous contenter de récupérer la partie de piano du modèle @qq{Solo
 piano} :
 
 @example
-\new PianoStaff <<
-  \set PianoStaff.instrumentName = #"Piano  "
+\new PianoStaff \with @{ instrumentName = #"Piano" @}
+<<
   \new Staff = "upper" \superieur
   \new Staff = "lower" \inferieur
 >>
@@ -2610,52 +2605,52 @@ Les systèmes pour chœur et pour piano doivent être combinés à l'aide de
 doubles chevrons gauche/droite puisqu'ils doivent s'empiler :
 
 @example
-<<  % combine ChoirStaff et PianoStaff l'un au-dessus de l'autre
+<<  % combine ChoirStaff and PianoStaff one above the other
   \new ChoirStaff <<
     \new Staff = "sopranos" <<
       \new Voice = "sopranos" @{
         \global
-        \sopranoMusique
+        \sopranoMusic
       @}
     >>
     \new Lyrics \lyricsto "sopranos" @{
-      \sopranoParoles
+      \sopranoWords
      @}
     \new Staff = "altos" <<
       \new Voice = "altos" @{
         \global
-        \altoMusique
+        \altoMusic
       @}
     >>
     \new Lyrics \lyricsto "altos" @{
-      \altoParoles
+      \altoWords
     @}
     \new Staff = "tenors" <<
       \clef "G_8"  % tenor clef
       \new Voice = "tenors" @{
         \global
-        \tenorMusique
+        \tenorMusic
       @}
     >>
     \new Lyrics \lyricsto "tenors" @{
-      \tenorParoles
+      \tenorWords
     @}
     \new Staff = "basses" <<
       \clef "bass"
       \new Voice = "basses" @{
         \global
-        \bassMusique
+        \bassMusic
       @}
     >>
     \new Lyrics \lyricsto "basses" @{
-      \bassParoles
+      \bassWords
     @}
-  >>  % fin du ChoirStaff
+  >>  % end ChoirStaff
 
-  \new PianoStaff <<
-    \set PianoStaff.instrumentName = #"Piano"
-    \new Staff = "upper" \superieur
-    \new Staff = "lower" \inferieur
+  \new PianoStaff \with @{ instrumentName = #"Piano" @}
+  <<
+    \new Staff = "upper" \upper
+    \new Staff = "lower" \lower
   >>
 >>
 @end example
@@ -2705,8 +2700,9 @@ lower = \relative {
 \score {
   <<  % combine ChoirStaff and PianoStaff in parallel
     \new ChoirStaff <<
-      \new Staff = "sopranos" <<
-        \set Staff.instrumentName = #"Soprano"
+      \new Staff = "sopranos"
+      \with { instrumentName = #"Soprano" }
+      <<
         \new Voice = "sopranos" {
           \global
           \sopranoMusic
@@ -2715,8 +2711,9 @@ lower = \relative {
       \new Lyrics \lyricsto "sopranos" {
         \sopranoWords
       }
-      \new Staff = "altos" <<
-        \set Staff.instrumentName = #"Alto"
+      \new Staff = "altos"
+      \with { instrumentName = #"Alto" }
+      <<
         \new Voice = "altos" {
           \global
           \altoMusic
@@ -2725,8 +2722,9 @@ lower = \relative {
       \new Lyrics \lyricsto "altos" {
         \altoWords
       }
-      \new Staff = "tenors" <<
-        \set Staff.instrumentName = #"Tenor"
+      \new Staff = "tenors"
+      \with { instrumentName = #"Tenor" }
+      <<
         \new Voice = "tenors" {
           \global
           \tenorMusic
@@ -2735,8 +2733,9 @@ lower = \relative {
       \new Lyrics \lyricsto "tenors" {
         \tenorWords
       }
-      \new Staff = "basses" <<
-        \set Staff.instrumentName = #"Bass"
+      \new Staff = "basses"
+      \with { instrumentName = #"Bass" }
+      <<
         \new Voice = "basses" {
           \global
           \bassMusic
@@ -2747,8 +2746,9 @@ lower = \relative {
       }
     >>  % end ChoirStaff
 
-    \new PianoStaff <<
-      \set PianoStaff.instrumentName = #"Piano  "
+    \new PianoStaff
+    \with { instrumentName = #"Piano  " }
+    <<
       \new Staff = "upper" \upper
       \new Staff = "lower" \lower
     >>