From eea3764cd6bbc78506261f78ed4e7745ac69df41 Mon Sep 17 00:00:00 2001 From: Jean-Charles Malahieude Date: Sun, 2 Sep 2012 15:58:27 +0200 Subject: [PATCH] Doc-fr: updates to 2.16 - Learning --- .../fr/learning/common-notation.itely | 163 +++--- Documentation/fr/learning/fundamental.itely | 549 +++++++++--------- Documentation/fr/learning/preface.itely | 8 +- Documentation/fr/learning/templates.itely | 17 +- Documentation/fr/learning/tutorial.itely | 91 +-- Documentation/fr/learning/tweaks.itely | 290 +++++---- 6 files changed, 558 insertions(+), 560 deletions(-) diff --git a/Documentation/fr/learning/common-notation.itely b/Documentation/fr/learning/common-notation.itely index 3428877527..f546f05134 100644 --- a/Documentation/fr/learning/common-notation.itely +++ b/Documentation/fr/learning/common-notation.itely @@ -1,6 +1,7 @@ @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*- + @ignore - Translation of GIT committish: 1dea8bf1d7182f3d1a1c70bb2010f4585f56b3e6 + Translation of GIT committish: 8df40d45e4366f4e9baa2cec3b7eb38b6482150f When revising a translation, copy the HEAD committish of the version that you are working on. For details, see the Contributors' @@ -45,6 +46,7 @@ créer de belles partitions utilisant une notation musicale courante * Dernières précisions:: @end menu + @node Notation sur une seule portée @section Notation sur une seule portée @translationof Single staff notation @@ -67,7 +69,6 @@ Cette section présente la notation courante dont on a besoin pour @subsection Contrôle de mesure @translationof Bar checks - Les contrôles de barre de mesure -- @emph{bar checks} en anglais -- ne sont à priori pas strictement nécessaires. Ils permettent cependant d'indiquer directement dans le code saisi -- à l'aide d'une barre @@ -92,7 +93,7 @@ Manuel de notation : @warning{Si, comme nombre de nouveaux utilisateurs, ce qui suit vous paraît déroutant, lisez cette partie jusqu'au bout, à plus forte raison -si vous n'avez jamais fait de solfège@tie{}!} +si vous n'avez jamais fait de solfège !} @subheading Altérations @@ -123,19 +124,20 @@ dénomination des notes dans les langues nordiques et germaniques, comme l'allemand ou le hollandais. @c DIV specific -Cependant, si vous utilisez la commande -@w{@code{@w{\language@tie{}"italiano"}}} pour entrer les noms de note -français au lieu des noms hollandais, il faudra ajouter un @code{d} pour -obtenir un dièse, et un @code{b} pour un bémol. Le double dièse et le -double bémol s'obtiennent en ajoutant respectivement @code{dd} et -@code{bb}. Pour en savoir plus sur les autres langues disponibles, -consultez @ruser{Nom des notes dans d'autres langues}. +Cependant, si vous utilisez la commande @code{\language "italiano"} pour +entrer les noms de note français au lieu des noms hollandais, il faudra +ajouter un @code{d} pour obtenir un dièse, et un @code{b} pour un bémol. +Le double dièse et le double bémol s'obtiennent en ajoutant +respectivement @code{dd} et @code{bb}. Pour en savoir plus sur les +autres langues disponibles, consultez +@ruser{Nom des notes dans d'autres langues}. @c END DIV @lilypond[verbatim,quote,relative=2] cis1 ees fisis, aeses @end lilypond + @subheading Armures @cindex armure, définition de l' @@ -167,6 +169,7 @@ a @smallspace + @subheading Attention aux armures et aux hauteurs Glossaire musicologique : @@ -179,7 +182,7 @@ La combinaison de l'@notation{armure} et des hauteurs de note -- y compris les altérations -- permet à LilyPond de déterminer dans quel cas imprimer des @notation{altérations accidentelles}. L'armure n'affecte que les altérations @emph{imprimées}, et non les hauteurs -réelles@tie{}! Cette fonctionnalité est souvent source de confusion pour +réelles ! Cette fonctionnalité est souvent source de confusion pour les nouveaux utilisateurs, aussi expliquons-la en détail. LilyPond fait une distinction nette entre le contenu musical et la @@ -190,7 +193,7 @@ accidentelle -- un @emph{signe} bémol, bécarre ou dièse -- devant la note correspondante est une question qui relève de la mise en forme. La gravure d'une partition suit des règles, en particulier des règles d'indication des altérations accidentelles. Les hauteurs de note, en -revanche, relèvent de ce que vous voulez entendre@tie{}; et, dans la +revanche, relèvent de ce que vous voulez entendre ; et, dans la mesure où la musique que vous entrez est censée être celle que vous voulez entendre, LilyPond, qui n'est chargé que de la gravure, ne les choisira pas à votre place. @@ -207,17 +210,17 @@ aucune note n'a d'altération accidentelle, et pourtant vous devrez entrer le @code{is} pour les notes @code{cis} et @code{fis}. Le code @code{b} ne veut pas dire @qq{Imprimez-moi un point noir sur -la troisième ligne de la portée.} Cela signifie plutôt@tie{}: @qq{Ici se +la troisième ligne de la portée.} Cela signifie plutôt : @qq{Ici se trouve une note dont la hauteur est un si naturel.} Avec une armure de la bémol majeur, ce @code{si} est flanqué d'un bécarre -accidentel@tie{}: +accidentel : @lilypond[verbatim,quote,relative=2] \key aes \major aes4 c b c @end lilypond -Prenons un autre exemple@tie{}: imaginez-vous devant un piano@tie{}; dès +Prenons un autre exemple : imaginez-vous devant un piano ; dès lors que vous voulez enfoncer l'une des touches noires, il vous faudra @strong{ajouter} un @code{is} ou un @code{es} au nom de la note. @@ -229,7 +232,6 @@ connaître les différentes manières dont les altérations accidentelles peuvent être imprimées, consultez @ruser{Altérations accidentelles automatiques}. - @seealso Manuel de notation : @ruser{Nom des notes dans d'autres langues}, @@ -252,6 +254,7 @@ Manuel de notation : @funindex ( ... ) @funindex \( ... \) + @subheading Liaisons de prolongation Glossaire musicologique : @@ -265,9 +268,9 @@ liée. g4~ g c2~ | c4 ~ c8 a8 ~ a2 | @end lilypond + @cindex liaisons d'articulation @cindex articulation, liaisons d' - @subheading Liaisons d'articulation @c Le terme de "slur" a deux sens en français : articulation et phrasé. @@ -287,6 +290,7 @@ respectivement d'un signe @code{(} et @code{)}. d4( c16) cis( d e c cis d) e( d4) @end lilypond + @cindex liaisons de phrasé @cindex phrasé, liaisons de @cindex legato @@ -303,6 +307,7 @@ g4\( g8( a) b( c) b4\) @smallspace + @cindex liaisons d'articulation et de prolongation, différences @subheading Attention aux types de liaison @@ -321,7 +326,6 @@ enchâssées dans un @emph{legato} ou un phrasé. c4~( c8 d~ d4 e) @end lilypond - @seealso Manuel de notation : @ruser{Liaisons de prolongation}, @@ -343,15 +347,15 @@ Glossaire musicologique : @rglos{articulation}. Des @notation{articulations} peuvent être ajoutées à une note, au moyen -d'un tiret @code{-} suivi d'un caractère@tie{}: +d'un tiret @code{-} suivi d'un caractère : @lilypond[verbatim,quote,relative=2] c4-^ c-+ c-- c-| c4-> c-. c2-_ @end lilypond -@subheading Doigtés +@subheading Doigtés @cindex doigtés @funindex ^ @@ -361,7 +365,7 @@ Glossaire musicologique : @rglosnamed{fingering,doigté}. De même, des indications de doigté peuvent être ajoutées à une note en -utilisant un tiret (@samp{-}) et le chiffre à écrire@tie{}: +utilisant un tiret (@samp{-}) et le chiffre à écrire : @lilypond[verbatim,quote,relative=2] c4-3 e-5 b-2 a-1 @@ -378,6 +382,7 @@ l'articulation. c4_-^1 d^. f^4_2-> e^-_+ @end lilypond + @subheading Nuances @cindex nuances @@ -403,7 +408,7 @@ Glossaire musicologique : @rglos{decrescendo}. On obtient un signe de @notation{nuance} en ajoutant à la note les -lettres du signe, précédées d'un anti-slash @code{\}@tie{}: +lettres du signe, précédées d'un anti-slash @code{\} : @lilypond[verbatim,quote,relative=2] c4\ff c\mf c\p c\pp @@ -419,13 +424,12 @@ c4\ff c\mf c\p c\pp @notation{Crescendos} et @notation{decrescendos} débutent avec les commandes @code{\<} et @code{\>}. Ils se terminent soit par une nuance d'arrivée, par exemple @code{\f}, soit par la commande -@code{\!}@tie{}: +@code{\!} : @lilypond[verbatim,quote,relative=2] c4\< c\ff\> c c\! @end lilypond - @seealso Manuel de notation : @ruser{Articulations et ornements}, @@ -450,8 +454,7 @@ On peut ajouter du texte à une partition : c2^"espr" a_"legato" @end lilypond -Pour mettre en forme du texte, on utilise la commande -@code{\markup}@tie{}: +Pour mettre en forme du texte, on utilise la commande @code{\markup} : @lilypond[verbatim,quote,relative=2] c2^\markup{ \bold espr} @@ -460,7 +463,6 @@ a2_\markup{ } @end lilypond - @seealso Manuel de notation : @ruser{Ajout de texte}. @@ -487,7 +489,7 @@ Manuel de notation : Glossaire musicologique : @rglosnamed{beam,ligature}. -Toutes les barres de ligature sont dessinées automatiquement@tie{}: +Toutes les barres de ligature sont dessinées automatiquement : @lilypond[verbatim,quote,relative=2] a8 ais d ees r d c16 b a8 @@ -514,7 +516,6 @@ a8 c b4 d8. c16 b4 | a8 c b4 d8. c16 b4 | @end lilypond - @seealso Manuel de notation : @ruser{Barres de ligature automatiques}, @@ -537,14 +538,15 @@ Manuel de notation : Glossaire musicologique : @rglosnamed{anacrusis,anacrouse}. On crée une levée (ou anacrouse) avec la commande @code{\partial}, -suivie d'une durée@tie{}: @code{\partial@tie{}4} produit une levée d'une -noire et @code{\partial@tie{}8} d'une croche. +suivie d'une durée : @code{\partial 4} produit une levée d'une +noire et @code{\partial 8} d'une croche. @lilypond[verbatim,quote,relative=2] \partial 8 f8 | c2 d | @end lilypond + @subheading Nolets @cindex nolets @@ -557,11 +559,11 @@ Glossaire musicologique : @rglosnamed{note value,valeur d'une note}, @rglosnamed{triplet,triolet}. Les @notation{nolets} sont créés avec la commande @code{\times}, qui -prend deux arguments@tie{}: une fraction et une expression musicale. La +prend deux arguments : une fraction et une expression musicale. La durée des notes de l'expression musicale est multipliée par la fraction. Par exemple les notes d'un @notation{triolet} durent les deux tiers de la durée de leur notation réelle, cette fraction est -donc de 2/3 pour les triolets@tie{}: +donc de 2/3 pour les triolets : @lilypond[verbatim,quote,relative=2] \times 2/3 { f8 g a } @@ -570,6 +572,7 @@ donc de 2/3 pour les triolets@tie{}: \times 2/3 { d4 a8 } @end lilypond + @subheading Notes d'ornement @cindex notes d'ornement @@ -585,12 +588,13 @@ donc de 2/3 pour les triolets@tie{}: @funindex acciaccatura Glossaire musicologique : -@rglosnamed{grace notes,ornements}, @rglosnamed{acciaccatura,acciacature}, +@rglosnamed{grace notes,ornements}, +@rglosnamed{acciaccatura,acciaccature}, @rglosnamed{appoggiatura,appogiature}. Des @notation{notes d'ornement} s'obtiennent en appliquant la commande @code{\grace}, @code{\appoggiatura} ou @code{\acciaccatura} à une -expression musicale@tie{}: +expression musicale : @lilypond[verbatim,quote,relative=2] c2 \grace { a32[ b] } c2 | @@ -598,7 +602,6 @@ c2 \appoggiatura b16 c2 | c2 \acciaccatura b16 c2 | @end lilypond - @seealso Manuel de notation : @ruser{Notes d'ornement}, @@ -611,11 +614,11 @@ Manuel de notation : @translationof Multiple notes at once Cette section traite de situations où l'on a plus d'une note à la -fois@tie{}: plusieurs instruments, plusieurs voix ou portées pour un +fois : plusieurs instruments, plusieurs voix ou portées pour un même instrument (le piano, par exemple), et les accords. En théorie musicale, la polyphonie désigne une musique constituée de -plusieurs voix@tie{}; dans LilyPond, ce terme désigne les situations où +plusieurs voix ; dans LilyPond, ce terme désigne les situations où il y a plus d'une voix sur une même portée. @menu @@ -635,7 +638,7 @@ il y a plus d'une voix sur une même portée. Dans les fichiers source LilyPond, la musique est représentée par ce qu'on appelle des @emph{expressions musicales}. En soi, une seule note -peut constituer une expression musicale@tie{}: +peut constituer une expression musicale : @lilypond[verbatim,quote,relative=2] a4 @@ -643,7 +646,7 @@ a4 Mettre un groupe de notes entre accolades crée une nouvelle expression musicale, appelée @emph{expression musicale composée}. En voici un -exemple avec deux notes@tie{}: +exemple avec deux notes : @lilypond[verbatim,quote,relative=2] { a4 g4 } @@ -654,21 +657,22 @@ notes par exemple -- signifie qu'elles doivent être jouées successivement, les unes après les autres. Le résultat est une expression, qui peut elle-même être regroupée séquentiellement avec d'autres expressions. Ici, l'expression de l'exemple précédent est -combinée à deux notes@tie{}: +combinée à deux notes : @lilypond[verbatim,quote,relative=2] { { a4 g } f g } @end lilypond + @subheading Analogie avec les expressions mathématiques @cindex expression -Ce mécanisme est similaire aux formules mathématiques@tie{}: une grosse +Ce mécanisme est similaire aux formules mathématiques : une grosse formule est créée en assemblant plusieurs petites formules. De telles formules sont appelées expressions, elles ont une définition récursive, de telle sorte que vous pouvez fabriquer des expressions -arbitrairement longues et complexes. Par exemple@tie{}: +arbitrairement longues et complexes. Par exemple : @example 1 @@ -710,7 +714,7 @@ Glossaire musicologique : @rglosnamed{polyphony,polyphonie}. Cette technique est utile pour de la musique @notation{polyphonique}. Pour entrer une musique avec plusieurs voix ou plusieurs portées, nous -pouvons aussi combiner @emph{en parallèle} les expressions@tie{}: deux +pouvons aussi combiner @emph{en parallèle} les expressions : deux voix qui doivent être jouées en même temps, sont entrées comme une combinaison simultanée de deux expressions. Une expression musicale @qq{simultanée} est formée en entourant les expressions entre @code{<<} @@ -740,9 +744,9 @@ mais pas au @code{c''} de la commande @code{@bs{}relative} de départ.} Pour déterminer le nombre de portées, LilyPond regarde le début de la première expression. Si c'est une seule note, une seule portée -est produite@tie{}; si c'est une expression simultanée, plusieurs +est produite ; si c'est une expression simultanée, plusieurs portées sont produites. Nous avons dans l'exemple ci-dessous une -expression complexe@tie{}; dans la mesure où elle débute par une note +expression complexe ; dans la mesure où elle débute par une note seule, elle sera produite sur une unique portée. @lilypond[verbatim,quote] @@ -794,7 +798,6 @@ chaque partie de la musique constituant une portée. Ces éléments } @end lilypond - La commande @code{\new} introduit un @qq{contexte de notation}. Un contexte de notation est un environnement dans lequel les événements musicaux -- comme les notes ou les commandes @code{\clef} -- sont @@ -857,7 +860,7 @@ La musique pour piano s'écrit sur deux portées reliées par une @notation{accolade}. La gravure de ce type de portée est semblable à l'exemple de musique polyphonique de @ref{Plusieurs portées}, mais maintenant cette expression entière est interprétée dans un contexte -@code{PianoStaff}@tie{}: +@code{PianoStaff} : @example \new PianoStaff << @@ -878,14 +881,13 @@ Voici un bref exemple : @end lilypond Vous pouvez générer d'autres formes de regroupement, avec -@w{@code{\new GrandStaff}} pour une partition d'orchestre, ou -@w{@code{\new ChoirStaff}} qui sied particulièrement aux partitions +@code{\new GrandStaff} pour une partition d'orchestre, ou +@code{\new ChoirStaff} qui sied particulièrement aux partitions chorales. Chacun de ces regroupements constitue un contexte à part entière, avec ses particularités, tant au niveau du signe qui regroupe les portées au sein d'un @notation{système} qu'au niveau de l'étendue des barres de mesure. - @seealso Manuel de notation : @ruser{Instruments utilisant des portées multiples}, @@ -918,7 +920,7 @@ r4 2 Beaucoup d'éléments de notation que l'on peut attacher à une note simple, comme une liaison, un crochet indiquant un début ou une fin de lien, un signe d'articulation, peuvent être également attachés à un -accord@tie{}: il faut ajouter ces indications après les hauteurs et la +accord : il faut ajouter ces indications après les hauteurs et la durée, donc @emph{à l'extérieur} des chevrons. @lilypond[verbatim,quote,relative=2] @@ -1000,7 +1002,7 @@ come out to play}. Des @notation{paroles} peuvent être associées à ces notes, en les combinant avec la commande @code{\addlyrics}. On entre les paroles en -séparant chaque syllable par une espace@tie{}: +séparant chaque syllable par une espace : @lilypond[verbatim,quote] << @@ -1020,11 +1022,11 @@ paroles de la dernière syllabe -- par une espace ou un saut de ligne -- au risque de voir apparaître une @rprogram{Erreur renvoyant à ../ly/init.ly}.} - Notez les doubles chevrons @w{@code{<< ... >>}} encadrant -toute la pièce@tie{}; ils indiquent simplement que la musique et les +toute la pièce ; ils indiquent simplement que la musique et les paroles se produisent en même temps. + @node Alignement des paroles sur une mélodie @subsection Alignement des paroles sur une mélodie @translationof Aligning lyrics to a melody @@ -1058,7 +1060,7 @@ shine as bright as day}. Ajoutons-la au code. >> @end lilypond -Si vous compilez ce code en l'état, vous verrez apparaître@tie{}: +Si vous compilez ce code en l'état, vous verrez apparaître : @example song.ly:12:29: Avertissement : échec du contrôle de mesure (barcheck) à : 5/8 @@ -1069,13 +1071,13 @@ song.ly:12:46: Avertissement : échec du contrôle de mesure (barcheck) à : 3/8 | @end example -Voici qui illustre bien l'utilité des contrôles de barre de -mesure@tie{}! Remarquez que les paroles ajoutées ne s'alignent pas bien -avec les notes. Le mot @emph{shine} devrait être chanté sur deux notes -au lieu d'une. On appelle ceci un @notation{mélisme}@tie{}: il s'agit -d'une seule syllabe chantée sur plus d'une note. Il existe plusieurs -façons d'étaler une sylabe sur plusieurs notes, la plus simple étant de -lier les notes du mélisme. Pour les détails, consultez @ref{Liaisons}. +Voici qui illustre bien l'utilité des contrôles de barre de mesure ! +Remarquez que les paroles ajoutées ne s'alignent pas bien avec les +notes. Le mot @emph{shine} devrait être chanté sur deux notes au lieu +d'une. On appelle ceci un @notation{mélisme} : il s'agit d'une seule +syllabe chantée sur plus d'une note. Il existe plusieurs façons +d'étaler une syllabe sur plusieurs notes, la plus simple étant de lier +les notes du mélisme. Pour les détails, consultez @ref{Liaisons}. @lilypond[verbatim,quote] << @@ -1095,7 +1097,7 @@ lier les notes du mélisme. Pour les détails, consultez @ref{Liaisons}. Les paroles sont maintenant correctement alignées, mais les liens de croche automatiques ne conviennent pas pour les notes au-dessus de @emph{shine as}. On peut les corriger en ajoutant des liens de croche -manuels@tie{}; pour ceci consultez +manuels ; pour ceci consultez @ref{Barres de ligature automatiques et manuelles}. @lilypond[verbatim,quote] @@ -1179,11 +1181,11 @@ sur l'alignement de paroles à une mélodie. @end lilypond Avec certaines paroles, en particulier en italien, il se produit la -situation inverse@tie{}: il peut y avoir plusieurs syllabes sur une -seule note. On réalise ceci avec LilyPond grâce à un caractère souligné +situation inverse : il peut y avoir plusieurs syllabes sur une seule +note. On réalise ceci avec LilyPond grâce à un caractère souligné @code{_} sans espace entre les syllabes, ou alors en groupant les -syllabes avec des guillemets. L'exemple suivant est extrait de l'air -de Figaro @emph{Largo al factotum}, dans @notation{Figaro} de Rossini, où +syllabes avec des guillemets. L'exemple suivant est extrait de l'air de +Figaro @emph{Largo al factotum}, dans @notation{Figaro} de Rossini, où la syllabe @emph{al} est chantée sur la même note que @emph{go}. @c no ragged-right here because otherwise the hyphens get lost, @@ -1202,7 +1204,6 @@ la syllabe @emph{al} est chantée sur la même note que @emph{go}. >> @end lilypond - @seealso Manuel de notation : @ruser{Musique vocale}. @@ -1212,7 +1213,7 @@ Manuel de notation : @subsection Paroles pour plusieurs portées @translationof Lyrics to multiple staves -@cindex paroles et portées mutiples +@cindex paroles et portées multiples @cindex portées multiples et paroles La méthode simple d'ajout de paroles avec @code{\addlyrics} peut être @@ -1245,8 +1246,8 @@ L'exemple suivant est extrait de @emph{Judas Macchabée} de Händel. Pour produire des partitions plus complexes ou plus longues que cet exemple simple, il est vivement conseillé de séparer la structure de la partition des notes et paroles, grâce à des variables. Ceci sera -détaillé plus loin dans @ref{Organisation du code source avec des variables}. - +détaillé plus loin dans +@ref{Organisation du code source avec des variables}. @seealso Manuel de notation : @@ -1292,7 +1293,7 @@ l'utilisation de @emph{variables}. En utilisant des variables, parfois appelées identificateurs ou macros, on peut scinder des expressions musicales complexes en des -expressions plus simples. Une variable se définit comme suit@tie{}: +expressions plus simples. Une variable se définit comme suit : @example musiqueToto = @{ @dots{} @} @@ -1331,7 +1332,7 @@ Le nom d'une variable ne doit comporter que des caractères alphabétiques non accentués, aucun nombre ni tiret ne sont autorisés. On peut utiliser une variable déjà définie autant de fois que l'on -veut, y compris dans la définition d'une nouvelle variable@tie{}; par +veut, y compris dans la définition d'une nouvelle variable ; par exemple, cela peut servir à saisir un motif qu'une seule fois, même s'il se répète un grand nombre de fois dans la pièce. @@ -1418,7 +1419,7 @@ sur les titres à la section Jusqu'ici nous n'avons utilisé que le mode @code{\relative} pour définir les hauteurs de notes. Si c'est souvent le moyen le plus simple de saisir la musique au clavier, il existe une autre façon de -procéder@tie{}: le mode de hauteurs absolues. +procéder : le mode de hauteurs absolues. Si vous omettez la commande @code{\relative}, LilyPond considérera toutes les hauteurs comme des hauteurs absolues. Un @code{c'} désigne @@ -1434,7 +1435,7 @@ la portée en clé de fa. } @end lilypond -Voici une gamme sur 4 octaves : +Voici une gamme sur quatre octaves : @lilypond[verbatim,quote] { @@ -1479,7 +1480,7 @@ facile à lire et à saisir. @end lilypond Si d'aventure vous faites une erreur d'octaviation, le mode -@code{\relative} la mettra en évidence@tie{}: toutes les notes suivantes +@code{\relative} la mettra en évidence : toutes les notes suivantes seront placées à la mauvaise octave. En mode de hauteurs absolues, une erreur isolée ne serait pas autant visible, et serait donc plus difficile à dénicher. @@ -1504,7 +1505,7 @@ ensemble instrumental non couvert par les modèles, lisez la section Après avoir écrit quelques pièces courtes, lisez les chapitres 3 à 5 du manuel d'initiation. Rien ne s'oppose à ce que vous consultiez dès -à présent ces chapitres, bien sûr@tie{}! Néanmoins, le reste du manuel +à présent ces chapitres, bien sûr ! Néanmoins, le reste du manuel d'initiation part du principe que vous avez déjà bien assimilé la syntaxe de base de LilyPond. Vous pouvez toujours survoler ces chapitres 3 à 5, et y revenir plus tard après avoir acquis de @@ -1512,14 +1513,14 @@ l'expérience. Dans ce tutoriel comme dans le reste de ce manuel, se trouve à chaque section un paragraphe @strong{Voir aussi} contenant des références -vers d'autres sections@tie{}: il est conseillé de ne pas les suivre en -première lecture@tie{}; lorsque vous aurez lu l'ensemble du manuel +vers d'autres sections : il est conseillé de ne pas les suivre en +première lecture ; lorsque vous aurez lu l'ensemble du manuel d'initiation, vous pourrez en relisant certaines sections suivre ces références pour approfondir certains aspects. Si vous ne l'avez pas encore fait, lisez @ref{Vue d'ensemble des manuels}. Les sources de documentation et d'information sur LilyPond sont vastes, il est normal pour un débutant -de ne pas savoir où chercher@tie{}; si vous passez quelques minutes à +de ne pas savoir où chercher ; si vous passez quelques minutes à lire attentivement cette section, vous vous épargnerez certainement la frustration causée par des heures de recherches infructueuses. diff --git a/Documentation/fr/learning/fundamental.itely b/Documentation/fr/learning/fundamental.itely index 7507aa88a4..9be9bd7959 100644 --- a/Documentation/fr/learning/fundamental.itely +++ b/Documentation/fr/learning/fundamental.itely @@ -1,6 +1,7 @@ @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*- + @ignore - Translation of GIT committish: 952705bbbb000581a13836e6a733df04511e93c5 + Translation of GIT committish: 8df40d45e4366f4e9baa2cec3b7eb38b6482150f When revising a translation, copy the HEAD committish of the version that you are working on. For details, see the Contributors' @@ -29,6 +30,7 @@ partitions complexes de même qualité. * Extension des modèles:: @end menu + @node Organisation des fichiers LilyPond @section Organisation des fichiers LilyPond @translationof How LilyPond input files work @@ -49,6 +51,7 @@ description plus complète dans @ruser{Structure de fichier}. * Non-imbrication des crochets et liaisons:: @end menu + @node Introduction à la structure de fichier LilyPond @subsection Introduction à la structure de fichier LilyPond @translationof Introduction to the LilyPond file structure @@ -56,7 +59,7 @@ description plus complète dans @ruser{Structure de fichier}. @cindex format d'entrée @cindex structure de ficher -Un fichier d'entrée LilyPond ressemble à@tie{}: +Un fichier d'entrée LilyPond ressemble à : @example \version @w{"@version{}"} @@ -148,11 +151,11 @@ quoi, d'une note isolée à un gigantesque @end example @noindent -Dès lors que tout cela est entre accolades@tie{}: @code{@{ @dots{} @}}, +Dès lors que tout cela est entre accolades : @code{@{ @dots{} @}}, LilyPond le considère comme une et une seule expression musicale. Comme nous l'avons vu précédemment, un bloc @code{\score} peut contenir -d'autres informations@tie{}: +d'autres informations : @example \score @{ @@ -178,7 +181,7 @@ d'autres informations@tie{}: @noindent Gardez à l'esprit que ces trois commandes -- @code{\header}, -@code{\layout} et @code{\midi} -- sont spécifiques@tie{}: à l'inverse de +@code{\layout} et @code{\midi} -- sont spécifiques : à l'inverse de toutes les commandes débutant par une oblique inversée @code{\} (@emph{backslash} en anglais), @strong{elles ne constituent pas} des expressions musicales et ne peuvent pas faire partie d'expressions @@ -209,12 +212,13 @@ regroupées dans un seul fichier résultant. La commande @code{\book} (@emph{recueil} ou @emph{ouvrage}) n'est pas obligatoire -- elle sera créée implicitement. Néanmoins, le recours à la commande @code{\book} vous permettra d'obtenir des fichiers résultants distincts à partir -d'un même fichier source @file{.ly} -- par exemple un fichier par pupitre. +d'un même fichier source @file{.ly} -- par exemple un fichier par +pupitre. En résumé : -Dès que LilyPond rencontre un bloc @code{\book}, il crée un -fichier distinct (@file{.pdf} par exemple). Dans le cas où il n'est pas +Dès que LilyPond rencontre un bloc @code{\book}, il crée un fichier +distinct (@file{.pdf} par exemple). Dans le cas où il n'est pas mentionné explicitement, LilyPond regroupera l'intégralité du code dans un bloc @code{\book}. @@ -224,7 +228,7 @@ fragment de musique, par exemple un mouvement d'une symphonie. @cindex layout, effets selon l'emplacement Tout bloc @code{\layout} affecte le bloc @code{\score} ou @code{\book} -au sein duquel il intervient@tie{}: si c'est à l'intérieur d'un bloc +au sein duquel il intervient : si c'est à l'intérieur d'un bloc @code{\score}, seul celui-ci en sera affecté. Dans le cas où le bloc @code{\layout} se trouve à l'extérieur du bloc @code{\score}, que le bloc @code{\book} soit explicite ou non, il affectera chacun des @@ -239,7 +243,7 @@ Pour plus de détail à ce sujet, consultez Un autre raccourci pratique est la possibilité de définir des variables, également appelées @qq{identificateurs} -- voir @ref{Organisation du code source avec des variables} à ce sujet. Dans -tous les modèles, vous trouverez@tie{}: +tous les modèles, vous trouverez : @example melodie = \relative c' @{ @@ -252,17 +256,16 @@ melodie = \relative c' @{ @end example Lorsque LilyPond examinera ce fichier, il va prendre la valeur de la -variable @code{melodie}, c'est-à-dire tout ce qui suit le signe @code{=}, -et l'insérer partout où il rencontrera @code{\melodie}. Vous êtes -libre de choisir comment dénommer vos variables@footnote{Les noms de -variables sont sensibles à la casse, et ne peuvent contenir ni -chiffre, ni ponctuation, ni caractère accentué, ni espace.}@tie{}; ce -peut être @code{melodie}, @code{global}, @code{maindroitepiano}, ou +variable @code{melodie}, c'est-à-dire tout ce qui suit le signe +@code{=}, et l'insérer partout où il rencontrera @code{\melodie}. Vous +êtes libre de choisir comment dénommer vos variables@footnote{Les noms +de variables sont sensibles à la casse, et ne peuvent contenir ni +chiffre, ni ponctuation, ni caractère accentué, ni espace.} ; ce peut +être @code{melodie}, @code{global}, @code{maindroitepiano}, ou @code{laTeteAToto}, tant qu'il ne s'agit pas de @qq{mot réservé}. Pour plus de détails, voir @ref{Économie de saisie grâce aux identificateurs et fonctions}. - @seealso Pour une description complète du format des fichiers d'entrée, voir @ruser{Structure de fichier}. @@ -282,12 +285,12 @@ Pour une description complète du format des fichiers d'entrée, voir Dans la section précédente, @ref{Introduction à la structure de fichier LilyPond}, nous avons vu l'organisation générale des fichiers d'entrée de LilyPond. -Mais c'est comme si nous avions éludé la question essentielle@tie{}: -comment diable peut-on savoir quoi mettre après @code{\score}@tie{}? +Mais c'est comme si nous avions éludé la question essentielle : +comment diable peut-on savoir quoi mettre après @code{\score} ? -En fait, nous ne l'avons pas éludée du tout@tie{}: le grand mystère est +En fait, nous ne l'avons pas éludée du tout : le grand mystère est tout simplement qu'@strong{il n'y a pas} de mystère. Allez, -expliquons-le en une ligne@tie{}: +expliquons-le en une ligne : @quotation @emph{Un bloc @code{\score} doit commencer par une et une seule @@ -298,7 +301,7 @@ expression musicale.} Peut-être serait-il judicieux de relire la section @ref{Les expressions musicales en clair}, dans laquelle vous avez appris à construire de grandes expressions musicales petit bout -par petit bout -- nous avons vu les notes, puis les accords, etc. +par petit bout -- nous avons vu les notes, puis les accords, etc. Maintenant, nous allons partir d'une grande expression musicale, et remonter la pente. Pour rester simple, nous nous contenterons d'un chanteur accompagné au piano. On n'a pas besoin d'une partition @@ -322,14 +325,14 @@ une double portée de piano. Nous avons ici attribué des noms aux portées -- @qq{chanteur} et @qq{piano}. Bien que cela ne soit pas primordial, c'est une -habitude qu'il est bon d'adopter dès le départ@tie{}: vous saurez au +habitude qu'il est bon d'adopter dès le départ : vous saurez au premier coup d'œil à quoi correspond chaque portée. Vous vous souvenez que nous avons recours à @code{<<} et @code{>>} -en lieu et place de @code{@{ @dots{} @}} pour gérer des musiques +en lieu et place de @code{@{ @dots{} @}} pour gérer des musiques simultanées. Et, pour le coup, on aimerait @emph{vraiment} que la partie vocale et l'accompagnement soient imprimés ensemble@dots{} Bien -que faire appel à @code{<< ... >>} ne soit pas réellement nécessaire +que faire appel à @code{<< @dots{} >>} ne soit pas réellement nécessaire pour la portée du chanteur, dans la mesure où elle ne contient qu'une seule expression musicale, nous vous recommandons de prendre l'habitude de l'encadrer ainsi plutôt que par de simples accolades -- une portée @@ -359,13 +362,13 @@ On y voit nettement plus clair maintenant. Nous voici donc avec la partie du chanteur, qui contient un ensemble @code{Voice}, ce qui dans LilyPond correspond à une voix, au sens de voix d'une polyphonie plutôt que de voix chantée -- ce pourrait être une partie de violon par -exemple --, et des paroles. -Nous avons également une partie de piano, qui contient deux -portées@tie{}: une pour la main droite, une autre pour la main gauche. -Il nous faudra d'ailleurs ajouter une clef de fa à cette dernière. +exemple --, et des paroles. Nous avons également une partie de piano, +qui contient deux portées : une pour la main droite, une autre pour la +main gauche. Il nous faudra d'ailleurs ajouter une clef de fa à cette +dernière. À ce point, on pourrait commencer à ajouter les notes. Dans les -accolades qui suivent @code{\new Voice = "chant"}, on pourrait +accolades qui suivent @code{\new Voice = "chant"}, on pourrait commencer à écrire @example @@ -385,8 +388,7 @@ qui déclencherait immanquablement des erreurs. LilyPond dispose de différents types de données -- voir @ruser{Modes de saisie} pour plus de détails. -Avec quelques notes de plus et une clef de fa, nous pourrions -avoir@tie{}: +Avec quelques notes de plus et une clef de fa, nous pourrions avoir : @lilypond[verbatim,quote,ragged-right] melody = \relative c'' { r4 d8\noBeam g, c4 r } @@ -415,10 +417,9 @@ lower = \relative c { b2 e2 } Quand on écrit ou que l'on lit une section @code{\score}, mieux vaut y aller lentement et soigneusement. Commencez par le niveau le plus large, puis travaillez sur chaque niveau plus détaillé. À ce propos, -une indentation stricte et propre est vraiment d'une aide -précieuse@tie{}: assurez-vous que chaque élément d'un même niveau a le -même décalage horizontal dans votre éditeur de texte@tie{}! - +une indentation stricte et propre est vraiment d'une aide précieuse : +assurez-vous que chaque élément d'un même niveau a le même décalage +horizontal dans votre éditeur de texte ! @seealso Manuel de notation : @@ -433,10 +434,10 @@ Manuel de notation : @cindex ossias Déclarer toutes les portées dès le départ n'est pas une -obligation@tie{}; elles peuvent intervenir temporairement n'importe où +obligation ; elles peuvent intervenir temporairement n'importe où dans la partition. Ceci est tout à fait indiqué pour créer des sections @rglos{ossia}. L'exemple suivant illustre la manière de créer -temporairement une nouvelle portée, l'espace de trois notes@tie{}: +temporairement une nouvelle portée, l'espace de trois notes : @lilypond[verbatim,quote,ragged-right] \new Staff { @@ -461,8 +462,7 @@ celle imprimée en tête de ligne. @cindex portée, positionnement -Une section ossia se placera au dessus de la portée en procédant -ainsi@tie{}: +Une section ossia se placera au dessus de la portée en procédant ainsi : @lilypond[verbatim,quote,ragged-right] \new Staff = "main" { @@ -486,7 +486,6 @@ portée individuelle. Nous indiquons ici que la nouvelle portée doit se placer au-dessus de la portée @qq{principal} plutôt qu'en dessous, ce qui est le comportement par défaut. - @seealso Les ossias apparaissent souvent sans clef ni métrique, et dans une taille plus petite. Ceci requiert des commandes dont nous n'avons pas @@ -503,7 +502,7 @@ encore parlé. Voir @ref{Taille des objets} et @ruser{Portées d'ossia}. Nous avons déjà rencontré plusieurs types de crochets au fil de nos fichiers LilyPond. Ils obéissent à des règles différentes qui peuvent paraître déroutantes de prime abord. Avant d'examiner ces règles, voici -une liste des différents types de crochet@tie{}: +une liste des différents types de crochet : @c attempt to force this onto a new page @need 50 @@ -525,29 +524,27 @@ une liste des différents types de crochet@tie{}: @end multitable D'autres constructions permettent d'obtenir des lignes regroupant ou en -travers des notes@tie{}: les liaisons de prolongation indiquées par un -tilde (@code{~}), les marques de nolet avec -@w{@code{\times x/y @{..@}}}, ou +travers des notes : les liaisons de prolongation indiquées par un tilde +(@code{~}), les marques de nolet avec @code{\times x/y @{..@}}, ou encore les notes d'ornement avec @code{\grace@{..@}}. En dehors de LilyPond, l'imbrication correcte de différents types de crochets exige un strict respect des conventions, telles que -@code{<<@tie{}[@tie{}@{@tie{}(@tie{}..@tie{})@tie{}@}@tie{}]@tie{}>>}, -où les marques de fermeture interviennent +@code{<< [ @{ ( .. ) @} ] >>}, où les marques de fermeture interviennent obligatoirement dans l'ordre exactement inverse à celles d'ouverture. -Ceci @strong{doit} être rigoureusement respecté pour les trois -types de crochets utilisés pour @strong{délimiter} comme l'indique le -tableau ci-dessus. -Une telle rigueur dans l'imbrication n'est @strong{pas} requise pour les -types de crochets dont la fonction est de @strong{marquer}, selon le -tableau ci-dessus, lorsqu'il sont utilisés en combinaison avec des -liaisons de prolongation ou des nolets. En effet, il ne s'agit pas -de crochets ayant pour fonction de borner quelque chose@tie{}; ils -agissent plutôt comme marquant le début de quelque chose et sa fin. +Ceci @strong{doit} être rigoureusement respecté pour les trois types de +crochets utilisés pour @strong{délimiter} comme l'indique le tableau +ci-dessus. Une telle rigueur dans l'imbrication n'est @strong{pas} +requise pour les types de crochets dont la fonction est de +@strong{marquer}, selon le tableau ci-dessus, lorsqu'il sont utilisés en +combinaison avec des liaisons de prolongation ou des nolets. En effet, +il ne s'agit pas de crochets ayant pour fonction de borner quelque +chose ; ils agissent plutôt comme marquant le début de quelque chose et +sa fin. 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@tie{}: +avant la fin de la ligature : @lilypond[quote,verbatim,ragged-right,relative=2] g8\( a b[ c b\) a] g4 @@ -573,7 +570,7 @@ g,8[( a \times 2/3 { b8 d) e~] } | @section Les voix contiennent la musique @translationof Voices contain music -Les chanteurs utilisent leur voix pour chanter@tie{}; il en va de même +Les chanteurs utilisent leur voix pour chanter ; il en va de même pour LilyPond. En fait, la musique de chacun des instruments d'une partition est contenue dans des voix (@emph{Voices} en anglais), qui se trouvent être le concept fondamental de LilyPond. @@ -584,6 +581,7 @@ se trouvent être le concept fondamental de LilyPond. * Voix et paroles:: @end menu + @node J'entends des Voix @subsection J'entends des Voix @translationof I'm hearing Voices @@ -600,8 +598,8 @@ se trouvent être le concept fondamental de LilyPond. Dans une partition gérée par LilyPond, le niveau le plus bas, ou bien élémentaire ou fondamental, est le @qq{contexte de voix} -- @emph{Voice -context} en anglais --. Pour d'autres logiciels, on fait tantôt -référence à la notion de @qq{couche} ou de @qq{calque}. +context} en anglais. Pour d'autres logiciels, on fait tantôt référence +à la notion de @qq{couche} ou de @qq{calque}. En réalité, le contexte de voix est le seul à pouvoir contenir de la musique. S'il n'est pas déclaré explicitement, il sera créé @@ -615,7 +613,7 @@ et rythmes différents. Si une voix unique peut tout à fait contenir plusieurs notes dans un accord, à partir de quand aurons-nous vraiment besoin de plusieurs -voix@tie{}? Considérons déjà ces quatre accords@tie{}: +voix ? Considérons déjà ces quatre accords : @lilypond[quote,verbatim,ragged-right,relative=1] \key g \major @@ -623,16 +621,15 @@ voix@tie{}? Considérons déjà ces quatre accords@tie{}: @end lilypond Nous exprimons ici chacun des accords par l'utilisation de -chevrons gauche et droite simples, @w{@code{< ... >}}, puisque nous +chevrons gauche et droite simples, @code{< @dots{} >}, puisque nous n'avons besoin que d'une seule voix. Supposons maintenant que le fa dièse soit une croche, suivie d'un sol croche -- une note de passage -vers le la@tie{}? Nous avons alors deux notes qui débutent au même -moment, mais dont la durée est différente@tie{}: un ré noire et un fa -dièse croche. Comment coder cela@tie{}? Dans la mesure où toutes les -notes d'un accord doivent avoir la même durée, nous ne pouvons pas -écrire un accord. Nous ne pouvons pas non plus écrire deux notes -séparées, puisqu'elles débutent en même temps. Nous avons alors besoin -de deux voix. +vers le la ? Nous avons alors deux notes qui débutent au même moment, +mais dont la durée est différente : un ré noire et un fa dièse croche. +Comment coder cela ? Dans la mesure où toutes les notes d'un accord +doivent avoir la même durée, nous ne pouvons pas écrire un accord. Nous +ne pouvons pas non plus écrire deux notes séparées, puisqu'elles +débutent en même temps. Nous avons alors besoin de deux voix. Voyons comment cela se pratique selon la grammaire de LilyPond. @@ -651,7 +648,7 @@ d'une pièce homophonique ne comportant que quelques courts passages de polyphonie. Voici comment éclater les accords en deux voix, avec la note de passage -et la liaison@tie{}: +et la liaison : @lilypond[quote,verbatim,ragged-right,relative=2] \key g \major @@ -674,7 +671,7 @@ Autre exemple : Le recours à une construction @code{<< \\ >>} particulière à chaque 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@tie{}: +carrément séparer chaque voix : @lilypond[quote,verbatim,ragged-right,relative=2] \key d \minor @@ -691,7 +688,6 @@ carrément séparer chaque voix@tie{}: } >> @end lilypond - @cindex voix, nommage @cindex voix et constructions simultanées @cindex liaisons et constructions simultanées @@ -700,12 +696,12 @@ Cet exemple ne comporte que deux voix, mais il peut être étendu pour traiter trois voix ou plus en ajoutant autant de séparateurs @code{\\} que de besoin. -Les contextes @code{Voice} portent les noms @code{"1"}, @code{"2"}, etc. +Les contextes @code{Voice} portent les noms @code{"1"}, @code{"2"}, etc. Les premiers contextes définissent les voix @emph{extrêmes}, la plus haute au contexte @code{"1"}, le plus basse au contexte @code{"2"}. Les voix intermédiaires seront affectées aux contextes @code{"3"} et @code{"4"}. Pour chacun de ces contextes, le positionnement et -l'orientation des liaisons, hampes, nuances, etc. est définie +l'orientation des liaisons, hampes, nuances, etc. est définie automatiquement. @lilypond[quote,verbatim] @@ -722,7 +718,7 @@ Ces voix sont séparées de la voix principale, laquelle contient les notes en dehors de la construction @code{<<...>>} -- que nous appellerons @emph{construction simultanée}. Les liaisons, de prolongation ou non, ne peuvent relier des notes que si elles -appartiennent à la même voix@tie{}; elles ne peuvent ni pénétrer une +appartiennent à la même voix ; elles ne peuvent ni pénétrer une construction simultanée, ni en sortir. Inversement, les voix parallèles issues de constructions simultanées apparaissant sur une même portée appartiennent à la même voix. Les autres propriétés liées au contexte @@ -775,10 +771,9 @@ couleur des hampes et ligatures et le style de tête des note, pour permettre une meilleure distinction entre les différentes voix. La première voix comporte des têtes en losange rouge, la deuxième en triangle bleu, la troisième en cercle barré vert, la quatrième (non -utilisée ici) en croix magenta@tie{}; @code{\voiceNeutralStyle} (non -utilisé ici) revient au style par défaut. Nous verrons plus tard -comment créer de telles commandes. -Voir @ref{Visibilité et couleur des objets} et +utilisée ici) en croix magenta ; @code{\voiceNeutralStyle} (non utilisé +ici) revient au style par défaut. Nous verrons plus tard comment créer +de telles commandes. Voir @ref{Visibilité et couleur des objets} et @ref{Utilisation de variables dans les retouches}. @cindex polyphonie et mode relatif @@ -802,7 +797,7 @@ qui précède. Ainsi, dans Une méthode alternative, et qui peut simplifier les choses si les notes des différentes voix sont espacées, consiste à placer une commande -@code{\relative} au début de chacune des voix@tie{}: +@code{\relative} au début de chacune des voix : @example \relative c' @{ noteA ... @} @@ -856,16 +851,16 @@ plus d'une voix. Mais le réel besoin de multiples voix se fait sentir dès lors que plusieurs notes qui débutent en même temps ont des durées différentes. -C'est évident au troisième temps de la première mesure@tie{}: le la -bémol est une noire pointée, le fa une noire, et le ré bémol une -blanche. On ne peut les grouper dans un accord, puisque toutes les -notes composant un accord doivent être de même durée. On ne peut non -plus les écrire séquentiellement, puisqu'elles débutent toutes au même -instant. Ce fragment de mesure nécessite trois voix, et une bonne -pratique voudrait que l'intégralité de la mesure soit sur trois voix, -comme ci-dessous où nous avons une allure et une couleur différentes aux -notes de chacune d'entre elles. Une fois de plus, nous reviendrons plus -tard sur le code que vous ne comprendriez pas. +C'est évident au troisième temps de la première mesure : le la bémol est +une noire pointée, le fa une noire, et le ré bémol une blanche. On ne +peut les grouper dans un accord, puisque toutes les notes composant un +accord doivent être de même durée. On ne peut non plus les écrire +séquentiellement, puisqu'elles débutent toutes au même instant. Ce +fragment de mesure nécessite trois voix, et une bonne pratique voudrait +que l'intégralité de la mesure soit sur trois voix, comme ci-dessous où +nous avons une allure et une couleur différentes aux notes de chacune +d'entre elles. Une fois de plus, nous reviendrons plus tard sur le code +que vous ne comprendriez pas. @c The following should appear as music without code @c The three voice styles should be defined in -init @@ -898,9 +893,8 @@ tard sur le code que vous ne comprendriez pas. Essayons à présent de coder cette musique en partant de zéro. Comme nous le verrons, certaines difficultés vont se présenter. Partons de ce -que nous avons appris@tie{}: utilisons la construction -@code{<<@tie{}\\@tie{}>>} pour saisir la première mesure dans trois -voix@tie{}: +que nous avons appris : utilisons la construction @code{<< \\ >>} pour +saisir la première mesure dans trois voix : @lilypond[quote,verbatim,ragged-right] \new Staff \relative c'' { @@ -919,13 +913,12 @@ voix@tie{}: @cindex voix et direction des hampes @cindex direction des hampes et voix -La direction des hampes est attribuée automatiquement@tie{}: les voix +La direction des hampes est attribuée automatiquement : les voix impaires portent des hampes vers le haut, les voix paires des hampes vers le bas. Les hampes des voix 1 et 2 sont orientées comme il faut mais celles de la voix 3 devraient, dans le cas qui nous occupe, aller vers le bas. Nous pouvons corriger cela en sautant la voix 3 et en -plaçant la musique dans la voix 4 grâce à un @code{\\} -supplémentaire@tie{}: +plaçant la musique dans la voix 4 grâce à un @code{\\} supplémentaire : @lilypond[quote,verbatim,ragged-right] \new Staff \relative c'' { @@ -949,16 +942,15 @@ décale les notes des voix intermédiaires lorsque leur tête ou leur hampe viendrait à chevaucher celles des voix extrêmes. Bien entendu, ce n'est pas souhaitable dans le cas d'une partition pour piano. Dans d'autres situations, les décalages que LilyPond applique peuvent ne pas éviter -certaines collisions. LilyPond met à notre disposition plusieurs -moyens d'ajuster le positionnement horizontal des notes. Nous ne sommes -pas encore tout à fait prêts pour voir comment corriger cela, aussi nous +certaines collisions. LilyPond met à notre disposition plusieurs moyens +d'ajuster le positionnement horizontal des notes. Nous ne sommes pas +encore tout à fait prêts pour voir comment corriger cela, aussi nous examinerons ce problème dans un autre chapitre (voir la propriété @code{force-hshift} dans @ref{Correction des collisions d'objets}). -@warning{Paroles et objets étendus (liaisons, soufflets etc.) ne peuvent +@warning{Paroles et objets étendus (liaisons, soufflets, etc.) ne peuvent passer d'une voix à l'autre.} - @seealso Manuel de notation : @ruser{Plusieurs voix}. @@ -982,15 +974,15 @@ Manuel de notation : @cindex Voice, création de contextes Les contextes @rinternals{Voice} peuvent être déclarés manuellement -dans un bloc @code{@w{<< >>}} pour créer de la musique polyphonique, en -utilisant @code{\voiceOne}, @dots{} jusqu'à @code{\voiceFour} pour +dans un bloc @code{<< >>} pour créer de la musique polyphonique, en +utilisant @code{\voiceOne}@dots{} jusqu'à @code{\voiceFour} pour assigner des directions de hampes et un déplacement horizontal pour chaque partie. Cette méthode apporte de la clarté pour des partitions plus importantes puisqu'elle permet de bien séparer les voix et de leur affecter un nom plus parlant. En particulier, la construction @code{<< \\ >>} que nous avons vue -précédemment@tie{}: +précédemment : @example \new Staff @{ @@ -1066,14 +1058,14 @@ Voyons à présent trois différentes façons d'exprimer un passage polyphonique, à partir d'un exemple de la section précédente. Chacune d'elles aura ses avantages selon les circonstances. -Une expression séquentielle qui apparaît en premier dans un @code{<< >>} --- attention, @strong{pas} dans une construction @code{<< \\ >>} -- +Une expression séquentielle qui apparaît en premier dans un @code{<< >>} +-- attention, @strong{pas} dans une construction @code{<< \\ >>} -- appartient à la voix principale. Ceci est utile lorsque des voix supplémentaires apparaissent pendant que la voix principale est jouée. -Voici une meilleure réalisation de notre exemple. -Les notes colorées et en croix mettent en évidence le fait que la -mélodie principale est maintenant dans un seul contexte de voix, ce qui -permet d'ajouter une liaison de phrasé à l'ensemble. +Voici une meilleure réalisation de notre exemple. Les notes colorées et +en croix mettent en évidence le fait que la mélodie principale est +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' { @@ -1086,7 +1078,7 @@ permet d'ajouter une liaison de phrasé à l'ensemble. { g4 f e | d2 e) | } % Initiate second voice \new Voice { - % Set stems, etc., down + % Set stems, etc., down \voiceTwo r8 e4 d c8~ | c8 b16 a b8 g~ g2 | } @@ -1105,10 +1097,9 @@ permet d'ajouter une liaison de phrasé à l'ensemble. @cindex voix temporaires @cindex voix, imbrication - Dans certaines circonstances de polyphonie complexe, vous pourrez être amené à recourir à une voix temporaire, ce qui peut être une manière -plus naturelle de saisir la musique@tie{}: +plus naturelle de saisir la musique : @lilypond[quote,ragged-right,verbatim] \new Staff \relative c' { @@ -1161,6 +1152,7 @@ voix. >> @end lilypond + @subsubheading Empilement des notes @translationof Note columns @@ -1186,11 +1178,11 @@ empilements de notes. Chaque voix dispose de plusieurs empilements, et l'attribution d'un décalage à une voix en particulier s'appliquera à l'empilement en question s'il y avait risque de collision. Nous en avons une illustration à la deuxième mesure de l'exemple -ci-dessus@tie{}: le do de la deuxième voix est décalé à droite du ré de +ci-dessus : le do de la deuxième voix est décalé à droite du ré de la première voix et, dans l'accord final, le do de la troisième voix est lui aussi décalé à droite des autres notes. -Les commandes @code{\shiftOn}, @code{\shiftOnn}, @code{\shiftOnnn}, et +Les commandes @code{\shiftOn}, @code{\shiftOnn}, @code{\shiftOnnn} et @code{\shiftOff} spécifient le degré nécessaire de décalage qui sera appliqué aux notes ou accords de la voix en question afin d'éviter une collision. Par défaut, les voix extérieures -- normalement les @@ -1211,7 +1203,6 @@ même moment et qu'aucun décalage n'a été spécifié ou qu'ils sont identiques, LilyPond vous le signalera par le message @qq{Trop d'empilements en conflit}. - @seealso Manuel de notation : @ruser{Plusieurs voix}. @@ -1221,7 +1212,7 @@ Manuel de notation : @subsection Voix et paroles @translationof Voices and vocals -La musique vocale est une gageure en soi@tie{}: il nous faut combiner +La musique vocale est une gageure en soi : il nous faut combiner deux expressions différentes -- des notes et des paroles. @funindex \new Lyrics @@ -1236,9 +1227,9 @@ Nous avons déjà abordé la commande @code{\addlyrics@{@}}, qui permet de gérer des partitions simples. Cette technique est cependant relativement limitée. Pour de la musique un peu plus compliquée, il vous faudra contenir les paroles dans un contexte @code{Lyrics}, créé -par la commande @code{\new Lyrics}@tie{}; vous relierez ensuite ces -paroles aux notes grâce à la commande @code{\lyricsto@{@}} et au nom -assigné à la voix en question. +par la commande @code{\new Lyrics} ; vous relierez ensuite ces paroles +aux notes grâce à la commande @code{\lyricsto@{@}} et au nom assigné à +la voix en question. @lilypond[quote,verbatim] << @@ -1266,11 +1257,11 @@ et @code{Voice}. @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 de même dans le cas d'une musique associée à des paroles, -et pour laquelle soit les ligatures sont carrément absentes, soit elles -servent à indiquer un mélisme -- plusieurs notes pour une même syllabe. +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 +de même dans le cas d'une musique associée à des paroles, et pour +laquelle soit les ligatures sont carrément absentes, soit elles servent +à indiquer un mélisme -- plusieurs notes pour une même syllabe. Dans l'exemple qui suit, nous utilisons la commande @code{\autoBeamOff} afin de désactiver les ligatures automatiques. @@ -1388,7 +1379,6 @@ VerseFour = } @end lilypond - @seealso Manuel de notation : @ruser{Musique vocale}. @@ -1399,7 +1389,7 @@ Manuel de notation : @translationof Contexts and engravers Nous avons évoqué rapidement les contextes et graveurs dans les -chapitres précédents@tie{}; examinons en détail ces concepts essentiels +chapitres précédents ; examinons en détail ces concepts essentiels à la maîtrise de LilyPond. @menu @@ -1410,6 +1400,7 @@ chapitres précédents@tie{}; examinons en détail ces concepts essentiels * Ajout et suppression de graveurs:: @end menu + @node Tout savoir sur les contextes @subsection Tout savoir sur les contextes @translationof Contexts explained @@ -1418,7 +1409,7 @@ chapitres précédents@tie{}; examinons en détail ces concepts essentiels 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@tie{}: +qui l'engendre : @lilypond[quote,verbatim,relative=2] cis4 cis2. | a4 a2. | @@ -1426,12 +1417,12 @@ cis4 cis2. | a4 a2. | Si le code est assez austère, dans la partition ont été ajoutés un chiffre de mesure, des barres de mesure, des altérations et une clé. -Pour une bonne raison@tie{}: LilyPond @emph{interprète} le code. Il le +Pour une bonne raison : LilyPond @emph{interprète} le code. Il le compulse dans l'ordre chronologique, de même qu'on lit une partition de -gauche à droite@tie{}; et pendant ce traitement, le logiciel garde en +gauche à droite ; et pendant ce traitement, le logiciel garde en mémoire les limites des mesures, ou encore quelles hauteurs de note demandent des altérations accidentelles. Ces informations se présentent -à plusieurs niveaux@tie{}: ainsi, une altération n'a d'effet que sur une +à plusieurs niveaux : ainsi, une altération n'a d'effet que sur une seule portée, tandis qu'une barre de mesure doit être synchronisée sur toute l'étendue verticale de la partition. @@ -1439,7 +1430,7 @@ LilyPond regroupe ces règles et ces fragments d'information dans des @emph{Contextes}. Certains contextes sont les voix (contexte @code{Voice}), les portées (contexte @code{Staff}), ou la partition dans son ensemble (contexte @code{Score}). Ils sont ordonnés -hiérarchiquement@tie{}: ainsi un contexte @code{Staff} peut contenir +hiérarchiquement : ainsi un contexte @code{Staff} peut contenir plusieurs contextes @code{Voice}, et un contexte @code{Score} peut contenir plusieurs contextes @code{Staff}. @@ -1455,11 +1446,11 @@ peut faire intervenir une altération accidentelle, puis le contexte dans la suite de la mesure. Les barres de mesure, quant à elles, sont alignées verticalement grâce -au contexte @code{Score} par défaut. -En revanche, dans une musique polymétrique, par exemple mêlant une -portée à 3/4 et une autre à 4/4, les barres de mesures n'ont plus à être -alignées@tie{}: il faut alors modifier les comportement par défaut des -contextes @code{Score} et @code{Staff}. +au contexte @code{Score} par défaut. En revanche, dans une musique +polymétrique, par exemple mêlant une portée à 3/4 et une autre à 4/4, +les barres de mesures n'ont plus à être alignées : il faut alors +modifier les comportement par défaut des contextes @code{Score} et +@code{Staff}. Dans une partition très simple, les contextes sont créés implicitement et peuvent être ignorés. Mais lorsqu'il s'agit de morceaux plus amples @@ -1475,13 +1466,12 @@ partition et portée, chargés de gérer certains regroupement, tels que @code{PianoStaff} ou @code{ChoirStaff}. Vous disposez aussi d'autres contextes de portée ou de voix alternatifs, ainsi que des contextes spécifiques pour les paroles, les percussions, les diagrammes pour -instruments frettés, la basse chiffrée, etc. +instruments frettés, la basse chiffrée, etc. Le nom de chacun des contextes est formé d'un ou plusieurs mots aux initiales en capitale et directement accolés les uns aux autres sans ponctuation, comme par exemple @code{GregorianTranscriptionStaff}. - @seealso Manuel de notation : @ruser{Tout savoir sur les contextes}. @@ -1497,20 +1487,19 @@ Manuel de notation : @cindex nouveaux contextes @cindex contextes, création de -Il en va des contextes comme de toute hiérarchie@tie{}: il faut un -sommet -- le contexte @code{Score} en l'occurrence. La commande -@code{\score} est chargée de le créer, mais pour des partitions simples, -il le sera automatiquement. Le bloc @code{\score} contient donc une -expression musicale unique ainsi que la définition des supports à -produire -- @code{\layout} pour du visuel ou @code{\midi} pour de -l'acoustique. +Il en va des contextes comme de toute hiérarchie : il faut un sommet -- +le contexte @code{Score} en l'occurrence. La commande @code{\score} est +chargée de le créer, mais pour des partitions simples, il le sera +automatiquement. Le bloc @code{\score} contient donc une expression +musicale unique ainsi que la définition des supports à produire -- +@code{\layout} pour du visuel ou @code{\midi} pour de l'acoustique. Lorsqu'une partition ne comporte qu'une voix et une seule portée, vous pouvez laisser LilyPond créer automatiquement les contextes @code{Voice} -et @code{Staff}@tie{}; mais leur présence explicite devient -indispensable dès que la situation se complique. -Le moyen le plus simple est d'utiliser la commande @code{\new}. Elle -doit intervenir avant une expression musicale, ainsi@tie{}: +et @code{Staff} ; mais leur présence explicite devient indispensable dès +que la situation se complique. Le moyen le plus simple est d'utiliser +la commande @code{\new}. Elle doit intervenir avant une expression +musicale, ainsi : @example \new @var{type} @var{expression-musicale} @@ -1534,7 +1523,7 @@ chapitre @ref{Modification des propriétés d'un contexte}.} Nous avons déjà vu au cours des chapitres précédents de nombreux exemples où des contextes @code{Staff} ou @code{Voice} étaient créés au besoin. Dans un but didactique, voici maintenant une application -complète et abondamment commentée@tie{}: +complète et abondamment commentée : @lilypond[quote,verbatim,ragged-right] \score { % start of single compound music expression @@ -1572,40 +1561,39 @@ complète et abondamment commentée@tie{}: } % end of single compound music expression @end lilypond -Notez que toute déclaration qui ouvre un bloc par une -accolade, @code{@{}, ou un double chevron gauche, @code{<<}, est -indentée de deux espaces supplémentaires, et de deux autres pour sa -marque de fermeture. Bien que ceci ne soit pas obligatoire, nous vous -invitons à adopter cette pratique qui vous évitera nombre d'erreurs -@qq{accolades non appariées}. La structure de la musique apparaît ainsi -au premier coup d'œil, et les défauts de parité sont plus facilement -repérables. Vous remarquerez que la portée MG est créée à l'aide d'un -double chevron gauche -- nécessaire pour gérer ses deux voix -- alors -que la portée MD ne contient qu'une seule expression musicale -- il n'y -a qu'une voix -- bornée par des accolades simples. +Notez que toute déclaration qui ouvre un bloc par une accolade, +@code{@{}, ou un double chevron gauche, @code{<<}, est indentée de deux +espaces supplémentaires, et de deux autres pour sa marque de fermeture. +Bien que ceci ne soit pas obligatoire, nous vous invitons à adopter +cette pratique qui vous évitera nombre d'erreurs @qq{accolades non +appariées}. La structure de la musique apparaît ainsi au premier coup +d'œil, et les défauts de parité sont plus facilement repérables. Vous +remarquerez que la portée MG est créée à l'aide d'un double chevron +gauche -- nécessaire pour gérer ses deux voix -- alors que la portée MD +ne contient qu'une seule expression musicale -- il n'y a qu'une voix -- +bornée par des accolades simples. @cindex contexte, nommage @cindex nommage des contextes La commande @code{\new} peut aussi permettre de nommer le contexte créé, -et ainsi le distinguer des autres contextes déjà existants@tie{}: +et ainsi le distinguer des autres contextes déjà existants : @example \new @var{type} = @var{"UnNom"} @var{expression-musicale} @end example Vous noterez la distinction entre le nom du type de contexte, -@code{Staff}, @code{Voice}, etc. et le nom -- une simple suite de +@code{Staff}, @code{Voice}, etc. et le nom -- une simple suite de lettres au bon gré de l'utilisateur -- permettant d'identifier une instance particulière du type en question. Vous pouvez utiliser des chiffres et espaces, à la stricte condition d'englober le tout dans des -guillemets@tie{}; l'identificateur suivant est tout à fait valide@tie{}: -@w{@code{\new Staff = "MaPortee 1" @var{expression-musicale}}}. +guillemets ; l'identificateur suivant est tout à fait valide : +@code{\new Staff = "MaPortee 1" @var{expression-musicale}}. Comme nous l'avons déjà vu dans le chapitre consacré aux paroles (@ref{Voix et paroles}), cet identifiant permettra ensuite de se référer à ce contexte particulier. - @seealso Manuel de notation : @ruser{Création d'un contexte}. @@ -1621,8 +1609,8 @@ Manuel de notation : Tout point qui compose une partition générée par LilyPond est produit par un graveur (@emph{engraver} en anglais). Ainsi, il y en a un qui imprime les portées, un autre les têtes de note, un autre les -hampes, un autre encore pour les ligatures, etc. LilyPond dispose de -plus de 120 graveurs@tie{}! La plupart des partitions ne requièrent de +hampes, un autre encore pour les ligatures, etc. LilyPond dispose de +plus de 120 graveurs ! La plupart des partitions ne requièrent de s'intéresser qu'à quelques-uns seulement, et pour des partitions simples, vous n'aurez même pas à vous en préoccuper. @@ -1632,7 +1620,7 @@ s'appliquent à la partition dans son intégralité, opèrent au sein du contexte de plus haut niveau -- le contexte @code{Score}. Les graveurs @code{Clef_engraver} et @code{Key_engraver} seront logés -dans chacun des contextes @code{Staff}@tie{}; deux portées peuvent +dans chacun des contextes @code{Staff} ; deux portées peuvent requérir des clefs et des armures différentes. Les graveurs @code{Note_heads_engraver} et @code{Stem_engraver} résident @@ -1659,7 +1647,8 @@ partir du nom, et vice versa. @headitem Graveur @tab Fonction @item Accidental_engraver - @tab Crée les altérations, y compris de précaution, accidentelles ou suggérées + @tab Crée les altérations, y compris de précaution, accidentelles ou + suggérées @item Beam_engraver @tab Grave les ligatures (@emph{beams}) @item Clef_engraver @@ -1691,7 +1680,6 @@ partir du nom, et vice versa. Nous verrons plus avant comment le résultat de LilyPond peut changer lorsqu'on modifie l'action des graveurs. - @seealso Référence des propriétés internes : @rinternals{Engravers and Performers}. @@ -1714,7 +1702,7 @@ Les contextes gèrent les différentes valeurs des nombreuses @emph{propriétés} qui leur sont attachées. Beaucoup d'entre elles sont susceptibles d'être modifiées afin d'influer sur l'interprétation de l'input et ainsi changer l'apparence du résultat. On les modifie -grâce à la commande @code{\set}, qui s'utilise ainsi@tie{}: +grâce à la commande @code{\set}, qui s'utilise ainsi : @example \set @emph{ContexteNommé}.@emph{propriétéNommée} = #@emph{valeur} @@ -1746,7 +1734,8 @@ communément utilisées. @tab @code{50} @item doubleSlurs @tab Booléen - @tab Si vrai, imprime les liaisons au-dessous @strong{et} au-dessus des notes + @tab Si vrai, imprime les liaisons au-dessous @strong{et} au-dessus + des notes @tab @code{#t}, @code{#f} @item instrumentName @tab Texte @@ -1768,7 +1757,7 @@ anglais) ou faux (@code{#f} pour @emph{False} en anglais), un entier est un nombre entier positif, un réel est un nombre décimal positif ou négatif, et texte correspond à une suite de caractères encadrée par des apostrophes doubles. Attention à la présence des signes dièse -(@code{#}) dans deux cas particuliers@tie{}: ils sont partie intégrante +(@code{#}) dans deux cas particuliers : ils sont partie intégrante des valeurs booléennes et précèdent les @code{t} ou @code{f}, mais doivent aussi précéder @emph{valeur} dans le libellé de la commande @code{\set}. Il faudra donc, dans le cas d'une valeur booléenne, ne pas @@ -1824,17 +1813,16 @@ 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 -est définie dans un contexte @code{Staff}@tie{}; d'autres propriétés +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 défaut à @code{##t} (vrai) pour toutes les portées. Si vous lui attribuez la valeur @code{##f} (faux) dans un contexte @code{Staff} particulier, elle ne s'appliquera qu'aux altérations de la portée en -question@tie{}; si vous lui attribuez la valeur @qq{faux} au niveau du +question ; si vous lui attribuez la valeur @qq{faux} au niveau du contexte @code{Score}, cela s'appliquera alors à toutes les portées. -Voici comment supprimer les bécarres supplémentaires pour une -portée@tie{}: +Voici comment supprimer les bécarres supplémentaires pour une portée : @lilypond[quote,verbatim,ragged-right] << @@ -1865,24 +1853,24 @@ et pour toutes les portées : Autre exemple, si la propriété @code{clefOctavation} est déterminée au niveau du contexte @code{Score}, elle modifiera la valeur de l'octave en -cours pour toutes les portées actives@tie{}; cette valeur sera considérée +cours pour toutes les portées actives ; cette valeur sera considérée comme étant la nouvelle valeur par défaut pour toutes les portées à venir. -La commande opposée, @code{\unset}, efface la propriété du -contexte@tie{}; la plupart des propriétés reviennent de ce fait à leur -valeur par défaut. En règle générale, la commande @code{\unset} n'est -pas nécessaire dès lors que vous faites appel à une nouvelle commande -@code{\set} pour modifier le réglage. +La commande opposée, @code{\unset}, efface la propriété du contexte ; la +plupart des propriétés reviennent de ce fait à leur valeur par défaut. +En règle générale, la commande @code{\unset} n'est pas nécessaire dès +lors que vous faites appel à une nouvelle commande @code{\set} pour +modifier le réglage. Les commandes @code{\set} et @code{\unset} peuvent intervenir n'importe où dans votre fichier source. Elles seront effectives dès leur apparition et jusqu'à la fin de la partition, à moins d'être affectées par un @code{\unset} ou un nouveau @code{\set}. À titre d'exemple, nous -allons jouer avec la taille des fontes, ce qui affecte entre -autres la 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. +allons jouer avec la taille des fontes, ce qui affecte entre autres la +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 @@ -1902,9 +1890,10 @@ propriété. N'oubliez pas que les nombres, entiers ou réels, doivent être précédés d'un signe dièse (@code{#}) et les valeurs vrai ou faux de deux signes dièse -- respectivement @code{##t} et @code{##f} --. Une valeur textuelle doit être encadrée de guillemets anglais, -@code{"@dots{ }"}, bien que, comme nous le constaterons plus tard, la +@code{"@dots{}"}, bien que, comme nous le constaterons plus tard, la commande @code{\markup} permet aussi de spécifier du texte. + @subsubheading Définition des propriétés de contexte avec @code{\with} @translationof Setting context properties with @code{\with} @@ -1918,10 +1907,10 @@ création de ce contexte. Ceci constitue parfois une façon plus claire de spécifier les valeurs d'une propriété pour la durée de vie du contexte. Lorsque vous créez un contexte à l'aide de la commande @code{\new}, vous pouvez la faire suivre immédiatement d'un bloc -@w{@code{\with @{ .. @}}} qui contiendra les réglages des différentes +@code{\with @{ .. @}} qui contiendra les réglages des différentes propriétés. Ainsi, si nous voulions par exemple annuler l'impression des bécarres supplémentaires sur la durée d'une portée, nous -écririons@tie{}: +écririons : @example \new Staff \with @{ extraNatural = ##f @} @@ -1945,17 +1934,18 @@ ce qui donnerait : @end lilypond Les propriétés réglées de cette manière peuvent néanmoins être modifiées -de façon dynamique grâce à @code{\set}@tie{}; un @code{\unset} les -ramènera à leur valeur initialisée par @code{\with}. +de façon dynamique grâce à @code{\set} ; un @code{\unset} les ramènera à +leur valeur initialisée par @code{\with}. @cindex fontSize, valeur par défaut et réglage -La propriété @code{fontSize} constitue une exception@tie{}: lorsqu'elle +La propriété @code{fontSize} constitue une exception : lorsqu'elle est déterminée au sein d'un bloc @code{\with}, cela redéfinit la valeur par défaut de la taille de fonte. Une modification est possible par la commande @code{\set}, mais la commande @code{\unset fontSize} fera revenir à la nouvelle valeur par défaut. + @subsubheading Définition des propriétés de contexte avec @code{\context} @translationof Setting context properties with @code{\context} @@ -1974,7 +1964,7 @@ avec la commande @code{\with}, puisqu'on se place dans un bloc @code{\context} inclus dans un bloc @code{\layout}. Chaque bloc @code{\context} affectera tous les contextes concernés par le bloc @code{\score} ou @code{\book} au sein duquel apparaît ce bloc -@code{\layout}. Voici comment le mettre en place@tie{}: +@code{\layout}. Voici comment le mettre en place : @lilypond[verbatim,quote] \score { @@ -1993,7 +1983,7 @@ avec la commande @code{\with}, puisqu'on se place dans un bloc @end lilypond Dans le cas où ces ajustements de propriété doivent affecter -toutes les portées de la partition, nous utiliserons alors@tie{}: +toutes les portées de la partition, nous utiliserons alors : @lilypond[quote,verbatim] \score { @@ -2022,7 +2012,6 @@ Les propriétés de contexte ainsi définies peuvent être adaptées pour chacun des contextes en particulier grâce à un bloc @code{\with} ou bien une commande @code{\set} au fil des notes. - @seealso Manuel de notation : @ruser{Modification des réglages par défaut d'un contexte}, @@ -2048,11 +2037,12 @@ Référence des propriétés internes : 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 particulière du fichier de sortie, qui les barres de mesure, qui la -portée, qui les têtes de note, les hampes, etc. Le fait de supprimer un +portée, qui les têtes de note, les hampes, etc. Le fait de supprimer un graveur d'un contexte éliminera sa contribution au fichier de sortie. Bien que ce soit là un moyen radical de modifier le résultat, cette pratique est dans quelques cas fort utile. + @subsubheading Modification d'un seul contexte @translationof Changing a single context @@ -2082,7 +2072,7 @@ lignes d'une portée sont générées par le @code{Staff_symbol_engraver}. @cindex ambitus, graveur Vous pouvez aussi ajouter individuellement un graveur à un contexte. La -commande se formule ainsi@tie{}: +commande se formule ainsi : @code{\consists @var{Nom_du_graveur}} @@ -2092,7 +2082,7 @@ font apparaître un @rglos{ambitus} au début de la portée, afin d'indiquer ses notes extrêmes. L'ambitus est généré par l'@code{Ambitus_engraver}, que l'on peut adjoindre à n'importe quel contexte. Si nous l'ajoutons au contexte @code{Voice}, seule la -tessiture de cette voix sera calculée@tie{}: +tessiture de cette voix sera calculée : @lilypond[quote,verbatim,ragged-right] \new Staff << @@ -2116,7 +2106,7 @@ tessiture de cette voix sera calculée@tie{}: @noindent alors que si nous l'ajoutons au contexte @code{Staff}, l'@code{Ambitus_engraver} calculera l'écart maximal à partir de toutes -les notes de toutes les voix de la portée@tie{}: +les notes de toutes les voix de la portée : @lilypond[quote,verbatim,ragged-right] \new Staff \with { @@ -2138,6 +2128,7 @@ les notes de toutes les voix de la portée@tie{}: >> @end lilypond + @subsubheading Modification de tous les contextes d'un même type @translationof Changing all contexts of the same type @@ -2149,7 +2140,7 @@ graveurs à des contextes individuels. Nous pourrions aussi ajouter ou supprimer des graveurs à tous les contextes d'un même type en insérant les commandes pour le contexte approprié au sein d'un bloc @code{\layout}. Si nous voulions afficher un ambitus pour chacune des -portées d'un système à quatre portées, il nous suffirait d'écrire@tie{}: +portées d'un système à quatre portées, il nous suffirait d'écrire : @lilypond[quote,verbatim,ragged-right] \score { @@ -2207,9 +2198,9 @@ rattachent à des têtes de note les objets qu'ils créent, désactiver le @translationof Extending the templates Bon, vous avez lu le tutoriel, vous savez écrire de la musique. Mais -comment obtenir les portées que vous voulez@tie{}? Les @ref{Modèles}, -c'est bien beau, mais que faire quand ils ne traitent pas ce que l'on -veut précisément@tie{}? +comment obtenir les portées que vous voulez ? Les @ref{Modèles}, c'est +bien beau, mais que faire quand ils ne traitent pas ce que l'on veut +précisément ? Les exemples qui suivent vous donneront des méthodes générales pour adapter des modèles. @@ -2222,6 +2213,7 @@ adapter des modèles. * Conducteurs et parties:: @end menu + @node Soprano et violoncelle @subsection Soprano et violoncelle @translationof Soprano and cello @@ -2230,8 +2222,8 @@ adapter des modèles. Commencez par le modèle qui vous semblera le plus proche de ce à quoi vous voulez aboutir. Disons par exemple que vous voulez écrire une pièce -pour soprano et violoncelle@tie{}: dans ce cas, on pourrait commencer -par les @qq{notes et paroles}, pour la partie de soprano. +pour soprano et violoncelle : dans ce cas, on pourrait commencer par les +@qq{notes et paroles}, pour la partie de soprano. @example \version @w{"@version{}"} @@ -2261,7 +2253,7 @@ texte = \lyricmode @{ @end example Maintenant, on veut ajouter une partie de violoncelle. -Jetons un coup d'œil sur l'exemple avec les notes seules@tie{}: +Jetons un coup d'œil sur l'exemple avec les notes seules : @example \version @w{"@version{}"} @@ -2283,19 +2275,19 @@ melodie = \relative c' @{ On n'a pas besoin de deux commandes @code{\version}. Ce dont on a besoin, c'est de la section @code{melodie}. De même, on n'a pas besoin de deux sections @code{\score} -- si nous les gardions toutes les deux, -on obtiendrait deux parties séparées@tie{}; mais nous voulons un vrai -duo, avec les deux parties ensemble. Dans la section @code{\score}, on -n'a pas besoin non plus de deux @code{\layout} ni de deux @code{\midi}. +on obtiendrait deux parties séparées ; mais nous voulons un vrai duo, +avec les deux parties ensemble. Dans la section @code{\score}, on n'a +pas besoin non plus de deux @code{\layout} ni de deux @code{\midi}. Si on se contente de couper et coller les sections @code{melodie}, on se -retrouvera avec deux sections de ce nom@tie{}; il nous faut donc les +retrouvera avec deux sections de ce nom ; il nous faut donc les renommer. Appelons la section pour la soprano @code{sopranoMusique} et 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@tie{}: -c'est-à-dire la définition de départ, où l'on trouve @w{@code{melodie = -\relative c' @{ }}, et l'endroit où cette dénomination est utilisée, -dans la section @code{\score}. +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 +est utilisée, dans la section @code{\score}. Et puis, toujours tant qu'on y est, mettons le violoncelle en clé de fa, comme le veut l'usage, et donnons-lui d'autres notes. @@ -2337,7 +2329,7 @@ violoncelleMusique = \relative c @{ Voilà qui est mieux, mais la partie de violoncelle n'apparaît pas sur la partition -- en effet, nous n'y avons pas fait appel dans la section @code{\score}. Si l'on veut que la partie de violoncelle s'imprime sous -la partie de soprano, on va devoir ajouter@tie{}: +la partie de soprano, on va devoir ajouter : @example \new Staff \musiqueVioloncelle @@ -2368,9 +2360,9 @@ se déroulent en même temps. Le bloc @code{\score} ressemble maintenant à @end example @noindent -C'est un peu le bazar dans tout ça@tie{}; mais il vous sera facile de +C'est un peu le bazar dans tout ça ; mais il vous sera facile de mettre un peu d'ordre dans l'indentation. Voici le modèle pour -soprano et violoncelle au complet@tie{}: +soprano et violoncelle au complet : @lilypond[quote,verbatim,ragged-right,addversion] sopranoMusic = \relative c' { @@ -2407,7 +2399,6 @@ celloMusic = \relative c { } @end lilypond - @seealso Les patrons originaux sont disponibles à l'annexe @qq{Modèles}, voir @ref{Portée unique}. @@ -2425,7 +2416,7 @@ orchestre, comme Elias de Mendelssohn ou le Messie de Haendel, disposent la musique et les paroles du chœur sur quatre portées -- soprano, alto, ténor et basse -- surmontant une réduction pour piano de l'accompagnement orchestral. En voici un exemple, tiré du Messie de -Haendel@tie{}: +Haendel : @c The following should appear as music without code @lilypond[quote,ragged-right] @@ -2525,24 +2516,24 @@ lower = \relative c, { Aucun des modèles ne permet d'arriver exactement à cette mise en forme. Celui qui s'en rapprocherait le plus est @qq{SATB vocal score and automatic piano reduction} -- voir @ref{Ensemble vocal} -- mais encore -faudrait-il en modifier la mise en forme et refaire la partie de -piano qui n'est plus une simple reprise des parties vocales. Les -variables qui gèrent la musique et les paroles du chœur ne nécessitent -pas de modification, mais il nous faut d'autres variables pour la -réduction de piano. +faudrait-il en modifier la mise en forme et refaire la partie de piano +qui n'est plus une simple reprise des parties vocales. Les variables +qui gèrent la musique et les paroles du chœur ne nécessitent pas de +modification, mais il nous faut d'autres variables pour la réduction de +piano. L'ordre dans lequel apparaissent les contextes dans le @code{ChoirStaff} du modèle ne correspond pas à ce que nous voyons ci-dessus. Il nous faudra y revenir pour obtenir quatre portées avec des paroles en dessous de chacune d'elles. Toutes les voix devraient être @code{\voiceOne}, -ce qui est la position par défaut@tie{}; il nous faudra donc éliminer -toutes les commandes @code{\voiceXXX}. Les ténors auront besoin d'une -clé spécifique. Enfin, nous n'avons pas encore abordé la façon dont les -paroles sont présentées dans le modèle@tie{}; nous procéderons donc -comme nous en avons l'habitude. Il faudra aussi ajouter un nom à chaque +ce qui est la position par défaut ; il nous faudra donc éliminer toutes +les commandes @code{\voiceXXX}. Les ténors auront besoin d'une clé +spécifique. Enfin, nous n'avons pas encore abordé la façon dont les +paroles sont présentées dans le modèle ; nous procéderons donc comme +nous en avons l'habitude. Il faudra aussi ajouter un nom à chaque portée. -Une fois tout ceci accompli, voici notre @code{ChoirStaff}@tie{}: +Une fois tout ceci accompli, voici notre @code{ChoirStaff} : @example \new ChoirStaff << @@ -2590,8 +2581,8 @@ Une fois tout ceci accompli, voici notre @code{ChoirStaff}@tie{}: @end example Il nous faut maintenant nous occuper de la partie de piano. Nous allons -nous contenter de récupérer la partie de piano du modèle -@qq{Solo piano}@tie{}: +nous contenter de récupérer la partie de piano du modèle @qq{Solo +piano} : @example \new PianoStaff << @@ -2605,7 +2596,7 @@ puis d'ajouter les définitions de variable pour @code{superieur} et @code{inferieur}. 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@tie{}: +doubles chevrons gauche/droite puisqu'ils doivent s'empiler : @example << % combine ChoirStaff et PianoStaff l'un au-dessus de l'autre @@ -2659,7 +2650,7 @@ doubles chevrons gauche/droite puisqu'ils doivent s'empiler@tie{}: @end example Une fois tout cela mis en place, et après avoir ajouté les notes et les -paroles de ces trois mesures du Messie, nous obtenons@tie{}: +paroles de ces trois mesures du Messie, nous obtenons : @lilypond[quote,verbatim,ragged-right,addversion] global = { \key d \major \time 4/4 } @@ -2770,11 +2761,11 @@ propres patrons selon le type de musique que vous affectionnez plus particulièrement. Pour voir comment procéder, nous allons monter la partition d'un prélude pour orgue. -Nous débutons par une section d'en-tête@tie{}; nous y mettrons entre +Nous débutons par une section d'en-tête ; nous y mettrons entre autres le titre et le nom du compositeur. Puis viennent toutes les définitions de toutes les variables. Nous terminons par le bloc @code{\score}. Attelons-nous pour cette aventure, en gardant bien à -l'esprit ce que nous venons de dire@tie{}; nous nous occuperons des +l'esprit ce que nous venons de dire ; nous nous occuperons des détails en temps voulu. Nous nous appuyons sur les deux premières mesures du prélude sur @@ -2782,7 +2773,7 @@ Nous nous appuyons sur les deux premières mesures du prélude sur voir ces deux mesures au bas de cette page. La main droite comporte deux voix, la main gauche et le pédalier une seule. Il nous faut donc quatre définitions de musique, plus une qui contiendra la métrique et -l'armure@tie{}: +l'armure : @example \version @w{"@version{}"} @@ -2832,7 +2823,7 @@ Il nous faut ajouter à cela une portée pour le pédalier. Elle se place sous le système de piano, mais puisqu'elle doit rester synchrone avec lui, nous utilisons des doubles chevrons pour les regrouper. Négliger ceci nous renverrait une erreur, et personne n'est à l'abri de -cette faute@tie{}! Pour preuve, il vous suffit de copier l'exemple +cette faute ! Pour preuve, il vous suffit de copier l'exemple complet en fin de chapitre, de supprimer ces @code{<<} et @code{>>}, et de le compiler, pour voir de quoi il retourne. @@ -2863,16 +2854,16 @@ de le compiler, pour voir de quoi il retourne. La construction en simultané -- @code{<<...>>} -- n'est pas strictement obligatoire pour les portées manuel deux et pédalier, qui ne contiennent -chacune qu'une seule expression musicale@tie{}; mais cela ne mange pas -de pain, et c'est une bonne habitude que de toujours encadrer par des -doubles chevrons gauche/droite ce qui suit une commande @code{\new -Staff} au cas où il y aurait plusieurs voix. Il en va autrement pour -les contextes @code{Voice}@tie{}: ils doivent être toujours suivis -d'accolades -- @code{@{...@}} -- au cas où vous auriez employé +chacune qu'une seule expression musicale ; mais cela ne mange pas de +pain, et c'est une bonne habitude que de toujours encadrer par des +doubles chevrons gauche/droite ce qui suit une commande +@code{\new Staff} au cas où il y aurait plusieurs voix. Il en va +autrement pour les contextes @code{Voice} : ils doivent être toujours +suivis d'accolades -- @code{@{...@}} -- au cas où vous auriez employé plusieurs variables qui doivent intervenir consécutivement. Ajoutons donc cette structure au bloc @code{\score}, tout en fignolant -l'indentation. Nous en profitons pour ajouter les clés appropriées, +l'indentation. Nous en profitons pour ajouter les clefs appropriées, effectuer les réglages concernant les hampes et liaisons de la portée supérieure grâce à @code{\voiceOne} et @code{\voiceTwo}, et mettre en place la métrique et l'armure de chaque portée grâce à notre variable @@ -2917,12 +2908,12 @@ place la métrique et l'armure de chaque portée grâce à notre variable @cindex portées, espacement Cette partition pour orgue est presque parfaite. Reste juste ce petit -défaut qui ne se remarque pas lorsque l'on considère un seul -système@tie{}: la distance qui sépare la portée de pédalier de celle de -la main gauche devrait être plus ou moins égale à celle qui sépare les -deux mains. En fait, la distance entre les deux portées d'un -@code{PianoStaff} ne saurait trop se dilater@tie{}; le pédalier devrait -adopter le même comportement. +défaut qui ne se remarque pas lorsque l'on considère un seul système : +la distance qui sépare la portée de pédalier de celle de la main gauche +devrait être plus ou moins égale à celle qui sépare les deux mains. En +fait, la distance entre les deux portées d'un @code{PianoStaff} ne +saurait trop se dilater ; le pédalier devrait adopter le même +comportement. @cindex sous-propriétés @cindex propriétés et sous-propriétés @@ -2934,10 +2925,10 @@ La propension des portées à se dilater se contrôle à l'aide de la propriété @code{staff-staff-spacing}, attachée à @qq{l'objet graphique} @code{VerticalAxisGroup} -- la documentation de LilyPond utilise souvent l'abréviation @emph{grob} pour @emph{graphical object}. Pas de -panique@tie{}! Tout ceci sera expliqué plus tard -- pour les curieux, +panique ! Tout ceci sera expliqué plus tard -- pour les curieux, jetez un œil au chapitre @ruser{Vue d'ensemble de la modification des propriétés}. -Revenons à notre propos@tie{}: nous voulons modifier uniquement la +Revenons à notre propos : nous voulons modifier uniquement la 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 @@ -3061,7 +3052,7 @@ Glossaire musicologique : @cindex variables @cindex identificateurs -Jusqu'à maintenant, vous avez vu ce type de code@tie{}: +Jusqu'à maintenant, vous avez vu ce type de code : @lilypond[quote,verbatim,ragged-right] hornNotes = \relative c'' { c4 b dis c } @@ -3073,7 +3064,7 @@ hornNotes = \relative c'' { c4 b dis c } @end lilypond Vous comprendrez combien cela peut être utile pour écrire de la -musique minimaliste@tie{}: +musique minimaliste : @lilypond[quote,verbatim,ragged-right] fragmentA = \relative c'' { a4 a8. b16 } @@ -3088,9 +3079,9 @@ violin = \new Staff { \fragmentA \fragmentA \fragmentB \fragmentA } } @end lilypond -Néanmoins vous pouvez aussi utiliser ces identificateurs --- aussi connus sous le nom de variables, macros, ou commandes -(définies par l'utilisateur) -- pour des retouches@tie{}: +Néanmoins vous pouvez aussi utiliser ces identificateurs -- aussi connus +sous le nom de variables, macros, ou commandes (définies par +l'utilisateur) -- pour des retouches : @c TODO Avoid padtext - not needed with skylining @lilypond[quote,verbatim,ragged-right] @@ -3120,7 +3111,7 @@ violin = \relative c'' { Ces identificateurs sont évidemment utiles pour économiser de la frappe. Mais ils peuvent l'être même si vous ne les utilisez qu'une -seule fois@tie{}: ils réduisent la complexité. Regardons l'exemple +seule fois : ils réduisent la complexité. Regardons l'exemple précédent sans aucun identificateur. C'est beaucoup plus laborieux à lire, et particulièrement la dernière ligne. @@ -3141,10 +3132,9 @@ violin = \relative c'' @{ @c TODO Replace the following with a better example -td @c Skylining handles this correctly without padText -Jusqu'ici nous avons vu des substitutions statiques@tie{}: quand -LilyPond rencontre @code{\padText}, il le remplace par le contenu que -nous lui avons défini -- c'est-à-dire le contenu à droite de -@code{padText=}. +Jusqu'ici nous avons vu des substitutions statiques : quand LilyPond +rencontre @code{\padText}, il le remplace par le contenu que nous lui +avons défini -- c'est-à-dire le contenu à droite de @code{padText=}. LilyPond gère également des substitutions non-statiques -- vous pouvez les voir comme des fonctions. @@ -3199,8 +3189,7 @@ notesCor = \relative c @{ @end example @noindent -On établira alors une partie séparée en constituant un nouveau -fichier@tie{}: +On établira alors une partie séparée en constituant un nouveau fichier : @example \include "musique-Cor.ly" @@ -3223,10 +3212,10 @@ fichier@tie{}: @noindent sera substitué le contenu du fichier @file{musique-Cor.ly}, et de ce fait la variable @code{notesCor} se trouvera définie. La commande -@code{\transpose@tie{}f@tie{}c'} indique que son argument -@code{\notesCor} sera transposé à la quinte supérieure@tie{}: le son -réel @code{f} s'écrit @code{c'}, ce qui est la caractéristique d'un Cor -en fa. La transposition est visible comme suit@tie{}: +@code{\transpose f c'} indique que son argument @code{\notesCor} sera +transposé à la quinte supérieure : le son réel @code{f} s'écrit +@code{c'}, ce qui est la caractéristique d'un Cor en fa. La +transposition est visible comme suit : @lilypond[quote,ragged-right] \transpose f c' \relative c { @@ -3238,18 +3227,16 @@ en fa. La transposition est visible comme suit@tie{}: Dans les pièces d'ensemble, il arrive souvent qu'une voix ne joue pas pendant plusieurs mesures. Un silence spécial, appelé silence multimesures, l'indique alors. On l'obtient par un @code{R} majuscule, -suivi d'une durée@tie{}: @code{1}@tie{}pour une pause, -@code{2}@tie{}pour une demi-pause, etc. Cette durée peut être -multipliée pour établir de plus longs silences. Par exemple, le silence -suivant dure 3@tie{}mesures à 2/4. +suivi d'une durée : @code{1} pour une pause, @code{2} pour une +demi-pause, etc. Cette durée peut être multipliée pour établir de plus +longs silences. Par exemple, le silence suivant dure 3 mesures à 2/4. @example R2*3 @end example Dans une partie séparée, les silences multimesure sont compressés. -Il faut pour cela définir la propriété @code{skipBars} à -@qq{vrai}@tie{}: +Il faut pour cela définir la propriété @code{skipBars} à @qq{vrai} : @example \set Score.skipBars = ##t @@ -3257,9 +3244,9 @@ Il faut pour cela définir la propriété @code{skipBars} à @noindent Cette commande assigne la valeur @qq{vrai} -- @emph{true} en anglais, et -@code{#t} dans le langage Scheme -- à cette propriété dans le -contexte @code{Score}. Si l'on ajoute dans la musique ci-dessus le -silence multimesure et cette option, on obtient le résultat suivant@tie{}: +@code{#t} dans le langage Scheme -- à cette propriété dans le contexte +@code{Score}. Si l'on ajoute dans la musique ci-dessus le silence +multimesure et cette option, on obtient le résultat suivant : @lilypond[quote,ragged-right] \transpose f c' \relative c { diff --git a/Documentation/fr/learning/preface.itely b/Documentation/fr/learning/preface.itely index 7b216dbea0..21ff271c77 100644 --- a/Documentation/fr/learning/preface.itely +++ b/Documentation/fr/learning/preface.itely @@ -1,7 +1,7 @@ @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*- @c This file is part of lilypond.tely @ignore - Translation of GIT committish: 5f722f1688eff7436789f8ca011205bdb16c04b7 + Translation of GIT committish: 8df40d45e4366f4e9baa2cec3b7eb38b6482150f When revising a translation, copy the HEAD committish of the version that you are working on. For details, see the Contributors' @@ -48,10 +48,10 @@ il fait maintenant partie de notre vie, et nous nous accrochons. Notre principale motivation vient sans doute de l'utilité réelle de notre logiciel. En flânant sur Internet, nous trouvons beaucoup de gens qui utilisent LilyPond pour réaliser d'impressionnantes -partitions@tie{}: c'est incroyable, mais en même temps très flatteur. +partitions : c'est incroyable, mais en même temps très flatteur. Les utilisateurs ne se contentent pas de nous encourager en utilisant -notre logiciel@tie{}; nombre d'entre eux nous aident aussi en faisant des +notre logiciel ; nombre d'entre eux nous aident aussi en faisant des suggestions et en signalant des bogues. Aussi, nous voudrions remercier ici tous les utilisateurs qui nous ont signalé des bugs, ont fait des suggestions ou ont contribué d'une façon ou d'une autre au @@ -62,7 +62,7 @@ séduisante. Même si l'on s'amuse beaucoup en programmant tous ensemble, et qu'on éprouve une satisfaction profonde à aider les gens, au bout du compte, notre travail sur LilyPond est avant tout une manière d'exprimer notre amour sincère de la musique. Puisse-t-il -vous aider à créer de nombreuses et belles œuvres@tie{}! +vous aider à créer de nombreuses et belles œuvres ! Han-Wen et Jan diff --git a/Documentation/fr/learning/templates.itely b/Documentation/fr/learning/templates.itely index 7c9bcf7775..bd1dbb9d0e 100644 --- a/Documentation/fr/learning/templates.itely +++ b/Documentation/fr/learning/templates.itely @@ -1,7 +1,7 @@ @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*- @ignore - Translation of GIT committish: 0f93dd92ffa0319328e58148458d22c5448b3d58 + Translation of GIT committish: 8df40d45e4366f4e9baa2cec3b7eb38b6482150f When revising a translation, copy the HEAD committish of the version that you are working on. For details, see the Contributors' @@ -20,7 +20,6 @@ Cette annexe du manuel d'initiation propose des patrons de partition Lilypond, prets à l'emploi. Il vous suffira d'y ajouter quelques notes, de lancer LilyPond, et d'aprécier le résultat. - @menu * Portée unique:: * Modèles pour piano:: @@ -31,6 +30,7 @@ de lancer LilyPond, et d'aprécier le résultat. * Autres modèles:: @end menu + @node Portée unique @appendixsec Portée unique @translationof Single staff @@ -40,16 +40,19 @@ de lancer LilyPond, et d'aprécier le résultat. @lilypondfile[verbatim,quote,ragged-right,texidoc,addversion] {single-staff-template-with-only-notes.ly} + @appendixsubsec Notes et paroles @lilypondfile[verbatim,quote,ragged-right,texidoc,addversion] {single-staff-template-with-notes-and-lyrics.ly} + @appendixsubsec Notes et accords @lilypondfile[verbatim,quote,ragged-right,texidoc] {single-staff-template-with-notes-and-chords.ly} + @appendixsubsec Notes, paroles et accords @lilypondfile[verbatim,quote,ragged-right,texidoc] @@ -65,11 +68,13 @@ de lancer LilyPond, et d'aprécier le résultat. @lilypondfile[verbatim,quote,ragged-right,texidoc] {piano-template-simple.ly} + @appendixsubsec Chant et accompagnement @lilypondfile[verbatim,quote,ragged-right,texidoc] {piano-template-with-melody-and-lyrics.ly} + @appendixsubsec Piano et paroles entre les portées @lilypondfile[verbatim,quote,ragged-right,texidoc] @@ -85,6 +90,7 @@ de lancer LilyPond, et d'aprécier le résultat. @lilypondfile[verbatim,quote,ragged-right,texidoc] {string-quartet-template-simple.ly} + @appendixsubsec Parties pour quatuor à cordes @lilypondfile[verbatim,quote,ragged-right,texidoc] @@ -100,31 +106,37 @@ de lancer LilyPond, et d'aprécier le résultat. @lilypondfile[verbatim,quote,ragged-right,texidoc] {vocal-ensemble-template.ly} + @appendixsubsec Partition pour chœur SATB avec réduction pour piano @lilypondfile[verbatim,quote,ragged-right,texidoc] {vocal-ensemble-template-with-automatic-piano-reduction.ly} + @appendixsubsec Partition pour chœur SATB avec alignement des contextes @lilypondfile[verbatim,quote,ragged-right,texidoc] {vocal-ensemble-template-with-lyrics-aligned-below-and-above-the-staves.ly} + @appendixsubsec Chœur à quatre voix mixtes sur quatre portées @lilypondfile[verbatim,quote,ragged-right,texidoc] {satb-choir-template---four-staves.ly} + @appendixsubsec Couplet pour solo et refrain à deux voix @lilypondfile[verbatim,quote,ragged-right,texidoc] {vocal-ensemble-template-with-verse-and-refrain.ly} + @appendixsubsec Hymnes et cantiques @lilypondfile[verbatim,quote,ragged-right,texidoc] {hymn-template.ly} + @appendixsubsec Psalmodie @lilypondfile[verbatim,quote,ragged-right,texidoc] @@ -152,6 +164,7 @@ de lancer LilyPond, et d'aprécier le résultat. @lilypondfile[verbatim,quote,ragged-right,texidoc,line-width=140] {ancient-notation-template----modern-transcription-of-mensural-music.ly} + @appendixsubsec Transcription du grégorien @lilypondfile[verbatim,quote,ragged-right,texidoc] diff --git a/Documentation/fr/learning/tutorial.itely b/Documentation/fr/learning/tutorial.itely index b401e9c3fd..1015ea06ee 100644 --- a/Documentation/fr/learning/tutorial.itely +++ b/Documentation/fr/learning/tutorial.itely @@ -1,7 +1,7 @@ @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*- @ignore - Translation of GIT committish: 5f722f1688eff7436789f8ca011205bdb16c04b7 + Translation of GIT committish: 8df40d45e4366f4e9baa2cec3b7eb38b6482150f When revising a translation, copy the HEAD committish of the version that you are working on. For details, see the Contributors' @@ -47,6 +47,7 @@ chose d'imprimable. * Ligne de commande:: @end menu + @node Saisie de la musique @subsection Saisie de la musique @translationof Entering input @@ -82,25 +83,24 @@ l'image ci-dessous. @end lilypond @c DIV specific -Il est aussi possible d'utiliser les noms de notes français @qq{@w{do -re mi fa sol la si}}, en insérant au début du fichier la ligne -@w{@code{\include@tie{}"italiano.ly"}}. +Il est aussi possible d'utiliser les noms de notes français @qq{do +re mi fa sol la si}, en insérant au début du fichier la ligne +@code{\include "italiano.ly"}. @c END DIV @warning{Tout extrait de code LilyPond doit être entouré d'une @w{@strong{@{ paire d'accolades @}}}. De plus, pour éviter toute ambiguïté, il est préférable d'entourer les accolades par des espaces ou retours à la ligne. Bien que certains exemples de ce manuel ne -comportent pas d'accolades, ne les oubliez pas dans vos partitions@tie{}! +comportent pas d'accolades, ne les oubliez pas dans vos partitions ! Pour plus d'informations sur l'affichage des exemples de cette documentation, consultez @ref{Bien lire le manuel}.} - @cindex casse, prise en compte de la @cindex prise en compte de la casse @cindex sensibilité à la casse -De plus, LilyPond est @strong{sensible à la casse}@tie{}: le code +De plus, LilyPond est @strong{sensible à la casse} : le code @w{@samp{@{ c d e @}}} est valide, alors que @w{@samp{@{ C D E @}}} produira un message d'erreur. @@ -138,7 +138,7 @@ comment voir ou imprimer le résultat produit par LilyPond. @end itemize Notez qu'il existe plusieurs éditeurs de texte disponibles avec un bon -support de LilyPond@tie{}; consultez @rweb{Facilités d'édition}. +support de LilyPond ; consultez @rweb{Facilités d'édition}. @warning{Le premier démarrage de LilyPond peut prendre une minute ou deux, afin de générer la liste des polices du système. LilyPond démarre @@ -206,7 +206,7 @@ et du rythme. @noindent Ces valeurs automatiques simplifient la saisie du code source dans -bien des cas ; nous verrons plus loin comment les indiquer +bien des cas ; nous verrons plus loin comment les indiquer explicitement. @@ -254,7 +254,7 @@ en d'autres termes, le premier @code{c} est le do central, entre la clef de sol et la clef de fa, puis est suivi par le @notation{ré} le plus proche, et ainsi de suite. On peut bien sûr créer des mélodies avec de plus grands intervalles, toujours avec le mode -@code{\relative}@tie{}: +@code{\relative} : @lilypond[verbatim,quote] \relative c' { @@ -265,13 +265,13 @@ avec de plus grands intervalles, toujours avec le mode @noindent Remarquez que cet exemple ne commence plus sur le @notation{do -central}@tie{}: la première note -- le @code{d} -- est le ré qui en est +central} : la première note -- le @code{d} -- est le ré qui en est le plus proche. Dans l'exemple suivant, on remplace @code{c'} dans la commande @w{@code{@bs{}relative c'}} par @code{c''}, afin de calculer l'octave de la première note par rapport au do situé une octave au-dessus du do -central@tie{}: +central : @lilypond[verbatim,quote] % one octave above middle C @@ -317,10 +317,10 @@ hauteur d'une octave -- au nom de la note. @end lilypond @noindent -Pour déplacer une note deux octaves (ou davantage@tie{}!) plus haut ou plus +Pour déplacer une note deux octaves (ou davantage !) plus haut ou plus bas, il suffit de mettre deux (ou davantage) @code{'} ou @code{,} -- attention cependant à bien mettre deux apostrophes @code{''}, et non -un guillemet @code{"}@tie{}! C'est de cette même manière que l'on +un guillemet @code{"} ! C'est de cette même manière que l'on peut modifier la valeur de départ de @w{@code{\relative c'}}. @c " - keeps quotes in order for context-sensitive editor -td @@ -345,7 +345,7 @@ Glossaire musicologique : @rglosnamed{dotted note,note pointée}. La @notation{durée} d'une note est indiquée par un nombre qui suit sa -hauteur@tie{}: @code{1} pour une @notation{ronde}, @code{2} pour une +hauteur : @code{1} pour une @notation{ronde}, @code{2} pour une @notation{blanche}, @code{4} pour une @notation{noire} et ainsi de suite. Les @notation{crochets} et @notation{liens} sont ajoutés automatiquement. @@ -404,7 +404,7 @@ lettre @code{r} (pour @emph{rest}). Glossaire musicologique : @rglosnamed{time signature,métrique}. La @notation{métrique}, aussi appelée @notation{chiffre de mesure}, -peut être définie à l'aide de la commande @code{\time}@tie{}: +peut être définie à l'aide de la commande @code{\time} : @lilypond[verbatim,quote] \relative c'' { @@ -433,7 +433,7 @@ Glossaire musicologique : @rglosnamed{metronome,métronome}. La commande @code{\tempo} permet de stipuler aussi bien le @emph{tempo} -que le métronome@tie{}: +que le métronome : @lilypond[verbatim,quote] \relative c'' { @@ -464,7 +464,7 @@ que le métronome@tie{}: Glossaire musicologique : @rglos{clef}. La @notation{clef} peut être définie à l'aide de la commande -@code{\clef}@tie{}: +@code{\clef} : @lilypond[verbatim,quote] \relative c' { @@ -483,7 +483,7 @@ La @notation{clef} peut être définie à l'aide de la commande @subheading Tout ensemble Voici un bref exemple qui rassemble tous les éléments que nous déjà -vus@tie{}: +vus : @lilypond[verbatim,quote] \relative c, { @@ -496,11 +496,13 @@ vus@tie{}: } @end lilypond - @seealso -Manuel de notation : @ruser{Écriture des hauteurs de note}, -@ruser{Écriture du rythme}, @ruser{Écriture des silences}, -@ruser{Gravure du rythme}, @ruser{Gravure des hauteurs}. +Manuel de notation : +@ruser{Écriture des hauteurs de note}, +@ruser{Écriture du rythme}, +@ruser{Écriture des silences}, +@ruser{Gravure du rythme}, +@ruser{Gravure des hauteurs}. @node Travail sur les fichiers d'entrée @@ -530,12 +532,11 @@ Le traitement des fichiers source de LilyPond est semblable à celui du code de nombreux langages de programmation. La casse est prise en compte, et les caractères considérés comme espaces ont généralement peu d'importance. Les expressions sont délimitées par des accolades -@w{@code{@{ @}}}, et les commentaires par @code{%} ou -@w{@code{%@{ @dots{} @}}}@tie{}. - -Si cette phrase vous paraît incompréhensible, ne vous en faites pas@tie{}! -Expliquons tous ces termes@tie{}: +@code{@{ @}}, et les commentaires par @code{%} ou +@w{@code{%@{ @dots{} @}}} . +Si cette phrase vous paraît incompréhensible, ne vous en faites pas ! +Expliquons tous ces termes : @itemize @@ -543,7 +544,7 @@ Expliquons tous ces termes@tie{}: @strong{La version} : Tout fichier LilyPond devrait porter mention de la version. Cette mention prend la forme d'une ligne décrivant le numéro de la version -utilisée lors de la confection du fichier en question, comme ici@tie{}: +utilisée lors de la confection du fichier en question, comme ici : @example \version "@w{@version{}}" @@ -553,7 +554,7 @@ Il est d'usage de porter cette mention au tout début du fichier LilyPond. Mentionner la version est important pour, au moins, les deux raisons -suivantes@tie{}: cela permet dans un premier temps de faciliter les +suivantes : cela permet dans un premier temps de faciliter les opérations de mise à jour automatisée au fil de l'évolution de la syntaxe de LilyPond. Ensuite, cela met en évidence le minimum requis pour pouvoir compiler votre fichier. @@ -565,7 +566,7 @@ la compilation. @strong{La casse} : LilyPond est sensible à la casse, c'est à dire qu'une lettre capitale n'a pas la même valeur qu'une lettre minuscule. Les notes, par -exemple, doivent être entrées en minuscule : @w{@code{@{ c d e @}}} est +exemple, doivent être entrées en minuscule : @w{@code{@{ c d e @}}} est un code valide, alors que @w{@code{@{ C D E @}}} produira un message d'erreur. @@ -573,7 +574,7 @@ d'erreur. @strong{Les espaces multiples} : LilyPond ne tient pas compte du nombre d'espaces, de tabulations ou de retours à la ligne. @w{@code{@{ c d e @}}} a le même sens que -@w{@code{@{ c @tie{} @tie{} d @tie{} e @}}} ou que +@w{@code{@{ c     d   e @}}} ou que @example @{ c4 d @@ -582,7 +583,7 @@ retours à la ligne. @w{@code{@{ c d e @}}} a le même sens que @noindent Bien sûr, ce dernier exemple est illisible. Une bonne habitude -à prendre est d'indenter les blocs de code avec des doubles espaces@tie{}: +à prendre est d'indenter les blocs de code avec des doubles espaces : @example @{ @@ -594,14 +595,14 @@ L'espace est néanmoins @strong{nécessaire} pour séparer nombre d'éléments syntaxiques les uns des autres. En d'autres termes, s'il est toujours possible d'@emph{ajouter} des espaces, il faut prendre garde à ne pas trop en @emph{supprimer}. En effet, l'absence d'une espace peut -avoir des conséquences et entraîner une erreur@tie{}; aussi nous vous +avoir des conséquences et entraîner une erreur ; aussi nous vous invitons à toujours insérer une espace avant et après chaque élément syntaxique, comme avant et après une accolade. @item @strong{Expressions musicales} : Tout morceau saisi dans LilyPond doit être placé entre -@strong{@{@tie{}accolades@tie{}@}}. Ces caractères indiquent à LilyPond +@strong{@{ accolades @}}. Ces caractères indiquent à LilyPond que ce bloc de texte représente une et une seule expression musicale, tout comme les parenthèses @code{()} en mathématiques. Pour éviter toute ambiguïté, il est préférable d'entourer ces accolades d'espaces ou @@ -613,10 +614,10 @@ exemple -- compte également comme une seule expression musicale. @item @strong{Les commentaires} : Un commentaire est une indication pour tout lecteur humain d'un -fichier source de musique@tie{}; il est ignoré lors de la compilation et +fichier source de musique ; il est ignoré lors de la compilation et n'a donc aucun effet sur la partition imprimée. On distingue deux types de commentaires. Le commentaire de fin de ligne, introduit par le -symbole @code{%}@tie{}: tout ce qui suit ce symbole sur la même ligne sera +symbole @code{%} : tout ce qui suit ce symbole sur la même ligne sera ignoré. Par convention, un commentaire qui occupe une ligne entière se place juste @emph{au-dessus} de la ligne à laquelle il fait référence. @@ -628,13 +629,13 @@ b2 b @end example Le bloc de commentaire, qui peut occuper plusieurs lignes, voire toute -une section@tie{}: tout ce qui se trouve entre @code{%@{} et @code{%@}} est +une section : tout ce qui se trouve entre @code{%@{} et @code{%@}} est ignoré. Les blocs de commentaires ne peuvent s'imbriquer, ce qui signifie que vous ne pouvez pas placer un commentaire-bloc à l'intérieur d'un autre commentaire-bloc. Si jamais vous essayez, vous verrez que la première occurence de @code{%@}} terminera @qq{les @emph{deux} commentaires-blocs}. Le fragment suivant met en évidence -quelques usages possibles des commentaires@tie{}: +quelques usages possibles des commentaires : @example % voici les notes de "ah vous dirai-je maman" @@ -661,12 +662,12 @@ quelques usages possibles des commentaires@tie{}: Parfois, LilyPond ne produit pas le résultat escompté. Voici quelques pistes à suivre pour vous aider à éviter de telles déconvenues. - @menu * Quand ça ne fonctionne pas:: * Erreurs courantes:: @end menu + @node Quand ça ne fonctionne pas @subsection Quand ça ne fonctionne pas @translationof General troubleshooting tips @@ -711,7 +712,6 @@ particularités de la domcumentation en ligne. @subsection Matériel incomplet @translationof Omitted material - @cindex bien lire le manuel @cindex manuel, lecture @cindex compulser le manuel @@ -723,13 +723,13 @@ particularités de la domcumentation en ligne. @cindex fichiers, conseils de construction Comme nous l'avons vu dans @ref{Travail sur les fichiers d'entrée}, un -code LilyPond doit être encadré par des accolades @{@tie{}@} ou bien par +code LilyPond doit être encadré par des accolades @{ @} ou bien par @w{@code{\relative c'' @{ @dots{} @}}}. Cependant, dans la suite de ce manuel, la plupart des exemples ne feront pas apparaître ces signes. Pour reproduire les exemples, vous pouvez copier et coller le code affiché, mais @strong{à condition} d'ajouter -@code{@w{\relative c'' @{ @}}} de la façon suivante@tie{}: +@code{@w{\relative c'' @{ @}}} de la façon suivante : @example \relative c'' @{ @@ -737,7 +737,7 @@ affiché, mais @strong{à condition} d'ajouter @} @end example -Pourquoi avoir omis les accolades@tie{}? La plupart des exemples de ce +Pourquoi avoir omis les accolades ? La plupart des exemples de ce manuel peuvent être insérés au milieu d'un morceau de musique plus long. Il n'y a donc aucune raison d'ajouter @code{@w{\relative c'' @{ @}}} à ces exemples -- en effet, il n'est pas possible d'insérer une @@ -755,7 +755,7 @@ Beaucoup de gens apprennent à utiliser les programmes en les essayant et en bidouillant avec. C'est également possible avec LilyPond. Si vous cliquez sur une image dans la version HTML de ce manuel, vous verrez exactement le code LilyPond utilisé pour générer cette image. -Essayez sur cette image@tie{}: +Essayez sur cette image : @c no verbatim here @c KEEP LY @@ -778,6 +778,7 @@ d'imprimer ou de garder un lien vers @ruser{Aide-mémoire}, tableau qui répertorie les commandes usuelles pour une consultation rapide. @end ignore + @node Vue d'ensemble des manuels @subsection Vue d'ensemble des manuels @translationof Overview of manuals diff --git a/Documentation/fr/learning/tweaks.itely b/Documentation/fr/learning/tweaks.itely index 016b5c431a..f7d7d1bf52 100644 --- a/Documentation/fr/learning/tweaks.itely +++ b/Documentation/fr/learning/tweaks.itely @@ -1,6 +1,7 @@ @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*- + @ignore - Translation of GIT committish: 2a87f1e1f98b76751482cae4474d41aa5e38e37b + Translation of GIT committish: 8df40d45e4366f4e9baa2cec3b7eb38b6482150f When revising a translation, copy the HEAD committish of the version that you are working on. For details, see the Contributors' @@ -58,10 +59,10 @@ de musique imprimée. Dans ce chapitre, nous traitons des concepts de base nécessaires pour comprendre l'art de la retouche. Puis nous présentons de nombreuses commandes déjà prêtes, qu'il suffit de recopier pour -obtenir un résultat identique dans vos partitions ; nous en -profitons pour expliquer comment ces commandes ont été construites, si -bien que vous pouvez apprendre par la même occasion à développer -vos propres retouches. +obtenir un résultat identique dans vos partitions ; nous en profitons +pour expliquer comment ces commandes ont été construites, si bien que +vous pouvez apprendre par la même occasion à développer vos propres +retouches. Avant de vous lancer dans ce chapitre, il peut être utile de revoir la section @ref{Contextes et graveurs}, dans la mesure où les contextes, @@ -91,27 +92,26 @@ opérations internes et ces structures. Le terme @qq{Objet} est un terme générique qui fait référence à une multitude de structures internes mises en place par LilyPond durant la compilation d'un fichier d'entrée. Ainsi, quand une -commande du type @code{\new Staff} apparaît, un nouvel objet -du type @code{Staff} est créé. Cet objet @code{Staff} contient -alors toutes les propriétés associées à cette portée, par exemple son -nom et son armure, ainsi que le détail des graveurs qui ont été -désignés pour fonctionner dans ce contexte de portée. -Certains objets peuvent contenir les propriétés de tous les autres -contextes, comme les objets @code{Voice}, les objets @code{Score}, -les objets @code{Lyrics} ; d'autres se rapportent à tous les -éléments de notation, comme les barres de mesure, les liaisons, les -nuances, etc. Chaque objet dispose de son propre échantillon de valeurs -pour le réglage des propriétés. +commande du type @code{\new Staff} apparaît, un nouvel objet du type +@code{Staff} est créé. Cet objet @code{Staff} contient alors toutes les +propriétés associées à cette portée, par exemple son nom et son armure, +ainsi que le détail des graveurs qui ont été désignés pour fonctionner +dans ce contexte de portée. Certains objets peuvent contenir les +propriétés de tous les autres contextes, comme les objets @code{Voice}, +les objets @code{Score}, les objets @code{Lyrics} ; d'autres se +rapportent à tous les éléments de notation, comme les barres de mesure, +les liaisons, les nuances, etc. Chaque objet dispose de son propre +échantillon de valeurs pour le réglage des propriétés. Certains types d'objet portent des noms spécifiques. Les objets qui se rapportent à des éléments de notation sur le fichier de sortie, comme les notes, les hampes, les liaisons de phrasé ou de prolongation, les -doigtés, les clefs, etc. sont appelés @qq{Objets de rendu} ; ils -sont aussi connus sous le nom d'@qq{Objets graphiques} (en -anglais : @emph{Graphical objects} ou @emph{Grobs} pour faire -court). Ce sont bien des objets au sens générique ci-dessus et, en -tant que tels, ils reçoivent des propriétés qui leur sont associées, -comme leur position, leur taille, leur couleur etc. +doigtés, les clefs, etc. sont appelés @qq{Objets de rendu} ; ils sont +aussi connus sous le nom d'@qq{Objets graphiques} (en anglais : +@emph{Graphical objects} ou @emph{Grobs} pour faire court). Ce sont +bien des objets au sens générique ci-dessus et, en tant que tels, ils +reçoivent des propriétés qui leur sont associées, comme leur position, +leur taille, leur couleur etc. Certains objets de rendu, comme les liaisons de phrasé, les soufflets de crescendo, les marques d'octaviation et beaucoup d'autres @@ -124,7 +124,7 @@ anglais). Il reste à expliquer ce que sont les @qq{interfaces}. De nombreux objets, qui peuvent être très différents les uns des autres, ont pour point commun de devoir être compilés simultanément. Par exemple, tous -les @emph{grobs} ont une couleur, une taille, une position etc., et +les @emph{grobs} ont une couleur, une taille, une position, etc. et toutes ces propriétés sont compilées simultanément durant l'interprétation du fichier d'entrée par LilyPond. Pour alléger ces opérations internes, ces actions et propriétés communes sont regroupées @@ -193,6 +193,7 @@ nom de ses propriétés. @cindex retouches, méthodologie @cindex méthodes de retouche + @strong{La commande \override} @cindex override, commande @@ -229,10 +230,10 @@ l'objet @var{ObjetDeRendu}, appartenant lui-même au contexte Le contexte @var{Contexte} peut être omis (c'est généralement le cas) quand il n'y a pas d'ambiguïté et qu'il s'agit d'un contexte -de très bas niveau, comme @code{Voice}, @code{ChordNames} -ou @code{Lyrics}. Dans les exemples qui suivent, le contexte sera -très souvent omis. Nous verrons plus tard dans quelles -circonstances il doit impérativement être indiqué. +de très bas niveau, comme @code{Voice}, @code{ChordNames} ou +@code{Lyrics}. Dans les exemples qui suivent, le contexte sera très +souvent omis. Nous verrons plus tard dans quelles circonstances il doit +impérativement être indiqué. Les sections ci-dessous traitent largement des propriétés et de leurs valeurs -- voir @ref{Types de propriétés} -- mais, pour illustrer la @@ -260,6 +261,7 @@ e4 f | g4 a b c | @end lilypond + @strong{La commande \revert} @cindex revert, commande @@ -297,6 +299,7 @@ g4 a b4 c | @end lilypond + @strong{Le préfixe \once} @funindex \once @@ -338,6 +341,7 @@ ici par souci d'exhaustivité ; pour le détail, voir @c Maybe explain in a later iteration -td + @strong{La commande \tweak} @cindex tweak, commande @@ -452,12 +456,12 @@ Quand plusieurs nolets sont imbriqués et commencent au même instant musical, c'est encore la commande @code{\tweak} qui est utilisée pour changer l'apparence de l'un d'entre eux. Dans l'exemple suivant, le long crochet de nolet et le premier des trois crochets courts commencent -au même instant musical ; une commande @code{\override} -s'appliquerait donc à la fois aux deux. En revanche, @code{\tweak} -permet de les dissocier. La première commande @code{\tweak} indique que -le long crochet doit être placé au-dessus des notes, et la seconde -indique que le coefficient de nolet doit être imprimé en rouge sur le -premier crochet de triolet court. +au même instant musical ; une commande @code{\override} s'appliquerait +donc à la fois aux deux. En revanche, @code{\tweak} permet de les +dissocier. La première commande @code{\tweak} indique que le long +crochet doit être placé au-dessus des notes, et la seconde indique que +le coefficient de nolet doit être imprimé en rouge sur le premier +crochet de triolet court. @cindex @code{\tweak}, exemple @cindex direction, exemple d'utilisation de la propriété @@ -573,7 +577,7 @@ Prenons un exemple concret tiré d'un morceau de musique connu : Admettons que nous voulions rendre les traits de liaison plus épais. Est-ce possible ? Une liaison est assurément un objet de rendu, si bien que la question est @qq{Existe-t-il une propriété attachée aux -liaisons et qui en contrôle l'épaisseur ?} Pour y répondre, nous +liaisons et qui en contrôle l'épaisseur ?} Pour y répondre, nous consultons la Référence des propriétés internes (ou RPI pour faire court). @@ -612,10 +616,10 @@ la propriété susceptible de contrôler l'épaisseur des traits de liaison. @end example Voilà qui semble approprié pour changer l'épaisseur (@emph{thickness} en -anglais). On apprend que la valeur de @code{thickness} -est un simple nombre (@emph{number}), qu'elle est par défaut définie -à 1,2 et que l'unité de mesure est fixée par une autre propriété -appelée @code{line-thickness}. +anglais). On apprend que la valeur de @code{thickness} est un simple +nombre (@emph{number}), qu'elle est par défaut définie à 1,2 et que +l'unité de mesure est fixée par une autre propriété appelée +@code{line-thickness}. Comme il a été indiqué, on ne trouve que peu, voire pas du tout d'explication dans la RPI, mais nous en savons assez pour essayer @@ -665,7 +669,7 @@ proche d'elle.} Essayons : @noindent et nous constatons que le trait de liaison est beaucoup plus épais. -Telle est la façon normale de construire les commandes +Telle est la façon normale de construire des commandes @code{\override}. Comme nous aurons l'occasion de le voir par la suite, le problème est parfois plus complexe. Dans l'immédiat, nous en savons assez pour construire nos propres @@ -679,20 +683,18 @@ suivants sont là dans cette intention. @cindex contexte, détermination du @cindex contexte, identification correcte du -Tout d'abord, de quoi avions-nous besoin pour préciser le -contexte ? À quoi devait-il ressembler ? Gageons que les -liaisons appartiennent au contexte Voix, dans la mesure où -elles sont étroitement liées à une ligne mélodique, mais -comment en être sûr ? Pour répondre à cette question, -revenons en haut de la page de la RPI consacrée aux liaisons ; +Tout d'abord, de quoi avions-nous besoin pour préciser le contexte ? À +quoi devait-il ressembler ? Gageons que les liaisons appartiennent au +contexte Voix, dans la mesure où elles sont étroitement liées à une +ligne mélodique, mais comment en être sûr ? Pour répondre à cette +question, revenons en haut de la page de la RPI consacrée aux liaisons ; il est écrit : @qq{Les objets Liaison sont créés par le graveur -Slur_engraver}. Ainsi les liaisons seront créées dans n'importe -quel contexte où se trouve le @code{Slur_engraver}. Suivons -le lien vers la page @code{Slur_engraver}. Tout en bas, on -lit que le @code{Slur_engraver} est un élément appartenant -à cinq contextes Voix, dont le contexte de voix -standard, @code{Voice}. Notre hypothèse était donc juste. -Et parce que @code{Voice} est un contexte de très bas +Slur_engraver}. Ainsi les liaisons seront créées dans n'importe quel +contexte où se trouve le @code{Slur_engraver}. Suivons le lien vers la +page @code{Slur_engraver}. Tout en bas, on lit que le +@code{Slur_engraver} est un élément appartenant à cinq contextes Voix, +dont le contexte de voix standard, @code{Voice}. Notre hypothèse était +donc juste. Et parce que @code{Voice} est un contexte de très bas niveau, qu'il est activé sans ambiguïté par le fait que l'on est en train de saisir des notes, on peut ici ne pas le mentionner. @@ -707,14 +709,14 @@ en train de saisir des notes, on peut ici ne pas le mentionner. @funindex once Dans le dernier exemple ci-dessus, @emph{toutes} les liaisons étaient -plus épaisses. Et si on veut épaissir uniquement la première -liaison ? On recourt alors à la commande @code{\once}. Placée -juste avant la commande @code{\override}, elle lui indique de ne changer -que la liaison commençant avec la note @strong{juste après}. Si la note -juste après n'ouvre pas une liaison, la commande sera sans aucun effet --- elle ne reste pas en mémoire jusqu'à la prochaine liaison, elle est -purement et simplement ignorée. Il faut donc que la commande introduite -par @code{\once} soit insérée comme suit : +plus épaisses. Et si on veut épaissir uniquement la première liaison ? +On recourt alors à la commande @code{\once}. Placée juste avant la +commande @code{\override}, elle lui indique de ne changer que la liaison +commençant avec la note @strong{juste après}. Si la note juste après +n'ouvre pas une liaison, la commande sera sans aucun effet -- elle ne +reste pas en mémoire jusqu'à la prochaine liaison, elle est purement et +simplement ignorée. Il faut donc que la commande introduite par +@code{\once} soit insérée comme suit : @cindex Slur, exemple de dérogation @cindex thickness, exemple d'utilisation de la propriété @@ -759,10 +761,9 @@ La commande @code{\once} peut aussi être utilisée devant la commande Et si l'on voulait que les deux premières liaisons soient plus épaisses ? On pourrait bien sûr utiliser deux commandes, chacune -précédée de @code{\once}, et placées juste avant la note par laquelle +précédée de @code{\once} et placée juste avant la note par laquelle débute la liaison : - @cindex liaison, exemple de dérogation @cindex thickness, exemple d'utilisation de la propriété @cindex épaisseur, exemple d'utilisation @@ -947,7 +948,7 @@ et voilà les paroles en italiques. Lorsqu'il s'agit de paroles et qu'on cherche à préciser le contexte sur le modèle de ce qui a été fait précédemment, la commande échoue. -Car une syllabe saisie en mode Paroles (lyricmode) se termine +Car une syllabe saisie en mode Paroles (@code{lyricmode}) se termine obligatoirement par une espace, un saut de ligne ou un nombre. Tout autre caractère compte comme un élément de la syllabe. C'est pourquoi il faut une espace ou un saut de ligne avant le @code{@}} final, pour @@ -1001,14 +1002,14 @@ la commande @code{\override}. @tab @code{2.5}, @code{0.34} @item Direction @tab Une direction valide ou son équivalent numérique (valeur décimale - comprise entre -1 et 1 seulement) + comprise entre -1 et 1 seulement) @tab @code{LEFT}, @code{CENTER}, @code{UP}, @code{1}, @code{-1} @item Entier (@emph{Integer} en anglais) @tab Un nombre entier positif @tab @code{3}, @code{1} @item Liste @tab Plusieurs valeurs séparées par une espace, encadrées par des -parenthèses et précédées par une apostrophe + parenthèses et précédées par une apostrophe @tab @code{'(left-edge staff-bar)}, @code{'(1)}, @code{'(1.0 0.25 0.5)} @item Markup (ou étiquette) @@ -1026,14 +1027,14 @@ par des parenthèses et précédés par une apostrophe @tab @code{'(2 . 3.5)}, @code{'(0.1 . -3.2)} @item Symbole @tab L'un des symboles autorisés pour cette propriété, précédé par une -apostrophe + apostrophe @tab @code{'italic}, @code{'inside} @item Inconnu (@emph{Unknown} en anglais) @tab Un processus, ou @code{#f} pour empêcher toute action @tab @code{bend::print}, @code{ly:text-interface::print}, @code{#f} @item Vecteur @tab Une liste de trois éléments encadrés par des parenthèses et -précédés par apostrophe-hash, @code{'#} + précédés par apostrophe-hash, @code{'#} @tab @code{'#(#t #t #f)} @end multitable @@ -1095,9 +1096,9 @@ d'elles tour à tour. @subheading stencil +@c VO stencil @cindex stencil, propriété -@c VO stencil Cette propriété contrôle l'apparence des barres de mesure en précisant le type de symbole (glyphe) à imprimer. Comme pour de nombreuses @@ -1128,8 +1129,8 @@ sorte que, si la commande @code{\override} n'a pas fonctionné comme prévu, c'est parce que @code{Barline} n'appartient pas au contexte par défaut, @code{Voice}. Si le contexte spécifié est erroné, la commande ne fonctionne pas. Cela n'entraîne pas de message d'erreur, et rien -n'apparaît dans le fichier log. Essayons de corriger en mentionnant le -bon contexte : +n'apparaît dans le fichier @emph{log}. Essayons de corriger en +mentionnant le bon contexte : @cindex BarLine, exemple de dérogation @cindex stencil, exemple d'utilisation de la propriété @@ -1152,7 +1153,7 @@ doit d'avoir des dimensions pour les nécessités du traitement. Ce sera le cas, par exemple, si vous effacez le @code{stencil} d'un objet @code{NoteHead}. Il vaut mieux, en pareil cas, utiliser la fonction @code{point-stencil} qui, quant à elle, attribue à l'objet une taille à -zero : +zéro : @lilypond[quote,verbatim,relative=2] { @@ -1174,12 +1175,12 @@ booléens. Ceux-ci indiquent respectivement si les barres de mesure doivent être imprimées ou non à la fin de la ligne, à l'intérieur de la ligne et au début de la ligne. Dans notre cas, nous voulons que toutes les barres soient supprimées, si bien que la valeur dont nous avons -besoin est @code{'#(#f #f #f)}. Essayons, sans oublier -d'ajouter le contexte @code{Staff}. Vous remarquerez que, en plus de -cette valeur, nous ajoutons @code{#'#} devant la parenthèse ouvrante. -Le @code{'#} est nécessaire car il fait partie intégrante de la valeur -contenant un vecteur, et le premier @code{#} est là, comme toujours avec -la commande @code{\override}, pour introduire la valeur elle-même. +besoin est @code{'#(#f #f #f)}. Essayons, sans oublier d'ajouter le +contexte @code{Staff}. Vous remarquerez que, en plus de cette valeur, +nous ajoutons @code{#'#} devant la parenthèse ouvrante. Le @code{'#} +est nécessaire car il fait partie intégrante de la valeur contenant un +vecteur, et le premier @code{#} est là, comme toujours avec la commande +@code{\override}, pour introduire la valeur elle-même. @cindex BarLine, exemple de dérogation @cindex break-visibility exemple d'utilisation de la propriété @@ -1339,10 +1340,10 @@ le symbole et insérer les deux à l'intérieur de parenthèses. Il existe une troisième fonction, écrite pour convertir les valeurs RVB en couleurs internes -- la fonction @code{rgb-color}. Elle comporte trois arguments, donnant respectivement l'intensité du rouge, du vert et -du bleu. Ces arguments prennent des valeurs comprises entre 0 et 1. +du bleu. Ces arguments prennent des valeurs comprises entre 0 et 1. Ainsi, pour choisir la couleur rouge, la valeur serait -@code{(rgb-color 1 0 0)} ; pour le blanc, ce serait -@code{(rgb-color 1 1 1)} : +@code{(rgb-color 1 0 0)} ; pour le blanc, ce serait +@code{(rgb-color 1 1 1)} : @cindex BarLine, exemple de dérogation @cindex color, exemple d'utilisation de la propriété @@ -1614,8 +1615,8 @@ portée -- plus rarement, il est question de demi-intervalles de lignes. Les propriétés d'épaisseur (@code{thickness}), quant à elles, sont généralement mesurées en unités d'une propriété interne appelée @qq{épaisseur de ligne} (@code{line-thickness}). Par exemple, les -lignes de crescendo/decrescendo présentent par défaut une épaisseur de -1 unité de @code{line-thickness}, alors que l'épaisseur d'une hampe +lignes de (de)crescendo présentent par défaut une épaisseur d'une +unité de @code{line-thickness}, alors que l'épaisseur d'une hampe est de 1,3. Toutefois, certaines propriétés d'épaisseur sont différentes : par exemple, l'épaisseur des ligature -- @code{beam-thickness} -- se mesure en espaces de portée. @@ -1624,9 +1625,9 @@ Dans ces conditions, comment ajuster les longueurs à la taille des polices de caractères ? La solution consiste à utiliser une fonction spéciale appelée @code{magstep} -- pseudo facteur de zoom --, créée précisément dans ce but. Elle comporte un argument, le changement -de taille de police (#-2 dans l'exemple précédent), à partir duquel elle -applique un facteur de mise à l'échelle qui réduit, ou augmente, les -objets en question. Voici comment elle s'utilise : +de taille de police (@code{#-2} dans l'exemple précédent), à partir +duquel elle applique un facteur de mise à l'échelle qui réduit, ou +augmente, les objets en question. Voici comment elle s'utilise : @cindex alignAboveContext, exemple d'utilisation de la propriété @cindex @code{\with}, exemple @@ -1678,7 +1679,7 @@ tous les objets peuvent être modifiées de manière analogue. Pour de petits changements d'échelle, comme dans l'exemple ci-dessus, il n'est généralement pas utile d'ajuster l'épaisseur des différentes lignes telles que les barres de mesure, les ligatures, les soufflets de -crescendo ou decrescendo, les liaisons, etc. Si l'épaisseur d'un objet +crescendo ou decrescendo, les liaisons, etc. Si l'épaisseur d'un objet en particulier doit être ajustée, le mieux est de modifier sa propriété @code{thickness}. Nous avons vu plus haut, dans @ref{Propriétés des objets de rendu}, un exemple de modification de @@ -1714,7 +1715,7 @@ objects} en anglais) et les @qq{objets extérieurs à la portée} (@emph{outside-staff objects} en anglais). Les objets de la portée sont ceux qui sont placés sur la portée --- les têtes de notes et les hampes, les altérations, etc. Leur +-- les têtes de notes et les hampes, les altérations, etc. Leur position est généralement déterminée par la musique elle-même -- ils sont placés verticalement sur des lignes spécifiques ou sont liés à d'autres objets placés de cette manière. Normalement, les collisions @@ -1792,11 +1793,10 @@ nombre de commandes déjà prêtes qui évitent, pour les modifications les plus courantes, d'avoir à encoder les retouches. Certains objets comme les traits des liaisons se recourbent tantôt -vers le haut, tantôt vers le bas ; d'autres encore, comme les -hampes et les crochets, peuvent se décaler vers la gauche ou vers la -droite selon qu'ils pointent vers le haut ou vers le bas. Ce -comportement est géré automatiquement dès lors que @code{direction} est -activé. +vers le haut, tantôt vers le bas ; d'autres encore, comme les hampes et +les crochets, peuvent se décaler vers la gauche ou vers la droite selon +qu'ils pointent vers le haut ou vers le bas. Ce comportement est géré +automatiquement dès lors que @code{direction} est activé. @cindex down @cindex up @@ -1868,7 +1868,8 @@ signification est précisée. @item @code{\textSpannerDown} @tab @code{\textSpannerUp} @tab @code{\textSpannerNeutral} - @tab Le texte saisi en tant qu'extension est au-dessous/au-dessus de la portée + @tab Le texte saisi en tant qu'extension est au-dessous/au-dessus de + la portée @item @code{\tieDown} @tab @code{\tieUp} @tab @code{\tieNeutral} @@ -1956,8 +1957,7 @@ le placement de tous ou certains chiffres de doigté, comme ceci : On peut aller encore plus loin dans le positionnement des doigtés pour chacune des notes d'un accord grâce à la commande -@code{\set fingeringOrientations}. La syntaxe de cette commande -est : +@code{\set fingeringOrientations}. La syntaxe de cette commande est : @example @code{\set fingeringOrientations = #'([up] [left/right] [down])} @@ -2269,8 +2269,7 @@ Par défaut, l'espacement horizontal d'un texte produit sous forme de @emph{markup} (ou d'étiquette) n'est pas pris en compte, dans la mesure où ce qui est concerné n'entre pas dans la musique. La commande @code{\textLengthOn} inverse ce comportement, faisant en sorte que les -notes soient espacées autant qu'il le faut pour s'adapter au -texte : +notes soient espacées autant qu'il le faut pour s'adapter au texte : @lilypond[quote,fragment,ragged-right,verbatim,relative=2] \textLengthOn % Cause notes to space out to accommodate text @@ -2345,8 +2344,7 @@ ees,2.~\)\mf ees4 r8 | De toute façon, si les notes et les nuances qui leur sont liées sont trop proches, le positionnement automatique évitera les collisions en déplaçant davantage les nuances suivantes, mais le résultat peut ne -pas être très satisfaisant, comme le montre cet exemple -artificiel : +pas être très satisfaisant, comme le montre cet exemple artificiel : @lilypond[quote,fragment,ragged-right,verbatim,relative=2] \dynamicUp @@ -2388,9 +2386,9 @@ comme étant nulle, si bien qu'ils peuvent se chevaucher horizontalement. Pour remédier à cela, on a ajouté l'infini à l'extension gauche et moins l'infini à l'extension droite, en attribuant à @code{extra-spacing-width} la valeur -@code{'(+inf.0 . -inf.0)}. Pour être sûr que les objets ne se +@code{'(+inf.0 . -inf.0)}. Pour être sûr que les objets ne se chevaucheront pas horizontalement, nous devons donc corriger cette -valeur de @code{extra-spacing-width} en @w{@code{'(0 . 0)}}, afin que +valeur de @code{extra-spacing-width} en @code{'(0 . 0)}, afin que leur vraie largeur se manifeste. La commande pour y parvenir avec des indications de nuances est : @@ -2483,9 +2481,9 @@ qu'entre deux positions, sans personnalisation possible. @item Les @strong{propriétés d'objet}, auxquelles LilyPond a recours pour positionner les objets, sont modifiables avec @code{\override}. Il y a -deux avantages à changer ces propriétés : (a) d'autres objets +deux avantages à changer ces propriétés : (a) d'autres objets pourront être déplacés automatiquement si nécessaire pour faire de la -place, et (b) la même retouche peut s'appliquer à toutes les occurrences +place, et (b) la même retouche peut s'appliquer à toutes les occurrences du même type d'objet. Ces propriétés sont : @itemize @@ -2665,7 +2663,7 @@ perturber quoi que ce soit. Cette propriété est très utile pour ajuster manuellement l'inclinaison et la hauteur des barres de ligature, des liaisons et des nolets. Elle est suivie de deux nombres qui donnent la position des extrémités gauche -et droite des barres, liaisons, etc. par rapport à la ligne médiane de +et droite des barres, liaisons, etc. par rapport à la ligne médiane de la portée. L'unité de référence est l'intervalle de lignes de portée. Attention toutefois au fait que les liaisons et phrasés ne peuvent pas être repositionnés n'importe où. LilyPond commence par dresser la liste @@ -2687,17 +2685,17 @@ trouver les propriétés à retoucher pour obtenir un déplacement. @multitable @columnfractions .5 .5 -@headitem Type d'objet @tab Nom d'objet -@item Articulations @tab @code{Script} -@item Barres de ligature @tab @code{Beam} -@item Doigté @tab @code{Fingering} -@item Liaisons de phrasé @tab @code{Slur} -@item Liaisons de prolongation @tab @code{Tie} -@item Nolets @tab @code{TupletBracket} -@item Nuances (verticalement) @tab @code{DynamicLineSpanner} -@item Nuances (horizontalement) @tab @code{DynamicText} -@item Reprises / marques de texte @tab @code{RehearsalMark} -@item Texte, p.ex. @code{^"texte"} @tab @code{TextScript} +@headitem Type d'objet @tab Nom d'objet +@item Articulations @tab @code{Script} +@item Barres de ligature @tab @code{Beam} +@item Doigté @tab @code{Fingering} +@item Liaisons de phrasé @tab @code{Slur} +@item Liaisons de prolongation @tab @code{Tie} +@item Nolets @tab @code{TupletBracket} +@item Nuances (verticalement) @tab @code{DynamicLineSpanner} +@item Nuances (horizontalement) @tab @code{DynamicText} +@item Reprises / marques de texte @tab @code{RehearsalMark} +@item Texte, par ex. @code{^"texte"} @tab @code{TextScript} @end multitable @@ -2876,7 +2874,7 @@ dans la @code{\voiceTwo} (c'est-à-dire dans la seconde voix d'une construction @code{<<@{@dots{}@} \\ @{@dots{}@}>>}), la propriété @code{staff-position} est réglée sur @code{-4} pour les @code{MultiMeasureRest} ; nous avons donc besoin de la déplacer, disons, -de quatre demi-intervalles vers le bas, ce qui donne @code{-8}. +de quatre demi-intervalles vers le bas, ce qui donne @code{-8}. @cindex MultiMeasureRest, exemple de dérogation @cindex staff-position, exemple d'utilisation de la propriété @@ -2908,8 +2906,7 @@ entièrement le placement d'un objet, aussi bien horizontalement que verticalement. Dans l'exemple suivant, la seconde indication de doigté est déplacée -légèrement vers la gauche et de 1,8 intervalle de lignes vers le -bas : +légèrement vers la gauche et de 1,8 intervalle de lignes vers le bas : @cindex Fingering, exemple de dérogation @cindex extra-offset, exemple d'utilisation de la propriété @@ -2990,7 +2987,7 @@ ligature chevauchent les liaisons de tenue : @noindent On peut y remédier en déplaçant manuellement vers le haut les deux extrémités des ligatures de croches, non plus à 1,81 intervalle -au-dessous de la ligne médiane mais, disons, à 1 : +au-dessous de la ligne médiane mais, disons, à 1 : @cindex Beam, exemple de dérogation @cindex positions, exemple d'utilisation de la propriété @@ -3093,9 +3090,8 @@ nombre de retouches jusqu'à l'obtention du résultat attendu. Cet exemple a été choisi en raison des problèmes inhabituels de notation qu'il soulevait et pour vous apprendre à les résoudre grâce au Manuel de notation. Il n'est pas représentatif d'une opération normale de -gravure ; que ces difficultés ne vous découragent donc pas ! -Des difficultés comme celles-ci ne sont, heureusement, pas -courantes ! +gravure ; que ces difficultés ne vous découragent donc pas ! Des +difficultés comme celles-ci ne sont, heureusement, pas courantes ! Cet exemple est tiré de la Première Ballade de Chopin, Op. 23, mesures 6 à 9 ; cela correspond à la transition entre le Lento d'ouverture @@ -3305,17 +3301,17 @@ cela n'a pas été traité dans le Manuel d'initiation ? C'est alors qu'il faut nous reporter au Manuel de notation. Quand on cherche @qq{arpège} et @qq{barre de mesure} dans l'index, on voit aisément qu'il faut ajouter @code{\arpeggio} à un accord pour produire un arpège et -qu'une double barre est le résultat de la commande -@code{\bar "||"}. Rien de plus facile ! Nous devons ensuite -corriger la collision entre la liaison et l'indication de mesure. Le -mieux est de déplacer la liaison vers le haut. La méthode pour déplacer -les objets a déjà été présentée dans @ref{Déplacement d'objets}, et l'on -sait que, pour des objets positionnés par rapport à la portée, il nous -faut modifier leur propriété @code{staff-position}, exprimée en -demi-intervalles de lignes par rapport à la ligne médiane de la portée. -Voici donc la retouche à insérer juste devant la première note -liée ; elle est censée déplacer la liaison vers le haut de 3,5 -demi-intervalles de lignes au-dessus de la ligne médiane : +qu'une double barre est le résultat de la commande @code{\bar "||"}. +Rien de plus facile ! Nous devons ensuite corriger la collision entre +la liaison et l'indication de mesure. Le mieux est de déplacer la +liaison vers le haut. La méthode pour déplacer les objets a déjà été +présentée dans @ref{Déplacement d'objets}, et l'on sait que, pour des +objets positionnés par rapport à la portée, il nous faut modifier leur +propriété @code{staff-position}, exprimée en demi-intervalles de lignes +par rapport à la ligne médiane de la portée. Voici donc la retouche à +insérer juste devant la première note liée ; elle est censée déplacer la +liaison vers le haut de 3,5 demi-intervalles de lignes au-dessus de la +ligne médiane : @code{\once \override Tie #'staff-position = #3.5} @@ -4202,17 +4198,18 @@ La référence des propriétés internes contient beaucoup d'informations sur LilyPond. Cependant vous pouvez en découvrir encore plus en consultant les fichiers internes de LilyPond. Pour cela, il vous faut d'abord connaître le répertoire @emph{ad hoc} sur votre système. -L'emplacement du répertoire dépend (a) du fait que, pour vous procurer -LilyPond, vous avez téléchargé un paquet précompilé sur lilypond.org, ou +L'emplacement du répertoire dépend (a) du fait que, pour vous procurer +LilyPond, vous avez téléchargé un paquet précompilé sur lilypond.org ou vous l'avez installé grâce à votre gestionnaire de paquetages -(c'est-à-dire distribué avec Linux ou installé avec fink ou cygwin), ou +(c'est-à-dire distribué avec GNU/Linux ou installé avec fink ou cygwin), ou encore vous l'avez compilé directement à partir des sources ; et -(b) du système d'exploitation sur lequel il tourne. +(b) du système d'exploitation sur lequel il tourne. + @strong{Téléchargé depuis lilypond.org} @itemize @bullet -@item Linux +@item GNU/Linux @example @file{@var{INSTALLDIR}/lilypond/usr/@/share/lilypond/current/} @@ -4238,13 +4235,14 @@ Dans l'Explorateur Windows, voir @end itemize + @strong{Installé par un gestionnaire de paquetages ou compilé d'après les sources} @code{@var{PREFIX}/share/lilypond/@var{X.Y.Z}/}, où @var{PREFIX} est déterminé par votre gestionnaire de paquetages ou par -le script @code{configure}, et @var{X.Y.Z} est le numéro de version de -LilyPond. +le script @code{configure}, et @var{X.Y.Z} représente le numéro de +version de LilyPond. @smallspace @@ -4283,15 +4281,15 @@ Voici les fichiers les plus utiles dans le répertoire @file{ly/} : @headitem Nom de fichier @tab Contenu @item @file{ly/engraver-init.ly} - @tab Définitions des Contextes de graveurs + @tab Définition des contextes de graveurs @item @file{ly/paper-defaults-init.ly} @tab Réglages papier par défaut @item @file{ly/performer-init.ly} - @tab Définitions des Contextes d'interprétation + @tab Définition des contextes d'interprétation @item @file{ly/property-init.ly} - @tab Définitions de toutes les commandes prédéfinies courantes + @tab Définition de toutes les commandes prédéfinies courantes @item @file{ly/spanner-init.ly} - @tab Définitions des commandes prédéfinies pour les bandeaux + @tab Définition des commandes prédéfinies pour les bandeaux @end multitable Les autres réglages (comme les définitions de commandes @emph{markup}) @@ -4321,7 +4319,7 @@ sont : @tab Réglages par défaut pour les sorties MIDI @item @file{scm/output-lib.scm} @tab Réglages affectant l'apparence des frets, couleurs, altérations, - barres de mesure etc. + barres de mesure, etc. @item @file{scm/parser-clef.scm} @tab Définition des clefs prises en charge @item @file{scm/script.scm} @@ -4351,7 +4349,6 @@ un réglage dynamique de la propriété par le simple fait d'invoquer la procédure. Dans cet exemple, nous colorons les têtes de notes en fonction de leur position sur la portée. - @cindex x11-color, exemple d'utilisation de la fonction @cindex NoteHead, exemple de dérogation @cindex color, détermination de la propriété par une procédure Scheme @@ -4381,4 +4378,3 @@ fonction de leur position sur la portée. Vous trouverez dans @rextend{Fonctions de rappel} d'autres exemples d'utilisation de ces interfaces programmables. - -- 2.39.2