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 @ruser{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 @ruser{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 @ruser{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 @ruser{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{d} ne veut pas dire @qq{Imprimez-moi un point noir juste
665 en-dessous de la portée.} Cela signifie plutôt : @qq{Ici se trouve
667 hauteur est un ré naturel.} Avec l'armure de la bémol majeur, ce ré
669 d'un bécarre accidentel :
671 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
676 Ajouter explicitement toutes les altérations requiert un peu plus
677 d'effort dans la phase de saisie, mais la transposition en sera
678 grandement facilitée.
679 De plus les altérations accidentelles
680 peuvent être imprimées suivant plusieurs conventions. Regardez
681 @ruser{Automatic accidentals} pour connaître les différentes manières dont les
682 altérations accidentelles peuvent être imprimées, suivant les règles
688 @item Les altérations
689 voir @ruser{Accidentals} and @ruser{Automatic accidentals}.
691 voir @ruser{Key signature}.
697 @subsection Ties and slurs
699 @cindex liaisons de prolongation
701 Une @rglos{tie}@footnote{parfois aussi appelée liaison de
702 tenue} se crée en ajoutant un tilde @samp{~} à la première note liée.
704 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
709 @cindex liaisons d'articulation
712 @c Le terme de "slur" a deux sens en français : articulation et phrasé.
713 @c Je garde ici le terme "legato", tel qu'il apparaît dans le texte original,
714 @c car c'est celui qui me semble le plus couramment employé.
716 Une @rglos{slur} d'articulation (ou @qq{legato}) peut englober
717 plusieurs notes. Les notes de départ et d'arrivée reçoivent
718 respectivement un signe @samp{(} et @samp{)}.
720 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
721 d4( c16) cis( d e c cis d) e( d4)
724 @cindex liaisons de phrasé
725 @subheading Phrasing slurs
727 De plus longues liaisons, dites de phrasé, sont délimitées par @code{\(} et
728 @code{\)}. Il est possible d'avoir en même temps des legatos et des
729 phrasés, mais pas plusieurs liaisons de phrasé ou de legato à la fois.
731 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
732 a8(\( ais b c) cis2 b'2 a4 cis,\)
737 @cindex liaisons de phrasé et de prolongation, différences
738 @subheading Warnings: slurs vs. ties
740 Une liaison d'articulation ou de phrasé ressemble à une liaison de
741 tenue, mais n'a pas la même signification. Alors qu'une liaison de
742 tenue ne peut relier que deux notes de même hauteur, le legato indique
743 une articulation de plusieurs notes, éventuellement nombreuses. Les
744 liaisons de tenue peuvent être enchâssées dans un legato ou un phrasé.
746 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
747 c2~( c8 fis fis4 ~ fis2 g2)
755 @item @ruser{Phrasing slurs}.
760 @node Articulation and dynamics
761 @subsection Articulation and dynamics
766 @subheading Articulations
768 Des @rglos{articulation}s peuvent être ajoutées à une note, au moyen
769 d'un tiret @samp{-} suivi d'un caractère :
771 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
772 c-. c-- c-> c-^ c-+ c-_
776 @subheading Fingerings
777 De même, des indications de doigté peuvent être ajoutées à une note en
778 utilisant un tiret (@samp{-}) et le chiffre à écrire :
780 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
784 Articulations et doigtés sont habituellement placés automatiquement,
785 mais vous pouvez spécifier une direction en utilisant @samp{^} (en haut)
786 ou @samp{_} (en bas). Vous pouvez aussi utiliser plusieurs
787 articulations sur la même note. Dans la plupart des cas, cependant, il
788 est mieux de laisser LilyPond déterminer l'emplacement de
791 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
792 c_-^1 d^. f^4_2-> e^-_+
796 Les signes de nuances sont obtenus en ajoutant à la note les noms des nuances,
797 précédées d'un anti-slash @samp{\} :
799 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
807 @c Pluriel des termes musicaux italiens :
808 @c selon Littré, plutôt à la française (en "-os" qu'en "-i")
810 Crescendos et decrescendos débutent avec les commandes @code{\<} et
811 @code{\>}. Ils se terminent soit par une nuance d'arrivée, par exemple
812 @code{\f}, soit par la commande @code{\!} :
814 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
821 @item @ruser{Articulations}.
822 @item @ruser{Fingering instructions}.
823 @item @ruser{Dynamics}.
828 @node Automatic and manual beams
829 @subsection Automatic and manual beams
831 @cindex ligatures manuelles
832 Toutes les @rglos{beam} sont dessinées automatiquement :
834 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
835 a8 ais d ees r d c16 b a8
839 Lorsqu'on n'aime pas la manière dont les notes sont automatiquement
840 groupées, il est possible de les ligaturer manuellement, en marquant la
841 première note à attacher d'un @samp{[} et la dernière d'un @samp{]}.
843 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
844 a8[ ais] d[ ees r d] a b
850 @item Groupements de notes et ligatures automatiques
851 voir @ruser{Automatic beams}.
852 @item Groupements et ligatures manuels
853 voir @ruser{Manual beams}.
858 @node Advanced rhythmic commands
859 @subsection Advanced rhythmic commands
863 @cindex mesure incomplète
864 @subheading Partial measure
866 Une levée (ou @rglos{anacrusis}) est entrée avec la commande
867 @code{\partial}, suivie d'une durée : @code{\partial 4} est une levée
868 d'une noire et @code{\partial 8} d'une croche.
870 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
878 Les nolets sont créés avec la commande @code{\times}, qui prend deux
879 arguments : une fraction et une expression musicale. La durée des notes
880 de l'expression musicale est multipliée par la fraction. Par exemple
881 les notes d'un triolet durent les deux tiers du temps de leur notation
882 réelle, cette fraction est donc de 2/3 pour les triolets :
884 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
885 \times 2/3 { f8 g a }
887 \times 2/3 { f,8 g16[ a g a] }
891 @cindex notes d'ornement
892 @cindex ornementation
894 @subheading Grace notes
896 Des notes d'ornement sont produites par la commande @code{\grace}, mais
897 aussi en préfixant une expression musicale avec le mot-clé
898 @code{\appoggiatura} ou @code{\acciaccatura} :
900 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
901 c2 \grace { a32[ b] } c2
902 c2 \appoggiatura b16 c2
903 c2 \acciaccatura b16 c2
909 @item Notes d'ornement
910 voir @ruser{Grace notes},
912 voir @ruser{Tuplets},
914 voir @ruser{Partial measures}.
919 @node Multiple notes at once
920 @section Multiple notes at once
922 Cette section traite des situations où l'on a plus d'une note à la fois
923 : plusieurs instruments, plusieurs portées pour un même instrument (le
924 piano, par exemple), et les accords.
926 La polyphonie, en théorie musicale, est la notion d'une musique
927 constituée de plusieurs voix ; dans lilypond, ce terme désigne les
928 situations où il y a plus d'une voix sur une même portée.
931 * Music expressions explained::
934 * Combining notes into chords::
935 * Single staff polyphony::
939 @node Music expressions explained
940 @subsection Music expressions explained
942 Dans les fichiers source LilyPond, la musique est représentée par ce
943 qu'on appelle des @emph{expressions musicales}. En soi, une seule note
944 peut constituer une expression musicale, si tant est qu'elle soit
945 correctement encadrée :
947 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
951 Mettre un groupe de notes entre accolades crée une nouvelle expression
954 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
958 Placer une séquence d'expressions musicales --- des notes par exemple
959 --- entre accolades signifie qu'elles doivent être jouées
960 successivement, les unes après les autres. Le résultat est une
961 expression, qui peut elle-même être regroupée séquentiellement avec
962 d'autres expressions. Ici, l'expression de l'exemple précédent est
963 combinée à deux notes :
965 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
969 @subheading Simultaneous music expressions: multiple staves
971 Cette technique est utile pour de la musique polyphonique. Pour entrer
972 une musique avec plusieurs voix ou plusieurs portées, nous pouvons aussi
973 combiner en parallèle les expressions. Deux voix qui doivent être
974 jouées en même temps, sont entrées comme une combinaison simultanée de
975 deux expressions. Une expression musicale @q{simultanée} est formée en
976 entourant les expressions entre @code{<<} et @code{>>}. Dans l'exemple
977 suivant, trois expressions (contenant chacune deux notes distinctes)
978 sont combinées simultanément.
980 @lilypond[quote,ragged-right,verbatim]
990 Notez que nous avons ici indenté chaque niveau du fichier d'entrée avec
991 un nombre d'espaces différent. LilyPond se moque de l'espace qu'il peut
992 y avoir (ou pas) au début d'une ligne, mais en indentant votre code vous
993 le rendrez bien plus facile à lire pour les humains.
995 @strong{Attention} : chaque note saisie est relative à la précédente,
996 mais pas au @code{c''} de la commande @code{\relative} de départ.
999 @subheading Simultaneous music expressions: single staff
1001 Pour déterminer le nombre de portées, LilyPond regarde le premier
1002 élément autre qu'une accolade. Si c'est une seule note, il y a une
1003 portée ; si c'est une expression simultanée, il y aura plus d'une
1006 @lilypond[quote,ragged-right,verbatim]
1009 << { e f } { c <<b d>> } >>
1014 @cindex expression musicale
1015 @subheading Analogy: mathematical expressions
1017 Ce mécanisme est similaire au formules mathématiques : une grosse
1018 formule est créée en assemblant plusieurs petites formules. Ces types
1019 de formules, appelées expressions, ont une définition récursive, de
1020 telle sorte que vous pouvez fabriquer des expressions arbitrairement
1021 longues et complexes. Par exemple,
1030 ((1 + 2) * 3) / (4 * 5)
1033 Ceci est une suite d'expressions, où chacune est contenue dans la
1034 suivante. Les expressions les plus simples sont les nombres, et de plus
1035 grandes expressions sont produites en combinant des expressions avec des
1036 opérateurs --- comme @samp{+}, @samp{*} et @samp{/} --- et des
1037 parenthèses. Tout comme les expressions mathématiques, les expressions
1038 musicales peuvent être imbriquées avec une profondeur arbitraire, ce qui
1039 est nécessaire pour de la musique complexe comme des partitions
1043 @node Multiple staves
1044 @subsection Multiple staves
1046 Comme nous l'avons vu dans @ruser{Music expressions explained}, un fichier
1047 d'entrée LilyPond est fait d'expressions musicales. Si la partition
1048 commence par plusieurs expressions simultanées, LilyPond créera
1049 plusieurs portées. Cependant, il est plus facile de voir ce qu'il
1050 advient si l'on crée explicitement chacune des portées.
1052 Pour créer plus d'une portée, chaque partie de la musique constituant
1053 une portée est entrée en la faisant précéder de @code{\new Staff}. Ces
1054 éléments @code{Staff} sont ensuite combinés en parallèle avec @code{<<}
1055 et @code{>>}, comme ceci :
1057 @lilypond[quote,ragged-right,verbatim]
1060 \new Staff { \clef treble c }
1061 \new Staff { \clef bass c,, }
1067 La commande @code{\new} introduit un @qq{contexte de notation}. Un
1068 contexte de notation est un environnement dans lequel les événements
1069 musicaux --- comme les notes ou les commandes @code{\clef} --- sont
1070 interprétés. Pour des pièces simples, ces contextes sont créés
1071 automatiquement. Pour des pièces plus complexes, il est préférable de
1072 spécifier explicitement les contextes. Cela assure que chaque fragment
1073 aura sa propre portée.
1075 Il existe différents types de contextes. Les contextes @code{Staff}
1076 (portée), @code{Voice} (voix) et @code{Score} (partition) gèrent la
1077 notation de la mélodie, alors que @code{Lyrics} gère les paroles et
1078 @code{ChordNames} imprime le nom des accords.
1080 En termes de syntaxe, faire précéder une expression musicale de
1081 @code{\new} crée une plus grosse expression musicale. En reprenant la
1082 comparaison, cela ressemble au signe @qq{moins} en mathématiques. La
1083 formule @math{(4+5)} est une expression, donc @math{-(4+5)} est une plus
1086 Les chiffres de métrique indiqués sur une portée affectent toutes les
1087 autres portées@footnote{Ce comportement peut être modifié si nécessaire,
1088 voir @ruser{Polymetric notation}.}. En revanche l'armure d'une portée
1089 n'affecte @emph{pas} les autres portées.
1091 @lilypond[quote,ragged-right,verbatim]
1094 \new Staff { \clef treble \time 3/4 c }
1095 \new Staff { \clef bass \key d \major c,, }
1104 @subsection Piano staves
1106 @cindex changement de portée manuel
1107 @cindex voix changeant manuellement de portée
1108 La musique pour piano s'écrit sur deux portées reliées par une accolade.
1109 Imprimer ce type de portée revient au même que dans l'exemple de musique
1110 polyphonique de @ruser{Multiple staves}, mais maintenant cette expression
1111 entière doit être interprétée dans un contexte @code{PianoStaff} :
1120 Voici un bref exemple :
1122 @lilypond[quote,ragged-right,verbatim]
1125 \new Staff { \time 2/4 c4 e g g, }
1126 \new Staff { \clef bass c,, c' e c }
1133 Voir @ruser{Piano music}.
1137 @node Combining notes into chords
1138 @subsection Combining notes into chords
1141 Des accords peuvent être produits en entourant les hauteurs de notes
1142 par des angles gauche et droit --- @samp{<} et @samp{>} ---
1144 @lilypond[quote,fragment,verbatim,relative=2,fragment]
1145 r4 <c e g>4 <c f a>2
1148 Vous pouvez combiner les indications comme les liaisons et les ligatures
1149 de croches avec les accords. Ils doivent cependant être placés en
1152 @lilypond[quote,fragment,verbatim,relative=2,fragment]
1153 r4 <c e g>8[ <c f a>]~ <c f a>2
1156 @lilypond[quote,fragment,verbatim,relative=2,fragment]
1157 r4 <c e g>8\>( <c e g> <c e g>4 <c f a>\!)
1161 @node Single staff polyphony
1162 @subsection Single staff polyphony
1165 @cindex voix multiples sur une portée
1166 Quand différentes lignes mélodiques sont combinées sur une seule et même
1167 portée, elles sont imprimées comme des voix polyphoniques ; chaque voix
1168 a ses propre hampes@footnote{familièrement appelées queues de note.},
1169 liaisons et ligatures, la voix supérieure ayant les hampes vers le haut,
1170 la voix inférieure vers le bas.
1172 Ce type de partition est réalisé en entrant chaque voix comme une
1173 séquence (avec @code{@{...@}}), en combinant simultanément les voix et
1174 en les séparant par @code{\\} :
1177 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
1184 Pour l'écriture de musique polyphonique, les silences invisibles
1185 s'avèrent bien pratiques : ce sont des silences qui ne s'impriment pas.
1186 Ils sont utiles pour remplir des voix qui, temporairement, ne jouent
1187 rien. On peut voir ici le même exemple avec un silence invisible
1188 (@code{s}) à la place d'un silence normal (@code{r}) :
1190 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
1198 Là encore, ces expressions peuvent s'imbriquer arbitrairement :
1200 @lilypond[quote,fragment,verbatim,relative=2,fragment]
1208 { <c g>1 ~ <c g>4 } \\
1216 Voir @ruser{Basic polyphony}.
1223 Cette section présente l'écriture vocale et les partitions de variété.
1231 @node Printing lyrics
1232 @subsection Printing lyrics
1236 Prenons une mélodie toute simple :
1238 @lilypond[quote,ragged-right,verbatim]
1245 Des paroles peuvent être associées à ces notes, en les combinant avec la
1246 commande @code{\addlyrics}. Les paroles sont entrées en séparant chaque
1247 syllable par un espace :
1249 @lilypond[quote,ragged-right,verbatim]
1255 \addlyrics { One day this shall be free }
1260 @cindex ligne d'extension
1261 Cette mélodie se termine sur un @rglos{melisma}, c'est-à-dire qu'une
1262 seule syllable (@qq{free}) correspond à plus d'une note. Ceci est
1263 indiqué avec une @emph{ligne d'extension}. Elle est entrée avec deux
1264 caractères souligné (@code{_}), c'est-à-dire :
1266 @lilypond[quote,ragged-right,verbatim]
1272 \addlyrics { One day this shall be free __ }
1276 De la même manière, les séparations syllabiques d'un mot peuvent être
1277 entrées avec deux tirets (@code{-}), ce qui produit un tiret centré
1278 entre les deux syllabes :
1280 @c no ragged-right here because otherwise the hypens get lost.
1281 @lilypond[quote,verbatim]
1287 \addlyrics { A -- le -- gri -- a }
1293 Plus de possibilités, comme celle d'ajouter plusieurs lignes de paroles
1294 en dessous d'une même mélodie sont exposées dans @ruser{Vocal music}.
1299 @subsection A lead sheet
1301 @cindex partition de chanson
1302 @cindex chanson, partition complète
1303 @cindex accords, noms
1304 @cindex noms d'accords
1306 En musique de variété, il est courant d'indiquer l'accompagnement par le
1307 nom des accords. De tels accords peuvent être entrés comme les notes :
1309 @lilypond[quote,ragged-right,verbatim]
1310 \chordmode { c2 f4. g8 }
1313 Maintenant, chaque hauteur est lue comme la base de l'accord à la place
1314 de la note. Ce mode est activé avec @code{\chordmode}. D'autres
1315 accords peuvent être créés en ajoutant des modificateurs après deux
1316 points. L'exemple suivant montre quelques modificateurs usuels :
1318 @lilypond[quote,verbatim,ragged-right]
1319 \chordmode { c2 f4:m g4:maj7 gis1:dim7 }
1322 Pour la musique improvisée, les accords ne sont pas imprimés sur des
1323 portées mais comme des lignes à part entière. Ceci s'obtient en
1324 utilisant @code{\chords} à la place de @code{\chordmode}. La même
1325 syntaxe sera utilisée que dans le cas de@code{\chordmode}, mais le rendu
1326 des notes interviendra dans un contexte @code{ChordNames}, avec le
1329 @lilypond[quote,verbatim,ragged-right]
1330 \chords { c2 f4.:m g4.:maj7 gis8:dim7 }
1333 @cindex partition de chanson
1334 @cindex chanson, partition complète
1335 Une fois assemblés, les accords, paroles et mélodie forment une
1336 partition de chanson :
1338 @lilypond[quote,verbatim,ragged-right]
1340 \chords { c2 g:sus4 f e }
1345 \addlyrics { One day this shall be free __ }
1352 Une liste complète de modificateurs et d'autres options de mise en forme
1353 se trouve à la section @ruser{Chords}.
1358 @section Final touches
1360 L'ultime section de ce tutoriel montre comment ajouter une touche finale
1361 à des morceaux simples, et consititue une introduction au reste du
1367 * Absolute note names::
1368 * Organizing pieces with identifiers::
1369 * After the tutorial::
1370 * How to read the manual::
1374 @node Version number
1375 @subsection Version number
1378 La déclaration @code{\version} stipule le numéro de la version de
1379 LilyPond pour laquelle le fichier a été écrit,
1382 \version @w{"@version{}"}
1386 que l'on place par convention en début de fichier.
1388 Cette annotation permet de faciliter les prochaines mises à jour de
1389 LilyPond. Les changements dans la syntaxe sont gérés avec un programme
1390 spécial, @file{convert-ly} --- voir @rprogram{Updating files with convert-ly}
1391 --- et il utilise @code{\version} pour déterminer les règles de
1392 conversion à appliquer au fichier.
1396 @subsection Adding titles
1398 Les informations bibliographiques (nom du morceau, du compositeur, etc)
1399 sont entrées dans un bloc séparé, le bloc d'en-tête (@code{\header}),
1400 qui existe indépendamment des expressions musicales principales. Le
1401 bloc @code{\header} est habituellement placé en début de fichier.
1412 @dots{} music @dots{}
1415 Quand le fichier est traité, le titre et le compositeur sont imprimés en
1416 haut de la partition. Vous trouverez plus d'informations sur les titres
1417 à @ruser{Creating titles}.
1419 @node Absolute note names
1420 @subsection Absolute note names
1422 Jusqu'ici nous n'avons utilisé que le mode @code{\relative} pour définir
1423 les hauteurs de notes. Si c'est effectivement le moyen le plus simple
1424 d'entrer la majeure partie de votre musique, il existe une autre façon
1425 de procéder : le mode des hauteurs absolues.
1427 Si vous omettez la commande @code{\relative}, LilyPond considérera
1428 toutes les hauteurs comme des hauteurs absolues. Un @code{c'} sera
1429 toujours un do du milieu, un @code{b} sera toujours une note au-dessous
1430 du précédent, et un @code{g,} sera toujours la note la plus grave dans
1431 la portée de clé de fa.
1433 @lilypond[quote,verbatim,ragged-right]
1441 Voici une gamme sur 4 octaves :
1443 @lilypond[quote,verbatim,ragged-right]
1458 Comme vous pouvez le voir, il faut beaucoup d'apostrophes pour écrire de
1459 la musique dans un registre aigu. Regardez cet extrait de Mozart :
1461 @lilypond[quote,verbatim,ragged-right]
1465 cis''8. d''16 cis''8 e''4 e''8
1466 b'8. cis''16 b'8 d''4 d''8
1470 Toutes ces apostrophes rendent le fichier moins lisible, et c'est donc
1471 une source d'erreurs. En mode @code{\relative}, le même exemple devient
1472 bien plus facile à lire :
1474 @lilypond[quote,verbatim,ragged-right]
1478 cis8. d16 cis8 e4 e8
1483 Si d'aventure vous faites une erreur d'octaviation, le mode
1484 @code{\relative} la rendra frappante --- toutes les notes suivantes
1485 seront placées à la mauvaise octave. En mode de hauteurs absolues, une
1486 erreur isolée ne serait pas auntant visible, et donc aussi facile à
1489 Cependant, le mode de hauteurs absolues reste utile pour les musiques où
1490 les intervalles sont étendus, surtout pour les fichiers LilyPond créés
1494 @node Organizing pieces with identifiers
1495 @subsection Organizing pieces with identifiers
1497 Lorsque l'on combine tous les éléments étudiés plus haut pour produire
1498 des fichiers plus volumineux, les blocs @code{\score} deviennent
1499 beaucoup plus gros parce que les expressions musicales sont plus longues
1500 et, dans le cas des pièces polyphoniques, profondément imbriquées. De
1501 telles expressions imposantes finissent par devenir peu maniables. Cet
1502 inconvénient peut être résolu par l'utilisation
1503 d'@emph{identificateurs}.
1505 En utilisant ces identificateurs, que l'on pourrait aussi appeler
1506 variables ou macros, il est possible de découper des expressions
1507 musicales complexes. Un identificateur se définit comme suit :
1510 MusiqueToto = @{ @dots{} @}
1513 Le contenu de l'expression musicale @code{MusiqueToto} pourra être
1514 utilisé plus loin en faisant précéder son nom d'un anti-slash,
1515 c'est-à-dire @code{\MusiqueToto}, juste comme n'importe quelle commande
1516 LilyPond. Tous les identificateurs doivent être définis @emph{avant}
1517 l'expression musicale principale.
1519 @lilypond[quote,verbatim,ragged-right]
1520 violin = \new Staff { \relative c'' {
1523 cello = \new Staff { \relative c {
1536 Le nom d'un identificateur ne doit comporter que des caractères
1537 alphabétiques non accentués, aucun nombre ni tiret.
1539 Il est possible d'utiliser des variables de types variés. Par exemple,
1544 aFivePaper = \paper @{ paperheight = 21.0 \cm @}
1547 En fonction de son contenu, un identificateur peut être utilisé à
1548 différents endroits. L'exemple suivant utilise la variable ci-dessus :
1559 @node After the tutorial
1560 @subsection After the tutorial
1562 Après avoir parcouru ce tutoriel, vous devriez vous essayer à écrire un
1563 morceau ou deux. Commencez par copier l'un des @ruser{Templates} types et
1564 ajoutez-y des notes. Si vous voulez employer une notation que vous
1565 n'avez pas trouvé dans le tutoriel, consultez la référence de notation,
1566 en commençant par la @ruser{Basic notation}. Si vous désirez écrire pour
1567 un ensemble instrumental non couvert par les @ruser{Templates}, lisez la
1568 section @ruser{Extending the templates}.
1570 Après avoir écrit quelques pièces courtes, lisez les chapitres 3 à 5 du
1571 manuel d'apprentissage. Rien ne s'oppose à ce que vous consultiez dès à
1572 présent les autres chapitres, bien sûr ! Néanmoins, le reste du manuel
1573 de l'utilisateur part du principe que vous avez déjà bien assimilé la
1574 syntaxe de LilyPond. Vous pouvez toujours survoler le reste du manuel,
1575 et y revenir plus tard après avoir acquis de l'expérience.
1577 @node How to read the manual
1578 @subsection How to read the manual
1580 Comme nous l'avons déjà vu dans @ruser{How to read the tutorial}, de
1581 nombreux exemples du tutoriel n'ont pas fait apparaître
1582 @code{\relative c'' @{ ... @}} dans l'extrait de code affiché.
1584 Dans le reste du manuel, les exemples utilisés sont encore beaucoup plus
1585 souples : parfois il leur manque le @code{\relative c'' @{ ... @}},
1586 mais d'autres fois ils ont recours à une autre hauteur de référence,
1587 telle que @code{c'} ou @code{c,,}), et dans certains cas c'est même
1588 l'exemple entier qui est en mode de hauteurs absolues ! Cependant, de
1589 telles ambiguïtés ne se trouvent que dans des contextes où les hauteurs
1590 n'ont que peu d'importance. Dans tous les exemples où elles en ont, le
1591 mode @code{\relative} ou absolu @code{@{ @}} est explicitement spécifié.
1593 Si vous ne vous y retrouvez toujours pas pour savoir quel code LilyPond
1594 produit précisément tel ou tel exemple, consultez la version HTML de ce
1595 manuel si ce n'est pas déjà le cas, et cliquez sur l'image de la
1596 partition. La source exacte utilisée pour générer ce manuel s'affichera
1599 Pour en savoir plus sur l'organisation de la suite de ce manuel,
1600 reportez-vous à @ruser{About this manual}.