1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
4 Translation of GIT committish: 049bdd90b5ae67fe463bf85e926c2eabf51acf74
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
24 * Agencement du code::
26 * Travail sur des fichiers texte::
27 * Contrôle des sorties::
29 * 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 :
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 :
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 : 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 : 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 @code{\score} ;
184 le contenu du champ @code{piece} viendra s'imprimer avant chaque
185 mouvement. De même, le titre de l'ouvrage peut se placer au sein du
186 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} :
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 :
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'expressions de
367 haut niveau. Les expressions de haut niveau sont les suivantes :
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 à un niveau supérieur, les
375 différents contenus seront combinés, à ceci près qu'en cas de
376 déclarations conflictuelles, la dernière aura préséance. Des
377 informations complémentaires sont disponibles à la rubrique
378 @ref{Le bloc \layout}.
381 Une expression Scheme pure, telle que
382 @w{@code{#(set-default-paper-size "a7" 'landscape)}} ou
383 @w{@code{#(ly:set-option 'point-and-click #f)}}.
386 Un bloc @code{\header}, dont le contenu sera de portée globale -- ce qui
387 est le cas en général pour le titre ou l'auteur entre autres.
390 Un bloc @code{\score} pour la partition. Cette partition sera assemblée
391 avec les autres partitions se trouvant au même niveau pour composer le
392 @code{\book}. Vous pouvez modifier ce comportement à l'aide de la
393 variable @code{toplevel-score-handler} placée en tête.
395 @c FIXME - I cannot read "toplevel-score-handler" in scm/lily.scm -jcm
396 The default handler is defined in the init file @file{../scm/lily.scm}.
400 Un bloc @code{\book} permet de regrouper naturellement plusieurs
401 mouvements -- autrement dit plusieurs blocs @code{\score} -- dans un
402 même document. Lorsqu'il y a plusieurs @code{\score}, LilyPond génère
403 un seul fichier dans lequel les mouvements sont mis les uns à la suite
404 des autres, ce pour chacun des blocs @code{\book} rencontrés. La seule
405 raison qui peut vous demander d'expliciter plusieurs blocs @code{\book}
406 dans un fichier @file{.ly} est lorsque vous avez besoin de générer
407 différents documents à partir d'une même source. La présence explicite
408 d'un bloc @code{\book} est aussi nécessaire lorsque vous travaillez sur
409 un document lilypond-book qui reprendrait plusieurs @code{\score} ou
410 @code{\markup} dans un même extrait. Vous pouvez modifier ce
411 comportement à l'aide de la variable @code{toplevel-book-handler}
414 @c FIXME - I cannot read "toplevel-book-handler" in scm/lily.scm -jcm
415 The default handler is defined in the init file @file{../scm/lily.scm}.
419 Un bloc @code{\bookpart}. Un ouvrage peut se découper en plusieurs
420 parties à l'aide de blocs @code{\bookpart}, aussi bien pour alléger le
421 travail de l'algorithme de calcul des sauts de page, que si les réglages
422 du bloc @code{\paper} diffèrent d'une partie à l'autre.
425 Une expression musicale telle que
430 Ce bout de code sera placé dans un @code{\score} et intégré à l'ouvrage
431 en même temps que tous les autres @code{\score} ou expressions
432 musicales. En d'autres termes, un fichier qui ne contiendrait que cette
433 simple expression musicale sera traduit en
450 Vous pouvez modifier ce comportement à l'aide de la variable
451 @code{toplevel-music-handler} placée en tête.
453 @c FIXME - I cannot read "toplevel-music-handler" in scm/lily.scm -jcm
454 The default handler is defined in the init file @file{../scm/lily.scm}.
458 Du texte sous forme de @emph{markup} comme les paroles d'un couplet
461 2. Le première ligne du deuxième couplet.
465 De tels @emph{markups} seront imprimés là où ils apparaissent,
466 avant, après ou entre les expressions musicales.
469 @cindex identificateurs
472 Une variable, ou identificateur, telle que
474 toto = @{ c4 d e d @}
477 Vous pourrez la réutiliser plus loin dans votre fichier en saisissant
478 simplement @code{\toto}. Le nom des identificateurs ne doit être
479 formés que de caractères alphabétiques -- sans chiffre ni caractère
484 Voici trois éléments que vous pouvez placer à un niveau supérieur :
488 % pas en pleine largeur
499 Vous pouvez placer, n'importe où dans votre fichier, les instructions
503 @item @code{\version}
504 @item @code{\include}
505 @item @code{\sourcefilename}
506 @item @code{\sourcefileline}
508 Une ligne de commentaire, introduite par le signe @code{%}.
511 Un bloc de commentaire, délimité par @code{%@{ .. %@}}.
518 Vous pouvez insérer des espaces dans votre fichier source afin de lui
519 apporter une meilleure lisibilité. Les espaces superflus sont
520 normalement ignorés. Notez cependant qu'il est des cas où l'espace est
521 requis pour éviter tout risque d'erreur :
525 Autour d'une accolade, qu'elle soit ouvrant ou fermante ;
528 Après chaque commande ou variable, autrement dit tout élément qui
529 commence par un @code{\} ;
532 Après tout élément qui sera interprété comme une expression Scheme,
533 autrement dit tout élément qui commence par un @code{#} ;
536 Pour séparer les éléments d'une expression Scheme ;
539 En mode parole -- @code{lyricmode} -- pour séparer les termes des
540 commandes @code{\override} et @code{\set}. Précisons à ce sujet qu'en
541 plus d'ajouter une espace avant et après l'intégralité de la commande,
542 vous devrez encadrer d'espaces le point et le signe égal qu'elle peut
544 @w{@code{\override Score . LyricText #'font-size = #5}}.
549 Manuel d'initiation :
550 @rlearning{Organisation des fichiers LilyPond}.
553 @ref{Le bloc \layout}.
556 @node Titres et entêtes
557 @section Titres et entêtes
558 @translationof Titles and headers
560 La plupart de la musique qui est éditée comporte un titre et le nom de
561 son compositeur ; certains ouvrages divulguent beaucoup plus
565 * Création de titres et entête ou pied de page::
566 * Titrages personnalisés::
567 * Notes de bas de page::
568 * Référencement des numéros de page::
569 * Table des matières::
573 @node Création de titres et entête ou pied de page
574 @subsection Création de titres et entête ou pied de page
575 @translationof Creating titles headers and footers
578 * Contenu des blocs de titrage::
579 * Mise en forme par défaut des titrages::
580 * Mise en forme par défaut des entête et pied de page::
584 @node Contenu des blocs de titrage
585 @unnumberedsubsubsec Contenu des blocs de titrage
586 @translationof Title blocks explained
588 @c TODO: figure out how \bookpart titles work
590 Il existe en fait deux types de blocs de titrage : un bloc pour
591 contenir le titre principal qui doit apparaître avant le tout premier
592 @code{\score} d'un ouvrage, et un autre attaché à chacun des blocs
593 @code{\score} qui le composent. Dans les deux cas, les champs qui
594 composent un bloc de titrage se saisissent dans un bloc @code{\header}.
596 Lorsque l'ouvrage ne comporte qu'un seul morceau, le bloc @code{\header}
597 peut se placer en dehors ou au sein même du bloc @code{\score}.
599 Dans le cas où le bloc @code{\header} est défini à l'intérieur du bloc
600 @code{\score}, seuls les champs @code{piece} et @code{opus} seront
603 @lilypond[papersize=a5,quote,verbatim,noragged-right]
607 title = "title" % not printed
614 @funindex print-all-headers
616 Vous pouvez modifier ce comportement et imprimer tous les champs d'un
617 bloc @code{\header} défini dans un bloc @code{\score} en ajoutant
621 print-all-headers = ##t
625 @warning{N'oubliez pas que lorsqu'il est placé à l'intérieur d'un bloc
626 @code{@bs{}score}, le bloc @code{@bs{}header} doit impérativement se
627 trouver @strong{à la suite} de l'expression musicale.}
629 @lilypond[papersize=a5,quote,verbatim,noragged-right]
632 composer = "J. S. Bach."
636 \new Staff \relative g, {
639 \repeat unfold 2 { g16( d' b') a b d, b' d, } |
640 \repeat unfold 2 { g,16( e' c') b c e, c' e, } |
648 \new Staff \relative b {
652 <g, d' b'~>4 b'16 a( g fis) g( d e fis) g( a b c) |
653 d16( b g fis) g( e d c) b(c d e) fis( g a b) |
661 Tous les champs appartenant au titrage principal d'un ouvrage peuvent se
662 reporter dans chaque bloc @code{\score} ou être supprimés manuellement :
665 @lilypond[papersize=a5,quote,verbatim,noragged-right]
668 print-all-headers = ##t
671 title = "DAS WOHLTEMPERIRTE CLAVIER"
673 % Pas de mention spéciale pour cet ouvrage
676 \markup { \vspace #1 }
680 \new Staff { \clef "bass" s1 }
683 title = "PRAELUDIUM I"
685 % Pas de sous-titre pour ce morceau
692 \new Staff { \clef "bass" s1 }
696 subsubtitle = "A 4 VOCI"
698 % Pas de sous-titre pour ce morceau
707 @ref{Structure de fichier},
708 @ref{Mise en forme personnalisée des blocs de titrage}.
711 @node Mise en forme par défaut des titrages
712 @unnumberedsubsubsec Mise en forme par défaut des titrages
713 @translationof Default layout of book and score title blocks
715 Voici les différentes variables attachées au bloc @code{\header} :
718 @lilypond[papersize=a7,quote,verbatim,noragged-right]
721 % Les champs suivants sont centrés
722 dedication = "Dédicace"
724 subtitle = "Sous-titre"
725 subsubtitle = "Sous-sous-titre"
726 % Les champs suivants sont répartis sur une même ligne, et
727 % le champ "instrument" apparaîtra sue les pages suivantes
728 instrument = \markup \with-color #green "Instrument"
730 composer = "Compositeur"
731 % Les champs suivants sont en opposition sur la même ligne
733 arranger = "Arrangeur"
734 % Les champs suivants sont centrés en bas de page
735 tagline = "« tagline » ou mention spéciale en pied de dernière page"
736 copyright = "copyright en pied de première page"
741 % Les champs suivants sont en opposition sur la même ligne
749 % Les champs suivants sont en opposition sur la même ligne
750 piece = "Pièce 2 sur la même page"
758 % Les champs suivants sont en opposition sur la même ligne
759 piece = "Pièce 3 sue une nouvelle page"
766 Quelques précisions :
770 Le nom de l'instrument sera répété en tête de chaque page.
773 Seuls seront imprimés les champs @code{piece} et @code{opus} inclus dans
774 un bloc @code{\score} dès lors que la variable @code{print-all-headers}
775 reste désactivée (valeur à @code{##f}).
778 @c Is the bit about \null markups true? -mp
779 Les champs d'un bloc @code{\header} qui n'auront pas été alimentés
780 seront remplacés par un @emph{markup} @code{\null} de façon à ne pas
784 Par défaut, @code{scoreTitleMarkup} place les champs @code{piece} et
785 @code{opus} de part et d'autre sur une même ligne.
789 Les possibilités de modifier la mise en forme par défaut sont abordées à
790 la rubrique @ref{Mise en forme personnalisée des blocs de titrage}.
794 La variable @code{breakbefore} activée dans un bloc @code{\header} situé
795 dans un bloc @code{\score} force le saut de page avant le morceau
796 contenu dans ce @code{\score}. Vous pourrez ainsi séparer le titre
797 principal de la musique.
799 @lilypond[papersize=a8landscape,verbatim,noragged-right]
802 title = "This is my Title"
803 subtitle = "This is my Subtitle"
804 copyright = "This is the bottom of the first page"
807 \repeat unfold 4 { e'' e'' e'' e'' }
809 piece = "This is the Music"
817 Manuel d'initiation :
818 @rlearning{Organisation des fichiers LilyPond}.
821 @ref{Mise en forme personnalisée des blocs de titrage},
822 @ref{Structure de fichier}.
824 Fichiers d'initialisation :
825 @file{ly/titling-init.ly}.
828 @node Mise en forme par défaut des entête et pied de page
829 @unnumberedsubsubsec Mise en forme par défaut des entête et pied de page
830 @translationof Default layout of headers and footers
832 Les entête et pied -- @emph{headers} et @emph{footers} -- sont des
833 lignes de textes qui apparaissent en haut et en bas de chaque page,
834 indépendamment du texte de l'ouvrage. Ils sont contrôlés par les
835 variables suivantes, attachées au bloc @code{\paper} :
838 @item @code{oddHeaderMarkup} -- entête de page impaire
839 @item @code{evenHeaderMarkup} -- entête de page paire
840 @item @code{oddFooterMarkup} -- pied de page impaire
841 @item @code{evenFooterMarkup} -- pied de page paire
844 Ces variables @emph{markup} n'accèdent qu'au contenu des champs du bloc
845 @code{\header} principal, celui qui s'appliquera à tous les blocs
846 @code{\score} du document. Ces variables sont définies dans le fichier
847 @file{ly/titling-init.ly}, et sont par défaut :
852 les numéros sont placés en haut à gauche (si pair) ou à droite (si
853 impair) de chaque page à compter de la deuxième ;
856 le contenu du champ @code{instrument} est centré en haut de chaque page
857 à compter de la deuxième ;
860 le texte du @code{copyright} est centré au bas de la première page ;
863 le @code{tagline} -- mention spéciale -- se place au bas de la dernière
864 page, ou bien sous le @code{copyright} s'il n'y a qu'une seule page.
868 @lilypond[papersize=a8landscape]
878 La mention spéciale se modifie en alimentant le champ @code{tagline} au
879 niveau du bloc @code{\header} principal.
881 @lilypond[papersize=a8landscape,verbatim]
884 tagline = "... music notation for Everyone"
894 Pour supprimer le @code{tagline}, il suffit de lui assigner la valeur
898 @node Titrages personnalisés
899 @subsection Titrages personnalisés
900 @translationof Custom headers footers and titles
902 @c TODO: somewhere put a link to header spacing info
903 @c (you'll have to explain it more in NR 4).
906 * Mise en forme personnalisée des champs de titrage::
907 * Mise en forme personnalisée des blocs de titrage::
908 * Mise en forme personnalisée des entête et pied de page::
912 @node Mise en forme personnalisée des champs de titrage
913 @unnumberedsubsubsec Mise en forme personnalisée des champs de titrage
914 @translationof Custom text formatting for title blocks
916 Toutes les commandes de mise en forme d'un @code{\markup} permettent de
917 personnaliser le texte des entête, pied de page et éléments de titre
918 contenus dans un bloc @code{\header}.
920 @lilypond[quote,verbatim,noragged-right]
924 piece = \markup { \fontsize #4 \bold "PRAELUDIUM I" }
925 opus = \markup { \italic "(Excerpt)" }
932 @ref{Mise en forme du texte}.
935 @node Mise en forme personnalisée des blocs de titrage
936 @unnumberedsubsubsec Mise en forme personnalisée des blocs de titrage
937 @translationof Custom layout for title blocks
939 @cindex bookTitleMarkup
940 @cindex scoreTitleMarkup
941 @funindex bookTitleMarkup
942 @funindex scoreTitleMarkup
944 L'utilisation de commandes @code{\markup} au sein d'un bloc
945 @code{\header} permet de modifier aisément l'apparence du texte,
946 mais n'influence en rien le positionnement précis des éléments de
947 titrage. L'accès au positionnement des champs de titrage est géré par
948 les deux variables suivantes, attachées au bloc @code{\paper} :
951 @item @code{bookTitleMarkup}
952 @item @code{scoreTitleMarkup}
955 Le positionnement des titres, avec les valeurs par défaut de ces
956 variables @code{\markup}, est illustré à la rubrique
957 @ref{Mise en forme par défaut des titrages}.
959 Voici les réglages par défaut de @code{scoreTitleMarkup}, tels que
960 définis dans le fichier @file{ly/titling-init.ly} :
963 scoreTitleMarkup = \markup @{ \column @{
964 \on-the-fly #print-all-headers @{ \bookTitleMarkup \hspace #1 @}
966 \fromproperty #'header:piece
967 \fromproperty #'header:opus
973 Ceci aura donc pour effet de positionner les champs @code{piece} et
974 @code{opus} sur la même ligne, en opposition :
976 @lilypond[quote,verbatim,noragged-right]
980 piece = "PRAELUDIUM I"
986 Voici comment positionner le champ @code{piece}, dont nous modifions
987 la taille et la graisse, au centre de cette ligne :
989 @lilypond[papersize=a5,quote,verbatim,noragged-right]
993 scoreTitleMarkup = \markup {
996 \fontsize #4 \bold \fromproperty #'header:piece
997 \fromproperty #'header:opus
1001 \header { tagline = ##f }
1005 piece = "PRAELUDIUM I"
1012 Les champs normalement réservés au bloc de titrage principal seront
1013 reportés au niveau inférieur dès lors que vous aurez activé
1014 l'instruction @code{print-all-headers} au sein du bloc @code{\paper}.
1015 Le principal inconvénient de cette fonction réside dans le fait que les
1016 champs réservés au bloc @code{\header} principal devront être supprimés
1017 dans chacun des blocs @code{\score} de votre fichier source -- voir
1018 @ref{Contenu des blocs de titrage}.
1020 Afin d'éviter ce désagrément, ajoutez le champ que vous désirez voir
1021 apparaître à la définition de @code{scoreTitleMarkup}. Nous allons,
1022 dans l'exemple suivant, ajouter au @code{scoreTitleMarkup} le champ
1023 @code{composer}, normalement associé au @code{bookTitleMarkup} ;
1024 chaque @code{\score} pourra mentionner un compositeur différent.
1026 @lilypond[papersize=a5,quote,verbatim,noragged-right]
1030 scoreTitleMarkup = \markup {
1033 \fontsize #4 \bold \fromproperty #'header:piece
1034 \fromproperty #'header:composer
1038 \header { tagline = ##f }
1043 composer = "Christian Petzold"
1050 composer = "François Couperin"
1056 Rien ne vous empêche de créer votre propre champ personnalisé, puis d'y
1057 faire référence dans la définition du @emph{markup}.
1059 @lilypond[papersize=a5,quote,verbatim,noragged-right]
1063 scoreTitleMarkup = \markup {
1066 \override #`(direction . ,UP) {
1068 \center-align \fontsize #-1 \bold
1069 \fromproperty #'header:mycustomtext %% User-defined field
1070 \center-align \fontsize #4 \bold
1071 \fromproperty #'header:piece
1074 \fromproperty #'header:opus
1078 \header { tagline = ##f }
1083 mycustomtext = "A 4 VOCI" %% User-defined field
1091 Manuel de notation :
1092 @ref{Contenu des blocs de titrage}.
1095 @node Mise en forme personnalisée des entête et pied de page
1096 @unnumberedsubsubsec Mise en forme personnalisée des entête et pied de page
1097 @translationof Custom layout for headers and footers
1099 @c can make-header and make-footer be removed from
1100 @c paper-defaults-init.ly? -mp
1102 L'utilisation de commandes @code{\markup} au sein d'un bloc
1103 @code{\header} permet de modifier aisément l'apparence du texte,
1104 mais n'influence en rien le positionnement précis des entête et pied
1105 de page. L'accès au positionnement des champs concernés est géré par
1106 les quatre variables suivantes, attachées au bloc @code{\paper} :
1109 @item @code{oddHeaderMarkup}
1110 @item @code{evenHeaderMarkup}
1111 @item @code{oddFooterMarkup}
1112 @item @code{evenFooterMarkup}
1115 @cindex markup conditionnel
1116 @cindex condition et markup
1118 @funindex \on-the-fly
1120 L'instruction @code{\on-the-fly} au sein d'un @code{\markup} permet
1121 d'ajouter, lorsque certaines conditions sont respectées, des éléments
1122 au texte des entête et pied de page définis dans le bloc @code{\paper}.
1123 En voici la syntaxe :
1126 @code{variable} = @code{\markup} @{
1128 @code{\on-the-fly} #@var{procédure} @var{markup}
1133 La @var{procédure} est appelée à chaque fois que la commande
1134 @code{\markup} où elle apparaît est évaluée. La @var{procédure}
1135 effectuera un test de conformité particulière et interprètera, autrement
1136 dit imprimera l'argument @var{markup} si et seulement si cette
1137 condition est remplie.
1139 LilyPond dispose d'ores et déjà d'un certain nombre de procédures :
1142 @multitable {print-page-number-check-first-----} {ce n'est la première page du book--}
1144 @headitem Nom de la procédure @tab Condition testée
1146 @item print-page-number-check-first @tab il faut imprimer ce numéro de page.
1147 @item create-page-number-stencil @tab 'print-page-numbers est vrai.
1148 @item print-all-headers @tab 'print-all-headers est vrai.
1149 @item first-page @tab c'est la première page du @emph{book}.
1150 @item (on-page nombre) @tab page number = nombre
1151 @item last-page @tab c'est la dernière page du @emph{book}.
1152 @item not-first-page @tab ce n'est la première page du @emph{book}.
1153 @item part-first-page @tab c'est la première page de la partie.
1154 @item part-last-page @tab c'est la dernière page de la partie.
1155 @item not-single-page @tab cette partie fait plus d'une page.
1160 L'exemple suivant illustre la manière de centrer son numéro au bas de
1161 chaque page. Il nous faut tout d'abord annuler la définition de
1162 @code{oddHeaderMarkup} et @code{evenHeaderMarkup} à l'aide d'un
1163 @emph{markup} @code{\null}. Nous redéfinissons ensuite
1164 @code{oddFooterMarkup} pour qu'il contienne le numéro de page, centré.
1165 Enfin, nous appliquons le même paramétrage au @code{\oddFooterMarkup}.
1167 @lilypond[papersize=a8,quote,verbatim,noragged-right]
1170 print-page-number = ##t
1171 print-first-page-number = ##t
1172 oddHeaderMarkup = \markup \null
1173 evenHeaderMarkup = \markup \null
1174 oddFooterMarkup = \markup {
1176 \on-the-fly #print-page-number-check-first
1177 \fromproperty #'page:page-number-string
1180 evenFooterMarkup = \oddFooterMarkup
1183 \new Staff { s1 \break s1 \break s1 }
1188 Plusieurs conditions @code{\on-the-fly} mentionnées l'une à la suite de
1189 l'autre se cumulent. Ainsi, par exemple,
1192 @code{\on-the-fly #first-page}
1193 @code{\on-the-fly #last-page}
1194 @code{@{ \markup ... \fromproperty #'header: ... @}}
1197 teste si la sortie tient sur une page unique.
1200 Manuel de notation :
1201 @ref{Contenu des blocs de titrage},
1202 @ref{Mise en forme par défaut des titrages}.
1204 fichiers d'initialisation :
1205 @file{../ly/titling-init.ly}.
1208 @node Notes de bas de page
1209 @subsection Notes de bas de page
1210 @translationof Creating footnotes
1212 LilyPond dispose de deux méthodes pour créer des notes de bas de page,
1213 l'une automatisée, et l'autre manuelle.
1216 * Considérations générales en matière de note de bas de page::
1217 * Notes de bas de page automatiques::
1218 * Notes de bas de page manuelles::
1222 @node Considérations générales en matière de note de bas de page
1223 @unnumberedsubsubsec Considérations générales en matière de note de bas de page
1224 @translationof Footnotes overview
1226 Il est parfois judicieux, notamment lorsqu'une annotation ou un
1227 commentaire gênerait la lecture de la partition, de les reporter en bas
1230 Les notes de bas de page automatiques font appel à un compteur
1231 numérique incrémenté automatiquement ; les notes de bas de page
1232 manuelles vous laissent le libre choix de l'appel (l'indicateur). Une
1233 note de bas de page s'applique comme un @code{\tweak} ; elle peut donc
1234 s'attacher directement à un objet graphique créé par la plupart des
1235 éléments musicaux ou événements rattachés. Lorsque ce n'est pas
1236 possible, par exemple sur une barre de mesure ou un changement de
1237 métrique -- l'objet étant alors le résultat d'une modification de
1238 propriété --, les notes de bas de page peuvent être spécifiées en tant
1239 qu'événement musical indépendant et affectant tous les objets d'un
1240 type particulier à un instant particulier.
1242 Examinons la forme développée d'une commande de note de bas de page :
1245 \footnote @var{marque} @var{décalage} @var{nom-grob} @var{annotation}
1249 Ses arguments peuvent se définir ainsi :
1253 un @emph{markup} ou une chaîne de caractères identifiant l'annotation
1254 tant au niveau de l'appel que de la note qui apparaîtra au bas de la
1255 page. L'absence de cet élément -- ou une valeur de @code{\default} --
1256 incrémentera le compteur.
1259 une paire de nombres -- @samp{#(2 . 1)} par exemple -- spécifiant le
1260 décalage de la marque, en abscisse et en ordonnée, par rapport au point
1264 le type d'objet à annoter -- @samp{#'Flag} par exemple. Lorsque cet
1265 élément est spécifié, c'est l'objet en question qui servira de point de
1266 référence, même s'il trouve son origine non pas directement dans
1267 l'élément @var{musique} mais dans un objet en résultant. Son absence ou
1268 une valeur de @code{\default} ne permet d'annoter que des objets
1272 un @emph{markup} ou une chaîne de caractères qui sera reporté au bas de
1276 l'élément qui fait l'objet du commentaire, qu'il s'agisse d'un
1277 événement musical, de l'un des constituants d'un accord ou d'un
1278 événement rattaché. Bien qu'il ne puisse être omis, il peut être
1279 remplacé par @code{\default}, auquel cas l'annotation ne sera pas
1280 rattachée à une expression musicale particulière, mais plutôt à un
1281 instant précis. L'argument @var{nom-grob} est alors obligatoire pour
1282 sélectionner le type d'objet affecté -- @samp{#'TimeSignature} par
1286 Tout comme pour la commande @code{\tweak}, lorsqu'un @code{\footnote}
1287 s'applique à un événement rattaché ou à une articulation, il devra être
1288 précédé d'un @code{-} de telle sorte que l'analyseur syntaxique en
1289 attache le résultat à la note ou au silence précédant.
1292 @node Notes de bas de page automatiques
1293 @unnumberedsubsubsec Notes de bas de page automatiques
1294 @translationof Automatic footnotes
1296 @cindex note de bas de page automatique
1297 @cindex bas de page, note automatique
1302 La commande @code{\footnote} permet de générer automatiquement des notes
1303 de bas de page. Elle requiert quatre arguments : la position
1304 @samp{(x . y)} de l'appel de note, le @var{nom-grob} optionnel
1305 spécifiant l'objet de rendu auquel s'applique le commentaire,
1306 l'@var{annotation} qui apparaîtra au bas de la page, et enfin la
1307 @var{musique} à laquelle se rapporte l'annotation.
1310 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1312 \header { tagline = ##f }
1314 \footnote #'(0.5 . -2)
1315 \markup { La première note }
1317 \single\footnote #'(0.5 . 1)
1318 \markup { La troisième note } Flag
1324 L'annotation d'un accord suit la même règle :
1327 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1329 \header { tagline = ##f }
1332 \footnote #'(1 . -1.25) "Voici un do" c
1333 \footnote #'(2 . -0.25) \markup { \italic "Un mi bémol" } es
1334 \footnote #'(2 . 3) \markup { \bold "Ceci est un sol" } g
1340 @warning{Lorsque plusieurs notes de bas de page se rapportent à un même
1341 empilement vertical, les notes apparaîtront dans l'ordre vertical des
1342 appels, autrement dit celui positionné le plus haut en premier, et ainsi
1345 Voici quelques exemples d'objets annotés automatiquement. Vous pouvez
1346 constater l'agencement des annotations correspondantes avec le copyright
1349 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1351 \header { copyright = \markup { "Copyright 1970" } }
1353 a'4-\footnote #'(-3 . 0) \markup { \bold Forte } \f
1354 -\footnote #'(0 . 1.5) \markup { A slur } (
1355 b8)-\footnote #'(0 . -2) \markup { Beam } [ e]
1356 \single\footnote #'(1 . -1)
1357 \markup { \teeny { This is a stem } } Stem
1359 \single\footnote #'(0 . 0.5)
1360 \markup \italic { A cautionary accidental } AccidentalCautionary
1361 \footnote #'(1 . 1) "The note itself"
1362 dis?4-\footnote #'(0.5 . -0.5) \markup \italic { Slow Down }
1368 Une note de bas de page affectant un @code{\markup} de haut niveau
1369 s'introduit par la commande @code{\auto-footnote} :
1371 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1373 \header { tagline = ##f }
1374 \markup { \auto-footnote "A simple tune" \italic "By me" }
1382 @node Notes de bas de page manuelles
1383 @unnumberedsubsubsec Notes de bas de page manuelles
1384 @translationof Manual footnotes
1386 @cindex note de bas de page manuelle
1387 @cindex bas de page, note manuelle
1389 LilyPond permet aussi de créer des notes de bas de page manuelles :
1390 la commande @code{\footnote} prend alors un argument supplémentaire :
1391 la @var{marque}, qui contient l'appel qui s'attache à la note ou à
1392 l'objet référencé. Contrairement aux notes de bas de page automatiques,
1393 l'annotation en bas de page ne sera pas précédée de la @var{marque} ;
1394 l'indicateur visuel est laissé à l'appréciation de l'utilisateur.
1395 LilyPond ne s'attache ici qu'à faire apparaître l'annotation au bas de
1398 La commande @code{\footnote} s'utilise de la même manière que dans le
1399 cas de notes automatiques.
1401 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1403 \header { tagline = ##f }
1407 \markup { \italic "1. The first note" }
1411 \markup { \bold "2" } #'(0.5 . 1)
1412 "2. The second note"
1415 d-\footnote "3" #'(0.5 . -1) "3. Piano" \p
1420 L'annotation d'un accord suit la même règle :
1422 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1424 \header { tagline = ##f }
1427 \footnote "1" #'(1 . -1.25) "1. C" c
1429 \markup { \bold "b" } #'(2 . -0.25) "b. E-flat" es
1430 \footnote "3" #'(2 . 3) \markup { \italic "iii. G" } g
1436 @warning{Lorsque plusieurs notes de bas de page se rapportent à un même
1437 empilement vertical, les notes apparaîtront dans l'ordre vertical des
1438 appels, autrement dit celui positionné le plus haut en premier, et ainsi
1441 Voici quelques exemples d'objets annotés manuellement. Vous pouvez
1442 constater l'agencement des annotations correspondantes avec le copyright
1445 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1447 \header { tagline = ##f }
1450 \markup { \teeny 1 } #'(-3 . 0)
1451 \markup { 1. \bold Forte } \f
1453 \markup { \teeny b } #'(0 . 1.5)
1454 \markup { b. A slur } (
1456 \markup { \teeny 3 } #'(0 . -2)
1457 \markup { 3. Beam } [
1460 \markup { 4 } #'(1 . -1)
1461 \markup { \bold 4. { This is a stem } } Stem
1464 \markup \concat \teeny { "sharp (v)" }
1466 \markup \italic { v. A cautionary accidental } AccidentalCautionary
1468 \markup \concat \teeny { "a" } #'(0.5 . -0.5)
1469 \markup \italic { a. Slow Down } _"rit."
1471 \markup { \teeny \musicglyph #"rests.4" }
1473 \markup { \null } \breathe
1478 L'annotation manuelle d'un @code{\markup} de haut niveau répond à la
1481 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1483 \header { tagline = ##f }
1484 \markup { "A simple tune" \footnote "*" \italic "* By me" }
1492 Manuel d'initiation :
1493 @rlearning{Objets et interfaces}.
1495 Manuel de notation :
1496 @ref{Commentaires textuels},
1497 @ref{Indications textuelles},
1499 @ref{Mise en forme de la page},
1500 @ref{Titres et entêtes}.
1502 Référence des propriétés internes :
1503 @rinternals{FootnoteEvent},
1504 @rinternals{FootnoteItem},
1505 @rinternals{FootnoteSpanner},
1506 @rinternals{Footnote_engraver}.
1509 Un silence multimesures ne peut se voir affecter une note de bas de
1512 Les notes de bas de page ne peuvent que s'empiler l'une au-dessus de
1513 l'autre ; elles ne seront jamais présentées à la queue leu leu.
1514 Les notes de bas de page peuvent générer des chevauchements quand elles
1515 sont trop nombreuses sur une même page.
1517 Dès lors que vous utilisez une commande de note de bas de page manuelle,
1518 le bloc @code{\paper} doit contenir la mention
1519 @w{@code{footnote-auto-number = ##f}}.
1522 @node Référencement des numéros de page
1523 @subsection Référencement des numéros de page
1524 @translationof Reference to page numbers
1526 LilyPond vous permet, à l'aide de la commande @code{\label}, d'insérer
1527 des points de référence dans un ouvrage, aussi bien en dehors qu'au fil
1528 de la musique. Ce point de référence pourra être ensuite repris à
1529 l'intérieur d'un @emph{markup} ; vous pourrez même y ajouter le
1530 numéro de page grâce à la commande de @emph{markup} @code{\page-ref}.
1533 @lilypond[verbatim,papersize=a8landscape]
1534 \header { tagline = ##f }
1540 \pageBreak \mark A \label #'markA
1545 \markup { Le premier mouvement débute à la page \page-ref #'firstScore "0" "?" }
1546 \markup { Le repère A est à la page \page-ref #'markA "0" "?" }
1550 L'instruction @code{\page-ref} prend trois arguments :
1553 le point de référence, sous la forme d'un symbole Scheme, comme par
1554 exemple @code{#'firstScore},
1557 un @qq{emporte-pièce} afin d'estimer la longueur totale du
1561 un texte de remplacement au cas où la référence ne serait pas retrouvée.
1564 La présence de l'emporte-pièce est rendue nécessaire par le fait que les
1565 @emph{markups} sont générés avant que les sauts de page ne soient
1566 positionnés. Bien que le numéro de page en question ne soit pas encore
1567 déterminé, LilyPond doit connaître les dimensions de ce @emph{markup}.
1568 Vous pouvez, lorsque l'ouvrage contiendra plus de dix pages, stipuler un
1569 emporte-pièce sur deux caractères -- soit @code{"00"}.
1579 @node Table des matières
1580 @subsection Table des matières
1581 @translationof Table of contents
1583 La commande @code{\markuplist \table-of-contents} vous permettra de
1584 générer une table des matières. Les éléments qui la composeront sont
1585 créés par la commande @code{\tocItem}, insérée indépendamment ou au sein
1586 d'une expression musicale.
1589 \markuplist \table-of-contents
1592 \tocItem \markup "Premier mouvement"
1596 \tocItem \markup "Passage spécifique du premier mouvement"
1601 \tocItem \markup "Second mouvement"
1609 Les @emph{markups} dévolus à la mise en forme de la table des matières
1610 se définissent dans le bloc @code{\paper}. Il s'agit par défaut de
1611 @code{tocTitleMarkup} pour le titre de la table, et de
1612 @code{tocItemMarkup} pour ses éléments -- composés de leur libellé et
1613 numéro de page. Vous pouvez bien entendu personnaliser ces variables :
1617 %% Translate the toc title into French:
1618 tocTitleMarkup = \markup \huge \column {
1619 \fill-line { \null "Table des matières" \null }
1622 %% use larger font size
1623 tocItemMarkup = \markup \large \fill-line {
1624 \fromproperty #'toc:text \fromproperty #'toc:page
1629 Notez bien la manière de référencer le libellé et le numéro de page dans
1630 la définition de @code{tocItemMarkup}.
1632 N'hésitez pas à définir vous-même d'autres commandes et @emph{markups}
1633 afin de construire une table plus élaborée :
1636 commencez par définir une nouvelle variable de type @code{markup} au
1637 sein du bloc @code{\paper},
1640 puis définissez une fonction musicale chargée d'insérer un élément de la
1641 table à partir de cette variable.
1644 Dans l'exemple qui suit, nous avons créé un nouveau style d'élément dans
1645 le but de mentionner les actes dans la table des matières d'un opéra :
1649 tocActMarkup = \markup \large \column {
1651 \fill-line { \null \italic \fromproperty #'toc:text \null }
1657 #(define-music-function (parser location text) (markup?)
1658 (add-toc-item! 'tocActMarkup text))
1661 @lilypond[line-width=10.0\cm]
1662 \header { tagline = ##f }
1664 tocActMarkup = \markup \large \column {
1666 \fill-line { \null \italic \fromproperty #'toc:text \null }
1672 #(define-music-function (parser location text) (markup?)
1673 (add-toc-item! 'tocActMarkup text))
1676 \markuplist \table-of-contents
1677 \tocAct \markup { Atto Primo }
1678 \tocItem \markup { Coro. Viva il nostro Alcide }
1679 \tocItem \markup { Cesare. Presti omai l'Egizzia terra }
1680 \tocAct \markup { Atto Secondo }
1681 \tocItem \markup { Sinfonia }
1682 \tocItem \markup { Cleopatra. V'adoro, pupille, saette d'Amore }
1687 L'élément et son numéro de page peuvent se rejoindre par une ligne
1690 @lilypond[verbatim,line-width=10.0\cm]
1691 \header { tagline = ##f }
1693 tocItemMarkup = \tocItemWithDotsMarkup
1697 \markuplist \table-of-contents
1698 \tocItem \markup { Allegro }
1699 \tocItem \markup { Largo }
1705 @funindex \table-of-contents
1706 @code{\table-of-contents},
1712 Fichiers d'initialisation :
1713 @file{../ly/toc-init.ly}.
1716 @node Travail sur des fichiers texte
1717 @section Travail sur des fichiers texte
1718 @translationof Working with input files
1721 * Insertion de fichiers LilyPond::
1722 * Différentes éditions à partir d'une même source::
1723 * Caractères spéciaux::
1727 @node Insertion de fichiers LilyPond
1728 @subsection Insertion de fichiers LilyPond
1729 @translationof Including LilyPond files
1732 @cindex inclusion de fichiers
1734 Lorsqu'un projet prend de l'importance en volume, il est judicieux de le
1735 scinder en plusieurs fichiers, auxquels vous ferez référence avec un
1739 \include "autrefichier.ly"
1742 Une ligne @code{\include "autrefichier.ly"} dans un fichier revient à
1743 recopier intégralement le contenu de @file{autrefichier.ly} à l'endroit
1744 même ou est placée l'instruction @code{\include}. Vous pouvez par
1745 exemple écrire un fichier individuel par instrument, puis les regrouper
1746 pour former le fichier @qq{conducteur}. Les différentes variables
1747 définies dans les fichiers séparés seront normalement reprises et
1748 utilisables dans le fichier formant le conducteur. Les sections
1749 balisées dans les fichiers individuels peuvent être réutilisées en
1750 différents endroit de la partition, comme expliqué à la rubrique
1751 @ref{Différentes éditions à partir d'une même source}.
1753 Lorsque le fichier auquel il est fait référence se trouve dans le même
1754 répertoire, donner seulement son nom en argument à la commande
1755 @code{\include} suffit. S'il se trouve ailleurs, vous devrez indiquer
1756 le chemin d'accès, absolu ou relatif, en respectant toutefois la syntaxe
1757 UNIX -- autrement dit, le séparateur de répertoire est une oblique
1758 normale @code{/} et non l'oblique inverse @code{\} de DOS ou Windows.
1759 Par exemple, si le fichier @file{truc.ly} se trouve dans le répertoire
1760 supérieur au répertoire de travail, la ligne devra être
1763 \include "../truc.ly"
1767 ou bien, si les fichiers correspondant aux parties d'orchestre se
1768 trouvent dans le sous-répertoire @file{parties} relativement au
1769 répertoire courant, vous devrez mentionner
1772 \include "parties/VI.ly"
1773 \include "parties/VII.ly"
1777 Les fichiers à inclure peuvent eux-mêmes contenir des instructions
1778 @code{\include}. Ces instructions @code{\include} de second niveau ne
1779 pourront, par défaut, être interprétées qu'une fois intégrées dans le
1780 fichier principal ; leur argument doit donc comporter le chemin
1781 relativement au fichier principal et non par rapport au fichier dans
1782 lequel cette inclusion est mentionnée. Vous pouvez toutefois influer
1783 sur ce comportement à l'aide de l'option @w{@code{-drelative-includes}}
1784 en ligne de commande ou en ajoutant une clause
1785 @code{#(ly:set-option 'relative-includes #t)} en tête du fichier
1786 principal. Une fois @code{relative-include} activé, le chemin à suivre
1787 pour chacune des commandes @code{\include} sera pris relativement au
1788 fichier qui la contient. Cette option est vouée à être activée par
1789 défaut dans une future version de LilyPond.
1791 Vous pouvez inclure des fichiers dont vous spécifierez le chemin d'accès
1792 sur la ligne de commande au moment de lancer la compilation. L'appel à
1793 ces fichiers ne mentionnera alors que leur nom. Par exemple, si vous
1794 voulez compiler avec cette méthode le fichier @file{principal.ly} qui
1795 inclut des fichiers situés dans le sous-répertoire @file{parties},
1796 placez vous dans le répertoire contenant @file{principal.ly}, puis tapez
1799 lilypond --include=parties principal.ly
1802 tout en ayant bien dans @file{principal.ly}
1810 Lorsqu'un fichier est voué à être inclus dans nombre de partitions, vous
1811 pouvez le placer dans le répertoire de LilyPond @file{../ly}.
1812 Attention : ce répertoire varie selon votre installation, comme
1813 indiqué au chapitre @rlearning{Autres sources de documentation}. Ce
1814 fichier sera inclus dès lors que vous fournirez uniquement son nom en
1815 argument à la fonction @code{\include}. C'est par exemple le cas du
1816 fichier de définition particulier @file{gregorian.ly}.
1818 Au moment où vous lancez LilyPond, un certain nombre de fichiers se
1819 retrouvent inclus par défaut ; il suffit d'activer le mode verbeux
1820 en faisant @w{@code{lilypond --verbose}} pour s'en rendre compte. Vous
1821 verrez ainsi défiler, en plus de nombreuses informations, le nom d'un
1822 certain nombre de fichiers et de chemins d'accès. Les fichiers les plus
1823 important sont mentionnés au chapitre
1824 @rlearning{Autres sources de documentation}. Si vous venez à les
1825 modifier, rappelez-vous qu'ils seront écrasés à l'installation d'une
1826 nouvelle version de LilyPond.
1828 Vous trouverez quelques exemples simples d'utilisation de la commande
1829 @code{\include} au chapitre @rlearning{Conducteurs et parties}.
1832 Manuel d'initiation :
1833 @rlearning{Autres sources de documentation},
1834 @rlearning{Conducteurs et parties}.
1837 Lorsque vous incluez un fichier qui porte le même nom que l'un des
1838 fichiers d'initialisation de LilyPond, le fichier de la distribution de
1839 LilyPond aura préséance.
1842 @node Différentes éditions à partir d'une même source
1843 @subsection Différentes éditions à partir d'une même source
1844 @translationof Different editions from one source
1846 Plusieurs méthodes permettent de générer différentes versions d'une
1847 partition à partir d'une même source. Les variables -- ou
1848 identificateurs -- sont sûrement le moyen le plus simple de combiner de
1849 différente manière des passages relativement longs, alors que les
1850 balises permettront de sélectionner de courts fragments selon leur
1853 Quelle que soit la méthode utilisée, séparer la notation de la structure
1854 de la partition vous donnera plus de liberté dans l'agencement de
1855 l'ouvrage final, puisque vous ne reviendrez pas sur la musique qui le
1859 * Utilisation de variables::
1860 * Utilisation de balises::
1861 * Globalisation des réglages::
1865 @node Utilisation de variables
1866 @unnumberedsubsubsec Utilisation de variables
1867 @translationof Using variables
1869 @cindex variables, utilisation de
1871 Un fragment musical identifié par une variable est réutilisable à divers
1872 endroits de la partition, comme nous l'avons vu à la rubrique
1873 @rlearning{Organisation du code source avec des variables}. Par
1874 exemple, une partition pour chœur @notation{a cappella} comporte souvent
1875 une réduction pour piano reprenant toutes les voix ; il s'agit de
1876 la même musique, et vous ne devrez donc la saisir qu'une seule fois.
1877 D'autre part, la musique issue de deux variables peut se combiner sur
1878 une seule portée, comme nous l'avons vu à la rubrique
1879 @ref{Regroupement automatique de parties}. Prenons l'exemple suivant :
1881 @lilypond[verbatim,quote]
1882 sopranoMusic = \relative c'' { a4 b c b8( a) }
1883 altoMusic = \relative g' { e4 e e f }
1884 tenorMusic = \relative c' { c4 b e d8( c) }
1885 bassMusic = \relative c' { a4 gis a d, }
1886 allLyrics = \lyricmode {King of glo -- ry }
1888 \new Staff = "Soprano" \sopranoMusic
1889 \new Lyrics \allLyrics
1890 \new Staff = "Alto" \altoMusic
1891 \new Lyrics \allLyrics
1892 \new Staff = "Tenor" {
1896 \new Lyrics \allLyrics
1897 \new Staff = "Bass" {
1901 \new Lyrics \allLyrics
1904 \set Staff.printPartCombineTexts = ##f
1910 \set Staff.printPartCombineTexts = ##f
1920 Générer une partition chorale ou la réduction pour piano ne requiert que
1921 de modifier la structure des éléments, sans aucunement toucher à la
1924 Dans le cas d'une partition relativement longue, vous pouvez isoler la
1925 définition des différentes variables dans des fichiers séparés que vous
1926 rappellerez ensuite, comme indiqué à la rubrique
1927 @ref{Insertion de fichiers LilyPond}.
1930 @node Utilisation de balises
1931 @unnumberedsubsubsec Utilisation de balises
1932 @translationof Using tags
1935 @funindex \keepWithTag
1936 @funindex \removeWithTag
1937 @funindex \pushToTag
1938 @funindex \appendToTag
1942 La commande @code{\tag #'@var{partieA}} affecte à une expression
1943 musicale le nom @var{partieA}. Les expressions ainsi balisées pourront
1944 être filtrées par la suite, à l'aide de @code{\keepWithTag #'@var{nom}}
1945 ou @code{\removeWithTag #'@var{nom}}. Ces filtres fonctionnent de la
1948 @multitable @columnfractions .5 .5
1953 Musique balisée précédée de @code{\keepWithTag #'@var{nom}}
1954 @tab Musique non balisée et musique balisée par @var{nom} seront
1955 incluses ; la musique balisée autrement est exclue.
1958 Musique balisée précédée de @code{\removeWithTag #'@var{nom}}
1959 @tab Musique non balisée et fragments appelés autrement que @var{nom}
1960 seront inclus ; la musique balisée par @var{nom} est exclue.
1963 Musique balisée non précédée de @code{\keepWithTag} ou
1964 @code{\removeWithTag}
1965 @tab Musique balisée et non balisée seront incluses.
1969 Les arguments des commandes @code{\tag}, @code{\keepWithTag} et
1970 @code{\removeWithTag} doivent être un symbole (tel que
1971 @code{#'conducteur} ou @code{#'partie}), suivi d'une expression
1974 Dans l'exemple qui suit, nous obtenons deux versions du même extrait,
1975 l'une pour le conducteur, l'autre pour l'instrumentiste qui, elle,
1976 comportera les ornements développés.
1978 @lilypond[verbatim,quote]
1979 music = \relative g' {
1981 \tag #'trills { d8.\trill }
1982 \tag #'expand { \repeat unfold 3 { e32 d } }
1987 \keepWithTag #'trills \music
1990 \keepWithTag #'expand \music
1995 Il est parfois plus aisé d'exclure des fragments :
1997 @lilypond[verbatim,quote]
1998 music = \relative g' {
2000 \tag #'trills { d8.\trill }
2001 \tag #'expand {\repeat unfold 3 { e32 d } }
2006 \removeWithTag #'expand
2010 \removeWithTag #'trills
2015 Ce principe de filtrage peut s'appliquer aux articulations, textes etc.
2016 Il suffit de positionner
2019 -\tag #@var{ma-balise}
2023 avant l'articulation ou le texte, comme ici :
2027 c1-\tag #'gaffe ^"Attention !"
2031 Ceci définira une note avec une indication conditionnelle de doigté ou
2034 Vous pouvez baliser différemment la même expression musicale en
2035 saisissant plusieurs @code{\tag} :
2037 @lilypond[quote,verbatim]
2038 music = \relative c'' {
2039 \tag #'a \tag #'both { a4 a a a }
2040 \tag #'b \tag #'both { b4 b b b }
2043 \keepWithTag #'a \music
2044 \keepWithTag #'b \music
2045 \keepWithTag #'both \music
2049 L'application concomitante de plusieurs filtres @code{\removeWithTag} à
2050 la même expression musicale permet d'exclure plusieurs balisages :
2052 @lilypond[verbatim,quote]
2053 music = \relative c'' {
2054 \tag #'A { a4 a a a }
2055 \tag #'B { b4 b b b }
2056 \tag #'C { c4 c c c }
2057 \tag #'D { d4 d d d }
2066 L'application de plus d'un filtre @code{\keepWithTag} à la même
2067 expression musicale aboutit à l'exclusion de @b{tous} les balisages.
2068 En effet, si le premier filtre exclut tous les autres balisages,
2069 l'application du second exclura les effets du premier.
2071 Il peut arriver que vous ayez besoin de raccorder quelque chose en un
2072 point particulier d'une expression musicale. Les commandes
2073 @code{\pushToTag} et @code{\appendToTag} permettent d'insérer du
2074 matériau, qu'il soit antérieur ou postérieur, à des @code{éléments}
2075 d'une construction musicale existante. La musique séquentielle ou
2076 simultanée comporte assurément des @code{éléments} :
2078 @lilypond[verbatim,quote]
2079 test = { \tag #'here { \tag #'here <<c''>> } }
2082 \pushToTag #'here c'
2083 \pushToTag #'here e'
2084 \pushToTag #'here g' \test
2085 \appendToTag #'here c'
2086 \appendToTag #'here e'
2087 \appendToTag #'here g' \test
2091 Ces deux instructions sont affectées d'une balise, le matériau à
2092 raccorder à chaque instance de la balise, et l'expression balisée.
2093 Ces instructions prennent soin de recopier tout ce qui doit être
2094 modifié, de telle sorte que l'expression @code{\test} originale conserve
2098 Manuel d'initiation :
2099 @rlearning{Organisation du code source avec des variables}.
2101 Manuel de notation :
2102 @ref{Regroupement automatique de parties},
2103 @ref{Insertion de fichiers LilyPond}.
2107 @c This warning is more general than this placement implies.
2108 @c Rests are not merged whether or not they come from tagged sections.
2109 @c Should be deleted? -td
2112 Lorsqu'elles comportent des silences, ceux-ci ne seront pas fusionnés
2113 si vous imprimez une partition avec les deux sections balisées.
2118 @node Globalisation des réglages
2119 @unnumberedsubsubsec Globalisation des réglages
2120 @translationof Using global settings
2122 @cindex include-settings
2124 Vous pouvez regrouper dans un fichier indépendant vos réglages
2125 personnels que vous inclurez au besoin :
2128 lilypond -dinclude-settings=MES_REGLAGES.ly MA_PARTITION.ly
2131 Vous pouvez ainsi stocker dans un fichier séparé vos réglages en matière
2132 de format de papier, de fontes utilisées ou vos définitions
2133 particulières. Selon le fichier de réglages que vous mentionnerez, vous
2134 obtiendrez facilement différentes éditions à partir d'une même source
2135 quelle qu'elle soit.
2137 Cette technique peut s'utiliser en combinaison avec des feuilles de
2138 styles, comme indiqué au chapitre @rlearning{Feuilles de style}.
2141 Manuel d'initiation :
2142 @rlearning{Organisation du code source avec des variables},
2143 @rlearning{Feuilles de style}.
2145 Manuel de notation :
2146 @ref{Insertion de fichiers LilyPond}.
2149 @node Caractères spéciaux
2150 @subsection Caractères spéciaux
2151 @translationof Special characters
2153 @cindex caractères spéciaux
2154 @cindex non-ASCII, caractères
2159 * Équivalents ASCII::
2163 @node Codage du texte
2164 @unnumberedsubsubsec Codage du texte
2165 @translationof Text encoding
2169 LilyPond utilise le jeu de caractères défini par le consortium Unicode
2170 et la norme ISO/CEI 10646. Chaque caractère est identifié par un
2171 nom unique et associé à un point de code, ce qui permet dans l'absolu de
2172 couvrir tous les langages. Unicode permet de coder tous les caractères
2173 utilisés par toutes les langues écrites du monde. LilyPond utilise le
2174 codage UTF-8 (UTF pour @emph{Unicode Transformation Format}) qui permet
2175 de représenter les caractères latins sur un octet et les autres sur une
2176 longueur allant jusqu'à quatre octets.
2178 L'apparence réelle des caractères est déterminée par les glyphes ou
2179 graphèmes tels que définis dans les différentes polices disponibles.
2180 Une police, ou une fonte, définit la mise en correspondance d'un
2181 sous-ensemble de points de code unicode en glyphes. LilyPond recourt à
2182 la bibliothèque Pango pour assurer le rendu des textes multilingues.
2184 LilyPond n'effectue aucune conversion d'encodage que ce soit. Ceci
2185 implique donc que tout texte -- un titre, des paroles ou même une
2186 instruction musicale -- comportant des caractères non ASCII soit
2187 codé en UTF-8. Le plus sûr moyen de saisir du texte de la sorte
2188 consiste à utiliser un éditeur supportant l'unicode et à enregistrer vos
2189 fichier en UTF-8. C'est le cas pour la plupart des éditeurs actuels,
2190 que ce soit vim, Emacs, jEdit et GEdit. Tous les systèmes Windows
2191 postérieurs à NT utilisent Unicode en natif ; même Notepad est
2192 capable d'éditer et sauvegarder un fichier en UTF-8 -- sans parler de
2193 l'excellente alternative qu'est BabelPad.
2195 La compilation d'un fichier LilyPond comportant des caractères non ASCII
2196 qui n'aurait pas été enregistré dans l'encodage UTF-8 vous renverra
2200 FT_Get_Glyph_Name () erreur : invalid argument
2203 Voici un exemple utilisant du texte en cyrillique, en hébreux et en
2207 %c No verbatim here as the code does not display correctly in PDF
2209 bulgarian = \lyricmode {
2210 Жълтата дюля беше щастлива, че пухът, който цъфна, замръзна като гьон.
2214 hebrew = \lyricmode {
2215 זה כיף סתם לשמוע איך תנצח קרפד עץ טוב בגן.
2219 portuguese = \lyricmode {
2220 à vo -- cê uma can -- ção legal
2226 \addlyrics { \bulgarian }
2227 \addlyrics { \hebrew }
2228 \addlyrics { \portuguese }
2233 @unnumberedsubsubsec Unicode
2234 @translationof Unicode
2238 Lorsque vous avez besoin d'un caractère dont vous connaissez le point de
2239 code mais que votre éditeur ne permet pas de saisir directement, vous
2240 pouvez utiliser les instructions @code{\char ##xhhhh} ou
2241 @code{\char #dddd} au sein d'un bloc @code{\markup} -- @code{hhhh}
2242 et @code{dddd} correspondant respectivement à la valeur hexadécimale ou
2243 décimale. Même s'il est inutile de saisir les zéros superflus, il est
2244 de bon ton de stipuler les quatre caractères formant la représentation
2245 hexadécimale. Évitez cependant l'encodage UTF-8 d'un point de code
2246 après un @code{\char} ; les encodages UTF-8 comprennent un bit
2247 supplémentaire indiquant le nombre d'octets. Une table de
2248 correspondance entre les codes Unicode et le nom des caractères ainsi
2249 que leur code hexadécimal est disponible sur le site du consortium
2250 Unicode, @uref{http://www.unicode.org/}.
2252 Par exemple, @code{\char ##x03BE} et @code{\char #958} correspondent
2253 tous deux au caractère unicode U+03BE, dénommé @qq{Greek Small Letter
2256 Quel que soit le point de code spécifié de cette manière, il ne vous
2257 sera alors pas nécessaire d'enregistrer votre fichier en UTF-8. Vous
2258 devrez toutefois disposer d'une fonte contenant ce caractère qui soit
2259 accessible à LilyPond.
2261 L'exemple suivant illustre la manière d'insérer un caractère sous sa
2262 forme hexadécimale, à la fois dans un repère, dans une articulation,
2263 dans des paroles et dans du texte indépendant.
2265 @lilypond[quote,verbatim]
2268 c1 \mark \markup { \char ##x03EE }
2269 c1_\markup { \tiny { \char ##x03B1 " to " \char ##x03C9 } }
2271 \addlyrics { O \markup { \concat { Ph \char ##x0153 be! } } }
2273 \markup { "Copyright 2008--2012" \char ##x00A9 }
2278 Le signe @emph{copyright} dans le champ de titrage consacré s'inscrit de
2279 la manière suivante :
2283 copyright = \markup @{ \char ##x00A9 "2008" @}
2288 @node Équivalents ASCII
2289 @unnumberedsubsubsec Équivalents ASCII
2290 @translationof ASCII aliases
2292 Dès lors que vous aurez inclus la liste de leur équivalent ASCII,
2293 LilyPond reconnaîtra un certain nombre de caractères spéciaux :
2295 @lilypond[quote,verbatim]
2297 #(include-special-characters)
2300 \markup "&flqq; – &OE;uvre incomplète… &frqq;"
2303 \new Staff { \repeat unfold 9 a'4 }
2305 This is al -- so wor -- kin'~in ly -- rics: –_&OE;…
2310 "The replacement can be disabled:"
2311 "– &OE; …"
2312 \override #'(replacement-alist . ()) "– &OE; …"
2316 L'extension de cette liste est possible aussi bien de manière globale :
2318 @lilypond[quote,verbatim]
2320 #(add-text-replacements!
2321 '(("100" . "hundred")
2322 ("dpi" . "dots per inch")))
2324 \markup "A 100 dpi."
2327 qu'en un point particulier de votre source :
2329 @lilypond[quote,verbatim]
2330 \markup \replace #'(("100" . "hundred")
2331 ("dpi" . "dots per inch")) "A 100 dpi."
2335 Manuel de notation :
2336 @ref{Liste des caractères spéciaux}.
2338 Fichiers d'initialisation :
2339 @file{ly/text-replacements.ly}.
2342 @node Contrôle des sorties
2343 @section Contrôle des sorties
2344 @translationof Controlling output
2347 * Extraction de fragments musicaux::
2348 * Ignorer des passages de la partition::
2349 * Formats de sortie alternatifs::
2350 * Changement des fontes musicales::
2354 @node Extraction de fragments musicaux
2355 @subsection Extraction de fragments musicaux
2356 @translationof Extracting fragments of music
2358 LilyPond permet d'extraire des fragments d'une partition à l'instar du
2359 choriste amateur qui alimente son album avec des coupures de journaux.
2361 Vous devrez pour cela définir les mesures à découper. La définition
2362 suivante, incluse dans votre fichier source,
2369 (make-rhythmic-location 5 1 2)
2370 (make-rhythmic-location 7 3 4)))
2375 vous permettra d'extraire un fragment compris entre le milieu de la
2376 cinquième mesure et quelque part dans la septième. Le triplet
2377 @code{5 1 2} signifie : après la durée d'une blanche dans la mesure 5 ;
2378 le @code{7 3 4} signifie quant à lui que l'on s'arrête à la mesure 7,
2379 après la durée de trois noires.
2381 Rien ne vous empêche d'extraire plusieurs fragments, dès lors que vous
2382 définissez dans la liste d'autres paires d'emplacements rythmiques.
2384 Cette fonctionnalité n'est toutefois effective que lorsque vous lancez
2385 LilyPond avec l'option @w{@code{-dclip-systems}}. Les @qq{coupures}
2386 seront générées sous la forme de fichiers EPS, convertis en PDF ou PNG
2387 selon le format que vous aurez stipulé.
2389 Pour de plus amples informations quant au format des résultats,
2390 consultez le chapitre @rprogram{Lancement de lilypond}.
2393 @node Ignorer des passages de la partition
2394 @subsection Ignorer des passages de la partition
2395 @translationof Skipping corrected music
2397 @funindex skipTypesetting
2398 @funindex showFirstLength
2399 @funindex showLastLength
2401 Dans un travail de transcription ou de recopie de la musique, ce qui
2402 vous intéresse plus particulièrement se situe à la fin, là même où vous
2403 en êtes dans la notation. Dans le but de gagner du temps dans le
2404 processus de correction, vous pouvez @qq{escamoter} le reste et ne
2405 générer que les dernières mesures en insérant
2408 showLastLength = R1*5
2413 dans votre fichier source. Ceci aura pour effet de ne générer que les
2414 cinq dernières mesures -- si tant est que le morceau soit à 4/4 -- de
2415 tous les @code{\score} de votre fichier. Dans le cas d'un œuvre
2416 conséquente, cette pratique s'avère fort utile puisqu'elle évite de tout
2417 générer. Vous pourriez aussi être amené à retravailler le début d'une
2418 œuvre, pour y ajouter une partie par exemple, auquel cas c'est la
2419 propriété @code{showFirstLength} que vous utiliserez.
2421 Vous pouvez contrôler très finement les parties à escamoter, grâce au
2422 commutateur @code{Score.skipTypesetting} : lorsqu'il est activé,
2423 aucune gravure n'est réalisée.
2425 Ce commutateur agit aussi sur la sortie MIDI. Notez bien que tous les
2426 événements seront escamotés, y compris les changements de tempo ou
2427 d'instrument -- vous voilà prévenu !
2429 @lilypond[quote,relative=2,ragged-right,verbatim]
2431 \set Score.skipTypesetting = ##t
2433 \set Score.skipTypesetting = ##f
2437 Dans le cadre de musique polyphonique, @code{Score.skipTypesetting}
2438 s'applique à toutes les voix et portées. Vous gagnerez donc encore plus
2442 @node Formats de sortie alternatifs
2443 @subsection Formats de sortie alternatifs
2444 @translationof Alternative output formats
2446 @cindex scalable vector graphics
2447 @cindex SVG, format de sortie
2448 @cindex encapsulated postscript
2449 @cindex EPS, format de sortie
2451 En matière de partition imprimable, LilyPond génère par défaut des
2452 documents au format PostScript (PS) et Portable Document Format (PDF).
2453 Vous pouvez aussi obtenir des documents au format Scalable Vector
2454 Graphics (SVG), Encapsulated PostScript (EPS) ou Portable Network
2455 Graphics (PNG) dès lors que vous aurez lancé LilyPond en ligne de
2456 commande avec l'option @i{ad hoc} -- voir
2457 @rprogram{Utilisation en ligne de commande} à ce sujet.
2460 @node Changement des fontes musicales
2461 @subsection Changement des fontes musicales
2462 @translationof Replacing the notation font
2464 Gonville est une alternative à la fonte Feta que LilyPond utilise par
2465 défaut. Vous pouvez la télécharger à partir de
2467 @uref{http://www.chiark.greenend.org.uk/~sgtatham/gonville/ ,http://www.chiark.greenend.org.uk/~sgtatham/gonville/}
2470 Voici quelques mesures utilisant la police Gonville :
2472 @c NOTE: these images are a bit big, but that's important
2473 @c for the font comparison. -gp
2474 @sourceimage{Gonville_after,,,}
2476 Et ces même mesures avec la police de LilyPond, Feta :
2478 @sourceimage{Gonville_before,,,}
2481 @subsubheading Instructions d'installation pour MacOS
2482 @translationof Installation Instructions for MacOS
2484 Téléchargez puis décompressez l'archive zip. Recopiez le répertoire
2485 @code{lilyfonts} dans @file{@var{SHARE_DIR}/lilypond/current} -- voir
2486 @rlearning{Autres sources de documentation} à ce sujet. Renommez le
2487 répertoire @code{fonts} qui s'y trouve en @code{fonts_orig}, puis le
2488 répertoire @code{lilyfonts} en @code{fonts}. Il vous suffira, pour
2489 retrouver la fonte Feta, de renommer @code{fonts_orig} en @code{fonts}.
2492 Manuel d'initiation :
2493 @rlearning{Autres sources de documentation}.
2496 Gonville ne permet pas de générer de la notation ancienne, et certains
2497 glyphes ajoutés depuis lors aux jeux de caractères en soient absent.
2498 Consultez le site de l'auteur pour de plus amples informations ainsi
2499 qu'à propos des conditions d'utilisation.
2503 @section Sortie MIDI
2504 @translationof MIDI output
2509 MIDI (Musical Instrument Digital Interface) constitue un standard en
2510 matière de connexion et de contrôle des instruments électroniques. Un
2511 fichier MIDI contient une série de notes réparties dans différentes
2512 pistes. Il ne s'agit en rien d'un fichier sonore ; il vous faudra
2513 un logiciel capable de traduire ces séries de notes en sons réels.
2515 Vous pouvez convertir vos partition en fichier MIDI de manière à
2516 entendre ce que vous avez saisi. Ceci vous permet de contrôler aisément
2517 ce que vous avez saisi : octaves et altérations erronées heurteront
2518 votre oreille avertie grâce au MIDI.
2520 Le fichier MIDI généré par LilyPond est relativement brut. Vous pouvez
2521 cependant obtenir un meilleur rendu avec @ref{Le script Articulate}.
2523 Dans une sortie MIDI, LilyPond alloue un canal à chaque portée, tout en
2524 réservant le canal 10 aux percussions. Dans la mesure ou un
2525 périphérique MIDI ne comprend que 16 canaux, un fichier MIDI qui
2526 comportera plus de quinze portées verra le même canal réutilisé.
2529 * Création de fichiers MIDI::
2531 * Contenu de la sortie MIDI::
2532 * Répétitions et MIDI::
2533 * Gestion des nuances en MIDI::
2534 * MIDI et percussions::
2535 * Le script Articulate::
2539 @node Création de fichiers MIDI
2540 @subsection Création de fichiers MIDI
2541 @translationof Creating MIDI files
2543 LilyPond générera un fichier MIDI dès que vous ajouterez un bloc
2544 @code{\midi} à la structure de votre partition, comme ici :
2553 Lorsque le bloc @code{\score} contient un bloc @code{\midi} mais pas de
2554 bloc @code{\layout}, LilyPond ne produira qu'une sortie MIDI. Si donc
2555 vous avez besoin aussi d'un support visuel, vous devrez aussi mentionner
2556 un bloc @code{\layout}.
2566 Hauteurs, durées, liaisons de prolongation, nuances et changements de
2567 tempo seront interprétés et traduits en événements MIDI. Les
2568 indications de nuances, crescendos et decrescendos sont traduits en
2569 niveau de volume ; les indications sous la forme d'une fraction
2570 déterminée du volume disponible, et crescendos et decrescendos sous la
2571 forme d'une progression linéaire entre les deux extrêmes. Le rendu des
2572 indications de nuance peut être désactivé pour le MIDI -- voir
2575 Le tempo initial ainsi que ses changements sont normalement indiqués au
2576 fil de la notation à l'aide de la commande @code{\tempo} ; ils seront
2577 retranscrits dans le fichier MIDI. La commande @code{\tempo} donne lieu
2578 à l'impression d'une indication métronomique que vous pouvez toutefois
2579 rendre invisible, comme indiqué à la rubrique
2580 @ref{Indication métronomique}. Une autre manière de spécifier le tempo
2581 initial pour un fichier MIDI est indiquée plus avant -- voir
2584 En raison de certaines limitations de Windows, les fichiers MIDI doivent
2585 y porter l'extension @code{.mid}. D'autres systèmes utilisent
2586 l'extension @code{.midi}. Si besoin est, placez la ligne suivante au
2587 début de votre fichier source, avant l'ouverture de tout bloc
2588 @code{\book}, @code{\bookpart} ou @code{\score} :
2591 #(ly:set-option 'midi-extension "midi")
2594 Cette ligne déterminera @code{.midi} comme extension par défaut pour les
2597 Vous pouvez aussi le faire en ligne de commande :
2600 lilypond … -dmidi-extension=midi fichierLily.ly
2604 @unnumberedsubsubsec Noms d'instrument
2605 @translationof Instrument names
2607 @cindex instrument, nom d'
2608 @funindex Staff.midiInstrument
2610 L'instrument MIDI affecté à un canal particulier est déterminé par la
2611 propriété @code{Staff.midiInstrument}. Vous pouvez choisir l'un des
2612 instruments répertoriés à l'annexe @ref{Instruments MIDI}.
2616 \set Staff.midiInstrument = #"glockenspiel"
2622 \new Staff \with @{midiInstrument = #"cello"@} @{
2627 Lorsque l'instrument choisi ne correspond pas exactement à l'une des
2628 dénominations consacrées, LilyPond le replacera par un piano de concert
2629 (@code{"acoustic grand"}).
2632 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
2633 {changing-midi-output-to-one-channel-per-voice.ly}
2636 @c In 2.11 the following no longer seems to be a problem -td
2638 Un (de)crescendo non terminé ne sera pas correctement rendu en MIDI --
2639 il y a nécessairement du silence. Il vous faut donc lui donner une fin
2640 explicite. Par exemple,
2647 ne fonctionnera pas correctement, contrairement à
2650 @{ a4\< b c d\!\f @}
2654 Un changement de volume ne peut intervenir que sur le démarrage d'une
2655 note. C'est la raison pour laquelle la succession d'un crescendo et
2656 d'un diminuendo ne peut se produire sur une même note.
2658 Certains lecteurs MIDI ne rendent pas correctement les changements de
2659 tempo. MS Windows Media Player et
2660 @uref{http://@/timidity@/.sourceforge@/.net/,timidity} le font sans
2665 @subsection Le bloc MIDI
2666 @translationof MIDI block
2668 Dès lors que vous désirez obtenir une sortie MIDI, vous devrez inscrire
2669 un bloc @code{\midi} au sein du bloc @code{\score}. Son fonctionnement
2670 est comparable à ce lui du bloc @code{\layout}, voire plus simple. Si
2671 le bloc @code{\midi} est la plupart du temps laissé vide, il peut
2672 contenir des aménagements pour certains contextes, la définition de
2673 contextes particuliers ou du code permettant de déterminer la valeur de
2674 certaines propriétés. L'exemple suivant détermine le tempo initial du
2675 fichier MIDI tout en se passant de son indication sur la partition
2687 Ici, le tempo est fixé à 72 noires à la minute. Spécifier un tempo de
2688 la sorte ne permet pas de donner une valeur pour une note pointée. Vous
2689 devrez, en pareil cas, subdiviser la note pointée en durée plus courte.
2690 Par exemple, indiquer 90 à la noire pointée est équivalent à spécifier
2691 270 croches à la minute :
2694 tempoWholesPerMinute = #(ly:make-moment 270 8)
2697 @cindex MIDI et définition de contexte
2698 @cindex contexte, définition en MIDI
2700 La syntaxe permettant de définir un contexte pour le @code{\midi} est en
2701 tout point identique à celle que vous utilisez dans le bloc
2702 @code{\layout}, à ceci près que le @qq{graveur} est remplacé par un
2703 @qq{interprète}. Les différents contextes disponibles en matière de
2704 MIDI sont répertoriés dans le fichier d'initialisation
2705 @file{../ly/performer-init.ly} -- pour plus de détail, voir
2706 @rlearning{Autres sources de documentation}.
2707 Si vous voulez vous passer des nuances dans votre fichier MIDI, il vous
2708 suffit d'insérer les lignes suivantes dans votre bloc
2716 \remove "Dynamic_performer"
2721 LilyPond ne générera de sortie MIDI que si vous incluez un bloc
2722 @code{\midi} dans la structure de la partition, initialisée par la
2723 commande @code{\score}.
2727 @{ @dots{}notes@dots{} @}
2733 @node Contenu de la sortie MIDI
2734 @subsection Contenu de la sortie MIDI
2735 @translationof What goes into the MIDI output?
2737 @c TODO Check grace notes - timing is suspect?
2740 @unnumberedsubsubsec Éléments pris en compte dans le MIDI
2741 @translationof Supported in MIDI
2743 @cindex hauteurs en MIDI
2744 @cindex MIDI, hauteurs
2745 @cindex quart de ton en MIDI
2746 @cindex MIDI, quart de ton
2747 @cindex microtonalité en MIDI
2748 @cindex MIDI, microtonalité
2749 @cindex accords nommés en MIDI
2750 @cindex MIDI, accords nommés
2751 @cindex Rythme en MIDI
2752 @cindex MIDI, Rythme
2753 @cindex articulations et MIDI
2754 @cindex MIDI et articulations
2755 @cindex trilles et MIDI
2756 @cindex MIDI et trilles
2759 Un fichier MIDI généré par LilyPond comprendra les éléments de notation
2767 les microtonalités -- voir @ref{Altérations}. Leur rendu nécessite
2768 cependant un lecteur qui prenne en charge la modulation ;
2771 les accords nommés ;
2774 le rythme en tant que durée de note, y compris les nolets ;
2777 les trémolos, exceptés ceux utilisant la syntaxe
2778 @qq{@code{:}[@var{nombre}]} ;
2781 les liaisons de prolongation ;
2784 les indications de nuance ;
2787 les crescendos et decrescendos s'étalant sur plusieurs notes ;
2790 les changements de tempo indiqués par un @code{\tempo} ;
2796 Si vous utilisez @ref{Le script Articulate}, d'autres éléments seront
2800 @item articulations (lié, staccato, etc.),
2801 @item trilles et groupettos,
2802 @item rallentando et accelerando.
2806 @unnumberedsubsubsec Éléments non pris en compte dans le MIDI
2807 @translationof Unsupported in MIDI
2809 @c TODO index as above
2811 LilyPond ne peut générer d'événement MIDI pour les éléments
2812 suivant, sauf à utiliser @ref{Le script Articulate} :
2816 le rythme indiqué sous forme d'annotation (par ex. @emph{swing}) ;
2819 les changements de tempo indiqués sous forme d'annotation (sans
2823 les staccatos et autres articulations ou ornementations ;
2826 les liaisons d'articulation et de phrasé ;
2829 les crescendos ou decrescendos sur une seule note ;
2832 les trémolos indiqués par la syntaxe @qq{@code{:}[@var{nombre}]} ;
2838 les accords en microtonalité.
2842 @node Répétitions et MIDI
2843 @subsection Répétitions et MIDI
2844 @translationof Repeats in MIDI
2846 @cindex reprises développées
2847 @cindex MIDI et reprises
2848 @funindex \unfoldRepeats
2850 Au prix de quelques réglages, les reprises de toutes sortes peuvent être
2851 rendues dans le fichier MIDI. Il suffit pour cela de recourir à la
2852 fonction @code{\unfoldRepeats}, qui développe toutes les reprises. En
2853 d'autre termes, @code{\unfoldRepeats} transforme toutes les reprises
2854 en reprises de type @code{unfold}.
2857 @lilypond[quote,verbatim]
2859 \repeat tremolo 8 {c'32 e' }
2860 \repeat percent 2 { c''8 d'' }
2861 \repeat volta 2 {c'4 d' e' f'}
2870 Dans une partition comportant plusieurs voix, le développement des
2871 reprises ne sera effectif en MIDI qu'à la condition que ces reprises
2872 soient mentionnée correctement dans @strong{toutes} les voix.
2874 Lorsque l'on veut utiliser @code{\unfoldRepeats} seulement pour le rendu
2875 MIDI, il faut établir deux blocs @code{\score} : un pour le MIDI,
2876 avec des reprises explicites, et l'autre pour la partition, avec des
2877 reprises notées sous forme de barres de reprise, de trémolo ou de
2878 symboles de pourcentage. Par exemple
2886 \unfoldRepeats @var{..musique..}
2892 @node Gestion des nuances en MIDI
2893 @subsection Gestion des nuances en MIDI
2894 @translationof Controlling MIDI dynamics
2896 Les nuances MIDI sont générées par le @code{Dynamic_performer}, affecté
2897 par défaut au contexte @code{Voice}. Vous pouvez contrôler à la fois le
2898 volume général, celui des indications de nuance ainsi que celui des
2899 différents instruments.
2902 @unnumberedsubsubsec Indications de nuance
2903 @translationof Dynamic marks
2905 Les indications de nuances sont transcrites en fraction du volume MIDI.
2906 Nous allons, par défaut, de 0,25 pour un @notation{ppppp} à 0,95 pour un
2907 @notation{fffff}. Les correspondances entre nuance et fraction de
2908 volume sont répertoriées dans le fichier @file{../scm/midi.scm} --
2909 consultez la rubrique @rlearning{Autres sources de documentation} si
2910 vous ne savez comment le localiser. Vous pouvez modifier ou étendre ce
2911 jeu grâce à une fonction qui prendra en argument une indication de
2912 nuance et renverra la fraction désirée, puis en affectant cette fonction
2913 à @code{Score.dynamicAbsoluteVolumeFunction}.
2915 Prenons un exemple. Votre partition comporte un @notation{rinforzando}
2916 que vous avez indiqué par @code{\rfz}. Cette indication de nuance
2917 n'étant pas répertoriée dans le jeu par défaut, elle ne produira aucun
2918 effet en MIDI. Il en sera d'ailleurs de même pour toute indication
2919 créée de toute pièce à l'aide de l'instruction
2920 @w{@code{make-dynamic-script}}. Voici comment procéder pour ajuster le
2921 volume MIDI de ce @notation{rinforzando} que le compositeur a indiqué.
2922 La fonction Scheme définit une fraction de 0,9 en cas de @notation{rfz},
2923 et demande d'utiliser la fonction par défaut dans les autre cas.
2925 @lilypond[verbatim,quote]
2926 #(define (myDynamics dynamic)
2927 (if (equal? dynamic "rfz")
2929 (default-dynamic-absolute-volume dynamic)))
2933 \set Staff.midiInstrument = #"cello"
2934 \set Score.dynamicAbsoluteVolumeFunction = #myDynamics
2946 Si vous étiez amené à devoir modifier l'intégralité du jeu des
2947 correspondances, nous vous conseillons d'utiliser la procédure
2948 @command{default-dynamic-absolute-volume} contenue dans le fichier
2949 @file{../scm/midi.scm} ainsi que la table d'association comme base.
2950 Le dernier exemple de cette partie illustre la manière de procéder.
2953 @unnumberedsubsubsec Amplitude du volume en MIDI
2954 @translationof Overall MIDI volume
2956 Les valeurs extrêmes du volume MIDI des nuances se contrôlent à l'aide
2957 des propriétés @code{midiMinimumVolume} et @code{midiMaximumVolume} qui
2958 agissent au niveau @code{Score}. Ces propriétés sont effectives dès
2959 lors qu'une nuance est indiquée ; une nuance de départ est donc
2960 requise pour que le volume soit ajusté dès le début de la partition.
2961 Vous pouvez alors modifier la fraction correspondant à chaque nuance à
2962 l'aide de la formule
2965 midiMinimumVolume + (midiMaximumVolume - midiMinimumVolume) * fraction
2968 Voici comment ajuster les nuances tout en limitant l'amplitude du volume
2971 @lilypond[verbatim,quote]
2977 \set Staff.midiInstrument = #"flute"
2978 \new Voice \relative c''' {
2986 \set Staff.midiInstrument = #"clarinet"
2987 \new Voice \relative c'' {
2998 tempoWholesPerMinute = #(ly:make-moment 72 2)
2999 midiMinimumVolume = #0.2
3000 midiMaximumVolume = #0.5
3007 @unnumberedsubsubsec Égalisation de plusieurs instruments (i)
3008 @translationof Equalizing different instruments (i)
3010 La définition de l'amplitude du volume MIDI au niveau d'un contexte
3011 @code{Staff} permet de gérer les volumes relatifs entre les différents
3012 instruments. Ceci constitue en quelque sorte un égaliseur, ce qui
3013 permet d'améliorer notablement la qualité de la sortie MIDI.
3015 La clarinette de l'exemple suivant jouera relativement moins fort que la
3016 flûte. Rappelez-vous que pour que cela fonctionne correctement, la
3017 première note de chacun des instruments doit être affublée d'une
3018 indication de nuance.
3020 @lilypond[verbatim,quote]
3026 \set Staff.midiInstrument = #"flute"
3027 \set Staff.midiMinimumVolume = #0.7
3028 \set Staff.midiMaximumVolume = #0.9
3029 \new Voice \relative c''' {
3037 \set Staff.midiInstrument = #"clarinet"
3038 \set Staff.midiMinimumVolume = #0.3
3039 \set Staff.midiMaximumVolume = #0.6
3040 \new Voice \relative c'' {
3055 @unnumberedsubsubsec Égalisation de plusieurs instruments (ii)
3056 @translationof Equalizing different instruments (ii)
3058 Lorsque les propriétés volume minimum et maximum n'ont pas été définies,
3059 LilyPond appliquera par défaut une légère égalisation pour quelques
3060 instruments. Les instrument concernés ainsi que le niveau d'égalisation
3061 sont répertoriés dans une table @notation{instrument-equalizer-alist}
3062 du fichier @file{../scm/midi.scm}.
3064 Vous pouvez remplacer l'égaliseur basique en définissant une nouvelle
3065 procédure Scheme @code{instrumentEqualizer} au sein du contexte
3066 @code{Score}. Cette procédure prend en unique argument le nom d'un
3067 instrument MIDI et renverra une paire de fractions correspondant au
3068 minimum et maximum de volume alloué à cet instrument. Cette
3069 substitution fonctionne selon le même principe que celui que nous avons
3070 vu en début de chapitre avec @code{dynamicAbsoluteVolumeFunction}.
3071 L'égaliseur par défaut, @notation{default-instrument-equalizer}, est
3072 défini dans le fichier @file{../scm/midi.scm} ; son analyse vous
3073 aidera à construire votre propre procédure.
3075 Nous allons, dans l'exemple suivant, régler le volume relatif de la
3076 flûte et de la clarinette -- au même niveau que dans le précédent.
3078 @lilypond[verbatim,quote]
3079 #(define my-instrument-equalizer-alist '())
3081 #(set! my-instrument-equalizer-alist
3084 ("flute" . (0.7 . 0.9))
3085 ("clarinet" . (0.3 . 0.6)))
3086 my-instrument-equalizer-alist))
3088 #(define (my-instrument-equalizer s)
3089 (let ((entry (assoc s my-instrument-equalizer-alist)))
3098 \set Score.instrumentEqualizer = #my-instrument-equalizer
3099 \set Staff.midiInstrument = #"flute"
3100 \new Voice \relative c''' {
3108 \set Staff.midiInstrument = #"clarinet"
3109 \new Voice \relative c'' {
3124 @c Delete when satisfied this is adequately covered elsewhere -td
3126 @n ode Microtones in MIDI
3127 @s ubsection Microtones in MIDI
3129 @cindex microtones in MIDI
3131 Microtones consisting of half sharps and half flats are exported
3132 to the MIDI file and render correctly in MIDI players which support
3133 pitch bending. See @ref{Note names in other languages}. Here is
3134 an example showing all the half sharps and half flats. It can be
3135 copied out and compiled to test microtones in your MIDI player.
3137 @lilypond[verbatim,quote]
3154 @node MIDI et percussions
3155 @subsection MIDI et percussions
3156 @translationof Percussion in MIDI
3158 La notation pour percussions recourt généralement à un contexte
3159 particulier -- le @code{DrumStaff} -- qui permet d'affecter directement
3160 les instruments concernés au canal 10 qui leur est réservé.
3162 Certains instruments, tels le xylophone, le marimba, le vibraphone ou
3163 les timbales, se traitent cependant comme des instruments
3164 @qq{classiques} puisqu'ils sont capables d'émettre des hauteurs
3165 différentes ; leurs notation relève donc d'un contexte @code{Staff}
3166 standard, et non d'un @code{DrumStaff} pour pouvoir être rendus
3167 correctement en MIDI.
3169 D'autres percussions, bien que n'émettant qu'un seul son et inclus dans
3170 le standard @emph{general MIDI}, comme le tom mélodique ou le tambour
3171 taiko, ne sont pas attachés au canal 10. Ces instruments doivent
3172 donc être saisi dans un contexte @code{Staff}, en utilisant la hauteur
3175 De nombreux instruments de la famille des percussions, les castagnettes
3176 par exemple, n'existent pas dans le standard @emph{general MIDI}.
3177 L'alternative, bien que peu satisfaisante, consiste à leur attribuer le
3178 son le plus proche dans la banque standard.
3180 @c TODO Expand with examples, and any other issues
3183 Le standard @emph{general MIDI} ne dispose pas du @emph{rim shot} ;
3184 LilyPond lui substitue un @emph{sidestick}.
3187 @node Le script Articulate
3188 @subsection Le script Articulate
3189 @translationof The Articulate script
3191 Vous obtiendrez un rendu MIDI plus @qq{réaliste} grâce au script
3192 @code{articulate}. Celui-ci va tout faire pour d'une part prendre en
3193 compte les articulations (liaisons, staccato etc.) -- en ajoutant un
3194 blanc aux notes raccourcies -- et, d'autre part, développer les trilles
3195 ou groupettos ainsi que tenir compte des éventuels rallentando et
3198 L'utilisation du script @code{articulate} se fait en deux temps. Vous
3199 devez dans un premier temps inclure son fichier d'initialisation en
3200 ajoutant en tête de votre fichier la ligne
3203 \include "articulate.ly"
3206 puis, dans le bloc @code{\score}, indiquer que toutes les répétitions
3207 seront développées et appliquer la commande à votre musique :
3210 \unfoldRepeats \articulate <<
3211 tout le reste du bloc contenant la partition...
3215 Une fois votre fichier modifié de la sorte, vous constaterez que la
3216 version imprimable aura été modifiée en profondeur. Le bloc
3217 @code{\midi} produira par contre un fichier MIDI de bien meilleure
3220 Bien que cela ne gène en rien le fonctionnement du script
3221 @code{articulate}, lui adjoindre la commande @code{\unfoldRepeats} comme
3222 illustré ci-dessus permettra le rendu d'un certain nombre
3223 d'articulations tels les trilles.
3226 Dans la mesure où le script @code{articulate} tend à raccourcir les
3227 accords, certaines musiques, notamment pour l'orgue, paraîtront de moins
3231 @node Extraction d'informations musicales
3232 @section Extraction d'informations musicales
3233 @translationof Extracting musical information
3235 En plus de générer du graphisme et du MIDI, LilyPond peut présenter
3236 l'information musicale sous forme textuelle.
3239 * Affichage de notation au format LilyPond::
3240 * Affichage de la musique sous forme d'expression Scheme::
3241 * Enregistrement d'événements musicaux dans un fichier::
3245 @node Affichage de notation au format LilyPond
3246 @subsection Affichage de notation au format LilyPond
3247 @translationof Displaying LilyPond notation
3249 @funindex \displayLilyMusic
3251 La fonction musicale @code{\displayLilyMusic} permet d'afficher en
3252 notation LilyPond une expression musicale. Le résultat défilera dans le
3253 terminal après avoir lancé LilyPond en ligne de commande. Par exemple,
3257 \displayLilyMusic \transpose c a, @{ c4 e g a bes @}
3264 @{ a,4 cis e fis g @}
3267 LilyPond affichera le résultat sous forme de message en console, au
3268 milieu de toutes les informations de compilation. Afin d'isoler ces
3269 messages et enregistrer le résultat de la fonction
3270 @code{\display@{MATÉRIAU@}}, pensez à rediriger la sortie vers un
3274 lilypond fichier.ly > affichage.txt
3279 Vous noterez que LilyPond ne se contente pas de simplement afficher
3280 l'expression musicale, mais procède aussi à son interprétation -- du
3281 fait que @code{\displayLilyMusic} renvoie l'expression tout en
3282 l'affichant. S'il est bien pratique d'insérer un
3283 @code{\displayLilyMusic} dans une expression musicale pour en obtenir
3284 des informations, l'interprétation de cette expression peut toutefois
3285 être évitée en ajoutant un @code{\void} avant l'instruction :
3289 \void \displayLilyMusic \transpose c a, @{ c4 e g a bes @}
3294 @node Affichage de la musique sous forme d'expression Scheme
3295 @subsection Affichage de la musique sous forme d'expression Scheme
3296 @translationof Displaying scheme music expressions
3298 Voir @rextend{Affichage d'expressions musicales}.
3301 @node Enregistrement d'événements musicaux dans un fichier
3302 @subsection Enregistrement d'événements musicaux dans un fichier
3303 @translationof Saving music events to a file
3305 LilyPond vous permet de sauvegarder dans un fichier séparé, sur la base
3306 de la portée, les événements musicaux. Vous devrez pour ce faire
3307 inclure dans votre fichier maître un fichier d'initialisation
3311 \include "event-listener.ly"
3314 Pour chaque portée que comporte votre partition, vous obtiendrez un
3315 fichier @file{NOMFICHIER-PORTÉENOMMÉE.notes} ou
3316 @file{NOMFICHIER-unnamed-staff.notes}. Notez bien que si plusieurs
3317 portées ne sont pas explicitement nommées, tous leurs événements seront
3318 regroupés et mélangés dans le même fichier. Le résultat ressemblera à
3322 0.000 note 57 4 p-c 2 12
3324 0.250 note 62 4 p-c 7 12
3325 0.500 note 66 8 p-c 9 12
3326 0.625 note 69 8 p-c 14 12
3331 Il s'agit d'un tableau dont les colonnes sont délimitées par une
3332 tabulation. Chaque ligne comporte deux champs fixes suivis d'un certain
3333 nombre de paramètres optionnels.
3336 @var{temps} @var{type} @var{...paramètres...}
3339 Ces informations peuvent faire l'objet d'un retraitement par d'autres
3340 programmes, comme des scripts python, aux fins de recherche en analyse
3341 musicologique ou des expériences à partir du rendu de LilyPond.
3344 Tous les événements ne sont pas pris en charge par
3345 @file{event-listener.ly}. Il s'agit en premier lieu d'une
3346 démonstration, un @qq{proof of concept} du potentiel de LilyPond. Si
3347 certains des éléments que vous cherchez à obtenir n'apparaissent pas,
3348 recopiez le fichier @file{event-listener.ly} dans votre répertoire et
3349 modifiez-le de telle sorte qu'il travaille selon vos attentes.