1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
4 Translation of GIT committish: 957ee70b1613ce33157486a1372827e7c1c9274f
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. For details, see the Contributors'
8 Guide, node Updating translation committishes..
13 @c Translators: Jean-Charles Malahieude, Valentin Villenave
15 @node Généralités en matière d'entrée et sortie
16 @chapter Généralités en matière d'entrée et sortie
17 @translationof General input and output
19 Nous n'allons pas, dans ce chapitre, parler directement de notation,
20 mais plutôt du contenu des fichiers source et du résultat produit par
25 * Agencement du code::
27 * Travail sur des fichiers texte::
28 * Contrôle des sorties::
30 * Extraction d'informations musicales::
33 @node Agencement du code
34 @section Agencement du code
35 @translationof Input structure
37 LilyPond traite des fichiers textuels. Ces fichiers portent par
38 convention une extension @code{.ly}.
41 * Structure d'une partition::
42 * Plusieurs partitions dans un même ouvrage::
43 * Plusieurs éditions pour une même source::
44 * Nom des fichiers de sortie::
45 * Structure de fichier::
49 @node Structure d'une partition
50 @subsection Structure d'une partition
51 @translationof Structure of a score
55 Un bloc @code{\score} contient obligatoirement une seule expression
56 musicale délimitée par des accolades@tie{}:
64 @warning{Il ne doit y avoir qu'@strong{une seule} expression musicale
65 globale dans un bloc @code{@bs{}score}, et elle @strong{doit} être
66 bornée par une paire d'accolades.}
68 Cette unique expression musicale peut être de n'importe quelle taille et
69 contenir d'autres expressions musicales aussi complexes soient elles.
70 Voici quelques exemples d'expression musicale@tie{}:
76 @lilypond[verbatim,quote]
83 @lilypond[verbatim,quote]
85 \new Staff { c'4 c' c' c' }
86 \new Staff { d'4 d' d' d' }
94 \new Staff @{ \flute @}
95 \new Staff @{ \hautbois @}
98 \new Staff @{ \violonI @}
99 \new Staff @{ \violonII @}
105 Les commentaires constituent l'une des rares exceptions à cette règle
106 immuable -- voir @ref{Structure de fichier} pour les autres. Qu'il
107 s'agisse d'une seule ligne ou de tout un bloc -- délimité par @code{%@{
108 .. %@}} -- un commentaire peut se placer n'importe où dans le fichier
109 source, aussi bien à l'intérieur qu'à l'extérieur du bloc @code{\score},
110 ou encore à l'intérieur ou à l'extérieur de l'expression musicale
111 contenue dans un bloc @code{\score}.
113 Lorsqu'un fichier ne comprend qu'un bloc @code{\score}, celui-ci est
114 implicitement inclus dans un bloc @code{\book}. Le bloc @code{\book}
115 d'un fichier source permet la production d'au moins un fichier dont le
116 nom sera, par défaut, déduit du fichier source@tie{}: le traitement de
117 @file{fandangopourelephants.ly} produira donc
118 @file{fandangopourelephants.pdf}.
120 Pour de plus amples informations à propos du bloc @code{\book}, lisez
121 @ref{Plusieurs partitions dans un même ouvrage},
122 @ref{Plusieurs éditions pour une même source} et
123 @ref{Structure de fichier}.
126 Manuel d'initiation :
127 @rlearning{La partition est une (unique) expression musicale composée},
128 @rlearning{Les expressions musicales en clair},
129 @rlearning{Travail sur les fichiers d'entrée}.
132 @node Plusieurs partitions dans un même ouvrage
133 @subsection Plusieurs partitions dans un même ouvrage
134 @translationof Multiple scores in a book
136 @cindex mouvements, plusieurs
137 @cindex plusieurs mouvements
141 Un ouvrage peut se composer de plusieurs morceaux et de texte. C'est le
142 cas des cahiers d'exercices ou d'une partie d'orchestre avec ses
143 différents mouvements. Chaque mouvement fait l'objet d'un bloc
152 et le texte est contenu dans un bloc @code{\markup},
162 Les différents mouvements et textes qui apparaissent dans un même
163 fichier @file{.ly} ne composeront en principe qu'un seul fichier
178 Attention cependant si vous travaillez avec lilypond-book@tie{}: il vous
179 faudra explicitement mentionner le bloc @code{\book}, en l'absence de
180 quoi seul le premier @code{\score} ou @code{\markup} apparaîtra après
183 L'entête de chaque pièce peut se placer au sein du bloc
184 @code{\score}@tie{}; le contenu du champ @code{piece} viendra s'imprimer
185 avant chaque mouvement. De même, le titre de l'ouvrage peut se placer
186 au sein du bloc @code{\book}. Dans le cas contraire, le contenu du bloc
187 @code{\header} placé en début de fichier sera utilisé.
191 title = "Huit miniatures"
192 composer = "Igor Stravinsky"
196 \header @{ piece = "Romance" @}
199 ..texte du second couplet..
202 ..texte du troisième couplet..
206 \header @{ piece = "Menuet" @}
212 Plusieurs pièces seront regroupées dans un même @qq{chapitre} à l'aide
213 d'un bloc @code{\bookpart}. Ces différents @qq{chapitres} sont séparés
214 par un saut de page et peuvent comporter un titre à l'instar de
215 l'ouvrage dès lors que vous y insérez un bloc @code{\header}.
220 title = "Titre de l'ouvrage"
221 subtitle = "Première partie"
228 subtitle = "Deuxième partie"
236 @node Plusieurs éditions pour une même source
237 @subsection Plusieurs éditions pour une même source
238 @translationof Multiple output files from one input file
240 Dès lors que vous inscrivez plusieurs blocs @code{\book} dans un même
241 fichier @file{.ly}, chacun d'eux donnera lieu à un résultat indépendant.
242 Lorsqu'aucun bloc @code{\book} n'est spécifié dans le fichier source,
243 LilyPond considère que l'intégralité du fichier constitue un bloc
244 @code{\book} unique, comme indiqué à la rubrique
245 @ref{Structure de fichier}.
247 LilyPond fait en sorte, lorsque plusieurs fichiers sont produits à
248 partir d'une même source, qu'aucun résultat d'un bloc @code{\book}
249 n'écrase celui qui a été généré pour un bloc @code{\book} précédent.
251 Dans les faits, et si le nom du fichier produit est repris de sa source
252 -- comportement par défaut --, un suffixe lui sera ajouté pour chaque
253 @code{\book}. Il s'agit en principe d'un pseudo numéro de version.
254 Ainsi, le fichier @file{huitminiatures.ly} qui contiendrait
259 \layout @{ @dots{} @}
263 \layout @{ @dots{} @}
267 \layout @{ @dots{} @}
275 @file{huitminiatures.pdf},
277 @file{huitminiatures-1.pdf} et
279 @file{huitminiatures-2.pdf}.
283 @node Nom des fichiers de sortie
284 @subsection Nom des fichiers de sortie
285 @translationof Output file names
287 @funindex \bookOutputSuffix
288 @funindex \bookOutputName
290 LilyPond vous permet de prendre le contrôle dans la dénomination des
291 fichiers que vous voulez générer, quel que soit le moteur de rendu
294 Nous avons vu dans la rubrique précédente que LilyPond évite les
295 conflits de nom des fichiers qu'il génère à partir d'une même source.
296 Vous pouvez même définir vous-même le suffixe qui sera appliqué à chacun
297 des blocs @code{\book}. Ainsi, en reprenant l'exemple ci-avant, vous
298 obtiendrez les fichiers @file{huitminiatures-Romance.pdf},
299 @file{huitminiatures-Menuet.pdf} et @file{huitminiatures-Nocturne.pdf}
300 en ajoutant simplement une déclaration @code{\bookOutputSuffix} au sein
301 de chaque bloc @code{\book}.
305 \bookOutputSuffix "Romance"
307 \layout @{ @dots{} @}
310 \bookOutputSuffix "Menuet"
312 \layout @{ @dots{} @}
315 \bookOutputSuffix "Nocturne"
317 \layout @{ @dots{} @}
321 La déclaration @code{\bookOutputName} vous permet de définir vous-même
322 le nom du fichier généré pour un bloc @code{\book}@tie{}:
326 \bookOutputName "Romance"
328 \layout @{ @dots{} @}
331 \bookOutputName "Menuet"
333 \layout @{ @dots{} @}
336 \bookOutputName "Nocturne"
338 \layout @{ @dots{} @}
342 Le traitement de ce fichier produira@tie{}:
354 @node Structure de fichier
355 @subsection Structure de fichier
356 @translationof File structure
366 Un fichier @code{.ly} peut contenir un certain nombre d'expression de
367 haut niveau. Les expressions de haut niveau sont les suivantes@tie{}:
371 Une définition de sortie, comme @code{\paper}, @code{\midi} et
372 @code{\layout}. Ces définitions, lorsqu'elles se trouvent à un niveau
373 supérieur, s'appliqueront à l'intégralité de l'ouvrage. Si l'une de ces
374 expression apparaît à plusieurs reprises, la dernière aura préséance.
377 Une expression scheme pure, telle que
378 @w{@code{#(set-default-paper-size@tie{}"a7"@tie{}'landscape)}} ou
379 @w{@code{#(ly:set-option@tie{}'point-and-click@tie{}#f)}}.
382 Un bloc @code{\header}, dont le contenu sera de portée globale -- ce qui
383 est le cas en général pour le titre ou l'auteur entre autres.
386 Un bloc @code{\score} pour la partition. Cette partition sera assemblée
387 avec les autres partitions se trouvant au même niveau pour composer le
388 @code{\book}. Vous pouvez modifier ce comportement à l'aide de la
389 variable @code{toplevel-score-handler} placée en tête.
391 @c FIXME - I cannot read "toplevel-score-handler" in scm/lily.scm -jcm
392 The default handler is defined in the init file @file{../scm/lily.scm}.
396 Un bloc @code{\book} permet de regrouper naturellement plusieurs
397 mouvements -- autrement dit plusieurs blocs @code{\score} -- dans un
398 même document. Lorsqu'il y a plusieurs @code{\score}s, LilyPond génère
399 un seul fichier dans lequel les mouvements sont mis les uns à la suite
400 des autres, ce pour chacun des blocs @code{\book} rencontrés. La seule
401 raison qui peut vous demander d'expliciter plusieurs blocs @code{\book}
402 dans un fichier @file{.ly} est lorsque vous avez besoin de générer
403 différents documents à partir d'une même source. La présence explicite
404 d'un bloc @code{\book} est aussi nécessaire lorsque vous travaillez sur
405 un document lilypond-book qui reprendrait plusieurs @code{\score}s ou
406 @code{\markup}s dans un même extrait. Vous pouvez modifier ce
407 comportement à l'aide de la variable @code{toplevel-book-handler}
410 @c FIXME - I cannot read "toplevel-book-handler" in scm/lily.scm -jcm
411 The default handler is defined in the init file @file{../scm/lily.scm}.
415 Un bloc @code{\bookpart}. Un ouvrage peut se découper en plusieurs
416 parties à l'aide de blocs @code{\bookpart}, aussi bien pour alléger le
417 travail de l'algorithme de calcul des sauts de page, que si les réglages
418 du bloc @code{\paper} diffèrent d'une partie à l'autre.
421 Une expression musicale telle que
426 Ce bout de code sera placé dans un @code{\score} et intégré à l'ouvrage
427 en même temps que tous les autres @code{\score}s ou expressions
428 musicales. En d'autres termes, un fichier qui ne contiendrait que cette
429 simple expression musicale sera traduit en
446 Vous pouvez modifier ce comportement à l'aide de la variable
447 @code{toplevel-music-handler} placée en tête.
449 @c FIXME - I cannot read "toplevel-music-handler" in scm/lily.scm -jcm
450 The default handler is defined in the init file @file{../scm/lily.scm}.
454 Du texte sous forme de @emph{markup} comme les paroles d'un couplet
457 2. Le première ligne du deuxième couplet.
461 De tels @emph{markups} seront imprimés là où ils apparaissent,
462 avant, après ou entre les expressions musicales.
465 @cindex identificateurs
468 Une variable, ou identificateur, telle que
470 toto = @{ c4 d e d @}
473 Vous pourrez la réutiliser plus loin dans votre fichier en saisissant
474 simplement @code{\toto}. Le nom des indentificateurs ne doit être
475 formés que de caractères alphabétiques -- sans chiffre ni caractère
480 Voici trois éléments que vous pouvez placer à un niveau supérieur@tie{}:
484 % pas en pleine largeur
495 Vous pouvez placer, n'importe où dans votre fichier, les instructions
499 @item @code{\version}
500 @item @code{\include}
501 @item @code{\sourcefilename}
502 @item @code{\sourcefileline}
504 Une ligne de commentaire, introduite par le signe @code{%}.
507 Un bloc de commentaire, délimité par @code{%@{ .. %@}}.
514 Vous pouvez insérer des espaces dans votre fichier source afin de lui
515 apporter une meilleure lisibilité. Les espaces superflus sont
516 normalement ignorés. Notez cependant qu'il est des cas où l'espace est
517 requis pour éviter tout risque d'erreur@tie{}:
521 Autour d'une accolade, qu'elle soit ouvrant ou fermante ;
524 Après chaque commande ou variable, autrement dit tout élément qui
525 commence par un@tie{}@code{\}@tie{};
528 Après tout élément qui sera interprété comme une expression Scheme,
529 autrement dit tout élément qui commence par un @code{#}@tie{};
532 Pour séparer les éléments d'une expression Scheme ;
535 En mode parole -- @code{lyricmode} -- pour séparer les termes des
536 commandes @code{\override} et @code{\set}. Précisons à ce sujet qu'en
537 plus d'ajouter une espace avant et après l'intégralité de la commande,
538 vous devrez encadrer d'espaces le point et le signe égal qu'elle peut
540 @w{@code{\override Score . LyricText #'font-size = #5}}.
546 Manuel d'initiation :
547 @rlearning{Organisation des fichiers LilyPond}.
550 @node Titres et entêtes
551 @section Titres et entêtes
552 @translationof Titles and headers
554 La plupart de la musique qui est éditée comporte un titre et le nom de
555 son compositeur@tie{}; certains ouvrages divulguent beaucoup plus
559 * Création de titres et entête ou pied de page::
560 * Titrages personnalisés::
561 * Notes de bas de page::
562 * Référencement des numéros de page::
563 * Table des matières::
567 @node Création de titres et entête ou pied de page
568 @subsection Création de titres et entête ou pied de page
569 @translationof Creating titles headers and footers
572 * Contenu des blocs de titrage::
573 * Mise en forme par défaut des titrages::
574 * Mise en forme par défaut des entête et pied de page::
578 @node Contenu des blocs de titrage
579 @unnumberedsubsubsec Contenu des blocs de titrage
580 @translationof Title blocks explained
582 @c TODO: figure out how \bookpart titles work
584 Il existe en fait deux types de blocs de titrage@tie{}: un bloc pour
585 contenir le titre principal qui doit apparaître avant le tout premier
586 @code{\score} d'un ouvrage, et un autre attaché à chacun des blocs
587 @code{\score} qui le composent. Dans les deux cas, les champs qui
588 composent un bloc de titrage se saisissent dans un bloc @code{\header}.
590 Lorsque l'ouvrage ne comporte qu'un seul morceau, le bloc @code{\header}
591 peut se placer en dehors ou au sein même du bloc @code{\score}.
593 Dans le cas où le bloc @code{\header} est défini à l'intérieur du bloc
594 @code{\score}, seuls les champs @code{piece} et @code{opus} seront
597 @lilypond[papersize=a5,quote,verbatim,noragged-right]
601 title = "title" % not printed
608 @funindex print-all-headers
610 Vous pouvez modifer ce comportement et imprimer tous les champs d'un
611 bloc @code{\header} défini dans un bloc @code{\score} en ajoutant
615 print-all-headers = ##t
619 @warning{N'oubliez pas que lorsqu'il est placé à l'intérieur d'un bloc
620 @code{@bs{}score}, le bloc @code{@bs{}header} doit impérativement se
621 trouver @strong{à la suite} de l'expression musicale.}
623 @lilypond[papersize=a5,quote,verbatim,noragged-right]
626 composer = "J. S. Bach."
630 \new Staff \relative g, {
633 \repeat unfold 2 { g16( d' b') a b d, b' d, } |
634 \repeat unfold 2 { g,16( e' c') b c e, c' e, } |
642 \new Staff \relative b {
646 <g, d' b'~>4 b'16 a( g fis) g( d e fis) g( a b c) |
647 d16( b g fis) g( e d c) b(c d e) fis( g a b) |
655 Tous les champs appartenant au titrage principal d'un ouvrage peuvent se
656 reporter dans chaque bloc @code{\score} ou être supprimés
660 @lilypond[papersize=a5,quote,verbatim,noragged-right]
663 print-all-headers = ##t
666 title = "DAS WOHLTEMPERIRTE CLAVIER"
668 % Pas de pied en dernière page pour ce livret
671 \markup { \vspace #1 }
675 \new Staff { \clef "bass" s1 }
678 title = "PRAELUDIUM I"
680 % Pas de sous-titre pour ce morceau
687 \new Staff { \clef "bass" s1 }
691 subsubtitle = "A 4 VOCI"
693 % Pas de sous-titre pour ce morceau
702 @ref{Structure de fichier},
703 @ref{Mise en forme personnalisée des blocs de titrage}.
706 @node Mise en forme par défaut des titrages
707 @unnumberedsubsubsec Mise en forme par défaut des titrages
708 @translationof Default layout of book and score title blocks
710 La mise en forme des blocs de titrage est contrôlée par deux variables
711 attachées au bloc @code{\paper}@tie{}: @code{bookTitleMarkup} pour le
712 bloc @code{\header} principal, et @code{scoreTitleMarkup} pour les blocs
713 @code{\header} relevant des blocs @code{\score}.
716 @lilypond[papersize=a6,quote,verbatim,noragged-right]
718 % Les champs suivants sont centrés
719 dedication = "Dédicace"
721 subtitle = "Sous-titre"
722 subsubtitle = "Sous-sous-titre"
723 instrument = "Instrument"
725 % Les champs suivants sont alignés sur le bord gauche
729 % Les champs suivants sont alignés sur le bord droit
730 composer = "Compositeur"
731 arranger = "Arrangeur"
737 % Les champs suivants sont en opposition sur la même ligne
744 @c Is the bit about \null markups true? -mp
746 Les champs d'un bloc @code{\header} qui n'auront pas été alimentés
747 seront remplacés par un @emph{markup} @code{\null} de façon à ne pas
750 Par défaut, @code{scoreTitleMarkup} place les champs @code{piece} et
751 @code{opus} de part et d'autre sur une même ligne.
755 La variable @code{breakbefore} activée dans un bloc @code{\header} situé
756 dans un bloc @code{\score} force le saut de page avant le morceau
757 contenu dans ce @code{\score}. Vous pourrez ainsi séparer le titre
758 principal de la musique.
760 @lilypond[papersize=a8landscape,verbatim,noragged-right]
763 title = "This is my Title"
764 subtitle = "This is my Subtitle"
765 copyright = "This is the bottom of the first page"
768 \repeat unfold 4 { e'' e'' e'' e'' }
770 piece = "This is the Music"
778 Manuel d'initiation :
779 @rlearning{Organisation des fichiers LilyPond}.
782 @ref{Structure de fichier}.
784 Fichiers d'initialisation :
785 @file{ly/titling-init.ly}.
788 @node Mise en forme par défaut des entête et pied de page
789 @unnumberedsubsubsec Mise en forme par défaut des entête et pied de page
790 @translationof Default layout of headers and footers
792 Les entête et pied -- @emph{headers} et @emph{footers} -- sont des
793 lignes de textes qui apparaîssent en haut et en bas de chaque page,
794 indépendamment du texte de l'ouvrage. Ils sont contrôlés par les
795 variables suivantes, attachées au bloc @code{\paper}@tie{}:
798 @item @code{oddHeaderMarkup} -- entête de page impaire
799 @item @code{evenHeaderMarkup} -- entête de page paire
800 @item @code{oddFooterMarkup} -- pied de page impaire
801 @item @code{evenFooterMarkup} -- pied de page paire
804 Ces variables @emph{markup} n'accèdent qu'au contenu des champs du bloc
805 @code{\header} principal, celui qui s'appliquera à tous les blocs
806 @code{\score} du document. Ces variables sont définies dans le fichier
807 @file{ly/titling-init.ly}, et sont par défaut@tie{}:
812 les numéros sont placés en haut à gauche (si pair) ou à droite (si
813 impair) de chaque page à compter de la deuxième@tie{};
816 le contenu du champ @code{instrument} est centré en haut de chaque page
817 à compter de la deuxième@tie{};
820 le texte du @code{copyright} est centré au bas de la première
824 le @code{tagline} -- mention spéciale -- se place au bas de la dernière
825 page, ou bien sous le @code{copyright} s'il n'y a qu'une seule page.
829 @lilypond[papersize=a8landscape]
839 La mention spéciale se modifie en alimentant le champ @code{tagline} au
840 niveau du bloc @code{\header} principal.
842 @lilypond[papersize=a8landscape,verbatim]
845 tagline = "... music notation for Everyone"
855 Pour supprimer le @code{tagline}, il suffit de lui assigner la valeur
859 @node Titrages personnalisés
860 @subsection Titrages personnalisés
861 @translationof Custom headers footers and titles
863 @c TODO: somewhere put a link to header spacing info
864 @c (you'll have to explain it more in NR 4).
867 * Mise en forme personnalisée des champs de titrage::
868 * Mise en forme personnalisée des blocs de titrage::
869 * Mise en forme personnalisée des entête et pied de page::
873 @node Mise en forme personnalisée des champs de titrage
874 @unnumberedsubsubsec Mise en forme personnalisée des champs de titrage
875 @translationof Custom text formatting for title blocks
877 Toutes les commandes de mise en forme d'un @code{\markup} permettent de
878 personnaliser le texte des entête, pied de page et éléments de titre
879 contenus dans un bloc @code{\header}.
881 @lilypond[quote,verbatim,noragged-right]
885 piece = \markup { \fontsize #4 \bold "PRAELUDIUM I" }
886 opus = \markup { \italic "(Excerpt)" }
893 @ref{Mise en forme du texte}.
896 @node Mise en forme personnalisée des blocs de titrage
897 @unnumberedsubsubsec Mise en forme personnalisée des blocs de titrage
898 @translationof Custom layout for title blocks
900 L'utilisation de commandes @code{\markup} au sein d'un bloc
901 @code{\header} permet de modifier aisément l'apparence du texte,
902 mais n'influence en rien le positionnement précis des éléments de
903 titrage. L'accès au positionnement des champs de titrage est géré par
904 les deux variables suivantes, attachées au bloc @code{\paper}@tie{}:
907 @item @code{bookTitleMarkup}
908 @item @code{scoreTitleMarkup}
911 Ces variables sont abordées à la rubrique
912 @ref{Mise en forme par défaut des titrages}.
914 Voici les réglages par défaut de @code{scoreTitleMarkup}, tels que
915 définis dans le fichier @file{ly/titling-init.ly}@tie{}:
918 scoreTitleMarkup = \markup @{ \column @{
919 \on-the-fly #print-all-headers @{ \bookTitleMarkup \hspace #1 @}
921 \fromproperty #'header:piece
922 \fromproperty #'header:opus
928 Ceci aura donc pour effet de positionner les champs @code{piece} et
929 @code{opus} sur la même ligne, en opposition@tie{}:
931 @lilypond[quote,verbatim,noragged-right]
935 piece = "PRAELUDIUM I"
941 Voici comment positionner le champ @code{piece}, dont nous modifions
942 la taille et la graisse, au centre de cette ligne@tie{}:
944 @lilypond[papersize=a5,quote,verbatim,noragged-right]
948 scoreTitleMarkup = \markup {
951 \fontsize #4 \bold \fromproperty #'header:piece
952 \fromproperty #'header:opus
956 \header { tagline = ##f }
960 piece = "PRAELUDIUM I"
967 Les champs normalement réservés au bloc de titrage principal seront
968 reportés au niveau au niveau inférieur dès lors que vous aurez activé
969 l'instruction @code{print-all-headers} au sein du bloc @code{\paper}.
970 Le principal inconvénient de cette fonction réside dans le fait que les
971 champs réservés au bloc @code{\header} principal devront être supprimés
972 dans chacun des blocs @code{\score} de votre fichier source -- voir
973 @ref{Contenu des blocs de titrage}.
975 Afin d'éviter ce désagrément, ajoutez le champ que vous désirez voir
976 apparaître à la définition de @code{scoreTitleMarkup}. Nous allons,
977 dans l'exemple suivant, ajouter au @code{scoreTitleMarkup} le champ
978 @code{composer}, normalement associé au @code{bookTitleMarkup}@tie{};
979 chaque @code{\score} pourra mentionner un compositeur différent.
981 @lilypond[papersize=a5,quote,verbatim,noragged-right]
985 scoreTitleMarkup = \markup {
988 \fontsize #4 \bold \fromproperty #'header:piece
989 \fromproperty #'header:composer
993 \header { tagline = ##f }
998 composer = "Christian Petzold"
1005 composer = "François Couperin"
1011 Rien ne vous empêche de créer votre propre champ personnalisé, puis d'y
1012 faire référence dans la définition du @emph{markup}.
1014 @lilypond[papersize=a5,quote,verbatim,noragged-right]
1018 scoreTitleMarkup = \markup {
1021 \override #`(direction . ,UP) {
1023 \center-align \fontsize #-1 \bold
1024 \fromproperty #'header:mycustomtext %% User-defined field
1025 \center-align \fontsize #4 \bold
1026 \fromproperty #'header:piece
1029 \fromproperty #'header:opus
1033 \header { tagline = ##f }
1038 mycustomtext = "A 4 VOCI" %% User-defined field
1046 Manuel de notation :
1047 @ref{Contenu des blocs de titrage}.
1050 @node Mise en forme personnalisée des entête et pied de page
1051 @unnumberedsubsubsec Mise en forme personnalisée des entête et pied de page
1052 @translationof Custom layout for headers and footers
1054 @c can make-header and make-footer be removed from
1055 @c paper-defaults-init.ly? -mp
1057 L'utilisation de commandes @code{\markup} au sein d'un bloc
1058 @code{\header} permet de modifier aisément l'apparence du texte,
1059 mais n'influence en rien le positionnement précis des entête et pied
1060 de page. L'accès au positionnement des champs concernés est géré par
1061 les quatre variables suivantes, attachées au bloc @code{\paper}@tie{}:
1064 @item @code{oddHeaderMarkup}
1065 @item @code{evenHeaderMarkup}
1066 @item @code{oddFooterMarkup}
1067 @item @code{evenFooterMarkup}
1070 L'exemple suivant illustre la manière de centrer son numéro au bas de
1071 chaque page. Il nous faut tout d'abord annuler la définition de
1072 @code{oddHeaderMarkup} et @code{evenHeaderMarkup} à l'aide d'un
1073 @emph{markup} @code{\null}. Nous redéfinissons ensuite
1074 @code{oddFooterMarkup} pour qu'il contienne le numéro de page, centré.
1075 Enfin, nous appliquons le même paramétrage au @code{\oddFooterMarkup}.
1077 @lilypond[papersize=a8,quote,verbatim,noragged-right]
1080 print-page-number = ##t
1081 print-first-page-number = ##t
1082 oddHeaderMarkup = \markup \null
1083 evenHeaderMarkup = \markup \null
1084 oddFooterMarkup = \markup {
1086 \on-the-fly #print-page-number-check-first
1087 \fromproperty #'page:page-number-string
1090 evenFooterMarkup = \oddFooterMarkup
1093 \new Staff { s1 \break s1 \break s1 }
1099 Manuel de notation :
1100 @ref{Contenu des blocs de titrage},
1101 @ref{Mise en forme par défaut des titrages}.
1104 @node Notes de bas de page
1105 @subsection Notes de bas de page
1106 @translationof Creating footnotes
1108 LilyPond dispose de deux méthodes pour créer des notes de bas de page,
1109 l'une automatisée, et l'autre manuelle.
1112 * Considérations générales en matière de note de bas de page::
1113 * Notes de bas de page automatiques::
1114 * Notes de bas de page manuelles::
1117 @node Considérations générales en matière de note de bas de page
1118 @unnumberedsubsubsec Considérations générales en matière de note de bas de page
1119 @translationof Footnotes overview
1121 Il est parfois judicieux, notamment lorsqu'une annotation ou un
1122 commentaire gènerait la lecture de la partition, de les reporter en bas
1125 Les notes de bas de page automatiques font appel à un compteur
1126 numérique incrémenté automatiquement@tie{}; les notes de bas de page
1127 manuelles vous laissent le libre choix de l'appel (l'indicateur). Tout
1128 objet graphique, @code{\markup} de haut niveau ou les notes d'un accord
1129 peuvent faire l'objet d'une annotation.
1131 L'ordre dans lequel les objets seront dessinés détermine l'ordre des
1132 appels et comment les annotations seront créées lors de la compilation.
1135 @node Notes de bas de page automatiques
1136 @unnumberedsubsubsec Notes de bas de page automatiques
1137 @translationof Automatic footnotes
1139 @cindex note de bas de page automatique
1140 @cindex bas de page, note automatique
1143 @funindex \footnoteGrob
1144 @funindex \auto-footnote
1146 LilyPond dispose, selon l'objet à référencer, de deux différentes
1147 commandes pour créer des notes de bas de page automatiques. La commande
1148 @code{\footnoteGrob} s'applique aux objets individuels, tels que
1149 tête de note, hampe, liaison, nuance ou @code{\markup} contenant un
1150 @code{TextScripts}. La commande @code{\footnote}, quant à elle,
1151 permet de référencer l'une des notes d'un accord.
1153 Ces deux commandes requièrent trois arguments@tie{}: l'@var{Objet de
1154 Rendu} devant être annoté, la position @var{(x@tie{}.@tie{}y)} de
1155 l'appel de note, et enfin un @code{\markup} contenant l'annotation qui
1156 apparaîtra en bas de la page.
1158 La commande @code{\footnoteGrob} doit être mentionnée @strong{avant}
1159 l'objet auquel la note est attachée.
1162 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1164 \header { tagline = ##f }
1166 \footnote #'(0.5 . -2) #'NoteHead
1167 \markup { La première note }
1169 \footnote #'(0.5 . 1) #'NoteHead
1170 \markup { La troisième note }
1176 Lorsqu'il s'agit de notes inscrites dans un accord, la commande
1177 @code{\footnote} doit être mentionnée @strong{après} la note à
1178 laquelle le @code{TextScript} fait référence.
1181 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1183 \header { tagline = ##f }
1186 c-\footnote #'(1 . -1.25) "Voici un do"
1187 es-\footnote #'(2 . -0.25) \markup { \italic "Un mi bémol" }
1188 g-\footnote #'(2 . 3) \markup { \bold "Ceci est un sol" }
1194 @warning{Lorsque plusieurs notes de bas de page se rapportent à un même
1195 empilement vertical, les notes apparaîtront dans l'ordre vertical des
1196 appels, autrement dit celui positionné le plus haut en premier, et ainsi
1199 Voici quelques exemples d'objets annotés automatiquement. Vous pouvez
1200 constater l'agencement des annotations correspondantes avec le copyright
1203 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1205 \header { copyright = \markup { "Copyright 1970" } }
1207 \footnote #'(-3 . 0) #'DynamicText
1208 \markup { \bold Forte }
1210 \footnote #'(0 . 1.5) #'Slur
1214 \footnote #'(0 . -2) #'Beam
1218 \footnote #'(1 . -1) #'Stem
1219 \markup { \teeny { This is a stem } }
1222 \footnote #'(0 . 0.5) #'AccidentalCautionary
1223 \markup \italic { A cautionary accidental }
1225 \footnote #'(0.5 . -0.5) #'TextScript
1226 \markup \italic { Slow Down }
1232 Une note de bas de page affectant un @code{\markup} de haut niveau
1233 s'introduit par la commande @code{\auto-footnote}@tie{}:
1235 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1237 \header { tagline = ##f }
1238 \markup { \auto-footnote "A simple tune" \italic "By me" }
1246 @node Notes de bas de page manuelles
1247 @unnumberedsubsubsec Notes de bas de page manuelles
1248 @translationof Manual footnotes
1250 @cindex note de bas de page manuelle
1251 @cindex bas de page, note manuelle
1254 @funindex \footnoteGrob
1256 LilyPond dispose, selon l'objet à référencer, de deux différentes
1257 commandes pour créer des notes de bas de page manuelles@tie{}: la
1258 commande @code{\footnote} pour les @code{\markup} de haut niveau ou les
1259 notes d'un accord, et la commande @code{\footnoteGrob} pour les objets
1260 individuels ou les @code{\markup} contenant un @code{TextScript}.
1262 S'agissant d'annoter un objet graphique, la commande @code{\footnote}
1263 requiert quatre arguments@tie{}: l'@var{Objet de Rendu} devant être
1264 annoté, la position @var{(x@tie{}.@tie{}y)} de l'appel de note, et deux
1265 @code{\markup} -- le premier contient l'appel qui s'attache à la note
1266 ou à l'objet, le second contient l'annotation qui est reportée en bas de
1269 La commande @code{\footnoteGrob} doit être mentionnée @strong{après}
1270 l'objet auquel l'annotation fait référence, comme s'il s'agissait d'une
1273 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1275 \header { tagline = ##f }
1278 "1" #'(0.5 . -2) #'NoteHead \markup { \italic "1. The first note" }
1281 \markup { \bold "2" } #'(0.5 . 1) #'NoteHead "2. The second note"
1283 d\p-\footnote "3" #'(0.5 . -1) #'DynamicText "3. Piano"
1288 S'agissant d'annoter l'une des notes d'un accord, la commande
1289 @code{\footnote} doit être mentionnée @strong{après} la note à laquelle
1290 l'annotation fait référence, comme s'il s'agissait d'une articulation.
1292 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1294 \header { tagline = ##f }
1297 c-\footnote "1" #'(1 . -1.25) "1. C"
1299 \markup { \bold "b" } #'(2 . -0.25) "b. E-flat"
1300 g-\footnote "3" #'(2 . 3) \markup { \italic "iii. G" }
1306 @warning{Lorsque plusieurs notes de bas de page se rapportent à un même
1307 empilement vertical, les notes apparaîtront dans l'ordre vertical des
1308 appels, autrement dit celui positionné le plus haut en premier, et ainsi
1311 Voici quelques exemples d'objets annotés manuellement. Vous pouvez
1312 constater l'agencement des annotations correspondantes avec le copyright
1315 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1317 \header { copyright = \markup { "Copyright 1970" } }
1320 \markup { \teeny 1 } #'(-3 . 0) #'DynamicText
1321 \markup { 1. \bold Forte }
1324 \markup { \teeny b } #'(0 . 1.5) #'Slur
1325 \markup { b. A slur }
1329 \markup { \teeny 3 } #'(0 . -2) #'Beam
1334 \markup { 4 } #'(1 . -1) #'Stem
1335 \markup { \bold 4. { This is a stem } }
1339 \markup \concat \teeny { "sharp (v)" } #'(0 . 0.5) #'AccidentalCautionary
1340 \markup \italic { v. A cautionary accidental }
1343 \markup \concat \teeny { "a" } #'(0.5 . -0.5) #'TextScript
1344 \markup \italic { a. Slow Down }
1349 \markup { \teeny \musicglyph #"rests.4" } #'(1.5 . -0.25) #'BreathingSign
1355 L'annotation manuelle d'un @code{\markup} de haut niveau répond à la
1356 syntaxe suivante@tie{}:
1358 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1360 \header { tagline = ##f }
1361 \markup { "A simple tune" \footnote "*" \italic "* By me" }
1369 Manuel d'initiation :
1370 @rlearning{Objets et interfaces}.
1372 Manuel de notation :
1373 @ref{Commentaires textuels},
1374 @ref{Indications textuelles},
1376 @ref{Mise en forme de la page},
1377 @ref{Titres et entêtes}.
1379 Référence des propriétés internes :
1380 @rinternals{FootnoteEvent},
1381 @rinternals{FootnoteItem},
1382 @rinternals{FootnoteSpanner},
1383 @rinternals{Footnote_engraver}.
1386 Un silence multi-mesures ne peut se voir affecter une note de bas de
1389 Les notes de bas de page ne peuvent que s'empiler l'une au-dessus de
1390 l'autre@tie{}; elles ne seront jamais présentées à la queue leu leu.
1391 Les notes de bas de page peuvent générer des chevauchements quand elles
1392 sont trop nombreuses sur une même page.
1394 Dès lors que vous utilisez une commande de note de bas de page manuelle,
1395 le bloc @code{\paper} doit contenir la mention
1396 @w{@code{footnote-auto-number@tie{}=@tie{}##f}}.
1399 @node Référencement des numéros de page
1400 @subsection Référencement des numéros de page
1401 @translationof Reference to page numbers
1403 LilyPond vous permet, à l'aide de la commande @code{\label}, d'insérer
1404 des points de référence dans un ouvrage, aussi bien en dehors qu'au fil
1405 de la musique. Ce point de référence pourra être ensuite repris à
1406 l'intérieur d'un @emph{markup}@tie{}; vous pourrez même y ajouter le
1407 numéro de page grâce à la commande de @emph{markup} @code{\page-ref}.
1411 \header { tagline = ##f }
1417 \pageBreak \mark A \label #'markA
1422 \markup { Le premier mouvement débute à la page \page-ref #'firstScore "0" "?" }
1423 \markup { Le repère A est à la page \page-ref #'markA "0" "?" }
1427 L'instruction @code{\page-ref} prend trois arguments@tie{}:
1430 le point de référence, sous la forme d'un symbole scheme, comme par
1431 exemple @code{#'firstScore},
1434 un @qq{emporte-pièce} afin d'estimer la longueur totale du
1438 un texte de remplacement au cas où la référence ne serait pas retrouvée.
1441 La présence de l'emporte-pièce est rendue nécessaire par le fait que les
1442 @emph{markups} sont générés avant que les sauts de page ne soient
1443 positionnés. Bien que le numéro de page en question ne soit pas encore
1444 déterminé, LilyPond doit connaître les dimensions de ce @emph{markup}.
1445 Vous pouvez, lorsque l'ouvrage contiendra plus de dix pages, stipuler un
1446 emporte-pièce sur deux caractères -- soit @code{"00"}.
1457 @node Table des matières
1458 @subsection Table des matières
1459 @translationof Table of contents
1461 La commande @code{\markuplist \table-of-contents} vous permettra de
1462 générer une table des matières. Les éléments qui la composeront sont
1463 créés par la commande @code{\tocItem}, insérée indépendamment ou au sein
1464 d'une expression musicale.
1467 \markuplist \table-of-contents
1470 \tocItem \markup "Premier mouvement"
1474 \tocItem \markup "Passage spécifique du premier mouvement"
1479 \tocItem \markup "Second mouvement"
1487 Les @emph{markups} dévolus à la mise en forme de la table des matières
1488 se définissent dans le bloc @code{\paper}. Il s'agit par défaut de
1489 @code{tocTitleMarkup} pour le titre de la table, et de
1490 @code{tocItemMarkup} pour ses éléments -- composés de leur libellé et
1491 numéro de page. Vous pouvez bien entendu personnaliser ces
1496 %% Translate the toc title into French:
1497 tocTitleMarkup = \markup \huge \column {
1498 \fill-line { \null "Table des matières" \null }
1501 %% use larger font size
1502 tocItemMarkup = \markup \large \fill-line {
1503 \fromproperty #'toc:text \fromproperty #'toc:page
1508 Notez bien la manière de référencer le libellé et le numéro de page dans
1509 la définition de @code{tocItemMarkup}.
1511 N'hésitez pas à définir vous-même d'autres commandes et @emph{markups}
1512 afin de construire une table plus élaborée@tie{}:
1515 commencez par définir une nouvelle variable de type @code{markup} au
1516 sein du bloc @code{\paper},
1519 puis définissez une fonction musicale chargée d'insérer un élément de la
1520 table à partir de cette variable.
1523 Dans l'exemple qui suit, nous avons créé un nouveau style d'élément dans
1524 le but de mentionner les actes dans la table des matières d'un
1529 tocActMarkup = \markup \large \column {
1531 \fill-line { \null \italic \fromproperty #'toc:text \null }
1537 #(define-music-function (parser location text) (markup?)
1538 (add-toc-item! 'tocActMarkup text))
1541 @lilypond[line-width=11.0\cm]
1542 \header { tagline = ##f }
1544 tocActMarkup = \markup \large \column {
1546 \fill-line { \null \italic \fromproperty #'toc:text \null }
1552 #(define-music-function (parser location text) (markup?)
1553 (add-toc-item! 'tocActMarkup text))
1556 \markuplist \table-of-contents
1557 \tocAct \markup { Atto Primo }
1558 \tocItem \markup { Coro. Viva il nostro Alcide }
1559 \tocItem \markup { Cesare. Presti omai l'Egizzia terra }
1560 \tocAct \markup { Atto Secondo }
1561 \tocItem \markup { Sinfonia }
1562 \tocItem \markup { Cleopatra. V'adoro, pupille, saette d'Amore }
1567 L'élément et son numéro de page peuvent se rejoindre par une ligne
1570 @lilypond[verbatim,quote]
1571 \header { tagline = ##f }
1573 tocItemMarkup = \tocItemWithDotsMarkup
1577 \markuplist \table-of-contents
1578 \tocItem \markup { Allegro }
1579 \tocItem \markup { Largo }
1586 Fichiers d'initialisation :
1587 @file{../ly/toc-init.ly}.
1591 @funindex \table-of-contents
1592 @code{\table-of-contents},
1598 @node Travail sur des fichiers texte
1599 @section Travail sur des fichiers texte
1600 @translationof Working with input files
1603 * Insertion de fichiers LilyPond::
1604 * Différentes éditions à partir d'une même source::
1605 * Caractères spéciaux::
1608 @node Insertion de fichiers LilyPond
1609 @subsection Insertion de fichiers LilyPond
1610 @translationof Including LilyPond files
1613 @cindex inclusion de fichiers
1615 Lorsqu'un projet prend de l'importance en volume, il est judicieux de le
1616 scinder en plusieurs fichiers, auxquels vous fereez référence avec un
1620 \include "autrefichier.ly"
1623 Une ligne @code{\include "autrefichier.ly"} dans un fichier revient à
1624 recopier intégralement le contenu de @file{autrefichier.ly} à l'endroit
1625 même ou est placée l'instruction @code{\include}. Vous pouvez par
1626 exemple écrire un fichier individuel par instrument, puis les regrouper
1627 pour former le fichier @qq{conducteur}. Les différentes variables
1628 définies dans les fichiers séparés seront normalement reprises et
1629 utilisables dans le fichier formant le conducteur. Les sections
1630 balisées dans les fichiers individuels peuvent être réutilisées en
1631 différents endroit de la partition , comme expliqué à la rubrique
1632 @ref{Différentes éditions à partir d'une même source}.
1634 Lorsque le fichier auquel il est fait référence se trouve dans le même
1635 répertoire, donner seulement son nom en argument à la commande
1636 @code{\include} suffit. S'il se trouve ailleurs, vous devrez indiquer
1637 le chemin d'accès, absolu ou relatif, en respectant toutefois la syntaxe
1638 UNIX -- autrement dit, le séparateur de répertoire est une oblique
1639 normale @code{/} et non l'oblique inverse @code{\} de DOS ou Windows.
1640 Par exemple, si le fichier @file{truc.ly} se trouve dans le répertoire
1641 supérieur au répertoire de travail, la ligne devra être
1644 \include "../truc.ly"
1648 ou bien, si les fichiers correspondant aux parties d'orchestre se
1649 trouvent dans le sous-répertoire @file{parties} relativement au
1650 répertoire courant, vous devrez mentionner
1653 \include "parties/VI.ly"
1654 \include "parties/VII.ly"
1658 Les fichiers à inclure peuvent eux-même contenir des instructions
1659 @code{\include}. Ces instructions @code{\include} de second niveau ne
1660 pourront, par défaut, être interprétées qu'une fois intégrées dans le
1661 fichier principal@tie{}; leur argument doit donc comporter le chemin
1662 relativement au fichier principal et non par rapport au fichier dans
1663 lequel cette inclusion est mentionnée. Vous pouvez toutefois influer
1664 sur ce comportement à l'aide de l'option @w{@code{-drelative-includes}}
1665 en ligne de commande ou en ajoutant une clause
1666 @code{@w{#(ly:set-option 'relative-includes #t)}} en tête du fichier
1667 principal. Une fois @code{relative-include} activé, le chemin à suivre
1668 pour chacune des commandes @code{\include} sera pris relativement au
1669 fichier qui la contient. Cette option est vouée à être activée par
1670 défaut dans une future version de LilyPond.
1672 Vous pouvez inclure des fichiers dont vous spécifierez le chemin d'accès
1673 sur la ligne de commande au moment de lancer la compilation. L'appel à
1674 ces fichiers ne mentionnerra alors que leur nom. Par exemple, si vous
1675 voulez compiler avec cette méthode le fichier @file{principal.ly} qui
1676 inclut des fichiers situés dans le sous-répertoire @file{parties},
1677 placez vous dans le répertoire contenant @file{principal.ly}, puis tapez
1680 lilypond --include=parties principal.ly
1683 tout en ayant bien dans @file{principal.ly}
1691 Lorsqu'un fichier est voué à être inclus dans nombre de partitions, vous
1692 pouvez le placer dans le répertoire de LilyPond @file{../ly}.
1693 Attention@tie{}: ce répertoire varie selon votre installation, comme
1694 indiqué au chapitre @rlearning{Autres sources de documentation}. Ce
1695 fichier sera inclus dès lors que vous fournirez uniquement son nom en
1696 argument à la fonction @code{\include}. C'est par exemple le cas du
1697 fichier de définition particulier @file{gregorian.ly}.
1699 Au moment où vous lancez LilyPond, un certain nombre de fichiers se
1700 retrouvent inclus par défaut@tie{}; il suffit d'activer le mode verbeux
1701 en faisant @w{@code{lilypond --verbose}} pour s'en rendre compte. Vous
1702 verrez ainsi défiler, en plus de nombreuses informations, le nom d'un
1703 certain nombre de fichiers et de chemins d'accès. Les fichiers les plus
1704 important sont mentionnés au chapitre
1705 @rlearning{Autres sources de documentation}. Si vous venez à les
1706 modifier, rappelez-vous qu'ils seront écrasés à l'installation d'une
1707 nouvelle version de LilyPond.
1709 Vous trouverez quelques exemples simples d'utilisation de la commande
1710 @code{\include} au chapitre @rlearning{Conducteurs et parties}.
1714 Manuel d'initiation :
1715 @rlearning{Autres sources de documentation},
1716 @rlearning{Conducteurs et parties}.
1720 Lorsque vous incluez un fichier qui porte le même nom que l'un des
1721 fichiers d'initialisation de LilyPond, le fichier de la distribution de
1722 LilyPond aura préséance.
1725 @node Différentes éditions à partir d'une même source
1726 @subsection Différentes éditions à partir d'une même source
1727 @translationof Different editions from one source
1729 Plusieurs méthodes permettent de générer différentes versions d'une
1730 partition à partir d'une même source. Les variables -- ou
1731 idendificateurs -- sont sûrement le moyen le plus simple de combiner de
1732 différente manière des passages relativement longs, alors que les
1733 balises permettront de sélectionner de courts fragments selon leur
1736 Quelle que soit la méthode utilisée, séparer la notation de la structure
1737 de la partition vous donnera plus de liberté dans l'agencement de
1738 l'ouvrage final, puisque vous ne reviendrez pas sur la musique qui le
1742 * Utilisation de variables::
1743 * Utilisation de balises::
1744 * Globalisation des réglages::
1747 @node Utilisation de variables
1748 @unnumberedsubsubsec Utilisation de variables
1749 @translationof Using variables
1751 @cindex variables, utilisation de
1753 Un fragment musical identifié par une variable est réutilisable à divers
1754 endroits de la partition, comme nous l'avons vu à la rubrique
1755 @rlearning{Organisation du code source avec des variables}. Par
1756 exemple, une partition pour chœur @notation{a cappella} comporte souvent
1757 une réduction pour piano reprenant toutes les voix@tie{}; il s'agit de
1758 la même musique, et vous ne devrez donc la saisir qu'une seule fois.
1759 D'autre part, la musique issue de deux variables peut se combiner sur
1760 une seule portée, comme nous l'avons vu à la rubrique
1761 @ref{Regroupement automatique de parties}. Prenons l'exemple
1764 @lilypond[verbatim,quote]
1765 sopranoMusic = \relative c'' { a4 b c b8( a) }
1766 altoMusic = \relative g' { e4 e e f }
1767 tenorMusic = \relative c' { c4 b e d8( c) }
1768 bassMusic = \relative c' { a4 gis a d, }
1769 allLyrics = \lyricmode {King of glo -- ry }
1771 \new Staff = "Soprano" \sopranoMusic
1772 \new Lyrics \allLyrics
1773 \new Staff = "Alto" \altoMusic
1774 \new Lyrics \allLyrics
1775 \new Staff = "Tenor" {
1779 \new Lyrics \allLyrics
1780 \new Staff = "Bass" {
1784 \new Lyrics \allLyrics
1787 \set Staff.printPartCombineTexts = ##f
1793 \set Staff.printPartCombineTexts = ##f
1803 Générer une partition chorale ou la réduction pour piano ne requiert que
1804 de modifier la structure des éléments, sans aucunement toucher à la
1807 Dans le cas d'une partition relativement longue, vous pouvez isoler la
1808 définition des différentes variables dans des fichiers séparés que vous
1809 rappellerez ensuite, comme indiqué à la rubrique
1810 @ref{Insertion de fichiers LilyPond}.
1813 @node Utilisation de balises
1814 @unnumberedsubsubsec Utilisation de balises
1815 @translationof Using tags
1818 @funindex \keepWithTag
1819 @funindex \removeWithTag
1820 @funindex \pushToTag
1821 @funindex \appendToTag
1825 La commande @code{\tag #'@var{partieA}} affecte à une expression
1826 musicale le nom @var{partieA}. Les expressions ainsi balisées pourront
1827 être filtrées par la suite, à l'aide de
1828 @code{\keepWithTag@tie{}#'@var{nom}} ou
1829 @code{\removeWithTag@tie{}#'@var{nom}}. Ces filtres fonctionnent de la
1830 manière suivante@tie{}:
1832 @multitable @columnfractions .5 .5
1837 Musique balisée précédée de @code{\keepWithTag #'@var{nom}}
1838 @tab Musique non balisée et musique balisée par @var{nom} seront
1839 incluses@tie{}; la musique balisée autrement est exclue.
1842 Musique balisée précédée de @code{\removeWithTag #'@var{nom}}
1843 @tab Musique non balisée et fragments appelés autrement que @var{nom}
1844 seront inclus@tie{}; la musique balisée par @var{nom} est exclue.
1847 Musique balisée non précédée de @code{\keepWithTag} ou
1848 @code{\removeWithTag}
1849 @tab Musique balisée et non balisée seront incluses.
1853 Les arguments des commandes @code{\tag}, @code{\keepWithTag} et
1854 @code{\removeWithTag} doivent être un symbole (tel que
1855 @code{#'conducteur} ou @code{#'partie}), suivi d'une expression
1858 Dans l'exemple qui suit, nous obtenons deux versions du même extrait,
1859 l'une pour le conducteur, l'autre pour l'instrumentiste, et qui
1860 comportera les ornements développés.
1862 @lilypond[verbatim,quote]
1863 music = \relative g' {
1865 \tag #'trills { d8.\trill }
1866 \tag #'expand { \repeat unfold 3 { e32 d } }
1871 \keepWithTag #'trills \music
1874 \keepWithTag #'expand \music
1879 Il est parfois plus aisé d'exclure des fragments@tie{}:
1881 @lilypond[verbatim,quote]
1882 music = \relative g' {
1884 \tag #'trills { d8.\trill }
1885 \tag #'expand {\repeat unfold 3 { e32 d } }
1890 \removeWithTag #'expand
1894 \removeWithTag #'trills
1899 Ce principe de filtrage peut s'appliquer aux articulations, textes, etc.
1900 Il suffit de positionner
1903 -\tag #@var{ma-balise}
1907 avant l'articulation ou le texte, comme ici@tie{}:
1911 c1-\tag #'gaffe ^"Attention !"
1915 Ceci définira une note avec une indication conditionnelle de doigté ou
1918 Vous pouvez baliser différemment la même expression musicale en
1919 saisissant plusieurs @code{\tag}@tie{}:
1921 @lilypond[quote,verbatim]
1922 music = \relative c'' {
1923 \tag #'a \tag #'both { a4 a a a }
1924 \tag #'b \tag #'both { b4 b b b }
1927 \keepWithTag #'a \music
1928 \keepWithTag #'b \music
1929 \keepWithTag #'both \music
1933 L'application concomitante de plusieurs filtres @code{\removeWithTag} à
1934 la même expression musicale permet d'exclure plusieurs balisages@tie{}:
1936 @lilypond[verbatim,quote]
1937 music = \relative c'' {
1938 \tag #'A { a4 a a a }
1939 \tag #'B { b4 b b b }
1940 \tag #'C { c4 c c c }
1941 \tag #'D { d4 d d d }
1950 L'application de plus d'un filtre @code{\keepWithTag} à la même
1951 expression musicale aboutit à l'exclusion de @b{tous} les balisages.
1952 En effet, si le premier filtre exclut tous les autres balisages,
1953 l'application du second exclura les effets du premier.
1955 Il peut arriver que vous ayez besoin de raccorder quelque chose en un
1956 point particulier d'une expression musicale. Les commandes
1957 @code{\pushToTag} et @code{\appendToTag} permettent d'insérer du
1958 matériau, qu'il soit antérieur ou postérieur à des @code{éléments}
1959 d'une construction musicale existante. La musique séquentielle ou
1960 simultanée comporte assurément des @code{éléments}@tie{}:
1962 @lilypond[verbatim,quote]
1963 test = { \tag #'here { \tag #'here <<c''>> } }
1966 \pushToTag #'here c'
1967 \pushToTag #'here e'
1968 \pushToTag #'here g' \test
1969 \appendToTag #'here c'
1970 \appendToTag #'here e'
1971 \appendToTag #'here g' \test
1975 Ces deux instructions sont afféctées d'une balise, le matériau à
1976 raccorder à chaque instance de la balise, et l'expression balisée.
1977 Ces instructions prennent soin de recopier tout ce qui doit être
1978 modifié, de telle sorte que l'expression @code{\test} originale conserve
1983 Manuel d'initiation :
1984 @rlearning{Organisation du code source avec des variables}.
1986 Manuel de notation :
1987 @ref{Regroupement automatique de parties},
1988 @ref{Insertion de fichiers LilyPond}.
1992 @c This warning is more general than this placement implies.
1993 @c Rests are not merged whether or not they come from tagged sections.
1994 @c Should be deleted? -td
1998 Lorsqu'elles comportent des silences, ceux-ci ne seront pas fusionnés
1999 si vous imprimez une partition avec les deux sections balisées.
2004 @node Globalisation des réglages
2005 @unnumberedsubsubsec Globalisation des réglages
2006 @translationof Using global settings
2008 @cindex include-settings
2010 Vous pouvez regrouper dans un fichier indépendant vos réglages
2011 personnels que vous incluerez au besoin@tie{}:
2014 lilypond -dinclude-settings=MES_REGLAGES.ly MA_PARTITION.ly
2017 Vous pouvez ainsi stocker dans un fichier séparé vos réglages en matière
2018 de format de papier, de fontes utilisées ou vos définitions
2019 particulières. Selon le fichier de réglages que vous mentionnerez, vous
2020 obtiendrez facilement différentes éditions à partir d'une même source
2021 quelle qu'elle soit.
2023 Ceete technique peut s'utiliser en combinaison avec des feuilles de
2024 styles, comme indiqué au chapitre @rlearning{Feuilles de style}.
2027 Manuel d'initiation :
2028 @rlearning{Organisation du code source avec des variables},
2029 @rlearning{Feuilles de style}.
2031 Manuel de notation :
2032 @ref{Insertion de fichiers LilyPond}.
2035 @node Caractères spéciaux
2036 @subsection Caractères spéciaux
2037 @translationof Special characters
2039 @cindex caractères spéciaux
2040 @cindex non-ASCII, caractères
2045 * Équivalents ASCII::
2049 @node Codage du texte
2050 @unnumberedsubsubsec Codage du texte
2051 @translationof Text encoding
2055 LilyPond utilise le jeu de caractères défini par le consortium Unicode
2056 et la norme ISO/CEI@tie{}10646. Chaque caractère est identifié par un
2057 nom unique et associé à un point de code, ce qui permet dans l'absolu de
2058 couvrir tous les langages. Unicode permet de coder tous les caractères
2059 utilisés par toutes les langues écrites du monde. LilyPond utilise le
2060 codage UTF-8 (UTF pour @emph{Unicode Transformation Format}) qui permet
2061 de représenter les caractères latins sur un octet et les autres sur une
2062 longueur allant jusqu'à quatre octets.
2064 L'apparence réelle des caractères est déterminée par les glyphes ou
2065 graphèmes tels que définis dans les différentes polices disponibles.
2066 Une police, ou une fonte, définit la mise en correspondance d'un
2067 sous-ensemble de points de code unicode en glyphes. LilyPond recourt à
2068 la bibliothèque Pango pour assurer le rendu des textes multilingues.
2070 LilyPond n'effectue aucune conversion d'encodage que ce soit. Ceci
2071 implique donc que tout texte, qu'il s'agisse d'un titre, de paroles ou
2072 même d'instruction musicale, comportant des caractères non ASCII, soit
2073 codé en UTF-8. Le plus sûr moyen de saisir du texte de la sorte
2074 consiste à utiliser un éditeur supportant l'unicode et à enregistrer vos
2075 fichier en UTF-8. C'est le cas pour la plupart des éditeurs actuels,
2076 que ce soit vim, Emacs, jEdit et GEdit. Tous les systèmes Windows
2077 postérieurs à NT utilisent Unicode en natif@tie{}; même Notepad est
2078 capable d'éditer et sauvegarder un fichie en UTF-8 -- sans parler de
2079 l'excellente alternative qu'est BabelPad.
2081 La compilation d'un fichier LilyPond comportant des caractères non ASCII
2082 qui n'aurait pas été enregistré dans l'encodage UTF-8 vous renverra
2086 FT_Get_Glyph_Name () erreur : invalid argument
2089 Voici un exemple utilisant du texte en cyrilique, en hébreux et en
2093 %c No verbatim here as the code does not display correctly in PDF
2095 bulgarian = \lyricmode {
2096 Жълтата дюля беше щастлива, че пухът, който цъфна, замръзна като гьон.
2100 hebrew = \lyricmode {
2101 זה כיף סתם לשמוע איך תנצח קרפד עץ טוב בגן.
2105 portuguese = \lyricmode {
2106 à vo -- cê uma can -- ção legal
2112 \addlyrics { \bulgarian }
2113 \addlyrics { \hebrew }
2114 \addlyrics { \portuguese }
2119 @unnumberedsubsubsec Unicode
2120 @translationof Unicode
2124 Lorsque vous avez besoin d'un caractère dont vous connaissez le point de
2125 code mais que votre éditeur ne permet pas de saisir directement, vous
2126 pouvez utitliser les instructions @code{\char@tie{}##xhhhh} ou
2127 @code{\char@tie{}#dddd} au sein d'un bloc @code{\markup} -- @code{hhhh}
2128 et @code{dddd} correspondant respectivement à la valeur hexadécimale ou
2129 décimale. Même s'il est inutile de saisir les zéros superflus, il est
2130 de bon ton de stipuler les quatre caractères formant la représentation
2131 hexadécimale. Évitez cependant l'encodage UTF-8 d'un point de code
2132 après un @code{\char}@tie{}; les encodages UTF-8 comprennent un bit
2133 supplémentaire indiquant le nombre d'octets. Une table de
2134 correspondance entre les codes Unicode et le nom des caractères ainsi
2135 que leur code hexadécimal est disponible sur le site du consortium
2136 Unicode, @uref{http://www.unicode.org/}.
2138 Par exemple, @code{\char ##x03BE} et @code{\char #958} correspondent
2139 tous deux au caractère unicode U+03BE, dénommé @qq{Greek Small Letter
2142 Quel que soit le point de code spécifié de cette manière, il ne vous
2143 sera alors pas nécessaire d'enregistrer votre fichier en UTF-8. Vous
2144 devrez toutefois disposer d'une fonte contenant ce caractère qui soit
2145 accessible à LilyPond.
2147 L'exemple suivant illustre la manière d'insérer un caractère sous sa
2148 forme hexadécimale, à la fois dans un repère, dans une articulation,
2149 dans des paroles et dans du texte indépendant.
2151 @lilypond[quote,verbatim]
2154 c1 \mark \markup { \char ##x03EE }
2155 c1_\markup { \tiny { \char ##x03B1 " to " \char ##x03C9 } }
2157 \addlyrics { O \markup { \concat { Ph \char ##x0153 be! } } }
2159 \markup { "Copyright 2008--2012" \char ##x00A9 }
2164 Le signe @emph{copyright} dans le champ de titrage consacré s'inscrit de
2165 la manière suivante@tie{}:
2169 copyright = \markup @{ \char ##x00A9 "2008" @}
2174 @node Équivalents ASCII
2175 @unnumberedsubsubsec Équivalents ASCII
2176 @translationof ASCII aliases
2178 Dès lors que vous aurez inclus la liste de leur équivalent ASCII,
2179 LilyPond reconnaitra un certain nombre de caractères spéciaux@tie{}:
2181 @lilypond[quote,verbatim]
2183 #(include-special-characters)
2186 \markup "&flqq; – &OE;uvre incomplète… &frqq;"
2189 \new Staff { \repeat unfold 9 a'4 }
2191 This is al -- so wor -- kin'~in ly -- rics: –_&OE;…
2196 "The replacement can be disabled:"
2197 "– &OE; …"
2198 \override #'(replacement-alist . ()) "– &OE; …"
2202 L'extension de cette liste est possible aussi bien de manière globale :
2204 @lilypond[quote,verbatim]
2206 #(add-text-replacements!
2207 '(("100" . "hundred")
2208 ("dpi" . "dots per inch")))
2210 \markup "A 100 dpi."
2213 qu'en un point particulier de votre source :
2215 @lilypond[quote,verbatim]
2216 \markup \replace #'(("100" . "hundred")
2217 ("dpi" . "dots per inch")) "A 100 dpi."
2221 Manuel de notation :
2222 @ref{Liste des caractères spéciaux}.
2224 Fichiers d'initialisation :
2225 @file{ly/text-replacements.ly}.
2228 @node Contrôle des sorties
2229 @section Contrôle des sorties
2230 @translationof Controlling output
2233 * Extraction de fragments musicaux::
2234 * Ignorer des passages de la partition::
2235 * Formats de sortie alternatifs::
2236 * Changement des fontes musicales::
2239 @node Extraction de fragments musicaux
2240 @subsection Extraction de fragments musicaux
2241 @translationof Extracting fragments of music
2243 LilyPond vous permet d'extraire des fragments d'une partition à l'instar
2244 du choriste amateur qui alimente son album avec des coupures de
2247 Vous devrez pour cela définir les mesures à découper. La définition
2248 suivante, incluse dans votre fichier source,
2255 (make-rhythmic-location 5 1 2)
2256 (make-rhythmic-location 7 3 4)))
2261 vous permettra d'extraire un fragment compris entre le milieu de la
2262 cinquième mesure et quelque part dans la septième. Le triplet
2263 @code{5@tie{}1@tie{}2} signifie@tie{}: après la durée d'une blanche dans
2264 la mesure 5@tie{}; le @code{7@tie{}3@tie{}4} signifie quant à lui que
2265 l'on s'arrête à la mesure 7, après la durée de trois noires.
2267 Rien ne vous empêche d'extraire plusieurs fragments, dès lors que vous
2268 définissez dans la liste d'autres paires d'emplacements ryhtmiques.
2270 Cette fonctionnalité n'est toutefois effective que lorsque vous lancez
2271 LilyPond avec l'option @w{@code{-dclip-systems}}. Les @qq{coupures}
2272 seront générées sous la forme de fichiers EPS, convertis en PDF ou PNG
2273 selon le format que vous aurez stipulé.
2275 Pour de plus amples informations quant au format des résultats,
2276 consultez le chapitre @rprogram{Lancement de lilypond}.
2279 @node Ignorer des passages de la partition
2280 @subsection Ignorer des passages de la partition
2281 @translationof Skipping corrected music
2283 @funindex skipTypesetting
2284 @funindex showFirstLength
2285 @funindex showLastLength
2287 Dans un travail de transcription ou de recopie de la musique, ce qui
2288 vous intéresse plus particulièrement se situe à la fin, là même où vous
2289 en êtes dans la notation. Dans le but de gagner du temps dans le
2290 processus de correction, vous pouvez @qq{escamoter} le reste et ne
2291 générer que les dernières mesures en insérant
2294 showLastLength = R1*5
2299 dans votre fichier source. Ceci aura pour effet de ne générer que les
2300 cinq dernières mesures -- si tant est que le morceau soit à 4/4 -- de
2301 tous les @code{\score} de votre fichier. Dans le cas d'un œuvre
2302 conséquente, cette pratique s'avère fort utile puisqu'elle évite de tout
2303 générer. Vous pourriez aussi être amené à retravailler le début d'une
2304 œuvre, pour y ajouter une partie par exemple, auquel cas c'est la
2305 propriété @code{showFirstLength} que vous utiliserez.
2307 Vous pouvez contrôler très finement les parties à escamoter, grâce au
2308 commutateur @code{Score.skipTypesetting}@tie{}: lorsqu'il est activé,
2309 aucune gravure n'est réalisée.
2311 Ce commutateur agit aussi sur la sortie MIDI. Notez bien que tous les
2312 événements seront escamotés, y compris les changements de tempo ou
2313 d'instrument -- vous voilà prévenu@tie{}!
2315 @lilypond[quote,relative=2,ragged-right,verbatim]
2317 \set Score.skipTypesetting = ##t
2319 \set Score.skipTypesetting = ##f
2323 Dans le cadre de musique polyphonique, @code{Score.skipTypesetting}
2324 s'applique à toutes les voix et portées. Vous gagnerez donc encore plus
2328 @node Formats de sortie alternatifs
2329 @subsection Formats de sortie alternatifs
2330 @translationof Alternative output formats
2332 @cindex scalable vector graphics
2333 @cindex SVG, format de sortie
2334 @cindex encapsulated postscript
2335 @cindex EPS, format de sortie
2337 En matière de partition imprimable, LilyPond génère par défaut des
2338 documents au format PostScript (PS) et Portable Document Format (PDF).
2339 Vous pouvez aussi obtenir des documents au format Scalable Vector
2340 Graphics (SVG), Encapsulated PostScript (EPS) ou Portable Network
2341 Graphics (PNG) dès lors que vous aurez lancé LilyPond en ligne de
2342 commande avec l'option @i{ad hoc} -- voir
2343 @rprogram{Options en ligne de commande pour lilypond} à ce sujet.
2346 @node Changement des fontes musicales
2347 @subsection Changement des fontes musicales
2348 @translationof Replacing the notation font
2350 Gonville est une alternative à la fonte Feta que LilyPond utilise par
2351 défaut. Vous pouvez la télécharger à partir de
2353 @uref{http://www.chiark.greenend.org.uk/~sgtatham/gonville/ ,http://www.chiark.greenend.org.uk/~sgtatham/gonville/}
2356 Voici quelques mesures utilisant la police Gonville@tie{}:
2358 @c NOTE: these images are a bit big, but that's important
2359 @c for the font comparison. -gp
2360 @sourceimage{Gonville_after,,,}
2362 Et ces même mesures avec la police de LilyPond, Feta@tie{}:
2364 @sourceimage{Gonville_before,,,}
2367 @subsubheading Instructions d'installation pour MacOS
2368 @translationof Installation Instructions for MacOS
2370 Téléchargez puis décompressez l'archive zip. Recopiez le répertoire
2371 @code{lilyfonts} dans @file{@var{SHARE_DIR}/lilypond/current} -- voir
2372 @rlearning{Autres sources de documentation} à ce sujet. Renommez le
2373 répertoire @code{fonts} qui s'y trouve en @code{fonts_orig}, puis le
2374 répertoire @code{lilyfonts} en @code{fonts}. Il vous suffira, pour
2375 retrouver la fonte Feta, de renommer @code{fonts_orig} en @code{fonts}.
2379 Manuel d'initiation :
2380 @rlearning{Autres sources de documentation}.
2384 Gonville ne permet pas de générer de la notation ancienne, et certains
2385 glyphes ajoutés depuis lors aux jeux de caractères en soient absent.
2386 Consultez le site de l'auteur pour de plus amples informations ainsi
2387 qu'à propos des conditions d'utilisation.
2391 @section Sortie MIDI
2392 @translationof MIDI output
2397 MIDI (Musical Instrument Digital Interface) constitue un standard en
2398 matière de connexion et de contrôle des instruments électroniques. Un
2399 fichier MIDI contient une série de notes réparties dans différentes
2400 pistes. Il ne s'agit en rien d'un fichier sonore@tie{}; il vous faudra
2401 un logiciel capable de traduire ces séries de notes en sons réels.
2403 Vous pouvez convertir vos partition en fichier MIDI de manière à
2404 entendre ce que vous avez saisi. Ceci vous permet de contrôler aisément
2405 ce que vous avez saisi@tie{}: octaves et altérations erronées heuteront
2406 votre oreille avertie grâce au MIDI.
2408 Le fichier MIDI généré par LilyPond est relativement brut. Vous pouvez
2409 cependant obtenir un meilleur rendu avec @ref{Le script Articulate}.
2411 Dans une sortie MIDI, LilyPond alloue un canal à chaque portée, tout en
2412 réservant le canal@tie{}10 aux percussions. Dans la mesure ou un
2413 périphérique MIDI ne comprend que 16 canaux, un fichier MIDI qui
2414 comportera plus de quinze portées verra le même canal réutilisé.
2417 * Création de fichiers MIDI::
2419 * Contenu de la sortie MIDI::
2420 * Répétitions et MIDI::
2421 * Gestion des nuances en MIDI::
2422 * MIDI et percussions::
2423 * Le script Articulate::
2427 @node Création de fichiers MIDI
2428 @subsection Création de fichiers MIDI
2429 @translationof Creating MIDI files
2431 LilyPond génèrera un fichier MIDI dès que vous ajouterez un bloc
2432 @code{\midi} à la structure de votre partition, comme ici@tie{}:
2441 Lorsque le bloc @code{\score} contient un bloc @code{\midi} mais pas de
2442 bloc @code{\layout}, LilyPond ne produira qu'une sortie MIDI. Si donc
2443 vous avez besoin aussi d'un support visuel, vous devrez aussi mentionner
2444 un bloc @code{\layout}.
2454 Hauteurs, durées, liaisons de prolongation, nuances et changements de
2455 tempo seront interprétés et traduits en événements MIDI. Les
2456 indications de nuances, crescendos et decrescendos sont traduits en
2457 niveau de volume@tie{}; les indications sous la forme d'une fraction
2458 déterminée du volume disponible, et crescendos et decrescendos sous la
2459 forme d'une progression linéaire entre les deux extrêmes. Le rendu des
2460 indications de nuance peut être désactivé pour le MIDI -- voir
2463 Le tempo initial ainsi que ses changements sont normalement indiqués au
2464 fil de la notation à l'aide de la commande @code{\tempo}@tie{}; ils
2465 seront retranscrits dans le fichier MIDI. La commande @code{\tempo}
2466 donne lieu à l'impression d'une indication métronomique que vous pouvez
2467 toutefois rendre invisible, comme indiqué à la rubrique
2468 @ref{Indication métronomique}. Une autre manière de spécifier le tempo
2469 initial pour un fichier MIDI est indiquée plus avant -- voir
2472 En raison de certaines limitations de Windows, les fichiers MIDI doivent
2473 y porter l'extension @code{.mid}. D'autres systèmes utilisent
2474 l'extension @code{.midi}. Si besoin est, placez la ligne suivante au
2475 début de votre fichier source, avant l'ouverture de tout bloc
2476 @code{\book}, @code{\bookpart} ou @code{\score}@tie{}:
2479 #(ly:set-option 'midi-extension "midi")
2482 Cette ligne déterminera @code{.midi} comme extension par défaut pour les
2485 Vous pouvez aussi le faire en ligne de commande@tie{}:
2488 lilypond … -dmidi-extension=midi fichierLily.ly
2492 @unnumberedsubsubsec Noms d'instrument
2493 @translationof Instrument names
2495 @cindex instrument, nom d'
2496 @funindex Staff.midiInstrument
2498 L'instrument MIDI affecté à un canal particulier est déterminé par la
2499 propiété @code{Staff.midiInstrument}. Vous pouvez choisr l'un des
2500 instruments répertoriés à l'annexe @ref{Instruments MIDI}.
2504 \set Staff.midiInstrument = #"glockenspiel"
2510 \new Staff \with @{midiInstrument = #"cello"@} @{
2515 Lorsque l'instrument choisi ne correspond pas exactement à l'une des
2516 dénominations consacrées, LilyPond le replacera par un piano de concert
2517 (@code{"acoustic grand"}).
2522 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
2523 {changing-midi-output-to-one-channel-per-voice.ly}
2527 @c In 2.11 the following no longer seems to be a problem -td
2529 Un (de)crescendo non terminé ne sera pas correctement rendu en MIDI --
2530 il y a nécessairement du silence. Il vous faut donc lui donner une fin
2531 explicite. Par exemple,
2538 ne fonctionnera pas correctement, contrairement à
2541 @{ a4\< b c d\!\f @}
2545 Un changement de volume ne peut intervenir que sur le démarrage d'une
2546 note. C'est la raison pour laquelle la succession d'un crescendo et
2547 d'un diminuendo ne peut se produire sur une même note.
2549 Certains lecteurs MIDI ne rendent pas correctement les changements de
2550 tempo. MS Windows Media Player et
2551 @uref{http://@/timidity@/.sourceforge@/.net/,timidity} le font sans
2556 @subsection Le bloc MIDI
2557 @translationof MIDI block
2559 Dès lors que vous désirez obtenir une sortie MIDI, vous devrez inscrire
2560 un bloc @code{\midi} au sein du bloc @code{\score}. Son fonctionnement
2561 est comparable à ce lui du bloc @code{\layout}, voire plus simple. Si
2562 le bloc @code{\midi} est la plupart du temps laissé vide, il peut
2563 contenir des aménagements pour certains contextes, la définition de
2564 contextes particuliers ou du code permettant de déterminer la valeur de
2565 certaines propriétés. L'exemple suivant détermine le tempo initial du
2566 fichier MIDI tout en se passant de son indication sur la partition
2575 tempoWholesPerMinute = #(ly:make-moment 72 4)
2581 Ici, le tempo est fixé à 72 noires à la minute. Spécifier un tempo de
2582 la sorte ne permet pas de doner une valeur pour une note pointée. Vous
2583 devrez, en pareil cas, subdiviser la note pointée en durée plus courte.
2584 Par exemple, indiquer 90 à la noire pointée est équivalent à spécifier
2585 270 croches à la minute@tie{}:
2588 tempoWholesPerMinute = #(ly:make-moment 270 8)
2591 @cindex MIDI et définition de contexte
2592 @cindex contexte, définition en MIDI
2594 La syntaxe permettant de définir un contexte pour le @code{\midi} est en
2595 tout point identique à celle que vous utilisez dans le bloc
2596 @code{\layout}, à ceci près que le @qq{graveur} est remplacé par un
2597 @qq{interprète}. Les différents contextes disponibles en matière de
2598 MIDI sont répertoriés dans le fichier d'initialisation
2599 @file{../ly/performer-init.ly} -- pour plus de détail, voir
2600 @rlearning{Autres sources de documentation}.
2601 Si vous voulez vous passer des nuances dans votre fichier MIDI, il vous
2602 suffit d'insérer les lignes suivantes dans votre bloc
2610 \remove "Dynamic_performer"
2615 LilyPond ne génèrera de sortie MIDI que si vous incluez un bloc
2616 @code{\midi} dans la structure de la partition, initialisée par la
2617 commande @code{\score}.
2621 @{ @dots{}notes@dots{} @}
2627 @node Contenu de la sortie MIDI
2628 @subsection Contenu de la sortie MIDI
2629 @translationof What goes into the MIDI output?
2631 @c TODO Check grace notes - timing is suspect?
2634 @unnumberedsubsubsec Éléments pris en compte dans le MIDI
2635 @translationof Supported in MIDI
2637 @cindex hauteurs en MIDI
2638 @cindex MIDI, hauteurs
2639 @cindex quart de ton en MIDI
2640 @cindex MIDI, quart de ton
2641 @cindex microtonalité en MIDI
2642 @cindex MIDI, microtonalité
2643 @cindex accords nommés en MIDI
2644 @cindex MIDI, accords nommés
2645 @cindex Rythme en MIDI
2646 @cindex MIDI, Rythme
2647 @cindex articulations et MIDI
2648 @cindex MIDI et articulations
2649 @cindex trilles et MIDI
2650 @cindex MIDI et trilles
2653 Un fichier MIDI généré par LilyPond comprendra les éléments de notation
2661 les microtonalités -- voir @ref{Altérations}. Leur rendu nécessite
2662 cependant un lecteur qui prenne en charge la modulation@tie{};
2665 les accords nommés ;
2668 le rythme en tant que durée de note, y compris les nolets ;
2671 les tremolos, exceptés ceux utilisant la syntaxe
2672 @qq{@code{:}[@var{nombre}]}@tie{};
2675 les liaisons de prolongation ;
2678 les indications de nuance ;
2681 les crescendos et decrescendos s'étalant sur plusieurs notes@tie{};
2684 les changements de tempo indiqués par un @code{\tempo}@tie{};
2690 Si vous utilisez @ref{Le script Articulate}, d'autres éléments seront
2694 @item articulations (lié, staccato, etc.),
2695 @item trilles et groupettos,
2696 @item rallentando et accelerando.
2700 @unnumberedsubsubsec Éléments non pris en compte dans le MIDI
2701 @translationof Unsupported in MIDI
2703 @c TODO index as above
2705 LilyPond ne peut générer d'événement MIDI pour les éléments
2706 suivant, sauf à utiliser @ref{Le script Articulate}@tie{}:
2710 le rythme indiqué sous forme d'annotation (p.ex. @emph{swing})@tie{};
2713 les changements de tempo indiqués sous forme d'annotation (sans
2714 @code{\tempo})@tie{};
2717 les staccatos et autres articulations ou ornementations@tie{};
2720 les liaisons d'articulation et de prhasé@tie{};
2723 les crescendos ou decrescendos sur une sele note@tie{};
2726 les tremolos indiqués par la syntaxe @qq{@code{:}[@var{nombre}]}@tie{};
2732 les accords en microtonalité.
2736 @node Répétitions et MIDI
2737 @subsection Répétitions et MIDI
2738 @translationof Repeats in MIDI
2740 @cindex reprises développées
2741 @cindex MIDI et reprises
2742 @funindex \unfoldRepeats
2744 Au prix de quelques réglages, les reprises de toutes sortes peuvent être
2745 rendues dans le fichier MIDI. Il suffit pour cela de recourir à la
2746 fonction @code{\unfoldRepeats}, qui développe toutes les reprises. En
2747 d'autre termes, @code{\unfoldRepeats} transforme toutes les reprises
2748 en reprises de type @code{unfold}.
2751 @lilypond[quote,verbatim]
2753 \repeat tremolo 8 {c'32 e' }
2754 \repeat percent 2 { c''8 d'' }
2755 \repeat volta 2 {c'4 d' e' f'}
2764 Dans une partition comportant plusieurs voix, le développement des
2765 reprises ne sera effectif en MIDI qu'à la condition que ces reprises
2766 soient mentionnée correctement dans @strong{toutes} les voix.
2768 Lorsque l'on veut utiliser @code{\unfoldRepeats} seulement pour le rendu
2769 MIDI, il faut établir deux blocs @code{\score}@tie{}: un pour le MIDI,
2770 avec des reprises explicites, et l'autre pour la partition, avec des
2771 reprises notées sous forme de barres de reprise, de trémolo ou de
2772 symboles de pourcentage. Par exemple
2780 \unfoldRepeats @var{..musique..}
2786 @node Gestion des nuances en MIDI
2787 @subsection Gestion des nuances en MIDI
2788 @translationof Controlling MIDI dynamics
2790 Les nuances MIDI sont générées par le @code{Dynamic_performer}, affecté
2791 par défaut au contexte @code{Voice}. Vous pouvez contrôler à la fois le
2792 volume général, celui des indications de nuance ainsi que celui des
2793 différents instruments.
2796 @unnumberedsubsubsec Indications de nuance
2797 @translationof Dynamic marks
2799 Les indications de nuances sont transcrites en fraction du volume MIDI.
2800 Nous allons, par défaut, de 0,25 pour un @notation{ppppp} à 0,95 pour un
2801 @notation{fffff}. Les correspondances entre nuance et fraction de
2802 volume sont répertoriées dans le fichier @file{../scm/midi.scm} --
2803 consultez la rubrique @rlearning{Autres sources de documentation} si
2804 vous ne savez comment le localiser. Vous pouvez modifier ou étendre ce
2805 jeu grâce à une fonction qui prendra en argument une indication de
2806 nuance et renverra la fraction désirée, puis en affectant cette fonction
2807 à @code{Score.dynamicAbsoluteVolumeFunction}.
2809 Prenons un exemple. Votre partition comporte un @notation{rinforzando}
2810 que vous avez indiqué par @code{\rfz}. Cette indication de nuance
2811 n'étant pas répertoriée dans le jeu par défaut, elle ne produira aucun
2812 effet en MIDI. Il en sera d'ailleurs de même pour toute indication
2813 créée de toute pièce à l'aide de l'instruction
2814 @w{@code{make-dynamic-script}}. Voici comment procéder pour ajuster le
2815 volume MIDI de ce @notation{rinforzando} que le compositeur a indiqué.
2816 La fonction Scheme définit une fraction de 0,9 en cas de @notation{rfz},
2817 et demande d'utiliser la fonction par défaut dans les autre cas.
2819 @lilypond[verbatim,quote]
2820 #(define (myDynamics dynamic)
2821 (if (equal? dynamic "rfz")
2823 (default-dynamic-absolute-volume dynamic)))
2827 \set Staff.midiInstrument = #"cello"
2828 \set Score.dynamicAbsoluteVolumeFunction = #myDynamics
2840 Si vous étiez amené à devoir modifier l'intégralité du jeu des
2841 correspondances, nous vous conseillons d'utiliser la procédure
2842 @command{default-dynamic-absolute-volume} contenue dans le fichier
2843 @file{../scm/midi.scm} ansi que la table d'association comme base. Le
2844 dernier exemple de cette partie illustre la manière de procéder.
2847 @unnumberedsubsubsec Amplitude du volume en MIDI
2848 @translationof Overall MIDI volume
2850 Les valeurs extrêmes du volume MIDI des nuances se contrôlent à l'aide
2851 des propriétés @code{midiMinimumVolume} et @code{midiMaximumVolume} qui
2852 agissent au niveau @code{Score}. Ces propriétés sont effectives dès
2853 lors qu'une nuance est indiquée@tie{}; une nuance de départ est donc
2854 requise pour que le volume soit ajusté dès le début de la partition.
2855 Vous pouvez alors modifier la fraction correspondant à chaque nuance à
2856 l'aide de la formule
2859 midiMinimumVolume + (midiMaximumVolume - midiMinimumVolume) * fraction
2862 Voici comment ajuster les nuances tout en limitant l'amplitude du volume
2863 entre 0,2 et 0,5@tie{}:
2865 @lilypond[verbatim,quote]
2871 \set Staff.midiInstrument = #"flute"
2872 \new Voice \relative c''' {
2880 \set Staff.midiInstrument = #"clarinet"
2881 \new Voice \relative c'' {
2892 tempoWholesPerMinute = #(ly:make-moment 72 2)
2893 midiMinimumVolume = #0.2
2894 midiMaximumVolume = #0.5
2901 @unnumberedsubsubsec Égalisation de plusieurs instruments (i)
2902 @translationof Equalizing different instruments (i)
2904 La définition de l'amplitude du volume MIDI au niveau d'un contexte
2905 @code{Staff} permet de gérer les volumes relatifs entre les différents
2906 instruments. Ceci constitue en quelque sorte un égaliseur, ce qui
2907 permet d'améliorer notablement la qualité de la sortie MIDI.
2909 La clarinette de l'exemple suivant jouera relativement moins fort que la
2910 flûte. Rappelez-vous que pour que cela fonctionne correctement, la
2911 première note de chacun des instruments doit être affublée d'une
2912 indication de nuance.
2914 @lilypond[verbatim,quote]
2920 \set Staff.midiInstrument = #"flute"
2921 \set Staff.midiMinimumVolume = #0.7
2922 \set Staff.midiMaximumVolume = #0.9
2923 \new Voice \relative c''' {
2931 \set Staff.midiInstrument = #"clarinet"
2932 \set Staff.midiMinimumVolume = #0.3
2933 \set Staff.midiMaximumVolume = #0.6
2934 \new Voice \relative c'' {
2945 tempoWholesPerMinute = #(ly:make-moment 72 2)
2952 @unnumberedsubsubsec Égalisation de plusieurs instruments (ii)
2953 @translationof Equalizing different instruments (ii)
2955 Lorsque les propriétés volume minimum et maximum n'ont pas été définies,
2956 LilyPond appliquera par défaut une légère égalisation pour quelques
2957 instruments. Les instrument concernés ainsi que le niveau d'égalisation
2958 sont répertoriés dans une table @notation{instrument-equalizer-alist}
2959 du fichier @file{../scm/midi.scm}.
2961 Vous pouvez remplacer l'égaliseur basique en définissant une nouvelle
2962 procédure Scheme @code{instrumentEqualizer} au sein du contexte
2963 @code{Score}. Cette procédure prend en unique argument le nom d'un
2964 instrument MIDI et renverra une paire de fractions correspondant au
2965 minimum et maximum de volume alloué à cet instrument. Cette
2966 substitution fonctionne selon le même principe que celui que nous avons
2967 vu en dédut de chapitre avec @code{dynamicAbsoluteVolumeFunction}.
2968 L'égaliseur par défaut, @notation{default-instrument-equalizer}, est
2969 défini dans le fichier @file{../scm/midi.scm}@tie{}; son analyse vous
2970 aidera à construire votre propre procédure.
2972 Nous allons, dans l'exemple suivant, régler le volume relatif de la
2973 flûte et de la clarinette -- au même niveau que dans le précédent.
2975 @lilypond[verbatim,quote]
2976 #(define my-instrument-equalizer-alist '())
2978 #(set! my-instrument-equalizer-alist
2981 ("flute" . (0.7 . 0.9))
2982 ("clarinet" . (0.3 . 0.6)))
2983 my-instrument-equalizer-alist))
2985 #(define (my-instrument-equalizer s)
2986 (let ((entry (assoc s my-instrument-equalizer-alist)))
2995 \set Score.instrumentEqualizer = #my-instrument-equalizer
2996 \set Staff.midiInstrument = #"flute"
2997 \new Voice \relative c''' {
3005 \set Staff.midiInstrument = #"clarinet"
3006 \new Voice \relative c'' {
3017 tempoWholesPerMinute = #(ly:make-moment 72 2)
3024 @c Delete when satisfied this is adequately covered elsewhere -td
3026 @n ode Microtones in MIDI
3027 @s ubsection Microtones in MIDI
3029 @cindex microtones in MIDI
3031 Microtones consisting of half sharps and half flats are exported
3032 to the MIDI file and render correctly in MIDI players which support
3033 pitch bending. See @ref{Note names in other languages}. Here is
3034 an example showing all the half sharps and half flats. It can be
3035 copied out and compiled to test microtones in your MIDI player.
3037 @lilypond[verbatim,quote]
3054 @node MIDI et percussions
3055 @subsection MIDI et percussions
3056 @translationof Percussion in MIDI
3058 La notation pour percussions recourt généralement à un contexte
3059 particulier -- le @code{DrumStaff} -- qui permet d'affecter directement
3060 les instruments concernés au canal@tie{}10 qui leur est réservé.
3062 Certains instruments, tels le xylophone, le marimba, le vibraphone ou
3063 les timbales, se traitent cependant comme des instruments
3064 @qq{classiques} puisqu'ils sont capables d'émettre des hauteurs
3065 différentes@tie{}; leurs notation relève donc d'un contexte @code{Staff}
3066 standard, et non d'un @code{DrumStaff} pour pouvoir être rendus
3067 correctement en MIDI.
3069 D'autres percussions, bien que n'émettant qu'un seul son et inclus dans
3070 le standard @emph{general MIDI}, comme le tom mélodique ou le tambour
3071 taiko, ne sont pas attachés au canal@tie{}10. Ces instruments doivent
3072 donc être saisi dans un contexte @code{Staff}, en utilisant la hauteur
3075 De nombreux instruments de la famille des percussions, les castagnettes
3076 par exemple, n'existent pas dans le standard @emph{general MIDI}.
3077 L'alternative, bien que peu satisfaisante, consiste à leur attribuer le
3078 son le plus proche dans la banque standard.
3080 @c TODO Expand with examples, and any other issues
3084 Le standard @emph{general MIDI} ne dispose pas du @emph{rim shot}@tie{};
3085 LilyPond lui subtitue un @emph{sidestick}.
3088 @node Le script Articulate
3089 @subsection Le script Articulate
3090 @translationof The Articulate script
3092 Vous obtiendrez un rendu MIDI plus @qq{réaliste} grâce au script
3093 @code{articulate}. Celui-ci va tout faire pour d'une part prendre en
3094 compte les articulations (liaisons, staccato, etc.) -- en ajoutant un
3095 blanc aux notes raccourcies -- et, d'autre part, développer les trilles
3096 ou groupettos ainsi que tenir compte des éventuels rallentando et
3099 L'utilisation du script @code{articulate} se fait en deux temps. Vous
3100 devez dans un premier temps inclure son fichier d'initialisation en
3101 ajoutant en tête de votre fichier la ligne
3104 \include "articulate.ly"
3107 puis, dans le bloc @code{\score}, indiquer que toutes les répétitions
3108 seront développées et appliquer la commande à votre musique@tie{}:
3111 \unfoldRepeats \articulate <<
3112 tout le reste du bloc contenant la partition...
3116 Une fois votre fichier modifié de la sorte, vous constaterez que la
3117 version imprimable aura été modifiée en profondeur. Le bloc
3118 @code{\midi} produira par contre un fichier MIDI de bien meilleure
3121 Bien que cela ne gène en rien le fonctionnement du script
3122 @code{articulate}, lui adjoindre la commande @code{\unfoldRepeats} comme
3123 illustré ci-dessus permettra le rendu d'un certain nombre
3124 d'articulations tels les trilles.
3128 Dans la mesure où la script @code{articulate} tend à raccourcir les
3129 accords, certaines musiques, notamment pour l'orgue, paraîtront de moins
3133 @node Extraction d'informations musicales
3134 @section Extraction d'informations musicales
3135 @translationof Extracting musical information
3137 En plus de générer du graphisme et du MIDI, LilyPond peut présenter
3138 l'information musicale sous forme textuelle.
3141 * Affichage de notation au format LilyPond::
3142 * Affichage de la musique sous forme d'expression scheme::
3143 * Enregistrement d'événements musicaux dans un fichier::
3147 @node Affichage de notation au format LilyPond
3148 @subsection Affichage de notation au format LilyPond
3149 @translationof Displaying LilyPond notation
3151 @funindex \displayLilyMusic
3153 La fonction musicale @code{\displayLilyMusic} permet d'afficher en
3154 notation LilyPond une expression musicale. Le réultat défilera dans le
3155 terminal après avoir lancé LilyPond en ligne de commande. Par exemple,
3159 \displayLilyMusic \transpose c a, @{ c4 e g a bes @}
3166 @{ a,4 cis e fis g @}
3169 LilyPond affichera le résultat sous forme de message en console, au
3170 milieu de toutes les informations de compilation. Afin d'isoler ces
3171 messages et enregistrer le résultat de la fonction
3172 @code{\display@{MATÉRIAU@}}, pensez à rediriger la sortie vers un
3176 lilypond fichier.ly >affichage.txt
3181 Vous noterez que LilyPond ne se contente pas de simplement afficher
3182 l'expression musicale, mais procède aussi à son interprétation -- du
3183 fait que @code{\displayLilyMusic} renvoie l'expression tout en
3184 l'affichant. S'il est bien pratique d'insérer un
3185 @code{\displayLilyMusic} dans une expression musicale pour en obtenir
3186 des informations, l'interprétation de cette expression peut toutefois
3187 être évitée en ajoutant un @code{\void} avant l'instruction@tie{}:
3191 \void \displayLilyMusic \transpose c a, @{ c4 e g a bes @}
3196 @node Affichage de la musique sous forme d'expression scheme
3197 @subsection Affichage de la musique sous forme d'expression scheme
3198 @translationof Displaying scheme music expressions
3200 Voir @rextend{Displaying music expressions}.
3203 @node Enregistrement d'événements musicaux dans un fichier
3204 @subsection Enregistrement d'événements musicaux dans un fichier
3205 @translationof Saving music events to a file
3207 LilyPond vous permet de sauvegarder dans un fichier séparé, sur la base
3208 de la portée, les événements musicaux. Vous devrez pour ce faire
3209 inclure dans votre fichier maître un fichier d'initialisation
3213 \include "event-listener.ly"
3216 Pour chaque portée que comporte votre partition, vous obtiendrez un
3217 fichier @file{NOMFICHIER-PORTÉENOMMÉE.notes} ou
3218 @file{NOMFICHIER-unnamed-staff.notes}. Notez bien que si plusieurs
3219 portées ne sont pas explicitement nomées, tous leurs événements seront
3220 regroupés et mélangés dans le même fichier. Le résultat ressemblera à
3224 0.000 note 57 4 p-c 2 12
3226 0.250 note 62 4 p-c 7 12
3227 0.500 note 66 8 p-c 9 12
3228 0.625 note 69 8 p-c 14 12
3233 Il s'agit d'un tableau dont les colonnes sont délimitées par une
3234 tabulation. Chaque ligne comporte deux champs fixes suivis d'un certain
3235 nombre de paramètres optionnels.
3238 @var{temps} @var{type} @var{...paramètres...}
3241 Ces informations peuvent faire l'objet d'un retraîtement par d'autres
3242 programmes, comme des scripts python, aux fins de recherche en analyse
3243 musicologique ou des expériences à partir du rendu de LilyPond.
3248 Tous les événements ne sont pas pris en charge par
3249 @file{event-listener.ly}. Il s'agit en premier lieu d'une
3250 démonstration, un @qq{proof of concept} du potentiel de LilyPond. Si
3251 certains des éléments que vous cherchez à obtenir n'apparaîssent pas,
3252 recopiez le fichier @file{event-listener.ly} dans votre répoertoire et
3253 modifiez-le de telle sorte qu'il travaille selon vos attentes.