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. } }
58 En copiant et en collant tout le code @qq{ly snippet} dans un fichier test,
59 vous aurez un modèle de base pour faire vos expériences. Si vous
60 apprenez de cette façon, vous aurez probablement envie d'imprimer ou
61 de garder un lien vers la
62 @ref{Cheat sheet}, tableau qui répertorie les commandes usuelles
63 pour une consultation rapide.
68 * Single staff notation::
69 * Multiple notes at once::
78 Cette section présente sommairement la façon de travailler avec LilyPond.
83 * Working on text files::
84 * How to read the tutorial::
88 @node Compiling a file
89 @subsection Compiling a file
91 Le premier exemple montre comment débuter avec LilyPond. Pour créer
92 une partition, on écrit un fichier de texte qui décrit la notation
93 musicale. Par exemple, si l'on écrit
102 le résultat ressemblera à
104 @c in this case we don't want verbatim
105 @lilypond[quote,ragged-right]
112 Il est aussi possible d'utiliser les noms de notes français @samp{do
113 re mi fa sol la si}, en insérant au début du fichier la ligne
114 @samp{\include "italiano.ly"}
117 @emph{Attention :} tout extrait de code LilyPond doit être entouré
118 d'une @{paire d'accolades@}. De plus, pour éviter toute ambiguïté, il
119 est préférable d'entourer les accolades par des espaces ou retours à
120 la ligne. Bien que certains exemples de ce manuel ne comportent pas
121 d'accolades, ne les oubliez pas dans vos partitions !
123 @cindex Case sensitive
124 De plus, LilyPond est sensible à la casse. @code{ @{ c d e @} } est
125 un code valide ; @code{ @{ C D E @} } produira un message d'erreur.
129 @subheading Entering music and viewing output
131 Dans cette section nous expliquerons quelles commandes exécuter et
132 comment voir ou imprimer le résultat de LilyPond.
134 @subsubheading MacOS X
136 Si vous double-cliquez sur LilyPond.app, un fichier d'exemple
137 s'ouvrira. Sauvegardez-le, par exemple, sous @file{test.ly} sur votre
138 bureau, et traitez-le ensuite avec la commande du menu @samp{Compile >
139 Typeset File}. Le fichier PDF résultant sera alors affiché sur votre
142 Notez que le premier démarrage peut prendre une minute ou deux, car
143 toutes les polices système doivent être d'abord analysées.
145 À l'avenir, vous aurez certainement recours aux commandes @qq{ Nouveau
146 } ou @qq{ Ouvrir }. Vous devez enregistrer votre fichier avant de
147 lancer la création de la partition. Si une erreur advient pendant le
148 traitement, vous la trouverez dans la fenêtre @qq{ log }.
150 @subsubheading Windows
152 Sous Windows, démarrez un éditeur de texte @footnote{N'importe quel
153 éditeur simple ou orienté programmation, qui prend en charge le codage
154 de caractères UTF-8, fera l'affaire, par exemple le Bloc-notes. N'utilisez
155 pas de traitement de texte car ceux-ci insèrent des codes de formatage
156 qui posent problème à LilyPond.} et saisissez
164 Enregistrez-le sur le bureau sous @file{test.ly} et vérifiez bien
165 qu'il ne s'appelle pas @file{test.ly.TXT}. Double-cliquez sur le
166 fichier @file{test.ly} pour le traiter et afficher le fichier
167 PDF résultant. Pour modifier un fichier @file{.ly} existant, faites
168 un clic droit dessus et sélectionnez @qq{Éditer la source}.
170 Si vous double-cliquez sur l'icône LilyPond sur le Bureau, un fichier
171 d'exemple s'ouvrira dans un simple éditeur de texte. Enregistrez-le,
172 par exemple en tant que @file{test.ly} sur votre Bureau, puis
173 double-cliquez dessus pour le traiter. Après quelques secondes, vous
174 obtiendrez un fichier @file{test.pdf} sur votre Bureau, fichier que
175 vous pourrez ouvrir pour voir la partition imprimée. Une autre
176 méthode pour lancer le traitement du fichier @file{test.ly} est de le
177 glisser avec votre souris sur l'icône de LilyPond.
179 En double-cliquant sur le fichier, vous obtiendrez, en plus du fichier
180 PDF, un fichier @file{.log} qui récapitule les opérations que LilyPond
181 a effectuées sur votre fichier. Si une erreur advient, c'est ce
182 fichier qu'il vous faudra étudier.
187 Commencez par ouvrir une fenêtre de terminal et un éditeur de
188 texte. Par exemple, vous pouvez ouvrir un xterm et exécuter
189 @code{joe}. @footnote{Il existe des fichiers de macros pour les fans
191 @code{LilyPond-mode} pour les fans d'Emacs. S'ils ne sont pas
192 encore installés, consultez le fichier @file{INSTALL.txt}. L'outil
193 d'édition le plus facile d'utilisation est de loin
194 @file{LilyPondTool}. Vous trouverez plus d'informations dans
195 @ref{Editor support}.} Dans votre
196 éditeur, entrez le texte suivant et sauvegardez le fichier sous
206 Pour traiter @file{test.ly}, procédez comme ceci :
213 Vous verrez quelque chose ressemblant à :
220 Interpreting music... [1]
221 Preprocessing graphical objects...
222 Calculating line breaks... [2]
223 Layout output to `test.ps'...
224 Converting to `test.pdf'...
228 Suivant votre installation, ces messages peuvent être traduits.
232 @cindex Viewing music
235 De tout cela résulte un fichier @file{test.pdf}, que vous pouvez imprimer
236 ou visualiser avec les outils standards de votre système
237 d'exploitation. @footnote{Si votre système ne dispose pas des outils
238 nécessaires, vous pouvez essayer
239 @uref{http://@/www@/.cs@/.wisc@/.edu/@/~ghost/,Ghostscript}, un
240 programme pour afficher et imprimer librement les fichiers PDF et PostScript.}
243 @node Simple notation
244 @subsection Simple notation
246 Il y a certains éléments graphiques que LilyPond ajoute
247 automatiquement. Dans l'exemple suivant, nous n'avons fourni que
248 quatre hauteurs, mais LilyPond a ajouté une clé, un chiffre de mesure
251 @lilypond[quote,ragged-right,verbatim]
258 Ce comportement peut être modifié, mais dans bien des cas ces
259 attributions automatiques s'avèrent utiles.
263 Le moyen le plus simple d'entrer des notes est d'utiliser le mode
264 @code{\relative}. Avec ce mode, l'@rglos{interval} entre la note et
265 celle qui la précède est supposé inférieur ou égal à une
266 @rglos{fourth}. Commençons par entrer la partition la plus
267 élémentaire qui soit, une (@rglos{scale}).
269 @lilypond[quote,ragged-right,verbatim]
276 La note de départ est @rglos{middle C}. Chacune des notes qui suivent
277 est à moins d'une quarte de la note précédente -- en d'autres termes,
278 le premier @samp{c} est le Do dit "du milieu", entre la clé de Sol et
279 la clé de Fa, puis est suivi par le ré le plus proche, et ainsi de
280 suite. On peut bien sûr créer des mélodies d'intervalles plus étendus
283 @lilypond[quote,ragged-right,verbatim]
291 Comme vous l'aurez remarqué, cet exemple ne commence plus sur le do du
292 milieu. La première note --le @samp{d} -- est le Ré qui en est le
295 Pour ajouter des intervalles supérieurs à une quarte, il suffit
296 d'indiquer si la note est à l'octave supérieure ou inférieure, en
297 ajoutant respectivement une apostrophe @code{'} ou une virgule
298 @code{,} au nom de la note.
300 @lilypond[quote,ragged-right,verbatim]
308 Pour envoyer une note deux octaves (ou davantage !) plus haut ou plus
309 bas, il suffit de mettre plusieurs @code{''} ou plusieurs @code{,,} --
310 attention cependant à bien mettre deux apostrophes @code{''}, et non
311 deux guillemets @code{"}@tie{} ! C'est de cette même manière que l'on
312 peut modifier la valeur de départ de @code{\relative c'}.
315 @subheading Durations (rhythms)
317 La @rglos{duration} d'une note est indiquée par un nombre
318 qui suit son nom : @samp{1} pour une (@rglos{whole
319 note}), @samp{2} pour une (@rglos{half note}), @samp{4} pour
320 une (@rglos{quarter note}) et ainsi de suite. Les hampes sont
321 ajoutées automatiquement.
323 @lilypond[quote,ragged-right,verbatim]
327 a16 a a a a32 a a a a64 a a a a a a a a2
332 Si aucune durée n'est indiquée, la dernière durée entrée sera utilisée
333 pour les notes suivantes. En l'absence d'indication, la première note
336 Les @rglos{dotted notes} s'obtiennent en ajoutant un point @samp{.} à
339 @lilypond[quote,ragged-right,verbatim]
349 On saisit un (@rglos{rest}) tout comme une note, mais avec le
352 @lilypond[quote,ragged-right,verbatim]
360 @subheading Time signature
362 Le @rglos{time signature}) peut être défini à l'aide de la commande
365 @lilypond[quote,ragged-right,verbatim]
379 La @rglos{clef} peut être définie à l'aide de la commande @code{\clef} :
381 @lilypond[quote,ragged-right,verbatim]
395 @subheading All together
397 Voici un bref exemple qui montre tous ces éléments ensemble :
399 @lilypond[quote,ragged-right,verbatim]
411 @item Entrer des hauteurs et des durées
412 see @ref{Pitches} and @ref{Durations}.
415 @item Les chiffres de mesure et autres commandes de métrique
416 see @ref{Time signature}.
423 @node Working on text files
424 @subsection Working on text files
426 Les fichiers d'entrée de LilyPond sont traités comme la plupart des
427 langages de programmation : la casse est prise en compte mais pas les
428 espaces vides, les expressions musicales sont délimitées par des
429 accolades @{ @}, et les commentaires par des @code{%} ou @code{%@{ ..
432 Si cette phrase vous paraît incompréhensible, ne vous en faites pas !
433 Tous ces termes vont être expliqués :
437 @cindex Case sensitive
438 @item @strong{La casse} :
439 LilyPond est sensible à la casse, c'est à dire qu'une lettre en
440 capitales n'a pas la même valeur qu'une lettre en minuscules. Les
441 notes, par exemple, doivent être entrées en minuscules : @code{ @{ c
443 un code valide, alors que @code{ @{ C D E @} } produira un message d'erreur.
445 @item @strong{Les espaces multiples} :
446 LilyPond ne tient pas compte du nombre d'espaces, ou de retours à la
447 ligne. @code{ @{ c d e @}} a le même sens que @code{ @{ c @ @ @ @ @
456 Bien sûr, ce dernier exemple est difficile à lire. Une bonne habitude
457 à prendre est d'indenter les blocs de code avec soit des tabulations
458 soit des doubles espaces :
465 @item @strong{Expressions musicales :}
466 Tout morceau saisi dans LilyPond nécessite d'être placé entre
467 @strong{@{ accolades @}}. Ces caractères indiquent à LilyPond que ce
468 bloc de texte est une et une seule expression musicale, tout comme les
469 parenthèses @samp{()} en mathématiques. Il est préférable, pour
470 éviter toute ambiguïté, d'entourer tous ces crochets d'espaces, à
471 moins qu'ils se trouvent au début ou à la fin d'une ligne.
473 Une fonction telle que @code{\relative @{ @}} ) compte également comme
474 une seule expression musicale.
478 @cindex block comment
479 @item @strong{Les commentaires} :
480 Un commentaire est une indication pour tout lecteur humain d'un
481 fichier de musique ; il est ignoré par l'ordinateur, et n'a donc aucun
482 effet sur la partition imprimée. On distingue deux types de
485 @item la ligne de commentaire, introduite par le symbole @samp{%} :
486 tout ce qui suit ce symbole sur cette ligne sera ignoré.
487 @item le bloc de commentaire, qui peut être de plusieurs lignes voire
488 de toute une section : tout ce qui se trouve entre @code{%@{} et
489 @code{%@}} est ignoré.
491 Le fragment suivant met en évidence quelques usages possibles des commentaires :
494 % voici les notes de "ah vous dirai-je maman"
498 Ces lignes et les notes qui suivent
499 seront ignorées, car elles se trouvent
500 dans un bloc de commentaire.
508 Vous trouverez plus d'astuces pour organiser vos fichiers LilyPond dans
509 @ref{Suggestions for writing LilyPond files}.
512 @node How to read the tutorial
513 @subsection How to read the tutorial
515 Comme nous l'avons vu dans @ref{Working on text files}, un code
516 LilyPond doit être encadré par des @{ @} ou bien par @code{\relative
517 c'' @{ ... @}} afin d'être compris. Cependant, dans la suite de ce
518 manuel, la plupart des exemples ne feront pas apparaître ces signes.
520 Si vous consultez la documentation au format HTML, et que vous
521 souhaitez voir la source exacte d'un exemple, il vous suffit de
522 cliquer sur l'image. Si vous ne disposez pas de la version HTML, il
523 vous est possible de simplement copier et coller le code affiché, mais
524 @strong{à condition} d'ajouter @code{\relative c'' @{ @}} de la façon
529 ... collez ici votre exemple...
533 Pourquoi avoir omis les accolades ? La plupart des exemples de ce
534 manuel peuvent être insérés au milieu d'un morceau de musique plus
535 long. Il n'y a donc aucune raison d'ajouter @code{\relative c'' @{
536 @}} à ces exemples -- en effet, il n'est pas possible d'insérer un
537 @code{\relative} à l'intérieur d'un autre @code{\relative}. Il vous
538 serait donc devenu impossible de copier un bref exemple de la
539 documentation et de le coller dans une pièce de votre crû.
541 @node Single staff notation
542 @section Single staff notation
544 Cette section présente la notation courante dont on a besoin pour
545 écrire une seule voix sur une seule portée.
548 * Relative note names::
549 * Accidentals and key signatures::
551 * Articulation and dynamics::
552 * Automatic and manual beams::
553 * Advanced rhythmic commands::
557 @node Relative note names
558 @subsection Relative note names
560 Comme nous l'avons vu dans @ref{Simple notation}, LilyPond calcule la
561 hauteur de chaque note en fonction de la précédente@footnote{Il existe
562 un autre mode de saisie des hauteurs, le mode @ref{Absolute note
563 names}, mais en pratique il est bien plus aisé et sûr d'avoir recours
564 au mode de hauteurs relatives.}. Si aucune indication supplémentaire
565 d'octaviation n'est ajoutée, il en conlcuera que chaque hauteur est
566 située à une quarte au plus de la note précédente.
568 Lilypond tient compte des intervalles induits par les noms des notes
569 -- en d'autres termes,une quarte augmentée n'est @emph{pas}
570 équivalente à une quinte diminuée. Ainsi, si l'on part d'un Do, un Fa
571 dièse sera placé au-dessus, tandis qu'un Sol bémol sera placé
574 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
582 @item Les Octaves Relatives
583 see @ref{Relative octaves}.
584 @item Les vérifications d'octaves
585 see @ref{Octave check}.
591 @node Accidentals and key signatures
592 @subsection Accidentals and key signatures
594 @subheading Accidentals
596 Dans la notation par défaut,un dièse (@rglos{sharp}) s'obtient en
597 ajoutant @samp{is} au nom de la
598 note, et un bémol (@rglos{flat}) en ajoutant @samp{es}. Comme vous pouvez
599 vous y attendre, un double dièse ou double bémol est alors obtenu en
600 ajoutant @samp{isis} ou @samp{eses}@footnote{Cette syntaxe est dérivée
601 de la convention de dénomination des notes dans les langues nordiques
602 et germaniques, comme l'allemand ou le hollandais.}.
605 Cependant, si vous utilisez la commande @samp{\include "italiano.ly"}
607 les noms de notes français au lieu des noms hollandais, il faudra
608 ajouter un @samp{d} pour un dièse, et un @samp{b} pour un bémol. Le
609 double dièse et le double bémol s'obtiennent en ajoutant
610 respectivement @samp{dd} et @samp{bb}
613 Pour en savoir plus sur les autres langues disponibles, voir @ref{Note
614 names in other languages}.}
616 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
617 cis1 ees fisis, aeses
620 @cindex key signature, setting
621 @subheading Key signatures
623 L'armure est déterminée par la commande @code{\key}, suivie d'une
624 hauteur puis de @code{\major} (majeur) ou @code{\minor} (mineur) :
626 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
635 @subheading Warning: key signatures and pitches
637 La combinaison de l'armure et des hauteurs de note -- y compris les
638 altérations -- permet à LilyPond de déterminer dans quel cas afficher les
639 altérations accidentelles. L'armure n'affecte que les altérations
640 @emph{imprimées}, et non les hauteurs réelles ! Cette fonctionnalité
641 est souvent source de
642 confusion pour les nouveaux utilisateurs, aussi expliquons-la en
645 LilyPond fait une nette distinction entre le contenu musical et la
646 mise en forme. L'altération d'une note -- bémol, bécarre ou dièse --
647 fait partie de sa hauteur, et relève donc du contenu musical. La
649 d'une altération accidentelle -- un @emph{signe} bémol, bécarre ou
650 dièse -- devant la note correspondante est une question qui relève de la mise en
651 page. Mettre en page une partition se fait selon des règles ; les
652 altérations accidentelles seront donc automatiquement imprimées suivant
653 ces règles. Les hauteurs de note, en revanche, relèvent de ce que
654 vous voulez entendre ; et, dans la mesure où la musique que vous
655 entrez est censée être celle que vous voulez entendre, LilyPond (qui
656 n'est chargé que de la gravure) ne les choisira pas à votre place.
660 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
666 Aucune note n'a ici d'altération accidentelle, et pourtant vous devrez
667 entrer le @samp{is} pour les notes @code{cis} et @code{fis}.
669 Le code @samp{d} ne veut pas dire @qq{Imprimez-moi un point noir juste
670 en-dessous de la portée.} Cela signifie plutôt : @qq{Ici se trouve
672 hauteur est un ré naturel.} Avec l'armure de la bémol majeur, ce ré
674 d'un bécarre accidentel :
676 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
681 Ajouter explicitement toutes les altérations requiert un peu plus
682 d'effort dans la phase de saisie, mais la transposition en sera
683 grandement facilitée.
684 De plus les altérations accidentelles
685 peuvent être imprimées suivant plusieurs conventions. Regardez
686 @ref{Automatic accidentals} pour connaître les différentes manières dont les
687 altérations accidentelles peuvent être imprimées, suivant les règles
693 @item Les altérations
694 see @ref{Accidentals} and @ref{Automatic accidentals}.
696 see @ref{Key signature}.
702 @subsection Ties and slurs
706 Une @rglos{tie}@footnote{parfois aussi appelée liaison de
707 tenue} se crée en ajoutant un tilde @samp{~} à la première note liée.
709 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
717 @c Le terme de "slur" a deux sens en français : articulation et phrasé.
718 @c Je garde ici le terme "legato", tel qu'il apparaît dans le texte original,
719 @c car c'est celui qui me semble le plus couramment employé.
721 Une @rglos{slur} d'articulation (ou @qq{legato}) peut englober
722 plusieurs notes. La note de départ et d'arrivée reçoivent
723 respectivement un signe @samp{(} et @samp{)}.
725 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
726 d4( c16) cis( d e c cis d) e( d4)
729 @cindex slurs, phrasing
730 @cindex phrasing slurs
731 @subheading Phrasing slurs
733 @cindex phrasing slurs
734 De plus longues liaisons, dites de phrasé, sont délimitées par @code{\(} et
735 @code{\)}. Il est possible d'avoir en même temps des legatos et des
736 phrasés, mais pas plusieurs liaisons de phrasé ou de legato à la fois.
738 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
739 a8(\( ais b c) cis2 b'2 a4 cis,\)
744 @cindex slurs versus ties
745 @subheading Warnings: slurs vs. ties
747 Une liaison d'articulation ou de phrasé ressemble à une liaison de
748 tenue, mais n'a pas la même signification. Alors qu'une liaison de
749 tenue ne peut relier que deux notes de même hauteur, le legato indique
750 une articulation de plusieurs notes, éventuellement nombreuses. Les
751 liaisons de tenue peuvent être enchâssées dans un legato ou un phrasé.
753 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
754 c2~( c8 fis fis4 ~ fis2 g2)
760 @item Liaisons de prolongation
764 @item Liaisons de phrasé
765 see @ref{Phrasing slurs}.
770 @node Articulation and dynamics
771 @subsection Articulation and dynamics
776 @subheading Articulations
778 Des @rglos{articulations} peuvent être ajoutées à une note, au moyen
779 d'un tiret @samp{-} suivi d'un caractère :
781 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
782 c-. c-- c-> c-^ c-+ c-_
786 @subheading Fingerings
787 De même, des indications de doigté peuvent être ajoutées à une note en
788 utilisant un tiret (@samp{-}) et le chiffre à écrire :
790 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
794 Articulations et doigtés sont habituellement placés automatiquement,
795 mais vous pouvez spécifier une direction en utilisant @samp{^} (en haut)
796 ou @samp{_} (en bas). Vous pouvez aussi utiliser plusieurs articulations
797 sur la même note. Dans la plupart des cas, cependant, il est mieux de
798 laisser LilyPond déterminer l'emplacement de l'articulation.
800 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
801 c_-^1 d^. f^4_2-> e^-_+
805 Les signes de nuances sont obtenus en ajoutant à la note les noms des nuances,
806 précédées d'un anti-slash @samp{\} :
808 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
816 @c Pluriel des termes musicaux italiens :
817 @c selon Littré, plutôt à la française (en "-os" qu'en "-i")
819 Crescendos et decrescendos débutent avec les commandes @code{\<} et
820 @code{\>}. Ils se terminent soit par une nuance d'arrivée, par
822 soit par la commande @code{\!} :
824 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
825 c2\< c2\ff\> c2 c2\!
832 see @ref{Articulations}.
834 see @ref{Fingering instructions}.
841 @node Automatic and manual beams
842 @subsection Automatic and manual beams
844 @cindex beams, by hand
845 Toutes les @rglos{beam}s sont dessinées automatiquement :
847 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
848 a8 ais d ees r d c16 b a8
852 Lorsqu'on n'aime pas la manière dont les notes sont automatiquement
853 groupées, il est possible de les entrer à la main, en marquant la
854 première note à attacher d'un @samp{[} et la dernière d'un @samp{]}.
856 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
857 a8[ ais] d[ ees r d] a b
863 @item Groupements de notes et ligatures automatiques
864 see @ref{Automatic beams}.
865 @item Groupements et ligatures manuels
866 see @ref{Manual beams}.
871 @node Advanced rhythmic commands
872 @subsection Advanced rhythmic commands
876 @cindex partial measure
877 @subheading Partial measure
879 Une levée (ou @rglos{anacrusis}) est entrée avec la commande
880 @code{\partial}, suivie d'une durée : @code{\partial 4} est une levée
882 @code{\partial 8} d'une croche.
884 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
892 Les n-olets sont créés avec la commande @code{\times}, qui prend
893 deux arguments : une fraction et une expression musicale. La durée des
894 notes de l'expression musicale est multipliée par la fraction. Par exemple les
895 notes d'un triolet durent les deux tiers du temps de leur notation
896 réelle, cette fraction est donc de 2/3 pour les triolets :
898 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
899 \times 2/3 { f8 g a }
901 \times 2/3 { f,8 g16 a g a }
908 @subheading Grace notes
910 Des notes d'ornement sont produites par la commande @code{\grace},
911 mais aussi en préfixant une expression musicale avec le mot-clé
912 @code{\appoggiatura} ou @code{\acciaccatura} :
914 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
915 c2 \grace { a32[ b] } c2
916 c2 \appoggiatura b16 c2
917 c2 \acciaccatura b16 c2
923 @item Notes d'ornement
924 see @ref{Grace notes},
928 see @ref{Partial measures}.
933 @node Multiple notes at once
934 @section Multiple notes at once
936 Cette section traite des situations où l'on a plus d'une note à la
937 fois : plusieurs instruments, plusieurs portées pour un même
938 instrument (le piano, par exemple), et les accords.
940 La polyphonie, en théorie musicale, est la notion d'une musique
941 constituée de plusieurs voix ; dans lilypond, ce terme désigne les
942 situations où il y a plus d'une voix sur une même portée.
945 * Music expressions explained::
948 * Single staff polyphony::
949 * Combining notes into chords::
953 @node Music expressions explained
954 @subsection Music expressions explained
956 Dans les fichiers source LilyPond, la musique est représentée par ce qu'on
957 appelle des @emph{expressions musicales}. En soi, une seule note peut
959 expression musicale, si tant est qu'elle soit correctement encadrée :
961 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
965 Mettre un groupe de notes entre accolades crée une nouvelle expression
968 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
972 Placer une séquence d'expressions musicales -- des notes par exemple
973 -- entre accolades signifie qu'elles doivent être jouées
974 successivement, les unes après les autres. Le résultat est une
975 expression, qui peut elle-même être regroupée séquentiellement avec
976 d'autres expressions. Ici, l'expression de l'exemple précédent est
977 combinée à deux notes :
979 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
983 @subheading Simultaneous music expressions: multiple staves
985 Cette technique est utile pour de la musique polyphonique. Pour
986 entrer une musique avec plusieurs voix ou plusieurs portées, nous
987 pouvons aussi combiner en parallèle les expressions. Deux voix qui doivent être
988 jouées en même temps, sont entrées comme une combinaison simultanée de
989 deux expressions. Une expression musicale @q{simultanée} est formée en
990 entourant les expressions entre @code{<<} et @code{>>}. Dans l'exemple
991 suivant, trois expressions (contenant chacune deux notes distinctes) sont
992 combinées simultanément.
994 @lilypond[quote,ragged-right,verbatim]
1004 Notez que nous avons ici indenté chaque niveau du fichier d'entrée
1005 avec un nombre d'espaces différent. LilyPond se moque de l'espace
1006 qu'il peut y avoir (ou pas) au début d'une ligne, mais en indentant
1007 votre code vous le rendrez bien plus facile à lire pour les humains.
1009 @strong{Attention} : chaque note saisie est relative à la précédente,
1010 mais pas au @code{c''} de la commande @code{\relative} de départ.
1013 @subheading Simultaneous music expressions: single staff
1015 Pour déterminer le nombre de portées, LilyPond regarde le premier
1016 élément autre qu'une accolade. Si c'est une seule note, il y a une
1017 portée ; si c'est une expression simultanée, il y aura plus d'une
1020 @lilypond[quote,ragged-right,verbatim]
1022 c2 <<c e>>
1023 << { e f } { c <<b d>> } >>
1028 @cindex music expression
1029 @subheading Analogy: mathematical expressions
1031 Ce mécanisme est similaire au formules mathématiques : une grosse
1032 formule est créée en assemblant plusieurs petites formules. Ces types
1033 de formules, appelées expressions, ont une définition récursive, de
1034 telle sorte que vous pouvez fabriquer des expressions arbitrairement
1035 longues et complexes. Par exemple,
1044 ((1 + 2) * 3) / (4 * 5)
1047 Ceci est une suite d'expressions, où chacune est contenue dans la
1048 suivante. Les expressions les plus simples sont les nombres, et de
1049 plus grandes expressions sont produites en combinant des expressions
1050 avec des opérateurs -- comme @samp{+}, @samp{*} et @samp{/} -- et des
1051 parenthèses. Tout comme les expressions mathématiques, les expressions
1052 musicales peuvent être imbriquées avec une profondeur arbitraire, ce
1053 qui est nécessaire pour de la musique complexe comme des partitions
1057 @node Multiple staves
1058 @subsection Multiple staves
1060 Comme nous l'avons vu dans @ref{Music expressions explained}, un
1061 fichier d'entrée LilyPond est fait d'expressions musicales. Si la
1062 partition commence par plusieurs expressions simultanées, LilyPond
1063 créera plusieurs portées. Cependant, il est plus facile de voir ce
1064 qu'il advient si l'on crée explicitement chacune des portées.
1066 Pour créer plus d'une portée, chaque partie de la musique constituant
1067 une portée est entrée en la faisant précéder de @code{\new Staff}.
1068 Ces éléments @code{Staff} sont ensuite combinés en parallèle avec
1069 @code{<<} et @code{>>}, comme ceci :
1071 @lilypond[quote,ragged-right,verbatim]
1074 \new Staff { \clef treble c }
1075 \new Staff { \clef bass c,, }
1081 La commande @code{\new} introduit un « contexte de notation ». Un
1082 contexte de notation est un environnement dans lequel les événements
1083 musicaux -- comme les notes ou les commandes @code{\clef} -- sont
1084 interprétés. Pour des pièces simples, ces contextes sont créés
1085 automatiquement. Pour des pièces plus complexes, il est préférable de
1086 spécifier explicitement les contextes. Cela assure que chaque
1087 fragment aura sa propre portée.
1089 Il existe différents types de contextes. Les contextes @code{Staff}
1090 (portée), @code{Voice} (voix) et @code{Score} (partition) gèrent la
1091 notation de la mélodie, alors que @code{Lyrics} gère les paroles et
1092 @code{ChordNames} imprime le nom des accords.
1094 En termes de syntaxe, faire précéder une expression musicale de
1095 @code{\new} crée une plus grosse expression musicale. En reprenant la
1096 comparaison, cela ressemble au signe « moins » en mathématiques. La
1097 formule @math{(4+5)} est une expression, donc @math{-(4+5)} est une
1098 plus grosse expression.
1100 Les chiffres de mesure figurant sur une portée affectent toutes les
1101 autres portées ; en revanche l'armure d'une portée n'affectera
1102 @emph{pas} les autres portées.@footnote{Ce comportement peut être
1103 modifié si nécessaire : voir pour cela @ref{Changing defaults}.}.
1105 @lilypond[quote,ragged-right,verbatim]
1108 \new Staff { \clef treble \time 3/4 c }
1109 \new Staff { \clef bass \key d \major c,, }
1118 @subsection Piano staves
1120 @cindex staff switch, manual
1121 @cindex cross staff voice, manual
1122 La musique pour piano s'écrit sur deux portées reliées par une
1123 accolade. Imprimer ce type de portée revient au même que dans
1124 l'exemple de musique polyphonique de (@ref{Multiple staves}), mais
1125 maintenant cette expression entière doit être interprétée dans un
1126 contexte @code{PianoStaff} :
1129 \new PianoStaff <<
1135 Voici un bref exemple :
1137 @lilypond[quote,ragged-right,verbatim]
1139 \new PianoStaff <<
1140 \new Staff { \time 2/4 c4 e g g, }
1141 \new Staff { \clef bass c,, c' e c }
1148 See @ref{Piano music}.
1152 @node Single staff polyphony
1153 @subsection Single staff polyphony
1156 @cindex multiple voices
1157 @cindex voices, more -- on a staff
1158 Quand différentes lignes mélodiques sont combinées sur une seule et
1159 même portée, elles sont imprimées comme des voix polyphoniques ;
1160 chaque voix a ses propre hampes@footnote{familièrement appelées queues
1161 de note.}, liaisons et ligatures, la voix supérieure ayant les hampes
1162 vers le haut, la voix inférieure vers le bas.
1164 Ce type de partition est réalisé en entrant chaque voix comme une
1165 séquence (avec @code{@{...@}}), en combinant simultanément les voix et
1166 en les séparant par @code{\\} :
1169 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
1176 Pour l'écriture de musique polyphonique, les silences invisibles
1177 (spacer rests) s'avèrent bien pratiques ; ce sont des silences qui ne
1178 s'impriment pas. Ils sont utiles pour remplir des voix qui,
1179 temporairement, ne jouent rien. On peut voir ici le même exemple avec
1180 un silence espace invisible (@code{s}) à la place d'un silence normal
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 See @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 }
1341 Pour la musique improvisée, les accords ne sont pas imprimés sur des
1342 portées mais comme des lignes à part entière. Ceci s'obtient en
1343 utilisant @code{\chords} à la place de @code{\chordmode}. La même
1344 syntaxe sera utilisée que dans le cas de@code{\chordmode}, mais le
1345 rendu des notes interviendra dans un contexte de @code{ChordNames},
1346 avec le résultat suivant :
1348 @lilypond[quote,verbatim,ragged-right]
1349 \chords { c2 f4.:m g4.:maj7 gis8:dim7 }
1353 Une fois assemblés, les accords, paroles et mélodie forment une
1354 partition de chanson :
1356 @lilypond[quote,verbatim,ragged-right]
1358 \chords { c2 g:sus4 f e }
1363 \addlyrics { One day this shall be free __ }
1370 Une liste complète de modificateurs et d'autres options de mise en
1371 forme se trouve à la section @ref{Chords}.
1376 @section Final touches
1378 Voici l'ultime section de ce tutoriel, qui montre comment ajouter la
1379 touche finale à des morceaux simples, et sert d'introduction pour le
1385 * Absolute note names::
1386 * Organizing pieces with identifiers::
1387 * After the tutorial::
1388 * How to read the manual::
1392 @node Version number
1393 @subsection Version number
1396 La déclaration @code{\version} stipule le numéro de la version de
1397 LilyPond pour laquelle le fichier a été écrit. Pour donner à un
1398 fichier la version 2.10.0, ajoutez
1405 tout en haut de votre fichier LilyPond.
1407 Cette annotation permet de faciliter les prochaines mises à jour de
1408 LilyPond. Les changements dans la syntaxe sont gérés avec un
1409 programme spécial, @file{convert-ly} -- voir @ref{Updating files with
1410 convert-ly} -- et il utilise @code{\version} pour déterminer les
1411 règles de conversion à appliquer au fichier.
1415 @subsection Adding titles
1417 Les informations bibliographiques (nom du morceau, du compositeur,
1418 etc) sont entrées dans un bloc séparé, le bloc d'en-tête
1419 (@code{\header}), qui existe indépendamment des expressions musicales
1420 principales. Le bloc @code{\header} est habituellement placé en début
1432 @dots{} music @dots{}
1435 Quand le fichier est traité, le titre et le compositeur sont imprimés
1436 en haut de la partition. Vous trouverez plus d'informations sur les
1437 titres à @ref{Creating titles}.
1439 @node Absolute note names
1440 @subsection Absolute note names
1442 Jusqu'ici nous n'avons utilisé que le mode @code{\relative} pour
1443 définir les hauteurs de notes. Si c'est effectivement le moyen le
1444 plus simple d'entrer la majeure partie de votre musique, il existe une
1445 autre façon de procéder : le mode de hauteurs absolues.
1447 Si vous omettez la commande @code{\relative}, LilyPond considérera
1448 toutes les hauteurs comme des hauteurs absolues. Un @code{c'} sera
1449 toujours un do du milieu, un @code{b} sera toujours une note
1450 au-dessous du précédent, et un @code{g,} sera toujours la note la plus
1451 grave dans la portée de clé de Fa.
1453 @lilypond[quote,verbatim,ragged-right]
1461 Voici une gamme sur 4 octaves :
1463 @lilypond[quote,verbatim,ragged-right]
1478 Comme vous pouvez le voir, il faut beaucoup d'apostrophes pour écrire
1479 de la musique dans un registre aigu. Regardez cet extrait de Mozart :
1481 @lilypond[quote,verbatim,ragged-right]
1485 cis''8. d''16 cis''8 e''4 e''8
1486 b'8. cis''16 b'8 d''4 d''8
1490 Toutes ces apostrophes rendent le fichier moins lisible, et c'est donc
1491 une source d'erreurs. En mode @code{\relative}, le même exemple
1492 devient bien plus facile à lire :
1494 @lilypond[quote,verbatim,ragged-right]
1498 cis8. d16 cis8 e4 e8
1503 Si d'aventure vous faites une erreur d'octaviation, le mode
1504 @code{\relative} la rendra frappante -- toutes les notes suivantes
1505 seront placées à la mauvaise octave. En mode de hauteurs absolues,
1506 une erreur isolée ne serait pas aussi visible, et donc aussi facile à
1509 Cependant, le mode de hauteurs absolues reste utile pour les musiques
1510 où les intervalles sont étendus, surtout pour les fichiers LilyPond
1511 créés par ordinateur.
1514 @node Organizing pieces with identifiers
1515 @subsection Organizing pieces with identifiers
1517 Lorsque l'on combine tous les éléments étudiés plus haut pour produire
1518 des fichiers plus volumineux, les blocs @code{\score} deviennent
1519 beaucoup plus gros parce que les expressions musicales sont plus
1520 longues et, dans le cas des pièces polyphoniques, profondément
1521 imbriquées. De telles expressions imposantes finissent par devenir
1522 peu maniables. Cet inconvénient peut être résolu par l'utilisation
1523 d'@emph{identificateurs}.
1525 En utilisant ces identificateurs, que l'on pourrait aussi appeler
1526 variables ou macros, il est possible de découper des expressions
1527 musicales complexes. Un identificateur se définit comme suit :
1530 MusiqueToto = @{ @dots{} @}
1533 Le contenu de l'expression musicale @code{MusiqueToto} pourra être
1534 utilisé plus loin en faisant précéder son nom d'un anti-slash,
1535 c'est-à-dire @code{\MusiqueToto}, juste comme n'importe quelle
1536 commande LilyPond. Tous les identificateurs doivent être définis
1537 @emph{avant} l'expression musicale principale.
1539 @lilypond[quote,verbatim,ragged-right]
1540 violin = \new Staff { \relative c'' {
1543 cello = \new Staff { \relative c {
1556 Le nom d'un identificateur ne doit comporter que des caractères
1557 alphabétiques non accentués, aucun nombre ni tiret.
1559 Il est possible d'utiliser des variables de types variés. Par exemple,
1564 aFivePaper = \paper @{ paperheight = 21.0 \cm @}
1567 En fonction de son contenu, un identificateur peut être utilisé à
1568 différents endroits. L'exemple suivant utilise la variable ci-dessus
1580 @node After the tutorial
1581 @subsection After the tutorial
1583 Après avoir parcouru ce tutoriel, vous devriez vous essayer à écrire
1584 un morceau ou deux. Commencez par copier l'un des modèles types
1585 (@ref{Templates}) et ajoutez-y des notes. Si vous voulez employer une
1586 notation que vous n'avez pas trouvé dans le tutoriel, consultez la
1587 référence de notation, en commençant par la @ref{Basic notation}. Si
1588 vous désirez écrire pour un ensemble instrumental non couvert par les
1589 @ref{Example templates}, lisez la section @ref{Extending the
1592 Après avoir écrit quelques pièces courtes, lisez les chapitres 3 à 5
1593 du manuel d'apprentissage. Rien ne s'oppose à ce que vous consultiez
1594 dès à présent les autres chapitres, bien sûr ! Néanmoins, le reste du
1595 manuel de l'utilisateur part du principe que vous avez déjà bien
1596 assimilé la syntaxe de LilyPond. Vous pouvez toujours survoler le
1597 reste du manuel, et y revenir plus tard après avoir acquis de
1600 @node How to read the manual
1601 @subsection How to read the manual
1603 Comme nous l'avons déjà vu dans @ref{How to read the tutorial}, de
1604 nombreux exemples du tutoriel n'ont pas fait apparaître le
1605 @code{\relative c'' @{ ... @}} dans l'extrait de code affiché.
1607 Dans le reste du manuel, les exemples utilisés sont encore beaucoup
1608 plus souples : parfois il leur manque le @code{\relative c'' @{ ...
1609 @}}, mais d'autres fois ils ont recours à une autre hauteur de
1610 référence, telle que @code{c'} ou @code{c,,}), et dans certains cas
1611 c'est même l'exemple entier qui est en mode de hauteurs absolues !
1612 Cependant, de telles ambiguïtés ne se trouvent que dans des contextes
1613 où les hauteurs n'ont que peu d'importance. Dans tous les exemples où
1614 elles en ont, le mode @code{\relative} ou absolu @code{@{ @}} est
1615 explicitement spécifié.
1617 Si vous ne vous y retrouvez toujours pas pour savoir quel code
1618 LilyPond produit précisément tel ou tel exemple, consultez la version
1619 HTML de ce manuel (si ce n'est pas déjà le cas), et cliquez sur
1620 l'image de la partition. La source exacte utilisée pour générer ce
1621 manuel s'affichera alors.