1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
2 @c This file is part of lilypond.tely
4 Translation of GIT committish: f413550b658b43fbea690fc060f872bce6bbc885
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. See TRANSLATION for details.
13 Tutorial guidelines: (different from policy.txt!)
14 - unless you have a really good reason, use either
15 @lilypond[verbatim,quote]
17 @lilypond[verbatim,quote,relative=2]
19 Don't use any other relative=X commands.
21 - use "aes" and "ees" instead of "as" and "es". I know it's not
22 correct Dutch naming, but let's not confuse people with this
23 until we get to the Basic notation chapter.
25 - Add "Music Glossary: @rglos{foo}" to the *top* of the relevant
26 portions of the tutorial.
31 @c Translators: Nicolas Grandclaude, Ludovic Sardain, Gauvain Pocentek
32 @c Translation checkers: Jean-Charles Malahieude, Valentin Villenave, John Mandereau
33 @c Translation status: post-GDP
38 Ce tutoriel commence par une introduction au langage musical utilisé
39 par LilyPond, qui vous permettra de faire fonctionner le logiciel pour
40 produire une partition. Après ce premier contact, nous verrons comment
41 créer des partitions utilisant une notation musicale courante.
45 * Single staff notation::
46 * Multiple notes at once::
55 Cette section présente les aspects élémentaires de l'utilisation de
61 * Working on input files::
62 * How to read the manual::
66 @node Compiling a file
67 @subsection Compiling a file
70 @cindex exemple, premier
71 @cindex premier exemple
73 Pour créer une partition avec LilyPond, on écrit un fichier texte,
74 appelé fichier source, qui décrit la notation musicale. La
75 @emph{compilation} de ce fichier source par LilyPond produit un
76 fichier graphique imprimable, et si on le désire un fichier MIDI qui
77 peut être joué par un séquenceur.
79 Voici un premier exemple simple de fichier source LilyPond.
88 La compilation de ce fichier donnera quelque chose de sembable à
91 @c in this case we don't want verbatim
99 Il est aussi possible d'utiliser les noms de notes français @samp{do
100 re mi fa sol la si}, en insérant au début du fichier la ligne
101 @samp{\include "italiano.ly"}.
104 @warning{Tout extrait de code LilyPond doit être entouré d'une
105 @strong{@{ paire d'accolades @}}. De plus, pour éviter toute
106 ambiguïté, il est préférable d'entourer les accolades par des espaces
107 ou retours à la ligne. Bien que certains exemples de ce manuel ne
108 comportent pas d'accolades, ne les oubliez pas dans vos partitions !
109 Pour plus d'informations sur l'affichage des exemples de cette
110 documentation, consultez @ref{How to read the manual}.}
113 @cindex casse, prise en compte de la
114 @cindex prise en compte de la casse
115 @cindex sensibilité à la casse
117 De plus, LilyPond est @strong{sensible à la casse} : le code
118 @w{@code{@{ c d e @}}} est valide, alors que @w{@code{@{ C D E @}}}
119 produira un message d'erreur.
123 @subheading Entering music and viewing output
127 @cindex partition, lire
128 @cindex lire la partition
129 @cindex éditeurs de texte
130 @cindex LilyPond et MacOS X
131 @cindex MacOS X et LilyPond
132 @cindex LilyPond et Windows
133 @cindex Windows et LilyPond
134 @cindex LilyPond et Unix
135 @cindex Unix et LilyPond
137 Dans cette section nous expliquerons quelles commandes exécuter et
138 comment voir ou imprimer le résultat produit par LilyPond.
140 Notez qu'il existe plusieurs éditeurs de texte disponibles avec un bon
141 support de LilyPond ; consultez @rprogram{Text editor support}.
143 @warning{Le premier démarrage de LilyPond peut prendre une minute ou
144 deux, afin de générer la liste des polices du système. LilyPond démarre
145 en principe plus rapidement lors des exécutions suivantes.}
148 @subsubheading MacOS X
150 Si vous double-cliquez sur @code{LilyPond.app}, un fichier d'exemple
151 s'ouvrira. Sauvegardez-le, par exemple, sous @file{test.ly} sur votre
152 bureau, puis traitez-le avec la commande de menu @samp{Compile >
153 Typeset File}. Le fichier PDF résultant sera alors affiché à l'écran.
155 À l'avenir, vous aurez certainement recours aux commandes @qq{Nouveau}
156 ou @qq{Ouvrir}. Vous devez enregistrer votre fichier avant de lancer
157 la gravure de la partition par LilyPond. Si une erreur apparaît
158 pendant le traitement, vous la trouverez dans la fenêtre @qq{log}.
160 @subsubheading Windows
162 Sous Windows, double-cliquez sur l'icône LilyPond qui se trouve sur le
163 bureau, un fichier d'exemple s'ouvre dans un simple éditeur de texte.
164 Enregistrez-le, par exemple en tant que @file{test.ly} sur le bureau,
165 puis double-cliquez sur son icône (qui montre une note de musique)
166 pour le traiter. Après quelques secondes, vous obtiendrez un fichier
167 @file{test.pdf} sur le bureau, fichier que vous pourrez ouvrir pour
168 voir la partition gravée. Une autre méthode pour lancer le traitement
169 du fichier @file{test.ly} est de le glisser avec votre souris sur
172 Pour modifier un fichier @file{.ly} existant, faites un clic droit
173 dessus et sélectionnez @qq{Éditer la source}. Pour partir d'un
174 fichier vide, lancez l'éditeur en ouvrant un fichier existant et
175 utilisez la commande @qq{New} du menu @qq{File}.
177 En double-cliquant sur le fichier, vous obtiendrez, en plus du fichier
178 PDF, un fichier @file{.log} qui récapitule les opérations que LilyPond
179 a effectuées sur votre fichier. Si une erreur survient, vous en
180 trouverez les détails dans ce fichier.
184 Créez un fichier texte @file{test.ly} qui contient
193 Pour traiter @file{test.ly}, entrez la commande suivante dans un
201 Vous verrez quelque chose ressemblant à
205 GNU LilyPond @version{}
206 Traitement de « test.ly »
208 Interprétation en cours de la musique...
209 Pré-traitement des éléments graphiques...
210 Détermination du nombre optimal de pages...
211 Répartition de la musique sur une page...
212 Dessin des systèmes...
213 Sortie mise en page vers « test.ps »...
214 Conversion à « ./test.pdf »...
219 Suivant votre installation, ces messages peuvent être traduits ou
224 @node Simple notation
225 @subsection Simple notation
227 @cindex simple, notation
228 @cindex notation simple
230 Il y a certains éléments graphiques de notation que LilyPond ajoute
231 automatiquement. Dans l'exemple suivant, nous n'avons fourni que
232 quatre hauteurs, mais LilyPond a ajouté une clef, un chiffre de mesure
235 @lilypond[verbatim,quote]
242 Ces valeurs automatiques simplifient la saisie du code source dans
243 bien des cas ; nous verrons plus loin comment les indiquer
253 @cindex altérations et mode relatif
254 @cindex mode relatif et altérations
261 Glossaire musical : @rglos{pitch}, @rglos{interval},
262 @rglos{scale}, @rglos{middle C}, @rglos{octave},
265 Le moyen le plus simple d'entrer des notes est d'utiliser le mode
266 d'octaves relatives, ou mode @code{\relative}. Dans ce mode, l'octave
267 de chaque note est sélectionnée automatiquement de façon à ce qu'elle
268 soit la plus proche possible de la note précédente, c'est-à-dire de
269 façon à ce que l'intervalle avec la note précédente soit au plus d'une
270 quarte. Commençons par saisir une partition très simple, à savoir une
273 @lilypond[verbatim,quote]
274 % set the starting point to middle C
281 La note de départ est le @notation{do central}. Chacune des notes qui
282 suivent est placée à l'octave la plus proche de la note précédente ---
283 en d'autres termes, le premier @samp{c} est le do central, entre la
284 clef de sol et la clef de fa, puis est suivi par le ré le plus proche,
285 et ainsi de suite. On peut bien sûr créer des mélodies avec de plus
286 grands intervalles, toujours avec le mode @code{\relative} :
288 @lilypond[verbatim,quote]
296 Remarquez que cet exemple ne commence plus sur le do central : la
297 première note --- le @samp{d} --- est le ré qui en est le plus proche.
299 Dans l'exemple suivant, on remplace @code{c'} dans la commande
300 @w{@code{\relative c'}} par @code{c''}, afin de calculer l'octave de
301 la première note par rapport au do situé une octave au-dessus du do
304 @lilypond[verbatim,quote]
305 % one octave above middle C
311 Le mode d'octaves relatives peut être déroutant au début, mais c'est
312 souvent la façon la plus économique de saisir les hauteurs en
313 utilisant le clavier de l'ordinateur de façon classique. Détaillons
314 dans un exemple le calcul des octaves relatives. En partant d'un si
315 sur la troisième ligne de la clé de sol, un do, un ré ou un mi sans
316 indication d'octave particulière seront placés juste au-dessus du si,
317 c'est-à-dire au plus à une quarte ascendante du si, alors qu'un la, un
318 sol ou un fa seront placés juste en-dessous du si, c'est-à-dire au
319 plus à une quarte descendante du si.
321 @lilypond[verbatim,quote]
323 b c % c is 1 staff space up, so is the c above
324 b d % d is 2 up or 5 down, so is the d above
325 b e % e is 3 up or 4 down, so is the e above
326 b a % a is 6 up or 1 down, so is the a below
327 b g % g is 5 up or 2 down, so is the g below
328 b f % f is 4 up or 3 down, so is the f below
332 Notez que le calcul des octaves relatives @strong{ne dépend pas des
333 altérations} des notes, dièses bémols ou bécarre.
335 Pour obtenir des intervalles supérieurs à une quarte, on peut ajouter
336 des apostrophes @code{'} --- qui font chacune monter la hauteur d'une
337 octave --- ou des virgules @code{,} --- qui font chacune descendre la
338 hauteur d'une octave --- au nom de la note.
340 @lilypond[verbatim,quote]
348 Pour déplacer une note deux octaves (ou davantage !) plus haut ou plus
349 bas, il suffit de mettre deux (ou davantage) @code{'} ou @code{,} ---
350 attention cependant à bien mettre deux apostrophes @code{''}, et non
351 un guillemet @code{"}@tie{}! C'est de cette même manière que l'on
352 peut modifier la valeur de départ de @code{\relative c'}.
355 @subheading Durées et rythme
364 @cindex spécification des durées
366 Glossaire musical : @rglos{beam}, @rglos{duration},
367 @rglos{whole note}, @rglos{half note}, @rglos{quarter note},
370 La @notation{durée} d'une note est indiquée par un nombre qui suit sa
371 hauteur : @samp{1} pour une @notation{ronde}, @samp{2} pour une
372 @notation{blanche}, @samp{4} pour une @notation{noire} et ainsi de
373 suite. Les @notation{crochets} et @notation{liens} sont ajoutés
376 Si aucune durée n'est indiquée pour une note, la dernière durée entrée
377 est utilisée. En l'absence d'indication de durée, la première note
380 @lilypond[verbatim,quote]
384 a16 a a a a32 a a a a64 a a a a a a a a2
388 Une @notation{note pointée} s'obtient en ajoutant un point @code{.} à
389 la valeur rythmique. Le point doit être précédé d'un nombre spécifiant
392 @lilypond[verbatim,quote]
403 @cindex notation des silences
405 Glossaire musical : @rglos{rest}.
407 On saisit un @notation{silence} tout comme une note, mais avec la
408 lettre @samp{r} (pour @emph{rest}).
410 @lilypond[verbatim,quote]
425 Glossaire musical : @rglos{time signature}.
427 La @notation{métrique}, aussi appelée @notation{chiffre de mesure},
428 peut être définie à l'aide de la commande @code{\time} :
430 @lilypond[verbatim,quote]
453 Glossaire musical : @rglos{clef}.
455 La @notation{clef} peut être définie à l'aide de la commande
458 @lilypond[verbatim,quote]
472 @subheading Tout ensemble
474 Voici un bref exemple qui rassemble tous les éléments que nous déjà
477 @lilypond[verbatim,quote]
488 Manuel de notation : @ruser{Writing pitches},
489 @ruser{Writing rhythms}, @ruser{Writing rests},
490 @ruser{Time signature}, @ruser{Clef}.
493 @node Working on input files
494 @subsection Working on input files
499 Le traitement des fichiers source de LilyPond est semblable à celui du
500 code de nombreux langages de programmation. La casse est prise
501 en compte, et les caractères considérés comme espaces ont généralement
502 peu d'importance. Les expressions sont délimitées par des accolades @{
503 @}, et les commentaires par @code{%} ou @code{%@{ ... %@}}.
505 Si cette phrase vous paraît incompréhensible, ne vous en faites pas !
506 Expliquons tous ces termes :
510 @item @strong{La casse} :
511 @cindex casse, prise en compte de
512 @cindex prise en compte de la casse
513 @cindex sensibilité à la casse
514 LilyPond est sensible à la casse, c'est à dire qu'une lettre capitale
515 n'a pas la même valeur qu'une lettre minuscule. Les notes, par
516 exemple, doivent être entrées en minuscule : @code{@{ c d e @}} est
517 un code valide, alors que @code{@{ C D E @}} produira un message
520 @cindex espaces multiples, insensibilité
521 @cindex insensibilité aux espaces multiples
523 @item @strong{Les espaces multiples} :
524 LilyPond ne tient pas compte du nombre d'espaces, ou de retours à la
525 ligne. @code{@{ c d e @}} a le
526 même sens que @code{@{ c @tie{} @tie{} d @tie{} e @}} ou que
534 Bien sûr, ce dernier exemple est illisible. Une bonne habitude
535 à prendre est d'indenter les blocs de code avec soit des tabulations
536 soit des doubles espaces :
546 @item @strong{Expressions musicales} :
547 Tout morceau saisi dans LilyPond doit être placé entre @strong{@{
548 accolades @}}. Ces caractères indiquent à LilyPond que ce bloc de
549 texte représente une et une seule expression musicale, tout comme les
550 parenthèses @samp{()} en mathématiques. Pour éviter toute ambiguïté,
551 il est préférable d'entourer ces accolades d'espaces ou de retours à
554 Un appel de fonction --- @w{@code{\relative @{ @}}} par exemple ---
555 compte également comme une seule expression musicale.
558 @cindex commentaire de fin de ligne
559 @cindex commentaire-bloc
560 @cindex bloc de commentaire
563 @funindex %@{ ... %@}
565 @item @strong{Les commentaires} :
566 un commentaire est une indication pour tout lecteur humain d'un
567 fichier source de musique ; il est ignoré par l'ordinateur, et n'a
568 donc aucun effet sur la partition imprimée. On distingue deux types
569 de commentaires. Le commentaire de fin de ligne, introduit par le
570 symbole @samp{%} : tout ce qui suit ce symbole sur la même ligne sera
571 ignoré. Par convention, un commentaire qui occupe une ligne entière
572 se place juste @emph{au-dessus} de la ligne à laquelle il fait
577 % ce commentaire fait référence aux si
581 Le bloc de commentaire, qui peut occuper plusieurs lignes, voire toute
582 une section : tout ce qui se trouve entre @code{%@{} et @code{%@}} est
583 ignoré. Les blocs de commentaires ne peuvent s'imbriquer, ce qui
584 signifie que vous ne pouvez pas placer un commentaire-bloc à
585 l'intérieur d'un autre commentaire-bloc. Si jamais vous essayez, vous
586 verrez que la première occurence de @code{%@}} terminera @qq{les
587 @emph{deux} commentaires-blocs}. Le fragment suivant met en évidence
588 quelques usages possibles des commentaires :
591 % voici les notes de "ah vous dirai-je maman"
595 Ces lignes et les notes qui suivent
596 seront ignorées, car elles se trouvent
597 dans un bloc de commentaire.
607 @node How to read the manual
608 @subsection How to read the manual
610 @cindex bien lire le manuel
611 @cindex manuel, lecture
612 @cindex compulser le manuel
613 @cindex exemples cliquables
614 @cindex cliquables, exemples
615 @cindex conseils de construction des fichiers
617 @cindex construction des fichiers, conseils
618 @cindex fichiers, conseils de construction
620 Comme nous l'avons vu dans @ref{Working on input files}, un code
621 LilyPond doit être encadré par des accolades @{ @} ou bien par
622 @code{\relative c'' @{ ... @}}. Cependant, dans la suite de ce
623 manuel, la plupart des exemples ne feront pas apparaître ces signes.
625 Pour reproduire les exemples, vous pouvez copier et coller le code
626 affiché, mais @strong{à condition} d'ajouter @code{\relative c'' @{
627 @}} de la façon suivante :
631 ...collez ici votre exemple...
635 Pourquoi avoir omis les accolades ? La plupart des exemples de ce
636 manuel peuvent être insérés au milieu d'un morceau de musique plus
637 long. Il n'y a donc aucune raison d'ajouter @code{\relative c'' @{
638 @}} à ces exemples --- en effet, il n'est pas possible d'insérer une
639 expression @code{\relative} à l'intérieur d'un autre expression
640 @code{\relative}. Si nous mettions tous nos exemples dans une
641 expression @code{\relative}, vous ne pourriez plus copier un bref
642 exemple de la documentation pour le coller dans vos pièces.
645 @subheading Exemples cliquables
647 Beaucoup de gens apprennent à utiliser les programmes en les essayant
648 et en bidouillant avec. C'est également possible avec LilyPond. Si
649 vous cliquez sur une image dans la version HTML de ce manuel, vous
650 verrez exactement le code LilyPond utilisé pour générer cette image.
651 Essayez sur cette image :
655 @lilypond[quote,ragged-right]
657 c-\markup { \bold \huge { Cliquez ici. } }
661 En copiant-collant le code à partir du commentaire @qq{ly snippet}
662 vers un fichier test, vous aurez un modèle de base pour faire vos
663 expériences. Pour obtenir une gravure à l'identique, copiez tout le
664 code à partir de @qq{Start cut-&-pastable section}.
666 @c No longer in the text in English, but should we really
669 Si vous apprenez de cette façon, vous aurez probablement envie
670 d'imprimer ou de garder un lien vers @ruser{Cheat sheet}, tableau
671 qui répertorie les commandes usuelles pour une consultation rapide.
676 Vous trouverez plus de conseils pour construire des fichiers source
677 dans @ref{Suggestions for writing LilyPond input files}. Cependant,
678 lors d'une première lecture il est préférable de terminer d'abord la
682 @node Single staff notation
683 @section Single staff notation
685 Cette section présente la notation courante dont on a besoin pour
686 écrire une voix sur une portée.
689 * Accidentals and key signatures::
691 * Articulation and dynamics::
693 * Automatic and manual beams::
694 * Advanced rhythmic commands::
698 @node Accidentals and key signatures
699 @subsection Accidentals and key signatures
701 @subheading Accidentals
705 @cindex dièse, double
708 @cindex bémol, double
719 Glossaire musical : @rglos{sharp}, @rglos{flat}, @rglos{double sharp},
720 @rglos{double flat}, @rglos{accidental}.
722 Dans la notation par défaut, on obtient un @notation{dièse} en
723 ajoutant @code{is} au nom de la note, et un @notation{bémol} en
724 ajoutant @code{es}. Comme vous pouvez vous y attendre, un double
725 dièse ou double bémol s'obtiennent en ajoutant @code{isis} ou
726 @code{eses}. Cette syntaxe est dérivée de la convention de
727 dénomination des notes dans les langues nordiques et germaniques,
728 comme l'allemand ou le hollandais.
731 Cependant, si vous utilisez la commande @code{\include "italiano.ly"}
732 pour entrer les noms de notes français au lieu des noms hollandais, il
733 faudra ajouter un @code{d} pour obtenir un dièse, et un @code{b} pour
734 un bémol. Le double dièse et le double bémol s'obtiennent en ajoutant
735 respectivement @code{dd} et @code{bb}. Pour en savoir plus sur les
736 autres langues disponibles, consultez @ruser{Note names in other
740 @lilypond[verbatim,quote,relative=2]
741 cis1 ees fisis, aeses
744 @subheading Key signatures
746 @cindex armure, définition de l'
747 @cindex armure, altérations à l'
748 @cindex altérations à l'armure
759 Glossaire musical : @rglos{key signature}, @rglos{major},
762 L'armure est déterminée par la commande @code{\key}, suivie d'une
763 hauteur puis de @code{\major} (majeur) ou @code{\minor} (mineur).
765 @lilypond[verbatim,quote,relative=2]
774 @subheading Warning: key signatures and pitches
776 Glossaire musical : @rglos{accidental}, @rglos{key signature},
777 @rglos{pitch}, @rglos{flat}, @rglos{natural}, @rglos{sharp},
778 @rglos{transposition}.
780 La combinaison de l'@notation{armure} et des hauteurs de note --- y
781 compris les altérations --- permet à LilyPond de déterminer dans quel
782 cas imprimer des @notation{altérations accidentelles}. L'armure
783 n'affecte que les altérations @emph{imprimées}, et non les hauteurs
784 réelles ! Cette fonctionnalité est souvent source de confusion pour
785 les nouveaux utilisateurs, aussi expliquons-la en détail.
787 LilyPond fait une distinction nette entre le contenu musical et la
788 mise en forme. L'altération d'une note --- @notation{bémol},
789 @notation{bécarre} ou @notation{dièse} --- fait partie de sa hauteur,
790 et relève donc du contenu musical. La gravure ou non d'une altération
791 accidentelle --- un @emph{signe} bémol, bécarre ou dièse --- devant la
792 note correspondante est une question qui relève de la mise en forme.
793 La gravure d'une partition suit des règles, en particulier des règles
794 d'indication des altérations accidentelles. Les hauteurs de note, en
795 revanche, relèvent de ce que vous voulez entendre ; et, dans la mesure
796 où la musique que vous entrez est censée être celle que vous voulez
797 entendre, LilyPond, qui n'est chargé que de la gravure, ne les
798 choisira pas à votre place.
802 @lilypond[verbatim,quote,relative=2]
808 aucune note n'a d'altération accidentelle, et pourtant vous devrez
809 entrer le @code{is} pour les notes @code{cis} et @code{fis}.
811 Le code @code{b} ne veut pas dire @qq{Imprimez-moi un point noir sur
812 la troisième ligne de la portée.} Cela signifie plutôt : @qq{Ici se
813 trouve une note dont la hauteur est un si naturel.} Avec une armure
814 de la bémol majeur, ce si est flanqué d'un bécarre accidentel :
816 @lilypond[verbatim,quote,relative=2]
821 Ajouter explicitement toutes les altérations demande un peu plus
822 d'effort dans la phase de saisie, mais cela facilite grandement la
823 @notation{transposition}. De plus, les altérations accidentelles
824 peuvent ainsi être imprimées suivant plusieurs conventions. Pour
825 connaître les différentes manières dont les altérations accidentelles
826 peuvent être imprimées, consultez @ruser{Automatic accidentals}.
830 Manuel de notation : @ruser{Note names in other languages},
831 @ruser{Accidentals}, @ruser{Automatic accidentals},
832 @ruser{Key signature}.
834 Glossaire musical : @rglos{Pitch names}.
838 @subsection Ties and slurs
840 @cindex liaisons de prolongation
841 @cindex liaisons de tenue
842 @cindex prolongation, liaisons de
843 @cindex durée, liaisons de
844 @cindex tenue, liaisons de
852 Glossaire musical : @rglos{tie}.
854 Pour créer une liaison de prolongation@footnote{parfois aussi appelée
855 liaison de tenue}, on ajoute un tilde @code{~} à la première note
858 @lilypond[verbatim,quote,relative=2]
863 @cindex liaisons d'articulation
864 @cindex articulation, liaisons d'
868 @c Le terme de "slur" a deux sens en français : articulation et phrasé.
869 @c Je garde ici le terme "legato", tel qu'il apparaît dans le texte original,
870 @c car c'est celui qui me semble le plus couramment employé.
871 @c slur = "il zon" (articulation). jcm
872 @c phrasing slur = "ils ont des chapeaux ronds" (phrase). jcm
874 Glossaire musical : @rglos{slur}, @rglos{phrasing}.
876 Une liaison d'articulation ou @emph{legato} peut englober
877 plusieurs notes. Les notes de départ et d'arrivée sont suivies
878 respectivement d'un signe @samp{(} et @samp{)}.
880 @lilypond[verbatim,quote,relative=2]
881 d4( c16) cis( d e c cis d) e( d4)
884 @cindex liaisons de phrasé
885 @cindex phrasé, liaisons de
887 @subheading Phrasing slurs
889 De plus longues liaisons, dites de phrasé, sont délimitées par @code{\(} et
890 @code{\)}. Il est possible d'avoir en même temps des legatos et des
891 phrasés, mais pas plusieurs liaisons de phrasé ou de @emph{legato} à la fois.
893 @lilypond[verbatim,quote,relative=2]
894 a8(\( ais b c) cis2 b'2 a4 cis,\)
899 @cindex liaisons d'articulation et de prolongation, différences
900 @subheading Warnings: slurs vs. ties
902 Glossaire musical : @rglos{articulation}, @rglos{slur}, @rglos{tie}.
904 Une liaison d'articulation ou de phrasé ressemble à une liaison de
905 prolongation, mais n'a pas la même signification. Alors qu'une
906 liaison de prolongation ne peut relier que deux notes de même hauteur,
907 le @emph{legato} indique une articulation de plusieurs notes,
908 éventuellement en grand nombre. Les liaisons de tenue peuvent être
909 enchâssées dans un @emph{legato} ou un phrasé.
911 @lilypond[verbatim,quote,relative=2]
912 c2~( c8 fis fis4 ~ fis2 g2)
917 Manuel de notation : @ruser{Ties}, @ruser{Slurs},
918 @ruser{Phrasing slurs}.
921 @node Articulation and dynamics
922 @subsection Articulation and dynamics
927 @subheading Articulations
929 Glossaire musical : @rglos{articulation}.
931 Des @notation{articulations} peuvent être ajoutées à une note, au moyen
932 d'un tiret @code{-} suivi d'un caractère :
934 @lilypond[verbatim,quote,relative=2]
935 c-. c-- c-> c-^ c-+ c-_
939 @subheading Fingerings
944 Glossaire musical : @rglos{fingering}.
946 De même, des indications de doigté peuvent être ajoutées à une note en
947 utilisant un tiret (@samp{-}) et le chiffre à écrire :
949 @lilypond[verbatim,quote,relative=2]
953 Articulations et doigtés sont habituellement placés automatiquement,
954 mais vous pouvez spécifier leur positionnement en utilisant @samp{^} (en
955 haut) ou @samp{_} (en bas). Vous pouvez aussi utiliser plusieurs
956 articulations sur la même note. Dans la plupart des cas, cependant,
957 il est bon de laisser LilyPond déterminer l'emplacement de
960 @lilypond[verbatim,quote,relative=2]
961 c_-^1 d^. f^4_2-> e^-_+
979 Glossaire musical : @rglos{dynamics}, @rglos{crescendo},
982 On obtient un signe de @notation{nuance} en ajoutant à la note les
983 lettres du signe, précédées d'un anti-slash @samp{\} :
985 @lilypond[verbatim,quote,relative=2]
993 @c Pluriel des termes musicaux italiens :
994 @c selon Littré, plutôt à la française (en "-os" qu'en "-i")
996 @notation{Crescendos} et @notation{decrescendos} débutent avec les
997 commandes @code{\<} et @code{\>}. Ils se terminent soit par une
998 nuance d'arrivée, par exemple @code{\f}, soit par la commande
1001 @lilypond[verbatim,quote,relative=2]
1002 c2\< c2\ff\> c2 c2\!
1007 Manuel de notation : @ruser{Articulations and ornamentations},
1008 @ruser{Fingering instructions}, @ruser{Dynamics}.
1012 @subsection Adding text
1014 @cindex texte, ajout de
1015 @cindex ajout de texte
1021 On peut ajouter du texte à une partition :
1023 @lilypond[verbatim,quote,relative=2]
1024 c1^"espr" a_"legato"
1027 Pour mettre en forme du texte, on utilise la commande @code{markup} :
1029 @lilypond[verbatim,quote,relative=2]
1030 c1^\markup{ \bold espr}
1032 \dynamic f \italic \small { 2nd } \hspace #0.1 \dynamic p
1038 Manuel de notation : @ruser{Writing text}.
1041 @node Automatic and manual beams
1042 @subsection Automatic and manual beams
1045 @cindex ligatures automatiques
1046 @cindex ligatures manuelles
1047 @cindex ligatures explicites
1052 @funindex \autoBeamOff
1053 @funindex autoBeamOff
1054 @funindex \autoBeamOn
1055 @funindex autoBeamOn
1057 Glossaire musical : @rglos{beam}.
1059 Toutes les barres de ligature sont dessinées automatiquement :
1061 @lilypond[verbatim,quote,relative=2]
1062 a8 ais d ees r d c16 b a8
1066 Lorsqu'on n'aime pas la manière dont les notes sont automatiquement
1067 groupées, il est possible de les ligaturer manuellement, en marquant la
1068 première note à attacher d'un crochet ouvrant @code{[} et la dernière
1069 d'un crochet fermant @code{]}.
1071 @lilypond[verbatim,quote,relative=2]
1072 a8[ ais] d[ ees r d] a b
1075 Pour désactiver les barres de ligature automatiques pour des passages
1076 entiers, utilisez la commande @code{\autoBeamOff}, et utilisez
1077 @code{\autoBeamOn} pour les réactiver.
1079 @lilypond[verbatim,quote,relative=2]
1088 Manuel de notation : @ruser{Automatic beams}, @ruser{Manual beams}.
1091 @node Advanced rhythmic commands
1092 @subsection Advanced rhythmic commands
1094 @subheading Partial measure
1098 @cindex mesure incomplète
1103 Glossaire musical : @rglos{anacrusis}.
1105 On crée une levée (ou anacrouse) avec la commande @code{\partial},
1106 suivie d'une durée : @code{\partial 4} produit une levée d'une noire
1107 et @code{\partial 8} d'une croche.
1109 @lilypond[verbatim,quote,relative=2]
1122 Glossaire musical : @rglos{note value}, @rglos{triplet}.
1124 Les @notation{nolets} sont créés avec la commande @code{\times}, qui
1125 prend deux arguments : une fraction et une expression musicale. La
1126 durée des notes de l'expression musicale est multipliée par la
1127 fraction. Par exemple les notes d'un @notation{triolet} durent les
1128 deux tiers de la durée de leur notation réelle, cette fraction est
1129 donc de 2/3 pour les triolets :
1131 @lilypond[verbatim,quote,relative=2]
1132 \times 2/3 { f8 g a }
1133 \times 2/3 { c r c }
1134 \times 2/3 { f,8 g16[ a g a] }
1135 \times 2/3 { d4 a8 }
1138 @subheading Grace notes
1140 @cindex notes d'ornement
1141 @cindex ornementation
1142 @cindex appoggiature
1143 @cindex acciaccature
1147 @funindex \acciaccatura
1148 @funindex acciaccatura
1149 @funindex \appoggiatura
1150 @funindex acciaccatura
1152 Glossaire musical : @rglos{grace notes}, @rglos{acciaccatura},
1153 @rglos{appoggiatura}.
1155 Des @notation{notes d'ornement} s'obtiennent en appliquant la commande
1156 @code{\grace}, @code{\appoggiatura} ou @code{\acciaccatura} à une
1157 expression musicale :
1159 @lilypond[verbatim,quote,relative=2]
1160 c2 \grace { a32[ b] } c2
1161 c2 \appoggiatura b16 c2
1162 c2 \acciaccatura b16 c2
1167 Manuel de notation : @ruser{Grace notes}, @ruser{Tuplets},
1171 @node Multiple notes at once
1172 @section Multiple notes at once
1174 Cette section traite de situations où l'on a plus d'une note à la fois :
1175 plusieurs instruments, plusieurs voix ou portées pour un même
1176 instrument (le piano, par exemple), et les accords.
1178 En théorie musicale, la polyphonie désigne une musique constituée de
1179 plusieurs voix ; dans LilyPond, ce terme désigne les situations où il
1180 y a plus d'une voix sur une même portée.
1183 * Music expressions explained::
1186 * Combining notes into chords::
1187 * Single staff polyphony::
1191 @node Music expressions explained
1192 @subsection Music expressions explained
1194 @cindex expression musicale
1196 Dans les fichiers source LilyPond, la musique est représentée par ce
1197 qu'on appelle des @emph{expressions musicales}. En soi, une seule note
1198 peut constituer une expression musicale :
1200 @lilypond[verbatim,quote,relative=2]
1204 Mettre un groupe de notes entre accolades crée une nouvelle expression
1205 musicale, appelée @emph{expression musicale composée}. En voici un
1206 exemple avec deux notes :
1208 @lilypond[verbatim,quote,relative=2]
1212 La mise entre accolades d'une séquence d'expressions musicales --- des
1213 notes par exemple --- signifie qu'elles doivent être jouées
1214 successivement, les unes après les autres. Le résultat est une
1215 expression, qui peut elle-même être regroupée séquentiellement avec
1216 d'autres expressions. Ici, l'expression de l'exemple précédent est
1217 combinée à deux notes :
1219 @lilypond[verbatim,quote,relative=2]
1223 @subheading Analogy: mathematical expressions
1227 Ce mécanisme est similaire aux formules mathématiques : une grosse
1228 formule est créée en assemblant plusieurs petites formules. De telles
1229 formules sont appelées expressions, elles ont une définition
1230 récursive, de telle sorte que vous pouvez fabriquer des expressions
1231 arbitrairement longues et complexes. Par exemple :
1240 ((1 + 2) * 3) / (4 * 5)
1243 Ceci est une suite d'expressions, où chacune est contenue dans la
1244 suivante. Les expressions les plus simples sont les nombres, et de
1245 plus grandes expressions sont produites en combinant des expressions
1246 avec des opérateurs --- comme @samp{+}, @samp{*} et @samp{/} --- et
1247 des parenthèses. Tout comme les expressions mathématiques, les
1248 expressions musicales peuvent être imbriquées avec une profondeur
1249 arbitraire, ce qui est nécessaire pour des partitions complexes comme
1250 de la musique polyphonique.
1253 @subheading Simultaneous music expressions: multiple staves
1255 @cindex portées multiples
1257 @cindex combinaison d'expressions en parallèle
1258 @cindex parallèles, expressions
1259 @cindex expressions parallèles
1260 @cindex hauteur relative et musique simultanée
1261 @cindex musique simultanée et hauteur relative
1262 @cindex hauteur relative et expressions parallèles
1263 @cindex expressions parallèles et hauteur relative
1269 Glossaire musical : @rglos{polyphony}.
1271 Cette technique est utile pour de la musique @notation{polyphonique}.
1272 Pour entrer une musique avec plusieurs voix ou plusieurs portées, nous
1273 pouvons aussi combiner @emph{en parallèle} les expressions : deux voix
1274 qui doivent être jouées en même temps, sont entrées comme une
1275 combinaison simultanée de deux expressions. Une expression musicale
1276 @qq{simultanée} est formée en entourant les expressions entre @code{<<}
1277 et @code{>>}. Dans l'exemple suivant, trois expressions (contenant
1278 chacune deux notes distinctes) sont combinées simultanément.
1280 @lilypond[verbatim,quote]
1290 Notez que nous avons ici indenté chaque niveau du fichier d'entrée
1291 avec un nombre d'espaces différent. LilyPond se moque --- ou presque
1292 --- de l'espace qu'il peut y avoir ou non au début d'une ligne, mais
1293 un code bien indenté est bien plus lisible par des humains.
1295 @warning{la hauteur de chaque note saisie est relative à la précédente,
1296 mais pas au @code{c''} de la commande @code{\relative} de départ.}
1299 @subheading Simultaneous music expressions: single staff
1301 Pour déterminer le nombre de portées, LilyPond regarde le début
1302 de la première expression. Si c'est une seule note, une seule portée
1303 est produite ; si c'est une expression simultanée, plusieurs portées
1306 @lilypond[verbatim,quote]
1309 << { e f } { c <<b d>> } >>
1314 @node Multiple staves
1315 @subsection Multiple staves
1317 @cindex multiples portées
1318 @cindex portées multiples
1320 @cindex contexte de notation
1321 @cindex notation, contexte
1323 @funindex \new Staff
1331 @funindex ChordNames
1333 Comme nous l'avons vu dans @ref{Music expressions explained}, un
1334 fichier d'entrée LilyPond est fait d'expressions musicales. Si la
1335 partition commence par plusieurs expressions simultanées, LilyPond
1336 créera plusieurs portées. Cependant, il est plus facile de prévoir le
1337 nombre de portées si on les crée explicitement, ce que nous allons
1340 Pour créer plus d'une portée, on ajoute @code{\new Staff} au début de
1341 chaque partie de la musique constituant une portée. Ces éléments
1342 @code{Staff} sont ensuite combinés en parallèle avec @code{<<} et
1343 @code{>>}, comme ci-dessous.
1345 @lilypond[verbatim,quote]
1348 \new Staff { \clef treble c }
1349 \new Staff { \clef bass c,, }
1355 La commande @code{\new} introduit un @qq{contexte de notation}. Un
1356 contexte de notation est un environnement dans lequel les événements
1357 musicaux --- comme les notes ou les commandes @code{\clef} --- sont
1358 interprétés. Pour des pièces simples, ces contextes sont créés
1359 automatiquement. Pour des pièces plus complexes, il est préférable de
1360 spécifier explicitement les contextes, afin de s'assurer que chaque
1361 fragment aura sa propre portée.
1363 Il existe différents types de contextes. Les contextes @code{Score}
1364 (partition), @code{Staff} (portée) et @code{Voice} (voix) gèrent la
1365 notation de la mélodie, alors que @code{Lyrics} gère les paroles et
1366 @code{ChordNames} imprime des noms d'accords.
1368 En termes de syntaxe, ajouter @code{\new} devant une expression
1369 musicale crée une plus grande expression musicale. En reprenant la
1370 comparaison précédente, cela ressemble au signe @emph{moins} en
1371 mathématiques. La formule @math{(4+5)} est une expression, donc
1372 @math{-(4+5)} est une plus grande expression.
1374 Les chiffres de métrique indiqués sur une portée affectent toutes les
1375 autres portées@footnote{Ce comportement peut être modifié si
1376 nécessaire, voir @ruser{Polymetric notation}}. En revanche l'armure
1377 d'une portée n'affecte @emph{pas} les autres portées. Ces
1378 caractéristiques par défaut se justifient par le fait que
1379 l'utilisation d'instruments transpositeurs est bien plus fréquente que
1380 la musique polyrythmique.
1382 @lilypond[verbatim,quote]
1385 \new Staff { \clef treble \key d \major \time 3/4 c }
1386 \new Staff { \clef bass c,, }
1393 @subsection Staff groups
1395 @cindex portée double
1396 @cindex portée pour piano
1397 @cindex piano, portée pour
1398 @cindex clavier, portée pour
1399 @cindex chœur, système pour
1400 @cindex système pour chœur
1402 @cindex portées, regroupement de
1403 @cindex regroupement de portées
1405 @funindex PianoStaff
1406 @funindex GrandStaff
1407 @funindex ChoirStaff
1409 Glossaire musical : @rglos{brace}.
1411 La musique pour piano s'écrit sur deux portées reliées par une
1412 @notation{accolade}. La gravure de ce type de portée est semblable à
1413 l'exemple de musique polyphonique de @ref{Multiple staves}, mais
1414 maintenant cette expression entière est interprétée dans un contexte
1424 Voici un bref exemple :
1426 @lilypond[verbatim,quote]
1429 \new Staff { \time 2/4 c4 e g g, }
1430 \new Staff { \clef bass c,, c' e c }
1437 Manuel de notation : @ruser{Keyboard and other multi-staff instruments},
1438 @ruser{Displaying staves}.
1441 @node Combining notes into chords
1442 @subsection Combining notes into chords
1444 @cindex accords, notes simultanées
1445 @cindex accords et durée
1451 Glossaire musical : @rglos{chord}.
1453 Nous avons vu précédemment comment combiner des notes simultanément,
1454 en les encadrant par des angles doubles @code{<<} et @code{>>}. Pour
1455 produire des accords simples, c'est-à-dire une superposition de notes
1456 de même durée, on encadre les hauteurs de notes par des angles simples
1457 @code{<} et @code{>}, et on écrit la durée juste après.
1459 @lilypond[verbatim,quote,relative=2]
1460 r4 <c e g>4 <c f a>2
1463 Beaucoup d'éléments de notation que l'on peut attacher à une note
1464 simple, comme une liaison, un crochet indiquant un début ou une fin de
1465 lien, un signe d'articulation, peuvent être également attachés à un
1466 accord : il faut ajouter ces indications après les hauteurs et la
1467 durée, donc @emph{à l'extérieur} des angles.
1469 @lilypond[verbatim,quote,relative=2]
1470 r4 <c e g>8[ <c f a>]~ <c f a>2
1471 r4 <c e g>8( <c e g>\> <c e g>4 <c f a>\!)
1475 @node Single staff polyphony
1476 @subsection Single staff polyphony
1479 @cindex voix multiples sur une portée
1480 @cindex silence invisible
1481 @cindex invisible, silence
1483 @funindex << ... \\ ... >>
1488 Quand différentes lignes mélodiques sont combinées sur une seule et même
1489 portée, elles sont imprimées comme des voix polyphoniques ; chaque voix
1490 a ses propre hampes@footnote{familièrement appelées queues de note.},
1491 liaisons et ligatures, la voix supérieure ayant les hampes vers le haut,
1492 la voix inférieure vers le bas.
1494 On réalise ce type de partition en entrant chaque voix comme une
1495 séquence, autrement dit avec @code{@{...@}}, puis en combinant
1496 simultanément les voix et en les séparant par @code{\\}.
1498 @lilypond[verbatim,quote,relative=2]
1505 Pour l'écriture de musique polyphonique, les silences invisibles
1506 s'avèrent bien pratiques : ce sont des silences qui ne s'impriment pas.
1507 Ils sont utiles pour remplir des voix qui, temporairement, ne jouent
1508 rien. Voici le même exemple que ci-dessus, avec un silence invisible
1509 @code{s} (pour @emph{skip}) à la place d'un silence normal @code{r} :
1511 @lilypond[verbatim,quote,relative=2]
1519 Là encore, ces expressions peuvent s'imbriquer arbitrairement :
1521 @lilypond[verbatim,quote,relative=2]
1529 { <c g>1 ~ <c g>4 } \\
1537 Manuel de notation : @ruser{Simultaneous notes}.
1543 Cette section présente l'écriture vocale et les partitions de variété.
1546 * Setting simple songs::
1547 * Aligning lyrics to a melody::
1548 * Lyrics to multiple staves::
1552 @node Setting simple songs
1553 @subsection Setting simple songs
1558 @funindex \addlyrics
1561 Glossaire musical : @rglos{lyrics}.
1563 Prenons une mélodie toute simple, la comptine @emph{Girls and boys
1566 @lilypond[verbatim,quote]
1570 d4 b8 c4 a8 d4 b8 g4
1574 Des @notation{paroles} peuvent être associées à ces notes, en les
1575 combinant avec la commande @code{\addlyrics}. On entre les paroles en
1576 séparant chaque syllable par un espace :
1578 @lilypond[verbatim,quote]
1583 d4 b8 c4 a8 d4 b8 g4
1586 Girls and boys come out to play,
1591 Remarquez les accolades embrassant la musique et celles embrassant les
1592 paroles, ainsi que les angles doubles encadrant toute la pièce ; ces
1593 derniers indiquent simplement que la musique et les paroles se
1594 produisent en même temps.
1597 @node Aligning lyrics to a melody
1598 @subsection Aligning lyrics to a melody
1601 @cindex ligne d'extension
1602 @cindex trait d'union (paroles)
1603 @cindex caractère souligné (paroles)
1604 @cindex paroles, alignement des
1605 @cindex alignement des paroles
1606 @cindex paroles, mot de plusieurs syllabes
1608 Glossaire musical : @rglos{melisma}, @rglos{extender line}.
1610 La ligne suivante de la comptine précédente est @emph{The moon doth
1611 shine as bright as day}. Ajoutons-la au code.
1613 @lilypond[verbatim,quote]
1618 d4 b8 c4 a8 d4 b8 g4
1619 g8 a4 b8 c b a d4 b8 g4.
1622 Girls and boys come out to play,
1623 The moon doth shine as bright as day;
1628 Remarquez que les paroles ajoutées ne s'alignent pas bien avec les
1629 notes. Le mot @emph{shine} devrait être chanté sur deux notes au lieu
1630 d'une. On appelle ceci un @notation{mélisme} : il s'agit d'une seule
1631 syllabe chantée sur plus d'une note. Il existe plusieurs façons
1632 d'étaler une sylabe sur plusieurs notes, la plus simple étant de lier
1633 les notes du mélisme. Pour les détails, consultez @ref{Ties and
1636 @lilypond[verbatim,quote]
1641 d4 b8 c4 a8 d4 b8 g4
1642 g8 a4 b8 c( b) a d4 b8 g4.
1645 Girls and boys come out to play,
1646 The moon doth shine as bright as day;
1651 Les paroles sont maintenant correctement alignées, mais les liens de
1652 croche automatiques ne conviennent pas pour les notes au-dessus de
1653 @emph{shine as}. On peut les corriger en ajoutant des liens de croche
1654 manuels, pour ceci consultez @ref{Automatic and manual beams}.
1656 @lilypond[verbatim,quote]
1661 d4 b8 c4 a8 d4 b8 g4
1662 g8 a4 b8 c([ b]) a d4 b8 g4.
1665 Girls and boys come out to play,
1666 The moon doth shine as bright as day;
1671 Au lieu d'utiliser une liaison, on peut indiquer le mélisme dans les
1672 paroles en insérant un caractère souligné @code{_} pour chaque note du
1673 mélisme sauf la première.
1675 @lilypond[verbatim,quote]
1680 d4 b8 c4 a8 d4 b8 g4
1681 g8 a4 b8 c[ b] a d4 b8 g4.
1684 Girls and boys come out to play,
1685 The moon doth shine _ as bright as day;
1690 Si une syllabe s'étend sur un grand nombre de notes ou une note très
1691 longue, on représente souvent le mélisme par un @notation{trait de
1692 prolongation}, qu'on entre avec @code{__}. L'exemple suivant montre
1693 les trois premières mesures de la plainte de Didon, extraite de
1694 @emph{Didon et Énée} de Purcell.
1696 @lilypond[verbatim,quote]
1702 b c4.( bes8 a4. g8 fis4.) g8 fis1
1706 am laid __ in earth,
1711 Aucun exemple jusqu'à présent n'a utilisé de mots de plus d'une
1712 syllabe. Dans des paroles, de tels mots sont écrits en syllabes
1713 séparées par des traits d'union. Avec LilyPond, on utilise deux
1714 tirets pour produire un trait d'union centré entre deux syllabes.
1715 L'exemple suivant montre tout ce que nous avons vu jusqu'à maintenant
1716 sur l'alignement de paroles à une mélodie.
1718 @c no ragged-right here because otherwise the hyphens get lost,
1719 @c but the example is long enough to avoid looking strange.
1720 @lilypond[verbatim,quote,noragged-right]
1726 d4 g4 g a8( b) g4 g4
1730 A -- way in a __ man -- ger,
1731 no __ crib for a bed, __
1736 Avec certaines paroles, en particulier en italien, il se produit la
1737 situation inverse : il peut y avoir plusieurs syllabes sur une seule
1738 note. On réalise ceci avec LilyPond grâce à un caractère souligné
1739 @code{_} sans espace entre les syllabes, ou alors en groupant les
1740 syllabes avec des guillemets. L'exemple suivant est extrait de l'air
1741 de Figaro @emph{Largo al factotum}, dans @emph{Figaro} de Rossini, où
1742 la syllabe @emph{al} est chantée sur la même note que @emph{go}.
1744 @c no ragged-right here because otherwise the hyphens get lost,
1745 @c but the example is long enough to avoid looking strange.
1746 @lilypond[verbatim,quote,noragged-right]
1752 c4.~ c8 d b c([ d]) b c d b c
1755 Lar -- go_al fac -- to -- tum del -- la cit -- tà
1762 Manuel de notation : @ruser{Vocal music}.
1765 @node Lyrics to multiple staves
1766 @subsection Lyrics to multiple staves
1768 @cindex paroles et portées mutiples
1769 @cindex portées multiples et paroles
1771 La méthode simple d'ajout de paroles avec @code{\addlyrics} peut être
1772 également utilisée pour placer des paroles sous plusieurs portées.
1773 L'exemple suivant est extrait de @emph{Judas Macchabée} de Händel.
1775 @lilypond[verbatim,quote]
1781 c8 c([ bes]) a a([ g]) f f'4. b, c4.~ c4
1784 Let flee -- cy flocks the hills a -- dorn, __
1790 r8 r4. r4 c8 a'([ g]) f f([ e]) d e([ d]) c bes'4
1793 Let flee -- cy flocks the hills a -- dorn,
1798 Pour produire des partitions plus complexes ou plus longues que cet
1799 exemple simple, il est vivement conseillé de séparer la structure de
1800 la partition des notes et paroles, grâce à des variables. Ceci sera
1801 détaillé plus loin dans @ref{Organizing pieces with variables}.
1805 Manuel de notation : @ruser{Vocal music}.
1809 @section Final touches
1811 L'ultime section de ce tutoriel montre comment ajouter une touche
1812 finale à des morceaux simples, et constitue une introduction au reste
1816 * Organizing pieces with variables::
1819 * Absolute note names::
1820 * After the tutorial::
1824 @node Organizing pieces with variables
1825 @subsection Organizing pieces with variables
1828 @cindex variables, definition
1829 @cindex identificateurs
1831 @cindex assignation de variables
1832 @cindex utilisation de variables
1833 @cindex variables, utilisation de
1834 @cindex variables, caractères autorisés dans les
1835 @cindex caractères autorisés dans les variables
1837 Lorsque l'on combine tous les éléments étudiés précédemment pour
1838 écrire des partitions plus longues, les expressions musicales prennent
1839 de l'ampleur et, dans le cas des pièces polyphoniques, deviennent
1840 profondément imbriquées, jusqu'au point où il devient difficile de se
1841 repérer dans le fichier source. Cet inconvénient peut être résolu par
1842 l'utilisation de @emph{variables}.
1844 En utilisant des variables, parfois appelées identificateurs ou
1845 macros, on peut scinder des expressions musicales complexes en des
1846 expressions plus simples. Une variable se définit comme suit :
1849 musiqueToto = @{ @dots{} @}
1852 Le contenu de l'expression musicale @code{musiqueToto} pourra être
1853 utilisé plus loin en faisant précéder son nom d'un anti-slash,
1854 c'est-à-dire @code{\musiqueToto}, tout comme n'importe quelle commande
1855 LilyPond. Toute variable doit être définie @emph{avant} son
1856 utilisation dans une autre expression musicale.
1858 @lilypond[verbatim,quote]
1859 violin = \new Staff {
1864 cello = \new Staff {
1879 Le nom d'une variable ne doit comporter que des caractères
1880 alphabétiques non accentués, aucun nombre ni tiret ne sont autorisés.
1882 On peut utiliser une variable déjà définie autant de fois que l'on
1883 veut, y compris dans la définition d'une nouvelle variable ; par
1884 exemple, cela peut servir à saisir un motif qu'une seule fois, même
1885 s'il se répète un grand nombre de fois dans la pièce.
1887 @lilypond[verbatim,quote]
1888 tripletA = \times 2/3 { c,8 e g }
1889 barA = { \tripletA \tripletA \tripletA \tripletA }
1896 Il est possible d'utiliser des variables de types variés. Par exemple,
1901 aFivePaper = \paper @{ paperheight = 21.0 \cm @}
1904 En fonction de son contenu, un identificateur peut être utilisé à
1905 différents endroits. L'exemple suivant utilise les variable définies
1917 @node Version number
1918 @subsection Version number
1922 @cindex numéro de version
1923 @cindex version, numéro de
1925 @cindex future mise à jour
1926 @cindex mise à jour de fichiers
1927 @cindex fichiers, mise à jour de
1931 @funindex convert-ly
1933 La déclaration @code{\version} stipule le numéro de la version de
1934 LilyPond pour laquelle le fichier a été écrit :
1937 \version @w{"@version{}"}
1941 Par convention, on place cette instruction en début de fichier.
1943 Cette instruction permet de faciliter les mises à jour futures de
1944 LilyPond. Les changements de syntaxe au fil des versions sont gérés
1945 avec un programme dédié, @command{convert-ly}, qui utilise la valeur
1946 de @code{\version} pour déterminer les règles de conversion à
1947 appliquer au fichier source. Pour plus d'informations, consultez
1948 @rprogram{Updating files with convert-ly}.
1952 @subsection Adding titles
1956 @cindex bloc d'en-tête
1961 On indique les informations bibliographiques --- nom du morceau, du
1962 compositeur, numéro d'opus@dots{} --- dans un bloc à part, le bloc
1963 d'en-tête @code{\header}, qui existe indépendamment de l'expression
1964 musicale principale. Le bloc @code{\header} est habituellement placé
1965 en début de fichier, après le numéro de version.
1968 \version @w{"@version{}"}
1976 @dots{} la musique @dots{}
1980 Quand LilyPond traite le fichier, le titre et le compositeur sont
1981 imprimés au début de la partition. Vous trouverez plus d'informations
1982 sur les titres à la section @ruser{Creating titles}.
1985 @node Absolute note names
1986 @subsection Absolute note names
1988 @cindex notes, nom des
1989 @cindex absolu, mode
1991 @cindex hauteurs, valeurs absolues
1992 @cindex noms de note absolus
1994 Jusqu'ici nous n'avons utilisé que le mode @code{\relative} pour
1995 définir les hauteurs de notes. Si c'est souvent le moyen le plus
1996 simple de saisir la musique au clavier, il existe une autre façon de
1997 procéder : le mode de hauteurs absolues.
1999 Si vous omettez la commande @code{\relative}, LilyPond considérera
2000 toutes les hauteurs comme des hauteurs absolues. Un @code{c'} désigne
2001 toujours le do central, un @code{b} se situe une seconde en dessous
2002 du do central, et un @code{g,} est situé sur la première ligne de
2003 la portée en clé de fa.
2005 @lilypond[verbatim,quote]
2013 Voici une gamme sur 4 octaves :
2015 @lilypond[verbatim,quote]
2030 Comme vous pouvez le voir, il faut beaucoup d'apostrophes pour écrire
2031 de la musique dans un registre aigu, comme le montre cet extrait de
2034 @lilypond[verbatim,quote]
2038 cis''8. d''16 cis''8 e''4 e''8
2039 b'8. cis''16 b'8 d''4 d''8
2043 Toutes ces apostrophes rendent le fichier moins lisible, et surtout il
2044 est très probable d'oublier au moins une apostrophe au cours de la
2045 frappe. En mode @code{\relative}, le même exemple devient bien plus
2046 facile à lire et à saisir.
2048 @lilypond[verbatim,quote]
2052 cis8. d16 cis8 e4 e8
2057 Si d'aventure vous faites une erreur d'octaviation, le mode
2058 @code{\relative} la mettra en évidence : toutes les notes suivantes
2059 seront placées à la mauvaise octave. En mode de hauteurs absolues,
2060 une erreur isolée ne serait pas autant visible, et serait donc plus
2061 difficile à dénicher.
2063 Cependant, le mode de hauteurs absolues reste utile pour les musiques
2064 où les intervalles sont étendus, et plus encore pour les fichiers
2065 LilyPond créés par des programmes.
2068 @node After the tutorial
2069 @subsection After the tutorial
2071 Après avoir parcouru ce tutoriel, vous devriez essayer d'écrire un
2072 morceau ou deux. Commencez par copier l'un des modèles types et
2073 ajoutez-y des notes --- consultez les @ref{Templates}. Si vous voulez
2074 employer une notation que vous n'avez pas trouvé dans le tutoriel,
2075 consultez le manuel de notation, en commençant par la @ruser{Musical
2076 notation}. Si vous désirez écrire pour un ensemble instrumental non
2077 couvert par les modèles, lisez la section @ref{Extending the
2080 Après avoir écrit quelques pièces courtes, lisez les chapitres 3 à 5
2081 du manuel d'initiation. Rien ne s'oppose à ce que vous consultiez dès
2082 à présent ces chapitres, bien sûr ! Néanmoins, le reste du manuel
2083 d'initiation part du principe que vous avez déjà bien assimilé la
2084 syntaxe de base de LilyPond. Vous pouvez toujours survoler ces
2085 chapitres 3 à 5, et y revenir plus tard après avoir acquis de
2088 Dans ce tutoriel comme dans le reste de ce manuel, se trouve à chaque
2089 section un paragraphe @strong{Voir aussi} contenant des références
2090 vers d'autres sections : il est conseillé de ne pas les suivre en
2091 première lecture ; lorsque vous aurez lu l'ensemble du manuel
2092 d'initiation, vous pourrez en relisant certaines sections suivre ces
2093 références pour approfondir certains aspects.
2095 Si vous ne l'avez pas encore fait, lisez @ref{About the
2096 documentation}. Les sources de documentation et d'information sur
2097 LilyPond sont vastes, il est normal pour un débutant de ne pas savoir
2098 où chercher ; si vous passez quelques minutes à lire attentivement
2099 cette section, vous vous épargnerez certainement la frustration causée
2100 par des heures de recherches infructueuses.