1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
2 @c This file is part of lilypond.tely
4 Translation of GIT committish: 71b67137f76fa4e8aede58299630369f616004d9
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. See TRANSLATION for details.
12 - unless you have a really good reason, use either
13 @l ilypond[quote,ragged-right,verbatim]
15 @l ilypond[quote,ragged-right,verbatim,fragment,relative=2]
17 Don't use any other relative=X commands (make it a non-fragment
18 example), and don't use fragment without relative=2.
19 - use "aes" and "ees" instead of "as" and "aes". I know it's not
20 correct Dutch naming, but let's not confuse people with this until
21 we get to the Basic notation chapter.
26 @c old info that will probably be removed.
28 @c * more details about running lilypond; error messages,
29 @c compiling/viewing (emacs?)
30 @c * where to go from First steps+More basics?
32 @c wherever possible, do not include index entries here; the
33 @c index should point to stuff in the reference manual. -gp
35 @c Your first LilyPond score in 10 minutes?
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 l'@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 casse, prise en compte de
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 survient, 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 à @rprogram{Text 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 @rprogram{Text 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 visionnage de la musique
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 fa, 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 Une @rglos{dotted note} s'obtient 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 La @rglos{time signature} peut être définie à 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 Le traitement des fichiers source de LilyPond est semblable à celui du
418 code de nombreux langages de programmation répandus : la casse est prise
419 en compte, et les caractères considérés comme espaces ont généralement
420 peu d'importance. Les expressions sont délimitées par des accolades @{
421 @}, et les commentaires par @code{%} ou @code{%@{ ... %@}}.
423 Si cette phrase vous paraît incompréhensible, ne vous en faites pas !
424 Tous ces termes vont être expliqués :
428 @cindex casse, prise en compte de
429 @item @strong{La casse} :
430 LilyPond est sensible à la casse, c'est à dire qu'une lettre capitale
431 n'a pas la même valeur qu'une lettre minuscule. Les notes, par
432 exemple, doivent être entrées en minuscules : @code{@{ c d e @}} est
433 un code valide, alors que @code{@{ C D E @}} produira un message
436 @item @strong{Les espaces multiples} :
437 LilyPond ne tient pas compte du nombre d'espaces, ou de retours à la
438 ligne. @code{@{ c d e @}} a le
439 même sens que @code{@{ c @tie{} @tie{} d @tie{} e @}} ou que
447 Bien sûr, ce dernier exemple est difficile à lire. Une bonne habitude
448 à prendre est d'indenter les blocs de code avec soit des tabulations
449 soit des doubles espaces :
456 @item @strong{Expressions musicales} :
457 Tout morceau saisi dans LilyPond doit être placé entre @strong{@{
458 accolades @}}. Ces caractères indiquent à LilyPond que ce bloc de
459 texte est une et une seule expression musicale, tout comme les
460 parenthèses @samp{()} en mathématiques. Il est préférable, pour
461 éviter toute ambiguïté, d'entourer tous ces crochets d'espaces, à
462 moins qu'ils se trouvent au début ou à la fin d'une ligne.
464 Une fonction --- @code{\relative @{ @}} par exemple --- compte
465 également comme une seule expression musicale.
468 @cindex commentaire de fin de ligne
469 @cindex commentaire-bloc
470 @item @strong{Les commentaires} :
471 Un commentaire est une indication pour tout lecteur humain d'un
472 fichier de musique ; il est ignoré par l'ordinateur, et n'a donc aucun
473 effet sur la partition imprimée. On distingue deux types de
476 @item la ligne de commentaire, introduite par le symbole @samp{%} :
477 tout ce qui suit ce symbole sur cette ligne sera ignoré.
478 @item le bloc de commentaire, qui peut être de plusieurs lignes voire
479 de toute une section : tout ce qui se trouve entre @code{%@{} et
480 @code{%@}} est ignoré. Les blocs de commentaires ne peuvent s'imbriquer.
482 Le fragment suivant met en évidence quelques usages possibles des commentaires :
485 % voici les notes de "ah vous dirai-je maman"
489 Ces lignes et les notes qui suivent
490 seront ignorées, car elles se trouvent
491 dans un bloc de commentaire.
499 Vous trouverez plus d'astuces pour organiser vos fichiers LilyPond dans
500 @ref{Suggestions for writing LilyPond files}.
503 @node How to read the tutorial
504 @subsection How to read the tutorial
506 Comme nous l'avons vu dans @ref{Working on text files}, un code
507 LilyPond doit être encadré par des @{ @} ou bien par @code{\relative
508 c'' @{ ... @}} afin d'être compris. Cependant, dans la suite de ce
509 manuel, la plupart des exemples ne feront pas apparaître ces signes.
511 Si vous consultez la documentation au format HTML, et que vous
512 souhaitez voir la source exacte d'un exemple, il vous suffit de
513 cliquer sur l'image. Si vous ne disposez pas de la version HTML, il
514 vous est possible de simplement copier et coller le code affiché, mais
515 @strong{à condition} d'ajouter @code{\relative c'' @{ @}} de la façon
520 ... collez ici votre exemple...
524 Pourquoi avoir omis les accolades ? La plupart des exemples de ce
525 manuel peuvent être insérés au milieu d'un morceau de musique plus
526 long. Il n'y a donc aucune raison d'ajouter @code{\relative c'' @{
527 @}} à ces exemples --- en effet, il n'est pas possible d'insérer un
528 @code{\relative} à l'intérieur d'un autre @code{\relative}. Il vous
529 serait donc devenu impossible de copier un bref exemple de la
530 documentation et de le coller dans une pièce de votre cru.
532 @node Single staff notation
533 @section Single staff notation
535 Cette section présente la notation courante dont on a besoin pour
536 écrire une seule voix sur une seule portée.
539 * Relative note names::
540 * Accidentals and key signatures::
542 * Articulation and dynamics::
543 * Automatic and manual beams::
544 * Advanced rhythmic commands::
548 @node Relative note names
549 @subsection Relative note names
551 Comme nous l'avons vu dans @ref{Simple notation}, LilyPond calcule la
552 hauteur de chaque note en fonction de la précédente@footnote{Il existe
553 un autre mode de saisie des hauteurs, le mode @ref{Absolute note
554 names}, mais en pratique il est bien plus aisé et sûr d'avoir recours
555 au mode de hauteurs relatives.}. Si aucune indication supplémentaire
556 d'octaviation n'est ajoutée, il en concluera que chaque hauteur est
557 située à une quarte au plus de la note précédente.
559 Lilypond tient compte des intervalles induits par les noms des notes
560 --- en d'autres termes, une quarte augmentée n'est @emph{pas}
561 équivalente à une quinte diminuée. Ainsi, si l'on part d'un Do, un Fa
562 dièse sera placé au-dessus, tandis qu'un Sol bémol sera placé
565 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
573 @item Les hauteurs de note relatives
574 voir @ref{Relative octaves}.
575 @item Les vérifications d'octaves
576 voir @ref{Octave check}.
582 @node Accidentals and key signatures
583 @subsection Accidentals and key signatures
585 @subheading Accidentals
587 Dans la notation par défaut, un @rglos{sharp} s'obtient en ajoutant
588 @samp{is} au nom de la note, et un @rglos{flat} en ajoutant @samp{es}.
589 Comme vous pouvez vous y attendre, un double dièse ou double bémol est
590 alors obtenu en ajoutant @samp{isis} ou @samp{eses}@footnote{Cette
591 syntaxe est dérivée de la convention de dénomination des notes dans
592 les langues nordiques et germaniques, comme l'allemand ou le
596 Cependant, si vous utilisez la commande @samp{\include "italiano.ly"}
597 pour entrer les noms de notes français au lieu des noms hollandais, il
598 faudra ajouter un @samp{d} pour un dièse, et un @samp{b} pour un
599 bémol. Le double dièse et le double bémol s'obtiennent en ajoutant
600 respectivement @samp{dd} et @samp{bb}
603 Pour en savoir plus sur les autres langues disponibles, voir @ref{Note
604 names in other languages}.
606 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
607 cis1 ees fisis, aeses
610 @cindex armure, définition de
611 @subheading Key signatures
613 L'armure est déterminée par la commande @code{\key}, suivie d'une
614 hauteur puis de @code{\major} (majeur) ou @code{\minor} (mineur) :
616 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
625 @subheading Warning: key signatures and pitches
627 La combinaison de l'armure et des hauteurs de note --- y compris les
628 altérations --- permet à LilyPond de déterminer dans quel cas afficher
629 les altérations accidentelles. L'armure n'affecte que les altérations
630 @emph{imprimées}, et non les hauteurs réelles ! Cette fonctionnalité
631 est souvent source de confusion pour les nouveaux utilisateurs, aussi
632 expliquons-la en détail.
634 LilyPond fait une nette distinction entre le contenu musical et la
635 mise en forme. L'altération d'une note --- bémol, bécarre ou dièse
636 --- fait partie de sa hauteur, et relève donc du contenu musical. La
637 présence ou non d'une altération accidentelle --- un @emph{signe}
638 bémol, bécarre ou dièse --- devant la note correspondante est une
639 question qui relève de la mise en page. Mettre en page une partition
640 se fait selon des règles ; les altérations accidentelles seront donc
641 automatiquement imprimées suivant ces règles. Les hauteurs de note,
642 en revanche, relèvent de ce que vous voulez entendre ; et, dans la
643 mesure où la musique que vous entrez est censée être celle que vous
644 voulez entendre, LilyPond (qui n'est chargé que de la gravure) ne les
645 choisira pas à votre place.
649 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
655 aucune note n'a d'altération accidentelle, et pourtant vous devrez
656 entrer le @samp{is} pour les notes @code{cis} et @code{fis}.
658 Le code @samp{d} ne veut pas dire @qq{Imprimez-moi un point noir juste
659 en-dessous de la portée.} Cela signifie plutôt : @qq{Ici se trouve
661 hauteur est un ré naturel.} Avec l'armure de la bémol majeur, ce ré
663 d'un bécarre accidentel :
665 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
670 Ajouter explicitement toutes les altérations requiert un peu plus
671 d'effort dans la phase de saisie, mais la transposition en sera
672 grandement facilitée.
673 De plus les altérations accidentelles
674 peuvent être imprimées suivant plusieurs conventions. Regardez
675 @ref{Automatic accidentals} pour connaître les différentes manières dont les
676 altérations accidentelles peuvent être imprimées, suivant les règles
682 @item Les altérations
683 voir @ref{Accidentals} and @ref{Automatic accidentals}.
685 voir @ref{Key signature}.
691 @subsection Ties and slurs
693 @cindex liaisons de prolongation
695 Une @rglos{tie}@footnote{parfois aussi appelée liaison de
696 tenue} se crée en ajoutant un tilde @samp{~} à la première note liée.
698 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
703 @cindex liaisons d'articulation
706 @c Le terme de "slur" a deux sens en français : articulation et phrasé.
707 @c Je garde ici le terme "legato", tel qu'il apparaît dans le texte original,
708 @c car c'est celui qui me semble le plus couramment employé.
710 Une @rglos{slur} d'articulation (ou @qq{legato}) peut englober
711 plusieurs notes. Les notes de départ et d'arrivée reçoivent
712 respectivement un signe @samp{(} et @samp{)}.
714 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
715 d4( c16) cis( d e c cis d) e( d4)
718 @cindex liaisons de phrasé
719 @subheading Phrasing slurs
721 De plus longues liaisons, dites de phrasé, sont délimitées par @code{\(} et
722 @code{\)}. Il est possible d'avoir en même temps des legatos et des
723 phrasés, mais pas plusieurs liaisons de phrasé ou de legato à la fois.
725 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
726 a8(\( ais b c) cis2 b'2 a4 cis,\)
731 @cindex liaisons de phrasé et de prolongation, différences
732 @subheading Warnings: slurs vs. ties
734 Une liaison d'articulation ou de phrasé ressemble à une liaison de
735 tenue, mais n'a pas la même signification. Alors qu'une liaison de
736 tenue ne peut relier que deux notes de même hauteur, le legato indique
737 une articulation de plusieurs notes, éventuellement nombreuses. Les
738 liaisons de tenue peuvent être enchâssées dans un legato ou un phrasé.
740 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
741 c2~( c8 fis fis4 ~ fis2 g2)
749 @item @ref{Phrasing slurs}.
754 @node Articulation and dynamics
755 @subsection Articulation and dynamics
760 @subheading Articulations
762 Des @rglos{articulation}s peuvent être ajoutées à une note, au moyen
763 d'un tiret @samp{-} suivi d'un caractère :
765 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
766 c-. c-- c-> c-^ c-+ c-_
770 @subheading Fingerings
771 De même, des indications de doigté peuvent être ajoutées à une note en
772 utilisant un tiret (@samp{-}) et le chiffre à écrire :
774 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
778 Articulations et doigtés sont habituellement placés automatiquement,
779 mais vous pouvez spécifier une direction en utilisant @samp{^} (en haut)
780 ou @samp{_} (en bas). Vous pouvez aussi utiliser plusieurs
781 articulations sur la même note. Dans la plupart des cas, cependant, il
782 est mieux de laisser LilyPond déterminer l'emplacement de
785 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
786 c_-^1 d^. f^4_2-> e^-_+
790 Les signes de nuances sont obtenus en ajoutant à la note les noms des nuances,
791 précédées d'un anti-slash @samp{\} :
793 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
801 @c Pluriel des termes musicaux italiens :
802 @c selon Littré, plutôt à la française (en "-os" qu'en "-i")
804 Crescendos et decrescendos débutent avec les commandes @code{\<} et
805 @code{\>}. Ils se terminent soit par une nuance d'arrivée, par exemple
806 @code{\f}, soit par la commande @code{\!} :
808 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
815 @item @ref{Articulations}.
816 @item @ref{Fingering instructions}.
817 @item @ref{Dynamics}.
822 @node Automatic and manual beams
823 @subsection Automatic and manual beams
825 @cindex ligatures manuelles
826 Toutes les @rglos{beam} sont dessinées automatiquement :
828 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
829 a8 ais d ees r d c16 b a8
833 Lorsqu'on n'aime pas la manière dont les notes sont automatiquement
834 groupées, il est possible de les ligaturer manuellement, en marquant la
835 première note à attacher d'un @samp{[} et la dernière d'un @samp{]}.
837 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
838 a8[ ais] d[ ees r d] a b
844 @item Groupements de notes et ligatures automatiques
845 voir @ref{Automatic beams}.
846 @item Groupements et ligatures manuels
847 voir @ref{Manual beams}.
852 @node Advanced rhythmic commands
853 @subsection Advanced rhythmic commands
857 @cindex mesure incomplète
858 @subheading Partial measure
860 Une levée (ou @rglos{anacrusis}) est entrée avec la commande
861 @code{\partial}, suivie d'une durée : @code{\partial 4} est une levée
862 d'une noire et @code{\partial 8} d'une croche.
864 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
872 Les nolets sont créés avec la commande @code{\times}, qui prend deux
873 arguments : une fraction et une expression musicale. La durée des notes
874 de l'expression musicale est multipliée par la fraction. Par exemple
875 les notes d'un triolet durent les deux tiers du temps de leur notation
876 réelle, cette fraction est donc de 2/3 pour les triolets :
878 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
879 \times 2/3 { f8 g a }
881 \times 2/3 { f,8 g16[ a g a] }
885 @cindex notes d'ornement
886 @cindex ornementation
888 @subheading Grace notes
890 Des notes d'ornement sont produites par la commande @code{\grace}, mais
891 aussi en préfixant une expression musicale avec le mot-clé
892 @code{\appoggiatura} ou @code{\acciaccatura} :
894 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
895 c2 \grace { a32[ b] } c2
896 c2 \appoggiatura b16 c2
897 c2 \acciaccatura b16 c2
903 @item Notes d'ornement
904 voir @ref{Grace notes},
908 voir @ref{Partial measures}.
913 @node Multiple notes at once
914 @section Multiple notes at once
916 Cette section traite des situations où l'on a plus d'une note à la fois
917 : plusieurs instruments, plusieurs portées pour un même instrument (le
918 piano, par exemple), et les accords.
920 La polyphonie, en théorie musicale, est la notion d'une musique
921 constituée de plusieurs voix ; dans lilypond, ce terme désigne les
922 situations où il y a plus d'une voix sur une même portée.
925 * Music expressions explained::
928 * Combining notes into chords::
929 * Single staff polyphony::
933 @node Music expressions explained
934 @subsection Music expressions explained
936 Dans les fichiers source LilyPond, la musique est représentée par ce
937 qu'on appelle des @emph{expressions musicales}. En soi, une seule note
938 peut constituer une expression musicale, si tant est qu'elle soit
939 correctement encadrée :
941 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
945 Mettre un groupe de notes entre accolades crée une nouvelle expression
948 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
952 Placer une séquence d'expressions musicales --- des notes par exemple
953 --- entre accolades signifie qu'elles doivent être jouées
954 successivement, les unes après les autres. Le résultat est une
955 expression, qui peut elle-même être regroupée séquentiellement avec
956 d'autres expressions. Ici, l'expression de l'exemple précédent est
957 combinée à deux notes :
959 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
963 @subheading Simultaneous music expressions: multiple staves
965 Cette technique est utile pour de la musique polyphonique. Pour entrer
966 une musique avec plusieurs voix ou plusieurs portées, nous pouvons aussi
967 combiner en parallèle les expressions. Deux voix qui doivent être
968 jouées en même temps, sont entrées comme une combinaison simultanée de
969 deux expressions. Une expression musicale @q{simultanée} est formée en
970 entourant les expressions entre @code{<<} et @code{>>}. Dans l'exemple
971 suivant, trois expressions (contenant chacune deux notes distinctes)
972 sont combinées simultanément.
974 @lilypond[quote,ragged-right,verbatim]
984 Notez que nous avons ici indenté chaque niveau du fichier d'entrée avec
985 un nombre d'espaces différent. LilyPond se moque de l'espace qu'il peut
986 y avoir (ou pas) au début d'une ligne, mais en indentant votre code vous
987 le rendrez bien plus facile à lire pour les humains.
989 @strong{Attention} : chaque note saisie est relative à la précédente,
990 mais pas au @code{c''} de la commande @code{\relative} de départ.
993 @subheading Simultaneous music expressions: single staff
995 Pour déterminer le nombre de portées, LilyPond regarde le premier
996 élément autre qu'une accolade. Si c'est une seule note, il y a une
997 portée ; si c'est une expression simultanée, il y aura plus d'une
1000 @lilypond[quote,ragged-right,verbatim]
1003 << { e f } { c <<b d>> } >>
1008 @cindex expression musicale
1009 @subheading Analogy: mathematical expressions
1011 Ce mécanisme est similaire au formules mathématiques : une grosse
1012 formule est créée en assemblant plusieurs petites formules. Ces types
1013 de formules, appelées expressions, ont une définition récursive, de
1014 telle sorte que vous pouvez fabriquer des expressions arbitrairement
1015 longues et complexes. Par exemple,
1024 ((1 + 2) * 3) / (4 * 5)
1027 Ceci est une suite d'expressions, où chacune est contenue dans la
1028 suivante. Les expressions les plus simples sont les nombres, et de plus
1029 grandes expressions sont produites en combinant des expressions avec des
1030 opérateurs --- comme @samp{+}, @samp{*} et @samp{/} --- et des
1031 parenthèses. Tout comme les expressions mathématiques, les expressions
1032 musicales peuvent être imbriquées avec une profondeur arbitraire, ce qui
1033 est nécessaire pour de la musique complexe comme des partitions
1037 @node Multiple staves
1038 @subsection Multiple staves
1040 Comme nous l'avons vu dans @ref{Music expressions explained}, un fichier
1041 d'entrée LilyPond est fait d'expressions musicales. Si la partition
1042 commence par plusieurs expressions simultanées, LilyPond créera
1043 plusieurs portées. Cependant, il est plus facile de voir ce qu'il
1044 advient si l'on crée explicitement chacune des portées.
1046 Pour créer plus d'une portée, chaque partie de la musique constituant
1047 une portée est entrée en la faisant précéder de @code{\new Staff}. Ces
1048 éléments @code{Staff} sont ensuite combinés en parallèle avec @code{<<}
1049 et @code{>>}, comme ceci :
1051 @lilypond[quote,ragged-right,verbatim]
1054 \new Staff { \clef treble c }
1055 \new Staff { \clef bass c,, }
1061 La commande @code{\new} introduit un @qq{contexte de notation}. Un
1062 contexte de notation est un environnement dans lequel les événements
1063 musicaux --- comme les notes ou les commandes @code{\clef} --- sont
1064 interprétés. Pour des pièces simples, ces contextes sont créés
1065 automatiquement. Pour des pièces plus complexes, il est préférable de
1066 spécifier explicitement les contextes. Cela assure que chaque fragment
1067 aura sa propre portée.
1069 Il existe différents types de contextes. Les contextes @code{Staff}
1070 (portée), @code{Voice} (voix) et @code{Score} (partition) gèrent la
1071 notation de la mélodie, alors que @code{Lyrics} gère les paroles et
1072 @code{ChordNames} imprime le nom des accords.
1074 En termes de syntaxe, faire précéder une expression musicale de
1075 @code{\new} crée une plus grosse expression musicale. En reprenant la
1076 comparaison, cela ressemble au signe @qq{moins} en mathématiques. La
1077 formule @math{(4+5)} est une expression, donc @math{-(4+5)} est une plus
1080 Les chiffres de métrique indiqués sur une portée affectent toutes les
1081 autres portées@footnote{Ce comportement peut être modifié si nécessaire,
1082 voir @ref{Polymetric notation}.}. En revanche l'armure d'une portée
1083 n'affecte @emph{pas} les autres portées.
1085 @lilypond[quote,ragged-right,verbatim]
1088 \new Staff { \clef treble \time 3/4 c }
1089 \new Staff { \clef bass \key d \major c,, }
1098 @subsection Piano staves
1100 @cindex changement de portée manuel
1101 @cindex voix changeant manuellement de portée
1102 La musique pour piano s'écrit sur deux portées reliées par une accolade.
1103 Imprimer ce type de portée revient au même que dans l'exemple de musique
1104 polyphonique de @ref{Multiple staves}, mais maintenant cette expression
1105 entière doit être interprétée dans un contexte @code{PianoStaff} :
1114 Voici un bref exemple :
1116 @lilypond[quote,ragged-right,verbatim]
1119 \new Staff { \time 2/4 c4 e g g, }
1120 \new Staff { \clef bass c,, c' e c }
1127 Voir @ref{Piano music}.
1131 @node Combining notes into chords
1132 @subsection Combining notes into chords
1135 Des accords peuvent être produits en entourant les hauteurs de notes
1136 par des angles gauche et droit --- @samp{<} et @samp{>} ---
1138 @lilypond[quote,fragment,verbatim,relative=2,fragment]
1139 r4 <c e g>4 <c f a>2
1142 Vous pouvez combiner les indications comme les liaisons et les ligatures
1143 de croches avec les accords. Ils doivent cependant être placés en
1146 @lilypond[quote,fragment,verbatim,relative=2,fragment]
1147 r4 <c e g>8[ <c f a>]~ <c f a>2
1150 @lilypond[quote,fragment,verbatim,relative=2,fragment]
1151 r4 <c e g>8\>( <c e g> <c e g>4 <c f a>\!)
1155 @node Single staff polyphony
1156 @subsection Single staff polyphony
1159 @cindex voix multiples sur une portée
1160 Quand différentes lignes mélodiques sont combinées sur une seule et même
1161 portée, elles sont imprimées comme des voix polyphoniques ; chaque voix
1162 a ses propre hampes@footnote{familièrement appelées queues de note.},
1163 liaisons et ligatures, la voix supérieure ayant les hampes vers le haut,
1164 la voix inférieure vers le bas.
1166 Ce type de partition est réalisé en entrant chaque voix comme une
1167 séquence (avec @code{@{...@}}), en combinant simultanément les voix et
1168 en les séparant par @code{\\} :
1171 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
1178 Pour l'écriture de musique polyphonique, les silences invisibles
1179 s'avèrent bien pratiques : ce sont des silences qui ne s'impriment pas.
1180 Ils sont utiles pour remplir des voix qui, temporairement, ne jouent
1181 rien. On peut voir ici le même exemple avec un silence invisible
1182 (@code{s}) à la place d'un silence normal (@code{r}) :
1184 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
1192 Là encore, ces expressions peuvent s'imbriquer arbitrairement :
1194 @lilypond[quote,fragment,verbatim,relative=2,fragment]
1202 { <c g>1 ~ <c g>4 } \\
1210 Voir @ref{Basic polyphony}.
1217 Cette section présente l'écriture vocale et les partitions de variété.
1225 @node Printing lyrics
1226 @subsection Printing lyrics
1230 Prenons une mélodie toute simple :
1232 @lilypond[quote,ragged-right,verbatim]
1239 Des paroles peuvent être associées à ces notes, en les combinant avec la
1240 commande @code{\addlyrics}. Les paroles sont entrées en séparant chaque
1241 syllable par un espace :
1243 @lilypond[quote,ragged-right,verbatim]
1249 \addlyrics { One day this shall be free }
1254 @cindex ligne d'extension
1255 Cette mélodie se termine sur un @rglos{melisma}, c'est-à-dire qu'une
1256 seule syllable (@qq{free}) correspond à plus d'une note. Ceci est
1257 indiqué avec une @emph{ligne d'extension}. Elle est entrée avec deux
1258 caractères souligné (@code{_}), c'est-à-dire :
1260 @lilypond[quote,ragged-right,verbatim]
1266 \addlyrics { One day this shall be free __ }
1270 De la même manière, les séparations syllabiques d'un mot peuvent être
1271 entrées avec deux tirets (@code{-}), ce qui produit un tiret centré
1272 entre les deux syllabes :
1274 @c no ragged-right here because otherwise the hypens get lost.
1275 @lilypond[quote,verbatim]
1281 \addlyrics { A -- le -- gri -- a }
1287 Plus de possibilités, comme celle d'ajouter plusieurs lignes de paroles
1288 en dessous d'une même mélodie sont exposées dans @ref{Vocal music}.
1293 @subsection A lead sheet
1295 @cindex partition de chanson
1296 @cindex chanson, partition complète
1297 @cindex accords, noms
1298 @cindex noms d'accords
1300 En musique de variété, il est courant d'indiquer l'accompagnement par le
1301 nom des accords. De tels accords peuvent être entrés comme les notes :
1303 @lilypond[quote,ragged-right,verbatim]
1304 \chordmode { c2 f4. g8 }
1307 Maintenant, chaque hauteur est lue comme la base de l'accord à la place
1308 de la note. Ce mode est activé avec @code{\chordmode}. D'autres
1309 accords peuvent être créés en ajoutant des modificateurs après deux
1310 points. L'exemple suivant montre quelques modificateurs usuels :
1312 @lilypond[quote,verbatim,ragged-right]
1313 \chordmode { c2 f4:m g4:maj7 gis1:dim7 }
1316 Pour la musique improvisée, les accords ne sont pas imprimés sur des
1317 portées mais comme des lignes à part entière. Ceci s'obtient en
1318 utilisant @code{\chords} à la place de @code{\chordmode}. La même
1319 syntaxe sera utilisée que dans le cas de@code{\chordmode}, mais le rendu
1320 des notes interviendra dans un contexte @code{ChordNames}, avec le
1323 @lilypond[quote,verbatim,ragged-right]
1324 \chords { c2 f4.:m g4.:maj7 gis8:dim7 }
1327 @cindex partition de chanson
1328 @cindex chanson, partition complète
1329 Une fois assemblés, les accords, paroles et mélodie forment une
1330 partition de chanson :
1332 @lilypond[quote,verbatim,ragged-right]
1334 \chords { c2 g:sus4 f e }
1339 \addlyrics { One day this shall be free __ }
1346 Une liste complète de modificateurs et d'autres options de mise en forme
1347 se trouve à la section @ref{Chords}.
1352 @section Final touches
1354 L'ultime section de ce tutoriel montre comment ajouter une touche finale
1355 à des morceaux simples, et consititue une introduction au reste du
1361 * Absolute note names::
1362 * Organizing pieces with identifiers::
1363 * After the tutorial::
1364 * How to read the manual::
1368 @node Version number
1369 @subsection Version number
1372 La déclaration @code{\version} stipule le numéro de la version de
1373 LilyPond pour laquelle le fichier a été écrit,
1380 que l'on place par convention en début de fichier.
1382 Cette annotation permet de faciliter les prochaines mises à jour de
1383 LilyPond. Les changements dans la syntaxe sont gérés avec un programme
1384 spécial, @file{convert-ly} --- voir @rprogram{Updating files with convert-ly}
1385 --- et il utilise @code{\version} pour déterminer les règles de
1386 conversion à appliquer au fichier.
1390 @subsection Adding titles
1392 Les informations bibliographiques (nom du morceau, du compositeur, etc)
1393 sont entrées dans un bloc séparé, le bloc d'en-tête (@code{\header}),
1394 qui existe indépendamment des expressions musicales principales. Le
1395 bloc @code{\header} est habituellement placé en début de fichier.
1406 @dots{} music @dots{}
1409 Quand le fichier est traité, le titre et le compositeur sont imprimés en
1410 haut de la partition. Vous trouverez plus d'informations sur les titres
1411 à @ref{Creating titles}.
1413 @node Absolute note names
1414 @subsection Absolute note names
1416 Jusqu'ici nous n'avons utilisé que le mode @code{\relative} pour définir
1417 les hauteurs de notes. Si c'est effectivement le moyen le plus simple
1418 d'entrer la majeure partie de votre musique, il existe une autre façon
1419 de procéder : le mode des hauteurs absolues.
1421 Si vous omettez la commande @code{\relative}, LilyPond considérera
1422 toutes les hauteurs comme des hauteurs absolues. Un @code{c'} sera
1423 toujours un do du milieu, un @code{b} sera toujours une note au-dessous
1424 du précédent, et un @code{g,} sera toujours la note la plus grave dans
1425 la portée de clé de fa.
1427 @lilypond[quote,verbatim,ragged-right]
1435 Voici une gamme sur 4 octaves :
1437 @lilypond[quote,verbatim,ragged-right]
1452 Comme vous pouvez le voir, il faut beaucoup d'apostrophes pour écrire de
1453 la musique dans un registre aigu. Regardez cet extrait de Mozart :
1455 @lilypond[quote,verbatim,ragged-right]
1459 cis''8. d''16 cis''8 e''4 e''8
1460 b'8. cis''16 b'8 d''4 d''8
1464 Toutes ces apostrophes rendent le fichier moins lisible, et c'est donc
1465 une source d'erreurs. En mode @code{\relative}, le même exemple devient
1466 bien plus facile à lire :
1468 @lilypond[quote,verbatim,ragged-right]
1472 cis8. d16 cis8 e4 e8
1477 Si d'aventure vous faites une erreur d'octaviation, le mode
1478 @code{\relative} la rendra frappante --- toutes les notes suivantes
1479 seront placées à la mauvaise octave. En mode de hauteurs absolues, une
1480 erreur isolée ne serait pas auntant visible, et donc aussi facile à
1483 Cependant, le mode de hauteurs absolues reste utile pour les musiques où
1484 les intervalles sont étendus, surtout pour les fichiers LilyPond créés
1488 @node Organizing pieces with identifiers
1489 @subsection Organizing pieces with identifiers
1491 Lorsque l'on combine tous les éléments étudiés plus haut pour produire
1492 des fichiers plus volumineux, les blocs @code{\score} deviennent
1493 beaucoup plus gros parce que les expressions musicales sont plus longues
1494 et, dans le cas des pièces polyphoniques, profondément imbriquées. De
1495 telles expressions imposantes finissent par devenir peu maniables. Cet
1496 inconvénient peut être résolu par l'utilisation
1497 d'@emph{identificateurs}.
1499 En utilisant ces identificateurs, que l'on pourrait aussi appeler
1500 variables ou macros, il est possible de découper des expressions
1501 musicales complexes. Un identificateur se définit comme suit :
1504 MusiqueToto = @{ @dots{} @}
1507 Le contenu de l'expression musicale @code{MusiqueToto} pourra être
1508 utilisé plus loin en faisant précéder son nom d'un anti-slash,
1509 c'est-à-dire @code{\MusiqueToto}, juste comme n'importe quelle commande
1510 LilyPond. Tous les identificateurs doivent être définis @emph{avant}
1511 l'expression musicale principale.
1513 @lilypond[quote,verbatim,ragged-right]
1514 violin = \new Staff { \relative c'' {
1517 cello = \new Staff { \relative c {
1530 Le nom d'un identificateur ne doit comporter que des caractères
1531 alphabétiques non accentués, aucun nombre ni tiret.
1533 Il est possible d'utiliser des variables de types variés. Par exemple,
1538 aFivePaper = \paper @{ paperheight = 21.0 \cm @}
1541 En fonction de son contenu, un identificateur peut être utilisé à
1542 différents endroits. L'exemple suivant utilise la variable ci-dessus :
1553 @node After the tutorial
1554 @subsection After the tutorial
1556 Après avoir parcouru ce tutoriel, vous devriez vous essayer à écrire un
1557 morceau ou deux. Commencez par copier l'un des @ref{Templates} types et
1558 ajoutez-y des notes. Si vous voulez employer une notation que vous
1559 n'avez pas trouvé dans le tutoriel, consultez la référence de notation,
1560 en commençant par la @ref{Basic notation}. Si vous désirez écrire pour
1561 un ensemble instrumental non couvert par les @ref{Templates}, lisez la
1562 section @ref{Extending the templates}.
1564 Après avoir écrit quelques pièces courtes, lisez les chapitres 3 à 5 du
1565 manuel d'apprentissage. Rien ne s'oppose à ce que vous consultiez dès à
1566 présent les autres chapitres, bien sûr ! Néanmoins, le reste du manuel
1567 de l'utilisateur part du principe que vous avez déjà bien assimilé la
1568 syntaxe de LilyPond. Vous pouvez toujours survoler le reste du manuel,
1569 et y revenir plus tard après avoir acquis de l'expérience.
1571 @node How to read the manual
1572 @subsection How to read the manual
1574 Comme nous l'avons déjà vu dans @ref{How to read the tutorial}, de
1575 nombreux exemples du tutoriel n'ont pas fait apparaître
1576 @code{\relative c'' @{ ... @}} dans l'extrait de code affiché.
1578 Dans le reste du manuel, les exemples utilisés sont encore beaucoup plus
1579 souples : parfois il leur manque le @code{\relative c'' @{ ... @}},
1580 mais d'autres fois ils ont recours à une autre hauteur de référence,
1581 telle que @code{c'} ou @code{c,,}), et dans certains cas c'est même
1582 l'exemple entier qui est en mode de hauteurs absolues ! Cependant, de
1583 telles ambiguïtés ne se trouvent que dans des contextes où les hauteurs
1584 n'ont que peu d'importance. Dans tous les exemples où elles en ont, le
1585 mode @code{\relative} ou absolu @code{@{ @}} est explicitement spécifié.
1587 Si vous ne vous y retrouvez toujours pas pour savoir quel code LilyPond
1588 produit précisément tel ou tel exemple, consultez la version HTML de ce
1589 manuel si ce n'est pas déjà le cas, et cliquez sur l'image de la
1590 partition. La source exacte utilisée pour générer ce manuel s'affichera
1593 Pour en savoir plus sur l'organisation de la suite de ce manuel,
1594 reportez-vous à @ref{About this manual}.