]> git.donarmstrong.com Git - lilypond.git/commitdiff
Doc-fr: updates LM
authorJean-Charles Malahieude <lilyfan@orange.fr>
Sat, 28 Jun 2014 15:41:47 +0000 (17:41 +0200)
committerJean-Charles Malahieude <lilyfan@orange.fr>
Sat, 28 Jun 2014 15:41:47 +0000 (17:41 +0200)
 - learning
 - common notation
 - fundamental
 - templates
 - tweaks

Documentation/fr/learning.tely
Documentation/fr/learning/common-notation.itely
Documentation/fr/learning/fundamental.itely
Documentation/fr/learning/templates.itely
Documentation/fr/learning/tweaks.itely

index 4ae8bada5e4a58054a07f54cbf7391878c466a58..c5da8f6855a5a7caa477b884e1b464b28beeb886 100644 (file)
@@ -1,6 +1,6 @@
 \input texinfo @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 @ignore
-    Translation of GIT committish: 957ee70b1613ce33157486a1372827e7c1c9274f
+    Translation of GIT committish: ab336761427b7214e133ff06b3592afa75eda1cf
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  For details, see the Contributors'
index 46548572f025f97c2a27939bb48d404832087c04..13363ddb4e60d5b293b504e4de13c2be97ff85b1 100644 (file)
@@ -1,7 +1,7 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 
 @ignore
-   Translation of GIT committish: 45f95ed2dabb3aef3c9a6995701dc255ba88d68a
+   Translation of GIT committish: ab336761427b7214e133ff06b3592afa75eda1cf
 
    When revising a translation, copy the HEAD committish of the
    version that you are working on.  For details, see the Contributors'
@@ -326,8 +326,8 @@ g4~ 4 c2~ | 4 ~ 8 a8 ~ 2 |
 @cindex legato
 
 @c Le terme de "slur" a deux sens en français : articulation et phrasé.
-@c Je garde ici le terme "legato", tel qu'il apparaît dans le texte original,
-@c car c'est celui qui me semble le plus couramment employé.
+@c Je garde ici le terme "legato", tel qu'il apparaît dans le texte
+@c original, car c'est celui qui me semble le plus couramment employé.
 @c slur = "il zon" (articulation). jcm
 @c phrasing slur = "ils ont des chapeaux ronds" (phrase). jcm
 
@@ -1495,7 +1495,7 @@ en début de fichier, après le numéro de version.
 
 Quand LilyPond traite le fichier, le titre et le compositeur sont
 imprimés au début de la partition.  Vous trouverez plus d'informations
-sur les titres à la section 
+sur les titres à la section
 @ruser{Création de titres et entête ou pied de page}.
 
 
@@ -1586,7 +1586,7 @@ absolues permet d'en préserver les octaves.
 La musiqeu peut être agencée de manière plutôt complexe.  Dans le cas
 d'une imbrication de commandes @code{\relative}, chacune des sections
 est indépendante de l'autre :
+
 @lilypond[verbatim,quote]
 \relative c { c'4 \relative c'' { f g } c }
 @end lilypond
index b838285a19382e4883ddbbb7fcbf8d652269f3f6..4ea3b61559c0b7bc3420d7c31075cc8c741a79e2 100644 (file)
@@ -1,7 +1,7 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 
 @ignore
-    Translation of GIT committish: d46572826e777ed3e9fa4656535a6e9000f2ed9e
+    Translation of GIT committish: ab336761427b7214e133ff06b3592afa75eda1cf
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  For details, see the Contributors'
@@ -293,8 +293,8 @@ tout simplement qu'@strong{il n'y a pas} de mystère.  Allez,
 expliquons-le en une ligne :
 
 @quotation
-@emph{Un bloc @code{\score} doit commencer par une et une seule
-expression musicale.}
+@emph{Un bloc @code{\score} doit contenir une et une seule expression
+musicale.}
 @end quotation
 
 @noindent
@@ -2516,8 +2516,15 @@ lower = \relative c, {
 }
 @end lilypond
 
-Aucun des modèles ne permet d'arriver exactement à cette mise en forme.
-Celui qui s'en rapprocherait le plus est 
+@warning{Cette présentation s'obtient facilement à l'aide du gabarit
+préprogrammé @code{satb.ly} -- voir @ref{Gabarits préprogrammés}.  Il
+masque, dans un but de simplification, totalement la structure des
+contextes nécessaires et les génère automatiquement.  Pour les besoins
+de la démonstration et à titre didactique nous procèderons ici pas à
+pas, ce gabarit préprogrammé ne correspondant pas forcément à vos
+attentes.}
+
+Le gabarit qui se rapprocherait le plus de cette mise en forme est
 @ref{Partition pour chœur SATB avec réduction pour piano} -- voir
 @ref{Modèles pour ensemble vocal} -- mais encore faudrait-il en
 modifier la mise en forme et refaire la partie de piano qui n'est
@@ -2809,7 +2816,7 @@ première partie du manuel requiert deux voix et la seconde une seule.
 \new PianoStaff <<
   \new Staff = "ManuelUn" <<
     \new Voice @{
-      \ManuelUnVoixUnMusique 
+      \ManuelUnVoixUnMusique
     @}
     \new Voice @{
       \ManuelUnVoixDeuxMusique
@@ -2937,7 +2944,7 @@ sous-propriété @code{stretchability}.  Les impatients trouveront les
 valeurs par défaut de la propriété @code{staff-staff-spacing} dans le
 fichier @file{scm/define-grobs.scm}, en examinant la définition du
 @emph{grob} @code{VerticalAxisGroup}.  La valeur que nous affecterons à
-@code{stretchability} est celle que contient la définition du contexte 
+@code{stretchability} est celle que contient la définition du contexte
 @code{PianoStaff} telle qu'elle apparaît dans le fichier
 @file{ly/engraver-init.ly}).
 
@@ -3292,4 +3299,3 @@ ce qui équivaut à
   }
 >>
 @end lilypond
-
index 3995bff9a0eaca61d17654869298872cbc3354ca..bb10d4528f0bc9284e39aec2a3aca68b5792078a 100644 (file)
@@ -1,14 +1,14 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 
 @ignore
-    Translation of GIT committish: 3bad1130cea3a64b2592e1bfd44fbd5f0a9a98ee
+    Translation of GIT committish: ab336761427b7214e133ff06b3592afa75eda1cf
 
     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.16.0"
+@c \version "2.19.2"
 
 @c Translators: Jean-Charles Malahieude
 
@@ -21,6 +21,7 @@ Lilypond, prets à l'emploi.  Il vous suffira d'y ajouter quelques notes,
 de lancer LilyPond, et d'aprécier le résultat.
 
 @menu
+* Gabarits préprogrammés::
 * Modèles pour portée unique::
 * Modèles pour piano::
 * Modèles pour quatuor à cordes::
@@ -31,6 +32,182 @@ de lancer LilyPond, et d'aprécier le résultat.
 @end menu
 
 
+@node Gabarits préprogrammés
+@appendixsec Gabarits préprogrammés
+@translationof Built-in templates
+
+LilyPond est livré avec un gabarit convenant à un certain nombre de
+configurations chorales. Il permet de gérer de la musique chorale
+simple, avec ou sans accompagnement de piano, présentée sur deux ou
+quatre portées.  Contrairement aux autre gabarits, celui-ci est
+« préprogrammé », ce qui signifie qu'il ne nécessite pas d'être recopié
+et édité ; il suffit en fait d'ajouter une instruction @code{\include}
+au fichier source.
+
+@warning {Contrairement à la plupart des inclusions, la commande
+@code{\include} traitant ce gabarit préprogrammé doit se place @strong{à
+la fin} du fichier source.}
+
+Les expressions musicales nécessaires sont affectées à des variables
+spécifiques.  Ces définitions doivent intervenir avant la commande
+@code{\include}.
+
+La musique peut se présenter en une ou deux voix par portée à l'aide du
+commutateur @code{TwoVoicesPerStaff} (@emph{DeuxVoixParPortée}) --
+valorisé à @code{##f} ou @code{##t} selon le cas.
+
+Voici l'intégralité d'un fichier permettant d'obtenir une partition pour
+chœur à quatre voix avec paroles individuelles et accompagnement de
+piano :
+
+@lilypond[verbatim, quote]
+  SopranoMusic = \relative { a'4\f a8 a a4 a }
+  SopranoLyrics = \lyricmode { Sop -- ra -- no ly -- rics }
+  AltoMusic = \relative { d'4\f d d d }
+  AltoLyrics = \lyricmode { Al -- to ly -- rics }
+  TenorMusic = \relative { a4\p a a a }
+  TenorLyrics = \lyricmode { Te -- nor ly -- rics }
+  BassMusic = \relative { c2\p c4 c }
+  BassLyrics = \lyricmode { Bass ly -- rics }
+  PianoRHMusic = \relative { c' e g c }
+  PianoDynamics = { s2\mp s4 s4 }
+  PianoLHMusic = \relative { c e g c }
+  \include "satb.ly"
+@end lilypond
+
+Ce même fichier peut servir à générer une partition dans laquelle deux
+voix partagent une même portée, après avoir simplement commuté
+@code{TwoVoicesPerStaff} à @code{##t}.  Chaque voix dispose à nouveau de
+ses propres paroles.
+
+@lilypond[verbatim, quote]
+  SopranoMusic = \relative { a'4\f a8 a a4 a }
+  SopranoLyrics = \lyricmode { Sop -- ra -- no ly -- rics }
+  AltoMusic = \relative { d'4\f d d d }
+  AltoLyrics = \lyricmode { Al -- to ly -- rics }
+  TenorMusic = \relative { a4\p a a a }
+  TenorLyrics = \lyricmode { Te -- nor ly -- rics }
+  BassMusic = \relative { c2\p c4 c }
+  BassLyrics = \lyricmode { Bass ly -- rics }
+  PianoRHMusic = \relative { c' e g c }
+  PianoDynamics = { s2\mp s4 s4 }
+  PianoLHMusic = \relative { c e g c }
+  TwoVoicesPerStaff = ##t
+  \include "satb.ly"
+@end lilypond
+
+Désactiver @code{TwoVoicesPerStaff}, ou le laisser à sa valeur par
+défaut, et se limiter à certaines variables seulement permet d'obtenir
+un agencement pour moins de voix.  Voici, par exemple, comment saisir un
+duo soprano basse :
+
+@lilypond[verbatim,quote]
+  SopranoMusic = \relative { c'' c c c }
+  SopranoLyrics = \lyricmode { High voice ly -- rics }
+  BassMusic = \relative { a a a a }
+  BassLyrics = \lyricmode { Low voice ly -- rics }
+  \include "satb.ly"
+@end lilypond
+
+Chacune des parties peut se voir adjoindre un deuxième couplet ou des
+paroles alternatives :
+
+@lilypond[verbatim, quote]
+  SopranoMusic = \relative { a'4 a a a }
+  SopranoLyricsOne = \lyricsto "Soprano" {
+    \set stanza = "1."
+    Words to verse one
+  }
+  SopranoLyricsTwo = \lyricsto "Soprano" {
+    \set stanza = "2."
+    Words to verse two
+  }
+  \include "satb.ly"
+@end lilypond
+
+Lorsque paroles et rythme sont identiques à toutes les voix, la
+partition peut s'agencer sur deux portées, chacune comportant deux voix.
+Le gabarit préprogrammé autorise jusqu'à neuf couplets.  L'exemple
+suivant, dépourvu d'accompagnement, se contente de trois couplets.
+
+@lilypond[verbatim, quote]
+  SopranoMusic = \relative { a' a a a }
+  AltoMusic = \relative { f' f f f }
+  VerseOne = \lyricmode {
+    \set stanza = "1."
+    Words to verse one
+  }
+  VerseTwo = \lyricmode {
+    \set stanza = "2."
+    Words to verse two
+  }
+  VerseThree = \lyricmode {
+    \set stanza = "3."
+    Words to verse three
+  }
+  TenorMusic = \relative { a a a a }
+  BassMusic = \relative { f f f f }
+  TwoVoicesPerStaff = ##t
+  \include "satb.ly"
+@end lilypond
+
+Dautres variables peuvent se voir attribuer une valeur.  C'est notamment
+le cas de la tonalité et de la métrique :
+
+@lilypond[verbatim, quote]
+  Key = \key a \major
+  Time = {
+    \time 5/4
+    \tempo "Allegro" 4 = 144
+  }
+  SopranoMusic = \relative { gis' gis gis gis gis }
+  AltoMusic = \relative { cis' cis cis cis cis }
+  VerseOne = \lyricmode { Words to this du -- et }
+  TwoVoicesPerStaff = ##t
+  \include "satb.ly"
+@end lilypond
+
+Les intitulés d'instrument, ainsi que leur version abrégée, sont
+modifiables :
+
+@lilypond[verbatim,quote]
+  SopranoMusic = \relative { c'' c c c }
+  SopranoLyrics = \lyricmode { High voice ly -- rics }
+  SopranoInstrumentName = "Soprano 1"
+  SopranoShortInstrumentName = "S1"
+  AltoMusic = \relative { a' a a a }
+  AltoLyrics = \lyricmode { Low voice ly -- rics }
+  AltoInstrumentName = "Soprano 2"
+  AltoShortInstrumentName = "S2"
+  \include "satb.ly"
+@end lilypond
+
+Une partie de soliste s'ajoute à l'aide de la variable
+@code{DescantMusic}, à laquelle s'appliqueront les paroles contenues
+dans la variable @code{DescantLyrics}.
+
+Comme pour n'importe quelle partition, vous pouver y ajouter des blocs
+@code{\header} et @code{\paper}.  Un bloc @code{\layout} devra quant à
+lui faire l'objet de la variable @code{Layout} :
+
+@example
+Layout = \layout @{ ... @}
+@end example
+
+Le jeu complet des variables modifiables disponibles est contenu dans le
+fichier @file{ly/satb.ly}.
+
+@seealso
+Manuel d'initiation :
+@ref{Organisation du code source avec des variables},
+@ref{Modèles pour ensemble vocal},
+@ref{Extension des modèles}.
+
+@knownissues
+Des arrangements plus complexes de partition pour chœur mixte à quatre
+voix ne sont pas réalisables avec ce gabarit préprogrammé.
+
+
 @node Modèles pour portée unique
 @appendixsec Modèles pour portée unique
 @translationof Single staff templates
@@ -41,7 +218,7 @@ de lancer LilyPond, et d'aprécier le résultat.
 * Notes et accords::
 * Notes paroles et accords::
 @end menu
+
 
 @node Notes seules
 @appendixsubsec Notes seules
@@ -140,6 +317,11 @@ de lancer LilyPond, et d'aprécier le résultat.
 @appendixsec Modèles pour ensemble vocal
 @translationof Vocal ensembles templates
 
+Les exemples ci-après demandent à être recopiés et édités dans vos
+propres fichiers.  Pour des constructions simples, vous pouvez
+adopter une construction préprogrammée appelée par une instruction
+@code{\include} -- voir @ref{Gabarits préprogrammés}.
+
 @menu
 * Partition pour chœur SATB::
 * Partition pour chœur SATB avec réduction pour piano::
@@ -267,4 +449,3 @@ de lancer LilyPond, et d'aprécier le résultat.
 @c Line-width below is because of Issue 766.  If that's fixed, it can be removed.
 @lilypondfile[verbatim,quote,ragged-right,texidoc,line-width=140]
 {jazz-combo-template.ly}
-
index 616c31fe4895a2dd38c4c291ed1afb7bb78a7057..463f5ef554becc6e07a4a91216bf68354ef4190e 100644 (file)
@@ -1,7 +1,7 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 
 @ignore
-    Translation of GIT committish: d46572826e777ed3e9fa4656535a6e9000f2ed9e
+    Translation of GIT committish: ab336761427b7214e133ff06b3592afa75eda1cf
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  For details, see the Contributors'
@@ -2727,7 +2727,7 @@ sur la distance de base (@code{basic-distance}) et le décalage
   >>
 >>
 @end lilypond
+
 Les portées sont vraiment rapprochées, mais c'est ce que veut l'éditeur.
 On pourra toujours les écarter au besoin en jouant sur les éléments
 @code{padding} ou @code{basic-distance}.
@@ -3466,7 +3466,7 @@ rhMusic = \relative c'' {
     \time 6/4
     \mergeDifferentlyHeadedOn
     \mergeDifferentlyDottedOn
-    bes2.^\markup { \bold "Moderato" } r8
+    bes2.\tempo "Moderato" r8
     <<
       { c,8 d fis bes a }
       \new Voice {
@@ -3531,7 +3531,7 @@ opportun.  Si vous avez oublié comment faire, reportez-vous à
 @ref{J'entends des Voix} et @ref{Instanciation explicite des voix}.
 Nous opterons ici pour une déclaration explicite des voix du passage
 polyphonique, puisque LilyPond est alors plus performant en matière
-d'évitement des collisions. 
+d'évitement des collisions.
 
 Commençons par saisir les notes comme appartenant à deux variables,
 mettons en place l'ossature des portées dans un bloc @code{\Score} et
@@ -3722,17 +3722,17 @@ lhMusic = \relative c' {
 @end lilypond
 
 Venons-en à la troisième mesure et au début de la section Moderato.
-Dans le Tutoriel, il est indiqué comment insérer du texte en gras à
-l'aide de la commande @code{\markup} ; pas de problème, du coup,
-pour ajouter @qq{Moderato} en gras.  Mais comment faire pour fusionner
-les notes de différentes voix ?  C'est là que le Manuel de notation
-peut nous venir en aide.  Une recherche sur @qq{fusionnement de notes}
-dans l'index nous renvoie au chapitre @ruser{Résolution des collisions},
-et plus précisément aux commandes permettant de fusionner des notes en
-fonction de leur type et selon qu'elles sont pointées ou non.  Dans
-notre exemple, pour la durée de la polyphonie de la troisième mesure,
-nous avons besoin de fusionner deux types de notes ; grâce aux
-informations trouvées dans le Manuel de notation, nous ajoutons
+Dans le Tutoriel, il est indiqué comment insérer une indication de tempo
+à l'aide de la commande @code{\tempo} ; pas de problème, du coup, pour
+ajouter @qq{Moderato}.  Mais comment faire pour fusionner les notes de
+différentes voix ?  C'est là que le Manuel de notation peut nous venir
+en aide.  Une recherche sur @qq{fusionnement de notes} dans l'index nous
+renvoie au chapitre @ruser{Résolution des collisions}, et plus
+précisément aux commandes permettant de fusionner des notes en fonction
+de leur type et selon qu'elles sont pointées ou non.  Dans notre exemple,
+pour la durée de la polyphonie de la troisième mesure, nous avons besoin
+de fusionner deux types de notes ; grâce aux informations trouvées dans
+le Manuel de notation, nous ajoutons
 
 @example
 \mergeDifferentlyHeadedOn
@@ -3759,7 +3759,7 @@ rhMusic = \relative c'' {
     bes1~ |
     \bar "||"
     \time 6/4
-    bes2.^\markup { \bold "Moderato" } r8
+    bes2.\tempo "Moderato" r8
     \mergeDifferentlyHeadedOn
     \mergeDifferentlyDottedOn
     % Start polyphonic section of four voices
@@ -3834,7 +3834,7 @@ rhMusic = \relative c'' {
     bes1~ |
     \bar "||"
     \time 6/4
-    bes2.^\markup { \bold "Moderato" } r8
+    bes2.\tempo "Moderato" r8
     \mergeDifferentlyHeadedOn
     \mergeDifferentlyDottedOn
     % Start polyphonic section of four voices
@@ -3905,7 +3905,7 @@ rhMusic = \relative c'' {
     bes1~ |
     \bar "||"
     \time 6/4
-    bes2.^\markup { \bold "Moderato" } r8
+    bes2.\tempo "Moderato" r8
     \mergeDifferentlyHeadedOn
     \mergeDifferentlyDottedOn
     % Start polyphonic section of four voices
@@ -4008,7 +4008,7 @@ peuvent être ainsi liées.  La solution consiste à utiliser deux voix,
 dont l'une avec les notes liées
 
 @lilypond[quote,fragment,relative=2]
-<< { b8~ 8\noBeam } \\ { b[ g8] } >>
+<< { b8~ 8\noBeam } \\ { b8[ g] } >>
 @end lilypond
 
 @noindent