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 d'écriture
18 de la musique avec LilyPond. Après ce premier contact, nous verrons
19 comment produire une partition à imprimer. Vous serez alors capable de
20 créer et d'imprimer vos propres partitions.
23 Beaucoup de gens apprennent à utiliser les programmes en les essayant
24 et en jouant avec. Ceci 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 que nous avons utilisé pour
28 Essayez sur cette image
30 @lilypond[fragment,quote,ragged-right,relative=2]
31 c-\markup { \bold \huge { Click here. } }
35 En coupant et en collant l'itégralité du code dans un fichier test, vous aurez
36 un modèle pour démarrer les expérimentations. Si vous apprenez de cette
37 façon, vous aurez probablement envie d'imprimer ou de créer un lien
42 @ref{Cheat sheet}, tableau qui répertorie les commandes usuelles
43 et constitue une référence rapide.
47 * Running LilyPond for the first time::
48 * More about pitches::
50 * Automatic and manual beams::
52 * Music expressions explained::
54 * Adding articulation marks to notes::
55 * Combining notes into chords::
56 * Advanced rhythmic commands::
57 * Commenting input files::
61 * Single staff polyphony::
63 * Organizing larger pieces::
64 * An orchestral part::
65 * After the tutorial::
72 Le premier exemple montre comment écrire la partition la plus
73 élémentaire qui soit, une gamme (@rglos{scale}). Une @rglos{note} peut
74 être entrée en tapant son nom, de @samp{a} à @samp{g}. Donc si vous entrez
83 le résultat ressemblera à
85 @lilypond[fragment,quote,notime,relative=1]
89 @footnote{NdT : il est aussi possible d'utiliser les noms
90 de notes do re mi fa sol la si, en insérant au début du fichier
91 @samp{\include "catalan.ly"}}
93 Toue partie de code LilyPond doit être entouré d'une @{paire
94 d'accolades@}. Bien que la plupart des exemples de ce manuel n'en
95 comportent pas, ne les oubliez pas dans vos compositions !
97 De plus, de nombreux exemples utilisent les mode @code{relative}. Ceci
98 est expliqué à la section @ref{Octave entry} ; sachez dès à présent
99 que certains exemples devraient être libellés sous la forme
100 @code{\relative @{ @emph{...musique...} @}}.
101 De nombreux exemples ont aussi été « raccourcis » pour économiser la
102 place, grace à la commande @code{\paper @{ ragged-right = ##t @}}.
104 @cindex Case sensitive
105 Enfin, LilyPond est sensible à la casse. @code{ @{ c d e @} } est
106 un code valide ; @code{ @{ C D E @} } produira un message d'erreur.
108 La valeur (@rglos{duration}) d'une note est spécifiée par un nombre
109 qui suit le nom de cette note. @samp{1} pour une ronde (@rglos{whole
110 note}), @samp{2} pour une blanche (@rglos{half note}), @samp{4} pour
111 une noire (@rglos{quarter note}) et ainsi de suite.
117 @lilypond[fragment,quote,notime,relative=2]
118 \set Staff.autoBeaming = ##f
119 { a1 a2 a4 a16 a32 s16_" " }
122 Si aucune durée n'est spécifiée, la dernière entrée est utilisée pour les
123 notes suivantes. La valeur par défaut de la première note d'une partition
130 @lilypond[fragment,quote,notime,relative=2]
131 { a a8 a a2 a s16_" " }
135 Un silence (@rglos{rest}) se saisi tout comme une note, mais avec le
142 @lilypond[fragment,quote,notime]
146 Ajouter un point @samp{.} après une durée permet d'obtenir une note
147 pointée (@rglos{dotted note}).
153 @lilypond[fragment,quote,notime,relative=1]
154 { a2. a4 a8. a16 s16_" " }
157 Le chiffrage de la mesure (@rglos{time signature}) peut se définir à
158 l'aide de la commande @code{\time}.
166 @c A clef here may lead to confusion, remove it.
167 @lilypond[fragment,quote]
168 \override Staff.Clef #'transparent = ##t
177 La @rglos{clef} peut être réglée avec la commande @code{\clef}.
186 @lilypond[fragment,quote,notime]
197 Pensez bien à encadrer les notes et commandes avec des accolades
198 @code{@{@tie{}@dots{}@tie{}@}} pour pouvoir obtenir un résultat imprimable.
200 @c @li @lilypond[fragment,quote,noindent,linewidth=55\staffspace]
201 @lilypond[fragment,quote,noindent,verbatim]
208 Pour plus d'informations sur
212 @item Définir des hauteurs et des durées
214 @ref{Pitches}, et @ref{Durations}.
219 @item les chiffrages de mesure et autres commandes liées au temps
220 see @ref{Time signature}.
225 @node Running LilyPond for the first time
226 @section Running LilyPond for the first time
228 @c cheesy title to avoid clash with chapter name.
230 Dans la section précédente, nous avons vu quelles sortes d'éléments
231 peut contenir un fichier LilyPond. Dans cette section nous
232 expliquerons quelles commandes exécuter et comment voir ou imprimer le
233 résultat de LilyPond. Si vous n'avez jamais utilisé
234 LilyPond, voulez tester votre installation ou souhaitez exécuter
235 vous-même un fichier d'exemple, lisez cette section.
237 @unnumberedsubsec MacOS X
239 Si vous double-cliquez sur LilyPond.app, un fichier d'exemple sera
240 ouvert. Sauvegardez le, par exemple, sous @file{test.ly} sur votre
241 bureau, et traitez-le ensuite avec la commande du menu
242 @samp{Compile > Typeset File}.
243 Le fichier PDF résultant est affiché sur votre écran.
245 Prenez note que le premier démarrage prend une minute ou deux
246 car toutes les polices systèmes doivent être d'abord analysées.
248 @unnumberedsubsec Windows
250 Sous Windows, démarrez un éditeur de texte @footnote{N'importe quel
251 éditeur simple ou orienté programmation fera l'affaire, comme
252 Notepad. N'utilisez pas de traitement de texte car ceux-ci insèrent
253 des codes de formatage qui posent problème à LilyPond.} et entrez
259 Enregistrez le sur le bureau sous @file{test.ly} et vérifiez bien
260 qu'il ne s'appelle pas @file{test.ly.TXT}. Double-cliquez sur le
261 fichier @file{test.ly} pour le traiter et afficher le fichier
265 @unnumberedsubsec Unix
267 Commencez par ouvrir une fenêtre de terminal et lancez un éditeur de
268 texte. Par exemple, vous pouvez ouvrir un xterm et exécuter
269 @code{joe}. @footnote{Des fichiers de macros pour les fans de VIM et un
270 @code{LilyPond-mode} pour les fans d'Emacs existent. S'ils ne sont pas
271 encore installés, consultez le fichier @file{INSTALL.txt}.} Dans votre
272 éditeur, entrez le texte suivant et sauvegardez le fichier sous
280 Pour traiter @file{test.ly}, procédez comme ceci :
287 Vous verrez quelque chose ressemblant à :
294 Interpreting music... [1]
295 Preprocessing graphical objects...
296 Calculating line breaks... [2]
297 Layout output to `test.ps'...
298 Converting to `test.pdf'...
302 @cindex Viewing music
305 Le résultat est le fichier @file{test.pdf} que vous pouvez imprimer ou
306 visualiser avec les outils standards de votre système d'exploitation.
307 @footnote{Si votre système ne dispose pas des outils nécessaires,
309 @uref{http://@/www@/.cs@/.wisc@/.edu/@/~ghost/,Ghostscript}, un
310 programme pour voir et imprimer les fichiers PDF et PostScript.}
312 @footnote{NdT : suivant votre installation, les messages
313 peuvent être traduits.}
315 @node More about pitches
316 @section More about pitches
318 Un dièse (@rglos{sharp}) s'obtient en ajoutant @samp{is} au nom
319 de la note, un bémol (@rglos{flat}) en ajoutant @samp{es}. Comme
320 vous pouvez vous y attendre, un double dièse ou double bémol est
321 obtenu en ajoutant @samp{isis} ou @samp{eses}@footnote{Cette syntaxe
322 est dérivée de la convention de dénomination des notes dans les langues
323 nordiques et germaniques, comme l'allemand ou le hollandais.}.
324 @footnote{NdT : si vous utilisez la commande décrite plus haut
325 pour utiliser do ré mi à la place des lettres, il faudra ajouter un
326 @samp{d} pour un dièse, et un @samp{b} pour un bèmol. Le double dièse
327 et le double bémol s'obtiennent en ajoutant respectivement @samp{dd} et @samp{bb}}
333 @lilypond[fragment,quote,notime]
334 \set Score.timing = ##f
335 \transpose c c' { cis1 ees fisis aeses s16_" " }
338 @cindex key signature, setting
339 L'armure est déterminée par la commande @code{\key}, suivie d'une
340 hauteur et de @code{\major} (majeur) ou @code{\minor} (mineur).
349 @lilypond[fragment,quote,notime,fragment]
357 Les armures fixées par des hauteurs (y compris les altérations)
358 permettent de déterminer quand afficher les altérations
359 accidentelles. Cette fonctionnalité est souvent source
360 de confusion pour les nouveaux utilisateurs, aussi expliquons la
364 LilyPond fait une distinction entre le contenu musical et la mise
365 en page. L'altération (bémol, bécarre ou dièse) d'une note fait
366 partie de sa hauteur, et donc du contenu musical. La présence d'une
367 altération accidentelle (un @emph{signe} bémol, bécarre ou dièse) devant
368 la note correspondante est question de mise en page. La mise
369 en page est quelque chose qui obéit à des règles ; les signes
370 accidentels sont donc automatiquement imprimés suivant ces règles. Les
371 hauteurs de note contenues dans votre musique font partie des éléments
372 artistiques, et les altérations ne sont pas ajoutées automatiquement,
373 même si vous devez entrer ce que vous voulez entendre.
377 @lilypond[quote,notime,fragment]
383 si aucune note n'a une altération accidentelle explicite, vous devez
384 cependant les entrer :
392 Le code @samp{d} ne veut pas dire « imprimer un point noir sur la
393 portée. » Cela signifie plutôt : « une note ayant la hauteur ré
395 Avec l'armure en la bémol majeur, il y aura un signe accidentel.
397 @lilypond[quote,notime,fragment,relative=1,verbatim]
402 Ajouter explicitement toutes les altérations requiert un peu plus
403 d'effort en cours de saisie, mais l'avantage est que la transposition
404 sera facilitée. De plus les signes accidentels peuvent être imprimés suivant
405 plusieurs conventions. Regardez @ref{Automatic accidentals} pour
406 d'autres exemples sur la manière dont les signes accidentels peuvent
407 être imprimés suivant différentes règles.
410 Pour plus d'informations sur
414 @item les altérations accidentelles
415 voir @ref{Automatic accidentals}.
418 voir @ref{Key signature}.
423 @section Entering ties
426 Une liaison entre deux notes de même hauteur (@rglos{tie}) est créée
427 en ajoutant un tilde @samp{~} à la suite de la première note à être liée.
429 @lilypond[quote,notime,fragment,verbatim,relative=3]
433 Pour plus d'informations sur les liaisons de durées, voir @ref{Ties}.
437 @node Automatic and manual beams
438 @section Automatic and manual beams
440 @cindex beams, by hand
441 Toutes les ligatures (@rglos{beam}), ou liens de croches, sont dessinées
444 @lilypond[quote,fragment,relative=2,verbatim]
449 Si l'emplacement des barres ne vous convient pas, vous pouvez
450 les entrer à la main. Marquer la première note à être attachée d'un
451 @samp{[} et la dernière d'un @samp{]}.
453 @lilypond[quote,fragment,relative=2,verbatim]
457 Pour plus d'informations sur les liens de croches, voir @ref{Manual beams}.
460 Voici comment se comportent armures, altérations accidentelles et
463 @lilypond[fragment,quote,noindent,line-width=50\staff-space,verbatim]
470 fis4 fis8 fis8 eis4 a8 gis~
479 Il y a plusieurs points intéressants à noter dans cet exemple. Les
480 barres de mesure et les liens de croches sont dessinés automatiquement.
481 Les sauts de ligne sont calculés automatiquement ; peu importe où ils
482 se situent dans le fichier source. Enfin, l'ordre dans lequel
483 l'indicateur de mesure, l'armure et les changements de clefs sont
484 saisis n'a pas d'importance ; dans la sortie imprimable, ils sont
485 organisés suivant les conventions standard de notation.
490 @section Octave entry
493 @c Tim wants to move this quotes example just before the: quotes-do not-work
494 @c score, but we'd need to remove quotes from the other two (key and
497 @c better to have this just before the `octaves are bad' snipped
498 @c but we'd need to remove the ', from \key and tie
499 Pour hausser une note d'une octave, ajoutez lui une apostrophe
500 @code{'} ; pour la baisser d'une octave, ajoutez lui une virgule
501 @code{,}. Le do entre la clef de sol et la clef de fa est @code{c'}.
503 @lilypond[quote,notime,fragment,verbatim]
504 c'4 c'' c''' \clef bass c c,
507 Un exemple de l'utilisation des apostrophes dans ce fragment de Mozart
509 @lilypond[quote,ragged-right,fragment,verbatim]
512 cis''8. d''16 cis''8 e''4 e''8
513 b'8. cis''16 b'8 d''4 d''8
517 Cet exemple montre qu'il faut beaucoup d'apostrophes pour écrire de
518 la musique dans un registre aigu. Ceci rend le fichier moins
519 lisible, et c'est une source d'erreurs. La solution consiste à utiliser
520 les « octaves relatives ». C'est la façon la plus commode pour copier de
521 la musique existante.
523 En mode relatif, une note sans signe d'octavation (c'est à dire @code{'} ou
524 @code{,} après la note) est interprétée de manière à ce qu'elle soit la
525 plus proche de la note précédente. Par exemple, @samp{c f} monte, alors
526 que @samp{c g} descend.
528 Pour utiliser le mode relatif, ajouter @code{\relative} avant la pièce de
530 La première note est choisie relativement en fonction du do medium
531 @c no , for this sentence
536 @lilypond[quote,notime,fragment,verbatim]
543 Puisque la plupart de la musique utilise de petits intervalles, les pièces
544 peuvent être écrites en mode relatif, sans pratiquement utiliser de signes
545 d'octavation. L'exemple précédent est entré comme ceci :
547 @lilypond[quote,ragged-right,verbatim]
551 cis'8. d16 cis8 e4 e8
556 @c needed better, maybe even redundant explanation
557 @c added another example below.
558 @c grappig: Pa vond het heel logies, en slim toen-i eenmaal begreep.
559 @c in eerste instantie drong het `relative' niet door zonder extra uitleg.
560 Les intervalles plus grands sont faits en ajoutant les signes d'octavation.
562 @lilypond[quote,notime,verbatim,fragment]
568 En résumé, apostrophes et virgules ne déterminent pas la
569 hauteur absolue d'une note dans le mode @code{\relative}. La hauteur de la
570 note est relative à la précédente, et modifier l'octave d'une seule
571 note changera l'octave des suivantes.
573 Pour plus d'information sur les octaves relatives, voir @ref{Relative
574 octaves}, et @ref{Octave check}.
577 @node Music expressions explained
578 @section Music expressions explained
581 Dans les fichiers LilyPond, la musique est représentée par ce qu'on
582 appelle des @emph{expressions musicales}. Nous en avons déjà vu dans
583 les quelques exemples précédents ; une seule note constitue une
586 @lilypond[fragment,quote,verbatim,relative=3]
590 Mettre un groupe de notes entre accolades crée une nouvelle expression
593 @lilypond[fragment,quote,verbatim,relative=3]
597 Placer un groupe d'expressions musicales (ex: des notes) entre accolades
598 signifie qu'elles doivent être jouées en une seule phrase. Le résultat
599 est une expression, qui peut être regroupé avec d'autres expressions
600 séquentiellement. Ici, l'expression de l'expemple précédent est
601 combiné à deux notes :
603 @lilypond[fragment,quote,verbatim,relative=3]
607 Cette technique est utile pour de la musique non monophonique. Pour
608 entrer une musique avec plusieurs voix ou plusieurs portées, nous
609 combinons les expressions en parallèle. Deux voix qui doivent être
610 jouées en même temps, sont entrées comme une combinaison simultanée de
611 deux phrases. Une expression musicale « simultanée » est formée en
612 entourant les expressions entre @code{<<} et @code{>>}. Dans l'exemple
613 suivant, trois phrases (contenant chacune deux notes séparées) sont
614 combinées simultanément.
616 @lilypond[fragment,quote,verbatim,relative=3]
624 Ce mécanisme est similaire au formules mathématiques : une grosse formule
625 est créée en assemblant plusieurs petites formules. Ces types
626 de formules, appelées expressions, ont une définition récursive, de
627 telle sorte que vous pouvez fabriquer arbitrairement des expressions
628 complexes et importantes. Par exemple,
637 ((1 + 2) * 3) / (4 * 5)
641 @cindex music expression
642 Ceci est une suite d'expressions, où chacune est contenue dans la
643 suivante. Les expressions les plus simples sont les nombres, et les plus
644 conséquentes sont faites en combinant des expressions avec des
645 opérateurs (comme @samp{+}, @samp{*} et @samp{/}) et des
646 parenthèses. Tout comme les expressions mathématiques, les expressions
647 musicales peuvent être profondément imbriquées, ce qui est nécessaire
648 pour de la musique complexe comme des partitions polyphoniques.
650 Notez que cet exemple ne comporte qu'une seule portée, contrairement à
651 l'exemple précédent qui contenait trois portées séparées. C'est parce que
652 l'exemple commence par une note seule. Pour déterminer le nombre de
653 portées, LilyPond regarde le premier élément. Si c'est une seule note, il
654 y a une portée ; en cas d'expressions simultanées, il y aura
657 @lilypond[fragment,quote,verbatim,relative=2]
660 << { e f } { c <<b d>> } >>
664 On s'y perd souvent avec des fichiers musicaux comprenant de nombreuses
665 imbrications, tant pour leur création que pour leur maintenance. Une
666 convention permet d'éviter cette confusion : l'indentation. Pour
667 entrer un fichier avec de nombreux emboîtements d'accolades et de
668 crochets, il est d'usage d'avoir recours à une indentation qui indique
669 le niveau de profondeur. Formatter la musique de telle manière en
670 facilite la lecture et vous aide à insérer le bon nombre de caractère
671 ferment une expression. Par exemple,
684 Certains éditeurs disposent d'un mode spécifique pour taper des
685 fichiers LilyPond qui peut aider à l'indentation du fichier source.
686 Voir la section @ref{Editor support} pour plus d'informations.
691 Pour imprimer plus d'une portée, chaque partie de la musique faisant
692 l'objet d'une portée distincte est entrée en la faisant précéder de
693 @code{\new Staff}. Ces éléments @code{Staff} sont combinés en parallèle avec
694 @code{<<} et @code{>>} comme ci-dessous :
696 @lilypond[quote,fragment,verbatim]
698 \new Staff { \clef treble c'' }
699 \new Staff { \clef bass c }
704 La commande @code{\new} introduit un « contexte de notation.» Un contexte
705 de notation est un environnement dans lequel les évènements musicaux
706 (comme les notes ou les commandes @code{\clef}) sont interprétés.
707 Pour des pièces simples, ces contectes sont créés automatiquement. Pour
708 des œuvres plus complexes, il est préférable de marquer les contextes
709 explicitement. Cela assure que chaque fragment aura sa propre portée.
711 Il existe différents types de contextes. Portée (@code{Staff}), Voix
712 (@code{Voice}) et partition (@code{Score}) gèreent la notation de la
713 mélodie, alors que @code{Lyrics} gère les paroles et @code{ChordNames}
714 imprime le nom des accords.
716 En matière de syntaxe, faire précéder une expression musicale de
717 @code{\new} crée une plus grosse expression musicale. Pour conserver la
718 comparaison, cela ressemble au « moins » en mathématiques. La formule
719 @math{(4+5)} est une expression, donc @math{-(4+5)} est une plus grosse
722 Nous pouvons maintenant écrire une mélodie à deux portées.
724 @c TODO: (c) status of this Paul McCartney (?) song (let's all stand together)
726 @lilypond[fragment,quote,verbatim,ragged-right]
743 Pour plus d'informations sur les contextes voir leur description dans
744 @ref{Interpretation contexts}.
748 @node Adding articulation marks to notes
749 @section Adding articulation marks to notes
755 Les accents standards peuvent être ajoutés à une note en utilisant un tiret
756 (@samp{-}) et un caractère.
758 @lilypond[fragment,quote,verbatim,relative=2]
759 c-. c-- c-> c-^ c-+ c-_
763 De la même manière, les indications de doigté peuvent être ajoutées à
764 une note en utilisant un tiret (@samp{-}) et le chiffre à écrire.
766 @lilypond[fragment,quote,verbatim,relative=2]
770 Articulations et doigtés sont habituellement placés automatiquement,
771 mais vous pouvez spécifier l'emplacement en utilisant @samp{^} (en haut)
772 ou @samp{_} (en bas). Vous pouvez aussi utiliser plusieurs articulations
773 sur la même note. Dans la plupart des cas, cependant, il est mieux de
774 laisser LilyPond déterminer l'emplacement de l'articulation.
776 @lilypond[fragment,quote,verbatim,relative=2]
777 c_-^1 d^. f^4_2-> e^-_+
780 Les signes de nuances sont obtenus en ajoutant à la note les noms des nuances,
781 précédées d'un anti-slash (@samp{\}).
783 @lilypond[fragment,quote,verbatim,relative=2]
791 Crescendos et decrescendos débutent avec les commandes @code{\<} et
792 @code{\>}. Une nuance d'arrivée, par exemple @code{\f}, va finir le
793 (de)crescendo. La commande @code{\!} peut aussi être utilisée pour la
795 Crescendi and decrescendi are started with the commands @code{\<} and
796 @code{\>}. An ending dynamic, for example @code{\f}, will finish the
797 (de)crescendo, or the command @code{\!} can be used
799 @lilypond[fragment,quote,verbatim,relative=2]
807 Une liaison d'articulation (@rglos{slur}) est une courbe tendue
808 au-dessus de plusieurs notes. Elle indique un jeu legato. La note de
809 départ et celle d'arrivée sont marquées respectivement par @samp{(} et
812 @lilypond[fragment,quote,fragment,relative=2,verbatim]
813 d4( c16) cis( d e c cis d) e( d4)
816 @cindex slurs versus ties
817 Une liaison d'atriculation ressemble à une liaison de prolongation
818 (@rglos{tie}), mais signifie signifie autre chose. Une liaison de
819 prolongation fait durer la première note plus longtemps, et ne peut
820 être utilisée que sur deux notes de même hauteur. Ces deux types de
821 liaison peuvent être imbriqués.
823 @lilypond[quote,fragment,relative=2]
824 c2~( c8 fis fis4 ~ fis2 g2)
827 @cindex phrasing slurs
828 Une liaison de phrasé peut être entrée avec @code{\(} et @code{\)},
829 vous pouvez donc avoir simultanément des liaisons d'articulation et des
830 liaisons de phrasé. Vous ne pouvez pas avoir simultanément plusieurs
831 liaisons d'articulation ou simultanément plusieurs liaisons de phrasés.
833 @lilypond[quote,fragment,relative=2,verbatim]
834 a8(\( ais b c) cis2 b'2 a4 cis, c\)
838 Pour plus d'informations sur les
843 voir @ref{Fingering instructions}.
845 voir @ref{Articulations}.
848 @item Liaisons de phrasé
849 voir @ref{Phrasing slurs}.
856 @node Combining notes into chords
857 @section Combining notes into chords
860 Les accords peuvent être créés en entourant les notes avec les symboles
861 @samp{<} et @samp{>}.
863 @lilypond[quote,relative=1,fragment,verbatim]
868 Vous pouvez combiner les indications comme les liaisons et les liens de
869 croches avec les accords. Ils doivent cependant être placés en
870 dehors des symboles @samp{<} et @samp{>}
872 @lilypond[quote,relative=1,fragment,verbatim]
873 r4 <c e g>8[ <c f a>]~ <c f a>
877 r4 <c e g>8\>( <c e g> <c e g> <c f a>\!)
880 @lilypond[quote,relative=1,fragment]
882 r4 <c e g>8\>( <c e g> <c e g> <c f a>\!)
886 @node Advanced rhythmic commands
887 @section Advanced rhythmic commands
891 @cindex partial measure
892 Une levée est entrée avec le mot-clef @code{\partial}. Il est suivi par
893 une durée : @code{\partial 4} est une levée d'une noire et
894 @code{\partial 8} d'une croche.
896 @lilypond[quote,relative=2,verbatim,fragment]
903 Les n-olets sont créés avec le mot-clef @code{\times}. Il prend deux
904 arguments : une fraction et une de la musique. La durée de la partie
905 musique est multipliée par la fraction. Les triolets ne prennent que
906 2/3 du temps de leur notation réelle, cette fraction est donc de 2/3
909 @lilypond[quote,relative=1,verbatim,fragment]
910 \times 2/3 { f8 g a }
916 Les notes d'ornement sont aussi créées en préfixant une expression musicale
917 avec le mot-clef @code{\appoggiatura} ou @code{\acciaccatura}.
921 @lilypond[quote,relative=2,verbatim,fragment]
922 c4 \appoggiatura b16 c4
923 c4 \acciaccatura b16 c4
928 Pour plus d'informations sur les
933 voir @ref{Grace notes},
936 @item Mesures partielles
937 voir @ref{Partial measures}.
942 @node Commenting input files
943 @section Commenting input files
947 @cindex block comment
948 Un commentaire est une remarque à l'attention du lecteur du fichier
949 source ; il est ignoré lors de l'analyse du fichier, et n'aura donc
950 aucun effet sur la sortie imprimable. Il existe deux types
951 de commentaires. Le symbole pourcent @samp{%} introduit un commentaire
952 d'une ligne ; après @code{%}, le reste de la ligne est ignoré. Un bloc de
953 commentaire marque une section entière dans le fichier d'entrée. Tout ce
954 qui est à l'intérieur de @code{%@{} et @code{%@}} est ignoré. Le fragment
955 suivant montre les utilisations possible des commentaires.
958 % mélodie de "ah vous dirais-je maman"
962 Cette ligne, et les notes ci-dessous
963 sont ignorées, puisque'elles sont dans
964 un bloc de commentaire.
970 @c TODO post-2.6 reorg
971 @c This is good info, but I wouldn't call it a comment. IMO it should
972 @c be moved somewhere else.
976 Il y a une déclaration particulière qui est une sorte de commentaire. La
977 déclaration @code{\version} stipule le numéro de la version de LilyPond
978 pour laquelle le fichier a été écrit. Pour donner à un fichier la version
986 Ces annotations permettent de faciliter les prochaines mises à jour de
987 LilyPond. Les changements dans la syntaxe sont gérés avec un
988 programme spécial, @file{convert-ly} (voir @ref{Updating files with
989 convert-ly}), et il utilise @code{\version} pour déterminer les
990 règles de conversion à appliquer au fichier.
993 @node Printing lyrics
994 @section Printing lyrics
997 @c TODO: (c) status of the Queen fragment.
1001 Les paroles sont entrées en séparant chaque syllable par un espace.
1004 I want to break free
1009 @lilypond[quote,verbatim,fragment,ragged-right]
1011 r4 c \times 2/3 { f g g }
1012 \times 2/3 { g4( a2) }
1016 Les paroles peuvent être accolées à ces notes en les combinant avec le
1017 mot-clef @code{\addlyrics}
1019 @lilypond[quote,verbatim,fragment,ragged-right]
1022 r4 c \times 2/3 { f g g }
1023 \times 2/3 { g4( a2) }
1025 \addlyrics { I want to break free }
1030 @cindex extender line
1032 Cette mélodie se termine sur un mélisme (@rglos{melisma}),
1033 c'est-à-dire qu'une seule syllable (« free ») correspond à plus d'une
1034 note. Ceci est indiqué avec une @emph{ligne d'extension}. Elle est
1035 entrée avec deux caractères souligné (@code{_}), c'est à dire
1038 @{ I want to break free __ @}
1041 @lilypond[fragment,quote,ragged-right]
1044 r4 c \times 2/3 { f g g }
1045 \times 2/3 { g4( a2) }
1047 \addlyrics { I want to break free __ }
1051 De la même manière, les séparations syllabiques d'un mot peuvent être entrées
1052 avec deux tirets (@code{-}), ce qui produit un tiret centré entre les deux
1059 @c no ragged-right here, because otherwise the hypens get lost.
1060 @lilypond[fragment,quote]
1066 \addlyrics { A -- le gri -- a }
1070 Plus d'options, comme celle d'ajouter plusieurs lignes de paroles en dessous
1071 d'une même mélodie sont exposées dans @ref{Vocal music}.
1075 @section A lead sheet
1081 @c TODO: revise this, \chords { } is shorter and more intuitive.
1083 Dans la variété, il est courant d'indiquer l'accompagnement par le
1084 nom des accords. De tels accords peuvent être entrés comme les notes,
1086 @lilypond[quote,verbatim,ragged-right]
1087 \chordmode { c2 f4. g8 }
1091 Maintenant, chaque hauteur est lue comme la base de l'accord à la
1092 place de la note. Ce mode est activé avec @code{\chordmode}
1094 Les autres accords peuvent être créés en ajoutant des indications après
1095 deux points. L'exemple suivant montre quelques indications usuelles.
1097 @lilypond[quote,verbatim,ragged-right]
1098 \chordmode { c2 f4:m g4:maj7 gis1:dim7 }
1101 Pour la musique improvisée, les accords ne sont pas imprimés sur des
1102 portées mais comme des lignes à part entière. Ceci s'obtient en
1103 utilisant @code{\chords} à la place de @code{\chordmode}. La même
1104 syntaxe sera utilisé que dans le cas de@code{\chordmode}, mais le
1105 rendu des notes interviendra dans un contexte de @code{ChordNames},
1106 avec le résultat suivant.
1108 @lilypond[quote,verbatim,ragged-right]
1109 \chords { c2 f4.:m g4.:maj7 gis8:dim7 }
1113 Une fois assemblés, les accords, paroles et mélodie forment une
1114 partition d'improvisation :
1118 \chords @{ @emph{chords} @}
1120 \addlyrics @{ @emph{the text} @}
1125 @lilypond[quote,ragged-right]
1127 \chords { r2 c:sus4 f }
1129 r4 c' \times 2/3 { f g g }
1130 \times 2/3 { g4( a2) }
1132 \addlyrics { I want to break free __ }
1136 Une liste complète de modificateurs et d'autres options pour
1137 l'agencement des pages se trouve à la section @ref{Chords}.
1141 @section Adding titles
1143 Les informations bibliographiques sont entrées dans un bloc séparé, le
1144 bloc d'entête (@code{\header}). Le nom du morceau, son compositeur, etc, sont
1145 déterminés et affectés dans @code{\header@{@tie{}@dots{}@tie{}@}}.
1146 Le bloc @code{\header} est habituellement placé en début de fichier.
1152 composer = "Igor Stravinsky"
1159 Quand le fichier est traité, le titre et le compositeur sont imprimés en haut
1160 de la partition. Plus d'informations sur les titres peuvent être trouvées
1161 dans @ref{Creating titles}.
1164 @node Single staff polyphony
1165 @section Single staff polyphony
1168 @cindex multiple voices
1169 @cindex voices, more -- on a staff
1170 Quand différentes lignes mélodiques sont combinées sur une seule et
1171 même portée, elle sont imprimées comme des voix polyphoniques ; chaque
1172 voix a ses propre queues, liaisons et barres, la voix supérieure ayant
1173 les queues vers le haut, la voix du bas vers le bas.
1175 Saisir ce type de partition est réalisé en entrant chaque voix comme
1176 une chaine (avec @code{@{...@}}), et en les combinant simultanément
1177 en séparant les voix avec @code{\\}.
1179 @lilypond[quote,verbatim,relative=2,fragment]
1180 << { a4 g2 f4~ f4 } \\
1184 Pour l'écriture de musique polyphonique, des « blancs » (spacer rests)
1185 s'avèrent bien pratique ; ce sont des silences qui ne s'impriment pas. Ils
1186 sont utiles pour remplir les voix qui, temporairement, ne jouent pas. On peut
1187 voir ici le même exemple avec un « silence espace » (@code{s}) à la place
1188 d'un silence normal (@code{r}) :
1190 @lilypond[quote,verbatim,relative=2,fragment]
1191 << { a4 g2 f4~ f4 } \\
1196 Encore une fois, ces expressions peuvent s'imbriquer arbitrairement.
1198 @lilypond[quote,fragment,verbatim,relative=2,fragment]
1206 { <c g>1 ~ <c g>4 } \\
1212 Plus de fonctionnalités sur l'écriture polyphonique sont décrites à la
1213 section @ref{Basic polyphony} du manuel.
1217 @section Piano staves
1219 @cindex staff switch, manual
1220 @cindex cross staff voice, manual
1221 La musique pour piano s'écrit avec deux portées connectées par une
1222 accolade. Imprimer ce type de portée revient au même que dans l'exemple de
1223 musique polyphonique (@ref{More staves}),
1226 << \new Staff @{ @dots{} @}
1227 \new Staff @{ @dots{} @} >>
1231 mais maintenant cette expression entière doit être interprétée dans un
1232 contexte @code{PianoStaff}
1235 \new PianoStaff << \new Staff @dots{} >>
1238 Voici un petit exemple :
1240 @lilypond[quote,verbatim,relative=1,fragment]
1242 \new Staff { \time 2/4 c4 c g' g }
1243 \new Staff { \clef bass c,, c' e c }
1247 Plus d'informations sur le formatage de la musique pour piano sont
1248 données dans @ref{Piano music}.
1251 @node Organizing larger pieces
1252 @section Organizing larger pieces
1254 Quand tous les éléments discutés plus haut sont combinés ensemble pour
1255 produire un fichier plus volumineux, les blocs @code{\score}
1256 deviennent beaucoup plus gros parce que les expressions musicales
1257 sont plus longues et, dans le cas des pièces polyphoniques, très
1258 emboîtées. Ce type d'expression imposante finit par devenir peu maniable.
1260 En utilisant des variables, appelées également identifiants, il est
1261 possible de découper les expressions musicales complexes. Un identificateur
1262 est assigné comme suit :
1265 namedMusic = @{ @dots{} @}
1269 Le contenu de l'expression musicale @code{NomDeLaVariable}, peut être
1270 rappelé plus loin en faisant précéder son nom d'un anti-slash, par exemple
1271 @code{\NomDeLaVariable}. Dans l'exemple suivant, un motif de deux notes est
1272 répété deux fois en utilisant la substitution par une variable.
1274 @lilypond[quote,ragged-right,verbatim,nofragment]
1278 { \seufzer \seufzer }
1281 Le nom d'un identifiant ne doit comporter que des caractères
1282 alphabétiques, et pas de nombre, souligné ou tiret. L'assignation
1283 doit être faite en dehors de la musique.
1285 Il est possible d'utiliser des variables de plusieurs types d'objet.
1291 aFivePaper = \paper @{ paperheight = 21.0 \cm @}
1294 En fonction de son contenu, l'identifiant peut être utilisé à différents
1295 endroits. L'exemple suivant utilise la variable précédente :
1305 Plus d'informations sur les recours possibles aux identifiants
1306 sont données dans le manuel technique, section @ref{Input variables
1308 @c fixme: the ref is too technical.
1311 @node An orchestral part
1312 @section An orchestral part
1314 Pour la musique d'orchestre, toutes les notes sont imprimées deux fois.
1315 Une partition pour chaque pupître, et un conducteur pour le chef.
1316 Recourrir à des identifiants permet de s'épargner un double travail. La
1317 musique est entrée une seule fois, et enregistrée dans une variable. Le
1318 contenu de ces variables sera utilisé pour générer à la fois la
1319 partie d'instrument et le conducteur.
1321 Définir les notes dans un fichier spécial est très pratique. Par
1322 exemple, supposons que le fichier @file{horn-music.ly} contienne la
1323 partie d'un duo haubois/@/basson.
1326 hornNotes = \relative c @{
1333 Puis, une partie individuelle est faite en mettant ce qui suit dans
1337 \include "horn-music.ly"
1339 instrument = "Horn in F"
1343 \transpose f c' \hornNotes
1350 \include "horn-music.ly"
1354 substitue le contenu de @file{horn-music.ly} à cet endroit dans le
1355 fichier, ainsi @code{hornNotes} est définit pour ce qui suivra. La commande
1356 @code{\transpose f@tie{}c'} indique que l'argument, en l'occurence
1357 @code{\hornNotes}, doit être transposé une quinte au-dessus. Entendre
1358 @samp{fa} correspond à la notation @code{do'}, ce qui correspond à la
1359 transpostion d'un cor anglais en fa. La transposition peut être
1360 constatée dans la sortie suivante :
1362 @lilypond[quote,ragged-right]
1363 \transpose f c' \relative c {
1369 Dans la musique d'ensemble, il arrive souvent qu'une des voix ne joue
1370 pas pendant plusieurs mesures. Ceci est spécifié par un silence
1371 spécial, le silence multi-mesure (mesures à compter). Il est saisi
1372 par une lettre capitale @samp{R} suivie d'une durée (@code{1}@tie{}pour une
1373 ronde, @code{2}@tie{}pour une blanche, etc.). En multipliant la durée, on
1374 peut construire des silences plus longs. Par exemple, ce silence dure
1375 3@tie{}mesures à 2/4
1381 Pour l'impression de parties séparées, ces silences multi-mesures doivent être
1382 condensés. Ceci est réalisé en réglant une variable « run-time »
1385 \set Score.skipBars = ##t
1389 Cette commande règle la propriété @code{skipBars} dans le contexte
1390 @code{Score} à vrai (@code{##t}). Faire précéder la musique plus haut
1391 par ce silence et cette option à la musique produit au résultat suivant
1393 @lilypond[quote,ragged-right]
1394 \transpose f c' \relative c {
1396 \set Score.skipBars = ##t
1403 Le conducteur est créé en combinant ensemble toutes les parties. En
1404 supposant que l'autre voix soit dans @code{bassoonNotes} du fichier
1405 @file{bassoon-music.ly}, un conducteur est fait avec
1408 \include "bassoon-music.ly"
1409 \include "horn-music.ly"
1412 \new Staff \hornNotes
1413 \new Staff \bassoonNotes
1420 @lilypond[quote,ragged-right]
1428 r4 d,8 f | gis4 c | b bes |
1429 a8 e f4 | g d | gis f
1434 De plus amples informations sur la gestion des parties et conducteurs
1435 se trouvent dans le manuel de notation, section @ref{Orchestral music}.
1437 Le réglage des variables « run-time » ("propriétés") est abordé dans
1438 @ref{Changing context properties on the fly}.
1441 @node After the tutorial
1442 @section After the tutorial
1444 Après avoir parcouru ce tutoriel, vous devriez vous essayer à écrire
1445 un morceau ou deux. Commencez par l'une des matrices (@ref{Example
1446 templates}) et ajoutez-y des notes. Si vous utilisez une notation que
1447 vous n'avez pas trouvé dans le tutoriel, consultez la section Notation
1448 Reference (@ref{Basic notation}). Si vous désirez écrire pour un
1449 ensemble instrumental non couvert par les @ref{Example templates},
1450 lisez la section @ref{Extending the templates}.
1452 Après avoir écrit quelques pièces courtes, lisez les chapitres 3 à 5
1453 du utilisateur. Rien ne s'oppose à ce que vous consultiez dès à
1454 présent les autres chapitres, bien sûr ! Néanmoins, le reste du manuel
1455 utilisateur part du principe que vous avez déjà bien assimilé la
1456 syntaxe de LilyPond. Vous pouvez toujours survoler le reste du manuel,
1457 et y revenir plus tard, ayant acquis de l'expérience.