1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
2 @c This file is part of lilypond.tely
4 @c Translation of GIT committish: 829be449be664ea765ed43f5d56b50b41e43b397
6 @c When revising a translation, copy the HEAD committish of the
7 @c version that you are working on. Use
9 @c git-rev-list HEAD | head -1
14 @c * more details about running lilypond; error messages,
15 @c compiling/viewing (emacs?)
16 @c * where to go from First steps+More basics?
18 @c wherever possible, do not include index entries here; the
19 @c index should point to stuff in the reference manual. -gp
21 @c Your first LilyPond score in 10 minutes?
26 Ce tutoriel commence par une courte introduction au langage utilisé
27 par LilyPond pour représenter la musique. Après ce premier contact,
28 nous verrons comment produire une partition à imprimer. Vous serez
29 alors capable de créer et d'imprimer vos propres partitions.
32 Beaucoup de gens apprennent à utiliser les programmes en les essayant
33 et en bidouillant avec. C'est également possible avec LilyPond. Si
34 vous cliquez sur une image dans la version HTML de ce manuel, vous
35 verrez exactement le code LilyPond utilisé pour générer cette image.
36 Essayez sur cette image
38 @lilypond[fragment,quote,ragged-right,relative=2]
39 c-\markup { \bold \huge { Click here. } }
43 En copiant et en collant l'intégralité du code dans un fichier test,
44 vous aurez un modèle comme base pour expérimenter. Si vous
45 apprenez de cette façon, vous aurez probablement envie d'imprimer ou
50 @ref{Cheat sheet}, tableau qui répertorie les commandes usuelles
51 pour une consultation rapide.
55 * Running LilyPond for the first time::
56 * More about pitches::
58 * Automatic and manual beams::
60 * Music expressions explained::
62 * Adding articulation marks to notes::
63 * Combining notes into chords::
64 * Advanced rhythmic commands::
65 * Commenting input files::
69 * Single staff polyphony::
71 * Organizing larger pieces::
72 * An orchestral part::
73 * After the tutorial::
80 Le premier exemple montre comment écrire la partition la plus
81 élémentaire qui soit, une gamme (@rglos{scale}). Une @rglos{note} peut
82 être entrée en tapant son nom, de @samp{a} à @samp{g}. Donc si vous
92 le résultat ressemblera à
94 @lilypond[fragment,quote,notime,relative=1]
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 "catalan.ly"}
104 Tout extrait de code LilyPond doit être entouré d'une @{paire
105 d'accolades@}. Bien que la plupart des exemples de ce manuel n'en
106 comportent pas, ne les oubliez pas dans vos compositions !
108 De plus, de nombreux exemples utilisent le mode @code{relative}. Ceci
109 est expliqué à la section @ref{Octave entry} ; sachez dès à présent
110 que certains exemples devraient être libellés sous la forme
111 @code{\relative @{ @emph{...musique...} @}}.
112 De nombreux exemples ont aussi été compressés horizontalement pour
113 économiser de la place, grace à la commande
114 @code{\paper @{ragged-right = ##t @}}.
116 @cindex Case sensitive
117 Enfin, LilyPond est sensible à la casse. @code{ @{ c d e @} } est
118 un code valide ; @code{ @{ C D E @} } produira un message d'erreur.
120 La durée (@rglos{duration}) d'une note est spécifiée par un nombre
121 qui suit le nom de cette note : @samp{1} pour une ronde (@rglos{whole
122 note}), @samp{2} pour une blanche (@rglos{half note}), @samp{4} pour
123 une noire (@rglos{quarter note}) et ainsi de suite.
129 @lilypond[fragment,quote,notime,relative=2]
130 \set Staff.autoBeaming = ##f
131 { a1 a2 a4 a16 a32 s16_" " }
134 Si aucune durée n'est spécifiée, la dernière durée entrée est utilisée
135 pour les notes suivantes. La valeur implicite de la première note
136 dans les fichiers sources de la partition est la noire :
142 @lilypond[fragment,quote,notime,relative=2]
143 { a a8 a a2 a s16_" " }
147 On saisit un silence (@rglos{rest}) tout comme une note, mais avec le
154 @lilypond[fragment,quote,notime]
158 Ajouter un point @samp{.} après une durée permet d'obtenir une note
159 pointée (@rglos{dotted note})
165 @lilypond[fragment,quote,notime,relative=1]
166 { a2. a4 a8. a16 s16_" " }
169 La métrique (@rglos{time signature}) est définie par
170 la commande @code{\time}
178 @c A clef here may lead to confusion, remove it.
179 @lilypond[fragment,quote]
180 \override Staff.Clef #'transparent = ##t
189 La @rglos{clef} est définie par la commande @code{\clef}
198 @lilypond[fragment,quote,notime]
209 Pensez bien à encadrer les notes et les commandes avec des accolades
210 @code{@{@tie{}@dots{}@tie{}@}} pour pouvoir obtenir un résultat
213 @lilypond[fragment,quote,noindent,verbatim]
220 Pour plus d'informations sur
224 @item la définition des hauteurs et des durées
226 @ref{Pitches}, et @ref{Durations}.
231 @item la métrique et autres commandes liées au temps
232 voir @ref{Time signature}.
237 @node Running LilyPond for the first time
238 @section Running LilyPond for the first time
240 @c cheesy title to avoid clash with chapter name.
242 Dans la section précédente, nous avons vu quelles sortes d'éléments
243 peut contenir un fichier LilyPond. Dans cette section nous
244 expliquerons quelles commandes exécuter et comment voir ou imprimer le
245 résultat de LilyPond. Si vous n'avez jamais utilisé
246 LilyPond, voulez tester votre installation ou souhaitez compiler
247 vous-même un fichier d'exemple, lisez cette section.
249 @unnumberedsubsec MacOS X
251 Si vous double-cliquez sur LilyPond.app, un fichier d'exemple sera
252 ouvert. Sauvegardez-le, par exemple, sous @file{test.ly} sur votre
253 bureau, et traitez-le ensuite avec la commande du menu
254 @samp{Compile > Typeset File}.
255 Le fichier PDF résultant est alors affiché sur votre écran.
257 Prenez note que le premier démarrage prend une minute ou deux ,
258 car toutes les polices systèmes doivent être d'abord analysées.
260 @unnumberedsubsec Windows
262 Sous Windows, démarrez un éditeur de texte @footnote{N'importe quel
263 éditeur simple ou orienté programmation, qui prend en charge le
264 codage de caractères UTF-8, fera l'affaire, par exemple
265 Notepad. N'utilisez pas de traitement de texte car ceux-ci insèrent
266 des codes de formatage qui posent problème à LilyPond.} et saisissez
272 Enregistrez le sur le bureau sous @file{test.ly} et vérifiez bien
273 qu'il ne s'appelle pas @file{test.ly.TXT}. Double-cliquez sur le
274 fichier @file{test.ly} pour le traiter et afficher le fichier
278 @unnumberedsubsec Unix
280 Commencez par ouvrir une fenêtre de terminal et un éditeur de
281 texte. Par exemple, vous pouvez ouvrir un xterm et exécuter
282 @code{joe}. @footnote{Des fichiers de macros pour les fans de VIM et un
283 @code{LilyPond-mode} pour les fans d'Emacs existent. S'ils ne sont pas
284 encore installés, consultez le fichier @file{INSTALL.txt}.} Dans votre
285 éditeur, entrez le texte suivant et sauvegardez le fichier sous
293 Pour traiter @file{test.ly}, procédez comme ceci :
300 Vous verrez quelque chose ressemblant à :
307 Interpreting music... [1]
308 Preprocessing graphical objects...
309 Calculating line breaks... [2]
310 Layout output to `test.ps'...
311 Converting to `test.pdf'...
315 Suivant votre installation, les messages peuvent être traduits.
319 @cindex Viewing music
322 Le résultat est le fichier @file{test.pdf} que vous pouvez imprimer ou
323 visualiser avec les outils standards de votre système d'exploitation.
324 @footnote{Si votre système ne dispose pas des outils nécessaires,
326 @uref{http://@/www@/.cs@/.wisc@/.edu/@/~ghost/,Ghostscript}, un
327 programme pour voir et imprimer les fichiers PDF et PostScript.}
329 @node More about pitches
330 @section More about pitches
332 Un dièse (@rglos{sharp}) s'obtient en ajoutant @samp{is} au nom de la
333 note, un bémol (@rglos{flat}) en ajoutant @samp{es}. Comme vous pouvez
334 vous y attendre, un double dièse ou double bémol est obtenu en
335 ajoutant @samp{isis} ou @samp{eses}@footnote{Cette syntaxe est dérivée
336 de la convention de dénomination des notes dans les langues nordiques
337 et germaniques, comme l'allemand ou le hollandais.}.
340 Si vous utilisez la commande @samp{\include "catalan.ly"} pour entrer
341 les noms de notes français au lieu des noms hollandais, il faudra
342 ajouter un @samp{d} pour un dièse, et un @samp{b} pour un bèmol. Le
343 double dièse et le double bémol s'obtiennent en ajoutant
344 respectivement @samp{dd} et @samp{bb}
351 @lilypond[fragment,quote,notime]
352 \set Score.timing = ##f
353 \transpose c c' { cis1 ees fisis aeses s16_" " }
356 @cindex key signature, setting
357 L'armure est déterminée par la commande @code{\key}, suivie d'une
358 hauteur puis de @code{\major} (majeur) ou @code{\minor} (mineur) :
367 @lilypond[fragment,quote,notime,fragment]
375 La combinaison de l'armure et des hauteurs de note -- y compris les
376 altérations -- permet de déterminer dans quel cas afficher les
377 altérations accidentelles. Cette fonctionnalité est souvent source de
378 confusion pour les nouveaux utilisateurs, aussi expliquons-la en
382 LilyPond fait une nette distinction entre le contenu musical et la
383 mise en forme. L'altération d'une note -- bémol, bécarre ou dièse --
384 fait partie de sa hauteur, et donc du contenu musical. La présence
385 d'une altération accidentelle -- un @emph{signe} bémol, bécarre ou
386 dièse -- devant la note correspondante est une question de mise en
387 page. La mise en page est un processus qui obéit à des règles ; les
388 altérations accidentelles sont donc automatiquement imprimées suivant
389 ces règles. Les hauteurs de note appartiennent à la musique que vous
390 entrez, et comme vous êtes sensé(e) entrer ce que vous voulez entendre,
391 LilyPond, qui n'est chargé que de la gravure, ne les choisit pas à
396 @lilypond[quote,notime,fragment]
402 si aucune note n'a d'altération accidentelle, vous devez
411 Le code @samp{d} ne veut pas dire « imprimer un point noir juste
412 en-dessous de la portée. » Cela signifie plutôt : « une note ayant la
413 hauteur ré naturel. » Avec l'armure de la bémol majeur, ce ré sera flanqué
414 d'un bécarre accidentel.
416 @lilypond[quote,notime,fragment,relative=1,verbatim]
421 Ajouter explicitement toutes les altérations requiert un peu plus
422 d'effort dans la phase de saisie, mais avec l'avantage que la
423 transposition en sera facilitée. De plus les altérations accidentelles
424 peuvent être imprimées suivant plusieurs conventions. Regardez
425 @ref{Automatic accidentals} pour connaître la manière dont les
426 altérations accidentelles peuvent être imprimées suivant différentes
430 Pour plus d'informations sur
434 @item les altérations accidentelles
435 voir @ref{Automatic accidentals}.
438 voir @ref{Key signature}.
443 @section Entering ties
446 Une liaison de prolongation@footnote{parfois aussi appelée liaison de
447 tenue.} (@rglos{tie}) est créée en ajoutant un tilde @samp{~} à
448 la suite de la première note liée.
450 @lilypond[quote,notime,fragment,verbatim,relative=3]
454 Pour plus d'informations sur les liaisons de prolongation, voir @ref{Ties}.
458 @node Automatic and manual beams
459 @section Automatic and manual beams
461 @cindex beams, by hand
462 Toutes les ligatures@footnote{parfois appelées aussi liens de croches}
463 (@rglos{beam}), sont dessinées automatiquement :
465 @lilypond[quote,fragment,relative=2,verbatim]
470 Si l'emplacement des barres ne vous convient pas, vous pouvez
471 les entrer à la main. Marquer la première note à être attachée d'un
472 @samp{[} et la dernière d'un @samp{]}.
474 @lilypond[quote,fragment,relative=2,verbatim]
478 Pour plus d'informations sur les ligatures, voir @ref{Manual beams}.
481 Voici comment se comportent ensemble armures, altérations
482 accidentelles et liaisons :
484 @lilypond[fragment,quote,noindent,line-width=50\staff-space,verbatim]
491 fis4 fis8 fis8 eis4 a8 gis~
500 Il y a plusieurs points intéressants à noter dans cet exemple. Les
501 barres de mesure et les liens de croches sont dessinés
502 automatiquement. Les sauts de ligne sont calculés automatiquement ;
503 peu importe où se situent les sauts de ligne dans le fichier source.
504 Enfin, l'ordre dans lequel la métrique, l'armure et les changements de
505 clefs sont saisis n'a pas d'importance : dans la sortie imprimable,
506 ils sont organisés suivant les conventions standard de notation.
511 @section Octave entry
514 @c Tim wants to move this quotes example just before the: quotes-do not-work
515 @c score, but we'd need to remove quotes from the other two (key and
518 @c better to have this just before the `octaves are bad' snipped
519 @c but we'd need to remove the ', from \key and tie
520 Pour hausser une note d'une octave, ajoutez une apostrophe @code{'} au
521 nom de la note ; pour la baisser d'une octave, ajoutez une virgule
522 @code{,}. Le do central (entre la clef de sol et la clef de fa) est
525 @lilypond[quote,notime,fragment,verbatim]
526 c'4 c'' c''' \clef bass c c,
529 Un exemple de l'utilisation des apostrophes dans ce fragment de Mozart :
531 @lilypond[quote,ragged-right,fragment,verbatim]
534 cis''8. d''16 cis''8 e''4 e''8
535 b'8. cis''16 b'8 d''4 d''8
539 Cet exemple montre qu'il faut beaucoup d'apostrophes pour écrire de la
540 musique dans un registre aigu. Ceci rend le fichier moins lisible, et
541 c'est une source d'erreurs. La solution consiste à utiliser le mode
542 d'« octaves relatives ». C'est la façon la plus commode de copier de
543 la musique existante.
545 En mode relatif, une note sans signe d'octaviation -- @code{'} ou
546 @code{,} après le nom de la note -- est interprétée de manière à ce
547 qu'elle soit la plus proche de la note précédente. Par exemple,
548 @samp{c f} monte, alors que @samp{c g} descend.
550 Pour utiliser le mode relatif, ajoutez @code{\relative} avant le
551 morceau de musique. La première hauteur de note est choisie
552 relativement en fonction du do central -- c'est-à-dire @code{c'}.
556 @lilypond[quote,notime,fragment,verbatim]
563 Puisque la plus grande partie de la musique utilise de petits
564 intervalles, les pièces peuvent être écrites en mode relatif sans
565 pratiquement utiliser de signes d'octavation. L'exemple précédent est
568 @lilypond[quote,ragged-right,verbatim]
572 cis'8. d16 cis8 e4 e8
577 @c needed better, maybe even redundant explanation
578 @c added another example below.
579 @c grappig: Pa vond het heel logies, en slim toen-i eenmaal begreep.
580 @c in eerste instantie drong het `relative' niet door zonder extra uitleg.
581 Les intervalles plus grands qu'une quarte sont produits en ajoutant
582 les signes d'octavation :
584 @lilypond[quote,notime,verbatim,fragment]
590 En résumé, apostrophes et virgules ne déterminent pas la hauteur
591 absolue d'une note dans le mode @code{\relative}. Au lieu de cela, la
592 hauteur de la note est relative à la précédente, et modifier l'octave
593 d'une seule note changera l'octave de toutes les notes suivantes.
595 Pour plus d'information sur les octaves relatives, voir
596 @ref{Relative octaves}, et @ref{Octave check}.
599 @node Music expressions explained
600 @section Music expressions explained
603 Dans les fichiers source LilyPond, la musique est représentée par ce qu'on
604 appelle des @emph{expressions musicales}. Nous en avons déjà vu dans
605 les quelques exemples précédents ; une seule note constitue une
606 expression musicale :
608 @lilypond[fragment,quote,verbatim,relative=3]
612 Mettre un groupe de notes entre accolades crée une nouvelle expression
615 @lilypond[fragment,quote,verbatim,relative=3]
619 Placer une séquence d'expressions musicales -- des notes par exemple
620 -- entre accolades signifie qu'elles doivent être jouées
621 successivement, les unes après les autres. Le résultat est une
622 expression, qui peut elle-même être regroupée séquentiellement avec
623 d'autres expressions. Ici, l'expression de l'exemple précédent est
624 combinée à deux notes :
626 @lilypond[fragment,quote,verbatim,relative=3]
630 Cette technique est utile pour de la musique non monophonique. Pour
631 entrer une musique avec plusieurs voix ou plusieurs portées, nous
632 pouvons aussi combiner en parallèle les expressions. Deux voix qui doivent être
633 jouées en même temps, sont entrées comme une combinaison simultanée de
634 deux expression. Une expression musicale « simultanée » est formée en
635 entourant les expressions entre @code{<<} et @code{>>}. Dans l'exemple
636 suivant, trois expressions (contenant chacune deux notes distinctes) sont
637 combinées simultanément.
639 @lilypond[fragment,quote,verbatim,relative=3]
647 Ce mécanisme est similaire au formules mathématiques : une grosse formule
648 est créée en assemblant plusieurs petites formules. Ces types
649 de formules, appelées expressions, ont une définition récursive, de
650 telle sorte que vous pouvez fabriquer des expressions
651 arbitrairement longues et complexes. Par exemple,
660 ((1 + 2) * 3) / (4 * 5)
664 @cindex music expression
665 Ceci est une suite d'expressions, où chacune est contenue dans la
666 suivante. Les expressions les plus simples sont les nombres, et de
667 plus grandes expressions sont produites en combinant des expressions
668 avec des opérateurs -- comme @samp{+}, @samp{*} et @samp{/} -- et des
669 parenthèses. Tout comme les expressions mathématiques, les expressions
670 musicales peuvent être imbriquées avec une profondeur arbitraire, ce
671 qui est nécessaire pour de la musique complexe comme des partitions
674 Notez que l'exemple suivant ne comporte qu'une seule portée,
675 contrairement à l'exemple précédent qui contenait trois portées
676 séparées. C'est parce que l'exemple commence par une note seule. Pour
677 déterminer le nombre de portées, LilyPond regarde le premier élément
678 qui n'est pas une accolade. Si c'est une seule note, il y a une portée
679 ; si c'est une expression simultanée, il y aura plus d'une portée.
681 @lilypond[fragment,quote,verbatim,relative=2]
684 << { e f } { c <<b d>> } >>
688 Il est facile de s'y perdre avec des fichiers musicaux comprenant de nombreuses
689 imbrications, tant pour leur création que pour leur maintenance. Une
690 convention permet d'éviter cette confusion : l'indentation. Pour
691 entrer un fichier avec de prfondes imbrications d'accolades et de
692 crochets, il est d'usage d'avoir recours à une indentation qui indique
693 le niveau de profondeur. Formater la musique d'une telle manière en
694 facilite la lecture et vous aide à insérer le bon nombre d'accolades
695 fermant les expressions. Par exemple,
708 Certains éditeurs disposent d'un mode spécifique pour saisir des
709 fichiers LilyPond, qui peut vous aider à indenter le fichier source.
710 Voir la section @ref{Editor support} pour plus d'informations.
715 Pour créer plus d'une portée, chaque partie de la musique constituant
716 une portée est entrée en la faisant précéder de
717 @code{\new Staff}. Ces éléments @code{Staff} sont combinés en parallèle avec
718 @code{<<} et @code{>>}, comme
720 @lilypond[quote,fragment,verbatim]
722 \new Staff { \clef treble c'' }
723 \new Staff { \clef bass c }
728 La commande @code{\new} introduit un « contexte de notation ». Un
729 contexte de notation est un environnement dans lequel les événements
730 musicaux -- comme les notes ou les commandes @code{\clef} -- sont
731 interprétés. Pour des pièces simples, ces contextes sont créés
732 automatiquement. Pour des pièces plus complexes, il est préférable de
733 spécifier explicitement les contextes. Cela assure que chaque fragment
734 aura sa propre portée.
736 Il existe différents types de contextes. Les contextes @code{Staff}
737 (portée), @code{Voice} (voix) et @code{Score} (partition) gèrent la
738 notation de la mélodie, alors que @code{Lyrics} gère les paroles et
739 @code{ChordNames} imprime le nom des accords.
741 En termes de syntaxe, faire précéder une expression musicale de
742 @code{\new} crée une plus grosse expression musicale. En reprenant la
743 comparaison, cela ressemble au signe « moins » en mathématiques. La formule
744 @math{(4+5)} est une expression, donc @math{-(4+5)} est une plus grosse
747 Nous pouvons maintenant écrire un morceau à deux portées :
749 @c TODO: (c) status of this Paul McCartney (?) song (let's all stand together)
751 @lilypond[fragment,quote,verbatim,ragged-right]
768 Pour plus d'informations sur les contextes, voir leur description à
769 @ref{Interpretation contexts}.
773 @node Adding articulation marks to notes
774 @section Adding articulation marks to notes
780 Les articulations standard peuvent être ajoutées à une note en
781 utilisant un tiret (@samp{-}) et un caractère :
783 @lilypond[fragment,quote,verbatim,relative=2]
784 c-. c-- c-> c-^ c-+ c-_
788 De la même manière, des indications de doigté peuvent être ajoutées à
789 une note en utilisant un tiret (@samp{-}) et le chiffre à écrire :
791 @lilypond[fragment,quote,verbatim,relative=2]
795 Articulations et doigtés sont habituellement placés automatiquement,
796 mais vous pouvez spécifier une direction en utilisant @samp{^} (en haut)
797 ou @samp{_} (en bas). Vous pouvez aussi utiliser plusieurs articulations
798 sur la même note. Dans la plupart des cas, cependant, il est mieux de
799 laisser LilyPond déterminer l'emplacement de l'articulation.
801 @lilypond[fragment,quote,verbatim,relative=2]
802 c_-^1 d^. f^4_2-> e^-_+
805 Les signes de nuances sont obtenus en ajoutant à la note les noms des nuances,
806 précédées d'un anti-slash @samp{\} :
808 @lilypond[fragment,quote,verbatim,relative=2]
816 Crescendi et decrescendi débutent avec les commandes @code{\<} et
817 @code{\>}. Ils se terminent soit par une nuance d'arrivée, par exemple @code{\f},
818 soit par la commande @code{\!} :
820 @lilypond[fragment,quote,verbatim,relative=2]
828 Une liaison d'articulation (@rglos{slur}) est une courbe tracée
829 au-dessus de plusieurs notes. Elle indique un jeu legato. Les notes de
830 départ et d'arrivée sont suivies respectivement par @samp{(} et
833 @lilypond[fragment,quote,fragment,relative=2,verbatim]
834 d4( c16) cis( d e c cis d) e( d4)
837 @cindex slurs versus ties
838 Une liaison d'articulation ressemble à une liaison de
839 prolongation (@rglos{tie}),
840 mais a une signification différente. Une liaison de prolongation fait
841 durer la première note plus longtemps, et ne peut être utilisée que
842 sur une paire de notes de même hauteur. Ces deux types de liaison
843 peuvent être imbriqués :
845 @lilypond[quote,fragment,relative=2]
846 c2~( c8 fis fis4 ~ fis2 g2)
849 @cindex phrasing slurs
850 Une liaison de phrasé peut être entrée avec @code{\(} et @code{\)},
851 vous pouvez donc avoir simultanément une liaison d'articulation et une
852 liaison de phrasé. Vous ne pouvez pas avoir de liaisons d'articulation
853 simultanées ni de liaisons de phrasé simultanées.
855 @lilypond[quote,fragment,relative=2,verbatim]
856 a8(\( ais b c) cis2 b'2 a4 cis, c\)
860 Pour plus d'informations sur les
865 voir @ref{Fingering instructions}.
867 voir @ref{Articulations}.
868 @item liaisons d'articulation
870 @item liaisons de phrasé
871 voir @ref{Phrasing slurs}.
878 @node Combining notes into chords
879 @section Combining notes into chords
882 Des accords peuvent être produits en entourant les hauteurs de note
883 avec les angles gauche et droit -- @samp{<} et @samp{>} --
885 @lilypond[quote,relative=1,fragment,verbatim]
890 Vous pouvez combiner les indications comme les liaisons et les liens de
891 croches avec les accords. Ils doivent cependant être placés en
894 @lilypond[quote,relative=1,fragment,verbatim]
895 r4 <c e g>8[ <c f a>]~ <c f a>
899 r4 <c e g>8\>( <c e g> <c e g> <c f a>\!)
902 @lilypond[quote,relative=1,fragment]
904 r4 <c e g>8\>( <c e g> <c e g> <c f a>\!)
908 @node Advanced rhythmic commands
909 @section Advanced rhythmic commands
913 @cindex partial measure
914 Une levée est entrée avec le mot-clé @code{\partial}. Il est suivi par
915 une durée : @code{\partial 4} est une levée d'une noire et
916 @code{\partial 8} d'une croche.
918 @lilypond[quote,relative=2,verbatim,fragment]
925 Les n-olets sont créés avec le mot-clef @code{\times}. Celui-ci prend
926 deux arguments : une fraction et une expression musicale. La durée des
927 notes de l'expression musicale est multipliée par la fraction. Les
928 notes d'un triolet durent les deux tiers du temps de leur notation
929 réelle, cette fraction est donc de 2/3 pour les triolets :
931 @lilypond[quote,relative=1,verbatim,fragment]
932 \times 2/3 { f8 g a }
938 Des notes d'ornement sont produites en préfixant une expression musicale
939 avec le mot-clé @code{\appoggiatura} ou @code{\acciaccatura} :
943 @lilypond[quote,relative=2,verbatim,fragment]
944 c4 \appoggiatura b16 c4
945 c4 \acciaccatura b16 c4
950 Pour plus d'informations sur les
955 voir @ref{Grace notes},
958 @item mesures incomplètes (levées)
959 voir @ref{Partial measures}.
964 @node Commenting input files
965 @section Commenting input files
969 @cindex block comment
970 Un commentaire est une remarque à l'attention du lecteur du fichier
971 source ; il est ignoré lors de l'analyse du fichier, et n'a donc
972 aucun effet sur la sortie imprimable. Il existe deux types
973 de commentaires. Le symbole pourcent @samp{%} introduit un commentaire
974 d'une ligne : après @code{%}, le reste de la ligne est ignoré. Un bloc de
975 commentaire marque une section entière dans le fichier d'entrée. Tout ce
976 qui est à l'intérieur de @code{%@{} et @code{%@}} est ignoré. Le fragment
977 suivant montre les utilisations possible des commentaires :
980 % mélodie de "ah vous dirais-je maman"
984 Cette ligne, et les notes ci-dessous
985 sont ignorées, puisque'elles sont dans
986 un bloc de commentaire.
992 @c TODO post-2.6 reorg
993 @c This is good info, but I wouldn't call it a comment. IMO it should
994 @c be moved somewhere else.
998 Il y a une déclaration particulière qui est une sorte de commentaire. La
999 déclaration @code{\version} stipule le numéro de la version de LilyPond
1000 pour laquelle le fichier a été écrit. Pour donner à un fichier la version
1008 Cette annotation permet de faciliter les prochaines mises à jour de
1009 LilyPond. Les changements dans la syntaxe sont gérés avec un
1010 programme spécial, @file{convert-ly} -- voir
1011 @ref{Updating files with convert-ly} -- et il utilise @code{\version}
1012 pour déterminer les règles de conversion à appliquer au fichier.
1015 @node Printing lyrics
1016 @section Printing lyrics
1019 @c TODO: (c) status of the Queen fragment.
1023 Les paroles sont entrées en séparant chaque syllable par un espace :
1026 I want to break free
1031 @lilypond[quote,verbatim,fragment,ragged-right]
1033 r4 c \times 2/3 { f g g }
1034 \times 2/3 { g4( a2) }
1038 Les paroles peuvent être associées à ces notes en les combinant avec le
1039 mot-clé @code{\addlyrics}
1041 @lilypond[quote,verbatim,fragment,ragged-right]
1044 r4 c \times 2/3 { f g g }
1045 \times 2/3 { g4( a2) }
1047 \addlyrics { I want to break free }
1052 @cindex extender line
1054 Cette mélodie se termine sur un mélisme (@rglos{melisma}),
1055 c'est-à-dire qu'une seule syllable (« free ») correspond à plus d'une
1056 note. Ceci est indiqué avec une @emph{ligne d'extension}. Elle est
1057 entrée avec deux caractères souligné (@code{_}), c'est-à-dire
1060 @{ I want to break free __ @}
1063 @lilypond[fragment,quote,ragged-right]
1066 r4 c \times 2/3 { f g g }
1067 \times 2/3 { g4( a2) }
1069 \addlyrics { I want to break free __ }
1073 De la même manière, les séparations syllabiques d'un mot peuvent être entrées
1074 avec deux tirets (@code{-}), ce qui produit un tiret centré entre les deux
1081 @c no ragged-right here, because otherwise the hypens get lost.
1082 @lilypond[fragment,quote]
1088 \addlyrics { A -- le gri -- a }
1092 Plus de possibilités, comme celle d'ajouter plusieurs lignes de
1093 paroles en dessous d'une même mélodie sont exposées à
1098 @section A lead sheet
1104 @c TODO: revise this, \chords { } is shorter and more intuitive.
1106 Dans la musique de variété, il est courant d'indiquer l'accompagnement
1107 par le nom des accords. De tels accords peuvent être entrés comme les
1110 @lilypond[quote,verbatim,ragged-right]
1111 \chordmode { c2 f4. g8 }
1115 Maintenant, chaque hauteur est lue comme la base de l'accord à la
1116 place de la note. Ce mode est activé avec @code{\chordmode}.
1118 Les autres accords peuvent être créés en ajoutant des modifiacteurs après
1119 deux points. L'exemple suivant montre quelques modificateurs usuels :
1121 @lilypond[quote,verbatim,ragged-right]
1122 \chordmode { c2 f4:m g4:maj7 gis1:dim7 }
1125 Pour la musique improvisée, les accords ne sont pas imprimés sur des
1126 portées mais comme des lignes à part entière. Ceci s'obtient en
1127 utilisant @code{\chords} à la place de @code{\chordmode}. La même
1128 syntaxe sera utilisée que dans le cas de@code{\chordmode}, mais le
1129 rendu des notes interviendra dans un contexte de @code{ChordNames},
1130 avec le résultat suivant
1132 @lilypond[quote,verbatim,ragged-right]
1133 \chords { c2 f4.:m g4.:maj7 gis8:dim7 }
1137 Une fois assemblés, les accords, paroles et mélodie forment une
1138 partition de chanson :
1142 \chords @{ @emph{les accords} @}
1144 \addlyrics @{ @emph{le texte} @}
1149 @lilypond[quote,ragged-right]
1151 \chords { r2 c:sus4 f }
1153 r4 c' \times 2/3 { f g g }
1154 \times 2/3 { g4( a2) }
1156 \addlyrics { I want to break free __ }
1160 Une liste complète de modificateurs et d'autres options de
1161 mise en forme se trouve à la section @ref{Chords}.
1165 @section Adding titles
1167 Les informations bibliographiques sont entrées dans un bloc séparé, le
1168 bloc d'en-tête (@code{\header}). Le nom du morceau, son compositeur, etc., sont
1169 définis dans @code{\header@{@tie{}@dots{}@tie{}@}}.
1170 Le bloc @code{\header} est habituellement placé en début de fichier.
1176 composer = "Igor Stravinsky"
1183 Quand le fichier est traité, le titre et le compositeur sont imprimés
1184 en haut de la partition. Vous trouverez plus d'informations sur les
1185 titres à @ref{Creating titles}.
1188 @node Single staff polyphony
1189 @section Single staff polyphony
1192 @cindex multiple voices
1193 @cindex voices, more -- on a staff
1194 Quand différentes lignes mélodiques sont combinées sur une seule et
1195 même portée, elle sont imprimées comme des voix polyphoniques ; chaque
1196 voix a ses propre hampes@footnote{familièrement appelées queues de
1197 note.}, liaisons et ligatures, la voix supérieure ayant les hampes
1198 vers le haut, la voix inférieure vers le bas.
1200 Ce type de partition est réalisé en entrant chaque voix comme
1201 une séquence (avec @code{@{...@}}), en combinant simultanément les
1202 voix et en les séparant par @code{\\} :
1204 @lilypond[quote,verbatim,relative=2,fragment]
1205 << { a4 g2 f4~ f4 } \\
1209 Pour l'écriture de musique polyphonique, les silences invisibles
1210 (spacer rests) s'avèrent bien pratiques ; ce sont des silences qui ne
1211 s'impriment pas. Ils sont utiles pour remplir des voix qui,
1212 temporairement, ne jouent rien. On peut voir ici le même exemple avec
1213 un silence espace invisible (@code{s}) à la place d'un silence normal
1216 @lilypond[quote,verbatim,relative=2,fragment]
1217 << { a4 g2 f4~ f4 } \\
1222 Encore une fois, ces expressions peuvent s'imbriquer arbitrairement :
1224 @lilypond[quote,fragment,verbatim,relative=2,fragment]
1232 { <c g>1 ~ <c g>4 } \\
1238 Plus de fonctionnalités sur l'écriture polyphonique sont décrites à la
1239 section @ref{Basic polyphony} du manuel.
1243 @section Piano staves
1245 @cindex staff switch, manual
1246 @cindex cross staff voice, manual
1247 La musique pour piano s'écrit avec deux portées reliées par une
1248 accolade. Imprimer ce type de portée revient au même que dans l'exemple de
1249 musique polyphonique (@ref{More staves}),
1252 << \new Staff @{ @dots{} @}
1253 \new Staff @{ @dots{} @} >>
1257 mais maintenant cette expression entière doit être interprétée dans un
1258 contexte @code{PianoStaff}
1261 \new PianoStaff << \new Staff @dots{} >>
1264 Voici un petit exemple :
1266 @lilypond[quote,verbatim,relative=1,fragment]
1268 \new Staff { \time 2/4 c4 c g' g }
1269 \new Staff { \clef bass c,, c' e c }
1273 Plus d'informations sur le formatage de la musique pour piano sont
1274 données à @ref{Piano music}.
1277 @node Organizing larger pieces
1278 @section Organizing larger pieces
1280 Lorsqu'on combine tous les éléments étudiés plus haut pour produire
1281 des fichiers plus volumineux, les blocs @code{\score} deviennent
1282 beaucoup plus gros parce que les expressions musicales sont plus
1283 longues et, dans le cas des pièces polyphoniques, profondément
1284 imbriquées. De telles expressions imposantes finissent par devenir peu
1287 En utilisant des variables, appelées également identificateurs, il est
1288 possible de découper des expressions musicales complexes. Un identificateur
1292 MusiqueToto = @{ @dots{} @}
1296 Le contenu de l'expression musicale @code{MusiqueToto}, peut être
1297 utilisé plus loin en faisant précéder son nom d'un anti-slash, c'est-à-dire
1298 @code{\MusiqueToto}. Dans l'exemple suivant, un motif de deux notes est
1299 répété deux fois en utilisant la substitution par une variable :
1301 @lilypond[quote,ragged-right,verbatim,nofragment]
1305 { \seufzer \seufzer }
1308 Le nom d'un identificateur ne doit comporter que des caractères
1309 alphabétiques non accentués, aucun nombre ni tiret. On doit le définir
1310 en dehors de toute expression musicale.
1312 Il est possible d'utiliser des variables de types variés.
1318 papierACinq = \paper @{ paperheight = 21.0 \cm @}
1321 En fonction de son contenu, l'identificateur peut être utilisé à différents
1322 endroits. L'exemple suivant utilise la variable précédente :
1327 line-width = \largeur
1332 Vous trouverez plus d'informations sur les usages possibles des
1333 identificateurs dans le manuel technique, section
1334 @ref{Input variables and Scheme}.
1335 @c fixme: the ref is too technical.
1338 @node An orchestral part
1339 @section An orchestral part
1341 Pour la musique d'orchestre, toute la musique est imprimée deux fois.
1342 Une partie séparée pour chaque pupitre, et un conducteur pour le chef.
1343 Recourir à des identifiants permet de s'épargner un double travail. La
1344 musique est entrée une seule fois, et enregistrée dans une variable. Le
1345 contenu de ces variables sera utilisé pour générer à la fois la
1346 partie d'instrument et le conducteur.
1348 Définir les notes dans un fichier à part est très pratique. Par
1349 exemple, supposons que le fichier @file{musique-cor.ly} contienne la
1350 partie d'un duo cor/@/basson :
1353 notesCor = \relative c @{
1360 Puis, une partie individuelle est créée en mettant ce qui suit dans
1364 \include "musique-cor.ly"
1366 instrument = "Cor en fa"
1370 \transpose f c' \notesCor
1377 \include "musique-cor.ly"
1381 indique à LilyPond de lire le contenu de @file{musique-cor.ly} à cet
1382 endroit dans le fichier, ainsi @code{notesCor} est défini pour ce qui
1383 suivra. La commande @code{\transpose f@tie{}c'} indique que
1384 l'argument, en l'occurence @code{\notesCor}, doit être transposé d'une
1385 quinte ascendante. Le son entendu @samp{fa} correspond à la note écrite
1386 @code{do'}, ce qui correspond bien à la transpostion d'un cor en
1387 fa. La transposition peut être constatée dans la sortie suivante :
1389 @lilypond[quote,ragged-right]
1390 \transpose f c' \relative c {
1396 Dans la musique d'ensemble, il arrive souvent qu'une des voix ne joue
1397 pas pendant plusieurs mesures. Ceci est spécifié par un silence
1398 spécial, le silence multi-mesures (mesures à compter). Il est saisi
1399 par une lettre capitale @samp{R} suivie d'une durée (@code{1}@tie{}pour une
1400 ronde, @code{2}@tie{}pour une blanche, etc.). En multipliant la durée, on
1401 peut construire des silences plus longs. Par exemple, ce silence dure
1402 3@tie{}mesures à 2/4
1408 Pour l'impression de parties séparées, ces silences multi-mesures doivent être
1409 condensés. On peut l'obtenir en réglant une variable d'exécution
1412 \set Score.skipBars = ##t
1416 Cette commande règle la propriété @code{skipBars} dans le contexte
1417 @code{Score} à vrai (@code{##t}). En faisant précéder la musique plus haut
1418 du silence et de cette option, on obtient
1420 @lilypond[quote,ragged-right]
1421 \transpose f c' \relative c {
1423 \set Score.skipBars = ##t
1430 On crée le conducteur en combinant toutes les parties. En
1431 supposant que l'autre voix soit dans l'expression @code{notesBasson} du fichier
1432 @file{musique-basson.ly}, le conducteur est composé des commandes
1435 \include "musique-cor.ly"
1436 \include "musique-basson.ly"
1439 \new Staff \notesCor
1440 \new Staff \notesBasson
1445 donnant pour résultat
1447 @lilypond[quote,ragged-right]
1455 r4 d,8 f | gis4 c | b bes |
1456 a8 e f4 | g d | gis f
1461 De plus amples informations sur la gestion des parties et conducteurs
1462 se trouvent dans le manuel de notation, section @ref{Orchestral music}.
1464 Le réglage des variables d'exécution (« propriétés ») est abordé dans
1465 @ref{Changing context properties on the fly}.
1468 @node After the tutorial
1469 @section After the tutorial
1471 Après avoir parcouru ce tutoriel, vous devriez vous essayer à écrire
1472 un morceau ou deux. Commencez par copier l'un des modèles types (@ref{Example
1473 templates}) et ajoutez-y des notes. Si vous voulez employer une notation que
1474 vous n'avez pas trouvé dans le tutoriel, consultez la référence de
1475 notation, en commençant par la @ref{Basic notation}. Si vous désirez écrire pour un
1476 ensemble instrumental non couvert par les @ref{Example templates},
1477 lisez la section @ref{Extending the templates}.
1479 Après avoir écrit quelques pièces courtes, lisez les chapitres 3 à 5
1480 du manuel d'apprentissage. Rien ne s'oppose à ce que vous consultiez dès à
1481 présent les autres chapitres, bien sûr ! Néanmoins, le reste du manuel
1482 de l'utilisateur part du principe que vous avez déjà bien assimilé la
1483 syntaxe de LilyPond. Vous pouvez toujours survoler le reste du manuel,
1484 et y revenir plus tard après avoir acquis de l'expérience.