1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
2 @c This file is part of lilypond.tely
4 Translation of GIT committish: 71b67137f76fa4e8aede58299630369f616004d9
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. See TRANSLATION for details.
12 - unless you have a really good reason, use either
13 @l ilypond[quote,ragged-right,verbatim]
15 @l ilypond[quote,ragged-right,verbatim,fragment,relative=2]
17 Don't use any other relative=X commands (make it a non-fragment
18 example), and don't use fragment without relative=2.
19 - use "aes" and "ees" instead of "as" and "aes". I know it's not
20 correct Dutch naming, but let's not confuse people with this until
21 we get to the Basic notation chapter.
26 @c old info that will probably be removed.
28 @c * more details about running lilypond; error messages,
29 @c compiling/viewing (emacs?)
30 @c * where to go from First steps+More basics?
32 @c wherever possible, do not include index entries here; the
33 @c index should point to stuff in the reference manual. -gp
35 @c Your first LilyPond score in 10 minutes?
37 @c Translators: Nicolas Grandclaude, Ludovic Sardain, Gauvain Pocentek
38 @c Translation checkers: Jean-Charles Malahieude, Valentin Villenave, John Mandereau
44 Ce tutoriel commence par une introduction au langage musical utilisé
45 par LilyPond, qui vous permettra de faire fonctionner le logiciel pour
46 produire une partition. Après ce premier contact, nous verrons comment
47 créer des partitions utilisant une notation musicale courante.
50 Beaucoup de gens apprennent à utiliser les programmes en les essayant
51 et en bidouillant avec. C'est également possible avec LilyPond. Si
52 vous cliquez sur une image dans la version HTML de ce manuel, vous
53 verrez exactement le code LilyPond utilisé pour générer cette image.
54 Essayez sur cette image :
58 @lilypond[quote,ragged-right]
60 c-\markup { \bold \huge { Cliquez ici. } }
64 En copiant et en collant tout le code de l'extrait ly dans un fichier
65 test, vous aurez un modèle de base pour faire vos expériences. Si vous
66 apprenez de cette façon, vous aurez probablement envie d'imprimer ou de
67 garder un lien vers l'@ruser{Cheat sheet}, tableau qui répertorie les
68 commandes usuelles pour une consultation rapide.
73 * Single staff notation::
74 * Multiple notes at once::
83 Cette section présente sommairement la façon de travailler avec LilyPond.
88 * Working on text files::
89 * How to read the tutorial::
93 @node Compiling a file
94 @subsection Compiling a file
96 Le premier exemple montre comment débuter avec LilyPond. Pour créer
97 une partition, on écrit un fichier de texte qui décrit la notation
98 musicale. Par exemple, si l'on écrit
107 le résultat ressemblera à
109 @c in this case we don't want verbatim
110 @lilypond[quote,ragged-right]
117 Il est aussi possible d'utiliser les noms de notes français @samp{do
118 re mi fa sol la si}, en insérant au début du fichier la ligne
119 @samp{\include "italiano.ly"}
122 @emph{Attention :} tout extrait de code LilyPond doit être entouré
123 d'une @{paire d'accolades@}. De plus, pour éviter toute ambiguïté, il
124 est préférable d'entourer les accolades par des espaces ou retours à
125 la ligne. Bien que certains exemples de ce manuel ne comportent pas
126 d'accolades, ne les oubliez pas dans vos partitions !
128 @cindex casse, prise en compte de
129 De plus, LilyPond est sensible à la casse. @code{ @{ c d e @} } est
130 un code valide ; @code{ @{ C D E @} } produira un message d'erreur.
134 @subheading Entering music and viewing output
136 Dans cette section nous expliquerons quelles commandes exécuter et
137 comment voir ou imprimer le résultat de LilyPond.
139 @subsubheading MacOS X
141 Si vous double-cliquez sur @code{LilyPond.app}, un fichier d'exemple
142 s'ouvrira. Sauvegardez-le, par exemple, sous @file{test.ly} sur votre
143 bureau, et traitez-le ensuite avec la commande du menu @samp{Compile >
144 Typeset File}. Le fichier PDF résultant sera alors affiché sur votre
147 Notez que le premier démarrage peut prendre une minute ou deux, car
148 toutes les polices système doivent être d'abord analysées.
150 À l'avenir, vous aurez certainement recours aux commandes @qq{Nouveau}
151 ou @qq{Ouvrir}. Vous devez enregistrer votre fichier avant de lancer
152 la création de la partition. Si une erreur advient pendant le
153 traitement, vous la trouverez dans la fenêtre @qq{log}.
155 @subsubheading Windows
157 Sous Windows, lorsque vous double-cliquez sur l'icône LilyPond qui se
158 trouve sur le Bureau, un fichier d'exemple s'ouvre dans un simple
159 éditeur de texte. Enregistrez-le, par exemple en tant que
160 @file{test.ly} sur votre Bureau, puis double-cliquez sur son icône
161 (qui montre une note de musique) pour le traiter. Après quelques
162 secondes, vous obtiendrez un fichier @file{test.pdf} sur votre Bureau,
163 fichier que vous pourrez ouvrir pour voir la partition imprimée. Une
164 autre méthode pour lancer le traitement du fichier @file{test.ly} est
165 de le glisser avec votre souris sur l'icône de LilyPond.
167 Pour modifier un fichier @file{.ly} existant, faites un clic droit
168 dessus et sélectionnez @qq{Éditer la source}. Pour partir d'un
169 fichier vide, lancez l'éditeur en ouvrant un fichier existant et
170 utilisez la commande @qq{New} du menu @qq{File}.
172 En double-cliquant sur le fichier, vous obtiendrez, en plus du fichier
173 PDF, un fichier @file{.log} qui récapitule les opérations que LilyPond
174 a effectuées sur votre fichier. Si une erreur survient, c'est ce
175 fichier qu'il vous faudra étudier.
177 Notez qu'il existe d'autres éditeurs de texte, certains disposant d'un
178 meilleur support pour LilyPond ; reportez-vous à @rprogram{Text editor support}.
183 Commencez par ouvrir une fenêtre de terminal et un éditeur de
184 texte. Par exemple, vous pouvez ouvrir un xterm et exécuter
185 @code{joe}. @footnote{Il existe des fichiers de macros pour les fans
187 @code{LilyPond-mode} pour les fans d'Emacs. S'ils ne sont pas
188 encore installés, consultez le fichier @file{INSTALL.txt}. L'outil
189 d'édition le plus facile d'utilisation est de loin
190 @file{LilyPondTool}. Vous trouverez plus d'informations dans
191 @rprogram{Text editor support}.} Dans votre
192 éditeur, entrez le texte suivant et sauvegardez le fichier sous
202 Pour traiter @file{test.ly}, procédez comme ceci :
209 Vous verrez quelque chose ressemblant à :
216 Interpreting music... [1]
217 Preprocessing graphical objects...
218 Calculating line breaks... [2]
219 Layout output to `test.ps'...
220 Converting to `test.pdf'...
224 Suivant votre installation, ces messages peuvent être traduits.
228 @cindex visionnage de la musique
231 De tout cela résulte un fichier @file{test.pdf}, que vous pouvez imprimer
232 ou visualiser avec les outils standards de votre système
233 d'exploitation. @footnote{Si votre système ne dispose pas des outils
234 nécessaires, vous pouvez essayer
235 @uref{http://@/www@/.cs@/.wisc@/.edu/@/~ghost/,Ghostscript}, un
236 programme pour afficher et imprimer librement les fichiers PDF et PostScript.}
239 @node Simple notation
240 @subsection Simple notation
242 Il y a certains éléments graphiques que LilyPond ajoute
243 automatiquement. Dans l'exemple suivant, nous n'avons fourni que
244 quatre hauteurs, mais LilyPond a ajouté une clé, un chiffre de mesure
247 @lilypond[quote,ragged-right,verbatim]
254 Ce comportement peut être modifié, mais dans bien des cas ces
255 attributions automatiques s'avèrent utiles.
259 Le moyen le plus simple d'entrer des notes est d'utiliser le mode
260 @code{\relative}. Avec ce mode, l'@rglos{interval} entre la note et
261 celle qui la précède est supposé inférieur ou égal à une
262 @rglos{fourth}. Commençons par entrer la partition la plus
263 élémentaire qui soit, une @rglos{scale}.
265 @lilypond[quote,ragged-right,verbatim]
272 La note de départ est @rglos{middle C}. Chacune des notes qui suivent
273 est à moins d'une quarte de la note précédente --- en d'autres termes,
274 le premier @samp{c} est le do central, entre la clé de sol et
275 la clé de fa, puis est suivi par le ré le plus proche, et ainsi de
276 suite. On peut bien sûr créer des mélodies d'intervalles plus étendus :
278 @lilypond[quote,ragged-right,verbatim]
286 Comme vous l'aurez remarqué, cet exemple ne commence plus sur le do du
287 milieu. La première note --- le @samp{d} --- est le ré qui en est le
290 Pour ajouter des intervalles supérieurs à une quarte, il suffit
291 d'indiquer si la note est à l'octave supérieure ou inférieure, en
292 ajoutant respectivement une apostrophe @code{'} ou une virgule
293 @code{,} au nom de la note.
295 @lilypond[quote,ragged-right,verbatim]
303 Pour déplacer une note deux octaves (ou davantage !) plus haut ou plus
304 bas, il suffit de mettre plusieurs @code{''} ou plusieurs @code{,,} ---
305 attention cependant à bien mettre deux apostrophes @code{''}, et non
306 un guillemet @code{"}@tie{}! C'est de cette même manière que l'on
307 peut modifier la valeur de départ de @code{\relative c'}.
310 @subheading Durations (rhythms)
312 La @rglos{duration} d'une note est indiquée par un nombre
313 qui suit son nom : @samp{1} pour une @rglos{whole
314 note}, @samp{2} pour une @rglos{half note}, @samp{4} pour
315 une @rglos{quarter note} et ainsi de suite. Les hampes sont
316 ajoutées automatiquement.
318 @lilypond[quote,ragged-right,verbatim]
322 a16 a a a a32 a a a a64 a a a a a a a a2
327 Si aucune durée n'est indiquée, la dernière durée entrée sera utilisée
328 pour les notes suivantes. En l'absence d'indication, la première note
331 Une @rglos{dotted note} s'obtient en ajoutant un point @samp{.} à
334 @lilypond[quote,ragged-right,verbatim]
344 On saisit un @rglos{rest} tout comme une note, mais avec le
347 @lilypond[quote,ragged-right,verbatim]
355 @subheading Time signature
357 La @rglos{time signature} peut être définie à l'aide de la commande
360 @lilypond[quote,ragged-right,verbatim]
374 La @rglos{clef} peut être définie à l'aide de la commande @code{\clef} :
376 @lilypond[quote,ragged-right,verbatim]
390 @subheading All together
392 Voici un bref exemple qui montre tous ces éléments ensemble :
394 @lilypond[quote,ragged-right,verbatim]
406 @item Entrer des hauteurs et des durées
407 voir @ruser{Pitches} and @ruser{Durations}.
410 @item Les chiffres de mesure et autres commandes de métrique
411 voir @ruser{Time signature}.
418 @node Working on text files
419 @subsection Working on text files
421 Le traitement des fichiers source de LilyPond est semblable à celui du
422 code de nombreux langages de programmation répandus : la casse est prise
423 en compte, et les caractères considérés comme espaces ont généralement
424 peu d'importance. Les expressions sont délimitées par des accolades @{
425 @}, et les commentaires par @code{%} ou @code{%@{ ... %@}}.
427 Si cette phrase vous paraît incompréhensible, ne vous en faites pas !
428 Tous ces termes vont être expliqués :
432 @cindex casse, prise en compte de
433 @item @strong{La casse} :
434 LilyPond est sensible à la casse, c'est à dire qu'une lettre capitale
435 n'a pas la même valeur qu'une lettre minuscule. Les notes, par
436 exemple, doivent être entrées en minuscules : @code{@{ c d e @}} est
437 un code valide, alors que @code{@{ C D E @}} produira un message
440 @item @strong{Les espaces multiples} :
441 LilyPond ne tient pas compte du nombre d'espaces, ou de retours à la
442 ligne. @code{@{ c d e @}} a le
443 même sens que @code{@{ c @tie{} @tie{} d @tie{} e @}} ou que
451 Bien sûr, ce dernier exemple est difficile à lire. Une bonne habitude
452 à prendre est d'indenter les blocs de code avec soit des tabulations
453 soit des doubles espaces :
460 @item @strong{Expressions musicales} :
461 Tout morceau saisi dans LilyPond doit être placé entre @strong{@{
462 accolades @}}. Ces caractères indiquent à LilyPond que ce bloc de
463 texte est une et une seule expression musicale, tout comme les
464 parenthèses @samp{()} en mathématiques. Il est préférable, pour
465 éviter toute ambiguïté, d'entourer tous ces crochets d'espaces, à
466 moins qu'ils se trouvent au début ou à la fin d'une ligne.
468 Une fonction --- @code{\relative @{ @}} par exemple --- compte
469 également comme une seule expression musicale.
472 @cindex commentaire de fin de ligne
473 @cindex commentaire-bloc
474 @item @strong{Les commentaires} :
475 Un commentaire est une indication pour tout lecteur humain d'un
476 fichier de musique ; il est ignoré par l'ordinateur, et n'a donc aucun
477 effet sur la partition imprimée. On distingue deux types de
480 @item la ligne de commentaire, introduite par le symbole @samp{%} :
481 tout ce qui suit ce symbole sur cette ligne sera ignoré.
482 @item le bloc de commentaire, qui peut être de plusieurs lignes voire
483 de toute une section : tout ce qui se trouve entre @code{%@{} et
484 @code{%@}} est ignoré. Les blocs de commentaires ne peuvent s'imbriquer.
486 Le fragment suivant met en évidence quelques usages possibles des commentaires :
489 % voici les notes de "ah vous dirai-je maman"
493 Ces lignes et les notes qui suivent
494 seront ignorées, car elles se trouvent
495 dans un bloc de commentaire.
503 Vous trouverez plus d'astuces pour organiser vos fichiers LilyPond dans
504 @ruser{Suggestions for writing LilyPond files}.
507 @node How to read the tutorial
508 @subsection How to read the tutorial
510 Comme nous l'avons vu dans @ruser{Working on text files}, un code
511 LilyPond doit être encadré par des @{ @} ou bien par @code{\relative
512 c'' @{ ... @}} afin d'être compris. Cependant, dans la suite de ce
513 manuel, la plupart des exemples ne feront pas apparaître ces signes.
515 Si vous consultez la documentation au format HTML, et que vous
516 souhaitez voir la source exacte d'un exemple, il vous suffit de
517 cliquer sur l'image. Si vous ne disposez pas de la version HTML, il
518 vous est possible de simplement copier et coller le code affiché, mais
519 @strong{à condition} d'ajouter @code{\relative c'' @{ @}} de la façon
524 ... collez ici votre exemple...
528 Pourquoi avoir omis les accolades ? La plupart des exemples de ce
529 manuel peuvent être insérés au milieu d'un morceau de musique plus
530 long. Il n'y a donc aucune raison d'ajouter @code{\relative c'' @{
531 @}} à ces exemples --- en effet, il n'est pas possible d'insérer un
532 @code{\relative} à l'intérieur d'un autre @code{\relative}. Il vous
533 serait donc devenu impossible de copier un bref exemple de la
534 documentation et de le coller dans une pièce de votre cru.
536 @node Single staff notation
537 @section Single staff notation
539 Cette section présente la notation courante dont on a besoin pour
540 écrire une seule voix sur une seule portée.
543 * Relative note names::
544 * Accidentals and key signatures::
546 * Articulation and dynamics::
547 * Automatic and manual beams::
548 * Advanced rhythmic commands::
552 @node Relative note names
553 @subsection Relative note names
555 Comme nous l'avons vu dans @ruser{Simple notation}, LilyPond calcule la
556 hauteur de chaque note en fonction de la précédente@footnote{Il existe
557 un autre mode de saisie des hauteurs, le mode @ruser{Absolute note
558 names}, mais en pratique il est bien plus aisé et sûr d'avoir recours
559 au mode de hauteurs relatives.}. Si aucune indication supplémentaire
560 d'octaviation n'est ajoutée, il en concluera que chaque hauteur est
561 située à une quarte au plus de la note précédente.
563 Lilypond tient compte des intervalles induits par les noms des notes
564 --- en d'autres termes, une quarte augmentée n'est @emph{pas}
565 équivalente à une quinte diminuée. Ainsi, si l'on part d'un Do, un Fa
566 dièse sera placé au-dessus, tandis qu'un Sol bémol sera placé
569 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
577 @item Les hauteurs de note relatives
578 voir @ruser{Relative octaves}.
579 @item Les vérifications d'octaves
580 voir @ruser{Octave check}.
586 @node Accidentals and key signatures
587 @subsection Accidentals and key signatures
589 @subheading Accidentals
591 Dans la notation par défaut, un @rglos{sharp} s'obtient en ajoutant
592 @samp{is} au nom de la note, et un @rglos{flat} en ajoutant @samp{es}.
593 Comme vous pouvez vous y attendre, un double dièse ou double bémol est
594 alors obtenu en ajoutant @samp{isis} ou @samp{eses}@footnote{Cette
595 syntaxe est dérivée de la convention de dénomination des notes dans
596 les langues nordiques et germaniques, comme l'allemand ou le
600 Cependant, si vous utilisez la commande @samp{\include "italiano.ly"}
601 pour entrer les noms de notes français au lieu des noms hollandais, il
602 faudra ajouter un @samp{d} pour un dièse, et un @samp{b} pour un
603 bémol. Le double dièse et le double bémol s'obtiennent en ajoutant
604 respectivement @samp{dd} et @samp{bb}
607 Pour en savoir plus sur les autres langues disponibles, voir @ruser{Note
608 names in other languages}.
610 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
611 cis1 ees fisis, aeses
614 @cindex armure, définition de
615 @subheading Key signatures
617 L'armure est déterminée par la commande @code{\key}, suivie d'une
618 hauteur puis de @code{\major} (majeur) ou @code{\minor} (mineur) :
620 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
629 @subheading Warning: key signatures and pitches
631 La combinaison de l'armure et des hauteurs de note --- y compris les
632 altérations --- permet à LilyPond de déterminer dans quel cas afficher
633 les altérations accidentelles. L'armure n'affecte que les altérations
634 @emph{imprimées}, et non les hauteurs réelles ! Cette fonctionnalité
635 est souvent source de confusion pour les nouveaux utilisateurs, aussi
636 expliquons-la en détail.
638 LilyPond fait une nette distinction entre le contenu musical et la
639 mise en forme. L'altération d'une note --- bémol, bécarre ou dièse
640 --- fait partie de sa hauteur, et relève donc du contenu musical. La
641 présence ou non d'une altération accidentelle --- un @emph{signe}
642 bémol, bécarre ou dièse --- devant la note correspondante est une
643 question qui relève de la mise en page. Mettre en page une partition
644 se fait selon des règles ; les altérations accidentelles seront donc
645 automatiquement imprimées suivant ces règles. Les hauteurs de note,
646 en revanche, relèvent de ce que vous voulez entendre ; et, dans la
647 mesure où la musique que vous entrez est censée être celle que vous
648 voulez entendre, LilyPond (qui n'est chargé que de la gravure) ne les
649 choisira pas à votre place.
653 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
659 aucune note n'a d'altération accidentelle, et pourtant vous devrez
660 entrer le @samp{is} pour les notes @code{cis} et @code{fis}.
662 Le code @samp{d} ne veut pas dire @qq{Imprimez-moi un point noir juste
663 en-dessous de la portée.} Cela signifie plutôt : @qq{Ici se trouve
665 hauteur est un ré naturel.} Avec l'armure de la bémol majeur, ce ré
667 d'un bécarre accidentel :
669 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
674 Ajouter explicitement toutes les altérations requiert un peu plus
675 d'effort dans la phase de saisie, mais la transposition en sera
676 grandement facilitée.
677 De plus les altérations accidentelles
678 peuvent être imprimées suivant plusieurs conventions. Regardez
679 @ruser{Automatic accidentals} pour connaître les différentes manières dont les
680 altérations accidentelles peuvent être imprimées, suivant les règles
686 @item Les altérations
687 voir @ruser{Accidentals} and @ruser{Automatic accidentals}.
689 voir @ruser{Key signature}.
695 @subsection Ties and slurs
697 @cindex liaisons de prolongation
699 Une @rglos{tie}@footnote{parfois aussi appelée liaison de
700 tenue} se crée en ajoutant un tilde @samp{~} à la première note liée.
702 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
707 @cindex liaisons d'articulation
710 @c Le terme de "slur" a deux sens en français : articulation et phrasé.
711 @c Je garde ici le terme "legato", tel qu'il apparaît dans le texte original,
712 @c car c'est celui qui me semble le plus couramment employé.
714 Une @rglos{slur} d'articulation (ou @qq{legato}) peut englober
715 plusieurs notes. Les notes de départ et d'arrivée reçoivent
716 respectivement un signe @samp{(} et @samp{)}.
718 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
719 d4( c16) cis( d e c cis d) e( d4)
722 @cindex liaisons de phrasé
723 @subheading Phrasing slurs
725 De plus longues liaisons, dites de phrasé, sont délimitées par @code{\(} et
726 @code{\)}. Il est possible d'avoir en même temps des legatos et des
727 phrasés, mais pas plusieurs liaisons de phrasé ou de legato à la fois.
729 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
730 a8(\( ais b c) cis2 b'2 a4 cis,\)
735 @cindex liaisons de phrasé et de prolongation, différences
736 @subheading Warnings: slurs vs. ties
738 Une liaison d'articulation ou de phrasé ressemble à une liaison de
739 tenue, mais n'a pas la même signification. Alors qu'une liaison de
740 tenue ne peut relier que deux notes de même hauteur, le legato indique
741 une articulation de plusieurs notes, éventuellement nombreuses. Les
742 liaisons de tenue peuvent être enchâssées dans un legato ou un phrasé.
744 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
745 c2~( c8 fis fis4 ~ fis2 g2)
753 @item @ruser{Phrasing slurs}.
758 @node Articulation and dynamics
759 @subsection Articulation and dynamics
764 @subheading Articulations
766 Des @rglos{articulation}s peuvent être ajoutées à une note, au moyen
767 d'un tiret @samp{-} suivi d'un caractère :
769 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
770 c-. c-- c-> c-^ c-+ c-_
774 @subheading Fingerings
775 De même, des indications de doigté peuvent être ajoutées à une note en
776 utilisant un tiret (@samp{-}) et le chiffre à écrire :
778 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
782 Articulations et doigtés sont habituellement placés automatiquement,
783 mais vous pouvez spécifier une direction en utilisant @samp{^} (en haut)
784 ou @samp{_} (en bas). Vous pouvez aussi utiliser plusieurs
785 articulations sur la même note. Dans la plupart des cas, cependant, il
786 est mieux de laisser LilyPond déterminer l'emplacement de
789 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
790 c_-^1 d^. f^4_2-> e^-_+
794 Les signes de nuances sont obtenus en ajoutant à la note les noms des nuances,
795 précédées d'un anti-slash @samp{\} :
797 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
805 @c Pluriel des termes musicaux italiens :
806 @c selon Littré, plutôt à la française (en "-os" qu'en "-i")
808 Crescendos et decrescendos débutent avec les commandes @code{\<} et
809 @code{\>}. Ils se terminent soit par une nuance d'arrivée, par exemple
810 @code{\f}, soit par la commande @code{\!} :
812 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
819 @item @ruser{Articulations}.
820 @item @ruser{Fingering instructions}.
821 @item @ruser{Dynamics}.
826 @node Automatic and manual beams
827 @subsection Automatic and manual beams
829 @cindex ligatures manuelles
830 Toutes les @rglos{beam} sont dessinées automatiquement :
832 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
833 a8 ais d ees r d c16 b a8
837 Lorsqu'on n'aime pas la manière dont les notes sont automatiquement
838 groupées, il est possible de les ligaturer manuellement, en marquant la
839 première note à attacher d'un @samp{[} et la dernière d'un @samp{]}.
841 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
842 a8[ ais] d[ ees r d] a b
848 @item Groupements de notes et ligatures automatiques
849 voir @ruser{Automatic beams}.
850 @item Groupements et ligatures manuels
851 voir @ruser{Manual beams}.
856 @node Advanced rhythmic commands
857 @subsection Advanced rhythmic commands
861 @cindex mesure incomplète
862 @subheading Partial measure
864 Une levée (ou @rglos{anacrusis}) est entrée avec la commande
865 @code{\partial}, suivie d'une durée : @code{\partial 4} est une levée
866 d'une noire et @code{\partial 8} d'une croche.
868 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
876 Les nolets sont créés avec la commande @code{\times}, qui prend deux
877 arguments : une fraction et une expression musicale. La durée des notes
878 de l'expression musicale est multipliée par la fraction. Par exemple
879 les notes d'un triolet durent les deux tiers du temps de leur notation
880 réelle, cette fraction est donc de 2/3 pour les triolets :
882 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
883 \times 2/3 { f8 g a }
885 \times 2/3 { f,8 g16[ a g a] }
889 @cindex notes d'ornement
890 @cindex ornementation
892 @subheading Grace notes
894 Des notes d'ornement sont produites par la commande @code{\grace}, mais
895 aussi en préfixant une expression musicale avec le mot-clé
896 @code{\appoggiatura} ou @code{\acciaccatura} :
898 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
899 c2 \grace { a32[ b] } c2
900 c2 \appoggiatura b16 c2
901 c2 \acciaccatura b16 c2
907 @item Notes d'ornement
908 voir @ruser{Grace notes},
910 voir @ruser{Tuplets},
912 voir @ruser{Partial measures}.
917 @node Multiple notes at once
918 @section Multiple notes at once
920 Cette section traite des situations où l'on a plus d'une note à la fois
921 : plusieurs instruments, plusieurs portées pour un même instrument (le
922 piano, par exemple), et les accords.
924 La polyphonie, en théorie musicale, est la notion d'une musique
925 constituée de plusieurs voix ; dans lilypond, ce terme désigne les
926 situations où il y a plus d'une voix sur une même portée.
929 * Music expressions explained::
932 * Combining notes into chords::
933 * Single staff polyphony::
937 @node Music expressions explained
938 @subsection Music expressions explained
940 Dans les fichiers source LilyPond, la musique est représentée par ce
941 qu'on appelle des @emph{expressions musicales}. En soi, une seule note
942 peut constituer une expression musicale, si tant est qu'elle soit
943 correctement encadrée :
945 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
949 Mettre un groupe de notes entre accolades crée une nouvelle expression
952 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
956 Placer une séquence d'expressions musicales --- des notes par exemple
957 --- entre accolades signifie qu'elles doivent être jouées
958 successivement, les unes après les autres. Le résultat est une
959 expression, qui peut elle-même être regroupée séquentiellement avec
960 d'autres expressions. Ici, l'expression de l'exemple précédent est
961 combinée à deux notes :
963 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
967 @subheading Simultaneous music expressions: multiple staves
969 Cette technique est utile pour de la musique polyphonique. Pour entrer
970 une musique avec plusieurs voix ou plusieurs portées, nous pouvons aussi
971 combiner en parallèle les expressions. Deux voix qui doivent être
972 jouées en même temps, sont entrées comme une combinaison simultanée de
973 deux expressions. Une expression musicale @q{simultanée} est formée en
974 entourant les expressions entre @code{<<} et @code{>>}. Dans l'exemple
975 suivant, trois expressions (contenant chacune deux notes distinctes)
976 sont combinées simultanément.
978 @lilypond[quote,ragged-right,verbatim]
988 Notez que nous avons ici indenté chaque niveau du fichier d'entrée avec
989 un nombre d'espaces différent. LilyPond se moque de l'espace qu'il peut
990 y avoir (ou pas) au début d'une ligne, mais en indentant votre code vous
991 le rendrez bien plus facile à lire pour les humains.
993 @strong{Attention} : chaque note saisie est relative à la précédente,
994 mais pas au @code{c''} de la commande @code{\relative} de départ.
997 @subheading Simultaneous music expressions: single staff
999 Pour déterminer le nombre de portées, LilyPond regarde le premier
1000 élément autre qu'une accolade. Si c'est une seule note, il y a une
1001 portée ; si c'est une expression simultanée, il y aura plus d'une
1004 @lilypond[quote,ragged-right,verbatim]
1007 << { e f } { c <<b d>> } >>
1012 @cindex expression musicale
1013 @subheading Analogy: mathematical expressions
1015 Ce mécanisme est similaire au formules mathématiques : une grosse
1016 formule est créée en assemblant plusieurs petites formules. Ces types
1017 de formules, appelées expressions, ont une définition récursive, de
1018 telle sorte que vous pouvez fabriquer des expressions arbitrairement
1019 longues et complexes. Par exemple,
1028 ((1 + 2) * 3) / (4 * 5)
1031 Ceci est une suite d'expressions, où chacune est contenue dans la
1032 suivante. Les expressions les plus simples sont les nombres, et de plus
1033 grandes expressions sont produites en combinant des expressions avec des
1034 opérateurs --- comme @samp{+}, @samp{*} et @samp{/} --- et des
1035 parenthèses. Tout comme les expressions mathématiques, les expressions
1036 musicales peuvent être imbriquées avec une profondeur arbitraire, ce qui
1037 est nécessaire pour de la musique complexe comme des partitions
1041 @node Multiple staves
1042 @subsection Multiple staves
1044 Comme nous l'avons vu dans @ruser{Music expressions explained}, un fichier
1045 d'entrée LilyPond est fait d'expressions musicales. Si la partition
1046 commence par plusieurs expressions simultanées, LilyPond créera
1047 plusieurs portées. Cependant, il est plus facile de voir ce qu'il
1048 advient si l'on crée explicitement chacune des portées.
1050 Pour créer plus d'une portée, chaque partie de la musique constituant
1051 une portée est entrée en la faisant précéder de @code{\new Staff}. Ces
1052 éléments @code{Staff} sont ensuite combinés en parallèle avec @code{<<}
1053 et @code{>>}, comme ceci :
1055 @lilypond[quote,ragged-right,verbatim]
1058 \new Staff { \clef treble c }
1059 \new Staff { \clef bass c,, }
1065 La commande @code{\new} introduit un @qq{contexte de notation}. Un
1066 contexte de notation est un environnement dans lequel les événements
1067 musicaux --- comme les notes ou les commandes @code{\clef} --- sont
1068 interprétés. Pour des pièces simples, ces contextes sont créés
1069 automatiquement. Pour des pièces plus complexes, il est préférable de
1070 spécifier explicitement les contextes. Cela assure que chaque fragment
1071 aura sa propre portée.
1073 Il existe différents types de contextes. Les contextes @code{Staff}
1074 (portée), @code{Voice} (voix) et @code{Score} (partition) gèrent la
1075 notation de la mélodie, alors que @code{Lyrics} gère les paroles et
1076 @code{ChordNames} imprime le nom des accords.
1078 En termes de syntaxe, faire précéder une expression musicale de
1079 @code{\new} crée une plus grosse expression musicale. En reprenant la
1080 comparaison, cela ressemble au signe @qq{moins} en mathématiques. La
1081 formule @math{(4+5)} est une expression, donc @math{-(4+5)} est une plus
1084 Les chiffres de métrique indiqués sur une portée affectent toutes les
1085 autres portées@footnote{Ce comportement peut être modifié si nécessaire,
1086 voir @ruser{Polymetric notation}.}. En revanche l'armure d'une portée
1087 n'affecte @emph{pas} les autres portées.
1089 @lilypond[quote,ragged-right,verbatim]
1092 \new Staff { \clef treble \time 3/4 c }
1093 \new Staff { \clef bass \key d \major c,, }
1102 @subsection Piano staves
1104 @cindex changement de portée manuel
1105 @cindex voix changeant manuellement de portée
1106 La musique pour piano s'écrit sur deux portées reliées par une accolade.
1107 Imprimer ce type de portée revient au même que dans l'exemple de musique
1108 polyphonique de @ruser{Multiple staves}, mais maintenant cette expression
1109 entière doit être interprétée dans un contexte @code{PianoStaff} :
1118 Voici un bref exemple :
1120 @lilypond[quote,ragged-right,verbatim]
1123 \new Staff { \time 2/4 c4 e g g, }
1124 \new Staff { \clef bass c,, c' e c }
1131 Voir @ruser{Piano music}.
1135 @node Combining notes into chords
1136 @subsection Combining notes into chords
1139 Des accords peuvent être produits en entourant les hauteurs de notes
1140 par des angles gauche et droit --- @samp{<} et @samp{>} ---
1142 @lilypond[quote,fragment,verbatim,relative=2,fragment]
1143 r4 <c e g>4 <c f a>2
1146 Vous pouvez combiner les indications comme les liaisons et les ligatures
1147 de croches avec les accords. Ils doivent cependant être placés en
1150 @lilypond[quote,fragment,verbatim,relative=2,fragment]
1151 r4 <c e g>8[ <c f a>]~ <c f a>2
1154 @lilypond[quote,fragment,verbatim,relative=2,fragment]
1155 r4 <c e g>8\>( <c e g> <c e g>4 <c f a>\!)
1159 @node Single staff polyphony
1160 @subsection Single staff polyphony
1163 @cindex voix multiples sur une portée
1164 Quand différentes lignes mélodiques sont combinées sur une seule et même
1165 portée, elles sont imprimées comme des voix polyphoniques ; chaque voix
1166 a ses propre hampes@footnote{familièrement appelées queues de note.},
1167 liaisons et ligatures, la voix supérieure ayant les hampes vers le haut,
1168 la voix inférieure vers le bas.
1170 Ce type de partition est réalisé en entrant chaque voix comme une
1171 séquence (avec @code{@{...@}}), en combinant simultanément les voix et
1172 en les séparant par @code{\\} :
1175 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
1182 Pour l'écriture de musique polyphonique, les silences invisibles
1183 s'avèrent bien pratiques : ce sont des silences qui ne s'impriment pas.
1184 Ils sont utiles pour remplir des voix qui, temporairement, ne jouent
1185 rien. On peut voir ici le même exemple avec un silence invisible
1186 (@code{s}) à la place d'un silence normal (@code{r}) :
1188 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
1196 Là encore, ces expressions peuvent s'imbriquer arbitrairement :
1198 @lilypond[quote,fragment,verbatim,relative=2,fragment]
1206 { <c g>1 ~ <c g>4 } \\
1214 Voir @ruser{Basic polyphony}.
1221 Cette section présente l'écriture vocale et les partitions de variété.
1229 @node Printing lyrics
1230 @subsection Printing lyrics
1234 Prenons une mélodie toute simple :
1236 @lilypond[quote,ragged-right,verbatim]
1243 Des paroles peuvent être associées à ces notes, en les combinant avec la
1244 commande @code{\addlyrics}. Les paroles sont entrées en séparant chaque
1245 syllable par un espace :
1247 @lilypond[quote,ragged-right,verbatim]
1253 \addlyrics { One day this shall be free }
1258 @cindex ligne d'extension
1259 Cette mélodie se termine sur un @rglos{melisma}, c'est-à-dire qu'une
1260 seule syllable (@qq{free}) correspond à plus d'une note. Ceci est
1261 indiqué avec une @emph{ligne d'extension}. Elle est entrée avec deux
1262 caractères souligné (@code{_}), c'est-à-dire :
1264 @lilypond[quote,ragged-right,verbatim]
1270 \addlyrics { One day this shall be free __ }
1274 De la même manière, les séparations syllabiques d'un mot peuvent être
1275 entrées avec deux tirets (@code{-}), ce qui produit un tiret centré
1276 entre les deux syllabes :
1278 @c no ragged-right here because otherwise the hypens get lost.
1279 @lilypond[quote,verbatim]
1285 \addlyrics { A -- le -- gri -- a }
1291 Plus de possibilités, comme celle d'ajouter plusieurs lignes de paroles
1292 en dessous d'une même mélodie sont exposées dans @ruser{Vocal music}.
1297 @subsection A lead sheet
1299 @cindex partition de chanson
1300 @cindex chanson, partition complète
1301 @cindex accords, noms
1302 @cindex noms d'accords
1304 En musique de variété, il est courant d'indiquer l'accompagnement par le
1305 nom des accords. De tels accords peuvent être entrés comme les notes :
1307 @lilypond[quote,ragged-right,verbatim]
1308 \chordmode { c2 f4. g8 }
1311 Maintenant, chaque hauteur est lue comme la base de l'accord à la place
1312 de la note. Ce mode est activé avec @code{\chordmode}. D'autres
1313 accords peuvent être créés en ajoutant des modificateurs après deux
1314 points. L'exemple suivant montre quelques modificateurs usuels :
1316 @lilypond[quote,verbatim,ragged-right]
1317 \chordmode { c2 f4:m g4:maj7 gis1:dim7 }
1320 Pour la musique improvisée, les accords ne sont pas imprimés sur des
1321 portées mais comme des lignes à part entière. Ceci s'obtient en
1322 utilisant @code{\chords} à la place de @code{\chordmode}. La même
1323 syntaxe sera utilisée que dans le cas de@code{\chordmode}, mais le rendu
1324 des notes interviendra dans un contexte @code{ChordNames}, avec le
1327 @lilypond[quote,verbatim,ragged-right]
1328 \chords { c2 f4.:m g4.:maj7 gis8:dim7 }
1331 @cindex partition de chanson
1332 @cindex chanson, partition complète
1333 Une fois assemblés, les accords, paroles et mélodie forment une
1334 partition de chanson :
1336 @lilypond[quote,verbatim,ragged-right]
1338 \chords { c2 g:sus4 f e }
1343 \addlyrics { One day this shall be free __ }
1350 Une liste complète de modificateurs et d'autres options de mise en forme
1351 se trouve à la section @ruser{Chords}.
1356 @section Final touches
1358 L'ultime section de ce tutoriel montre comment ajouter une touche finale
1359 à des morceaux simples, et consititue une introduction au reste du
1365 * Absolute note names::
1366 * Organizing pieces with identifiers::
1367 * After the tutorial::
1368 * How to read the manual::
1372 @node Version number
1373 @subsection Version number
1376 La déclaration @code{\version} stipule le numéro de la version de
1377 LilyPond pour laquelle le fichier a été écrit,
1380 \version @w{"@version{}"}
1384 que l'on place par convention en début de fichier.
1386 Cette annotation permet de faciliter les prochaines mises à jour de
1387 LilyPond. Les changements dans la syntaxe sont gérés avec un programme
1388 spécial, @file{convert-ly} --- voir @rprogram{Updating files with convert-ly}
1389 --- et il utilise @code{\version} pour déterminer les règles de
1390 conversion à appliquer au fichier.
1394 @subsection Adding titles
1396 Les informations bibliographiques (nom du morceau, du compositeur, etc)
1397 sont entrées dans un bloc séparé, le bloc d'en-tête (@code{\header}),
1398 qui existe indépendamment des expressions musicales principales. Le
1399 bloc @code{\header} est habituellement placé en début de fichier.
1410 @dots{} music @dots{}
1413 Quand le fichier est traité, le titre et le compositeur sont imprimés en
1414 haut de la partition. Vous trouverez plus d'informations sur les titres
1415 à @ruser{Creating titles}.
1417 @node Absolute note names
1418 @subsection Absolute note names
1420 Jusqu'ici nous n'avons utilisé que le mode @code{\relative} pour définir
1421 les hauteurs de notes. Si c'est effectivement le moyen le plus simple
1422 d'entrer la majeure partie de votre musique, il existe une autre façon
1423 de procéder : le mode des hauteurs absolues.
1425 Si vous omettez la commande @code{\relative}, LilyPond considérera
1426 toutes les hauteurs comme des hauteurs absolues. Un @code{c'} sera
1427 toujours un do du milieu, un @code{b} sera toujours une note au-dessous
1428 du précédent, et un @code{g,} sera toujours la note la plus grave dans
1429 la portée de clé de fa.
1431 @lilypond[quote,verbatim,ragged-right]
1439 Voici une gamme sur 4 octaves :
1441 @lilypond[quote,verbatim,ragged-right]
1456 Comme vous pouvez le voir, il faut beaucoup d'apostrophes pour écrire de
1457 la musique dans un registre aigu. Regardez cet extrait de Mozart :
1459 @lilypond[quote,verbatim,ragged-right]
1463 cis''8. d''16 cis''8 e''4 e''8
1464 b'8. cis''16 b'8 d''4 d''8
1468 Toutes ces apostrophes rendent le fichier moins lisible, et c'est donc
1469 une source d'erreurs. En mode @code{\relative}, le même exemple devient
1470 bien plus facile à lire :
1472 @lilypond[quote,verbatim,ragged-right]
1476 cis8. d16 cis8 e4 e8
1481 Si d'aventure vous faites une erreur d'octaviation, le mode
1482 @code{\relative} la rendra frappante --- toutes les notes suivantes
1483 seront placées à la mauvaise octave. En mode de hauteurs absolues, une
1484 erreur isolée ne serait pas auntant visible, et donc aussi facile à
1487 Cependant, le mode de hauteurs absolues reste utile pour les musiques où
1488 les intervalles sont étendus, surtout pour les fichiers LilyPond créés
1492 @node Organizing pieces with identifiers
1493 @subsection Organizing pieces with identifiers
1495 Lorsque l'on combine tous les éléments étudiés plus haut pour produire
1496 des fichiers plus volumineux, les blocs @code{\score} deviennent
1497 beaucoup plus gros parce que les expressions musicales sont plus longues
1498 et, dans le cas des pièces polyphoniques, profondément imbriquées. De
1499 telles expressions imposantes finissent par devenir peu maniables. Cet
1500 inconvénient peut être résolu par l'utilisation
1501 d'@emph{identificateurs}.
1503 En utilisant ces identificateurs, que l'on pourrait aussi appeler
1504 variables ou macros, il est possible de découper des expressions
1505 musicales complexes. Un identificateur se définit comme suit :
1508 MusiqueToto = @{ @dots{} @}
1511 Le contenu de l'expression musicale @code{MusiqueToto} pourra être
1512 utilisé plus loin en faisant précéder son nom d'un anti-slash,
1513 c'est-à-dire @code{\MusiqueToto}, juste comme n'importe quelle commande
1514 LilyPond. Tous les identificateurs doivent être définis @emph{avant}
1515 l'expression musicale principale.
1517 @lilypond[quote,verbatim,ragged-right]
1518 violin = \new Staff { \relative c'' {
1521 cello = \new Staff { \relative c {
1534 Le nom d'un identificateur ne doit comporter que des caractères
1535 alphabétiques non accentués, aucun nombre ni tiret.
1537 Il est possible d'utiliser des variables de types variés. Par exemple,
1542 aFivePaper = \paper @{ paperheight = 21.0 \cm @}
1545 En fonction de son contenu, un identificateur peut être utilisé à
1546 différents endroits. L'exemple suivant utilise la variable ci-dessus :
1557 @node After the tutorial
1558 @subsection After the tutorial
1560 Après avoir parcouru ce tutoriel, vous devriez vous essayer à écrire un
1561 morceau ou deux. Commencez par copier l'un des @ruser{Templates} types et
1562 ajoutez-y des notes. Si vous voulez employer une notation que vous
1563 n'avez pas trouvé dans le tutoriel, consultez la référence de notation,
1564 en commençant par la @ruser{Basic notation}. Si vous désirez écrire pour
1565 un ensemble instrumental non couvert par les @ruser{Templates}, lisez la
1566 section @ruser{Extending the templates}.
1568 Après avoir écrit quelques pièces courtes, lisez les chapitres 3 à 5 du
1569 manuel d'apprentissage. Rien ne s'oppose à ce que vous consultiez dès à
1570 présent les autres chapitres, bien sûr ! Néanmoins, le reste du manuel
1571 de l'utilisateur part du principe que vous avez déjà bien assimilé la
1572 syntaxe de LilyPond. Vous pouvez toujours survoler le reste du manuel,
1573 et y revenir plus tard après avoir acquis de l'expérience.
1575 @node How to read the manual
1576 @subsection How to read the manual
1578 Comme nous l'avons déjà vu dans @ruser{How to read the tutorial}, de
1579 nombreux exemples du tutoriel n'ont pas fait apparaître
1580 @code{\relative c'' @{ ... @}} dans l'extrait de code affiché.
1582 Dans le reste du manuel, les exemples utilisés sont encore beaucoup plus
1583 souples : parfois il leur manque le @code{\relative c'' @{ ... @}},
1584 mais d'autres fois ils ont recours à une autre hauteur de référence,
1585 telle que @code{c'} ou @code{c,,}), et dans certains cas c'est même
1586 l'exemple entier qui est en mode de hauteurs absolues ! Cependant, de
1587 telles ambiguïtés ne se trouvent que dans des contextes où les hauteurs
1588 n'ont que peu d'importance. Dans tous les exemples où elles en ont, le
1589 mode @code{\relative} ou absolu @code{@{ @}} est explicitement spécifié.
1591 Si vous ne vous y retrouvez toujours pas pour savoir quel code LilyPond
1592 produit précisément tel ou tel exemple, consultez la version HTML de ce
1593 manuel si ce n'est pas déjà le cas, et cliquez sur l'image de la
1594 partition. La source exacte utilisée pour générer ce manuel s'affichera
1597 Pour en savoir plus sur l'organisation de la suite de ce manuel,
1598 reportez-vous à @ruser{About this manual}.