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 de la même veine que les
418 sources dans la plupart des autres langages de programmation : la
419 casse est prise en compte mais pas les
420 espaces vides ; les expressions sont délimitées par des
421 accolades @{ @}, 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 Case sensitive
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.
469 @cindex block comment
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 conlcuera 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 key signature, setting
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 ici 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
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]
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. La note 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 slurs, phrasing
719 @cindex phrasing slurs
720 @subheading Phrasing slurs
722 @cindex phrasing slurs
723 De plus longues liaisons, dites de phrasé, sont délimitées par @code{\(} et
724 @code{\)}. Il est possible d'avoir en même temps des legatos et des
725 phrasés, mais pas plusieurs liaisons de phrasé ou de legato à la fois.
727 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
728 a8(\( ais b c) cis2 b'2 a4 cis,\)
733 @cindex slurs versus ties
734 @subheading Warnings: slurs vs. ties
736 Une liaison d'articulation ou de phrasé ressemble à une liaison de
737 tenue, mais n'a pas la même signification. Alors qu'une liaison de
738 tenue ne peut relier que deux notes de même hauteur, le legato indique
739 une articulation de plusieurs notes, éventuellement nombreuses. Les
740 liaisons de tenue peuvent être enchâssées dans un legato ou un phrasé.
742 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
743 c2~( c8 fis fis4 ~ fis2 g2)
749 @item Liaisons de prolongation
753 @item Liaisons de phrasé
754 voir @ref{Phrasing slurs}.
759 @node Articulation and dynamics
760 @subsection Articulation and dynamics
765 @subheading Articulations
767 Des @rglos{articulations} peuvent être ajoutées à une note, au moyen
768 d'un tiret @samp{-} suivi d'un caractère :
770 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
771 c-. c-- c-> c-^ c-+ c-_
775 @subheading Fingerings
776 De même, des indications de doigté peuvent être ajoutées à une note en
777 utilisant un tiret (@samp{-}) et le chiffre à écrire :
779 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
783 Articulations et doigtés sont habituellement placés automatiquement,
784 mais vous pouvez spécifier une direction en utilisant @samp{^} (en haut)
785 ou @samp{_} (en bas). Vous pouvez aussi utiliser plusieurs articulations
786 sur la même note. Dans la plupart des cas, cependant, il est mieux de
787 laisser LilyPond déterminer l'emplacement de l'articulation.
789 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
790 c_-^1 d^. f^4_2-> e^-_+
794 Les signes de nuances sont obtenus en ajoutant à la note les noms des nuances,
795 précédées d'un anti-slash @samp{\} :
797 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
805 @c Pluriel des termes musicaux italiens :
806 @c selon Littré, plutôt à la française (en "-os" qu'en "-i")
808 Crescendos et decrescendos débutent avec les commandes @code{\<} et
809 @code{\>}. Ils se terminent soit par une nuance d'arrivée, par
811 soit par la commande @code{\!} :
813 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
821 voir @ref{Articulations}.
823 voir @ref{Fingering instructions}.
830 @node Automatic and manual beams
831 @subsection Automatic and manual beams
833 @cindex beams, by hand
834 Toutes les @rglos{beam}s sont dessinées automatiquement :
836 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
837 a8 ais d ees r d c16 b a8
841 Lorsqu'on n'aime pas la manière dont les notes sont automatiquement
842 groupées, il est possible de les entrer à la main, en marquant la
843 première note à attacher d'un @samp{[} et la dernière d'un @samp{]}.
845 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
846 a8[ ais] d[ ees r d] a b
852 @item Groupements de notes et ligatures automatiques
853 voir @ref{Automatic beams}.
854 @item Groupements et ligatures manuels
855 voir @ref{Manual beams}.
860 @node Advanced rhythmic commands
861 @subsection Advanced rhythmic commands
865 @cindex partial measure
866 @subheading Partial measure
868 Une levée (ou @rglos{anacrusis}) est entrée avec la commande
869 @code{\partial}, suivie d'une durée : @code{\partial 4} est une levée
871 @code{\partial 8} d'une croche.
873 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
881 Les nolets sont créés avec la commande @code{\times}, qui prend
882 deux arguments : une fraction et une expression musicale. La durée des
883 notes de l'expression musicale est multipliée par la fraction. Par exemple les
884 notes d'un triolet durent les deux tiers du temps de leur notation
885 réelle, cette fraction est donc de 2/3 pour les triolets :
887 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
888 \times 2/3 { f8 g a }
890 \times 2/3 { f,8 g16[ a g a] }
897 @subheading Grace notes
899 Des notes d'ornement sont produites par la commande @code{\grace},
900 mais aussi en préfixant une expression musicale avec le mot-clé
901 @code{\appoggiatura} ou @code{\acciaccatura} :
903 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
904 c2 \grace { a32[ b] } c2
905 c2 \appoggiatura b16 c2
906 c2 \acciaccatura b16 c2
912 @item Notes d'ornement
913 voir @ref{Grace notes},
917 voir @ref{Partial measures}.
922 @node Multiple notes at once
923 @section Multiple notes at once
925 Cette section traite des situations où l'on a plus d'une note à la
926 fois : plusieurs instruments, plusieurs portées pour un même
927 instrument (le piano, par exemple), et les accords.
929 La polyphonie, en théorie musicale, est la notion d'une musique
930 constituée de plusieurs voix ; dans lilypond, ce terme désigne les
931 situations où il y a plus d'une voix sur une même portée.
934 * Music expressions explained::
937 * Single staff polyphony::
938 * Combining notes into chords::
942 @node Music expressions explained
943 @subsection Music expressions explained
945 Dans les fichiers source LilyPond, la musique est représentée par ce qu'on
946 appelle des @emph{expressions musicales}. En soi, une seule note peut
948 expression musicale, si tant est qu'elle soit correctement encadrée :
950 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
954 Mettre un groupe de notes entre accolades crée une nouvelle expression
957 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
961 Placer une séquence d'expressions musicales --- des notes par exemple
962 --- entre accolades signifie qu'elles doivent être jouées
963 successivement, les unes après les autres. Le résultat est une
964 expression, qui peut elle-même être regroupée séquentiellement avec
965 d'autres expressions. Ici, l'expression de l'exemple précédent est
966 combinée à deux notes :
968 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
972 @subheading Simultaneous music expressions: multiple staves
974 Cette technique est utile pour de la musique polyphonique. Pour
975 entrer une musique avec plusieurs voix ou plusieurs portées, nous
976 pouvons aussi combiner en parallèle les expressions. Deux voix qui doivent être
977 jouées en même temps, sont entrées comme une combinaison simultanée de
978 deux expressions. Une expression musicale @q{simultanée} est formée en
979 entourant les expressions entre @code{<<} et @code{>>}. Dans l'exemple
980 suivant, trois expressions (contenant chacune deux notes distinctes) sont
981 combinées simultanément.
983 @lilypond[quote,ragged-right,verbatim]
993 Notez que nous avons ici indenté chaque niveau du fichier d'entrée
994 avec un nombre d'espaces différent. LilyPond se moque de l'espace
995 qu'il peut y avoir (ou pas) au début d'une ligne, mais en indentant
996 votre code vous le rendrez bien plus facile à lire pour les humains.
998 @strong{Attention} : chaque note saisie est relative à la précédente,
999 mais pas au @code{c''} de la commande @code{\relative} de départ.
1002 @subheading Simultaneous music expressions: single staff
1004 Pour déterminer le nombre de portées, LilyPond regarde le premier
1005 élément autre qu'une accolade. Si c'est une seule note, il y a une
1006 portée ; si c'est une expression simultanée, il y aura plus d'une
1009 @lilypond[quote,ragged-right,verbatim]
1012 << { e f } { c <<b d>> } >>
1017 @cindex music expression
1018 @subheading Analogy: mathematical expressions
1020 Ce mécanisme est similaire au formules mathématiques : une grosse
1021 formule est créée en assemblant plusieurs petites formules. Ces types
1022 de formules, appelées expressions, ont une définition récursive, de
1023 telle sorte que vous pouvez fabriquer des expressions arbitrairement
1024 longues et complexes. Par exemple,
1033 ((1 + 2) * 3) / (4 * 5)
1036 Ceci est une suite d'expressions, où chacune est contenue dans la
1037 suivante. Les expressions les plus simples sont les nombres, et de
1038 plus grandes expressions sont produites en combinant des expressions
1039 avec des opérateurs --- comme @samp{+}, @samp{*} et @samp{/} --- et des
1040 parenthèses. Tout comme les expressions mathématiques, les expressions
1041 musicales peuvent être imbriquées avec une profondeur arbitraire, ce
1042 qui est nécessaire pour de la musique complexe comme des partitions
1046 @node Multiple staves
1047 @subsection Multiple staves
1049 Comme nous l'avons vu dans @ref{Music expressions explained}, un
1050 fichier d'entrée LilyPond est fait d'expressions musicales. Si la
1051 partition commence par plusieurs expressions simultanées, LilyPond
1052 créera plusieurs portées. Cependant, il est plus facile de voir ce
1053 qu'il advient si l'on crée explicitement chacune des portées.
1055 Pour créer plus d'une portée, chaque partie de la musique constituant
1056 une portée est entrée en la faisant précéder de @code{\new Staff}.
1057 Ces éléments @code{Staff} sont ensuite combinés en parallèle avec
1058 @code{<<} et @code{>>}, comme ceci :
1060 @lilypond[quote,ragged-right,verbatim]
1063 \new Staff { \clef treble c }
1064 \new Staff { \clef bass c,, }
1070 La commande @code{\new} introduit un @qq{contexte de notation}. Un
1071 contexte de notation est un environnement dans lequel les événements
1072 musicaux --- comme les notes ou les commandes @code{\clef} --- sont
1073 interprétés. Pour des pièces simples, ces contextes sont créés
1074 automatiquement. Pour des pièces plus complexes, il est préférable de
1075 spécifier explicitement les contextes. Cela assure que chaque
1076 fragment aura sa propre portée.
1078 Il existe différents types de contextes. Les contextes @code{Staff}
1079 (portée), @code{Voice} (voix) et @code{Score} (partition) gèrent la
1080 notation de la mélodie, alors que @code{Lyrics} gère les paroles et
1081 @code{ChordNames} imprime le nom des accords.
1083 En termes de syntaxe, faire précéder une expression musicale de
1084 @code{\new} crée une plus grosse expression musicale. En reprenant la
1085 comparaison, cela ressemble au signe @qq{moins} en mathématiques. La
1086 formule @math{(4+5)} est une expression, donc @math{-(4+5)} est une
1087 plus grosse expression.
1089 Les chiffres de mesure figurant sur une portée affectent toutes les
1090 autres portées ; en revanche l'armure d'une portée n'affectera
1091 @emph{pas} les autres portées.@footnote{Ce comportement peut être
1092 modifié si nécessaire : voir pour cela @ref{Changing defaults}.}.
1094 @lilypond[quote,ragged-right,verbatim]
1097 \new Staff { \clef treble \time 3/4 c }
1098 \new Staff { \clef bass \key d \major c,, }
1107 @subsection Piano staves
1109 @cindex staff switch, manual
1110 @cindex cross staff voice, manual
1111 La musique pour piano s'écrit sur deux portées reliées par une
1112 accolade. Imprimer ce type de portée revient au même que dans
1113 l'exemple de musique polyphonique de @ref{Multiple staves}, mais
1114 maintenant cette expression entière doit être interprétée dans un
1115 contexte @code{PianoStaff} :
1124 Voici un bref exemple :
1126 @lilypond[quote,ragged-right,verbatim]
1129 \new Staff { \time 2/4 c4 e g g, }
1130 \new Staff { \clef bass c,, c' e c }
1137 Voir @ref{Piano music}.
1141 @node Single staff polyphony
1142 @subsection Single staff polyphony
1145 @cindex multiple voices
1146 @cindex voices, more -- on a staff
1147 Quand différentes lignes mélodiques sont combinées sur une seule et
1148 même portée, elles sont imprimées comme des voix polyphoniques ;
1149 chaque voix a ses propre hampes@footnote{familièrement appelées queues
1150 de note.}, liaisons et ligatures, la voix supérieure ayant les hampes
1151 vers le haut, la voix inférieure vers le bas.
1153 Ce type de partition est réalisé en entrant chaque voix comme une
1154 séquence (avec @code{@{...@}}), en combinant simultanément les voix et
1155 en les séparant par @code{\\} :
1158 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
1165 Pour l'écriture de musique polyphonique, les silences invisibles
1166 s'avèrent bien pratiques : ce sont des silences qui ne s'impriment
1167 pas. Ils sont utiles pour remplir des voix qui, temporairement, ne
1168 jouent rien. On peut voir ici le même exemple avec un silence
1169 invisible (@code{s}) à la place d'un silence normal (@code{r}) :
1171 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
1179 Là encore, ces expressions peuvent s'imbriquer arbitrairement :
1181 @lilypond[quote,fragment,verbatim,relative=2,fragment]
1189 { <c g>1 ~ <c g>4 } \\
1197 Voir @ref{Basic polyphony}.
1201 @node Combining notes into chords
1202 @subsection Combining notes into chords
1205 Des accords peuvent être produits en entourant les hauteurs de notes
1206 par des angles gauche et droit --- @samp{<} et @samp{>} ---
1208 @lilypond[quote,fragment,verbatim,relative=2,fragment]
1209 r4 <c e g>4 <c f a>2
1212 Vous pouvez combiner les indications comme les liaisons et les
1213 ligatures de croches avec les accords. Ils doivent cependant être
1214 placés en dehors des angles :
1217 @lilypond[quote,fragment,verbatim,relative=2,fragment]
1218 r4 <c e g>8[ <c f a>]~ <c f a>2
1221 @lilypond[quote,fragment,verbatim,relative=2,fragment]
1222 r4 <c e g>8\>( <c e g> <c e g>4 <c f a>\!)
1229 Cette section présente l'écriture vocale et les partitions de variété.
1237 @node Printing lyrics
1238 @subsection Printing lyrics
1242 Prenons une mélodie toute simple :
1244 @lilypond[quote,ragged-right,verbatim]
1251 Des paroles peuvent être associées à ces notes, en les combinant avec
1252 la commande @code{\addlyrics}. Les paroles sont entrées en séparant
1253 chaque syllable par un espace :
1255 @lilypond[quote,ragged-right,verbatim]
1261 \addlyrics { One day this shall be free }
1266 @cindex extender line
1267 Cette mélodie se termine sur un @rglos{melisma}, c'est-à-dire qu'une
1268 seule syllable (@qq{free}) correspond à plus d'une note. Ceci est
1269 indiqué avec une @emph{ligne d'extension}. Elle est entrée avec deux
1270 caractères souligné (@code{_}), c'est-à-dire :
1272 @lilypond[quote,ragged-right,verbatim]
1278 \addlyrics { One day this shall be free __ }
1282 De la même manière, les séparations syllabiques d'un mot peuvent être
1283 entrées avec deux tirets (@code{-}), ce qui produit un tiret centré
1284 entre les deux syllabes :
1286 @c no ragged-right here because otherwise the hypens get lost.
1287 @lilypond[quote,verbatim]
1293 \addlyrics { A -- le -- gri -- a }
1299 Plus de possibilités, comme celle d'ajouter plusieurs lignes de
1300 paroles en dessous d'une même mélodie sont exposées dans @ref{Vocal
1306 @subsection A lead sheet
1312 En musique de variété, il est courant d'indiquer l'accompagnement par
1313 le nom des accords. De tels accords peuvent être entrés comme les
1316 @lilypond[quote,ragged-right,verbatim]
1317 \chordmode { c2 f4. g8 }
1320 Maintenant, chaque hauteur est lue comme la base de l'accord à la
1321 place de la note. Ce mode est activé avec @code{\chordmode}.
1322 D'autres accords peuvent être créés en ajoutant des modifiacteurs
1323 après deux points. L'exemple suivant montre quelques modificateurs
1326 @lilypond[quote,verbatim,ragged-right]
1327 \chordmode { c2 f4:m g4:maj7 gis1:dim7 }
1330 Pour la musique improvisée, les accords ne sont pas imprimés sur des
1331 portées mais comme des lignes à part entière. Ceci s'obtient en
1332 utilisant @code{\chords} à la place de @code{\chordmode}. La même
1333 syntaxe sera utilisée que dans le cas de@code{\chordmode}, mais le
1334 rendu des notes interviendra dans un contexte de @code{ChordNames},
1335 avec le résultat suivant :
1337 @lilypond[quote,verbatim,ragged-right]
1338 \chords { c2 f4.:m g4.:maj7 gis8:dim7 }
1342 Une fois assemblés, les accords, paroles et mélodie forment une
1343 partition de chanson :
1345 @lilypond[quote,verbatim,ragged-right]
1347 \chords { c2 g:sus4 f e }
1352 \addlyrics { One day this shall be free __ }
1359 Une liste complète de modificateurs et d'autres options de mise en
1360 forme se trouve à la section @ref{Chords}.
1365 @section Final touches
1367 L'ultime section de ce tutoriel montre comment ajouter la touche
1368 finale à des morceaux simples, et consititue une introduction au reste
1374 * Absolute note names::
1375 * Organizing pieces with identifiers::
1376 * After the tutorial::
1377 * How to read the manual::
1381 @node Version number
1382 @subsection Version number
1385 La déclaration @code{\version} stipule le numéro de la version de
1386 LilyPond pour laquelle le fichier a été écrit. Pour donner à un
1387 fichier la version 2.11.20, ajoutez
1394 tout en haut de votre fichier LilyPond.
1396 Cette annotation permet de faciliter les prochaines mises à jour de
1397 LilyPond. Les changements dans la syntaxe sont gérés avec un
1398 programme spécial, @file{convert-ly} --- voir @ref{Updating files with
1399 convert-ly} --- et il utilise @code{\version} pour déterminer les
1400 règles de conversion à appliquer au fichier.
1404 @subsection Adding titles
1406 Les informations bibliographiques (nom du morceau, du compositeur,
1407 etc) sont entrées dans un bloc séparé, le bloc d'en-tête
1408 (@code{\header}), qui existe indépendamment des expressions musicales
1409 principales. Le bloc @code{\header} est habituellement placé en début
1421 @dots{} music @dots{}
1424 Quand le fichier est traité, le titre et le compositeur sont imprimés
1425 en haut de la partition. Vous trouverez plus d'informations sur les
1426 titres à @ref{Creating titles}.
1428 @node Absolute note names
1429 @subsection Absolute note names
1431 Jusqu'ici nous n'avons utilisé que le mode @code{\relative} pour
1432 définir les hauteurs de notes. Si c'est effectivement le moyen le
1433 plus simple d'entrer la majeure partie de votre musique, il existe une
1434 autre façon de procéder : le mode de hauteurs absolues.
1436 Si vous omettez la commande @code{\relative}, LilyPond considérera
1437 toutes les hauteurs comme des hauteurs absolues. Un @code{c'} sera
1438 toujours un do du milieu, un @code{b} sera toujours une note
1439 au-dessous du précédent, et un @code{g,} sera toujours la note la plus
1440 grave dans la portée de clé de Fa.
1442 @lilypond[quote,verbatim,ragged-right]
1450 Voici une gamme sur 4 octaves :
1452 @lilypond[quote,verbatim,ragged-right]
1467 Comme vous pouvez le voir, il faut beaucoup d'apostrophes pour écrire
1468 de la musique dans un registre aigu. Regardez cet extrait de Mozart :
1470 @lilypond[quote,verbatim,ragged-right]
1474 cis''8. d''16 cis''8 e''4 e''8
1475 b'8. cis''16 b'8 d''4 d''8
1479 Toutes ces apostrophes rendent le fichier moins lisible, et c'est donc
1480 une source d'erreurs. En mode @code{\relative}, le même exemple
1481 devient bien plus facile à lire :
1483 @lilypond[quote,verbatim,ragged-right]
1487 cis8. d16 cis8 e4 e8
1492 Si d'aventure vous faites une erreur d'octaviation, le mode
1493 @code{\relative} la rendra frappante --- toutes les notes suivantes
1494 seront placées à la mauvaise octave. En mode de hauteurs absolues,
1495 une erreur isolée ne serait pas aussi visible, et donc aussi facile à
1498 Cependant, le mode de hauteurs absolues reste utile pour les musiques
1499 où les intervalles sont étendus, surtout pour les fichiers LilyPond
1500 créés par ordinateur.
1503 @node Organizing pieces with identifiers
1504 @subsection Organizing pieces with identifiers
1506 Lorsque l'on combine tous les éléments étudiés plus haut pour produire
1507 des fichiers plus volumineux, les blocs @code{\score} deviennent
1508 beaucoup plus gros parce que les expressions musicales sont plus
1509 longues et, dans le cas des pièces polyphoniques, profondément
1510 imbriquées. De telles expressions imposantes finissent par devenir
1511 peu maniables. Cet inconvénient peut être résolu par l'utilisation
1512 d'@emph{identificateurs}.
1514 En utilisant ces identificateurs, que l'on pourrait aussi appeler
1515 variables ou macros, il est possible de découper des expressions
1516 musicales complexes. Un identificateur se définit comme suit :
1519 MusiqueToto = @{ @dots{} @}
1522 Le contenu de l'expression musicale @code{MusiqueToto} pourra être
1523 utilisé plus loin en faisant précéder son nom d'un anti-slash,
1524 c'est-à-dire @code{\MusiqueToto}, juste comme n'importe quelle
1525 commande LilyPond. Tous les identificateurs doivent être définis
1526 @emph{avant} l'expression musicale principale.
1528 @lilypond[quote,verbatim,ragged-right]
1529 violin = \new Staff { \relative c'' {
1532 cello = \new Staff { \relative c {
1545 Le nom d'un identificateur ne doit comporter que des caractères
1546 alphabétiques non accentués, aucun nombre ni tiret.
1548 Il est possible d'utiliser des variables de types variés. Par exemple,
1553 aFivePaper = \paper @{ paperheight = 21.0 \cm @}
1556 En fonction de son contenu, un identificateur peut être utilisé à
1557 différents endroits. L'exemple suivant utilise la variable ci-dessus
1569 @node After the tutorial
1570 @subsection After the tutorial
1572 Après avoir parcouru ce tutoriel, vous devriez vous essayer à écrire
1573 un morceau ou deux. Commencez par copier l'un des @ref{Templates}
1574 types et ajoutez-y des notes. Si vous voulez employer une notation
1575 que vous n'avez pas trouvé dans le tutoriel, consultez la référence de
1576 notation, en commençant par la @ref{Basic notation}. Si vous désirez
1577 écrire pour un ensemble instrumental non couvert par les
1578 @ref{Templates}, lisez la section @ref{Extending the templates}.
1580 Après avoir écrit quelques pièces courtes, lisez les chapitres 3 à 5
1581 du manuel d'apprentissage. Rien ne s'oppose à ce que vous consultiez
1582 dès à présent les autres chapitres, bien sûr ! Néanmoins, le reste du
1583 manuel de l'utilisateur part du principe que vous avez déjà bien
1584 assimilé la syntaxe de LilyPond. Vous pouvez toujours survoler le
1585 reste du manuel, et y revenir plus tard après avoir acquis de
1588 @node How to read the manual
1589 @subsection How to read the manual
1591 Comme nous l'avons déjà vu dans @ref{How to read the tutorial}, de
1592 nombreux exemples du tutoriel n'ont pas fait apparaître le
1593 @code{\relative c'' @{ ... @}} dans l'extrait de code affiché.
1595 Dans le reste du manuel, les exemples utilisés sont encore beaucoup
1596 plus souples : parfois il leur manque le @code{\relative c'' @{ ...
1597 @}}, mais d'autres fois ils ont recours à une autre hauteur de
1598 référence, telle que @code{c'} ou @code{c,,}), et dans certains cas
1599 c'est même l'exemple entier qui est en mode de hauteurs absolues !
1600 Cependant, de telles ambiguïtés ne se trouvent que dans des contextes
1601 où les hauteurs n'ont que peu d'importance. Dans tous les exemples où
1602 elles en ont, le mode @code{\relative} ou absolu @code{@{ @}} est
1603 explicitement spécifié.
1605 Si vous ne vous y retrouvez toujours pas pour savoir quel code
1606 LilyPond produit précisément tel ou tel exemple, consultez la version
1607 HTML de ce manuel si ce n'est pas déjà le cas, et cliquez sur l'image
1608 de la partition. La source exacte utilisée pour générer ce manuel