X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Ffr%2Fuser%2Ftutorial.itely;h=52c6a0b60668537d3da0ce35b851b3ad8a6a2fbc;hb=1423508c355989fa26a8cfe5985b0d6e1ab0a538;hp=7dddaaae8d0f744a199c23a82e0fb2bb2761fc2e;hpb=8cebf6140c89a3141fa4a4864955f28e825e021c;p=lilypond.git diff --git a/Documentation/fr/user/tutorial.itely b/Documentation/fr/user/tutorial.itely index 7dddaaae8d..52c6a0b606 100644 --- a/Documentation/fr/user/tutorial.itely +++ b/Documentation/fr/user/tutorial.itely @@ -1,13 +1,13 @@ @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*- @c This file is part of lilypond.tely @ignore - Translation of GIT committish: 0b3b41414fa52672d7d9416c265cd8d0568eef13 + Translation of GIT committish: f413550b658b43fbea690fc060f872bce6bbc885 When revising a translation, copy the HEAD committish of the version that you are working on. See TRANSLATION for details. @end ignore -@c \version "2.11.51" +@c \version "2.12.0" @ignore Tutorial guidelines: (different from policy.txt!) @@ -58,7 +58,7 @@ LilyPond. @menu * Compiling a file:: * Simple notation:: -* Working on text files:: +* Working on input files:: * How to read the manual:: @end menu @@ -67,13 +67,16 @@ LilyPond. @subsection Compiling a file @cindex compilation +@cindex exemple, premier +@cindex premier exemple Pour créer une partition avec LilyPond, on écrit un fichier texte, appelé fichier source, qui décrit la notation musicale. La @emph{compilation} de ce fichier source par LilyPond produit un fichier graphique imprimable, et si on le désire un fichier MIDI qui -peut être joué par un séquenceur. Voici un premier exemple simple de -fichier source LilyPond. +peut être joué par un séquenceur. + +Voici un premier exemple simple de fichier source LilyPond. @example @{ @@ -82,11 +85,11 @@ fichier source LilyPond. @end example @noindent -Le compilation de cette partition donnera quelque chose de sembable à +La compilation de ce fichier donnera quelque chose de sembable à l'image ci-dessous. @c in this case we don't want verbatim -@lilypond[quote,ragged-right] +@lilypond[quote] { c' e' g' e' } @@ -107,9 +110,10 @@ Pour plus d'informations sur l'affichage des exemples de cette documentation, consultez @ref{How to read the manual}.} -@cindex casse, prise en compte de +@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} : le code @w{@code{@{ c d e @}}} est valide, alors que @w{@code{@{ C D E @}}} produira un message d'erreur. @@ -122,6 +126,13 @@ produira un message d'erreur. @cindex PDF @cindex partition, lire @cindex lire la partition +@cindex éditeurs de texte +@cindex LilyPond et MacOS X +@cindex MacOS X et LilyPond +@cindex LilyPond et Windows +@cindex Windows et LilyPond +@cindex LilyPond et Unix +@cindex Unix et LilyPond Dans cette section nous expliquerons quelles commandes exécuter et comment voir ou imprimer le résultat produit par LilyPond. @@ -130,7 +141,7 @@ Notez qu'il existe plusieurs éditeurs de texte disponibles avec un bon support de LilyPond ; consultez @rprogram{Text editor support}. @warning{Le premier démarrage de LilyPond peut prendre une minute ou -deux, afin de faire la liste des polices du système. LilyPond démarre +deux, afin de générer la liste des polices du système. LilyPond démarre en principe plus rapidement lors des exécutions suivantes.} @@ -213,12 +224,15 @@ non. @node Simple notation @subsection Simple notation +@cindex simple, notation +@cindex notation simple + Il y a certains éléments graphiques de notation que LilyPond ajoute automatiquement. Dans l'exemple suivant, nous n'avons fourni que -quatre hauteurs, mais LilyPond a ajouté une clé, un chiffre de mesure +quatre hauteurs, mais LilyPond a ajouté une clef, un chiffre de mesure et du rythme. -@lilypond[quote,ragged-right,verbatim] +@lilypond[verbatim,quote] { c' e' g' e' } @@ -232,6 +246,18 @@ explicitement. @subheading Hauteurs +@cindex hauteurs +@cindex mode relatif +@cindex apostrophe +@cindex virgule +@cindex altérations et mode relatif +@cindex mode relatif et altérations + +@funindex \relative +@funindex relative +@funindex ' +@funindex , + Glossaire musical : @rglos{pitch}, @rglos{interval}, @rglos{scale}, @rglos{middle C}, @rglos{octave}, @rglos{accidental}. @@ -244,8 +270,9 @@ façon à ce que l'intervalle avec la note précédente soit au plus d'une quarte. Commençons par saisir une partition très simple, à savoir une gamme. -@lilypond[quote,ragged-right,verbatim] -\relative c' { % set the starting point to middle C +@lilypond[verbatim,quote] +% set the starting point to middle C +\relative c' { c d e f g a b c } @@ -254,11 +281,11 @@ gamme. La note de départ est le @notation{do central}. Chacune des notes qui suivent est placée à l'octave la plus proche de la note précédente --- en d'autres termes, le premier @samp{c} est le do central, entre la -clé de sol et la clé de fa, puis est suivi par le ré le plus proche, +clef de sol et la clef de fa, puis est suivi par le 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} : -@lilypond[quote,ragged-right,verbatim] +@lilypond[verbatim,quote] \relative c' { d f a g c b f d @@ -274,8 +301,9 @@ Dans l'exemple suivant, on remplace @code{c'} dans la commande la première note par rapport au do situé une octave au-dessus du do central : -@lilypond[verbatim,quote,ragged-right] -\relative c'' { % one octave above middle C +@lilypond[verbatim,quote] +% one octave above middle C +\relative c'' { e c a c } @end lilypond @@ -283,14 +311,14 @@ central : Le mode d'octaves relatives peut être déroutant au début, mais c'est souvent la façon la plus économique de saisir les hauteurs en utilisant le clavier de l'ordinateur de façon classique. Détaillons -sur un exemple le calcul des octaves relatives. En partant d'un si +dans un exemple le calcul des octaves relatives. En partant d'un si sur la troisième ligne de la clé de sol, un do, un ré ou un mi sans indication d'octave particulière seront placés juste au-dessus du si, c'est-à-dire au plus à une quarte ascendante du si, alors qu'un la, un sol ou un fa seront placés juste en-dessous du si, c'est-à-dire au plus à une quarte descendante du si. -@lilypond[verbatim,quote,ragged-right] +@lilypond[verbatim,quote] \relative c'' { b c % c is 1 staff space up, so is the c above b d % d is 2 up or 5 down, so is the d above @@ -309,7 +337,7 @@ des apostrophes @code{'} --- qui font chacune monter la hauteur d'une octave --- ou des virgules @code{,} --- qui font chacune descendre la hauteur d'une octave --- au nom de la note. -@lilypond[quote,ragged-right,verbatim] +@lilypond[verbatim,quote] \relative c'' { a a, c' f, g g'' a,, f' @@ -318,7 +346,7 @@ hauteur d'une octave --- au nom de la note. @noindent Pour déplacer une note deux octaves (ou davantage !) plus haut ou plus -bas, il suffit de mettre deux (ou davantage) de @code{'} ou ou @code{,} --- +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 peut modifier la valeur de départ de @code{\relative c'}. @@ -326,6 +354,15 @@ peut modifier la valeur de départ de @code{\relative c'}. @subheading Durées et rythme +@cindex note, durée +@cindex durées +@cindex rhythmes +@cindex ronde +@cindex blanche +@cindex noire +@cindex note pointée +@cindex spécification des durées + Glossaire musical : @rglos{beam}, @rglos{duration}, @rglos{whole note}, @rglos{half note}, @rglos{quarter note}, @rglos{dotted note}. @@ -333,14 +370,14 @@ Glossaire musical : @rglos{beam}, @rglos{duration}, La @notation{durée} d'une note est indiquée par un nombre qui suit sa hauteur : @samp{1} pour une @notation{ronde}, @samp{2} pour une @notation{blanche}, @samp{4} pour une @notation{noire} et ainsi de -suite. Les @notation{crochets} et @notation{liens} sont ajoutées +suite. Les @notation{crochets} et @notation{liens} sont ajoutés automatiquement. Si aucune durée n'est indiquée pour une note, la dernière durée entrée est utilisée. En l'absence d'indication de durée, la première note est une noire. -@lilypond[verbatim,quote,ragged-right] +@lilypond[verbatim,quote] \relative c'' { a1 a2 a4 a8 a @@ -349,9 +386,10 @@ est une noire. @end lilypond Une @notation{note pointée} s'obtient en ajoutant un point @code{.} à -la valeur rythmique. Le point doit être précédé d'un nombre de durée. +la valeur rythmique. Le point doit être précédé d'un nombre spécifiant +la durée de base. -@lilypond[verbatim,quote,ragged-right] +@lilypond[verbatim,quote] \relative c'' { a a a4. a8 a8. a16 a a8. a8 a4. @@ -361,12 +399,15 @@ la valeur rythmique. Le point doit être précédé d'un nombre de durée. @subheading Silences +@cindex silences +@cindex notation des silences + Glossaire musical : @rglos{rest}. On saisit un @notation{silence} tout comme une note, mais avec la -lettre @samp{r}. +lettre @samp{r} (pour @emph{rest}). -@lilypond[verbatim,quote,ragged-right] +@lilypond[verbatim,quote] \relative c'' { a r r2 r8 a r4 r4. r8 @@ -376,12 +417,17 @@ lettre @samp{r}. @subheading Métrique +@cindex métrique + +@funindex \time +@funindex time + Glossaire musical : @rglos{time signature}. La @notation{métrique}, aussi appelée @notation{chiffre de mesure}, peut être définie à l'aide de la commande @code{\time} : -@lilypond[verbatim,quote,ragged-right] +@lilypond[verbatim,quote] \relative c'' { \time 3/4 a4 a a @@ -395,12 +441,21 @@ peut être définie à l'aide de la commande @code{\time} : @subheading Clef +@cindex clef +@cindex clé +@cindex sol, clef de +@cindex ut, clef d' +@cindex fa, clef de + +@funindex \clef +@funindex clef + Glossaire musical : @rglos{clef}. La @notation{clef} peut être définie à l'aide de la commande @code{\clef} : -@lilypond[verbatim,quote,ragged-right] +@lilypond[verbatim,quote] \relative c' { \clef treble c1 @@ -419,7 +474,7 @@ La @notation{clef} peut être définie à l'aide de la commande Voici un bref exemple qui rassemble tous les éléments que nous déjà vus : -@lilypond[verbatim,quote,ragged-right] +@lilypond[verbatim,quote] \relative c, { \time 3/4 \clef bass @@ -428,15 +483,18 @@ vus : } @end lilypond -@seealso +@seealso Manuel de notation : @ruser{Writing pitches}, @ruser{Writing rhythms}, @ruser{Writing rests}, @ruser{Time signature}, @ruser{Clef}. -@node Working on text files -@subsection Working on text files +@node Working on input files +@subsection Working on input files + +@cindex accolades +@funindex { ... } Le traitement des fichiers source de LilyPond est semblable à celui du code de nombreux langages de programmation. La casse est prise @@ -449,16 +507,19 @@ Expliquons tous ces termes : @itemize +@item @strong{La casse} : @cindex casse, prise en compte de @cindex prise en compte de la casse @cindex sensibilité à la casse -@item @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 minuscules : @code{@{ c d e @}} est +exemple, doivent être entrées en minuscule : @code{@{ c d e @}} est un code valide, alors que @code{@{ C D E @}} produira un message d'erreur. +@cindex espaces multiples, insensibilité +@cindex insensibilité aux espaces multiples + @item @strong{Les espaces multiples} : LilyPond ne tient pas compte du nombre d'espaces, ou de retours à la ligne. @code{@{ c d e @}} a le @@ -480,6 +541,8 @@ soit des doubles espaces : @} @end example +@cindex expressions + @item @strong{Expressions musicales} : Tout morceau saisi dans LilyPond doit être placé entre @strong{@{ accolades @}}. Ces caractères indiquent à LilyPond que ce bloc de @@ -495,6 +558,10 @@ compte également comme une seule expression musicale. @cindex commentaire de fin de ligne @cindex commentaire-bloc @cindex bloc de commentaire + +@funindex % +@funindex %@{ ... %@} + @item @strong{Les commentaires} : un commentaire est une indication pour tout lecteur humain d'un fichier source de musique ; il est ignoré par l'ordinateur, et n'a @@ -507,11 +574,11 @@ référence. @example a4 a a a -% ce commentaire fait référence aux sis +% ce commentaire fait référence aux si b2 b @end example -Le bloc de commentaire, qui peut occuper plusieurs lignes voire toute +Le bloc de commentaire, qui peut occuper plusieurs lignes, voire toute 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 à @@ -540,7 +607,17 @@ quelques usages possibles des commentaires : @node How to read the manual @subsection How to read the manual -Comme nous l'avons vu dans @ref{Working on text files}, un code +@cindex bien lire le manuel +@cindex manuel, lecture +@cindex compulser le manuel +@cindex exemples cliquables +@cindex cliquables, exemples +@cindex conseils de construction des fichiers +@cindex squelettes +@cindex construction des fichiers, conseils +@cindex fichiers, conseils de construction + +Comme nous l'avons vu dans @ref{Working on input files}, un code LilyPond doit être encadré par des accolades @{ @} ou bien par @code{\relative c'' @{ ... @}}. Cependant, dans la suite de ce manuel, la plupart des exemples ne feront pas apparaître ces signes. @@ -594,8 +671,8 @@ d'imprimer ou de garder un lien vers @ruser{Cheat sheet}, tableau qui répertorie les commandes usuelles pour une consultation rapide. @end ignore -@seealso +@seealso Vous trouverez plus de conseils pour construire des fichiers source dans @ref{Suggestions for writing LilyPond input files}. Cependant, lors d'une première lecture il est préférable de terminer d'abord la @@ -623,6 +700,22 @@ Cette section présente la notation courante dont on a besoin pour @subheading Accidentals +@cindex dièse +@cindex double dièse +@cindex dièse, double +@cindex bémol +@cindex double bémol +@cindex bémol, double + +@funindex es +@funindex b +@funindex is +@funindex d +@funindex eses +@funindex bb +@funindex isis +@funindex dd + Glossaire musical : @rglos{sharp}, @rglos{flat}, @rglos{double sharp}, @rglos{double flat}, @rglos{accidental}. @@ -644,19 +737,32 @@ autres langues disponibles, consultez @ruser{Note names in other languages}. @c END DIV -@lilypond[quote,ragged-right,verbatim,fragment,relative=2] +@lilypond[verbatim,quote,relative=2] cis1 ees fisis, aeses @end lilypond +@subheading Key signatures + @cindex armure, définition de l' @cindex armure, altérations à l' @cindex altérations à l'armure -@subheading Key signatures +@cindex majeur +@cindex mineur + +@funindex \key +@funindex key +@funindex \major +@funindex major +@funindex \minor +@funindex minor + +Glossaire musical : @rglos{key signature}, @rglos{major}, +@rglos{minor}. L'armure est déterminée par la commande @code{\key}, suivie d'une hauteur puis de @code{\major} (majeur) ou @code{\minor} (mineur). -@lilypond[quote,ragged-right,verbatim,fragment,relative=2] +@lilypond[verbatim,quote,relative=2] \key d \major a1 \key c \minor @@ -684,7 +790,7 @@ mise en forme. L'altération d'une note --- @notation{bémol}, et relève donc du contenu musical. La gravure ou non d'une altération 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 une partition suit des règles, en particulier des règles +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 ; et, dans la mesure où la musique que vous entrez est censée être celle que vous voulez @@ -693,7 +799,7 @@ choisira pas à votre place. Dans cet exemple, -@lilypond[quote,ragged-right,verbatim,fragment,relative=2] +@lilypond[verbatim,quote,relative=2] \key d \major d cis fis @end lilypond @@ -702,14 +808,14 @@ d cis fis 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{e} ne veut pas dire @qq{Imprimez-moi un point noir sur -la première ligne de la portée.} Cela signifie plutôt : @qq{Ici se -trouve une note dont la hauteur est un mi naturel.} Avec une armure -de la bémol majeur, ce mi est flanqué d'un bécarre accidentel : +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 : @qq{Ici se +trouve une note dont la hauteur est un si naturel.} Avec une armure +de la bémol majeur, ce si est flanqué d'un bécarre accidentel : -@lilypond[quote,ragged-right,verbatim,fragment,relative=2] +@lilypond[verbatim,quote,relative=2] \key aes \major -e +b @end lilypond Ajouter explicitement toutes les altérations demande un peu plus @@ -719,14 +825,15 @@ peuvent ainsi être imprimées suivant plusieurs conventions. Pour connaître les différentes manières dont les altérations accidentelles peuvent être imprimées, consultez @ruser{Automatic accidentals}. -@seealso +@seealso Manuel de notation : @ruser{Note names in other languages}, @ruser{Accidentals}, @ruser{Automatic accidentals}, @ruser{Key signature}. Glossaire musical : @rglos{Pitch names}. + @node Ties and slurs @subsection Ties and slurs @@ -735,6 +842,11 @@ Glossaire musical : @rglos{Pitch names}. @cindex prolongation, liaisons de @cindex durée, liaisons de @cindex tenue, liaisons de + +@funindex ~ +@funindex ( ... ) +@funindex \( ... \) + @subheading Ties Glossaire musical : @rglos{tie}. @@ -750,13 +862,16 @@ c4 ~ c8 a8 ~ a2 @cindex liaisons d'articulation @cindex articulation, liaisons d' + @subheading Slurs @c Le terme de "slur" a deux sens en français : articulation et phrasé. @c Je garde ici le terme "legato", tel qu'il apparaît dans le texte original, @c car c'est celui qui me semble le plus couramment employé. +@c slur = "il zon" (articulation). jcm +@c phrasing slur = "ils ont des chapeaux ronds" (phrase). jcm -Glossaire musical : @rglos{slur}. +Glossaire musical : @rglos{slur}, @rglos{phrasing}. Une liaison d'articulation ou @emph{legato} peut englober plusieurs notes. Les notes de départ et d'arrivée sont suivies @@ -773,9 +888,9 @@ d4( c16) cis( d e c cis d) e( d4) De plus longues liaisons, dites de phrasé, sont délimitées par @code{\(} et @code{\)}. Il est possible d'avoir en même temps des legatos et des -phrasés, mais pas plusieurs liaisons de phrasé ou de legato à la fois. +phrasés, mais pas plusieurs liaisons de phrasé ou de @emph{legato} à la fois. -@lilypond[quote,ragged-right,verbatim,fragment,relative=2] +@lilypond[verbatim,quote,relative=2] a8(\( ais b c) cis2 b'2 a4 cis,\) @end lilypond @@ -789,19 +904,20 @@ Glossaire musical : @rglos{articulation}, @rglos{slur}, @rglos{tie}. Une liaison d'articulation ou de phrasé ressemble à une liaison de prolongation, mais n'a pas la même signification. Alors qu'une liaison de prolongation ne peut relier que deux notes de même hauteur, -le legato indique une articulation de plusieurs notes, éventuellement -en grand nombre. Les liaisons de tenue peuvent être enchâssées dans -un legato ou un phrasé. +le @emph{legato} indique une articulation de plusieurs notes, +éventuellement en grand nombre. Les liaisons de tenue peuvent être +enchâssées dans un @emph{legato} ou un phrasé. -@lilypond[quote,ragged-right,verbatim,fragment,relative=2] +@lilypond[verbatim,quote,relative=2] c2~( c8 fis fis4 ~ fis2 g2) @end lilypond -@seealso +@seealso Manuel de notation : @ruser{Ties}, @ruser{Slurs}, @ruser{Phrasing slurs}. + @node Articulation and dynamics @subsection Articulation and dynamics @@ -815,42 +931,58 @@ Glossaire musical : @rglos{articulation}. Des @notation{articulations} peuvent être ajoutées à une note, au moyen d'un tiret @code{-} suivi d'un caractère : -@lilypond[quote,ragged-right,verbatim,fragment,relative=2] +@lilypond[verbatim,quote,relative=2] c-. c-- c-> c-^ c-+ c-_ @end lilypond @cindex doigtés @subheading Fingerings +@funindex ^ +@funindex _ + Glossaire musical : @rglos{fingering}. De même, des indications de doigté peuvent être ajoutées à une note en utilisant un tiret (@samp{-}) et le chiffre à écrire : -@lilypond[quote,ragged-right,verbatim,fragment,relative=2] +@lilypond[verbatim,quote,relative=2] c-3 e-5 b-2 a-1 @end lilypond Articulations et doigtés sont habituellement placés automatiquement, -mais vous pouvez indiquer une direction en utilisant @samp{^} (en +mais vous pouvez spécifier leur positionnement en utilisant @samp{^} (en haut) ou @samp{_} (en bas). Vous pouvez aussi utiliser plusieurs articulations sur la même note. Dans la plupart des cas, cependant, il est bon de laisser LilyPond déterminer l'emplacement de l'articulation. -@lilypond[quote,ragged-right,verbatim,fragment,relative=2] +@lilypond[verbatim,quote,relative=2] c_-^1 d^. f^4_2-> e^-_+ @end lilypond @subheading Dynamics +@funindex \f +@funindex \ff +@funindex \mp +@funindex \p +@funindex \mf +@funindex \pp +@funindex \< +@funindex < +@funindex \> +@funindex > +@funindex \! +@funindex ! + Glossaire musical : @rglos{dynamics}, @rglos{crescendo}, @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 @samp{\} : -@lilypond[quote,ragged-right,verbatim,fragment,relative=2] +@lilypond[verbatim,quote,relative=2] c\ff c\mf c\p c\pp @end lilypond @@ -866,12 +998,12 @@ commandes @code{\<} et @code{\>}. Ils se terminent soit par une nuance d'arrivée, par exemple @code{\f}, soit par la commande @code{\!} : -@lilypond[quote,ragged-right,verbatim,fragment,relative=2] +@lilypond[verbatim,quote,relative=2] c2\< c2\ff\> c2 c2\! @end lilypond -@seealso +@seealso Manuel de notation : @ruser{Articulations and ornamentations}, @ruser{Fingering instructions}, @ruser{Dynamics}. @@ -879,6 +1011,13 @@ Manuel de notation : @ruser{Articulations and ornamentations}, @node Adding text @subsection Adding text +@cindex texte, ajout de +@cindex ajout de texte +@cindex étiquette + +@funindex \markup +@funindex markup + On peut ajouter du texte à une partition : @lilypond[verbatim,quote,relative=2] @@ -894,21 +1033,32 @@ a1_\markup{ } @end lilypond -@seealso +@seealso Manuel de notation : @ruser{Writing text}. @node Automatic and manual beams @subsection Automatic and manual beams +@cindex lihature +@cindex ligatures automatiques @cindex ligatures manuelles +@cindex ligatures explicites + +@funindex [ ... ] +@funindex [ +@funindex ] +@funindex \autoBeamOff +@funindex autoBeamOff +@funindex \autoBeamOn +@funindex autoBeamOn Glossaire musical : @rglos{beam}. Toutes les barres de ligature sont dessinées automatiquement : -@lilypond[quote,ragged-right,verbatim,fragment,relative=2] +@lilypond[verbatim,quote,relative=2] a8 ais d ees r d c16 b a8 @end lilypond @@ -918,11 +1068,11 @@ groupées, il est possible de les ligaturer manuellement, en marquant la première note à attacher d'un crochet ouvrant @code{[} et la dernière d'un crochet fermant @code{]}. -@lilypond[quote,ragged-right,verbatim,fragment,relative=2] +@lilypond[verbatim,quote,relative=2] a8[ ais] d[ ees r d] a b @end lilypond -Pour désactiver les barres de ligature automatqiues pour des passages +Pour désactiver les barres de ligature automatiques pour des passages entiers, utilisez la commande @code{\autoBeamOff}, et utilisez @code{\autoBeamOn} pour les réactiver. @@ -933,18 +1083,22 @@ a8 c b4 d8. c16 b4 a8 c b4 d8. c16 b4 @end lilypond -@seealso +@seealso Manuel de notation : @ruser{Automatic beams}, @ruser{Manual beams}. @node Advanced rhythmic commands @subsection Advanced rhythmic commands +@subheading Partial measure + @cindex levée @cindex anacrouse @cindex mesure incomplète -@subheading Partial measure + +@funindex \partial +@funindex partial Glossaire musical : @rglos{anacrusis}. @@ -952,14 +1106,18 @@ On crée une levée (ou anacrouse) avec la commande @code{\partial}, suivie d'une durée : @code{\partial 4} produit une levée d'une noire et @code{\partial 8} d'une croche. -@lilypond[quote,ragged-right,verbatim,fragment,relative=2] +@lilypond[verbatim,quote,relative=2] \partial 8 f8 c2 d @end lilypond +@subheading Tuplets + @cindex nolets @cindex triolets -@subheading Tuplets + +@funindex \times +@funindex times Glossaire musical : @rglos{note value}, @rglos{triplet}. @@ -970,18 +1128,26 @@ 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 : -@lilypond[quote,ragged-right,verbatim,fragment,relative=2] +@lilypond[verbatim,quote,relative=2] \times 2/3 { f8 g a } \times 2/3 { c r c } \times 2/3 { f,8 g16[ a g a] } \times 2/3 { d4 a8 } @end lilypond +@subheading Grace notes + @cindex notes d'ornement @cindex ornementation @cindex appoggiature @cindex acciaccature -@subheading Grace notes + +@funindex \grace +@funindex grace +@funindex \acciaccatura +@funindex acciaccatura +@funindex \appoggiatura +@funindex acciaccatura Glossaire musical : @rglos{grace notes}, @rglos{acciaccatura}, @rglos{appoggiatura}. @@ -990,14 +1156,14 @@ Des @notation{notes d'ornement} s'obtiennent en appliquant la commande @code{\grace}, @code{\appoggiatura} ou @code{\acciaccatura} à une expression musicale : -@lilypond[quote,ragged-right,verbatim,fragment,relative=2] +@lilypond[verbatim,quote,relative=2] c2 \grace { a32[ b] } c2 c2 \appoggiatura b16 c2 c2 \acciaccatura b16 c2 @end lilypond -@seealso +@seealso Manuel de notation : @ruser{Grace notes}, @ruser{Tuplets}, @ruser{Upbeats}. @@ -1031,7 +1197,7 @@ 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 : -@lilypond[quote,ragged-right,verbatim,fragment,relative=2] +@lilypond[verbatim,quote,relative=2] a4 @end lilypond @@ -1039,7 +1205,7 @@ 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 : -@lilypond[quote,ragged-right,verbatim,fragment,relative=2] +@lilypond[verbatim,quote,relative=2] { a4 g4 } @end lilypond @@ -1050,13 +1216,14 @@ 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 : -@lilypond[quote,ragged-right,verbatim,fragment,relative=2] +@lilypond[verbatim,quote,relative=2] { { a4 g } f g } @end lilypond -@cindex expression @subheading Analogy: mathematical expressions +@cindex expression + 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 @@ -1085,6 +1252,20 @@ de la musique polyphonique. @subheading Simultaneous music expressions: multiple staves +@cindex portées multiples +@cindex polyphonie +@cindex combinaison d'expressions en parallèle +@cindex parallèles, expressions +@cindex expressions parallèles +@cindex hauteur relative et musique simultanée +@cindex musique simultanée et hauteur relative +@cindex hauteur relative et expressions parallèles +@cindex expressions parallèles et hauteur relative + +@funindex << +@funindex >> +@funindex << ... >> + Glossaire musical : @rglos{polyphony}. Cette technique est utile pour de la musique @notation{polyphonique}. @@ -1096,7 +1277,7 @@ combinaison simultanée de deux expressions. Une expression musicale et @code{>>}. Dans l'exemple suivant, trois expressions (contenant chacune deux notes distinctes) sont combinées simultanément. -@lilypond[quote,ragged-right,verbatim] +@lilypond[verbatim,quote] \relative c'' { << { a4 g } @@ -1122,7 +1303,7 @@ de la première expression. Si c'est une seule note, une seule portée est produite ; si c'est une expression simultanée, plusieurs portées sont produites. -@lilypond[quote,ragged-right,verbatim] +@lilypond[verbatim,quote] \relative c'' { c2 <> << { e f } { c <> } >> @@ -1133,6 +1314,22 @@ sont produites. @node Multiple staves @subsection Multiple staves +@cindex multiples portées +@cindex portées multiples +@cindex contexte +@cindex contexte de notation +@cindex notation, contexte + +@funindex \new Staff +@funindex new Staff +@funindex Staff +@funindex \new +@funindex new +@funindex Score +@funindex Voice +@funindex Lyrics +@funindex ChordNames + Comme nous l'avons vu dans @ref{Music expressions explained}, un fichier d'entrée LilyPond est fait d'expressions musicales. Si la partition commence par plusieurs expressions simultanées, LilyPond @@ -1145,7 +1342,7 @@ chaque partie de la musique constituant une portée. Ces éléments @code{Staff} sont ensuite combinés en parallèle avec @code{<<} et @code{>>}, comme ci-dessous. -@lilypond[quote,ragged-right,verbatim] +@lilypond[verbatim,quote] \relative c'' { << \new Staff { \clef treble c } @@ -1176,7 +1373,7 @@ mathématiques. La formule @math{(4+5)} est une expression, donc Les chiffres de métrique indiqués sur une portée affectent toutes les autres portées@footnote{Ce comportement peut être modifié si -nécessaire, voir @ruser{Polymetric notation}.}. En revanche l'armure +nécessaire, voir @ruser{Polymetric notation}}. En revanche l'armure d'une portée n'affecte @emph{pas} les autres portées. Ces caractéristiques par défaut se justifient par le fait que l'utilisation d'instruments transpositeurs est bien plus fréquente que @@ -1185,8 +1382,8 @@ la musique polyrythmique. @lilypond[verbatim,quote] \relative c'' { << - \new Staff { \clef treble \time 3/4 c } - \new Staff { \clef bass \key d \major c,, } + \new Staff { \clef treble \key d \major \time 3/4 c } + \new Staff { \clef bass c,, } >> } @end lilypond @@ -1199,6 +1396,15 @@ la musique polyrythmique. @cindex portée pour piano @cindex piano, portée pour @cindex clavier, portée pour +@cindex chœur, système pour +@cindex système pour chœur +@cindex système +@cindex portées, regroupement de +@cindex regroupement de portées + +@funindex PianoStaff +@funindex GrandStaff +@funindex ChoirStaff Glossaire musical : @rglos{brace}. @@ -1217,7 +1423,7 @@ maintenant cette expression entière est interprétée dans un contexte Voici un bref exemple : -@lilypond[quote,ragged-right,verbatim] +@lilypond[verbatim,quote] \relative c'' { \new PianoStaff << \new Staff { \time 2/4 c4 e g g, } @@ -1226,9 +1432,9 @@ Voici un bref exemple : } @end lilypond -@seealso -Manuel de notation : @ruser{Keyboard instruments}, +@seealso +Manuel de notation : @ruser{Keyboard and other multi-staff instruments}, @ruser{Displaying staves}. @@ -1236,6 +1442,11 @@ Manuel de notation : @ruser{Keyboard instruments}, @subsection Combining notes into chords @cindex accords, notes simultanées +@cindex accords et durée + +@funindex < +@funindex > +@funindex < ... > Glossaire musical : @rglos{chord}. @@ -1250,7 +1461,7 @@ r4 4 2 @end lilypond Beaucoup d'éléments de notation que l'on peut attacher à une note -simple, comme une liaison, un crochet indiquat un début ou fin de +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 : il faut ajouter ces indications après les hauteurs et la durée, donc @emph{à l'extérieur} des angles. @@ -1266,6 +1477,14 @@ r4 8( \> 4 \!) @cindex polyphonie @cindex voix multiples sur une portée +@cindex silence invisible +@cindex invisible, silence + +@funindex << ... \\ ... >> +@funindex << +@funindex \\ +@funindex >> + Quand différentes lignes mélodiques sont combinées sur une seule et même portée, elles sont imprimées comme des voix polyphoniques ; chaque voix a ses propre hampes@footnote{familièrement appelées queues de note.}, @@ -1273,10 +1492,10 @@ liaisons et ligatures, la voix supérieure ayant les hampes vers le haut, la voix inférieure vers le bas. On réalise ce type de partition en entrant chaque voix comme une -séquence, @emph{i.e.} avec @code{@{...@}}, puis en combinant +séquence, autrement dit avec @code{@{...@}}, puis en combinant simultanément les voix et en les séparant par @code{\\}. -@lilypond[quote,ragged-right,verbatim,fragment,relative=2] +@lilypond[verbatim,quote,relative=2] << { a4 g2 f4~ f4 } \\ { r4 g4 f2 f4 } @@ -1287,9 +1506,9 @@ Pour l'écriture de musique polyphonique, les silences invisibles s'avèrent bien pratiques : ce sont des silences qui ne s'impriment pas. Ils sont utiles pour remplir des voix qui, temporairement, ne jouent rien. Voici le même exemple que ci-dessus, avec un silence invisible -@code{s} à la place d'un silence normal @code{r} : +@code{s} (pour @emph{skip}) à la place d'un silence normal @code{r} : -@lilypond[quote,ragged-right,verbatim,fragment,relative=2] +@lilypond[verbatim,quote,relative=2] << { a4 g2 f4~ f4 } \\ { s4 g4 f2 f4 } @@ -1299,7 +1518,7 @@ rien. Voici le même exemple que ci-dessus, avec un silence invisible @noindent Là encore, ces expressions peuvent s'imbriquer arbitrairement : -@lilypond[quote,fragment,verbatim,relative=2,fragment] +@lilypond[verbatim,quote,relative=2] << \new Staff << { a4 g2 f4~ f4 } \\ @@ -1313,8 +1532,8 @@ Là encore, ces expressions peuvent s'imbriquer arbitrairement : >> @end lilypond -@seealso +@seealso Manuel de notation : @ruser{Simultaneous notes}. @@ -1336,15 +1555,19 @@ Cette section présente l'écriture vocale et les partitions de variété. @cindex paroles @cindex chansons +@funindex \addlyrics +@funindex addlyrics + Glossaire musical : @rglos{lyrics}. Prenons une mélodie toute simple, la comptine @emph{Girls and boys come out to play}. -@lilypond[quote,ragged-right,verbatim] +@lilypond[verbatim,quote] \relative c'' { - a4 e c8 e r4 - b2 c4( d) + \key g \major + \time 6/8 + d4 b8 c4 a8 d4 b8 g4 } @end lilypond @@ -1352,13 +1575,16 @@ 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 un espace : -@lilypond[quote,ragged-right,verbatim] +@lilypond[verbatim,quote] << \relative c'' { - a4 e c8 e r4 - b2 c4( d) + \key g \major + \time 6/8 + d4 b8 c4 a8 d4 b8 g4 + } + \addlyrics { + Girls and boys come out to play, } - \addlyrics { One day this shall be free } >> @end lilypond @@ -1375,6 +1601,10 @@ produisent en même temps. @cindex ligne d'extension @cindex trait d'union (paroles) @cindex caractère souligné (paroles) +@cindex paroles, alignement des +@cindex alignement des paroles +@cindex paroles, mot de plusieurs syllabes + Glossaire musical : @rglos{melisma}, @rglos{extender line}. La ligne suivante de la comptine précédente est @emph{The moon doth @@ -1527,14 +1757,17 @@ la syllabe @emph{al} est chantée sur la même note que @emph{go}. >> @end lilypond -@seealso +@seealso Manuel de notation : @ruser{Vocal music}. @node Lyrics to multiple staves @subsection Lyrics to multiple staves +@cindex paroles et portées mutiples +@cindex portées multiples et paroles + La méthode simple d'ajout de paroles avec @code{\addlyrics} peut être également utilisée pour placer des paroles sous plusieurs portées. L'exemple suivant est extrait de @emph{Judas Macchabée} de Händel. @@ -1567,12 +1800,11 @@ 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{Organizing pieces with variables}. -@seealso +@seealso Manuel de notation : @ruser{Vocal music}. - @node Final touches @section Final touches @@ -1592,6 +1824,16 @@ du manuel. @node Organizing pieces with variables @subsection Organizing pieces with variables +@cindex variables +@cindex variables, definition +@cindex identificateurs +@cindex macros +@cindex assignation de variables +@cindex utilisation de variables +@cindex variables, utilisation de +@cindex variables, caractères autorisés dans les +@cindex caractères autorisés dans les variables + Lorsque l'on combine tous les éléments étudiés précédemment pour écrire des partitions plus longues, les expressions musicales prennent de l'ampleur et, dans le cas des pièces polyphoniques, deviennent @@ -1613,14 +1855,18 @@ c'est-à-dire @code{\musiqueToto}, tout comme n'importe quelle commande LilyPond. Toute variable doit être définie @emph{avant} son utilisation dans une autre expression musicale. -@lilypond[quote,verbatim,ragged-right] -violin = \new Staff { \relative c'' { - a4 b c b -}} -cello = \new Staff { \relative c { - \clef bass - e2 d -}} +@lilypond[verbatim,quote] +violin = \new Staff { + \relative c'' { + a4 b c b + } +} +cello = \new Staff { + \relative c { + \clef bass + e2 d + } +} { << \violin @@ -1671,7 +1917,19 @@ ci-dessus. @node Version number @subsection Version number -@cindex versions +@cindex version +@cindex versionage +@cindex numéro de version +@cindex version, numéro de +@cindex mise à jour +@cindex future mise à jour +@cindex mise à jour de fichiers +@cindex fichiers, mise à jour de + +@funindex \version +@funindex version +@funindex convert-ly + La déclaration @code{\version} stipule le numéro de la version de LilyPond pour laquelle le fichier a été écrit : @@ -1686,15 +1944,22 @@ Cette instruction permet de faciliter les mises à jour futures de LilyPond. Les changements de syntaxe au fil des versions sont gérés avec un programme dédié, @command{convert-ly}, qui utilise la valeur de @code{\version} pour déterminer les règles de conversion à -appliquer au fichier source. Pour plus d'informations, consultez voir +appliquer au fichier source. Pour plus d'informations, consultez @rprogram{Updating files with convert-ly}. @node Adding titles @subsection Adding titles +@cindex titre +@cindex en-têtes +@cindex bloc d'en-tête + +@funindex \header +@funindex header + On indique les informations bibliographiques --- nom du morceau, du -compositeur, numéro d'opus... --- dans un bloc à part, le bloc +compositeur, numéro d'opus@dots{} --- dans un bloc à part, le bloc d'en-tête @code{\header}, qui existe indépendamment de l'expression musicale principale. Le bloc @code{\header} est habituellement placé en début de fichier, après le numéro de version. @@ -1720,6 +1985,12 @@ sur les titres à la section @ruser{Creating titles}. @node Absolute note names @subsection Absolute note names +@cindex notes, nom des +@cindex absolu, mode +@cindex mode absolu +@cindex hauteurs, valeurs absolues +@cindex noms de note absolus + 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 @@ -1731,7 +2002,7 @@ toujours le do central, un @code{b} se situe une seconde en dessous du do central, et un @code{g,} est situé sur la première ligne de la portée en clé de fa. -@lilypond[quote,verbatim,ragged-right] +@lilypond[verbatim,quote] { \clef bass c' b g, g, @@ -1741,7 +2012,7 @@ la portée en clé de fa. Voici une gamme sur 4 octaves : -@lilypond[quote,verbatim,ragged-right] +@lilypond[verbatim,quote] { \clef bass c, d, e, f, @@ -1760,7 +2031,7 @@ Comme vous pouvez le voir, il faut beaucoup d'apostrophes pour écrire de la musique dans un registre aigu, comme le montre cet extrait de Mozart. -@lilypond[quote,verbatim,ragged-right] +@lilypond[verbatim,quote] { \key a \major \time 6/8 @@ -1774,7 +2045,7 @@ est très probable d'oublier au moins une apostrophe au cours de la frappe. En mode @code{\relative}, le même exemple devient bien plus facile à lire et à saisir. -@lilypond[quote,verbatim,ragged-right] +@lilypond[verbatim,quote] \relative c'' { \key a \major \time 6/8 @@ -1786,7 +2057,7 @@ facile à lire et à saisir. Si d'aventure vous faites une erreur d'octaviation, le mode @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, donc serait plus +une erreur isolée ne serait pas autant visible, et serait donc plus difficile à dénicher. Cependant, le mode de hauteurs absolues reste utile pour les musiques @@ -1814,9 +2085,16 @@ syntaxe de base de LilyPond. Vous pouvez toujours survoler ces chapitres 3 à 5, et y revenir plus tard après avoir acquis de 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 : 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{About the documentation}. Les sources de documentation et d'information sur LilyPond sont vastes, il est normal pour un débutant 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 recherche infructueuses. +par des heures de recherches infructueuses.