1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
2 @c This file is part of lilypond.tely
5 @c * more details about running lilypond; error messages,
6 @c compiling/viewing (emacs?)
7 @c * where to go from First steps+More basics?
9 @c wherever possible, do not include index entries here; the
10 @c index should point to stuff in the reference manual. -gp
12 @c Your first LilyPond score in 10 minutes?
17 Ce tutoriel commence par une courte introduction au langage utilisé
18 par LilyPond pour représenter la musique. Après ce premier contact,
19 nous verrons comment produire une partition à imprimer. Vous serez
20 alors capable de créer et d'imprimer vos propres partitions.
23 Beaucoup de gens apprennent à utiliser les programmes en les essayant
24 et en bidouillant avec. C'est également possible avec LilyPond. Si
25 vous cliquez sur une image dans la version HTML de ce manuel, vous
26 verrez exactement le code LilyPond utilisé pour générer cette image.
27 Essayez sur cette image
29 @lilypond[fragment,quote,ragged-right,relative=2]
30 c-\markup { \bold \huge { Click here. } }
34 En copiant et en collant l'intégralité du code dans un fichier test,
35 vous aurez un modèle comme base pour expérimenter. Si vous
36 apprenez de cette façon, vous aurez probablement envie d'imprimer ou
41 @ref{Cheat sheet}, tableau qui répertorie les commandes usuelles
42 pour une consultation rapide.
46 * Running LilyPond for the first time::
47 * More about pitches::
49 * Automatic and manual beams::
51 * Music expressions explained::
53 * Adding articulation marks to notes::
54 * Combining notes into chords::
55 * Advanced rhythmic commands::
56 * Commenting input files::
60 * Single staff polyphony::
62 * Organizing larger pieces::
63 * An orchestral part::
64 * After the tutorial::
71 Le premier exemple montre comment écrire la partition la plus
72 élémentaire qui soit, une gamme (@rglos{scale}). Une @rglos{note} peut
73 être entrée en tapant son nom, de @samp{a} à @samp{g}. Donc si vous
83 le résultat ressemblera à
85 @lilypond[fragment,quote,notime,relative=1]
90 Il est aussi possible d'utiliser les noms de notes français @samp{do
91 re mi fa sol la si}, en insérant au début du fichier la ligne
92 @samp{\include "catalan.ly"}
95 Tout extrait de code LilyPond doit être entouré d'une @{paire
96 d'accolades@}. Bien que la plupart des exemples de ce manuel n'en
97 comportent pas, ne les oubliez pas dans vos compositions !
99 De plus, de nombreux exemples utilisent le mode @code{relative}. Ceci
100 est expliqué à la section @ref{Octave entry} ; sachez dès à présent
101 que certains exemples devraient être libellés sous la forme
102 @code{\relative @{ @emph{...musique...} @}}.
103 De nombreux exemples ont aussi été compressés horizontalement pour
104 économiser de la place, grace à la commande
105 @code{\paper @{ragged-right = ##t @}}.
107 @cindex Case sensitive
108 Enfin, LilyPond est sensible à la casse. @code{ @{ c d e @} } est
109 un code valide ; @code{ @{ C D E @} } produira un message d'erreur.
111 La durée (@rglos{duration}) d'une note est spécifiée par un nombre
112 qui suit le nom de cette note : @samp{1} pour une ronde (@rglos{whole
113 note}), @samp{2} pour une blanche (@rglos{half note}), @samp{4} pour
114 une noire (@rglos{quarter note}) et ainsi de suite.
120 @lilypond[fragment,quote,notime,relative=2]
121 \set Staff.autoBeaming = ##f
122 { a1 a2 a4 a16 a32 s16_" " }
125 Si aucune durée n'est spécifiée, la dernière durée entrée est utilisée
126 pour les notes suivantes. La valeur implicite de la première note
127 dans les fichiers sources de la partition est la noire :
133 @lilypond[fragment,quote,notime,relative=2]
134 { a a8 a a2 a s16_" " }
138 On saisit un silence (@rglos{rest}) tout comme une note, mais avec le
145 @lilypond[fragment,quote,notime]
149 Ajouter un point @samp{.} après une durée permet d'obtenir une note
150 pointée (@rglos{dotted note})
156 @lilypond[fragment,quote,notime,relative=1]
157 { a2. a4 a8. a16 s16_" " }
160 La métrique (@rglos{time signature}) est définie par
161 la commande @code{\time}
169 @c A clef here may lead to confusion, remove it.
170 @lilypond[fragment,quote]
171 \override Staff.Clef #'transparent = ##t
180 La @rglos{clef} est définie par la commande @code{\clef}
189 @lilypond[fragment,quote,notime]
200 Pensez bien à encadrer les notes et les commandes avec des accolades
201 @code{@{@tie{}@dots{}@tie{}@}} pour pouvoir obtenir un résultat
204 @lilypond[fragment,quote,noindent,verbatim]
211 Pour plus d'informations sur
215 @item la définition des hauteurs et des durées
217 @ref{Pitches}, et @ref{Durations}.
222 @item la métrique et autres commandes liées au temps
223 voir @ref{Time signature}.
228 @node Running LilyPond for the first time
229 @section Running LilyPond for the first time
231 @c cheesy title to avoid clash with chapter name.
233 Dans la section précédente, nous avons vu quelles sortes d'éléments
234 peut contenir un fichier LilyPond. Dans cette section nous
235 expliquerons quelles commandes exécuter et comment voir ou imprimer le
236 résultat de LilyPond. Si vous n'avez jamais utilisé
237 LilyPond, voulez tester votre installation ou souhaitez compiler
238 vous-même un fichier d'exemple, lisez cette section.
240 @unnumberedsubsec MacOS X
242 Si vous double-cliquez sur LilyPond.app, un fichier d'exemple sera
243 ouvert. Sauvegardez-le, par exemple, sous @file{test.ly} sur votre
244 bureau, et traitez-le ensuite avec la commande du menu
245 @samp{Compile > Typeset File}.
246 Le fichier PDF résultant est alors affiché sur votre écran.
248 Prenez note que le premier démarrage prend une minute ou deux ,
249 car toutes les polices systèmes doivent être d'abord analysées.
251 @unnumberedsubsec Windows
253 Sous Windows, démarrez un éditeur de texte @footnote{N'importe quel
254 éditeur simple ou orienté programmation, qui prend en charge le
255 codage de caractères UTF-8, fera l'affaire, par exemple
256 Notepad. N'utilisez pas de traitement de texte car ceux-ci insèrent
257 des codes de formatage qui posent problème à LilyPond.} et saisissez
263 Enregistrez le sur le bureau sous @file{test.ly} et vérifiez bien
264 qu'il ne s'appelle pas @file{test.ly.TXT}. Double-cliquez sur le
265 fichier @file{test.ly} pour le traiter et afficher le fichier
269 @unnumberedsubsec Unix
271 Commencez par ouvrir une fenêtre de terminal et un éditeur de
272 texte. Par exemple, vous pouvez ouvrir un xterm et exécuter
273 @code{joe}. @footnote{Des fichiers de macros pour les fans de VIM et un
274 @code{LilyPond-mode} pour les fans d'Emacs existent. S'ils ne sont pas
275 encore installés, consultez le fichier @file{INSTALL.txt}.} Dans votre
276 éditeur, entrez le texte suivant et sauvegardez le fichier sous
284 Pour traiter @file{test.ly}, procédez comme ceci :
291 Vous verrez quelque chose ressemblant à :
298 Interpreting music... [1]
299 Preprocessing graphical objects...
300 Calculating line breaks... [2]
301 Layout output to `test.ps'...
302 Converting to `test.pdf'...
306 Suivant votre installation, les messages peuvent être traduits.
310 @cindex Viewing music
313 Le résultat est le fichier @file{test.pdf} que vous pouvez imprimer ou
314 visualiser avec les outils standards de votre système d'exploitation.
315 @footnote{Si votre système ne dispose pas des outils nécessaires,
317 @uref{http://@/www@/.cs@/.wisc@/.edu/@/~ghost/,Ghostscript}, un
318 programme pour voir et imprimer les fichiers PDF et PostScript.}
320 @node More about pitches
321 @section More about pitches
323 Un dièse (@rglos{sharp}) s'obtient en ajoutant @samp{is} au nom de la
324 note, un bémol (@rglos{flat}) en ajoutant @samp{es}. Comme vous pouvez
325 vous y attendre, un double dièse ou double bémol est obtenu en
326 ajoutant @samp{isis} ou @samp{eses}@footnote{Cette syntaxe est dérivée
327 de la convention de dénomination des notes dans les langues nordiques
328 et germaniques, comme l'allemand ou le hollandais.}.
331 Si vous utilisez la commande @samp{\include "catalan.ly"} pour entrer
332 les noms de notes français au lieu des noms hollandais, il faudra
333 ajouter un @samp{d} pour un dièse, et un @samp{b} pour un bèmol. Le
334 double dièse et le double bémol s'obtiennent en ajoutant
335 respectivement @samp{dd} et @samp{bb}
342 @lilypond[fragment,quote,notime]
343 \set Score.timing = ##f
344 \transpose c c' { cis1 ees fisis aeses s16_" " }
347 @cindex key signature, setting
348 L'armure est déterminée par la commande @code{\key}, suivie d'une
349 hauteur puis de @code{\major} (majeur) ou @code{\minor} (mineur) :
358 @lilypond[fragment,quote,notime,fragment]
366 La combinaison de l'armure et des hauteurs de note -- y compris les
367 altérations -- permet de déterminer dans quel cas afficher les
368 altérations accidentelles. Cette fonctionnalité est souvent source de
369 confusion pour les nouveaux utilisateurs, aussi expliquons-la en
373 LilyPond fait une nette distinction entre le contenu musical et la
374 mise en forme. L'altération d'une note -- bémol, bécarre ou dièse --
375 fait partie de sa hauteur, et donc du contenu musical. La présence
376 d'une altération accidentelle -- un @emph{signe} bémol, bécarre ou
377 dièse -- devant la note correspondante est une question de mise en
378 page. La mise en page est un processus qui obéit à des règles ; les
379 altérations accidentelles sont donc automatiquement imprimées suivant
380 ces règles. Les hauteurs de note appartiennent à la musique que vous
381 entrez, et comme vous êtes sensé(e) entrer ce que vous voulez entendre,
382 LilyPond, qui n'est chargé que de la gravure, ne les choisit pas à
387 @lilypond[quote,notime,fragment]
393 si aucune note n'a d'altération accidentelle, vous devez
402 Le code @samp{d} ne veut pas dire « imprimer un point noir juste
403 en-dessous de la portée. » Cela signifie plutôt : « une note ayant la
404 hauteur ré naturel. » Avec l'armure de la bémol majeur, ce ré sera flanqué
405 d'un bécarre accidentel.
407 @lilypond[quote,notime,fragment,relative=1,verbatim]
412 Ajouter explicitement toutes les altérations requiert un peu plus
413 d'effort dans la phase de saisie, mais avec l'avantage que la
414 transposition en sera facilitée. De plus les altérations accidentelles
415 peuvent être imprimées suivant plusieurs conventions. Regardez
416 @ref{Automatic accidentals} pour connaître la manière dont les
417 altérations accidentelles peuvent être imprimées suivant différentes
421 Pour plus d'informations sur
425 @item les altérations accidentelles
426 voir @ref{Automatic accidentals}.
429 voir @ref{Key signature}.
434 @section Entering ties
437 Une liaison de prolongation@footnote{parfois aussi appelée liaison de
438 tenue.} (@rglos{tie}) est créée en ajoutant un tilde @samp{~} à
439 la suite de la première note liée.
441 @lilypond[quote,notime,fragment,verbatim,relative=3]
445 Pour plus d'informations sur les liaisons de prolongation, voir @ref{Ties}.
449 @node Automatic and manual beams
450 @section Automatic and manual beams
452 @cindex beams, by hand
453 Toutes les ligatures@footnote{parfois appelées aussi liens de croches}
454 (@rglos{beam}), sont dessinées automatiquement :
456 @lilypond[quote,fragment,relative=2,verbatim]
461 Si l'emplacement des barres ne vous convient pas, vous pouvez
462 les entrer à la main. Marquer la première note à être attachée d'un
463 @samp{[} et la dernière d'un @samp{]}.
465 @lilypond[quote,fragment,relative=2,verbatim]
469 Pour plus d'informations sur les ligatures, voir @ref{Manual beams}.
472 Voici comment se comportent ensemble armures, altérations
473 accidentelles et liaisons :
475 @lilypond[fragment,quote,noindent,line-width=50\staff-space,verbatim]
482 fis4 fis8 fis8 eis4 a8 gis~
491 Il y a plusieurs points intéressants à noter dans cet exemple. Les
492 barres de mesure et les liens de croches sont dessinés
493 automatiquement. Les sauts de ligne sont calculés automatiquement ;
494 peu importe où se situent les sauts de ligne dans le fichier source.
495 Enfin, l'ordre dans lequel la métrique, l'armure et les changements de
496 clefs sont saisis n'a pas d'importance : dans la sortie imprimable,
497 ils sont organisés suivant les conventions standard de notation.
502 @section Octave entry
505 @c Tim wants to move this quotes example just before the: quotes-do not-work
506 @c score, but we'd need to remove quotes from the other two (key and
509 @c better to have this just before the `octaves are bad' snipped
510 @c but we'd need to remove the ', from \key and tie
511 Pour hausser une note d'une octave, ajoutez une apostrophe @code{'} au
512 nom de la note ; pour la baisser d'une octave, ajoutez une virgule
513 @code{,}. Le do central (entre la clef de sol et la clef de fa) est
516 @lilypond[quote,notime,fragment,verbatim]
517 c'4 c'' c''' \clef bass c c,
520 Un exemple de l'utilisation des apostrophes dans ce fragment de Mozart :
522 @lilypond[quote,ragged-right,fragment,verbatim]
525 cis''8. d''16 cis''8 e''4 e''8
526 b'8. cis''16 b'8 d''4 d''8
530 Cet exemple montre qu'il faut beaucoup d'apostrophes pour écrire de la
531 musique dans un registre aigu. Ceci rend le fichier moins lisible, et
532 c'est une source d'erreurs. La solution consiste à utiliser le mode
533 d'« octaves relatives ». C'est la façon la plus commode de copier de
534 la musique existante.
536 En mode relatif, une note sans signe d'octaviation -- @code{'} ou
537 @code{,} après le nom de la note -- est interprétée de manière à ce
538 qu'elle soit la plus proche de la note précédente. Par exemple,
539 @samp{c f} monte, alors que @samp{c g} descend.
541 Pour utiliser le mode relatif, ajoutez @code{\relative} avant le
542 morceau de musique. La première hauteur de note est choisie
543 relativement en fonction du do central -- c'est-à-dire @code{c'}.
547 @lilypond[quote,notime,fragment,verbatim]
554 Puisque la plus grande partie de la musique utilise de petits
555 intervalles, les pièces peuvent être écrites en mode relatif sans
556 pratiquement utiliser de signes d'octavation. L'exemple précédent est
559 @lilypond[quote,ragged-right,verbatim]
563 cis'8. d16 cis8 e4 e8
568 @c needed better, maybe even redundant explanation
569 @c added another example below.
570 @c grappig: Pa vond het heel logies, en slim toen-i eenmaal begreep.
571 @c in eerste instantie drong het `relative' niet door zonder extra uitleg.
572 Les intervalles plus grands qu'une quarte sont produits en ajoutant
573 les signes d'octavation :
575 @lilypond[quote,notime,verbatim,fragment]
581 En résumé, apostrophes et virgules ne déterminent pas la hauteur
582 absolue d'une note dans le mode @code{\relative}. Au lieu de cela, la
583 hauteur de la note est relative à la précédente, et modifier l'octave
584 d'une seule note changera l'octave de toutes les notes suivantes.
586 Pour plus d'information sur les octaves relatives, voir
587 @ref{Relative octaves}, et @ref{Octave check}.
590 @node Music expressions explained
591 @section Music expressions explained
594 Dans les fichiers source LilyPond, la musique est représentée par ce qu'on
595 appelle des @emph{expressions musicales}. Nous en avons déjà vu dans
596 les quelques exemples précédents ; une seule note constitue une
597 expression musicale :
599 @lilypond[fragment,quote,verbatim,relative=3]
603 Mettre un groupe de notes entre accolades crée une nouvelle expression
606 @lilypond[fragment,quote,verbatim,relative=3]
610 Placer une séquence d'expressions musicales -- des notes par exemple
611 -- entre accolades signifie qu'elles doivent être jouées
612 successivement, les unes après les autres. Le résultat est une
613 expression, qui peut elle-même être regroupée séquentiellement avec
614 d'autres expressions. Ici, l'expression de l'exemple précédent est
615 combinée à deux notes :
617 @lilypond[fragment,quote,verbatim,relative=3]
621 Cette technique est utile pour de la musique non monophonique. Pour
622 entrer une musique avec plusieurs voix ou plusieurs portées, nous
623 pouvons aussi combiner en parallèle les expressions. Deux voix qui doivent être
624 jouées en même temps, sont entrées comme une combinaison simultanée de
625 deux expression. Une expression musicale « simultanée » est formée en
626 entourant les expressions entre @code{<<} et @code{>>}. Dans l'exemple
627 suivant, trois expressions (contenant chacune deux notes distinctes) sont
628 combinées simultanément.
630 @lilypond[fragment,quote,verbatim,relative=3]
638 Ce mécanisme est similaire au formules mathématiques : une grosse formule
639 est créée en assemblant plusieurs petites formules. Ces types
640 de formules, appelées expressions, ont une définition récursive, de
641 telle sorte que vous pouvez fabriquer des expressions
642 arbitrairement longues et complexes. Par exemple,
651 ((1 + 2) * 3) / (4 * 5)
655 @cindex music expression
656 Ceci est une suite d'expressions, où chacune est contenue dans la
657 suivante. Les expressions les plus simples sont les nombres, et de
658 plus grandes expressions sont produites en combinant des expressions
659 avec des opérateurs -- comme @samp{+}, @samp{*} et @samp{/} -- et des
660 parenthèses. Tout comme les expressions mathématiques, les expressions
661 musicales peuvent être imbriquées avec une profondeur arbitraire, ce
662 qui est nécessaire pour de la musique complexe comme des partitions
665 Notez que l'exemple suivant ne comporte qu'une seule portée,
666 contrairement à l'exemple précédent qui contenait trois portées
667 séparées. C'est parce que l'exemple commence par une note seule. Pour
668 déterminer le nombre de portées, LilyPond regarde le premier élément
669 qui n'est pas une accolade. Si c'est une seule note, il y a une portée
670 ; si c'est une expression simultanée, il y aura plus d'une portée.
672 @lilypond[fragment,quote,verbatim,relative=2]
675 << { e f } { c <<b d>> } >>
679 Il est facile de s'y perdre avec des fichiers musicaux comprenant de nombreuses
680 imbrications, tant pour leur création que pour leur maintenance. Une
681 convention permet d'éviter cette confusion : l'indentation. Pour
682 entrer un fichier avec de prfondes imbrications d'accolades et de
683 crochets, il est d'usage d'avoir recours à une indentation qui indique
684 le niveau de profondeur. Formater la musique d'une telle manière en
685 facilite la lecture et vous aide à insérer le bon nombre d'accolades
686 fermant les expressions. Par exemple,
699 Certains éditeurs disposent d'un mode spécifique pour saisir des
700 fichiers LilyPond, qui peut vous aider à indenter le fichier source.
701 Voir la section @ref{Editor support} pour plus d'informations.
706 Pour créer plus d'une portée, chaque partie de la musique constituant
707 une portée est entrée en la faisant précéder de
708 @code{\new Staff}. Ces éléments @code{Staff} sont combinés en parallèle avec
709 @code{<<} et @code{>>}, comme
711 @lilypond[quote,fragment,verbatim]
713 \new Staff { \clef treble c'' }
714 \new Staff { \clef bass c }
719 La commande @code{\new} introduit un « contexte de notation ». Un
720 contexte de notation est un environnement dans lequel les événements
721 musicaux -- comme les notes ou les commandes @code{\clef} -- sont
722 interprétés. Pour des pièces simples, ces contextes sont créés
723 automatiquement. Pour des pièces plus complexes, il est préférable de
724 spécifier explicitement les contextes. Cela assure que chaque fragment
725 aura sa propre portée.
727 Il existe différents types de contextes. Les contextes @code{Staff}
728 (portée), @code{Voice} (voix) et @code{Score} (partition) gèrent la
729 notation de la mélodie, alors que @code{Lyrics} gère les paroles et
730 @code{ChordNames} imprime le nom des accords.
732 En termes de syntaxe, faire précéder une expression musicale de
733 @code{\new} crée une plus grosse expression musicale. En reprenant la
734 comparaison, cela ressemble au signe « moins » en mathématiques. La formule
735 @math{(4+5)} est une expression, donc @math{-(4+5)} est une plus grosse
738 Nous pouvons maintenant écrire un morceau à deux portées :
740 @c TODO: (c) status of this Paul McCartney (?) song (let's all stand together)
742 @lilypond[fragment,quote,verbatim,ragged-right]
759 Pour plus d'informations sur les contextes, voir leur description à
760 @ref{Interpretation contexts}.
764 @node Adding articulation marks to notes
765 @section Adding articulation marks to notes
771 Les articulations standard peuvent être ajoutées à une note en
772 utilisant un tiret (@samp{-}) et un caractère :
774 @lilypond[fragment,quote,verbatim,relative=2]
775 c-. c-- c-> c-^ c-+ c-_
779 De la même manière, des indications de doigté peuvent être ajoutées à
780 une note en utilisant un tiret (@samp{-}) et le chiffre à écrire :
782 @lilypond[fragment,quote,verbatim,relative=2]
786 Articulations et doigtés sont habituellement placés automatiquement,
787 mais vous pouvez spécifier une direction en utilisant @samp{^} (en haut)
788 ou @samp{_} (en bas). Vous pouvez aussi utiliser plusieurs articulations
789 sur la même note. Dans la plupart des cas, cependant, il est mieux de
790 laisser LilyPond déterminer l'emplacement de l'articulation.
792 @lilypond[fragment,quote,verbatim,relative=2]
793 c_-^1 d^. f^4_2-> e^-_+
796 Les signes de nuances sont obtenus en ajoutant à la note les noms des nuances,
797 précédées d'un anti-slash @samp{\} :
799 @lilypond[fragment,quote,verbatim,relative=2]
807 Crescendi et decrescendi débutent avec les commandes @code{\<} et
808 @code{\>}. Ils se terminent soit par une nuance d'arrivée, par exemple @code{\f},
809 soit par la commande @code{\!} :
811 @lilypond[fragment,quote,verbatim,relative=2]
819 Une liaison d'articulation (@rglos{slur}) est une courbe tracée
820 au-dessus de plusieurs notes. Elle indique un jeu legato. Les notes de
821 départ et d'arrivée sont suivies respectivement par @samp{(} et
824 @lilypond[fragment,quote,fragment,relative=2,verbatim]
825 d4( c16) cis( d e c cis d) e( d4)
828 @cindex slurs versus ties
829 Une liaison d'articulation ressemble à une liaison de
830 prolongation (@rglos{tie}),
831 mais a une signification différente. Une liaison de prolongation fait
832 durer la première note plus longtemps, et ne peut être utilisée que
833 sur une paire de notes de même hauteur. Ces deux types de liaison
834 peuvent être imbriqués :
836 @lilypond[quote,fragment,relative=2]
837 c2~( c8 fis fis4 ~ fis2 g2)
840 @cindex phrasing slurs
841 Une liaison de phrasé peut être entrée avec @code{\(} et @code{\)},
842 vous pouvez donc avoir simultanément une liaison d'articulation et une
843 liaison de phrasé. Vous ne pouvez pas avoir de liaisons d'articulation
844 simultanées ni de liaisons de phrasé simultanées.
846 @lilypond[quote,fragment,relative=2,verbatim]
847 a8(\( ais b c) cis2 b'2 a4 cis, c\)
851 Pour plus d'informations sur les
856 voir @ref{Fingering instructions}.
858 voir @ref{Articulations}.
859 @item liaisons d'articulation
861 @item liaisons de phrasé
862 voir @ref{Phrasing slurs}.
869 @node Combining notes into chords
870 @section Combining notes into chords
873 Des accords peuvent être produits en entourant les hauteurs de note
874 avec les angles gauche et droit -- @samp{<} et @samp{>} --
876 @lilypond[quote,relative=1,fragment,verbatim]
881 Vous pouvez combiner les indications comme les liaisons et les liens de
882 croches avec les accords. Ils doivent cependant être placés en
885 @lilypond[quote,relative=1,fragment,verbatim]
886 r4 <c e g>8[ <c f a>]~ <c f a>
890 r4 <c e g>8\>( <c e g> <c e g> <c f a>\!)
893 @lilypond[quote,relative=1,fragment]
895 r4 <c e g>8\>( <c e g> <c e g> <c f a>\!)
899 @node Advanced rhythmic commands
900 @section Advanced rhythmic commands
904 @cindex partial measure
905 Une levée est entrée avec le mot-clé @code{\partial}. Il est suivi par
906 une durée : @code{\partial 4} est une levée d'une noire et
907 @code{\partial 8} d'une croche.
909 @lilypond[quote,relative=2,verbatim,fragment]
916 Les n-olets sont créés avec le mot-clef @code{\times}. Celui-ci prend
917 deux arguments : une fraction et une expression musicale. La durée des
918 notes de l'expression musicale est multipliée par la fraction. Les
919 notes d'un triolet durent les deux tiers du temps de leur notation
920 réelle, cette fraction est donc de 2/3 pour les triolets :
922 @lilypond[quote,relative=1,verbatim,fragment]
923 \times 2/3 { f8 g a }
929 Des notes d'ornement sont produites en préfixant une expression musicale
930 avec le mot-clé @code{\appoggiatura} ou @code{\acciaccatura} :
934 @lilypond[quote,relative=2,verbatim,fragment]
935 c4 \appoggiatura b16 c4
936 c4 \acciaccatura b16 c4
941 Pour plus d'informations sur les
946 voir @ref{Grace notes},
949 @item mesures incomplètes (levées)
950 voir @ref{Partial measures}.
955 @node Commenting input files
956 @section Commenting input files
960 @cindex block comment
961 Un commentaire est une remarque à l'attention du lecteur du fichier
962 source ; il est ignoré lors de l'analyse du fichier, et n'a donc
963 aucun effet sur la sortie imprimable. Il existe deux types
964 de commentaires. Le symbole pourcent @samp{%} introduit un commentaire
965 d'une ligne : après @code{%}, le reste de la ligne est ignoré. Un bloc de
966 commentaire marque une section entière dans le fichier d'entrée. Tout ce
967 qui est à l'intérieur de @code{%@{} et @code{%@}} est ignoré. Le fragment
968 suivant montre les utilisations possible des commentaires :
971 % mélodie de "ah vous dirais-je maman"
975 Cette ligne, et les notes ci-dessous
976 sont ignorées, puisque'elles sont dans
977 un bloc de commentaire.
983 @c TODO post-2.6 reorg
984 @c This is good info, but I wouldn't call it a comment. IMO it should
985 @c be moved somewhere else.
989 Il y a une déclaration particulière qui est une sorte de commentaire. La
990 déclaration @code{\version} stipule le numéro de la version de LilyPond
991 pour laquelle le fichier a été écrit. Pour donner à un fichier la version
999 Cette annotation permet de faciliter les prochaines mises à jour de
1000 LilyPond. Les changements dans la syntaxe sont gérés avec un
1001 programme spécial, @file{convert-ly} -- voir
1002 @ref{Updating files with convert-ly} -- et il utilise @code{\version}
1003 pour déterminer les règles de conversion à appliquer au fichier.
1006 @node Printing lyrics
1007 @section Printing lyrics
1010 @c TODO: (c) status of the Queen fragment.
1014 Les paroles sont entrées en séparant chaque syllable par un espace :
1017 I want to break free
1022 @lilypond[quote,verbatim,fragment,ragged-right]
1024 r4 c \times 2/3 { f g g }
1025 \times 2/3 { g4( a2) }
1029 Les paroles peuvent être associées à ces notes en les combinant avec le
1030 mot-clé @code{\addlyrics}
1032 @lilypond[quote,verbatim,fragment,ragged-right]
1035 r4 c \times 2/3 { f g g }
1036 \times 2/3 { g4( a2) }
1038 \addlyrics { I want to break free }
1043 @cindex extender line
1045 Cette mélodie se termine sur un mélisme (@rglos{melisma}),
1046 c'est-à-dire qu'une seule syllable (« free ») correspond à plus d'une
1047 note. Ceci est indiqué avec une @emph{ligne d'extension}. Elle est
1048 entrée avec deux caractères souligné (@code{_}), c'est-à-dire
1051 @{ I want to break free __ @}
1054 @lilypond[fragment,quote,ragged-right]
1057 r4 c \times 2/3 { f g g }
1058 \times 2/3 { g4( a2) }
1060 \addlyrics { I want to break free __ }
1064 De la même manière, les séparations syllabiques d'un mot peuvent être entrées
1065 avec deux tirets (@code{-}), ce qui produit un tiret centré entre les deux
1072 @c no ragged-right here, because otherwise the hypens get lost.
1073 @lilypond[fragment,quote]
1079 \addlyrics { A -- le gri -- a }
1083 Plus de possibilités, comme celle d'ajouter plusieurs lignes de
1084 paroles en dessous d'une même mélodie sont exposées à
1089 @section A lead sheet
1095 @c TODO: revise this, \chords { } is shorter and more intuitive.
1097 Dans la musique de variété, il est courant d'indiquer l'accompagnement
1098 par le nom des accords. De tels accords peuvent être entrés comme les
1101 @lilypond[quote,verbatim,ragged-right]
1102 \chordmode { c2 f4. g8 }
1106 Maintenant, chaque hauteur est lue comme la base de l'accord à la
1107 place de la note. Ce mode est activé avec @code{\chordmode}.
1109 Les autres accords peuvent être créés en ajoutant des modifiacteurs après
1110 deux points. L'exemple suivant montre quelques modificateurs usuels :
1112 @lilypond[quote,verbatim,ragged-right]
1113 \chordmode { c2 f4:m g4:maj7 gis1:dim7 }
1116 Pour la musique improvisée, les accords ne sont pas imprimés sur des
1117 portées mais comme des lignes à part entière. Ceci s'obtient en
1118 utilisant @code{\chords} à la place de @code{\chordmode}. La même
1119 syntaxe sera utilisée que dans le cas de@code{\chordmode}, mais le
1120 rendu des notes interviendra dans un contexte de @code{ChordNames},
1121 avec le résultat suivant
1123 @lilypond[quote,verbatim,ragged-right]
1124 \chords { c2 f4.:m g4.:maj7 gis8:dim7 }
1128 Une fois assemblés, les accords, paroles et mélodie forment une
1129 partition de chanson :
1133 \chords @{ @emph{les accords} @}
1135 \addlyrics @{ @emph{le texte} @}
1140 @lilypond[quote,ragged-right]
1142 \chords { r2 c:sus4 f }
1144 r4 c' \times 2/3 { f g g }
1145 \times 2/3 { g4( a2) }
1147 \addlyrics { I want to break free __ }
1151 Une liste complète de modificateurs et d'autres options de
1152 mise en forme se trouve à la section @ref{Chords}.
1156 @section Adding titles
1158 Les informations bibliographiques sont entrées dans un bloc séparé, le
1159 bloc d'en-tête (@code{\header}). Le nom du morceau, son compositeur, etc., sont
1160 définis dans @code{\header@{@tie{}@dots{}@tie{}@}}.
1161 Le bloc @code{\header} est habituellement placé en début de fichier.
1167 composer = "Igor Stravinsky"
1174 Quand le fichier est traité, le titre et le compositeur sont imprimés
1175 en haut de la partition. Vous trouverez plus d'informations sur les
1176 titres à @ref{Creating titles}.
1179 @node Single staff polyphony
1180 @section Single staff polyphony
1183 @cindex multiple voices
1184 @cindex voices, more -- on a staff
1185 Quand différentes lignes mélodiques sont combinées sur une seule et
1186 même portée, elle sont imprimées comme des voix polyphoniques ; chaque
1187 voix a ses propre hampes@footnote{familièrement appelées queues de
1188 note.}, liaisons et ligatures, la voix supérieure ayant les hampes
1189 vers le haut, la voix inférieure vers le bas.
1191 Ce type de partition est réalisé en entrant chaque voix comme
1192 une séquence (avec @code{@{...@}}), en combinant simultanément les
1193 voix et en les séparant par @code{\\} :
1195 @lilypond[quote,verbatim,relative=2,fragment]
1196 << { a4 g2 f4~ f4 } \\
1200 Pour l'écriture de musique polyphonique, les silences invisibles
1201 (spacer rests) s'avèrent bien pratiques ; ce sont des silences qui ne
1202 s'impriment pas. Ils sont utiles pour remplir des voix qui,
1203 temporairement, ne jouent rien. On peut voir ici le même exemple avec
1204 un silence espace invisible (@code{s}) à la place d'un silence normal
1207 @lilypond[quote,verbatim,relative=2,fragment]
1208 << { a4 g2 f4~ f4 } \\
1213 Encore une fois, ces expressions peuvent s'imbriquer arbitrairement :
1215 @lilypond[quote,fragment,verbatim,relative=2,fragment]
1223 { <c g>1 ~ <c g>4 } \\
1229 Plus de fonctionnalités sur l'écriture polyphonique sont décrites à la
1230 section @ref{Basic polyphony} du manuel.
1234 @section Piano staves
1236 @cindex staff switch, manual
1237 @cindex cross staff voice, manual
1238 La musique pour piano s'écrit avec deux portées reliées par une
1239 accolade. Imprimer ce type de portée revient au même que dans l'exemple de
1240 musique polyphonique (@ref{More staves}),
1243 << \new Staff @{ @dots{} @}
1244 \new Staff @{ @dots{} @} >>
1248 mais maintenant cette expression entière doit être interprétée dans un
1249 contexte @code{PianoStaff}
1252 \new PianoStaff << \new Staff @dots{} >>
1255 Voici un petit exemple :
1257 @lilypond[quote,verbatim,relative=1,fragment]
1259 \new Staff { \time 2/4 c4 c g' g }
1260 \new Staff { \clef bass c,, c' e c }
1264 Plus d'informations sur le formatage de la musique pour piano sont
1265 données à @ref{Piano music}.
1268 @node Organizing larger pieces
1269 @section Organizing larger pieces
1271 Lorsqu'on combine tous les éléments étudiés plus haut pour produire
1272 des fichiers plus volumineux, les blocs @code{\score} deviennent
1273 beaucoup plus gros parce que les expressions musicales sont plus
1274 longues et, dans le cas des pièces polyphoniques, profondément
1275 imbriquées. De telles expressions imposantes finissent par devenir peu
1278 En utilisant des variables, appelées également identificateurs, il est
1279 possible de découper des expressions musicales complexes. Un identificateur
1283 MusiqueToto = @{ @dots{} @}
1287 Le contenu de l'expression musicale @code{MusiqueToto}, peut être
1288 utilisé plus loin en faisant précéder son nom d'un anti-slash, c'est-à-dire
1289 @code{\MusiqueToto}. Dans l'exemple suivant, un motif de deux notes est
1290 répété deux fois en utilisant la substitution par une variable :
1292 @lilypond[quote,ragged-right,verbatim,nofragment]
1296 { \seufzer \seufzer }
1299 Le nom d'un identificateur ne doit comporter que des caractères
1300 alphabétiques non accentués, aucun nombre ni tiret. On doit le définir
1301 en dehors de toute expression musicale.
1303 Il est possible d'utiliser des variables de types variés.
1309 papierACinq = \paper @{ paperheight = 21.0 \cm @}
1312 En fonction de son contenu, l'identificateur peut être utilisé à différents
1313 endroits. L'exemple suivant utilise la variable précédente :
1318 line-width = \largeur
1323 Vous trouverez plus d'informations sur les usages possibles des
1324 identificateurs dans le manuel technique, section
1325 @ref{Input variables and Scheme}.
1326 @c fixme: the ref is too technical.
1329 @node An orchestral part
1330 @section An orchestral part
1332 Pour la musique d'orchestre, toute la musique est imprimée deux fois.
1333 Une partie séparée pour chaque pupitre, et un conducteur pour le chef.
1334 Recourir à des identifiants permet de s'épargner un double travail. La
1335 musique est entrée une seule fois, et enregistrée dans une variable. Le
1336 contenu de ces variables sera utilisé pour générer à la fois la
1337 partie d'instrument et le conducteur.
1339 Définir les notes dans un fichier à part est très pratique. Par
1340 exemple, supposons que le fichier @file{musique-cor.ly} contienne la
1341 partie d'un duo cor/@/basson :
1344 notesCor = \relative c @{
1351 Puis, une partie individuelle est créée en mettant ce qui suit dans
1355 \include "musique-cor.ly"
1357 instrument = "Cor en fa"
1361 \transpose f c' \notesCor
1368 \include "musique-cor.ly"
1372 indique à LilyPond de lire le contenu de @file{musique-cor.ly} à cet
1373 endroit dans le fichier, ainsi @code{notesCor} est défini pour ce qui
1374 suivra. La commande @code{\transpose f@tie{}c'} indique que
1375 l'argument, en l'occurence @code{\notesCor}, doit être transposé d'une
1376 quinte ascendante. Le son entendu @samp{fa} correspond à la note écrite
1377 @code{do'}, ce qui correspond bien à la transpostion d'un cor en
1378 fa. La transposition peut être constatée dans la sortie suivante :
1380 @lilypond[quote,ragged-right]
1381 \transpose f c' \relative c {
1387 Dans la musique d'ensemble, il arrive souvent qu'une des voix ne joue
1388 pas pendant plusieurs mesures. Ceci est spécifié par un silence
1389 spécial, le silence multi-mesures (mesures à compter). Il est saisi
1390 par une lettre capitale @samp{R} suivie d'une durée (@code{1}@tie{}pour une
1391 ronde, @code{2}@tie{}pour une blanche, etc.). En multipliant la durée, on
1392 peut construire des silences plus longs. Par exemple, ce silence dure
1393 3@tie{}mesures à 2/4
1399 Pour l'impression de parties séparées, ces silences multi-mesures doivent être
1400 condensés. On peut l'obtenir en réglant une variable d'exécution
1403 \set Score.skipBars = ##t
1407 Cette commande règle la propriété @code{skipBars} dans le contexte
1408 @code{Score} à vrai (@code{##t}). En faisant précéder la musique plus haut
1409 du silence et de cette option, on obtient
1411 @lilypond[quote,ragged-right]
1412 \transpose f c' \relative c {
1414 \set Score.skipBars = ##t
1421 On crée le conducteur en combinant toutes les parties. En
1422 supposant que l'autre voix soit dans l'expression @code{notesBasson} du fichier
1423 @file{musique-basson.ly}, le conducteur est composé des commandes
1426 \include "musique-cor.ly"
1427 \include "musique-basson.ly"
1430 \new Staff \notesCor
1431 \new Staff \notesBasson
1436 donnant pour résultat
1438 @lilypond[quote,ragged-right]
1446 r4 d,8 f | gis4 c | b bes |
1447 a8 e f4 | g d | gis f
1452 De plus amples informations sur la gestion des parties et conducteurs
1453 se trouvent dans le manuel de notation, section @ref{Orchestral music}.
1455 Le réglage des variables d'exécution (« propriétés ») est abordé dans
1456 @ref{Changing context properties on the fly}.
1459 @node After the tutorial
1460 @section After the tutorial
1462 Après avoir parcouru ce tutoriel, vous devriez vous essayer à écrire
1463 un morceau ou deux. Commencez par copier l'un des modèles types (@ref{Example
1464 templates}) et ajoutez-y des notes. Si vous voulez employer une notation que
1465 vous n'avez pas trouvé dans le tutoriel, consultez la référence de
1466 notation, en commençant par la @ref{Basic notation}. Si vous désirez écrire pour un
1467 ensemble instrumental non couvert par les @ref{Example templates},
1468 lisez la section @ref{Extending the templates}.
1470 Après avoir écrit quelques pièces courtes, lisez les chapitres 3 à 5
1471 du manuel d'apprentissage. Rien ne s'oppose à ce que vous consultiez dès à
1472 présent les autres chapitres, bien sûr ! Néanmoins, le reste du manuel
1473 de l'utilisateur part du principe que vous avez déjà bien assimilé la
1474 syntaxe de LilyPond. Vous pouvez toujours survoler le reste du manuel,
1475 et y revenir plus tard après avoir acquis de l'expérience.