1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
2 @c This file is part of lilypond.tely
4 Translation of GIT committish: 8bf657e5c944bd8da26af01d6a021b48e74ff10a
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?
40 Ce tutoriel commence par une introduction au langage musical utilisé
41 par LilyPond, qui vous permettra de faire fonctionner le logiciel pour
42 produire une partition. Après ce premier contact, nous verrons comment
43 créer des partitions utilisant une notation musicale courante.
46 Beaucoup de gens apprennent à utiliser les programmes en les essayant
47 et en bidouillant avec. C'est également possible avec LilyPond. Si
48 vous cliquez sur une image dans la version HTML de ce manuel, vous
49 verrez exactement le code LilyPond utilisé pour générer cette image.
50 Essayez sur cette image :
54 @lilypond[quote,ragged-right]
56 c-\markup { \bold \huge { Cliquez ici. } }
60 En copiant et en collant tout le code de l'extrait ly dans un fichier
61 test, vous aurez un modèle de base pour faire vos expériences. Si vous
62 apprenez de cette façon, vous aurez probablement envie d'imprimer ou de
63 garder un lien vers la @ref{Cheat sheet}, tableau qui répertorie les
64 commandes usuelles pour une consultation rapide.
69 * Single staff notation::
70 * Multiple notes at once::
79 Cette section présente sommairement la façon de travailler avec LilyPond.
84 * Working on text files::
85 * How to read the tutorial::
89 @node Compiling a file
90 @subsection Compiling a file
92 Le premier exemple montre comment débuter avec LilyPond. Pour créer
93 une partition, on écrit un fichier de texte qui décrit la notation
94 musicale. Par exemple, si l'on écrit
103 le résultat ressemblera à
105 @c in this case we don't want verbatim
106 @lilypond[quote,ragged-right]
113 Il est aussi possible d'utiliser les noms de notes français @samp{do
114 re mi fa sol la si}, en insérant au début du fichier la ligne
115 @samp{\include "italiano.ly"}
118 @emph{Attention :} tout extrait de code LilyPond doit être entouré
119 d'une @{paire d'accolades@}. De plus, pour éviter toute ambiguïté, il
120 est préférable d'entourer les accolades par des espaces ou retours à
121 la ligne. Bien que certains exemples de ce manuel ne comportent pas
122 d'accolades, ne les oubliez pas dans vos partitions !
124 @cindex Case sensitive
125 De plus, LilyPond est sensible à la casse. @code{ @{ c d e @} } est
126 un code valide ; @code{ @{ C D E @} } produira un message d'erreur.
130 @subheading Entering music and viewing output
132 Dans cette section nous expliquerons quelles commandes exécuter et
133 comment voir ou imprimer le résultat de LilyPond.
135 @subsubheading MacOS X
137 Si vous double-cliquez sur @code{LilyPond.app}, un fichier d'exemple
138 s'ouvrira. Sauvegardez-le, par exemple, sous @file{test.ly} sur votre
139 bureau, et traitez-le ensuite avec la commande du menu @samp{Compile >
140 Typeset File}. Le fichier PDF résultant sera alors affiché sur votre
143 Notez que le premier démarrage peut prendre une minute ou deux, car
144 toutes les polices système doivent être d'abord analysées.
146 À l'avenir, vous aurez certainement recours aux commandes @qq{Nouveau}
147 ou @qq{Ouvrir}. Vous devez enregistrer votre fichier avant de lancer
148 la création de la partition. Si une erreur advient pendant le
149 traitement, vous la trouverez dans la fenêtre @qq{log}.
151 @subsubheading Windows
153 Sous Windows, lorsque vous double-cliquez sur l'icône LilyPond qui se
154 trouve sur le Bureau, un fichier d'exemple s'ouvre dans un simple
155 éditeur de texte. Enregistrez-le, par exemple en tant que
156 @file{test.ly} sur votre Bureau, puis double-cliquez sur son icône
157 (qui montre une note de musique) pour le traiter. Après quelques
158 secondes, vous obtiendrez un fichier @file{test.pdf} sur votre Bureau,
159 fichier que vous pourrez ouvrir pour voir la partition imprimée. Une
160 autre méthode pour lancer le traitement du fichier @file{test.ly} est
161 de le glisser avec votre souris sur l'icône de LilyPond.
163 Pour modifier un fichier @file{.ly} existant, faites un clic droit
164 dessus et sélectionnez @qq{Éditer la source}. Pour partir d'un
165 fichier vide, lancez l'éditeur en ouvrant un fichier existant et
166 utilisez la commande @qq{New} du menu @qq{File}.
168 En double-cliquant sur le fichier, vous obtiendrez, en plus du fichier
169 PDF, un fichier @file{.log} qui récapitule les opérations que LilyPond
170 a effectuées sur votre fichier. Si une erreur advient, c'est ce
171 fichier qu'il vous faudra étudier.
173 Notez qu'il existe d'autres éditeurs de texte, certains disposant d'un
174 meilleur support pour LilyPond ; reportez-vous à @ref{Editor support}.
179 Commencez par ouvrir une fenêtre de terminal et un éditeur de
180 texte. Par exemple, vous pouvez ouvrir un xterm et exécuter
181 @code{joe}. @footnote{Il existe des fichiers de macros pour les fans
183 @code{LilyPond-mode} pour les fans d'Emacs. S'ils ne sont pas
184 encore installés, consultez le fichier @file{INSTALL.txt}. L'outil
185 d'édition le plus facile d'utilisation est de loin
186 @file{LilyPondTool}. Vous trouverez plus d'informations dans
187 @ref{Editor support}.} Dans votre
188 éditeur, entrez le texte suivant et sauvegardez le fichier sous
198 Pour traiter @file{test.ly}, procédez comme ceci :
205 Vous verrez quelque chose ressemblant à :
212 Interpreting music... [1]
213 Preprocessing graphical objects...
214 Calculating line breaks... [2]
215 Layout output to `test.ps'...
216 Converting to `test.pdf'...
220 Suivant votre installation, ces messages peuvent être traduits.
224 @cindex Viewing music
227 De tout cela résulte un fichier @file{test.pdf}, que vous pouvez imprimer
228 ou visualiser avec les outils standards de votre système
229 d'exploitation. @footnote{Si votre système ne dispose pas des outils
230 nécessaires, vous pouvez essayer
231 @uref{http://@/www@/.cs@/.wisc@/.edu/@/~ghost/,Ghostscript}, un
232 programme pour afficher et imprimer librement les fichiers PDF et PostScript.}
235 @node Simple notation
236 @subsection Simple notation
238 Il y a certains éléments graphiques que LilyPond ajoute
239 automatiquement. Dans l'exemple suivant, nous n'avons fourni que
240 quatre hauteurs, mais LilyPond a ajouté une clé, un chiffre de mesure
243 @lilypond[quote,ragged-right,verbatim]
250 Ce comportement peut être modifié, mais dans bien des cas ces
251 attributions automatiques s'avèrent utiles.
255 Le moyen le plus simple d'entrer des notes est d'utiliser le mode
256 @code{\relative}. Avec ce mode, l'@rglos{interval} entre la note et
257 celle qui la précède est supposé inférieur ou égal à une
258 @rglos{fourth}. Commençons par entrer la partition la plus
259 élémentaire qui soit, une @rglos{scale}.
261 @lilypond[quote,ragged-right,verbatim]
268 La note de départ est @rglos{middle C}. Chacune des notes qui suivent
269 est à moins d'une quarte de la note précédente --- en d'autres termes,
270 le premier @samp{c} est le do central, entre la clé de sol et
271 la clé de sa, puis est suivi par le ré le plus proche, et ainsi de
272 suite. On peut bien sûr créer des mélodies d'intervalles plus étendus :
274 @lilypond[quote,ragged-right,verbatim]
282 Comme vous l'aurez remarqué, cet exemple ne commence plus sur le do du
283 milieu. La première note --- le @samp{d} --- est le ré qui en est le
286 Pour ajouter des intervalles supérieurs à une quarte, il suffit
287 d'indiquer si la note est à l'octave supérieure ou inférieure, en
288 ajoutant respectivement une apostrophe @code{'} ou une virgule
289 @code{,} au nom de la note.
291 @lilypond[quote,ragged-right,verbatim]
299 Pour déplacer une note deux octaves (ou davantage !) plus haut ou plus
300 bas, il suffit de mettre plusieurs @code{''} ou plusieurs @code{,,} ---
301 attention cependant à bien mettre deux apostrophes @code{''}, et non
302 un guillemet @code{"}@tie{}! C'est de cette même manière que l'on
303 peut modifier la valeur de départ de @code{\relative c'}.
306 @subheading Durations (rhythms)
308 La @rglos{duration} d'une note est indiquée par un nombre
309 qui suit son nom : @samp{1} pour une @rglos{whole
310 note}, @samp{2} pour une @rglos{half note}, @samp{4} pour
311 une @rglos{quarter note} et ainsi de suite. Les hampes sont
312 ajoutées automatiquement.
314 @lilypond[quote,ragged-right,verbatim]
318 a16 a a a a32 a a a a64 a a a a a a a a2
323 Si aucune durée n'est indiquée, la dernière durée entrée sera utilisée
324 pour les notes suivantes. En l'absence d'indication, la première note
327 Les @rglos{dotted notes} s'obtiennent en ajoutant un point @samp{.} à
330 @lilypond[quote,ragged-right,verbatim]
340 On saisit un @rglos{rest} tout comme une note, mais avec le
343 @lilypond[quote,ragged-right,verbatim]
351 @subheading Time signature
353 Le @rglos{time signature} peut être défini à l'aide de la commande
356 @lilypond[quote,ragged-right,verbatim]
370 La @rglos{clef} peut être définie à l'aide de la commande @code{\clef} :
372 @lilypond[quote,ragged-right,verbatim]
386 @subheading All together
388 Voici un bref exemple qui montre tous ces éléments ensemble :
390 @lilypond[quote,ragged-right,verbatim]
402 @item Entrer des hauteurs et des durées
403 voir @ref{Pitches} and @ref{Durations}.
406 @item Les chiffres de mesure et autres commandes de métrique
407 voir @ref{Time signature}.
414 @node Working on text files
415 @subsection Working on text files
417 Les fichiers d'entrée de LilyPond sont traités comme la plupart des
418 langages de programmation : la casse est prise en compte mais pas les
419 espaces vides, les expressions musicales sont délimitées par des
420 accolades @{ @}, et les commentaires par @code{%} ou @code{%@{ ... %@}}.
422 Si cette phrase vous paraît incompréhensible, ne vous en faites pas !
423 Tous ces termes vont être expliqués :
427 @cindex Case sensitive
428 @item @strong{La casse} :
429 LilyPond est sensible à la casse, c'est à dire qu'une lettre capitale
430 n'a pas la même valeur qu'une lettre minuscule. Les notes, par
431 exemple, doivent être entrées en minuscules : @code{@{ c d e @}} est
432 un code valide, alors que @code{@{ C D E @}} produira un message
435 @item @strong{Les espaces multiples} :
436 LilyPond ne tient pas compte du nombre d'espaces, ou de retours à la
437 ligne. @code{@{ c d e @}} a le
438 même sens que @code{@{ c @tie{} @tie{} d @tie{} e @}} ou que
446 Bien sûr, ce dernier exemple est difficile à lire. Une bonne habitude
447 à prendre est d'indenter les blocs de code avec soit des tabulations
448 soit des doubles espaces :
455 @item @strong{Expressions musicales :}
456 Tout morceau saisi dans LilyPond doit être placé entre @strong{@{
457 accolades @}}. Ces caractères indiquent à LilyPond que ce bloc de
458 texte est une et une seule expression musicale, tout comme les
459 parenthèses @samp{()} en mathématiques. Il est préférable, pour
460 éviter toute ambiguïté, d'entourer tous ces crochets d'espaces, à
461 moins qu'ils se trouvent au début ou à la fin d'une ligne.
463 Une fonction --- @code{\relative @{ @}} par exemple --- compte
464 également comme une seule expression musicale.
468 @cindex block comment
469 @item @strong{Les commentaires} :
470 Un commentaire est une indication pour tout lecteur humain d'un
471 fichier de musique ; il est ignoré par l'ordinateur, et n'a donc aucun
472 effet sur la partition imprimée. On distingue deux types de
475 @item la ligne de commentaire, introduite par le symbole @samp{%} :
476 tout ce qui suit ce symbole sur cette ligne sera ignoré.
477 @item le bloc de commentaire, qui peut être de plusieurs lignes voire
478 de toute une section : tout ce qui se trouve entre @code{%@{} et
479 @code{%@}} est ignoré.
481 Le fragment suivant met en évidence quelques usages possibles des commentaires :
484 % voici les notes de "ah vous dirai-je maman"
488 Ces lignes et les notes qui suivent
489 seront ignorées, car elles se trouvent
490 dans un bloc de commentaire.
498 Vous trouverez plus d'astuces pour organiser vos fichiers LilyPond dans
499 @ref{Suggestions for writing LilyPond files}.
502 @node How to read the tutorial
503 @subsection How to read the tutorial
505 Comme nous l'avons vu dans @ref{Working on text files}, un code
506 LilyPond doit être encadré par des @{ @} ou bien par @code{\relative
507 c'' @{ ... @}} afin d'être compris. Cependant, dans la suite de ce
508 manuel, la plupart des exemples ne feront pas apparaître ces signes.
510 Si vous consultez la documentation au format HTML, et que vous
511 souhaitez voir la source exacte d'un exemple, il vous suffit de
512 cliquer sur l'image. Si vous ne disposez pas de la version HTML, il
513 vous est possible de simplement copier et coller le code affiché, mais
514 @strong{à condition} d'ajouter @code{\relative c'' @{ @}} de la façon
519 ... collez ici votre exemple...
523 Pourquoi avoir omis les accolades ? La plupart des exemples de ce
524 manuel peuvent être insérés au milieu d'un morceau de musique plus
525 long. Il n'y a donc aucune raison d'ajouter @code{\relative c'' @{
526 @}} à ces exemples --- en effet, il n'est pas possible d'insérer un
527 @code{\relative} à l'intérieur d'un autre @code{\relative}. Il vous
528 serait donc devenu impossible de copier un bref exemple de la
529 documentation et de le coller dans une pièce de votre cru.
531 @node Single staff notation
532 @section Single staff notation
534 Cette section présente la notation courante dont on a besoin pour
535 écrire une seule voix sur une seule portée.
538 * Relative note names::
539 * Accidentals and key signatures::
541 * Articulation and dynamics::
542 * Automatic and manual beams::
543 * Advanced rhythmic commands::
547 @node Relative note names
548 @subsection Relative note names
550 Comme nous l'avons vu dans @ref{Simple notation}, LilyPond calcule la
551 hauteur de chaque note en fonction de la précédente@footnote{Il existe
552 un autre mode de saisie des hauteurs, le mode @ref{Absolute note
553 names}, mais en pratique il est bien plus aisé et sûr d'avoir recours
554 au mode de hauteurs relatives.}. Si aucune indication supplémentaire
555 d'octaviation n'est ajoutée, il en conlcuera que chaque hauteur est
556 située à une quarte au plus de la note précédente.
558 Lilypond tient compte des intervalles induits par les noms des notes
559 --- en d'autres termes, une quarte augmentée n'est @emph{pas}
560 équivalente à une quinte diminuée. Ainsi, si l'on part d'un Do, un Fa
561 dièse sera placé au-dessus, tandis qu'un Sol bémol sera placé
564 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
572 @item Les hauteurs de note relatives
573 voir @ref{Relative octaves}.
574 @item Les vérifications d'octaves
575 voir @ref{Octave check}.
581 @node Accidentals and key signatures
582 @subsection Accidentals and key signatures
584 @subheading Accidentals
586 Dans la notation par défaut, un @rglos{sharp} s'obtient en ajoutant
587 @samp{is} au nom de la note, et un @rglos{flat} en ajoutant @samp{es}.
588 Comme vous pouvez vous y attendre, un double dièse ou double bémol est
589 alors obtenu en ajoutant @samp{isis} ou @samp{eses}@footnote{Cette
590 syntaxe est dérivée de la convention de dénomination des notes dans
591 les langues nordiques et germaniques, comme l'allemand ou le
595 Cependant, si vous utilisez la commande @samp{\include "italiano.ly"}
596 pour entrer les noms de notes français au lieu des noms hollandais, il
597 faudra ajouter un @samp{d} pour un dièse, et un @samp{b} pour un
598 bémol. Le double dièse et le double bémol s'obtiennent en ajoutant
599 respectivement @samp{dd} et @samp{bb}
602 Pour en savoir plus sur les autres langues disponibles, voir @ref{Note
603 names in other languages}.
605 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
606 cis1 ees fisis, aeses
609 @cindex key signature, setting
610 @subheading Key signatures
612 L'armure est déterminée par la commande @code{\key}, suivie d'une
613 hauteur puis de @code{\major} (majeur) ou @code{\minor} (mineur) :
615 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
624 @subheading Warning: key signatures and pitches
626 La combinaison de l'armure et des hauteurs de note --- y compris les
627 altérations --- permet à LilyPond de déterminer dans quel cas afficher
628 les altérations accidentelles. L'armure n'affecte que les altérations
629 @emph{imprimées}, et non les hauteurs réelles ! Cette fonctionnalité
630 est souvent source de confusion pour les nouveaux utilisateurs, aussi
631 expliquons-la en détail.
633 LilyPond fait une nette distinction entre le contenu musical et la
634 mise en forme. L'altération d'une note --- bémol, bécarre ou dièse
635 --- fait partie de sa hauteur, et relève donc du contenu musical. La
636 présence ou non d'une altération accidentelle --- un @emph{signe}
637 bémol, bécarre ou dièse --- devant la note correspondante est une
638 question qui relève de la mise en page. Mettre en page une partition
639 se fait selon des règles ; les altérations accidentelles seront donc
640 automatiquement imprimées suivant ces règles. Les hauteurs de note,
641 en revanche, relèvent de ce que vous voulez entendre ; et, dans la
642 mesure où la musique que vous entrez est censée être celle que vous
643 voulez entendre, LilyPond (qui n'est chargé que de la gravure) ne les
644 choisira pas à votre place.
648 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
654 Aucune note n'a ici d'altération accidentelle, et pourtant vous devrez
655 entrer le @samp{is} pour les notes @code{cis} et @code{fis}.
657 Le code @samp{d} ne veut pas dire @qq{Imprimez-moi un point noir juste
658 en-dessous de la portée.} Cela signifie plutôt : @qq{Ici se trouve
660 hauteur est un ré naturel.} Avec l'armure de la bémol majeur, ce ré
662 d'un bécarre accidentel :
664 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
669 Ajouter explicitement toutes les altérations requiert un peu plus
670 d'effort dans la phase de saisie, mais la transposition en sera
671 grandement facilitée.
672 De plus les altérations accidentelles
673 peuvent être imprimées suivant plusieurs conventions. Regardez
674 @ref{Automatic accidentals} pour connaître les différentes manières dont les
675 altérations accidentelles peuvent être imprimées, suivant les règles
681 @item Les altérations
682 voir @ref{Accidentals} and @ref{Automatic accidentals}.
684 voir @ref{Key signature}.
690 @subsection Ties and slurs
694 Une @rglos{tie}@footnote{parfois aussi appelée liaison de
695 tenue} se crée en ajoutant un tilde @samp{~} à la première note liée.
697 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
705 @c Le terme de "slur" a deux sens en français : articulation et phrasé.
706 @c Je garde ici le terme "legato", tel qu'il apparaît dans le texte original,
707 @c car c'est celui qui me semble le plus couramment employé.
709 Une @rglos{slur} d'articulation (ou @qq{legato}) peut englober
710 plusieurs notes. La note de départ et d'arrivée reçoivent
711 respectivement un signe @samp{(} et @samp{)}.
713 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
714 d4( c16) cis( d e c cis d) e( d4)
717 @cindex slurs, phrasing
718 @cindex phrasing slurs
719 @subheading Phrasing slurs
721 @cindex phrasing slurs
722 De plus longues liaisons, dites de phrasé, sont délimitées par @code{\(} et
723 @code{\)}. Il est possible d'avoir en même temps des legatos et des
724 phrasés, mais pas plusieurs liaisons de phrasé ou de legato à la fois.
726 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
727 a8(\( ais b c) cis2 b'2 a4 cis,\)
732 @cindex slurs versus ties
733 @subheading Warnings: slurs vs. ties
735 Une liaison d'articulation ou de phrasé ressemble à une liaison de
736 tenue, mais n'a pas la même signification. Alors qu'une liaison de
737 tenue ne peut relier que deux notes de même hauteur, le legato indique
738 une articulation de plusieurs notes, éventuellement nombreuses. Les
739 liaisons de tenue peuvent être enchâssées dans un legato ou un phrasé.
741 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
742 c2~( c8 fis fis4 ~ fis2 g2)
748 @item Liaisons de prolongation
752 @item Liaisons de phrasé
753 voir @ref{Phrasing slurs}.
758 @node Articulation and dynamics
759 @subsection Articulation and dynamics
764 @subheading Articulations
766 Des @rglos{articulations} 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 articulations
785 sur la même note. Dans la plupart des cas, cependant, il est mieux de
786 laisser LilyPond déterminer l'emplacement de l'articulation.
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
810 soit par la commande @code{\!} :
812 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
820 voir @ref{Articulations}.
822 voir @ref{Fingering instructions}.
829 @node Automatic and manual beams
830 @subsection Automatic and manual beams
832 @cindex beams, by hand
833 Toutes les @rglos{beam}s sont dessinées automatiquement :
835 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
836 a8 ais d ees r d c16 b a8
840 Lorsqu'on n'aime pas la manière dont les notes sont automatiquement
841 groupées, il est possible de les entrer à la main, en marquant la
842 première note à attacher d'un @samp{[} et la dernière d'un @samp{]}.
844 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
845 a8[ ais] d[ ees r d] a b
851 @item Groupements de notes et ligatures automatiques
852 voir @ref{Automatic beams}.
853 @item Groupements et ligatures manuels
854 voir @ref{Manual beams}.
859 @node Advanced rhythmic commands
860 @subsection Advanced rhythmic commands
864 @cindex partial measure
865 @subheading Partial measure
867 Une levée (ou @rglos{anacrusis}) est entrée avec la commande
868 @code{\partial}, suivie d'une durée : @code{\partial 4} est une levée
870 @code{\partial 8} d'une croche.
872 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
880 Les nolets sont créés avec la commande @code{\times}, qui prend
881 deux arguments : une fraction et une expression musicale. La durée des
882 notes de l'expression musicale est multipliée par la fraction. Par exemple les
883 notes d'un triolet durent les deux tiers du temps de leur notation
884 réelle, cette fraction est donc de 2/3 pour les triolets :
886 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
887 \times 2/3 { f8 g a }
889 \times 2/3 { f,8 g16[ a g a] }
896 @subheading Grace notes
898 Des notes d'ornement sont produites par la commande @code{\grace},
899 mais aussi en préfixant une expression musicale avec le mot-clé
900 @code{\appoggiatura} ou @code{\acciaccatura} :
902 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
903 c2 \grace { a32[ b] } c2
904 c2 \appoggiatura b16 c2
905 c2 \acciaccatura b16 c2
911 @item Notes d'ornement
912 voir @ref{Grace notes},
916 voir @ref{Partial measures}.
921 @node Multiple notes at once
922 @section Multiple notes at once
924 Cette section traite des situations où l'on a plus d'une note à la
925 fois : plusieurs instruments, plusieurs portées pour un même
926 instrument (le piano, par exemple), et les accords.
928 La polyphonie, en théorie musicale, est la notion d'une musique
929 constituée de plusieurs voix ; dans lilypond, ce terme désigne les
930 situations où il y a plus d'une voix sur une même portée.
933 * Music expressions explained::
936 * Single staff polyphony::
937 * Combining notes into chords::
941 @node Music expressions explained
942 @subsection Music expressions explained
944 Dans les fichiers source LilyPond, la musique est représentée par ce qu'on
945 appelle des @emph{expressions musicales}. En soi, une seule note peut
947 expression musicale, si tant est qu'elle soit correctement encadrée :
949 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
953 Mettre un groupe de notes entre accolades crée une nouvelle expression
956 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
960 Placer une séquence d'expressions musicales --- des notes par exemple
961 --- entre accolades signifie qu'elles doivent être jouées
962 successivement, les unes après les autres. Le résultat est une
963 expression, qui peut elle-même être regroupée séquentiellement avec
964 d'autres expressions. Ici, l'expression de l'exemple précédent est
965 combinée à deux notes :
967 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
971 @subheading Simultaneous music expressions: multiple staves
973 Cette technique est utile pour de la musique polyphonique. Pour
974 entrer une musique avec plusieurs voix ou plusieurs portées, nous
975 pouvons aussi combiner en parallèle les expressions. Deux voix qui doivent être
976 jouées en même temps, sont entrées comme une combinaison simultanée de
977 deux expressions. Une expression musicale @q{simultanée} est formée en
978 entourant les expressions entre @code{<<} et @code{>>}. Dans l'exemple
979 suivant, trois expressions (contenant chacune deux notes distinctes) sont
980 combinées simultanément.
982 @lilypond[quote,ragged-right,verbatim]
992 Notez que nous avons ici indenté chaque niveau du fichier d'entrée
993 avec un nombre d'espaces différent. LilyPond se moque de l'espace
994 qu'il peut y avoir (ou pas) au début d'une ligne, mais en indentant
995 votre code vous le rendrez bien plus facile à lire pour les humains.
997 @strong{Attention} : chaque note saisie est relative à la précédente,
998 mais pas au @code{c''} de la commande @code{\relative} de départ.
1001 @subheading Simultaneous music expressions: single staff
1003 Pour déterminer le nombre de portées, LilyPond regarde le premier
1004 élément autre qu'une accolade. Si c'est une seule note, il y a une
1005 portée ; si c'est une expression simultanée, il y aura plus d'une
1008 @lilypond[quote,ragged-right,verbatim]
1011 << { e f } { c <<b d>> } >>
1016 @cindex music expression
1017 @subheading Analogy: mathematical expressions
1019 Ce mécanisme est similaire au formules mathématiques : une grosse
1020 formule est créée en assemblant plusieurs petites formules. Ces types
1021 de formules, appelées expressions, ont une définition récursive, de
1022 telle sorte que vous pouvez fabriquer des expressions arbitrairement
1023 longues et complexes. Par exemple,
1032 ((1 + 2) * 3) / (4 * 5)
1035 Ceci est une suite d'expressions, où chacune est contenue dans la
1036 suivante. Les expressions les plus simples sont les nombres, et de
1037 plus grandes expressions sont produites en combinant des expressions
1038 avec des opérateurs --- comme @samp{+}, @samp{*} et @samp{/} --- et des
1039 parenthèses. Tout comme les expressions mathématiques, les expressions
1040 musicales peuvent être imbriquées avec une profondeur arbitraire, ce
1041 qui est nécessaire pour de la musique complexe comme des partitions
1045 @node Multiple staves
1046 @subsection Multiple staves
1048 Comme nous l'avons vu dans @ref{Music expressions explained}, un
1049 fichier d'entrée LilyPond est fait d'expressions musicales. Si la
1050 partition commence par plusieurs expressions simultanées, LilyPond
1051 créera plusieurs portées. Cependant, il est plus facile de voir ce
1052 qu'il advient si l'on crée explicitement chacune des portées.
1054 Pour créer plus d'une portée, chaque partie de la musique constituant
1055 une portée est entrée en la faisant précéder de @code{\new Staff}.
1056 Ces éléments @code{Staff} sont ensuite combinés en parallèle avec
1057 @code{<<} et @code{>>}, comme ceci :
1059 @lilypond[quote,ragged-right,verbatim]
1062 \new Staff { \clef treble c }
1063 \new Staff { \clef bass c,, }
1069 La commande @code{\new} introduit un @qq{contexte de notation}. Un
1070 contexte de notation est un environnement dans lequel les événements
1071 musicaux --- comme les notes ou les commandes @code{\clef} --- sont
1072 interprétés. Pour des pièces simples, ces contextes sont créés
1073 automatiquement. Pour des pièces plus complexes, il est préférable de
1074 spécifier explicitement les contextes. Cela assure que chaque
1075 fragment aura sa propre portée.
1077 Il existe différents types de contextes. Les contextes @code{Staff}
1078 (portée), @code{Voice} (voix) et @code{Score} (partition) gèrent la
1079 notation de la mélodie, alors que @code{Lyrics} gère les paroles et
1080 @code{ChordNames} imprime le nom des accords.
1082 En termes de syntaxe, faire précéder une expression musicale de
1083 @code{\new} crée une plus grosse expression musicale. En reprenant la
1084 comparaison, cela ressemble au signe @qq{moins} en mathématiques. La
1085 formule @math{(4+5)} est une expression, donc @math{-(4+5)} est une
1086 plus grosse expression.
1088 Les chiffres de mesure figurant sur une portée affectent toutes les
1089 autres portées ; en revanche l'armure d'une portée n'affectera
1090 @emph{pas} les autres portées.@footnote{Ce comportement peut être
1091 modifié si nécessaire : voir pour cela @ref{Changing defaults}.}.
1093 @lilypond[quote,ragged-right,verbatim]
1096 \new Staff { \clef treble \time 3/4 c }
1097 \new Staff { \clef bass \key d \major c,, }
1106 @subsection Piano staves
1108 @cindex staff switch, manual
1109 @cindex cross staff voice, manual
1110 La musique pour piano s'écrit sur deux portées reliées par une
1111 accolade. Imprimer ce type de portée revient au même que dans
1112 l'exemple de musique polyphonique de @ref{Multiple staves}, mais
1113 maintenant cette expression entière doit être interprétée dans un
1114 contexte @code{PianoStaff} :
1123 Voici un bref exemple :
1125 @lilypond[quote,ragged-right,verbatim]
1128 \new Staff { \time 2/4 c4 e g g, }
1129 \new Staff { \clef bass c,, c' e c }
1136 Voir @ref{Piano music}.
1140 @node Single staff polyphony
1141 @subsection Single staff polyphony
1144 @cindex multiple voices
1145 @cindex voices, more -- on a staff
1146 Quand différentes lignes mélodiques sont combinées sur une seule et
1147 même portée, elles sont imprimées comme des voix polyphoniques ;
1148 chaque voix a ses propre hampes@footnote{familièrement appelées queues
1149 de note.}, liaisons et ligatures, la voix supérieure ayant les hampes
1150 vers le haut, la voix inférieure vers le bas.
1152 Ce type de partition est réalisé en entrant chaque voix comme une
1153 séquence (avec @code{@{...@}}), en combinant simultanément les voix et
1154 en les séparant par @code{\\} :
1157 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
1164 Pour l'écriture de musique polyphonique, les silences invisibles
1165 s'avèrent bien pratiques : ce sont des silences qui ne s'impriment
1166 pas. Ils sont utiles pour remplir des voix qui, temporairement, ne
1167 jouent rien. On peut voir ici le même exemple avec un silence
1168 invisible (@code{s}) à la place d'un silence normal (@code{r}) :
1170 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
1178 Là encore, ces expressions peuvent s'imbriquer arbitrairement :
1180 @lilypond[quote,fragment,verbatim,relative=2,fragment]
1188 { <c g>1 ~ <c g>4 } \\
1196 Voir @ref{Basic polyphony}.
1200 @node Combining notes into chords
1201 @subsection Combining notes into chords
1204 Des accords peuvent être produits en entourant les hauteurs de notes
1205 par des angles gauche et droit --- @samp{<} et @samp{>} ---
1207 @lilypond[quote,fragment,verbatim,relative=2,fragment]
1208 r4 <c e g>4 <c f a>2
1211 Vous pouvez combiner les indications comme les liaisons et les
1212 ligatures de croches avec les accords. Ils doivent cependant être
1213 placés en dehors des angles :
1216 @lilypond[quote,fragment,verbatim,relative=2,fragment]
1217 r4 <c e g>8[ <c f a>]~ <c f a>2
1220 @lilypond[quote,fragment,verbatim,relative=2,fragment]
1221 r4 <c e g>8\>( <c e g> <c e g>4 <c f a>\!)
1228 Cette section présente l'écriture vocale et les partitions de variété.
1236 @node Printing lyrics
1237 @subsection Printing lyrics
1241 Prenons une mélodie toute simple :
1243 @lilypond[quote,ragged-right,verbatim]
1250 Des paroles peuvent être associées à ces notes, en les combinant avec
1251 la commande @code{\addlyrics}. Les paroles sont entrées en séparant
1252 chaque syllable par un espace :
1254 @lilypond[quote,ragged-right,verbatim]
1260 \addlyrics { One day this shall be free }
1265 @cindex extender line
1266 Cette mélodie se termine sur un @rglos{melisma}, c'est-à-dire qu'une
1267 seule syllable (@qq{free}) correspond à plus d'une note. Ceci est
1268 indiqué avec une @emph{ligne d'extension}. Elle est entrée avec deux
1269 caractères souligné (@code{_}), c'est-à-dire :
1271 @lilypond[quote,ragged-right,verbatim]
1277 \addlyrics { One day this shall be free __ }
1281 De la même manière, les séparations syllabiques d'un mot peuvent être
1282 entrées avec deux tirets (@code{-}), ce qui produit un tiret centré
1283 entre les deux syllabes :
1285 @c no ragged-right here because otherwise the hypens get lost.
1286 @lilypond[quote,verbatim]
1292 \addlyrics { A -- le -- gri -- a }
1298 Plus de possibilités, comme celle d'ajouter plusieurs lignes de
1299 paroles en dessous d'une même mélodie sont exposées dans @ref{Vocal
1305 @subsection A lead sheet
1311 En musique de variété, il est courant d'indiquer l'accompagnement par
1312 le nom des accords. De tels accords peuvent être entrés comme les
1315 @lilypond[quote,ragged-right,verbatim]
1316 \chordmode { c2 f4. g8 }
1319 Maintenant, chaque hauteur est lue comme la base de l'accord à la
1320 place de la note. Ce mode est activé avec @code{\chordmode}.
1321 D'autres accords peuvent être créés en ajoutant des modifiacteurs
1322 après deux points. L'exemple suivant montre quelques modificateurs
1325 @lilypond[quote,verbatim,ragged-right]
1326 \chordmode { c2 f4:m g4:maj7 gis1:dim7 }
1329 Pour la musique improvisée, les accords ne sont pas imprimés sur des
1330 portées mais comme des lignes à part entière. Ceci s'obtient en
1331 utilisant @code{\chords} à la place de @code{\chordmode}. La même
1332 syntaxe sera utilisée que dans le cas de@code{\chordmode}, mais le
1333 rendu des notes interviendra dans un contexte de @code{ChordNames},
1334 avec le résultat suivant :
1336 @lilypond[quote,verbatim,ragged-right]
1337 \chords { c2 f4.:m g4.:maj7 gis8:dim7 }
1341 Une fois assemblés, les accords, paroles et mélodie forment une
1342 partition de chanson :
1344 @lilypond[quote,verbatim,ragged-right]
1346 \chords { c2 g:sus4 f e }
1351 \addlyrics { One day this shall be free __ }
1358 Une liste complète de modificateurs et d'autres options de mise en
1359 forme se trouve à la section @ref{Chords}.
1364 @section Final touches
1366 L'ultime section de ce tutoriel montre comment ajouter la touche
1367 finale à des morceaux simples, et consititue une introduction au reste
1373 * Absolute note names::
1374 * Organizing pieces with identifiers::
1375 * After the tutorial::
1376 * How to read the manual::
1380 @node Version number
1381 @subsection Version number
1384 La déclaration @code{\version} stipule le numéro de la version de
1385 LilyPond pour laquelle le fichier a été écrit. Pour donner à un
1386 fichier la version 2.11.20, ajoutez
1393 tout en haut de votre fichier LilyPond.
1395 Cette annotation permet de faciliter les prochaines mises à jour de
1396 LilyPond. Les changements dans la syntaxe sont gérés avec un
1397 programme spécial, @file{convert-ly} --- voir @ref{Updating files with
1398 convert-ly} --- et il utilise @code{\version} pour déterminer les
1399 règles de conversion à appliquer au fichier.
1403 @subsection Adding titles
1405 Les informations bibliographiques (nom du morceau, du compositeur,
1406 etc) sont entrées dans un bloc séparé, le bloc d'en-tête
1407 (@code{\header}), qui existe indépendamment des expressions musicales
1408 principales. Le bloc @code{\header} est habituellement placé en début
1420 @dots{} music @dots{}
1423 Quand le fichier est traité, le titre et le compositeur sont imprimés
1424 en haut de la partition. Vous trouverez plus d'informations sur les
1425 titres à @ref{Creating titles}.
1427 @node Absolute note names
1428 @subsection Absolute note names
1430 Jusqu'ici nous n'avons utilisé que le mode @code{\relative} pour
1431 définir les hauteurs de notes. Si c'est effectivement le moyen le
1432 plus simple d'entrer la majeure partie de votre musique, il existe une
1433 autre façon de procéder : le mode de hauteurs absolues.
1435 Si vous omettez la commande @code{\relative}, LilyPond considérera
1436 toutes les hauteurs comme des hauteurs absolues. Un @code{c'} sera
1437 toujours un do du milieu, un @code{b} sera toujours une note
1438 au-dessous du précédent, et un @code{g,} sera toujours la note la plus
1439 grave dans la portée de clé de Fa.
1441 @lilypond[quote,verbatim,ragged-right]
1449 Voici une gamme sur 4 octaves :
1451 @lilypond[quote,verbatim,ragged-right]
1466 Comme vous pouvez le voir, il faut beaucoup d'apostrophes pour écrire
1467 de la musique dans un registre aigu. Regardez cet extrait de Mozart :
1469 @lilypond[quote,verbatim,ragged-right]
1473 cis''8. d''16 cis''8 e''4 e''8
1474 b'8. cis''16 b'8 d''4 d''8
1478 Toutes ces apostrophes rendent le fichier moins lisible, et c'est donc
1479 une source d'erreurs. En mode @code{\relative}, le même exemple
1480 devient bien plus facile à lire :
1482 @lilypond[quote,verbatim,ragged-right]
1486 cis8. d16 cis8 e4 e8
1491 Si d'aventure vous faites une erreur d'octaviation, le mode
1492 @code{\relative} la rendra frappante --- toutes les notes suivantes
1493 seront placées à la mauvaise octave. En mode de hauteurs absolues,
1494 une erreur isolée ne serait pas aussi visible, et donc aussi facile à
1497 Cependant, le mode de hauteurs absolues reste utile pour les musiques
1498 où les intervalles sont étendus, surtout pour les fichiers LilyPond
1499 créés par ordinateur.
1502 @node Organizing pieces with identifiers
1503 @subsection Organizing pieces with identifiers
1505 Lorsque l'on combine tous les éléments étudiés plus haut pour produire
1506 des fichiers plus volumineux, les blocs @code{\score} deviennent
1507 beaucoup plus gros parce que les expressions musicales sont plus
1508 longues et, dans le cas des pièces polyphoniques, profondément
1509 imbriquées. De telles expressions imposantes finissent par devenir
1510 peu maniables. Cet inconvénient peut être résolu par l'utilisation
1511 d'@emph{identificateurs}.
1513 En utilisant ces identificateurs, que l'on pourrait aussi appeler
1514 variables ou macros, il est possible de découper des expressions
1515 musicales complexes. Un identificateur se définit comme suit :
1518 MusiqueToto = @{ @dots{} @}
1521 Le contenu de l'expression musicale @code{MusiqueToto} pourra être
1522 utilisé plus loin en faisant précéder son nom d'un anti-slash,
1523 c'est-à-dire @code{\MusiqueToto}, juste comme n'importe quelle
1524 commande LilyPond. Tous les identificateurs doivent être définis
1525 @emph{avant} l'expression musicale principale.
1527 @lilypond[quote,verbatim,ragged-right]
1528 violin = \new Staff { \relative c'' {
1531 cello = \new Staff { \relative c {
1544 Le nom d'un identificateur ne doit comporter que des caractères
1545 alphabétiques non accentués, aucun nombre ni tiret.
1547 Il est possible d'utiliser des variables de types variés. Par exemple,
1552 aFivePaper = \paper @{ paperheight = 21.0 \cm @}
1555 En fonction de son contenu, un identificateur peut être utilisé à
1556 différents endroits. L'exemple suivant utilise la variable ci-dessus
1568 @node After the tutorial
1569 @subsection After the tutorial
1571 Après avoir parcouru ce tutoriel, vous devriez vous essayer à écrire
1572 un morceau ou deux. Commencez par copier l'un des @ref{Templates}
1573 types et ajoutez-y des notes. Si vous voulez employer une notation
1574 que vous n'avez pas trouvé dans le tutoriel, consultez la référence de
1575 notation, en commençant par la @ref{Basic notation}. Si vous désirez
1576 écrire pour un ensemble instrumental non couvert par les
1577 @ref{Templates}, lisez la section @ref{Extending the templates}.
1579 Après avoir écrit quelques pièces courtes, lisez les chapitres 3 à 5
1580 du manuel d'apprentissage. Rien ne s'oppose à ce que vous consultiez
1581 dès à présent les autres chapitres, bien sûr ! Néanmoins, le reste du
1582 manuel de l'utilisateur part du principe que vous avez déjà bien
1583 assimilé la syntaxe de LilyPond. Vous pouvez toujours survoler le
1584 reste du manuel, et y revenir plus tard après avoir acquis de
1587 @node How to read the manual
1588 @subsection How to read the manual
1590 Comme nous l'avons déjà vu dans @ref{How to read the tutorial}, de
1591 nombreux exemples du tutoriel n'ont pas fait apparaître le
1592 @code{\relative c'' @{ ... @}} dans l'extrait de code affiché.
1594 Dans le reste du manuel, les exemples utilisés sont encore beaucoup
1595 plus souples : parfois il leur manque le @code{\relative c'' @{ ...
1596 @}}, mais d'autres fois ils ont recours à une autre hauteur de
1597 référence, telle que @code{c'} ou @code{c,,}), et dans certains cas
1598 c'est même l'exemple entier qui est en mode de hauteurs absolues !
1599 Cependant, de telles ambiguïtés ne se trouvent que dans des contextes
1600 où les hauteurs n'ont que peu d'importance. Dans tous les exemples où
1601 elles en ont, le mode @code{\relative} ou absolu @code{@{ @}} est
1602 explicitement spécifié.
1604 Si vous ne vous y retrouvez toujours pas pour savoir quel code
1605 LilyPond produit précisément tel ou tel exemple, consultez la version
1606 HTML de ce manuel si ce n'est pas déjà le cas, et cliquez sur l'image
1607 de la partition. La source exacte utilisée pour générer ce manuel