1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
2 @c This file is part of lilypond.tely
4 Translation of GIT committish: b40f25ec7472b855483b5eb9126747bfb9487fe1
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 :
53 @lilypond[quote,ragged-right]
55 c-\markup { \bold \huge { Click here. } }
59 En copiant et en collant tout le code @qq{ly snippet} dans un fichier test,
60 vous aurez un modèle de base pour faire vos expériences. Si vous
61 apprenez de cette façon, vous aurez probablement envie d'imprimer ou
62 de garder un lien vers la
63 @ref{Cheat sheet}, tableau qui répertorie les commandes usuelles
64 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 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, démarrez un éditeur de texte @footnote{N'importe quel
154 éditeur simple ou orienté programmation, qui prend en charge le codage
155 de caractères UTF-8, fera l'affaire, par exemple le Bloc-notes. N'utilisez
156 pas de traitement de texte car ceux-ci insèrent des codes de formatage
157 qui posent problème à LilyPond.} et saisissez
165 Enregistrez-le sur le bureau sous @file{test.ly} et vérifiez bien
166 qu'il ne s'appelle pas @file{test.ly.TXT}. Double-cliquez sur le
167 fichier @file{test.ly} pour le traiter et afficher le fichier
168 PDF résultant. Pour modifier un fichier @file{.ly} existant, faites
169 un clic droit dessus et sélectionnez @qq{Éditer la source}.
171 Si vous double-cliquez sur l'icône LilyPond sur le Bureau, un fichier
172 d'exemple s'ouvrira dans un simple éditeur de texte. Enregistrez-le,
173 par exemple en tant que @file{test.ly} sur votre Bureau, puis
174 double-cliquez dessus pour le traiter. Après quelques secondes, vous
175 obtiendrez un fichier @file{test.pdf} sur votre Bureau, fichier que
176 vous pourrez ouvrir pour voir la partition imprimée. Une autre
177 méthode pour lancer le traitement du fichier @file{test.ly} est de le
178 glisser avec votre souris sur l'icône de LilyPond.
180 En double-cliquant sur le fichier, vous obtiendrez, en plus du fichier
181 PDF, un fichier @file{.log} qui récapitule les opérations que LilyPond
182 a effectuées sur votre fichier. Si une erreur advient, c'est ce
183 fichier qu'il vous faudra étudier.
188 Commencez par ouvrir une fenêtre de terminal et un éditeur de
189 texte. Par exemple, vous pouvez ouvrir un xterm et exécuter
190 @code{joe}. @footnote{Il existe des fichiers de macros pour les fans
192 @code{LilyPond-mode} pour les fans d'Emacs. S'ils ne sont pas
193 encore installés, consultez le fichier @file{INSTALL.txt}. L'outil
194 d'édition le plus facile d'utilisation est de loin
195 @file{LilyPondTool}. Vous trouverez plus d'informations dans
196 @ref{Editor support}.} Dans votre
197 éditeur, entrez le texte suivant et sauvegardez le fichier sous
207 Pour traiter @file{test.ly}, procédez comme ceci :
214 Vous verrez quelque chose ressemblant à :
221 Interpreting music... [1]
222 Preprocessing graphical objects...
223 Calculating line breaks... [2]
224 Layout output to `test.ps'...
225 Converting to `test.pdf'...
229 Suivant votre installation, ces messages peuvent être traduits.
233 @cindex Viewing music
236 De tout cela résulte un fichier @file{test.pdf}, que vous pouvez imprimer
237 ou visualiser avec les outils standards de votre système
238 d'exploitation. @footnote{Si votre système ne dispose pas des outils
239 nécessaires, vous pouvez essayer
240 @uref{http://@/www@/.cs@/.wisc@/.edu/@/~ghost/,Ghostscript}, un
241 programme pour afficher et imprimer librement les fichiers PDF et PostScript.}
244 @node Simple notation
245 @subsection Simple notation
247 Il y a certains éléments graphiques que LilyPond ajoute
248 automatiquement. Dans l'exemple suivant, nous n'avons fourni que
249 quatre hauteurs, mais LilyPond a ajouté une clé, un chiffre de mesure
252 @lilypond[quote,ragged-right,verbatim]
259 Ce comportement peut être modifié, mais dans bien des cas ces
260 attributions automatiques s'avèrent utiles.
264 Le moyen le plus simple d'entrer des notes est d'utiliser le mode
265 @code{\relative}. Avec ce mode, l'@rglos{interval} entre la note et
266 celle qui la précède est supposé inférieur ou égal à une
267 @rglos{fourth}. Commençons par entrer la partition la plus
268 élémentaire qui soit, une @rglos{scale}.
270 @lilypond[quote,ragged-right,verbatim]
277 La note de départ est @rglos{middle C}. Chacune des notes qui suivent
278 est à moins d'une quarte de la note précédente --- en d'autres termes,
279 le premier @samp{c} est le do central, entre la clé de sol et
280 la clé de sa, puis est suivi par le ré le plus proche, et ainsi de
281 suite. On peut bien sûr créer des mélodies d'intervalles plus étendus :
283 @lilypond[quote,ragged-right,verbatim]
291 Comme vous l'aurez remarqué, cet exemple ne commence plus sur le do du
292 milieu. La première note --- le @samp{d} --- est le ré qui en est le
295 Pour ajouter des intervalles supérieurs à une quarte, il suffit
296 d'indiquer si la note est à l'octave supérieure ou inférieure, en
297 ajoutant respectivement une apostrophe @code{'} ou une virgule
298 @code{,} au nom de la note.
300 @lilypond[quote,ragged-right,verbatim]
308 Pour déplacer une note deux octaves (ou davantage !) plus haut ou plus
309 bas, il suffit de mettre plusieurs @code{''} ou plusieurs @code{,,} ---
310 attention cependant à bien mettre deux apostrophes @code{''}, et non
311 un guillemet @code{"}@tie{}! C'est de cette même manière que l'on
312 peut modifier la valeur de départ de @code{\relative c'}.
315 @subheading Durations (rhythms)
317 La @rglos{duration} d'une note est indiquée par un nombre
318 qui suit son nom : @samp{1} pour une @rglos{whole
319 note}, @samp{2} pour une @rglos{half note}, @samp{4} pour
320 une @rglos{quarter note} et ainsi de suite. Les hampes sont
321 ajoutées automatiquement.
323 @lilypond[quote,ragged-right,verbatim]
327 a16 a a a a32 a a a a64 a a a a a a a a2
332 Si aucune durée n'est indiquée, la dernière durée entrée sera utilisée
333 pour les notes suivantes. En l'absence d'indication, la première note
336 Les @rglos{dotted notes} s'obtiennent en ajoutant un point @samp{.} à
339 @lilypond[quote,ragged-right,verbatim]
349 On saisit un @rglos{rest} tout comme une note, mais avec le
352 @lilypond[quote,ragged-right,verbatim]
360 @subheading Time signature
362 Le @rglos{time signature} peut être défini à l'aide de la commande
365 @lilypond[quote,ragged-right,verbatim]
379 La @rglos{clef} peut être définie à l'aide de la commande @code{\clef} :
381 @lilypond[quote,ragged-right,verbatim]
395 @subheading All together
397 Voici un bref exemple qui montre tous ces éléments ensemble :
399 @lilypond[quote,ragged-right,verbatim]
411 @item Entrer des hauteurs et des durées
412 voir @ref{Pitches} and @ref{Durations}.
415 @item Les chiffres de mesure et autres commandes de métrique
416 voir @ref{Time signature}.
423 @node Working on text files
424 @subsection Working on text files
426 Les fichiers d'entrée de LilyPond sont traités comme la plupart des
427 langages de programmation : la casse est prise en compte mais pas les
428 espaces vides, les expressions musicales sont délimitées par des
429 accolades @{ @}, et les commentaires par des @code{%} ou @code{%@{ ..
432 Si cette phrase vous paraît incompréhensible, ne vous en faites pas !
433 Tous ces termes vont être expliqués :
437 @cindex Case sensitive
438 @item @strong{La casse} :
439 LilyPond est sensible à la casse, c'est à dire qu'une lettre en
440 capitales n'a pas la même valeur qu'une lettre en minuscules. Les
441 notes, par exemple, doivent être entrées en minuscules : @code{ @{ c
443 un code valide, alors que @code{ @{ C D E @} } produira un message d'erreur.
445 @item @strong{Les espaces multiples} :
446 LilyPond ne tient pas compte du nombre d'espaces, ou de retours à la
447 ligne. @code{ @{ c d e @}} a le même sens que @code{ @{ c @ @ @ @ @
456 Bien sûr, ce dernier exemple est difficile à lire. Une bonne habitude
457 à prendre est d'indenter les blocs de code avec soit des tabulations
458 soit des doubles espaces :
465 @item @strong{Expressions musicales :}
466 Tout morceau saisi dans LilyPond doit être placé entre @strong{@{
467 accolades @}}. Ces caractères indiquent à LilyPond que ce bloc de
468 texte est une et une seule expression musicale, tout comme les
469 parenthèses @samp{()} en mathématiques. Il est préférable, pour
470 éviter toute ambiguïté, d'entourer tous ces crochets d'espaces, à
471 moins qu'ils se trouvent au début ou à la fin d'une ligne.
473 Une fonction telle que @code{\relative @{ @}} ) compte également comme
474 une seule expression musicale.
478 @cindex block comment
479 @item @strong{Les commentaires} :
480 Un commentaire est une indication pour tout lecteur humain d'un
481 fichier de musique ; il est ignoré par l'ordinateur, et n'a donc aucun
482 effet sur la partition imprimée. On distingue deux types de
485 @item la ligne de commentaire, introduite par le symbole @samp{%} :
486 tout ce qui suit ce symbole sur cette ligne sera ignoré.
487 @item le bloc de commentaire, qui peut être de plusieurs lignes voire
488 de toute une section : tout ce qui se trouve entre @code{%@{} et
489 @code{%@}} est ignoré.
491 Le fragment suivant met en évidence quelques usages possibles des commentaires :
494 % voici les notes de "ah vous dirai-je maman"
498 Ces lignes et les notes qui suivent
499 seront ignorées, car elles se trouvent
500 dans un bloc de commentaire.
508 Vous trouverez plus d'astuces pour organiser vos fichiers LilyPond dans
509 @ref{Suggestions for writing LilyPond files}.
512 @node How to read the tutorial
513 @subsection How to read the tutorial
515 Comme nous l'avons vu dans @ref{Working on text files}, un code
516 LilyPond doit être encadré par des @{ @} ou bien par @code{\relative
517 c'' @{ ... @}} afin d'être compris. Cependant, dans la suite de ce
518 manuel, la plupart des exemples ne feront pas apparaître ces signes.
520 Si vous consultez la documentation au format HTML, et que vous
521 souhaitez voir la source exacte d'un exemple, il vous suffit de
522 cliquer sur l'image. Si vous ne disposez pas de la version HTML, il
523 vous est possible de simplement copier et coller le code affiché, mais
524 @strong{à condition} d'ajouter @code{\relative c'' @{ @}} de la façon
529 ... collez ici votre exemple...
533 Pourquoi avoir omis les accolades ? La plupart des exemples de ce
534 manuel peuvent être insérés au milieu d'un morceau de musique plus
535 long. Il n'y a donc aucune raison d'ajouter @code{\relative c'' @{
536 @}} à ces exemples --- en effet, il n'est pas possible d'insérer un
537 @code{\relative} à l'intérieur d'un autre @code{\relative}. Il vous
538 serait donc devenu impossible de copier un bref exemple de la
539 documentation et de le coller dans une pièce de votre cru.
541 @node Single staff notation
542 @section Single staff notation
544 Cette section présente la notation courante dont on a besoin pour
545 écrire une seule voix sur une seule portée.
548 * Relative note names::
549 * Accidentals and key signatures::
551 * Articulation and dynamics::
552 * Automatic and manual beams::
553 * Advanced rhythmic commands::
557 @node Relative note names
558 @subsection Relative note names
560 Comme nous l'avons vu dans @ref{Simple notation}, LilyPond calcule la
561 hauteur de chaque note en fonction de la précédente@footnote{Il existe
562 un autre mode de saisie des hauteurs, le mode @ref{Absolute note
563 names}, mais en pratique il est bien plus aisé et sûr d'avoir recours
564 au mode de hauteurs relatives.}. Si aucune indication supplémentaire
565 d'octaviation n'est ajoutée, il en conlcuera que chaque hauteur est
566 située à une quarte au plus de la note précédente.
568 Lilypond tient compte des intervalles induits par les noms des notes
569 --- en d'autres termes, une quarte augmentée n'est @emph{pas}
570 équivalente à une quinte diminuée. Ainsi, si l'on part d'un Do, un Fa
571 dièse sera placé au-dessus, tandis qu'un Sol bémol sera placé
574 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
582 @item Les hauteurs de note relatives
583 voir @ref{Relative octaves}.
584 @item Les vérifications d'octaves
585 voir @ref{Octave check}.
591 @node Accidentals and key signatures
592 @subsection Accidentals and key signatures
594 @subheading Accidentals
596 Dans la notation par défaut, un @rglos{sharp} s'obtient en ajoutant
597 @samp{is} au nom de la note, et un @rglos{flat} en ajoutant @samp{es}.
598 Comme vous pouvez vous y attendre, un double dièse ou double bémol est
599 alors obtenu en ajoutant @samp{isis} ou @samp{eses}@footnote{Cette
600 syntaxe est dérivée de la convention de dénomination des notes dans
601 les langues nordiques et germaniques, comme l'allemand ou le
605 Cependant, si vous utilisez la commande @samp{\include "italiano.ly"}
606 pour entrer les noms de notes français au lieu des noms hollandais, il
607 faudra ajouter un @samp{d} pour un dièse, et un @samp{b} pour un
608 bémol. Le double dièse et le double bémol s'obtiennent en ajoutant
609 respectivement @samp{dd} et @samp{bb}
612 Pour en savoir plus sur les autres langues disponibles, voir @ref{Note
613 names in other languages}.}
615 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
616 cis1 ees fisis, aeses
619 @cindex key signature, setting
620 @subheading Key signatures
622 L'armure est déterminée par la commande @code{\key}, suivie d'une
623 hauteur puis de @code{\major} (majeur) ou @code{\minor} (mineur) :
625 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
634 @subheading Warning: key signatures and pitches
636 La combinaison de l'armure et des hauteurs de note --- y compris les
637 altérations --- permet à LilyPond de déterminer dans quel cas afficher
638 les altérations accidentelles. L'armure n'affecte que les altérations
639 @emph{imprimées}, et non les hauteurs réelles ! Cette fonctionnalité
640 est souvent source de confusion pour les nouveaux utilisateurs, aussi
641 expliquons-la en détail.
643 LilyPond fait une nette distinction entre le contenu musical et la
644 mise en forme. L'altération d'une note --- bémol, bécarre ou dièse
645 --- fait partie de sa hauteur, et relève donc du contenu musical. La
646 présence ou non d'une altération accidentelle --- un @emph{signe}
647 bémol, bécarre ou dièse --- devant la note correspondante est une
648 question qui relève de la mise en page. Mettre en page une partition
649 se fait selon des règles ; les altérations accidentelles seront donc
650 automatiquement imprimées suivant ces règles. Les hauteurs de note,
651 en revanche, relèvent de ce que vous voulez entendre ; et, dans la
652 mesure où la musique que vous entrez est censée être celle que vous
653 voulez entendre, LilyPond (qui n'est chargé que de la gravure) ne les
654 choisira pas à votre place.
658 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
664 Aucune note n'a ici d'altération accidentelle, et pourtant vous devrez
665 entrer le @samp{is} pour les notes @code{cis} et @code{fis}.
667 Le code @samp{d} ne veut pas dire @qq{Imprimez-moi un point noir juste
668 en-dessous de la portée.} Cela signifie plutôt : @qq{Ici se trouve
670 hauteur est un ré naturel.} Avec l'armure de la bémol majeur, ce ré
672 d'un bécarre accidentel :
674 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
679 Ajouter explicitement toutes les altérations requiert un peu plus
680 d'effort dans la phase de saisie, mais la transposition en sera
681 grandement facilitée.
682 De plus les altérations accidentelles
683 peuvent être imprimées suivant plusieurs conventions. Regardez
684 @ref{Automatic accidentals} pour connaître les différentes manières dont les
685 altérations accidentelles peuvent être imprimées, suivant les règles
691 @item Les altérations
692 voir @ref{Accidentals} and @ref{Automatic accidentals}.
694 voir @ref{Key signature}.
700 @subsection Ties and slurs
704 Une @rglos{tie}@footnote{parfois aussi appelée liaison de
705 tenue} se crée en ajoutant un tilde @samp{~} à la première note liée.
707 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
715 @c Le terme de "slur" a deux sens en français : articulation et phrasé.
716 @c Je garde ici le terme "legato", tel qu'il apparaît dans le texte original,
717 @c car c'est celui qui me semble le plus couramment employé.
719 Une @rglos{slur} d'articulation (ou @qq{legato}) peut englober
720 plusieurs notes. La note de départ et d'arrivée reçoivent
721 respectivement un signe @samp{(} et @samp{)}.
723 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
724 d4( c16) cis( d e c cis d) e( d4)
727 @cindex slurs, phrasing
728 @cindex phrasing slurs
729 @subheading Phrasing slurs
731 @cindex phrasing slurs
732 De plus longues liaisons, dites de phrasé, sont délimitées par @code{\(} et
733 @code{\)}. Il est possible d'avoir en même temps des legatos et des
734 phrasés, mais pas plusieurs liaisons de phrasé ou de legato à la fois.
736 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
737 a8(\( ais b c) cis2 b'2 a4 cis,\)
742 @cindex slurs versus ties
743 @subheading Warnings: slurs vs. ties
745 Une liaison d'articulation ou de phrasé ressemble à une liaison de
746 tenue, mais n'a pas la même signification. Alors qu'une liaison de
747 tenue ne peut relier que deux notes de même hauteur, le legato indique
748 une articulation de plusieurs notes, éventuellement nombreuses. Les
749 liaisons de tenue peuvent être enchâssées dans un legato ou un phrasé.
751 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
752 c2~( c8 fis fis4 ~ fis2 g2)
758 @item Liaisons de prolongation
762 @item Liaisons de phrasé
763 voir @ref{Phrasing slurs}.
768 @node Articulation and dynamics
769 @subsection Articulation and dynamics
774 @subheading Articulations
776 Des @rglos{articulations} peuvent être ajoutées à une note, au moyen
777 d'un tiret @samp{-} suivi d'un caractère :
779 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
780 c-. c-- c-> c-^ c-+ c-_
784 @subheading Fingerings
785 De même, des indications de doigté peuvent être ajoutées à une note en
786 utilisant un tiret (@samp{-}) et le chiffre à écrire :
788 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
792 Articulations et doigtés sont habituellement placés automatiquement,
793 mais vous pouvez spécifier une direction en utilisant @samp{^} (en haut)
794 ou @samp{_} (en bas). Vous pouvez aussi utiliser plusieurs articulations
795 sur la même note. Dans la plupart des cas, cependant, il est mieux de
796 laisser LilyPond déterminer l'emplacement de l'articulation.
798 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
799 c_-^1 d^. f^4_2-> e^-_+
803 Les signes de nuances sont obtenus en ajoutant à la note les noms des nuances,
804 précédées d'un anti-slash @samp{\} :
806 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
814 @c Pluriel des termes musicaux italiens :
815 @c selon Littré, plutôt à la française (en "-os" qu'en "-i")
817 Crescendos et decrescendos débutent avec les commandes @code{\<} et
818 @code{\>}. Ils se terminent soit par une nuance d'arrivée, par
820 soit par la commande @code{\!} :
822 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
830 voir @ref{Articulations}.
832 voir @ref{Fingering instructions}.
839 @node Automatic and manual beams
840 @subsection Automatic and manual beams
842 @cindex beams, by hand
843 Toutes les @rglos{beam}s sont dessinées automatiquement :
845 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
846 a8 ais d ees r d c16 b a8
850 Lorsqu'on n'aime pas la manière dont les notes sont automatiquement
851 groupées, il est possible de les entrer à la main, en marquant la
852 première note à attacher d'un @samp{[} et la dernière d'un @samp{]}.
854 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
855 a8[ ais] d[ ees r d] a b
861 @item Groupements de notes et ligatures automatiques
862 voir @ref{Automatic beams}.
863 @item Groupements et ligatures manuels
864 voir @ref{Manual beams}.
869 @node Advanced rhythmic commands
870 @subsection Advanced rhythmic commands
874 @cindex partial measure
875 @subheading Partial measure
877 Une levée (ou @rglos{anacrusis}) est entrée avec la commande
878 @code{\partial}, suivie d'une durée : @code{\partial 4} est une levée
880 @code{\partial 8} d'une croche.
882 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
890 Les nolets sont créés avec la commande @code{\times}, qui prend
891 deux arguments : une fraction et une expression musicale. La durée des
892 notes de l'expression musicale est multipliée par la fraction. Par exemple les
893 notes d'un triolet durent les deux tiers du temps de leur notation
894 réelle, cette fraction est donc de 2/3 pour les triolets :
896 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
897 \times 2/3 { f8 g a }
899 \times 2/3 { f,8 g16[ a g a] }
906 @subheading Grace notes
908 Des notes d'ornement sont produites par la commande @code{\grace},
909 mais aussi en préfixant une expression musicale avec le mot-clé
910 @code{\appoggiatura} ou @code{\acciaccatura} :
912 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
913 c2 \grace { a32[ b] } c2
914 c2 \appoggiatura b16 c2
915 c2 \acciaccatura b16 c2
921 @item Notes d'ornement
922 voir @ref{Grace notes},
926 voir @ref{Partial measures}.
931 @node Multiple notes at once
932 @section Multiple notes at once
934 Cette section traite des situations où l'on a plus d'une note à la
935 fois : plusieurs instruments, plusieurs portées pour un même
936 instrument (le piano, par exemple), et les accords.
938 La polyphonie, en théorie musicale, est la notion d'une musique
939 constituée de plusieurs voix ; dans lilypond, ce terme désigne les
940 situations où il y a plus d'une voix sur une même portée.
943 * Music expressions explained::
946 * Single staff polyphony::
947 * Combining notes into chords::
951 @node Music expressions explained
952 @subsection Music expressions explained
954 Dans les fichiers source LilyPond, la musique est représentée par ce qu'on
955 appelle des @emph{expressions musicales}. En soi, une seule note peut
957 expression musicale, si tant est qu'elle soit correctement encadrée :
959 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
963 Mettre un groupe de notes entre accolades crée une nouvelle expression
966 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
970 Placer une séquence d'expressions musicales --- des notes par exemple
971 --- entre accolades signifie qu'elles doivent être jouées
972 successivement, les unes après les autres. Le résultat est une
973 expression, qui peut elle-même être regroupée séquentiellement avec
974 d'autres expressions. Ici, l'expression de l'exemple précédent est
975 combinée à deux notes :
977 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
981 @subheading Simultaneous music expressions: multiple staves
983 Cette technique est utile pour de la musique polyphonique. Pour
984 entrer une musique avec plusieurs voix ou plusieurs portées, nous
985 pouvons aussi combiner en parallèle les expressions. Deux voix qui doivent être
986 jouées en même temps, sont entrées comme une combinaison simultanée de
987 deux expressions. Une expression musicale @q{simultanée} est formée en
988 entourant les expressions entre @code{<<} et @code{>>}. Dans l'exemple
989 suivant, trois expressions (contenant chacune deux notes distinctes) sont
990 combinées simultanément.
992 @lilypond[quote,ragged-right,verbatim]
1002 Notez que nous avons ici indenté chaque niveau du fichier d'entrée
1003 avec un nombre d'espaces différent. LilyPond se moque de l'espace
1004 qu'il peut y avoir (ou pas) au début d'une ligne, mais en indentant
1005 votre code vous le rendrez bien plus facile à lire pour les humains.
1007 @strong{Attention} : chaque note saisie est relative à la précédente,
1008 mais pas au @code{c''} de la commande @code{\relative} de départ.
1011 @subheading Simultaneous music expressions: single staff
1013 Pour déterminer le nombre de portées, LilyPond regarde le premier
1014 élément autre qu'une accolade. Si c'est une seule note, il y a une
1015 portée ; si c'est une expression simultanée, il y aura plus d'une
1018 @lilypond[quote,ragged-right,verbatim]
1021 << { e f } { c <<b d>> } >>
1026 @cindex music expression
1027 @subheading Analogy: mathematical expressions
1029 Ce mécanisme est similaire au formules mathématiques : une grosse
1030 formule est créée en assemblant plusieurs petites formules. Ces types
1031 de formules, appelées expressions, ont une définition récursive, de
1032 telle sorte que vous pouvez fabriquer des expressions arbitrairement
1033 longues et complexes. Par exemple,
1042 ((1 + 2) * 3) / (4 * 5)
1045 Ceci est une suite d'expressions, où chacune est contenue dans la
1046 suivante. Les expressions les plus simples sont les nombres, et de
1047 plus grandes expressions sont produites en combinant des expressions
1048 avec des opérateurs --- comme @samp{+}, @samp{*} et @samp{/} --- et des
1049 parenthèses. Tout comme les expressions mathématiques, les expressions
1050 musicales peuvent être imbriquées avec une profondeur arbitraire, ce
1051 qui est nécessaire pour de la musique complexe comme des partitions
1055 @node Multiple staves
1056 @subsection Multiple staves
1058 Comme nous l'avons vu dans @ref{Music expressions explained}, un
1059 fichier d'entrée LilyPond est fait d'expressions musicales. Si la
1060 partition commence par plusieurs expressions simultanées, LilyPond
1061 créera plusieurs portées. Cependant, il est plus facile de voir ce
1062 qu'il advient si l'on crée explicitement chacune des portées.
1064 Pour créer plus d'une portée, chaque partie de la musique constituant
1065 une portée est entrée en la faisant précéder de @code{\new Staff}.
1066 Ces éléments @code{Staff} sont ensuite combinés en parallèle avec
1067 @code{<<} et @code{>>}, comme ceci :
1069 @lilypond[quote,ragged-right,verbatim]
1072 \new Staff { \clef treble c }
1073 \new Staff { \clef bass c,, }
1079 La commande @code{\new} introduit un « contexte de notation ». Un
1080 contexte de notation est un environnement dans lequel les événements
1081 musicaux --- comme les notes ou les commandes @code{\clef} --- sont
1082 interprétés. Pour des pièces simples, ces contextes sont créés
1083 automatiquement. Pour des pièces plus complexes, il est préférable de
1084 spécifier explicitement les contextes. Cela assure que chaque
1085 fragment aura sa propre portée.
1087 Il existe différents types de contextes. Les contextes @code{Staff}
1088 (portée), @code{Voice} (voix) et @code{Score} (partition) gèrent la
1089 notation de la mélodie, alors que @code{Lyrics} gère les paroles et
1090 @code{ChordNames} imprime le nom des accords.
1092 En termes de syntaxe, faire précéder une expression musicale de
1093 @code{\new} crée une plus grosse expression musicale. En reprenant la
1094 comparaison, cela ressemble au signe « moins » en mathématiques. La
1095 formule @math{(4+5)} est une expression, donc @math{-(4+5)} est une
1096 plus grosse expression.
1098 Les chiffres de mesure figurant sur une portée affectent toutes les
1099 autres portées ; en revanche l'armure d'une portée n'affectera
1100 @emph{pas} les autres portées.@footnote{Ce comportement peut être
1101 modifié si nécessaire : voir pour cela @ref{Changing defaults}.}.
1103 @lilypond[quote,ragged-right,verbatim]
1106 \new Staff { \clef treble \time 3/4 c }
1107 \new Staff { \clef bass \key d \major c,, }
1116 @subsection Piano staves
1118 @cindex staff switch, manual
1119 @cindex cross staff voice, manual
1120 La musique pour piano s'écrit sur deux portées reliées par une
1121 accolade. Imprimer ce type de portée revient au même que dans
1122 l'exemple de musique polyphonique de @ref{Multiple staves}, mais
1123 maintenant cette expression entière doit être interprétée dans un
1124 contexte @code{PianoStaff} :
1133 Voici un bref exemple :
1135 @lilypond[quote,ragged-right,verbatim]
1138 \new Staff { \time 2/4 c4 e g g, }
1139 \new Staff { \clef bass c,, c' e c }
1146 Voir @ref{Piano music}.
1150 @node Single staff polyphony
1151 @subsection Single staff polyphony
1154 @cindex multiple voices
1155 @cindex voices, more -- on a staff
1156 Quand différentes lignes mélodiques sont combinées sur une seule et
1157 même portée, elles sont imprimées comme des voix polyphoniques ;
1158 chaque voix a ses propre hampes@footnote{familièrement appelées queues
1159 de note.}, liaisons et ligatures, la voix supérieure ayant les hampes
1160 vers le haut, la voix inférieure vers le bas.
1162 Ce type de partition est réalisé en entrant chaque voix comme une
1163 séquence (avec @code{@{...@}}), en combinant simultanément les voix et
1164 en les séparant par @code{\\} :
1167 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
1174 Pour l'écriture de musique polyphonique, les silences invisibles
1175 s'avèrent bien pratiques : ce sont des silences qui ne s'impriment
1176 pas. Ils sont utiles pour remplir des voix qui, temporairement, ne
1177 jouent rien. On peut voir ici le même exemple avec un silence
1178 invisible (@code{s}) à la place d'un silence normal (@code{r}) :
1180 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
1188 Là encore, ces expressions peuvent s'imbriquer arbitrairement :
1190 @lilypond[quote,fragment,verbatim,relative=2,fragment]
1198 { <c g>1 ~ <c g>4 } \\
1206 Voir @ref{Basic polyphony}.
1210 @node Combining notes into chords
1211 @subsection Combining notes into chords
1214 Des accords peuvent être produits en entourant les hauteurs de notes
1215 par des angles gauche et droit --- @samp{<} et @samp{>} ---
1217 @lilypond[quote,fragment,verbatim,relative=2,fragment]
1218 r4 <c e g>4 <c f a>2
1221 Vous pouvez combiner les indications comme les liaisons et les
1222 ligatures de croches avec les accords. Ils doivent cependant être
1223 placés en dehors des angles :
1226 @lilypond[quote,fragment,verbatim,relative=2,fragment]
1227 r4 <c e g>8[ <c f a>]~ <c f a>2
1230 @lilypond[quote,fragment,verbatim,relative=2,fragment]
1231 r4 <c e g>8\>( <c e g> <c e g>4 <c f a>\!)
1238 Cette section présente l'écriture vocale et les partitions de variété.
1246 @node Printing lyrics
1247 @subsection Printing lyrics
1251 Prenons une mélodie toute simple :
1253 @lilypond[quote,ragged-right,verbatim]
1260 Des paroles peuvent être associées à ces notes, en les combinant avec
1261 la commande @code{\addlyrics}. Les paroles sont entrées en séparant
1262 chaque syllable par un espace :
1264 @lilypond[quote,ragged-right,verbatim]
1270 \addlyrics { One day this shall be free }
1275 @cindex extender line
1276 Cette mélodie se termine sur un @rglos{melisma}, c'est-à-dire qu'une
1277 seule syllable (« free ») correspond à plus d'une note. Ceci est
1278 indiqué avec une @emph{ligne d'extension}. Elle est entrée avec deux
1279 caractères souligné (@code{_}), c'est-à-dire :
1281 @lilypond[quote,ragged-right,verbatim]
1287 \addlyrics { One day this shall be free __ }
1291 De la même manière, les séparations syllabiques d'un mot peuvent être
1292 entrées avec deux tirets (@code{-}), ce qui produit un tiret centré
1293 entre les deux syllabes :
1295 @c no ragged-right here because otherwise the hypens get lost.
1296 @lilypond[quote,verbatim]
1302 \addlyrics { A -- le -- gri -- a }
1308 Plus de possibilités, comme celle d'ajouter plusieurs lignes de
1309 paroles en dessous d'une même mélodie sont exposées dans @ref{Vocal
1315 @subsection A lead sheet
1321 En musique de variété, il est courant d'indiquer l'accompagnement par
1322 le nom des accords. De tels accords peuvent être entrés comme les
1325 @lilypond[quote,ragged-right,verbatim]
1326 \chordmode { c2 f4. g8 }
1329 Maintenant, chaque hauteur est lue comme la base de l'accord à la
1330 place de la note. Ce mode est activé avec @code{\chordmode}.
1331 D'autres accords peuvent être créés en ajoutant des modifiacteurs
1332 après deux points. L'exemple suivant montre quelques modificateurs
1335 @lilypond[quote,verbatim,ragged-right]
1336 \chordmode { c2 f4:m g4:maj7 gis1:dim7 }
1339 Pour la musique improvisée, les accords ne sont pas imprimés sur des
1340 portées mais comme des lignes à part entière. Ceci s'obtient en
1341 utilisant @code{\chords} à la place de @code{\chordmode}. La même
1342 syntaxe sera utilisée que dans le cas de@code{\chordmode}, mais le
1343 rendu des notes interviendra dans un contexte de @code{ChordNames},
1344 avec le résultat suivant :
1346 @lilypond[quote,verbatim,ragged-right]
1347 \chords { c2 f4.:m g4.:maj7 gis8:dim7 }
1351 Une fois assemblés, les accords, paroles et mélodie forment une
1352 partition de chanson :
1354 @lilypond[quote,verbatim,ragged-right]
1356 \chords { c2 g:sus4 f e }
1361 \addlyrics { One day this shall be free __ }
1368 Une liste complète de modificateurs et d'autres options de mise en
1369 forme se trouve à la section @ref{Chords}.
1374 @section Final touches
1376 L'ultime section de ce tutoriel montre comment ajouter la touche
1377 finale à des morceaux simples, et consititue une introduction au reste
1383 * Absolute note names::
1384 * Organizing pieces with identifiers::
1385 * After the tutorial::
1386 * How to read the manual::
1390 @node Version number
1391 @subsection Version number
1394 La déclaration @code{\version} stipule le numéro de la version de
1395 LilyPond pour laquelle le fichier a été écrit. Pour donner à un
1396 fichier la version 2.11.20, ajoutez
1403 tout en haut de votre fichier LilyPond.
1405 Cette annotation permet de faciliter les prochaines mises à jour de
1406 LilyPond. Les changements dans la syntaxe sont gérés avec un
1407 programme spécial, @file{convert-ly} --- voir @ref{Updating files with
1408 convert-ly} --- et il utilise @code{\version} pour déterminer les
1409 règles de conversion à appliquer au fichier.
1413 @subsection Adding titles
1415 Les informations bibliographiques (nom du morceau, du compositeur,
1416 etc) sont entrées dans un bloc séparé, le bloc d'en-tête
1417 (@code{\header}), qui existe indépendamment des expressions musicales
1418 principales. Le bloc @code{\header} est habituellement placé en début
1430 @dots{} music @dots{}
1433 Quand le fichier est traité, le titre et le compositeur sont imprimés
1434 en haut de la partition. Vous trouverez plus d'informations sur les
1435 titres à @ref{Creating titles}.
1437 @node Absolute note names
1438 @subsection Absolute note names
1440 Jusqu'ici nous n'avons utilisé que le mode @code{\relative} pour
1441 définir les hauteurs de notes. Si c'est effectivement le moyen le
1442 plus simple d'entrer la majeure partie de votre musique, il existe une
1443 autre façon de procéder : le mode de hauteurs absolues.
1445 Si vous omettez la commande @code{\relative}, LilyPond considérera
1446 toutes les hauteurs comme des hauteurs absolues. Un @code{c'} sera
1447 toujours un do du milieu, un @code{b} sera toujours une note
1448 au-dessous du précédent, et un @code{g,} sera toujours la note la plus
1449 grave dans la portée de clé de Fa.
1451 @lilypond[quote,verbatim,ragged-right]
1459 Voici une gamme sur 4 octaves :
1461 @lilypond[quote,verbatim,ragged-right]
1476 Comme vous pouvez le voir, il faut beaucoup d'apostrophes pour écrire
1477 de la musique dans un registre aigu. Regardez cet extrait de Mozart :
1479 @lilypond[quote,verbatim,ragged-right]
1483 cis''8. d''16 cis''8 e''4 e''8
1484 b'8. cis''16 b'8 d''4 d''8
1488 Toutes ces apostrophes rendent le fichier moins lisible, et c'est donc
1489 une source d'erreurs. En mode @code{\relative}, le même exemple
1490 devient bien plus facile à lire :
1492 @lilypond[quote,verbatim,ragged-right]
1496 cis8. d16 cis8 e4 e8
1501 Si d'aventure vous faites une erreur d'octaviation, le mode
1502 @code{\relative} la rendra frappante --- toutes les notes suivantes
1503 seront placées à la mauvaise octave. En mode de hauteurs absolues,
1504 une erreur isolée ne serait pas aussi visible, et donc aussi facile à
1507 Cependant, le mode de hauteurs absolues reste utile pour les musiques
1508 où les intervalles sont étendus, surtout pour les fichiers LilyPond
1509 créés par ordinateur.
1512 @node Organizing pieces with identifiers
1513 @subsection Organizing pieces with identifiers
1515 Lorsque l'on combine tous les éléments étudiés plus haut pour produire
1516 des fichiers plus volumineux, les blocs @code{\score} deviennent
1517 beaucoup plus gros parce que les expressions musicales sont plus
1518 longues et, dans le cas des pièces polyphoniques, profondément
1519 imbriquées. De telles expressions imposantes finissent par devenir
1520 peu maniables. Cet inconvénient peut être résolu par l'utilisation
1521 d'@emph{identificateurs}.
1523 En utilisant ces identificateurs, que l'on pourrait aussi appeler
1524 variables ou macros, il est possible de découper des expressions
1525 musicales complexes. Un identificateur se définit comme suit :
1528 MusiqueToto = @{ @dots{} @}
1531 Le contenu de l'expression musicale @code{MusiqueToto} pourra être
1532 utilisé plus loin en faisant précéder son nom d'un anti-slash,
1533 c'est-à-dire @code{\MusiqueToto}, juste comme n'importe quelle
1534 commande LilyPond. Tous les identificateurs doivent être définis
1535 @emph{avant} l'expression musicale principale.
1537 @lilypond[quote,verbatim,ragged-right]
1538 violin = \new Staff { \relative c'' {
1541 cello = \new Staff { \relative c {
1554 Le nom d'un identificateur ne doit comporter que des caractères
1555 alphabétiques non accentués, aucun nombre ni tiret.
1557 Il est possible d'utiliser des variables de types variés. Par exemple,
1562 aFivePaper = \paper @{ paperheight = 21.0 \cm @}
1565 En fonction de son contenu, un identificateur peut être utilisé à
1566 différents endroits. L'exemple suivant utilise la variable ci-dessus
1578 @node After the tutorial
1579 @subsection After the tutorial
1581 Après avoir parcouru ce tutoriel, vous devriez vous essayer à écrire
1582 un morceau ou deux. Commencez par copier l'un des @ref{Templates}
1583 types et ajoutez-y des notes. Si vous voulez employer une notation
1584 que vous n'avez pas trouvé dans le tutoriel, consultez la référence de
1585 notation, en commençant par la @ref{Basic notation}. Si vous désirez
1586 écrire pour un ensemble instrumental non couvert par les
1587 @ref{Templates}, lisez la section @ref{Extending the templates}.
1589 Après avoir écrit quelques pièces courtes, lisez les chapitres 3 à 5
1590 du manuel d'apprentissage. Rien ne s'oppose à ce que vous consultiez
1591 dès à présent les autres chapitres, bien sûr ! Néanmoins, le reste du
1592 manuel de l'utilisateur part du principe que vous avez déjà bien
1593 assimilé la syntaxe de LilyPond. Vous pouvez toujours survoler le
1594 reste du manuel, et y revenir plus tard après avoir acquis de
1597 @node How to read the manual
1598 @subsection How to read the manual
1600 Comme nous l'avons déjà vu dans @ref{How to read the tutorial}, de
1601 nombreux exemples du tutoriel n'ont pas fait apparaître le
1602 @code{\relative c'' @{ ... @}} dans l'extrait de code affiché.
1604 Dans le reste du manuel, les exemples utilisés sont encore beaucoup
1605 plus souples : parfois il leur manque le @code{\relative c'' @{ ...
1606 @}}, mais d'autres fois ils ont recours à une autre hauteur de
1607 référence, telle que @code{c'} ou @code{c,,}), et dans certains cas
1608 c'est même l'exemple entier qui est en mode de hauteurs absolues !
1609 Cependant, de telles ambiguïtés ne se trouvent que dans des contextes
1610 où les hauteurs n'ont que peu d'importance. Dans tous les exemples où
1611 elles en ont, le mode @code{\relative} ou absolu @code{@{ @}} est
1612 explicitement spécifié.
1614 Si vous ne vous y retrouvez toujours pas pour savoir quel code
1615 LilyPond produit précisément tel ou tel exemple, consultez la version
1616 HTML de ce manuel si ce n'est pas déjà le cas, et cliquez sur l'image
1617 de la partition. La source exacte utilisée pour générer ce manuel