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.
14 - unless you have a really good reason, use either
15 @l ilypond[quote,ragged-right,verbatim]
17 @l ilypond[quote,ragged-right,verbatim,fragment,relative=2]
19 Don't use any other relative=X commands (make it a non-fragment
20 example), and don't use fragment without relative=2.
21 - use "aes" and "ees" instead of "as" and "aes". I know it's not
22 correct Dutch naming, but let's not confuse people with this until
23 we get to the Basic notation chapter.
28 @c old info that will probably be removed.
30 @c * more details about running lilypond; error messages,
31 @c compiling/viewing (emacs?)
32 @c * where to go from First steps+More basics?
34 @c wherever possible, do not include index entries here; the
35 @c index should point to stuff in the reference manual. -gp
37 @c Your first LilyPond score in 10 minutes?
39 @c Translators: Nicolas Grandclaude, Ludovic Sardain, Gauvain Pocentek
40 @c Translation checkers: Jean-Charles Malahieude, Valentin Villenave, John Mandereau
46 Ce tutoriel commence par une introduction au langage musical utilisé
47 par LilyPond, qui vous permettra de faire fonctionner le logiciel pour
48 produire une partition. Après ce premier contact, nous verrons comment
49 créer des partitions utilisant une notation musicale courante.
52 Beaucoup de gens apprennent à utiliser les programmes en les essayant
53 et en bidouillant avec. C'est également possible avec LilyPond. Si
54 vous cliquez sur une image dans la version HTML de ce manuel, vous
55 verrez exactement le code LilyPond utilisé pour générer cette image.
56 Essayez sur cette image :
60 @lilypond[quote,ragged-right]
62 c-\markup { \bold \huge { Cliquez ici. } }
66 En copiant et en collant tout le code de l'extrait ly dans un fichier
67 test, vous aurez un modèle de base pour faire vos expériences. Si vous
68 apprenez de cette façon, vous aurez probablement envie d'imprimer ou de
69 garder un lien vers l'@ruser{Cheat sheet}, tableau qui répertorie les
70 commandes usuelles pour une consultation rapide.
75 * Single staff notation::
76 * Multiple notes at once::
85 Cette section présente sommairement la façon de travailler avec LilyPond.
90 * Working on text files::
91 * How to read the tutorial::
95 @node Compiling a file
96 @subsection Compiling a file
98 Le premier exemple montre comment débuter avec LilyPond. Pour créer
99 une partition, on écrit un fichier de texte qui décrit la notation
100 musicale. Par exemple, si l'on écrit
109 le résultat ressemblera à
111 @c in this case we don't want verbatim
112 @lilypond[quote,ragged-right]
119 Il est aussi possible d'utiliser les noms de notes français @samp{do
120 re mi fa sol la si}, en insérant au début du fichier la ligne
121 @samp{\include "italiano.ly"}
124 @emph{Attention :} tout extrait de code LilyPond doit être entouré
125 d'une @{paire d'accolades@}. De plus, pour éviter toute ambiguïté, il
126 est préférable d'entourer les accolades par des espaces ou retours à
127 la ligne. Bien que certains exemples de ce manuel ne comportent pas
128 d'accolades, ne les oubliez pas dans vos partitions !
130 @cindex casse, prise en compte de
131 De plus, LilyPond est sensible à la casse. @code{ @{ c d e @} } est
132 un code valide ; @code{ @{ C D E @} } produira un message d'erreur.
136 @subheading Entering music and viewing output
138 Dans cette section nous expliquerons quelles commandes exécuter et
139 comment voir ou imprimer le résultat de LilyPond.
141 @subsubheading MacOS X
143 Si vous double-cliquez sur @code{LilyPond.app}, un fichier d'exemple
144 s'ouvrira. Sauvegardez-le, par exemple, sous @file{test.ly} sur votre
145 bureau, et traitez-le ensuite avec la commande du menu @samp{Compile >
146 Typeset File}. Le fichier PDF résultant sera alors affiché sur votre
149 Notez que le premier démarrage peut prendre une minute ou deux, car
150 toutes les polices système doivent être d'abord analysées.
152 À l'avenir, vous aurez certainement recours aux commandes @qq{Nouveau}
153 ou @qq{Ouvrir}. Vous devez enregistrer votre fichier avant de lancer
154 la création de la partition. Si une erreur advient pendant le
155 traitement, vous la trouverez dans la fenêtre @qq{log}.
157 @subsubheading Windows
159 Sous Windows, lorsque vous double-cliquez sur l'icône LilyPond qui se
160 trouve sur le Bureau, un fichier d'exemple s'ouvre dans un simple
161 éditeur de texte. Enregistrez-le, par exemple en tant que
162 @file{test.ly} sur votre Bureau, puis double-cliquez sur son icône
163 (qui montre une note de musique) pour le traiter. Après quelques
164 secondes, vous obtiendrez un fichier @file{test.pdf} sur votre Bureau,
165 fichier que vous pourrez ouvrir pour voir la partition imprimée. Une
166 autre méthode pour lancer le traitement du fichier @file{test.ly} est
167 de le glisser avec votre souris sur l'icône de LilyPond.
169 Pour modifier un fichier @file{.ly} existant, faites un clic droit
170 dessus et sélectionnez @qq{Éditer la source}. Pour partir d'un
171 fichier vide, lancez l'éditeur en ouvrant un fichier existant et
172 utilisez la commande @qq{New} du menu @qq{File}.
174 En double-cliquant sur le fichier, vous obtiendrez, en plus du fichier
175 PDF, un fichier @file{.log} qui récapitule les opérations que LilyPond
176 a effectuées sur votre fichier. Si une erreur survient, c'est ce
177 fichier qu'il vous faudra étudier.
179 Notez qu'il existe d'autres éditeurs de texte, certains disposant d'un
180 meilleur support pour LilyPond ; reportez-vous à @rprogram{Text editor support}.
185 Commencez par ouvrir une fenêtre de terminal et un éditeur de
186 texte. Par exemple, vous pouvez ouvrir un xterm et exécuter
187 @code{joe}. @footnote{Il existe des fichiers de macros pour les fans
189 @code{LilyPond-mode} pour les fans d'Emacs. S'ils ne sont pas
190 encore installés, consultez le fichier @file{INSTALL.txt}. L'outil
191 d'édition le plus facile d'utilisation est de loin
192 @file{LilyPondTool}. Vous trouverez plus d'informations dans
193 @rprogram{Text editor support}.} Dans votre
194 éditeur, entrez le texte suivant et sauvegardez le fichier sous
204 Pour traiter @file{test.ly}, procédez comme ceci :
211 Vous verrez quelque chose ressemblant à :
218 Interpreting music... [1]
219 Preprocessing graphical objects...
220 Calculating line breaks... [2]
221 Layout output to `test.ps'...
222 Converting to `test.pdf'...
226 Suivant votre installation, ces messages peuvent être traduits.
230 @cindex visionnage de la musique
233 De tout cela résulte un fichier @file{test.pdf}, que vous pouvez imprimer
234 ou visualiser avec les outils standards de votre système
235 d'exploitation. @footnote{Si votre système ne dispose pas des outils
236 nécessaires, vous pouvez essayer
237 @uref{http://@/www@/.cs@/.wisc@/.edu/@/~ghost/,Ghostscript}, un
238 programme pour afficher et imprimer librement les fichiers PDF et PostScript.}
241 @node Simple notation
242 @subsection Simple notation
244 Il y a certains éléments graphiques que LilyPond ajoute
245 automatiquement. Dans l'exemple suivant, nous n'avons fourni que
246 quatre hauteurs, mais LilyPond a ajouté une clé, un chiffre de mesure
249 @lilypond[quote,ragged-right,verbatim]
256 Ce comportement peut être modifié, mais dans bien des cas ces
257 attributions automatiques s'avèrent utiles.
261 Le moyen le plus simple d'entrer des notes est d'utiliser le mode
262 @code{\relative}. Avec ce mode, l'@rglos{interval} entre la note et
263 celle qui la précède est supposé inférieur ou égal à une
264 @rglos{fourth}. Commençons par entrer la partition la plus
265 élémentaire qui soit, une @rglos{scale}.
267 @lilypond[quote,ragged-right,verbatim]
274 La note de départ est @rglos{middle C}. Chacune des notes qui suivent
275 est à moins d'une quarte de la note précédente --- en d'autres termes,
276 le premier @samp{c} est le do central, entre la clé de sol et
277 la clé de fa, puis est suivi par le ré le plus proche, et ainsi de
278 suite. On peut bien sûr créer des mélodies d'intervalles plus étendus :
280 @lilypond[quote,ragged-right,verbatim]
288 Comme vous l'aurez remarqué, cet exemple ne commence plus sur le do du
289 milieu. La première note --- le @samp{d} --- est le ré qui en est le
292 Pour ajouter des intervalles supérieurs à une quarte, il suffit
293 d'indiquer si la note est à l'octave supérieure ou inférieure, en
294 ajoutant respectivement une apostrophe @code{'} ou une virgule
295 @code{,} au nom de la note.
297 @lilypond[quote,ragged-right,verbatim]
305 Pour déplacer une note deux octaves (ou davantage !) plus haut ou plus
306 bas, il suffit de mettre plusieurs @code{''} ou plusieurs @code{,,} ---
307 attention cependant à bien mettre deux apostrophes @code{''}, et non
308 un guillemet @code{"}@tie{}! C'est de cette même manière que l'on
309 peut modifier la valeur de départ de @code{\relative c'}.
312 @subheading Durations (rhythms)
314 La @rglos{duration} d'une note est indiquée par un nombre
315 qui suit son nom : @samp{1} pour une @rglos{whole
316 note}, @samp{2} pour une @rglos{half note}, @samp{4} pour
317 une @rglos{quarter note} et ainsi de suite. Les hampes sont
318 ajoutées automatiquement.
320 @lilypond[quote,ragged-right,verbatim]
324 a16 a a a a32 a a a a64 a a a a a a a a2
329 Si aucune durée n'est indiquée, la dernière durée entrée sera utilisée
330 pour les notes suivantes. En l'absence d'indication, la première note
333 Une @rglos{dotted note} s'obtient en ajoutant un point @samp{.} à
336 @lilypond[quote,ragged-right,verbatim]
346 On saisit un @rglos{rest} tout comme une note, mais avec le
349 @lilypond[quote,ragged-right,verbatim]
357 @subheading Time signature
359 La @rglos{time signature} peut être définie à l'aide de la commande
362 @lilypond[quote,ragged-right,verbatim]
376 La @rglos{clef} peut être définie à l'aide de la commande @code{\clef} :
378 @lilypond[quote,ragged-right,verbatim]
392 @subheading All together
394 Voici un bref exemple qui montre tous ces éléments ensemble :
396 @lilypond[quote,ragged-right,verbatim]
408 @item Entrer des hauteurs et des durées
409 voir @ruser{Pitches} and @ruser{Durations}.
412 @item Les chiffres de mesure et autres commandes de métrique
413 voir @ruser{Time signature}.
420 @node Working on text files
421 @subsection Working on text files
423 Le traitement des fichiers source de LilyPond est semblable à celui du
424 code de nombreux langages de programmation répandus : la casse est prise
425 en compte, et les caractères considérés comme espaces ont généralement
426 peu d'importance. Les expressions sont délimitées par des accolades @{
427 @}, et les commentaires par @code{%} ou @code{%@{ ... %@}}.
429 Si cette phrase vous paraît incompréhensible, ne vous en faites pas !
430 Tous ces termes vont être expliqués :
434 @cindex casse, prise en compte de
435 @item @strong{La casse} :
436 LilyPond est sensible à la casse, c'est à dire qu'une lettre capitale
437 n'a pas la même valeur qu'une lettre minuscule. Les notes, par
438 exemple, doivent être entrées en minuscules : @code{@{ c d e @}} est
439 un code valide, alors que @code{@{ C D E @}} produira un message
442 @item @strong{Les espaces multiples} :
443 LilyPond ne tient pas compte du nombre d'espaces, ou de retours à la
444 ligne. @code{@{ c d e @}} a le
445 même sens que @code{@{ c @tie{} @tie{} d @tie{} e @}} ou que
453 Bien sûr, ce dernier exemple est difficile à lire. Une bonne habitude
454 à prendre est d'indenter les blocs de code avec soit des tabulations
455 soit des doubles espaces :
462 @item @strong{Expressions musicales} :
463 Tout morceau saisi dans LilyPond doit être placé entre @strong{@{
464 accolades @}}. Ces caractères indiquent à LilyPond que ce bloc de
465 texte est une et une seule expression musicale, tout comme les
466 parenthèses @samp{()} en mathématiques. Il est préférable, pour
467 éviter toute ambiguïté, d'entourer tous ces crochets d'espaces, à
468 moins qu'ils se trouvent au début ou à la fin d'une ligne.
470 Une fonction --- @code{\relative @{ @}} par exemple --- compte
471 également comme une seule expression musicale.
474 @cindex commentaire de fin de ligne
475 @cindex commentaire-bloc
476 @item @strong{Les commentaires} :
477 Un commentaire est une indication pour tout lecteur humain d'un
478 fichier de musique ; il est ignoré par l'ordinateur, et n'a donc aucun
479 effet sur la partition imprimée. On distingue deux types de
482 @item la ligne de commentaire, introduite par le symbole @samp{%} :
483 tout ce qui suit ce symbole sur cette ligne sera ignoré.
484 @item le bloc de commentaire, qui peut être de plusieurs lignes voire
485 de toute une section : tout ce qui se trouve entre @code{%@{} et
486 @code{%@}} est ignoré. Les blocs de commentaires ne peuvent s'imbriquer.
488 Le fragment suivant met en évidence quelques usages possibles des commentaires :
491 % voici les notes de "ah vous dirai-je maman"
495 Ces lignes et les notes qui suivent
496 seront ignorées, car elles se trouvent
497 dans un bloc de commentaire.
505 Vous trouverez plus d'astuces pour organiser vos fichiers LilyPond dans
506 @ref{Suggestions for writing LilyPond files}.
509 @node How to read the tutorial
510 @subsection How to read the tutorial
512 Comme nous l'avons vu dans @ref{Working on text files}, un code
513 LilyPond doit être encadré par des @{ @} ou bien par @code{\relative
514 c'' @{ ... @}} afin d'être compris. Cependant, dans la suite de ce
515 manuel, la plupart des exemples ne feront pas apparaître ces signes.
517 Si vous consultez la documentation au format HTML, et que vous
518 souhaitez voir la source exacte d'un exemple, il vous suffit de
519 cliquer sur l'image. Si vous ne disposez pas de la version HTML, il
520 vous est possible de simplement copier et coller le code affiché, mais
521 @strong{à condition} d'ajouter @code{\relative c'' @{ @}} de la façon
526 ... collez ici votre exemple...
530 Pourquoi avoir omis les accolades ? La plupart des exemples de ce
531 manuel peuvent être insérés au milieu d'un morceau de musique plus
532 long. Il n'y a donc aucune raison d'ajouter @code{\relative c'' @{
533 @}} à ces exemples --- en effet, il n'est pas possible d'insérer un
534 @code{\relative} à l'intérieur d'un autre @code{\relative}. Il vous
535 serait donc devenu impossible de copier un bref exemple de la
536 documentation et de le coller dans une pièce de votre cru.
538 @node Single staff notation
539 @section Single staff notation
541 Cette section présente la notation courante dont on a besoin pour
542 écrire une seule voix sur une seule portée.
545 * Relative note names::
546 * Accidentals and key signatures::
548 * Articulation and dynamics::
549 * Automatic and manual beams::
550 * Advanced rhythmic commands::
554 @node Relative note names
555 @subsection Relative note names
557 Comme nous l'avons vu dans @ref{Simple notation}, LilyPond calcule la
558 hauteur de chaque note en fonction de la précédente@footnote{Il existe
559 un autre mode de saisie des hauteurs, le mode @ref{Absolute note
560 names}, mais en pratique il est bien plus aisé et sûr d'avoir recours
561 au mode de hauteurs relatives.}. Si aucune indication supplémentaire
562 d'octaviation n'est ajoutée, il en concluera que chaque hauteur est
563 située à une quarte au plus de la note précédente.
565 Lilypond tient compte des intervalles induits par les noms des notes
566 --- en d'autres termes, une quarte augmentée n'est @emph{pas}
567 équivalente à une quinte diminuée. Ainsi, si l'on part d'un Do, un Fa
568 dièse sera placé au-dessus, tandis qu'un Sol bémol sera placé
571 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
579 @item Les hauteurs de note relatives
580 voir @ruser{Relative octaves}.
581 @item Les vérifications d'octaves
582 voir @ruser{Octave check}.
588 @node Accidentals and key signatures
589 @subsection Accidentals and key signatures
591 @subheading Accidentals
593 Dans la notation par défaut, un @rglos{sharp} s'obtient en ajoutant
594 @samp{is} au nom de la note, et un @rglos{flat} en ajoutant @samp{es}.
595 Comme vous pouvez vous y attendre, un double dièse ou double bémol est
596 alors obtenu en ajoutant @samp{isis} ou @samp{eses}@footnote{Cette
597 syntaxe est dérivée de la convention de dénomination des notes dans
598 les langues nordiques et germaniques, comme l'allemand ou le
602 Cependant, si vous utilisez la commande @samp{\include "italiano.ly"}
603 pour entrer les noms de notes français au lieu des noms hollandais, il
604 faudra ajouter un @samp{d} pour un dièse, et un @samp{b} pour un
605 bémol. Le double dièse et le double bémol s'obtiennent en ajoutant
606 respectivement @samp{dd} et @samp{bb}
609 Pour en savoir plus sur les autres langues disponibles, voir @ruser{Note
610 names in other languages}.
612 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
613 cis1 ees fisis, aeses
616 @cindex armure, définition de
617 @subheading Key signatures
619 L'armure est déterminée par la commande @code{\key}, suivie d'une
620 hauteur puis de @code{\major} (majeur) ou @code{\minor} (mineur) :
622 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
631 @subheading Warning: key signatures and pitches
633 La combinaison de l'armure et des hauteurs de note --- y compris les
634 altérations --- permet à LilyPond de déterminer dans quel cas afficher
635 les altérations accidentelles. L'armure n'affecte que les altérations
636 @emph{imprimées}, et non les hauteurs réelles ! Cette fonctionnalité
637 est souvent source de confusion pour les nouveaux utilisateurs, aussi
638 expliquons-la en détail.
640 LilyPond fait une nette distinction entre le contenu musical et la
641 mise en forme. L'altération d'une note --- bémol, bécarre ou dièse
642 --- fait partie de sa hauteur, et relève donc du contenu musical. La
643 présence ou non d'une altération accidentelle --- un @emph{signe}
644 bémol, bécarre ou dièse --- devant la note correspondante est une
645 question qui relève de la mise en page. Mettre en page une partition
646 se fait selon des règles ; les altérations accidentelles seront donc
647 automatiquement imprimées suivant ces règles. Les hauteurs de note,
648 en revanche, relèvent de ce que vous voulez entendre ; et, dans la
649 mesure où la musique que vous entrez est censée être celle que vous
650 voulez entendre, LilyPond (qui n'est chargé que de la gravure) ne les
651 choisira pas à votre place.
655 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
661 aucune note n'a d'altération accidentelle, et pourtant vous devrez
662 entrer le @samp{is} pour les notes @code{cis} et @code{fis}.
664 Le code @samp{e} ne veut pas dire @qq{Imprimez-moi un point noir sur
665 la première ligne de la portée.} Cela signifie plutôt : @qq{Ici se
666 trouve une note dont la hauteur est un mi naturel.} Avec l'armure de
667 la bémol majeur, ce mi sera flanqué 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. De plus les altérations accidentelles peuvent
677 être imprimées suivant plusieurs conventions. Regardez
678 @ruser{Automatic accidentals} pour connaître les différentes manières
679 dont les altérations accidentelles peuvent être imprimées, suivant les
680 règles que vous choisirez.
685 @item Les altérations
686 voir @ruser{Accidentals} and @ruser{Automatic accidentals}.
688 voir @ruser{Key signature}.
694 @subsection Ties and slurs
696 @cindex liaisons de prolongation
698 Une @rglos{tie}@footnote{parfois aussi appelée liaison de
699 tenue} se crée en ajoutant un tilde @samp{~} à la première note liée.
701 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
706 @cindex liaisons d'articulation
709 @c Le terme de "slur" a deux sens en français : articulation et phrasé.
710 @c Je garde ici le terme "legato", tel qu'il apparaît dans le texte original,
711 @c car c'est celui qui me semble le plus couramment employé.
713 Une @rglos{slur} d'articulation (ou @qq{legato}) peut englober
714 plusieurs notes. Les notes de départ et d'arrivée reçoivent
715 respectivement un signe @samp{(} et @samp{)}.
717 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
718 d4( c16) cis( d e c cis d) e( d4)
721 @cindex liaisons de phrasé
722 @subheading Phrasing slurs
724 De plus longues liaisons, dites de phrasé, sont délimitées par @code{\(} et
725 @code{\)}. Il est possible d'avoir en même temps des legatos et des
726 phrasés, mais pas plusieurs liaisons de phrasé ou de legato à la fois.
728 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
729 a8(\( ais b c) cis2 b'2 a4 cis,\)
734 @cindex liaisons de phrasé et de prolongation, différences
735 @subheading Warnings: slurs vs. ties
737 Une liaison d'articulation ou de phrasé ressemble à une liaison de
738 tenue, mais n'a pas la même signification. Alors qu'une liaison de
739 tenue ne peut relier que deux notes de même hauteur, le legato indique
740 une articulation de plusieurs notes, éventuellement nombreuses. Les
741 liaisons de tenue peuvent être enchâssées dans un legato ou un phrasé.
743 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
744 c2~( c8 fis fis4 ~ fis2 g2)
752 @item @ruser{Phrasing slurs}.
757 @node Articulation and dynamics
758 @subsection Articulation and dynamics
763 @subheading Articulations
765 Des @rglos{articulation}s peuvent être ajoutées à une note, au moyen
766 d'un tiret @samp{-} suivi d'un caractère :
768 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
769 c-. c-- c-> c-^ c-+ c-_
773 @subheading Fingerings
774 De même, des indications de doigté peuvent être ajoutées à une note en
775 utilisant un tiret (@samp{-}) et le chiffre à écrire :
777 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
781 Articulations et doigtés sont habituellement placés automatiquement,
782 mais vous pouvez spécifier une direction en utilisant @samp{^} (en haut)
783 ou @samp{_} (en bas). Vous pouvez aussi utiliser plusieurs
784 articulations sur la même note. Dans la plupart des cas, cependant, il
785 est mieux de laisser LilyPond déterminer l'emplacement de
788 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
789 c_-^1 d^. f^4_2-> e^-_+
793 Les signes de nuances sont obtenus en ajoutant à la note les noms des nuances,
794 précédées d'un anti-slash @samp{\} :
796 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
804 @c Pluriel des termes musicaux italiens :
805 @c selon Littré, plutôt à la française (en "-os" qu'en "-i")
807 Crescendos et decrescendos débutent avec les commandes @code{\<} et
808 @code{\>}. Ils se terminent soit par une nuance d'arrivée, par exemple
809 @code{\f}, soit par la commande @code{\!} :
811 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
818 @item @ruser{Articulations}.
819 @item @ruser{Fingering instructions}.
820 @item @ruser{Dynamics}.
825 @node Automatic and manual beams
826 @subsection Automatic and manual beams
828 @cindex ligatures manuelles
829 Toutes les @rglos{beam} sont dessinées automatiquement :
831 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
832 a8 ais d ees r d c16 b a8
836 Lorsqu'on n'aime pas la manière dont les notes sont automatiquement
837 groupées, il est possible de les ligaturer manuellement, en marquant la
838 première note à attacher d'un @samp{[} et la dernière d'un @samp{]}.
840 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
841 a8[ ais] d[ ees r d] a b
847 @item Groupements de notes et ligatures automatiques
848 voir @ruser{Automatic beams}.
849 @item Groupements et ligatures manuels
850 voir @ruser{Manual beams}.
855 @node Advanced rhythmic commands
856 @subsection Advanced rhythmic commands
860 @cindex mesure incomplète
861 @subheading Partial measure
863 Une levée (ou @rglos{anacrusis}) est entrée avec la commande
864 @code{\partial}, suivie d'une durée : @code{\partial 4} est une levée
865 d'une noire et @code{\partial 8} d'une croche.
867 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
875 Les nolets sont créés avec la commande @code{\times}, qui prend deux
876 arguments : une fraction et une expression musicale. La durée des notes
877 de l'expression musicale est multipliée par la fraction. Par exemple
878 les notes d'un triolet durent les deux tiers du temps de leur notation
879 réelle, cette fraction est donc de 2/3 pour les triolets :
881 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
882 \times 2/3 { f8 g a }
884 \times 2/3 { f,8 g16[ a g a] }
888 @cindex notes d'ornement
889 @cindex ornementation
891 @subheading Grace notes
893 Des notes d'ornement sont produites par la commande @code{\grace}, mais
894 aussi en préfixant une expression musicale avec le mot-clé
895 @code{\appoggiatura} ou @code{\acciaccatura} :
897 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
898 c2 \grace { a32[ b] } c2
899 c2 \appoggiatura b16 c2
900 c2 \acciaccatura b16 c2
906 @item Notes d'ornement
907 voir @ruser{Grace notes},
909 voir @ruser{Tuplets},
911 voir @ruser{Upbeats}.
916 @node Multiple notes at once
917 @section Multiple notes at once
919 Cette section traite des situations où l'on a plus d'une note à la fois
920 : plusieurs instruments, plusieurs portées pour un même instrument (le
921 piano, par exemple), et les accords.
923 La polyphonie, en théorie musicale, est la notion d'une musique
924 constituée de plusieurs voix ; dans lilypond, ce terme désigne les
925 situations où il y a plus d'une voix sur une même portée.
928 * Music expressions explained::
931 * Combining notes into chords::
932 * Single staff polyphony::
936 @node Music expressions explained
937 @subsection Music expressions explained
939 Dans les fichiers source LilyPond, la musique est représentée par ce
940 qu'on appelle des @emph{expressions musicales}. En soi, une seule note
941 peut constituer une expression musicale, si tant est qu'elle soit
942 correctement encadrée :
944 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
948 Mettre un groupe de notes entre accolades crée une nouvelle expression
951 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
955 Placer une séquence d'expressions musicales --- des notes par exemple
956 --- entre accolades signifie qu'elles doivent être jouées
957 successivement, les unes après les autres. Le résultat est une
958 expression, qui peut elle-même être regroupée séquentiellement avec
959 d'autres expressions. Ici, l'expression de l'exemple précédent est
960 combinée à deux notes :
962 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
966 @subheading Simultaneous music expressions: multiple staves
968 Cette technique est utile pour de la musique polyphonique. Pour entrer
969 une musique avec plusieurs voix ou plusieurs portées, nous pouvons aussi
970 combiner en parallèle les expressions. Deux voix qui doivent être
971 jouées en même temps, sont entrées comme une combinaison simultanée de
972 deux expressions. Une expression musicale @q{simultanée} est formée en
973 entourant les expressions entre @code{<<} et @code{>>}. Dans l'exemple
974 suivant, trois expressions (contenant chacune deux notes distinctes)
975 sont combinées simultanément.
977 @lilypond[quote,ragged-right,verbatim]
987 Notez que nous avons ici indenté chaque niveau du fichier d'entrée avec
988 un nombre d'espaces différent. LilyPond se moque de l'espace qu'il peut
989 y avoir (ou pas) au début d'une ligne, mais en indentant votre code vous
990 le rendrez bien plus facile à lire pour les humains.
992 @strong{Attention} : chaque note saisie est relative à la précédente,
993 mais pas au @code{c''} de la commande @code{\relative} de départ.
996 @subheading Simultaneous music expressions: single staff
998 Pour déterminer le nombre de portées, LilyPond regarde le premier
999 élément autre qu'une accolade. Si c'est une seule note, il y a une
1000 portée ; si c'est une expression simultanée, il y aura plus d'une
1003 @lilypond[quote,ragged-right,verbatim]
1006 << { e f } { c <<b d>> } >>
1011 @cindex expression musicale
1012 @subheading Analogy: mathematical expressions
1014 Ce mécanisme est similaire au formules mathématiques : une grosse
1015 formule est créée en assemblant plusieurs petites formules. Ces types
1016 de formules, appelées expressions, ont une définition récursive, de
1017 telle sorte que vous pouvez fabriquer des expressions arbitrairement
1018 longues et complexes. Par exemple,
1027 ((1 + 2) * 3) / (4 * 5)
1030 Ceci est une suite d'expressions, où chacune est contenue dans la
1031 suivante. Les expressions les plus simples sont les nombres, et de plus
1032 grandes expressions sont produites en combinant des expressions avec des
1033 opérateurs --- comme @samp{+}, @samp{*} et @samp{/} --- et des
1034 parenthèses. Tout comme les expressions mathématiques, les expressions
1035 musicales peuvent être imbriquées avec une profondeur arbitraire, ce qui
1036 est nécessaire pour de la musique complexe comme des partitions
1040 @node Multiple staves
1041 @subsection Multiple staves
1043 Comme nous l'avons vu dans @ref{Music expressions explained}, un fichier
1044 d'entrée LilyPond est fait d'expressions musicales. Si la partition
1045 commence par plusieurs expressions simultanées, LilyPond créera
1046 plusieurs portées. Cependant, il est plus facile de voir ce qu'il
1047 advient si l'on crée explicitement chacune des portées.
1049 Pour créer plus d'une portée, chaque partie de la musique constituant
1050 une portée est entrée en la faisant précéder de @code{\new Staff}. Ces
1051 éléments @code{Staff} sont ensuite combinés en parallèle avec @code{<<}
1052 et @code{>>}, comme ceci :
1054 @lilypond[quote,ragged-right,verbatim]
1057 \new Staff { \clef treble c }
1058 \new Staff { \clef bass c,, }
1064 La commande @code{\new} introduit un @qq{contexte de notation}. Un
1065 contexte de notation est un environnement dans lequel les événements
1066 musicaux --- comme les notes ou les commandes @code{\clef} --- sont
1067 interprétés. Pour des pièces simples, ces contextes sont créés
1068 automatiquement. Pour des pièces plus complexes, il est préférable de
1069 spécifier explicitement les contextes. Cela assure que chaque fragment
1070 aura sa propre portée.
1072 Il existe différents types de contextes. Les contextes @code{Staff}
1073 (portée), @code{Voice} (voix) et @code{Score} (partition) gèrent la
1074 notation de la mélodie, alors que @code{Lyrics} gère les paroles et
1075 @code{ChordNames} imprime le nom des accords.
1077 En termes de syntaxe, faire précéder une expression musicale de
1078 @code{\new} crée une plus grosse expression musicale. En reprenant la
1079 comparaison, cela ressemble au signe @qq{moins} en mathématiques. La
1080 formule @math{(4+5)} est une expression, donc @math{-(4+5)} est une plus
1083 Les chiffres de métrique indiqués sur une portée affectent toutes les
1084 autres portées@footnote{Ce comportement peut être modifié si nécessaire,
1085 voir @ruser{Polymetric notation}.}. En revanche l'armure d'une portée
1086 n'affecte @emph{pas} les autres portées.
1088 @lilypond[quote,ragged-right,verbatim]
1091 \new Staff { \clef treble \time 3/4 c }
1092 \new Staff { \clef bass \key d \major c,, }
1101 @subsection Piano staves
1103 @cindex changement de portée manuel
1104 @cindex voix changeant manuellement de portée
1105 La musique pour piano s'écrit sur deux portées reliées par une accolade.
1106 Imprimer ce type de portée revient au même que dans l'exemple de musique
1107 polyphonique de @ref{Multiple staves}, mais maintenant cette expression
1108 entière doit être interprétée dans un contexte @code{PianoStaff} :
1117 Voici un bref exemple :
1119 @lilypond[quote,ragged-right,verbatim]
1122 \new Staff { \time 2/4 c4 e g g, }
1123 \new Staff { \clef bass c,, c' e c }
1130 Voir @ruser{Keyboard instruments}.
1134 @node Combining notes into chords
1135 @subsection Combining notes into chords
1138 Des accords peuvent être produits en entourant les hauteurs de notes
1139 par des angles gauche et droit --- @samp{<} et @samp{>} ---
1141 @lilypond[quote,fragment,verbatim,relative=2,fragment]
1142 r4 <c e g>4 <c f a>2
1145 Vous pouvez combiner les indications comme les liaisons et les ligatures
1146 de croches avec les accords. Ils doivent cependant être placés en
1149 @lilypond[quote,fragment,verbatim,relative=2,fragment]
1150 r4 <c e g>8[ <c f a>]~ <c f a>2
1153 @lilypond[quote,fragment,verbatim,relative=2,fragment]
1154 r4 <c e g>8\>( <c e g> <c e g>4 <c f a>\!)
1158 @node Single staff polyphony
1159 @subsection Single staff polyphony
1162 @cindex voix multiples sur une portée
1163 Quand différentes lignes mélodiques sont combinées sur une seule et même
1164 portée, elles sont imprimées comme des voix polyphoniques ; chaque voix
1165 a ses propre hampes@footnote{familièrement appelées queues de note.},
1166 liaisons et ligatures, la voix supérieure ayant les hampes vers le haut,
1167 la voix inférieure vers le bas.
1169 Ce type de partition est réalisé en entrant chaque voix comme une
1170 séquence (avec @code{@{...@}}), en combinant simultanément les voix et
1171 en les séparant par @code{\\} :
1174 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
1181 Pour l'écriture de musique polyphonique, les silences invisibles
1182 s'avèrent bien pratiques : ce sont des silences qui ne s'impriment pas.
1183 Ils sont utiles pour remplir des voix qui, temporairement, ne jouent
1184 rien. On peut voir ici le même exemple avec un silence invisible
1185 (@code{s}) à la place d'un silence normal (@code{r}) :
1187 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
1195 Là encore, ces expressions peuvent s'imbriquer arbitrairement :
1197 @lilypond[quote,fragment,verbatim,relative=2,fragment]
1205 { <c g>1 ~ <c g>4 } \\
1213 Voir @ruser{Basic polyphony}.
1220 Cette section présente l'écriture vocale et les partitions de variété.
1228 @node Printing lyrics
1229 @subsection Printing lyrics
1233 Prenons une mélodie toute simple :
1235 @lilypond[quote,ragged-right,verbatim]
1242 Des paroles peuvent être associées à ces notes, en les combinant avec la
1243 commande @code{\addlyrics}. Les paroles sont entrées en séparant chaque
1244 syllable par un espace :
1246 @lilypond[quote,ragged-right,verbatim]
1252 \addlyrics { One day this shall be free }
1257 @cindex ligne d'extension
1258 Cette mélodie se termine sur un @rglos{melisma}, c'est-à-dire qu'une
1259 seule syllable (@qq{free}) correspond à plus d'une note. Ceci est
1260 indiqué avec une @emph{ligne d'extension}. Elle est entrée avec deux
1261 caractères souligné (@code{_}), c'est-à-dire :
1263 @lilypond[quote,ragged-right,verbatim]
1269 \addlyrics { One day this shall be free __ }
1273 De la même manière, les séparations syllabiques d'un mot peuvent être
1274 entrées avec deux tirets (@code{-}), ce qui produit un tiret centré
1275 entre les deux syllabes :
1277 @c no ragged-right here because otherwise the hypens get lost.
1278 @lilypond[quote,verbatim]
1284 \addlyrics { A -- le -- gri -- a }
1290 Plus de possibilités, comme celle d'ajouter plusieurs lignes de paroles
1291 en dessous d'une même mélodie sont exposées dans @ruser{Vocal music}.
1296 @subsection A lead sheet
1298 @cindex partition de chanson
1299 @cindex chanson, partition complète
1300 @cindex accords, noms
1301 @cindex noms d'accords
1303 En musique de variété, il est courant d'indiquer l'accompagnement par le
1304 nom des accords. De tels accords peuvent être entrés comme les notes :
1306 @lilypond[quote,ragged-right,verbatim]
1307 \chordmode { c2 f4. g8 }
1310 Maintenant, chaque hauteur est lue comme la base de l'accord à la place
1311 de la note. Ce mode est activé avec @code{\chordmode}. D'autres
1312 accords peuvent être créés en ajoutant des modificateurs après deux
1313 points. L'exemple suivant montre quelques modificateurs usuels :
1315 @lilypond[quote,verbatim,ragged-right]
1316 \chordmode { c2 f4:m g4:maj7 gis1:dim7 }
1319 Pour la musique improvisée, les accords ne sont pas imprimés sur des
1320 portées mais comme des lignes à part entière. Ceci s'obtient en
1321 utilisant @code{\chords} à la place de @code{\chordmode}. La même
1322 syntaxe sera utilisée que dans le cas de@code{\chordmode}, mais le rendu
1323 des notes interviendra dans un contexte @code{ChordNames}, avec le
1326 @lilypond[quote,verbatim,ragged-right]
1327 \chords { c2 f4.:m g4.:maj7 gis8:dim7 }
1330 @cindex partition de chanson
1331 @cindex chanson, partition complète
1332 Une fois assemblés, les accords, paroles et mélodie forment une
1333 partition de chanson :
1335 @lilypond[quote,verbatim,ragged-right]
1337 \chords { c2 g:sus4 f e }
1342 \addlyrics { One day this shall be free __ }
1349 Une liste complète de modificateurs et d'autres options de mise en forme
1350 se trouve à la section @ruser{Chord notation}.
1355 @section Final touches
1357 L'ultime section de ce tutoriel montre comment ajouter une touche finale
1358 à des morceaux simples, et consititue une introduction au reste du
1364 * Absolute note names::
1365 * Organizing pieces with identifiers::
1366 * After the tutorial::
1367 * How to read the manual::
1371 @node Version number
1372 @subsection Version number
1375 La déclaration @code{\version} stipule le numéro de la version de
1376 LilyPond pour laquelle le fichier a été écrit,
1379 \version @w{"@version{}"}
1383 que l'on place par convention en début de fichier.
1385 Cette annotation permet de faciliter les prochaines mises à jour de
1386 LilyPond. Les changements dans la syntaxe sont gérés avec un programme
1387 spécial, @file{convert-ly} --- voir @rprogram{Updating files with convert-ly}
1388 --- et il utilise @code{\version} pour déterminer les règles de
1389 conversion à appliquer au fichier.
1393 @subsection Adding titles
1395 Les informations bibliographiques (nom du morceau, du compositeur, etc)
1396 sont entrées dans un bloc séparé, le bloc d'en-tête (@code{\header}),
1397 qui existe indépendamment des expressions musicales principales. Le
1398 bloc @code{\header} est habituellement placé en début de fichier.
1409 @dots{} music @dots{}
1412 Quand le fichier est traité, le titre et le compositeur sont imprimés en
1413 haut de la partition. Vous trouverez plus d'informations sur les titres
1414 à @ruser{Creating titles}.
1416 @node Absolute note names
1417 @subsection Absolute note names
1419 Jusqu'ici nous n'avons utilisé que le mode @code{\relative} pour définir
1420 les hauteurs de notes. Si c'est effectivement le moyen le plus simple
1421 d'entrer la majeure partie de votre musique, il existe une autre façon
1422 de procéder : le mode des hauteurs absolues.
1424 Si vous omettez la commande @code{\relative}, LilyPond considérera
1425 toutes les hauteurs comme des hauteurs absolues. Un @code{c'} sera
1426 toujours un do du milieu, un @code{b} sera toujours une note au-dessous
1427 du précédent, et un @code{g,} sera toujours la note la plus grave dans
1428 la portée de clé de fa.
1430 @lilypond[quote,verbatim,ragged-right]
1438 Voici une gamme sur 4 octaves :
1440 @lilypond[quote,verbatim,ragged-right]
1455 Comme vous pouvez le voir, il faut beaucoup d'apostrophes pour écrire de
1456 la musique dans un registre aigu. Regardez cet extrait de Mozart :
1458 @lilypond[quote,verbatim,ragged-right]
1462 cis''8. d''16 cis''8 e''4 e''8
1463 b'8. cis''16 b'8 d''4 d''8
1467 Toutes ces apostrophes rendent le fichier moins lisible, et c'est donc
1468 une source d'erreurs. En mode @code{\relative}, le même exemple devient
1469 bien plus facile à lire :
1471 @lilypond[quote,verbatim,ragged-right]
1475 cis8. d16 cis8 e4 e8
1480 Si d'aventure vous faites une erreur d'octaviation, le mode
1481 @code{\relative} la rendra frappante --- toutes les notes suivantes
1482 seront placées à la mauvaise octave. En mode de hauteurs absolues, une
1483 erreur isolée ne serait pas auntant visible, et donc aussi facile à
1486 Cependant, le mode de hauteurs absolues reste utile pour les musiques où
1487 les intervalles sont étendus, surtout pour les fichiers LilyPond créés
1491 @node Organizing pieces with identifiers
1492 @subsection Organizing pieces with identifiers
1494 Lorsque l'on combine tous les éléments étudiés plus haut pour produire
1495 des fichiers plus volumineux, les blocs @code{\score} deviennent
1496 beaucoup plus gros parce que les expressions musicales sont plus longues
1497 et, dans le cas des pièces polyphoniques, profondément imbriquées. De
1498 telles expressions imposantes finissent par devenir peu maniables. Cet
1499 inconvénient peut être résolu par l'utilisation
1500 d'@emph{identificateurs}.
1502 En utilisant ces identificateurs, que l'on pourrait aussi appeler
1503 variables ou macros, il est possible de découper des expressions
1504 musicales complexes. Un identificateur se définit comme suit :
1507 MusiqueToto = @{ @dots{} @}
1510 Le contenu de l'expression musicale @code{MusiqueToto} pourra être
1511 utilisé plus loin en faisant précéder son nom d'un anti-slash,
1512 c'est-à-dire @code{\MusiqueToto}, juste comme n'importe quelle commande
1513 LilyPond. Tous les identificateurs doivent être définis @emph{avant}
1514 l'expression musicale principale.
1516 @lilypond[quote,verbatim,ragged-right]
1517 violin = \new Staff { \relative c'' {
1520 cello = \new Staff { \relative c {
1533 Le nom d'un identificateur ne doit comporter que des caractères
1534 alphabétiques non accentués, aucun nombre ni tiret.
1536 Il est possible d'utiliser des variables de types variés. Par exemple,
1541 aFivePaper = \paper @{ paperheight = 21.0 \cm @}
1544 En fonction de son contenu, un identificateur peut être utilisé à
1545 différents endroits. L'exemple suivant utilise la variable ci-dessus :
1556 @node After the tutorial
1557 @subsection After the tutorial
1559 Après avoir parcouru ce tutoriel, vous devriez vous essayer à écrire un
1560 morceau ou deux. Commencez par copier l'un des @ref{Templates} types et
1561 ajoutez-y des notes. Si vous voulez employer une notation que vous
1562 n'avez pas trouvé dans le tutoriel, consultez la référence de notation,
1563 en commençant par la @ruser{Musical notation}. Si vous désirez écrire pour
1564 un ensemble instrumental non couvert par les @ref{Templates}, lisez la
1565 section @ref{Extending the templates}.
1567 Après avoir écrit quelques pièces courtes, lisez les chapitres 3 à 5 du
1568 manuel d'apprentissage. Rien ne s'oppose à ce que vous consultiez dès à
1569 présent les autres chapitres, bien sûr ! Néanmoins, le reste du manuel
1570 de l'utilisateur part du principe que vous avez déjà bien assimilé la
1571 syntaxe de LilyPond. Vous pouvez toujours survoler le reste du manuel,
1572 et y revenir plus tard après avoir acquis de l'expérience.
1574 @node How to read the manual
1575 @subsection How to read the manual
1577 Comme nous l'avons déjà vu dans @ref{How to read the tutorial}, de
1578 nombreux exemples du tutoriel n'ont pas fait apparaître
1579 @code{\relative c'' @{ ... @}} dans l'extrait de code affiché.
1581 Dans le reste du manuel, les exemples utilisés sont encore beaucoup plus
1582 souples : parfois il leur manque le @code{\relative c'' @{ ... @}},
1583 mais d'autres fois ils ont recours à une autre hauteur de référence,
1584 telle que @code{c'} ou @code{c,,}), et dans certains cas c'est même
1585 l'exemple entier qui est en mode de hauteurs absolues ! Cependant, de
1586 telles ambiguïtés ne se trouvent que dans des contextes où les hauteurs
1587 n'ont que peu d'importance. Dans tous les exemples où elles en ont, le
1588 mode @code{\relative} ou absolu @code{@{ @}} est explicitement spécifié.
1590 Si vous ne vous y retrouvez toujours pas pour savoir quel code LilyPond
1591 produit précisément tel ou tel exemple, consultez la version HTML de ce
1592 manuel si ce n'est pas déjà le cas, et cliquez sur l'image de la
1593 partition. La source exacte utilisée pour générer ce manuel s'affichera
1596 Pour en savoir plus sur l'organisation de la suite de ce manuel,
1597 reportez-vous à @ref{About the documentation}.