1 @c -*- coding: utf-8; mode: texinfo; -*-
2 @c This file is part of lilypond.tely
4 Translation of GIT committish: a9d6b9a317e20cff479f9e0e54320dfae40bde31
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
148 lancer 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 dit "du milieu", entre la clé de Sol et
280 la clé de Fa, 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
284 @lilypond[quote,ragged-right,verbatim]
292 Comme vous l'aurez remarqué, cet exemple ne commence plus sur le do du
293 milieu. La première note -- le @samp{d} -- est le ré qui en est le
296 Pour ajouter des intervalles supérieurs à une quarte, il suffit
297 d'indiquer si la note est à l'octave supérieure ou inférieure, en
298 ajoutant respectivement une apostrophe @code{'} ou une virgule
299 @code{,} au nom de la note.
301 @lilypond[quote,ragged-right,verbatim]
309 Pour envoyer une note deux octaves (ou davantage !) plus haut ou plus
310 bas, il suffit de mettre plusieurs @code{''} ou plusieurs @code{,,} --
311 attention cependant à bien mettre deux apostrophes @code{''}, et non
312 deux guillemets @code{"}@tie{}! C'est de cette même manière que l'on
313 peut modifier la valeur de départ de @code{\relative c'}.
316 @subheading Durations (rhythms)
318 La @rglos{duration} d'une note est indiquée par un nombre
319 qui suit son nom : @samp{1} pour une @rglos{whole
320 note}, @samp{2} pour une @rglos{half note}, @samp{4} pour
321 une @rglos{quarter note} et ainsi de suite. Les hampes sont
322 ajoutées automatiquement.
324 @lilypond[quote,ragged-right,verbatim]
328 a16 a a a a32 a a a a64 a a a a a a a a2
333 Si aucune durée n'est indiquée, la dernière durée entrée sera utilisée
334 pour les notes suivantes. En l'absence d'indication, la première note
337 Les @rglos{dotted notes} s'obtiennent en ajoutant un point @samp{.} à
340 @lilypond[quote,ragged-right,verbatim]
350 On saisit un (@rglos{rest}) tout comme une note, mais avec le
353 @lilypond[quote,ragged-right,verbatim]
361 @subheading Time signature
363 Le @rglos{time signature}) peut être défini à l'aide de la commande
366 @lilypond[quote,ragged-right,verbatim]
380 La @rglos{clef} peut être définie à l'aide de la commande @code{\clef} :
382 @lilypond[quote,ragged-right,verbatim]
396 @subheading All together
398 Voici un bref exemple qui montre tous ces éléments ensemble :
400 @lilypond[quote,ragged-right,verbatim]
412 @item Entrer des hauteurs et des durées
413 voir @ref{Pitches} and @ref{Durations}.
416 @item Les chiffres de mesure et autres commandes de métrique
417 voir @ref{Time signature}.
424 @node Working on text files
425 @subsection Working on text files
427 Les fichiers d'entrée de LilyPond sont traités comme la plupart des
428 langages de programmation : la casse est prise en compte mais pas les
429 espaces vides, les expressions musicales sont délimitées par des
430 accolades @{ @}, et les commentaires par des @code{%} ou @code{%@{ ..
433 Si cette phrase vous paraît incompréhensible, ne vous en faites pas !
434 Tous ces termes vont être expliqués :
438 @cindex Case sensitive
439 @item @strong{La casse} :
440 LilyPond est sensible à la casse, c'est à dire qu'une lettre en
441 capitales n'a pas la même valeur qu'une lettre en minuscules. Les
442 notes, par exemple, doivent être entrées en minuscules : @code{ @{ c
444 un code valide, alors que @code{ @{ C D E @} } produira un message d'erreur.
446 @item @strong{Les espaces multiples} :
447 LilyPond ne tient pas compte du nombre d'espaces, ou de retours à la
448 ligne. @code{ @{ c d e @}} a le même sens que @code{ @{ c @ @ @ @ @
457 Bien sûr, ce dernier exemple est difficile à lire. Une bonne habitude
458 à prendre est d'indenter les blocs de code avec soit des tabulations
459 soit des doubles espaces :
466 @item @strong{Expressions musicales :}
467 Tout morceau saisi dans LilyPond doit être placé entre @strong{@{
468 accolades @}}. Ces caractères indiquent à LilyPond que ce bloc de
469 texte est une et une seule expression musicale, tout comme les
470 parenthèses @samp{()} en mathématiques. Il est préférable, pour
471 éviter toute ambiguïté, d'entourer tous ces crochets d'espaces, à
472 moins qu'ils se trouvent au début ou à la fin d'une ligne.
474 Une fonction telle que @code{\relative @{ @}} ) compte également comme
475 une seule expression musicale.
479 @cindex block comment
480 @item @strong{Les commentaires} :
481 Un commentaire est une indication pour tout lecteur humain d'un
482 fichier de musique ; il est ignoré par l'ordinateur, et n'a donc aucun
483 effet sur la partition imprimée. On distingue deux types de
486 @item la ligne de commentaire, introduite par le symbole @samp{%} :
487 tout ce qui suit ce symbole sur cette ligne sera ignoré.
488 @item le bloc de commentaire, qui peut être de plusieurs lignes voire
489 de toute une section : tout ce qui se trouve entre @code{%@{} et
490 @code{%@}} est ignoré.
492 Le fragment suivant met en évidence quelques usages possibles des commentaires :
495 % voici les notes de "ah vous dirai-je maman"
499 Ces lignes et les notes qui suivent
500 seront ignorées, car elles se trouvent
501 dans un bloc de commentaire.
509 Vous trouverez plus d'astuces pour organiser vos fichiers LilyPond dans
510 @ref{Suggestions for writing LilyPond files}.
513 @node How to read the tutorial
514 @subsection How to read the tutorial
516 Comme nous l'avons vu dans @ref{Working on text files}, un code
517 LilyPond doit être encadré par des @{ @} ou bien par @code{\relative
518 c'' @{ ... @}} afin d'être compris. Cependant, dans la suite de ce
519 manuel, la plupart des exemples ne feront pas apparaître ces signes.
521 Si vous consultez la documentation au format HTML, et que vous
522 souhaitez voir la source exacte d'un exemple, il vous suffit de
523 cliquer sur l'image. Si vous ne disposez pas de la version HTML, il
524 vous est possible de simplement copier et coller le code affiché, mais
525 @strong{à condition} d'ajouter @code{\relative c'' @{ @}} de la façon
530 ... collez ici votre exemple...
534 Pourquoi avoir omis les accolades ? La plupart des exemples de ce
535 manuel peuvent être insérés au milieu d'un morceau de musique plus
536 long. Il n'y a donc aucune raison d'ajouter @code{\relative c'' @{
537 @}} à ces exemples --- en effet, il n'est pas possible d'insérer un
538 @code{\relative} à l'intérieur d'un autre @code{\relative}. Il vous
539 serait donc devenu impossible de copier un bref exemple de la
540 documentation et de le coller dans une pièce de votre cru.
542 @node Single staff notation
543 @section Single staff notation
545 Cette section présente la notation courante dont on a besoin pour
546 écrire une seule voix sur une seule portée.
549 * Relative note names::
550 * Accidentals and key signatures::
552 * Articulation and dynamics::
553 * Automatic and manual beams::
554 * Advanced rhythmic commands::
558 @node Relative note names
559 @subsection Relative note names
561 Comme nous l'avons vu dans @ref{Simple notation}, LilyPond calcule la
562 hauteur de chaque note en fonction de la précédente@footnote{Il existe
563 un autre mode de saisie des hauteurs, le mode @ref{Absolute note
564 names}, mais en pratique il est bien plus aisé et sûr d'avoir recours
565 au mode de hauteurs relatives.}. Si aucune indication supplémentaire
566 d'octaviation n'est ajoutée, il en conlcuera que chaque hauteur est
567 située à une quarte au plus de la note précédente.
569 Lilypond tient compte des intervalles induits par les noms des notes
570 -- en d'autres termes,une quarte augmentée n'est @emph{pas}
571 équivalente à une quinte diminuée. Ainsi, si l'on part d'un Do, un Fa
572 dièse sera placé au-dessus, tandis qu'un Sol bémol sera placé
575 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
583 @item Les Octaves Relatives
584 voir @ref{Relative octaves}.
585 @item Les vérifications d'octaves
586 voir @ref{Octave check}.
592 @node Accidentals and key signatures
593 @subsection Accidentals and key signatures
595 @subheading Accidentals
597 Dans la notation par défaut,un dièse (@rglos{sharp}) s'obtient en
598 ajoutant @samp{is} au nom de la
599 note, et un bémol (@rglos{flat}) en ajoutant @samp{es}. Comme vous pouvez
600 vous y attendre, un double dièse ou double bémol est alors obtenu en
601 ajoutant @samp{isis} ou @samp{eses}@footnote{Cette syntaxe est dérivée
602 de la convention de dénomination des notes dans les langues nordiques
603 et germaniques, comme l'allemand ou le hollandais.}.
606 Cependant, si vous utilisez la commande @samp{\include "italiano.ly"}
608 les noms de notes français au lieu des noms hollandais, il faudra
609 ajouter un @samp{d} pour un dièse, et un @samp{b} pour un bémol. Le
610 double dièse et le double bémol s'obtiennent en ajoutant
611 respectivement @samp{dd} et @samp{bb}
614 Pour en savoir plus sur les autres langues disponibles, voir @ref{Note
615 names in other languages}.}
617 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
618 cis1 ees fisis, aeses
621 @cindex key signature, setting
622 @subheading Key signatures
624 L'armure est déterminée par la commande @code{\key}, suivie d'une
625 hauteur puis de @code{\major} (majeur) ou @code{\minor} (mineur) :
627 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
636 @subheading Warning: key signatures and pitches
638 La combinaison de l'armure et des hauteurs de note --- y compris les
639 altérations --- permet à LilyPond de déterminer dans quel cas afficher les
640 altérations accidentelles. L'armure n'affecte que les altérations
641 @emph{imprimées}, et non les hauteurs réelles ! Cette fonctionnalité
642 est souvent source de
643 confusion pour les nouveaux utilisateurs, aussi expliquons-la en
646 LilyPond fait une nette distinction entre le contenu musical et la
647 mise en forme. L'altération d'une note -- bémol, bécarre ou dièse --
648 fait partie de sa hauteur, et relève donc du contenu musical. La
650 d'une altération accidentelle -- un @emph{signe} bémol, bécarre ou
651 dièse -- devant la note correspondante est une question qui relève de la mise en
652 page. Mettre en page une partition se fait selon des règles ; les
653 altérations accidentelles seront donc automatiquement imprimées suivant
654 ces règles. Les hauteurs de note, en revanche, relèvent de ce que
655 vous voulez entendre ; et, dans la mesure où la musique que vous
656 entrez est censée être celle que vous voulez entendre, LilyPond (qui
657 n'est chargé que de la gravure) ne les choisira pas à votre place.
661 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
667 Aucune note n'a ici d'altération accidentelle, et pourtant vous devrez
668 entrer le @samp{is} pour les notes @code{cis} et @code{fis}.
670 Le code @samp{d} ne veut pas dire @qq{Imprimez-moi un point noir juste
671 en-dessous de la portée.} Cela signifie plutôt : @qq{Ici se trouve
673 hauteur est un ré naturel.} Avec l'armure de la bémol majeur, ce ré
675 d'un bécarre accidentel :
677 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
682 Ajouter explicitement toutes les altérations requiert un peu plus
683 d'effort dans la phase de saisie, mais la transposition en sera
684 grandement facilitée.
685 De plus les altérations accidentelles
686 peuvent être imprimées suivant plusieurs conventions. Regardez
687 @ref{Automatic accidentals} pour connaître les différentes manières dont les
688 altérations accidentelles peuvent être imprimées, suivant les règles
694 @item Les altérations
695 voir @ref{Accidentals} and @ref{Automatic accidentals}.
697 voir @ref{Key signature}.
703 @subsection Ties and slurs
707 Une @rglos{tie}@footnote{parfois aussi appelée liaison de
708 tenue} se crée en ajoutant un tilde @samp{~} à la première note liée.
710 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
718 @c Le terme de "slur" a deux sens en français : articulation et phrasé.
719 @c Je garde ici le terme "legato", tel qu'il apparaît dans le texte original,
720 @c car c'est celui qui me semble le plus couramment employé.
722 Une @rglos{slur} d'articulation (ou @qq{legato}) peut englober
723 plusieurs notes. La note de départ et d'arrivée reçoivent
724 respectivement un signe @samp{(} et @samp{)}.
726 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
727 d4( c16) cis( d e c cis d) e( d4)
730 @cindex slurs, phrasing
731 @cindex phrasing slurs
732 @subheading Phrasing slurs
734 @cindex phrasing slurs
735 De plus longues liaisons, dites de phrasé, sont délimitées par @code{\(} et
736 @code{\)}. Il est possible d'avoir en même temps des legatos et des
737 phrasés, mais pas plusieurs liaisons de phrasé ou de legato à la fois.
739 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
740 a8(\( ais b c) cis2 b'2 a4 cis,\)
745 @cindex slurs versus ties
746 @subheading Warnings: slurs vs. ties
748 Une liaison d'articulation ou de phrasé ressemble à une liaison de
749 tenue, mais n'a pas la même signification. Alors qu'une liaison de
750 tenue ne peut relier que deux notes de même hauteur, le legato indique
751 une articulation de plusieurs notes, éventuellement nombreuses. Les
752 liaisons de tenue peuvent être enchâssées dans un legato ou un phrasé.
754 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
755 c2~( c8 fis fis4 ~ fis2 g2)
761 @item Liaisons de prolongation
765 @item Liaisons de phrasé
766 voir @ref{Phrasing slurs}.
771 @node Articulation and dynamics
772 @subsection Articulation and dynamics
777 @subheading Articulations
779 Des @rglos{articulations} peuvent être ajoutées à une note, au moyen
780 d'un tiret @samp{-} suivi d'un caractère :
782 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
783 c-. c-- c-> c-^ c-+ c-_
787 @subheading Fingerings
788 De même, des indications de doigté peuvent être ajoutées à une note en
789 utilisant un tiret (@samp{-}) et le chiffre à écrire :
791 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
795 Articulations et doigtés sont habituellement placés automatiquement,
796 mais vous pouvez spécifier une direction en utilisant @samp{^} (en haut)
797 ou @samp{_} (en bas). Vous pouvez aussi utiliser plusieurs articulations
798 sur la même note. Dans la plupart des cas, cependant, il est mieux de
799 laisser LilyPond déterminer l'emplacement de l'articulation.
801 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
802 c_-^1 d^. f^4_2-> e^-_+
806 Les signes de nuances sont obtenus en ajoutant à la note les noms des nuances,
807 précédées d'un anti-slash @samp{\} :
809 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
817 @c Pluriel des termes musicaux italiens :
818 @c selon Littré, plutôt à la française (en "-os" qu'en "-i")
820 Crescendos et decrescendos débutent avec les commandes @code{\<} et
821 @code{\>}. Ils se terminent soit par une nuance d'arrivée, par
823 soit par la commande @code{\!} :
825 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
833 voir @ref{Articulations}.
835 voir @ref{Fingering instructions}.
842 @node Automatic and manual beams
843 @subsection Automatic and manual beams
845 @cindex beams, by hand
846 Toutes les @rglos{beam}s sont dessinées automatiquement :
848 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
849 a8 ais d ees r d c16 b a8
853 Lorsqu'on n'aime pas la manière dont les notes sont automatiquement
854 groupées, il est possible de les entrer à la main, en marquant la
855 première note à attacher d'un @samp{[} et la dernière d'un @samp{]}.
857 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
858 a8[ ais] d[ ees r d] a b
864 @item Groupements de notes et ligatures automatiques
865 voir @ref{Automatic beams}.
866 @item Groupements et ligatures manuels
867 voir @ref{Manual beams}.
872 @node Advanced rhythmic commands
873 @subsection Advanced rhythmic commands
877 @cindex partial measure
878 @subheading Partial measure
880 Une levée (ou @rglos{anacrusis}) est entrée avec la commande
881 @code{\partial}, suivie d'une durée : @code{\partial 4} est une levée
883 @code{\partial 8} d'une croche.
885 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
893 Les nolets sont créés avec la commande @code{\times}, qui prend
894 deux arguments : une fraction et une expression musicale. La durée des
895 notes de l'expression musicale est multipliée par la fraction. Par exemple les
896 notes d'un triolet durent les deux tiers du temps de leur notation
897 réelle, cette fraction est donc de 2/3 pour les triolets :
899 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
900 \times 2/3 { f8 g a }
902 \times 2/3 { f,8 g16[ a g a] }
909 @subheading Grace notes
911 Des notes d'ornement sont produites par la commande @code{\grace},
912 mais aussi en préfixant une expression musicale avec le mot-clé
913 @code{\appoggiatura} ou @code{\acciaccatura} :
915 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
916 c2 \grace { a32[ b] } c2
917 c2 \appoggiatura b16 c2
918 c2 \acciaccatura b16 c2
924 @item Notes d'ornement
925 voir @ref{Grace notes},
929 voir @ref{Partial measures}.
934 @node Multiple notes at once
935 @section Multiple notes at once
937 Cette section traite des situations où l'on a plus d'une note à la
938 fois : plusieurs instruments, plusieurs portées pour un même
939 instrument (le piano, par exemple), et les accords.
941 La polyphonie, en théorie musicale, est la notion d'une musique
942 constituée de plusieurs voix ; dans lilypond, ce terme désigne les
943 situations où il y a plus d'une voix sur une même portée.
946 * Music expressions explained::
949 * Single staff polyphony::
950 * Combining notes into chords::
954 @node Music expressions explained
955 @subsection Music expressions explained
957 Dans les fichiers source LilyPond, la musique est représentée par ce qu'on
958 appelle des @emph{expressions musicales}. En soi, une seule note peut
960 expression musicale, si tant est qu'elle soit correctement encadrée :
962 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
966 Mettre un groupe de notes entre accolades crée une nouvelle expression
969 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
973 Placer une séquence d'expressions musicales -- des notes par exemple
974 -- entre accolades signifie qu'elles doivent être jouées
975 successivement, les unes après les autres. Le résultat est une
976 expression, qui peut elle-même être regroupée séquentiellement avec
977 d'autres expressions. Ici, l'expression de l'exemple précédent est
978 combinée à deux notes :
980 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
984 @subheading Simultaneous music expressions: multiple staves
986 Cette technique est utile pour de la musique polyphonique. Pour
987 entrer une musique avec plusieurs voix ou plusieurs portées, nous
988 pouvons aussi combiner en parallèle les expressions. Deux voix qui doivent être
989 jouées en même temps, sont entrées comme une combinaison simultanée de
990 deux expressions. Une expression musicale @q{simultanée} est formée en
991 entourant les expressions entre @code{<<} et @code{>>}. Dans l'exemple
992 suivant, trois expressions (contenant chacune deux notes distinctes) sont
993 combinées simultanément.
995 @lilypond[quote,ragged-right,verbatim]
1005 Notez que nous avons ici indenté chaque niveau du fichier d'entrée
1006 avec un nombre d'espaces différent. LilyPond se moque de l'espace
1007 qu'il peut y avoir (ou pas) au début d'une ligne, mais en indentant
1008 votre code vous le rendrez bien plus facile à lire pour les humains.
1010 @strong{Attention} : chaque note saisie est relative à la précédente,
1011 mais pas au @code{c''} de la commande @code{\relative} de départ.
1014 @subheading Simultaneous music expressions: single staff
1016 Pour déterminer le nombre de portées, LilyPond regarde le premier
1017 élément autre qu'une accolade. Si c'est une seule note, il y a une
1018 portée ; si c'est une expression simultanée, il y aura plus d'une
1021 @lilypond[quote,ragged-right,verbatim]
1024 << { e f } { c <<b d>> } >>
1029 @cindex music expression
1030 @subheading Analogy: mathematical expressions
1032 Ce mécanisme est similaire au formules mathématiques : une grosse
1033 formule est créée en assemblant plusieurs petites formules. Ces types
1034 de formules, appelées expressions, ont une définition récursive, de
1035 telle sorte que vous pouvez fabriquer des expressions arbitrairement
1036 longues et complexes. Par exemple,
1045 ((1 + 2) * 3) / (4 * 5)
1048 Ceci est une suite d'expressions, où chacune est contenue dans la
1049 suivante. Les expressions les plus simples sont les nombres, et de
1050 plus grandes expressions sont produites en combinant des expressions
1051 avec des opérateurs -- comme @samp{+}, @samp{*} et @samp{/} -- et des
1052 parenthèses. Tout comme les expressions mathématiques, les expressions
1053 musicales peuvent être imbriquées avec une profondeur arbitraire, ce
1054 qui est nécessaire pour de la musique complexe comme des partitions
1058 @node Multiple staves
1059 @subsection Multiple staves
1061 Comme nous l'avons vu dans @ref{Music expressions explained}, un
1062 fichier d'entrée LilyPond est fait d'expressions musicales. Si la
1063 partition commence par plusieurs expressions simultanées, LilyPond
1064 créera plusieurs portées. Cependant, il est plus facile de voir ce
1065 qu'il advient si l'on crée explicitement chacune des portées.
1067 Pour créer plus d'une portée, chaque partie de la musique constituant
1068 une portée est entrée en la faisant précéder de @code{\new Staff}.
1069 Ces éléments @code{Staff} sont ensuite combinés en parallèle avec
1070 @code{<<} et @code{>>}, comme ceci :
1072 @lilypond[quote,ragged-right,verbatim]
1075 \new Staff { \clef treble c }
1076 \new Staff { \clef bass c,, }
1082 La commande @code{\new} introduit un « contexte de notation ». Un
1083 contexte de notation est un environnement dans lequel les événements
1084 musicaux -- comme les notes ou les commandes @code{\clef} -- sont
1085 interprétés. Pour des pièces simples, ces contextes sont créés
1086 automatiquement. Pour des pièces plus complexes, il est préférable de
1087 spécifier explicitement les contextes. Cela assure que chaque
1088 fragment aura sa propre portée.
1090 Il existe différents types de contextes. Les contextes @code{Staff}
1091 (portée), @code{Voice} (voix) et @code{Score} (partition) gèrent la
1092 notation de la mélodie, alors que @code{Lyrics} gère les paroles et
1093 @code{ChordNames} imprime le nom des accords.
1095 En termes de syntaxe, faire précéder une expression musicale de
1096 @code{\new} crée une plus grosse expression musicale. En reprenant la
1097 comparaison, cela ressemble au signe « moins » en mathématiques. La
1098 formule @math{(4+5)} est une expression, donc @math{-(4+5)} est une
1099 plus grosse expression.
1101 Les chiffres de mesure figurant sur une portée affectent toutes les
1102 autres portées ; en revanche l'armure d'une portée n'affectera
1103 @emph{pas} les autres portées.@footnote{Ce comportement peut être
1104 modifié si nécessaire : voir pour cela @ref{Changing defaults}.}.
1106 @lilypond[quote,ragged-right,verbatim]
1109 \new Staff { \clef treble \time 3/4 c }
1110 \new Staff { \clef bass \key d \major c,, }
1119 @subsection Piano staves
1121 @cindex staff switch, manual
1122 @cindex cross staff voice, manual
1123 La musique pour piano s'écrit sur deux portées reliées par une
1124 accolade. Imprimer ce type de portée revient au même que dans
1125 l'exemple de musique polyphonique de (@ref{Multiple staves}), mais
1126 maintenant cette expression entière doit être interprétée dans un
1127 contexte @code{PianoStaff} :
1136 Voici un bref exemple :
1138 @lilypond[quote,ragged-right,verbatim]
1141 \new Staff { \time 2/4 c4 e g g, }
1142 \new Staff { \clef bass c,, c' e c }
1149 Voir @ref{Piano music}.
1153 @node Single staff polyphony
1154 @subsection Single staff polyphony
1157 @cindex multiple voices
1158 @cindex voices, more -- on a staff
1159 Quand différentes lignes mélodiques sont combinées sur une seule et
1160 même portée, elles sont imprimées comme des voix polyphoniques ;
1161 chaque voix a ses propre hampes@footnote{familièrement appelées queues
1162 de note.}, liaisons et ligatures, la voix supérieure ayant les hampes
1163 vers le haut, la voix inférieure vers le bas.
1165 Ce type de partition est réalisé en entrant chaque voix comme une
1166 séquence (avec @code{@{...@}}), en combinant simultanément les voix et
1167 en les séparant par @code{\\} :
1170 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
1177 Pour l'écriture de musique polyphonique, les silences invisibles
1178 s'avèrent bien pratiques : ce sont des silences qui ne s'impriment
1179 pas. Ils sont utiles pour remplir des voix qui, temporairement, ne
1180 jouent rien. On peut voir ici le même exemple avec un silence
1181 invisible (@code{s}) à la place d'un silence normal (@code{r}) :
1183 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
1191 Là encore, ces expressions peuvent s'imbriquer arbitrairement :
1193 @lilypond[quote,fragment,verbatim,relative=2,fragment]
1201 { <c g>1 ~ <c g>4 } \\
1209 Voir @ref{Basic polyphony}.
1213 @node Combining notes into chords
1214 @subsection Combining notes into chords
1217 Des accords peuvent être produits en entourant les hauteurs de notes
1218 par des angles gauche et droit -- @samp{<} et @samp{>} --
1220 @lilypond[quote,fragment,verbatim,relative=2,fragment]
1221 r4 <c e g>4 <c f a>2
1224 Vous pouvez combiner les indications comme les liaisons et les
1225 ligatures de croches avec les accords. Ils doivent cependant être
1226 placés en dehors des angles :
1229 @lilypond[quote,fragment,verbatim,relative=2,fragment]
1230 r4 <c e g>8[ <c f a>]~ <c f a>2
1233 @lilypond[quote,fragment,verbatim,relative=2,fragment]
1234 r4 <c e g>8\>( <c e g> <c e g>4 <c f a>\!)
1241 Cette section présente l'écriture vocale, et les partitions de variété.
1249 @node Printing lyrics
1250 @subsection Printing lyrics
1254 Prenons une mélodie toute simple :
1256 @lilypond[quote,ragged-right,verbatim]
1263 Des paroles peuvent être associées à ces notes, en les combinant avec
1264 la commande @code{\addlyrics}. Les paroles sont entrées en séparant
1265 chaque syllable par un espace :
1267 @lilypond[quote,ragged-right,verbatim]
1273 \addlyrics { One day this shall be free }
1278 @cindex extender line
1279 Cette mélodie se termine sur un @rglos{melisma}, c'est-à-dire qu'une
1280 seule syllable (« free ») correspond à plus d'une note. Ceci est
1281 indiqué avec une @emph{ligne d'extension}. Elle est entrée avec deux
1282 caractères souligné (@code{_}), c'est-à-dire :
1284 @lilypond[quote,ragged-right,verbatim]
1290 \addlyrics { One day this shall be free __ }
1294 De la même manière, les séparations syllabiques d'un mot peuvent être
1295 entrées avec deux tirets (@code{-}), ce qui produit un tiret centré
1296 entre les deux syllabes :
1298 @c no ragged-right here because otherwise the hypens get lost.
1299 @lilypond[quote,verbatim]
1305 \addlyrics { A -- le -- gri -- a }
1311 Plus de possibilités, comme celle d'ajouter plusieurs lignes de
1312 paroles en dessous d'une même mélodie sont exposées dans @ref{Vocal
1318 @subsection A lead sheet
1324 En musique de variété, il est courant d'indiquer l'accompagnement par
1325 le nom des accords. De tels accords peuvent être entrés comme les
1328 @lilypond[quote,ragged-right,verbatim]
1329 \chordmode { c2 f4. g8 }
1332 Maintenant, chaque hauteur est lue comme la base de l'accord à la
1333 place de la note. Ce mode est activé avec @code{\chordmode}.
1334 D'autres accords peuvent être créés en ajoutant des modifiacteurs
1335 après deux points. L'exemple suivant montre quelques modificateurs
1338 @lilypond[quote,verbatim,ragged-right]
1339 \chordmode { c2 f4:m g4:maj7 gis1:dim7 }
1342 Pour la musique improvisée, les accords ne sont pas imprimés sur des
1343 portées mais comme des lignes à part entière. Ceci s'obtient en
1344 utilisant @code{\chords} à la place de @code{\chordmode}. La même
1345 syntaxe sera utilisée que dans le cas de@code{\chordmode}, mais le
1346 rendu des notes interviendra dans un contexte de @code{ChordNames},
1347 avec le résultat suivant :
1349 @lilypond[quote,verbatim,ragged-right]
1350 \chords { c2 f4.:m g4.:maj7 gis8:dim7 }
1354 Une fois assemblés, les accords, paroles et mélodie forment une
1355 partition de chanson :
1357 @lilypond[quote,verbatim,ragged-right]
1359 \chords { c2 g:sus4 f e }
1364 \addlyrics { One day this shall be free __ }
1371 Une liste complète de modificateurs et d'autres options de mise en
1372 forme se trouve à la section @ref{Chords}.
1377 @section Final touches
1379 Voici l'ultime section de ce tutoriel, qui montre comment ajouter la
1380 touche finale à des morceaux simples, et sert d'introduction pour le
1386 * Absolute note names::
1387 * Organizing pieces with identifiers::
1388 * After the tutorial::
1389 * How to read the manual::
1393 @node Version number
1394 @subsection Version number
1397 La déclaration @code{\version} stipule le numéro de la version de
1398 LilyPond pour laquelle le fichier a été écrit. Pour donner à un
1399 fichier la version 2.10.0, ajoutez
1406 tout en haut de votre fichier LilyPond.
1408 Cette annotation permet de faciliter les prochaines mises à jour de
1409 LilyPond. Les changements dans la syntaxe sont gérés avec un
1410 programme spécial, @file{convert-ly} -- voir @ref{Updating files with
1411 convert-ly} -- et il utilise @code{\version} pour déterminer les
1412 règles de conversion à appliquer au fichier.
1416 @subsection Adding titles
1418 Les informations bibliographiques (nom du morceau, du compositeur,
1419 etc) sont entrées dans un bloc séparé, le bloc d'en-tête
1420 (@code{\header}), qui existe indépendamment des expressions musicales
1421 principales. Le bloc @code{\header} est habituellement placé en début
1433 @dots{} music @dots{}
1436 Quand le fichier est traité, le titre et le compositeur sont imprimés
1437 en haut de la partition. Vous trouverez plus d'informations sur les
1438 titres à @ref{Creating titles}.
1440 @node Absolute note names
1441 @subsection Absolute note names
1443 Jusqu'ici nous n'avons utilisé que le mode @code{\relative} pour
1444 définir les hauteurs de notes. Si c'est effectivement le moyen le
1445 plus simple d'entrer la majeure partie de votre musique, il existe une
1446 autre façon de procéder : le mode de hauteurs absolues.
1448 Si vous omettez la commande @code{\relative}, LilyPond considérera
1449 toutes les hauteurs comme des hauteurs absolues. Un @code{c'} sera
1450 toujours un do du milieu, un @code{b} sera toujours une note
1451 au-dessous du précédent, et un @code{g,} sera toujours la note la plus
1452 grave dans la portée de clé de Fa.
1454 @lilypond[quote,verbatim,ragged-right]
1462 Voici une gamme sur 4 octaves :
1464 @lilypond[quote,verbatim,ragged-right]
1479 Comme vous pouvez le voir, il faut beaucoup d'apostrophes pour écrire
1480 de la musique dans un registre aigu. Regardez cet extrait de Mozart :
1482 @lilypond[quote,verbatim,ragged-right]
1486 cis''8. d''16 cis''8 e''4 e''8
1487 b'8. cis''16 b'8 d''4 d''8
1491 Toutes ces apostrophes rendent le fichier moins lisible, et c'est donc
1492 une source d'erreurs. En mode @code{\relative}, le même exemple
1493 devient bien plus facile à lire :
1495 @lilypond[quote,verbatim,ragged-right]
1499 cis8. d16 cis8 e4 e8
1504 Si d'aventure vous faites une erreur d'octaviation, le mode
1505 @code{\relative} la rendra frappante -- toutes les notes suivantes
1506 seront placées à la mauvaise octave. En mode de hauteurs absolues,
1507 une erreur isolée ne serait pas aussi visible, et donc aussi facile à
1510 Cependant, le mode de hauteurs absolues reste utile pour les musiques
1511 où les intervalles sont étendus, surtout pour les fichiers LilyPond
1512 créés par ordinateur.
1515 @node Organizing pieces with identifiers
1516 @subsection Organizing pieces with identifiers
1518 Lorsque l'on combine tous les éléments étudiés plus haut pour produire
1519 des fichiers plus volumineux, les blocs @code{\score} deviennent
1520 beaucoup plus gros parce que les expressions musicales sont plus
1521 longues et, dans le cas des pièces polyphoniques, profondément
1522 imbriquées. De telles expressions imposantes finissent par devenir
1523 peu maniables. Cet inconvénient peut être résolu par l'utilisation
1524 d'@emph{identificateurs}.
1526 En utilisant ces identificateurs, que l'on pourrait aussi appeler
1527 variables ou macros, il est possible de découper des expressions
1528 musicales complexes. Un identificateur se définit comme suit :
1531 MusiqueToto = @{ @dots{} @}
1534 Le contenu de l'expression musicale @code{MusiqueToto} pourra être
1535 utilisé plus loin en faisant précéder son nom d'un anti-slash,
1536 c'est-à-dire @code{\MusiqueToto}, juste comme n'importe quelle
1537 commande LilyPond. Tous les identificateurs doivent être définis
1538 @emph{avant} l'expression musicale principale.
1540 @lilypond[quote,verbatim,ragged-right]
1541 violin = \new Staff { \relative c'' {
1544 cello = \new Staff { \relative c {
1557 Le nom d'un identificateur ne doit comporter que des caractères
1558 alphabétiques non accentués, aucun nombre ni tiret.
1560 Il est possible d'utiliser des variables de types variés. Par exemple,
1565 aFivePaper = \paper @{ paperheight = 21.0 \cm @}
1568 En fonction de son contenu, un identificateur peut être utilisé à
1569 différents endroits. L'exemple suivant utilise la variable ci-dessus
1581 @node After the tutorial
1582 @subsection After the tutorial
1584 Après avoir parcouru ce tutoriel, vous devriez vous essayer à écrire
1585 un morceau ou deux. Commencez par copier l'un des modèles types
1586 (@ref{Templates}) et ajoutez-y des notes. Si vous voulez employer une
1587 notation que vous n'avez pas trouvé dans le tutoriel, consultez la
1588 référence de notation, en commençant par la @ref{Basic notation}. Si
1589 vous désirez écrire pour un ensemble instrumental non couvert par les
1590 @ref{Example templates}, lisez la section @ref{Extending the
1593 Après avoir écrit quelques pièces courtes, lisez les chapitres 3 à 5
1594 du manuel d'apprentissage. Rien ne s'oppose à ce que vous consultiez
1595 dès à présent les autres chapitres, bien sûr ! Néanmoins, le reste du
1596 manuel de l'utilisateur part du principe que vous avez déjà bien
1597 assimilé la syntaxe de LilyPond. Vous pouvez toujours survoler le
1598 reste du manuel, et y revenir plus tard après avoir acquis de
1601 @node How to read the manual
1602 @subsection How to read the manual
1604 Comme nous l'avons déjà vu dans @ref{How to read the tutorial}, de
1605 nombreux exemples du tutoriel n'ont pas fait apparaître le
1606 @code{\relative c'' @{ ... @}} dans l'extrait de code affiché.
1608 Dans le reste du manuel, les exemples utilisés sont encore beaucoup
1609 plus souples : parfois il leur manque le @code{\relative c'' @{ ...
1610 @}}, mais d'autres fois ils ont recours à une autre hauteur de
1611 référence, telle que @code{c'} ou @code{c,,}), et dans certains cas
1612 c'est même l'exemple entier qui est en mode de hauteurs absolues !
1613 Cependant, de telles ambiguïtés ne se trouvent que dans des contextes
1614 où les hauteurs n'ont que peu d'importance. Dans tous les exemples où
1615 elles en ont, le mode @code{\relative} ou absolu @code{@{ @}} est
1616 explicitement spécifié.
1618 Si vous ne vous y retrouvez toujours pas pour savoir quel code
1619 LilyPond produit précisément tel ou tel exemple, consultez la version
1620 HTML de ce manuel (si ce n'est pas déjà le cas), et cliquez sur
1621 l'image de la partition. La source exacte utilisée pour générer ce
1622 manuel s'affichera alors.