1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
3 Translation of GIT committish: 952705bbbb000581a13836e6a733df04511e93c5
5 When revising a translation, copy the HEAD committish of the
6 version that you are working on. For details, see the Contributors'
7 Guide, node Updating translation committishes..
12 @c Translators: Jean-Charles Malahieude, Valentin Villenave
14 @node Généralités en matière d'entrée et sortie
15 @chapter Généralités en matière d'entrée et sortie
16 @translationof General input and output
18 Nous n'allons pas, dans ce chapitre, parler directement de notation,
19 mais plutôt du contenu des fichiers source et du résultat produit par
23 * Agencement du code::
25 * Travail sur des fichiers texte::
26 * Contrôle des sorties::
28 * Extraction d'informations musicales::
32 @node Agencement du code
33 @section Agencement du code
34 @translationof Input structure
36 LilyPond traite des fichiers textuels. Ces fichiers portent par
37 convention une extension @code{.ly}.
40 * Structure d'une partition::
41 * Plusieurs partitions dans un même ouvrage::
42 * Plusieurs éditions pour une même source::
43 * Nom des fichiers de sortie::
44 * Structure de fichier::
48 @node Structure d'une partition
49 @subsection Structure d'une partition
50 @translationof Structure of a score
54 Un bloc @code{\score} contient obligatoirement une seule expression
55 musicale délimitée par des accolades :
63 @warning{Il ne doit y avoir qu'@strong{une seule} expression musicale
64 globale dans un bloc @code{@bs{}score}, et elle @strong{doit} être
65 bornée par une paire d'accolades.}
67 Cette unique expression musicale peut être de n'importe quelle taille et
68 contenir d'autres expressions musicales aussi complexes soient elles.
69 Voici quelques exemples d'expression musicale :
75 @lilypond[verbatim,quote]
82 @lilypond[verbatim,quote]
84 \new Staff { c'4 c' c' c' }
85 \new Staff { d'4 d' d' d' }
93 \new Staff @{ \flute @}
94 \new Staff @{ \hautbois @}
97 \new Staff @{ \violonI @}
98 \new Staff @{ \violonII @}
104 Les commentaires constituent l'une des rares exceptions à cette règle
105 immuable -- voir @ref{Structure de fichier} pour les autres. Qu'il
106 s'agisse d'une seule ligne ou de tout un bloc -- délimité par @code{%@{
107 .. %@}} -- un commentaire peut se placer n'importe où dans le fichier
108 source, aussi bien à l'intérieur qu'à l'extérieur du bloc @code{\score},
109 ou encore à l'intérieur ou à l'extérieur de l'expression musicale
110 contenue dans un bloc @code{\score}.
112 Lorsqu'un fichier ne comprend qu'un bloc @code{\score}, celui-ci est
113 implicitement inclus dans un bloc @code{\book}. Le bloc @code{\book}
114 d'un fichier source permet la production d'au moins un fichier dont le
115 nom sera, par défaut, déduit du fichier source : le traitement de
116 @file{fandangopourelephants.ly} produira donc
117 @file{fandangopourelephants.pdf}.
119 Pour de plus amples informations à propos du bloc @code{\book}, lisez
120 @ref{Plusieurs partitions dans un même ouvrage},
121 @ref{Plusieurs éditions pour une même source} et
122 @ref{Structure de fichier}.
125 Manuel d'initiation :
126 @rlearning{La partition est une (unique) expression musicale composée},
127 @rlearning{Les expressions musicales en clair},
128 @rlearning{Travail sur les fichiers d'entrée}.
131 @node Plusieurs partitions dans un même ouvrage
132 @subsection Plusieurs partitions dans un même ouvrage
133 @translationof Multiple scores in a book
135 @cindex mouvements, plusieurs
136 @cindex plusieurs mouvements
140 Un ouvrage peut se composer de plusieurs morceaux et de texte. C'est le
141 cas des cahiers d'exercices ou d'une partie d'orchestre avec ses
142 différents mouvements. Chaque mouvement fait l'objet d'un bloc
151 et le texte est contenu dans un bloc @code{\markup},
161 Les différents mouvements et textes qui apparaissent dans un même
162 fichier @file{.ly} ne composeront en principe qu'un seul fichier
177 Attention cependant si vous travaillez avec lilypond-book : il vous
178 faudra explicitement mentionner le bloc @code{\book}, en l'absence de
179 quoi seul le premier @code{\score} ou @code{\markup} apparaîtra après
182 L'entête de chaque pièce peut se placer au sein du bloc @code{\score} ;
183 le contenu du champ @code{piece} viendra s'imprimer avant chaque
184 mouvement. De même, le titre de l'ouvrage peut se placer au sein du
185 bloc @code{\book}. Dans le cas contraire, le contenu du bloc
186 @code{\header} placé en début de fichier sera utilisé.
190 title = "Huit miniatures"
191 composer = "Igor Stravinsky"
195 \header @{ piece = "Romance" @}
198 ..texte du second couplet..
201 ..texte du troisième couplet..
205 \header @{ piece = "Menuet" @}
211 Plusieurs pièces seront regroupées dans un même @qq{chapitre} à l'aide
212 d'un bloc @code{\bookpart}. Ces différents @qq{chapitres} sont séparés
213 par un saut de page et peuvent comporter un titre à l'instar de
214 l'ouvrage dès lors que vous y insérez un bloc @code{\header}.
219 title = "Titre de l'ouvrage"
220 subtitle = "Première partie"
227 subtitle = "Deuxième partie"
235 @node Plusieurs éditions pour une même source
236 @subsection Plusieurs éditions pour une même source
237 @translationof Multiple output files from one input file
239 Dès lors que vous inscrivez plusieurs blocs @code{\book} dans un même
240 fichier @file{.ly}, chacun d'eux donnera lieu à un résultat indépendant.
241 Lorsqu'aucun bloc @code{\book} n'est spécifié dans le fichier source,
242 LilyPond considère que l'intégralité du fichier constitue un bloc
243 @code{\book} unique, comme indiqué à la rubrique
244 @ref{Structure de fichier}.
246 LilyPond fait en sorte, lorsque plusieurs fichiers sont produits à
247 partir d'une même source, qu'aucun résultat d'un bloc @code{\book}
248 n'écrase celui qui a été généré pour un bloc @code{\book} précédent.
250 Dans les faits, et si le nom du fichier produit est repris de sa source
251 -- comportement par défaut --, un suffixe lui sera ajouté pour chaque
252 @code{\book}. Il s'agit en principe d'un pseudo numéro de version.
253 Ainsi, le fichier @file{huitminiatures.ly} qui contiendrait
258 \layout @{ @dots{} @}
262 \layout @{ @dots{} @}
266 \layout @{ @dots{} @}
274 @file{huitminiatures.pdf},
276 @file{huitminiatures-1.pdf} et
278 @file{huitminiatures-2.pdf}.
282 @node Nom des fichiers de sortie
283 @subsection Nom des fichiers de sortie
284 @translationof Output file names
286 @funindex \bookOutputSuffix
287 @funindex \bookOutputName
289 LilyPond vous permet de prendre le contrôle dans la dénomination des
290 fichiers que vous voulez générer, quel que soit le moteur de rendu
293 Nous avons vu dans la rubrique précédente que LilyPond évite les
294 conflits de nom des fichiers qu'il génère à partir d'une même source.
295 Vous pouvez même définir vous-même le suffixe qui sera appliqué à chacun
296 des blocs @code{\book}. Ainsi, en reprenant l'exemple ci-avant, vous
297 obtiendrez les fichiers @file{huitminiatures-Romance.pdf},
298 @file{huitminiatures-Menuet.pdf} et @file{huitminiatures-Nocturne.pdf}
299 en ajoutant simplement une déclaration @code{\bookOutputSuffix} au sein
300 de chaque bloc @code{\book}.
304 \bookOutputSuffix "Romance"
306 \layout @{ @dots{} @}
309 \bookOutputSuffix "Menuet"
311 \layout @{ @dots{} @}
314 \bookOutputSuffix "Nocturne"
316 \layout @{ @dots{} @}
320 La déclaration @code{\bookOutputName} vous permet de définir vous-même
321 le nom du fichier généré pour un bloc @code{\book} :
325 \bookOutputName "Romance"
327 \layout @{ @dots{} @}
330 \bookOutputName "Menuet"
332 \layout @{ @dots{} @}
335 \bookOutputName "Nocturne"
337 \layout @{ @dots{} @}
341 Le traitement de ce fichier produira :
353 @node Structure de fichier
354 @subsection Structure de fichier
355 @translationof File structure
365 Un fichier @code{.ly} peut contenir un certain nombre d'expressions de
366 haut niveau. Les expressions de haut niveau sont les suivantes :
370 Une définition de sortie, comme @code{\paper}, @code{\midi} et
371 @code{\layout}. Ces définitions, lorsqu'elles se trouvent à un niveau
372 supérieur, s'appliqueront à l'intégralité de l'ouvrage. Si l'une de ces
373 expression apparaît à plusieurs reprises à un niveau supérieur, les
374 différents contenus seront combinés, à ceci près qu'en cas de
375 déclarations conflictuelles, la dernière aura préséance. Des
376 informations complémentaires sont disponibles à la rubrique
377 @ref{Le bloc \layout}.
380 Une expression Scheme pure, telle que
381 @w{@code{#(set-default-paper-size "a7" 'landscape)}} ou
382 @w{@code{#(ly:set-option 'point-and-click #f)}}.
385 Un bloc @code{\header}, dont le contenu sera de portée globale -- ce qui
386 est le cas en général pour le titre ou l'auteur entre autres.
389 Un bloc @code{\score} pour la partition. Cette partition sera assemblée
390 avec les autres partitions se trouvant au même niveau pour composer le
391 @code{\book}. Vous pouvez modifier ce comportement à l'aide de la
392 variable @code{toplevel-score-handler} placée en tête.
394 @c FIXME - I cannot read "toplevel-score-handler" in scm/lily.scm -jcm
395 The default handler is defined in the init file @file{../scm/lily.scm}.
399 Un bloc @code{\book} permet de regrouper naturellement plusieurs
400 mouvements -- autrement dit plusieurs blocs @code{\score} -- dans un
401 même document. Lorsqu'il y a plusieurs @code{\score}, LilyPond génère
402 un seul fichier dans lequel les mouvements sont mis les uns à la suite
403 des autres, ce pour chacun des blocs @code{\book} rencontrés. La seule
404 raison qui peut vous demander d'expliciter plusieurs blocs @code{\book}
405 dans un fichier @file{.ly} est lorsque vous avez besoin de générer
406 différents documents à partir d'une même source. La présence explicite
407 d'un bloc @code{\book} est aussi nécessaire lorsque vous travaillez sur
408 un document lilypond-book qui reprendrait plusieurs @code{\score} ou
409 @code{\markup} dans un même extrait. Vous pouvez modifier ce
410 comportement à l'aide de la variable @code{toplevel-book-handler}
413 @c FIXME - I cannot read "toplevel-book-handler" in scm/lily.scm -jcm
414 The default handler is defined in the init file @file{../scm/lily.scm}.
418 Un bloc @code{\bookpart}. Un ouvrage peut se découper en plusieurs
419 parties à l'aide de blocs @code{\bookpart}, aussi bien pour alléger le
420 travail de l'algorithme de calcul des sauts de page, que si les réglages
421 du bloc @code{\paper} diffèrent d'une partie à l'autre.
424 Une expression musicale telle que
429 Ce bout de code sera placé dans un @code{\score} et intégré à l'ouvrage
430 en même temps que tous les autres @code{\score} ou expressions
431 musicales. En d'autres termes, un fichier qui ne contiendrait que cette
432 simple expression musicale sera traduit en
449 Vous pouvez modifier ce comportement à l'aide de la variable
450 @code{toplevel-music-handler} placée en tête.
452 @c FIXME - I cannot read "toplevel-music-handler" in scm/lily.scm -jcm
453 The default handler is defined in the init file @file{../scm/lily.scm}.
457 Du texte sous forme de @emph{markup} comme les paroles d'un couplet
460 2. Le première ligne du deuxième couplet.
464 De tels @emph{markups} seront imprimés là où ils apparaissent,
465 avant, après ou entre les expressions musicales.
468 @cindex identificateurs
471 Une variable, ou identificateur, telle que
473 toto = @{ c4 d e d @}
476 Vous pourrez la réutiliser plus loin dans votre fichier en saisissant
477 simplement @code{\toto}. Le nom des identificateurs ne doit être
478 formés que de caractères alphabétiques -- sans chiffre ni caractère
483 Voici trois éléments que vous pouvez placer à un niveau supérieur :
487 % pas en pleine largeur
498 Vous pouvez placer, n'importe où dans votre fichier, les instructions
502 @item @code{\version}
503 @item @code{\include}
504 @item @code{\sourcefilename}
505 @item @code{\sourcefileline}
507 Une ligne de commentaire, introduite par le signe @code{%}.
510 Un bloc de commentaire, délimité par @code{%@{ .. %@}}.
517 Vous pouvez insérer des espaces dans votre fichier source afin de lui
518 apporter une meilleure lisibilité. Les espaces superflus sont
519 normalement ignorés. Notez cependant qu'il est des cas où l'espace est
520 requis pour éviter tout risque d'erreur :
524 Autour d'une accolade, qu'elle soit ouvrant ou fermante ;
527 Après chaque commande ou variable, autrement dit tout élément qui
528 commence par un @code{\} ;
531 Après tout élément qui sera interprété comme une expression Scheme,
532 autrement dit tout élément qui commence par un @code{#} ;
535 Pour séparer les éléments d'une expression Scheme ;
538 En mode parole -- @code{lyricmode} -- pour séparer les termes des
539 commandes @code{\override} et @code{\set}. Précisons à ce sujet qu'en
540 plus d'ajouter une espace avant et après l'intégralité de la commande,
541 vous devrez encadrer d'espaces le point et le signe égal qu'elle peut
543 @w{@code{\override Score . LyricText #'font-size = #5}}.
548 Manuel d'initiation :
549 @rlearning{Organisation des fichiers LilyPond}.
552 @ref{Le bloc \layout}.
555 @node Titres et entêtes
556 @section Titres et entêtes
557 @translationof Titles and headers
559 La plupart de la musique qui est éditée comporte un titre et le nom de
560 son compositeur ; certains ouvrages divulguent beaucoup plus
564 * Création de titres et entête ou pied de page::
565 * Titrages personnalisés::
566 * Notes de bas de page::
567 * Référencement des numéros de page::
568 * Table des matières::
572 @node Création de titres et entête ou pied de page
573 @subsection Création de titres et entête ou pied de page
574 @translationof Creating titles headers and footers
577 * Contenu des blocs de titrage::
578 * Mise en forme par défaut des titrages::
579 * Mise en forme par défaut des entête et pied de page::
583 @node Contenu des blocs de titrage
584 @unnumberedsubsubsec Contenu des blocs de titrage
585 @translationof Title blocks explained
587 @c TODO: figure out how \bookpart titles work
589 Il existe en fait deux types de blocs de titrage : un bloc pour
590 contenir le titre principal qui doit apparaître avant le tout premier
591 @code{\score} d'un ouvrage, et un autre attaché à chacun des blocs
592 @code{\score} qui le composent. Dans les deux cas, les champs qui
593 composent un bloc de titrage se saisissent dans un bloc @code{\header}.
595 Lorsque l'ouvrage ne comporte qu'un seul morceau, le bloc @code{\header}
596 peut se placer en dehors ou au sein même du bloc @code{\score}.
598 Dans le cas où le bloc @code{\header} est défini à l'intérieur du bloc
599 @code{\score}, seuls les champs @code{piece} et @code{opus} seront
602 @lilypond[papersize=a5,quote,verbatim,noragged-right]
606 title = "title" % not printed
613 @funindex print-all-headers
615 Vous pouvez modifier ce comportement et imprimer tous les champs d'un
616 bloc @code{\header} défini dans un bloc @code{\score} en ajoutant
620 print-all-headers = ##t
624 @warning{N'oubliez pas que lorsqu'il est placé à l'intérieur d'un bloc
625 @code{@bs{}score}, le bloc @code{@bs{}header} doit impérativement se
626 trouver @strong{à la suite} de l'expression musicale.}
628 @lilypond[papersize=a5,quote,verbatim,noragged-right]
631 composer = "J. S. Bach."
635 \new Staff \relative g, {
638 \repeat unfold 2 { g16( d' b') a b d, b' d, } |
639 \repeat unfold 2 { g,16( e' c') b c e, c' e, } |
647 \new Staff \relative b {
651 <g, d' b'~>4 b'16 a( g fis) g( d e fis) g( a b c) |
652 d16( b g fis) g( e d c) b(c d e) fis( g a b) |
660 Tous les champs appartenant au titrage principal d'un ouvrage peuvent se
661 reporter dans chaque bloc @code{\score} ou être supprimés manuellement :
664 @lilypond[papersize=a5,quote,verbatim,noragged-right]
667 print-all-headers = ##t
670 title = "DAS WOHLTEMPERIRTE CLAVIER"
672 % Pas de mention spéciale pour cet ouvrage
675 \markup { \vspace #1 }
679 \new Staff { \clef "bass" s1 }
682 title = "PRAELUDIUM I"
684 % Pas de sous-titre pour ce morceau
691 \new Staff { \clef "bass" s1 }
695 subsubtitle = "A 4 VOCI"
697 % Pas de sous-titre pour ce morceau
706 @ref{Structure de fichier},
707 @ref{Mise en forme personnalisée des blocs de titrage}.
710 @node Mise en forme par défaut des titrages
711 @unnumberedsubsubsec Mise en forme par défaut des titrages
712 @translationof Default layout of book and score title blocks
714 Voici les différentes variables attachées au bloc @code{\header} :
717 @lilypond[papersize=a7,quote,verbatim,noragged-right]
720 % Les champs suivants sont centrés
721 dedication = "Dédicace"
723 subtitle = "Sous-titre"
724 subsubtitle = "Sous-sous-titre"
725 % Les champs suivants sont répartis sur une même ligne, et
726 % le champ "instrument" apparaîtra sue les pages suivantes
727 instrument = \markup \with-color #green "Instrument"
729 composer = "Compositeur"
730 % Les champs suivants sont en opposition sur la même ligne
732 arranger = "Arrangeur"
733 % Les champs suivants sont centrés en bas de page
734 tagline = "« tagline » ou mention spéciale en pied de dernière page"
735 copyright = "copyright en pied de première page"
740 % Les champs suivants sont en opposition sur la même ligne
748 % Les champs suivants sont en opposition sur la même ligne
749 piece = "Pièce 2 sur la même page"
757 % Les champs suivants sont en opposition sur la même ligne
758 piece = "Pièce 3 sue une nouvelle page"
765 Quelques précisions :
769 Le nom de l'instrument sera répété en tête de chaque page.
772 Seuls seront imprimés les champs @code{piece} et @code{opus} inclus dans
773 un bloc @code{\score} dès lors que la variable @code{print-all-headers}
774 reste désactivée (valeur à @code{##f}).
777 @c Is the bit about \null markups true? -mp
778 Les champs d'un bloc @code{\header} qui n'auront pas été alimentés
779 seront remplacés par un @emph{markup} @code{\null} de façon à ne pas
783 Par défaut, @code{scoreTitleMarkup} place les champs @code{piece} et
784 @code{opus} de part et d'autre sur une même ligne.
788 Les possibilités de modifier la mise en forme par défaut sont abordées à
789 la rubrique @ref{Mise en forme personnalisée des blocs de titrage}.
793 La variable @code{breakbefore} activée dans un bloc @code{\header} situé
794 dans un bloc @code{\score} force le saut de page avant le morceau
795 contenu dans ce @code{\score}. Vous pourrez ainsi séparer le titre
796 principal de la musique.
798 @lilypond[papersize=a8landscape,verbatim,noragged-right]
801 title = "This is my Title"
802 subtitle = "This is my Subtitle"
803 copyright = "This is the bottom of the first page"
806 \repeat unfold 4 { e'' e'' e'' e'' }
808 piece = "This is the Music"
816 Manuel d'initiation :
817 @rlearning{Organisation des fichiers LilyPond}.
820 @ref{Mise en forme personnalisée des blocs de titrage},
821 @ref{Structure de fichier}.
823 Fichiers d'initialisation :
824 @file{ly/titling-init.ly}.
827 @node Mise en forme par défaut des entête et pied de page
828 @unnumberedsubsubsec Mise en forme par défaut des entête et pied de page
829 @translationof Default layout of headers and footers
831 Les entête et pied -- @emph{headers} et @emph{footers} -- sont des
832 lignes de textes qui apparaissent en haut et en bas de chaque page,
833 indépendamment du texte de l'ouvrage. Ils sont contrôlés par les
834 variables suivantes, attachées au bloc @code{\paper} :
837 @item @code{oddHeaderMarkup} -- entête de page impaire
838 @item @code{evenHeaderMarkup} -- entête de page paire
839 @item @code{oddFooterMarkup} -- pied de page impaire
840 @item @code{evenFooterMarkup} -- pied de page paire
843 Ces variables @emph{markup} n'accèdent qu'au contenu des champs du bloc
844 @code{\header} principal, celui qui s'appliquera à tous les blocs
845 @code{\score} du document. Ces variables sont définies dans le fichier
846 @file{ly/titling-init.ly}, et sont par défaut :
851 les numéros sont placés en haut à gauche (si pair) ou à droite (si
852 impair) de chaque page à compter de la deuxième ;
855 le contenu du champ @code{instrument} est centré en haut de chaque page
856 à compter de la deuxième ;
859 le texte du @code{copyright} est centré au bas de la première page ;
862 le @code{tagline} -- mention spéciale -- se place au bas de la dernière
863 page, ou bien sous le @code{copyright} s'il n'y a qu'une seule page.
867 @lilypond[papersize=a8landscape]
877 La mention spéciale se modifie en alimentant le champ @code{tagline} au
878 niveau du bloc @code{\header} principal.
880 @lilypond[papersize=a8landscape,verbatim]
883 tagline = "... music notation for Everyone"
893 Pour supprimer le @code{tagline}, il suffit de lui assigner la valeur
897 @node Titrages personnalisés
898 @subsection Titrages personnalisés
899 @translationof Custom headers footers and titles
901 @c TODO: somewhere put a link to header spacing info
902 @c (you'll have to explain it more in NR 4).
905 * Mise en forme personnalisée des champs de titrage::
906 * Mise en forme personnalisée des blocs de titrage::
907 * Mise en forme personnalisée des entête et pied de page::
911 @node Mise en forme personnalisée des champs de titrage
912 @unnumberedsubsubsec Mise en forme personnalisée des champs de titrage
913 @translationof Custom text formatting for title blocks
915 Toutes les commandes de mise en forme d'un @code{\markup} permettent de
916 personnaliser le texte des entête, pied de page et éléments de titre
917 contenus dans un bloc @code{\header}.
919 @lilypond[quote,verbatim,noragged-right]
923 piece = \markup { \fontsize #4 \bold "PRAELUDIUM I" }
924 opus = \markup { \italic "(Excerpt)" }
931 @ref{Mise en forme du texte}.
934 @node Mise en forme personnalisée des blocs de titrage
935 @unnumberedsubsubsec Mise en forme personnalisée des blocs de titrage
936 @translationof Custom layout for title blocks
938 @cindex bookTitleMarkup
939 @cindex scoreTitleMarkup
940 @funindex bookTitleMarkup
941 @funindex scoreTitleMarkup
943 L'utilisation de commandes @code{\markup} au sein d'un bloc
944 @code{\header} permet de modifier aisément l'apparence du texte,
945 mais n'influence en rien le positionnement précis des éléments de
946 titrage. L'accès au positionnement des champs de titrage est géré par
947 les deux variables suivantes, attachées au bloc @code{\paper} :
950 @item @code{bookTitleMarkup}
951 @item @code{scoreTitleMarkup}
954 Le positionnement des titres, avec les valeurs par défaut de ces
955 variables @code{\markup}, est illustré à la rubrique
956 @ref{Mise en forme par défaut des titrages}.
958 Voici les réglages par défaut de @code{scoreTitleMarkup}, tels que
959 définis dans le fichier @file{ly/titling-init.ly} :
962 scoreTitleMarkup = \markup @{ \column @{
963 \on-the-fly #print-all-headers @{ \bookTitleMarkup \hspace #1 @}
965 \fromproperty #'header:piece
966 \fromproperty #'header:opus
972 Ceci aura donc pour effet de positionner les champs @code{piece} et
973 @code{opus} sur la même ligne, en opposition :
975 @lilypond[quote,verbatim,noragged-right]
979 piece = "PRAELUDIUM I"
985 Voici comment positionner le champ @code{piece}, dont nous modifions
986 la taille et la graisse, au centre de cette ligne :
988 @lilypond[papersize=a5,quote,verbatim,noragged-right]
992 scoreTitleMarkup = \markup {
995 \fontsize #4 \bold \fromproperty #'header:piece
996 \fromproperty #'header:opus
1000 \header { tagline = ##f }
1004 piece = "PRAELUDIUM I"
1011 Les champs normalement réservés au bloc de titrage principal seront
1012 reportés au niveau inférieur dès lors que vous aurez activé
1013 l'instruction @code{print-all-headers} au sein du bloc @code{\paper}.
1014 Le principal inconvénient de cette fonction réside dans le fait que les
1015 champs réservés au bloc @code{\header} principal devront être supprimés
1016 dans chacun des blocs @code{\score} de votre fichier source -- voir
1017 @ref{Contenu des blocs de titrage}.
1019 Afin d'éviter ce désagrément, ajoutez le champ que vous désirez voir
1020 apparaître à la définition de @code{scoreTitleMarkup}. Nous allons,
1021 dans l'exemple suivant, ajouter au @code{scoreTitleMarkup} le champ
1022 @code{composer}, normalement associé au @code{bookTitleMarkup} ;
1023 chaque @code{\score} pourra mentionner un compositeur différent.
1025 @lilypond[papersize=a5,quote,verbatim,noragged-right]
1029 scoreTitleMarkup = \markup {
1032 \fontsize #4 \bold \fromproperty #'header:piece
1033 \fromproperty #'header:composer
1037 \header { tagline = ##f }
1042 composer = "Christian Petzold"
1049 composer = "François Couperin"
1055 Rien ne vous empêche de créer votre propre champ personnalisé, puis d'y
1056 faire référence dans la définition du @emph{markup}.
1058 @lilypond[papersize=a5,quote,verbatim,noragged-right]
1062 scoreTitleMarkup = \markup {
1065 \override #`(direction . ,UP) {
1067 \center-align \fontsize #-1 \bold
1068 \fromproperty #'header:mycustomtext %% User-defined field
1069 \center-align \fontsize #4 \bold
1070 \fromproperty #'header:piece
1073 \fromproperty #'header:opus
1077 \header { tagline = ##f }
1082 mycustomtext = "A 4 VOCI" %% User-defined field
1090 Manuel de notation :
1091 @ref{Contenu des blocs de titrage}.
1094 @node Mise en forme personnalisée des entête et pied de page
1095 @unnumberedsubsubsec Mise en forme personnalisée des entête et pied de page
1096 @translationof Custom layout for headers and footers
1098 @c can make-header and make-footer be removed from
1099 @c paper-defaults-init.ly? -mp
1101 L'utilisation de commandes @code{\markup} au sein d'un bloc
1102 @code{\header} permet de modifier aisément l'apparence du texte,
1103 mais n'influence en rien le positionnement précis des entête et pied
1104 de page. L'accès au positionnement des champs concernés est géré par
1105 les quatre variables suivantes, attachées au bloc @code{\paper} :
1108 @item @code{oddHeaderMarkup}
1109 @item @code{evenHeaderMarkup}
1110 @item @code{oddFooterMarkup}
1111 @item @code{evenFooterMarkup}
1114 @cindex markup conditionnel
1115 @cindex condition et markup
1117 @funindex \on-the-fly
1119 L'instruction @code{\on-the-fly} au sein d'un @code{\markup} permet
1120 d'ajouter, lorsque certaines conditions sont respectées, des éléments
1121 au texte des entête et pied de page définis dans le bloc @code{\paper}.
1122 En voici la syntaxe :
1125 @code{variable} = @code{\markup} @{
1127 @code{\on-the-fly} #@var{procédure} @var{markup}
1132 La @var{procédure} est appelée à chaque fois que la commande
1133 @code{\markup} où elle apparaît est évaluée. La @var{procédure}
1134 effectuera un test de conformité particulière et interprètera, autrement
1135 dit imprimera l'argument @var{markup} si et seulement si cette
1136 condition est remplie.
1138 LilyPond dispose d'ores et déjà d'un certain nombre de procédures :
1141 @multitable {print-page-number-check-first-----} {ce n'est la première page du book--}
1143 @headitem Nom de la procédure @tab Condition testée
1145 @item print-page-number-check-first @tab il faut imprimer ce numéro de page.
1146 @item create-page-number-stencil @tab 'print-page-numbers est vrai.
1147 @item print-all-headers @tab 'print-all-headers est vrai.
1148 @item first-page @tab c'est la première page du @emph{book}.
1149 @item (on-page nombre) @tab page number = nombre
1150 @item last-page @tab c'est la dernière page du @emph{book}.
1151 @item not-first-page @tab ce n'est la première page du @emph{book}.
1152 @item part-first-page @tab c'est la première page de la partie.
1153 @item part-last-page @tab c'est la dernière page de la partie.
1154 @item not-single-page @tab cette partie fait plus d'une page.
1159 L'exemple suivant illustre la manière de centrer son numéro au bas de
1160 chaque page. Il nous faut tout d'abord annuler la définition de
1161 @code{oddHeaderMarkup} et @code{evenHeaderMarkup} à l'aide d'un
1162 @emph{markup} @code{\null}. Nous redéfinissons ensuite
1163 @code{oddFooterMarkup} pour qu'il contienne le numéro de page, centré.
1164 Enfin, nous appliquons le même paramétrage au @code{\oddFooterMarkup}.
1166 @lilypond[papersize=a8,quote,verbatim,noragged-right]
1169 print-page-number = ##t
1170 print-first-page-number = ##t
1171 oddHeaderMarkup = \markup \null
1172 evenHeaderMarkup = \markup \null
1173 oddFooterMarkup = \markup {
1175 \on-the-fly #print-page-number-check-first
1176 \fromproperty #'page:page-number-string
1179 evenFooterMarkup = \oddFooterMarkup
1182 \new Staff { s1 \break s1 \break s1 }
1187 Plusieurs conditions @code{\on-the-fly} mentionnées l'une à la suite de
1188 l'autre se cumulent. Ainsi, par exemple,
1191 @code{\on-the-fly #first-page}
1192 @code{\on-the-fly #last-page}
1193 @code{@{ \markup ... \fromproperty #'header: ... @}}
1196 teste si la sortie tient sur une page unique.
1199 Manuel de notation :
1200 @ref{Contenu des blocs de titrage},
1201 @ref{Mise en forme par défaut des titrages}.
1203 fichiers d'initialisation :
1204 @file{../ly/titling-init.ly}.
1207 @node Notes de bas de page
1208 @subsection Notes de bas de page
1209 @translationof Creating footnotes
1211 LilyPond dispose de deux méthodes pour créer des notes de bas de page,
1212 l'une automatisée, et l'autre manuelle.
1215 * Considérations générales en matière de note de bas de page::
1216 * Notes de bas de page automatiques::
1217 * Notes de bas de page manuelles::
1221 @node Considérations générales en matière de note de bas de page
1222 @unnumberedsubsubsec Considérations générales en matière de note de bas de page
1223 @translationof Footnotes overview
1225 Il est parfois judicieux, notamment lorsqu'une annotation ou un
1226 commentaire gênerait la lecture de la partition, de les reporter en bas
1229 Les notes de bas de page automatiques font appel à un compteur
1230 numérique incrémenté automatiquement ; les notes de bas de page
1231 manuelles vous laissent le libre choix de l'appel (l'indicateur). Une
1232 note de bas de page s'applique comme un @code{\tweak} ; elle peut donc
1233 s'attacher directement à un objet graphique créé par la plupart des
1234 éléments musicaux ou événements rattachés. Lorsque ce n'est pas
1235 possible, par exemple sur une barre de mesure ou un changement de
1236 métrique -- l'objet étant alors le résultat d'une modification de
1237 propriété --, les notes de bas de page peuvent être spécifiées en tant
1238 qu'événement musical indépendant et affectant tous les objets d'un
1239 type particulier à un instant particulier.
1241 Examinons la forme développée d'une commande de note de bas de page :
1244 \footnote @var{marque} @var{décalage} @var{nom-grob} @var{annotation}
1248 Ses arguments peuvent se définir ainsi :
1252 un @emph{markup} ou une chaîne de caractères identifiant l'annotation
1253 tant au niveau de l'appel que de la note qui apparaîtra au bas de la
1254 page. L'absence de cet élément -- ou une valeur de @code{\default} --
1255 incrémentera le compteur.
1258 une paire de nombres -- @samp{#(2 . 1)} par exemple -- spécifiant le
1259 décalage de la marque, en abscisse et en ordonnée, par rapport au point
1263 le type d'objet à annoter -- @samp{#'Flag} par exemple. Lorsque cet
1264 élément est spécifié, c'est l'objet en question qui servira de point de
1265 référence, même s'il trouve son origine non pas directement dans
1266 l'élément @var{musique} mais dans un objet en résultant. Son absence ou
1267 une valeur de @code{\default} ne permet d'annoter que des objets
1271 un @emph{markup} ou une chaîne de caractères qui sera reporté au bas de
1275 l'élément qui fait l'objet du commentaire, qu'il s'agisse d'un
1276 événement musical, de l'un des constituants d'un accord ou d'un
1277 événement rattaché. Bien qu'il ne puisse être omis, il peut être
1278 remplacé par @code{\default}, auquel cas l'annotation ne sera pas
1279 rattachée à une expression musicale particulière, mais plutôt à un
1280 instant précis. L'argument @var{nom-grob} est alors obligatoire pour
1281 sélectionner le type d'objet affecté -- @samp{#'TimeSignature} par
1285 Tout comme pour la commande @code{\tweak}, lorsqu'un @code{\footnote}
1286 s'applique à un événement rattaché ou à une articulation, il devra être
1287 précédé d'un @code{-} de telle sorte que l'analyseur syntaxique en
1288 attache le résultat à la note ou au silence précédant.
1291 @node Notes de bas de page automatiques
1292 @unnumberedsubsubsec Notes de bas de page automatiques
1293 @translationof Automatic footnotes
1295 @cindex note de bas de page automatique
1296 @cindex bas de page, note automatique
1301 La commande @code{\footnote} permet de générer automatiquement des notes
1302 de bas de page. Elle requiert quatre arguments : la position
1303 @samp{(x . y)} de l'appel de note, le @var{nom-grob} optionnel
1304 spécifiant l'objet de rendu auquel s'applique le commentaire,
1305 l'@var{annotation} qui apparaîtra au bas de la page, et enfin la
1306 @var{musique} à laquelle se rapporte l'annotation.
1309 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1311 \header { tagline = ##f }
1313 \footnote #'(0.5 . -2)
1314 \markup { La première note }
1316 \footnote #'(0.5 . 1) #'Flag
1317 \markup { La troisième note }
1323 L'annotation d'un accord suit la même règle :
1326 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1328 \header { tagline = ##f }
1331 \footnote #'(1 . -1.25) "Voici un do" c
1332 \footnote #'(2 . -0.25) \markup { \italic "Un mi bémol" } es
1333 \footnote #'(2 . 3) \markup { \bold "Ceci est un sol" } g
1339 @warning{Lorsque plusieurs notes de bas de page se rapportent à un même
1340 empilement vertical, les notes apparaîtront dans l'ordre vertical des
1341 appels, autrement dit celui positionné le plus haut en premier, et ainsi
1344 Voici quelques exemples d'objets annotés automatiquement. Vous pouvez
1345 constater l'agencement des annotations correspondantes avec le copyright
1348 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1350 \header { copyright = \markup { "Copyright 1970" } }
1352 a'4-\footnote #'(-3 . 0) \markup { \bold Forte } \f
1353 -\footnote #'(0 . 1.5) \markup { A slur } (
1354 b8)-\footnote #'(0 . -2) \markup { Beam } [ e]
1355 \footnote #'(1 . -1) #'Stem
1356 \markup { \teeny { This is a stem } }
1358 \footnote #'(0 . 0.5) #'AccidentalCautionary
1359 \markup \italic { A cautionary accidental }
1360 \footnote #'(1 . 1) "The note itself"
1361 dis?4-\footnote #'(0.5 . -0.5) \markup \italic { Slow Down }
1367 Une note de bas de page affectant un @code{\markup} de haut niveau
1368 s'introduit par la commande @code{\auto-footnote} :
1370 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1372 \header { tagline = ##f }
1373 \markup { \auto-footnote "A simple tune" \italic "By me" }
1381 @node Notes de bas de page manuelles
1382 @unnumberedsubsubsec Notes de bas de page manuelles
1383 @translationof Manual footnotes
1385 @cindex note de bas de page manuelle
1386 @cindex bas de page, note manuelle
1388 LilyPond permet aussi de créer des notes de bas de page manuelles :
1389 la commande @code{\footnote} prend alors un argument supplémentaire :
1390 la @var{marque}, qui contient l'appel qui s'attache à la note ou à
1391 l'objet référencé. Contrairement aux notes de bas de page automatiques,
1392 l'annotation en bas de page ne sera pas précédée de la @var{marque} ;
1393 l'indicateur visuel est laissé à l'appréciation de l'utilisateur.
1394 LilyPond ne s'attache ici qu'à faire apparaître l'annotation au bas de
1397 La commande @code{\footnote} s'utilise de la même manière que dans le
1398 cas de notes automatiques.
1400 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1402 \header { tagline = ##f }
1406 \markup { \italic "1. The first note" }
1410 \markup { \bold "2" } #'(0.5 . 1)
1411 "2. The second note"
1414 d-\footnote "3" #'(0.5 . -1) "3. Piano" \p
1419 L'annotation d'un accord suit la même règle :
1421 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1423 \header { tagline = ##f }
1426 \footnote "1" #'(1 . -1.25) "1. C" c
1428 \markup { \bold "b" } #'(2 . -0.25) "b. E-flat" es
1429 \footnote "3" #'(2 . 3) \markup { \italic "iii. G" } g
1435 @warning{Lorsque plusieurs notes de bas de page se rapportent à un même
1436 empilement vertical, les notes apparaîtront dans l'ordre vertical des
1437 appels, autrement dit celui positionné le plus haut en premier, et ainsi
1440 Voici quelques exemples d'objets annotés manuellement. Vous pouvez
1441 constater l'agencement des annotations correspondantes avec le copyright
1444 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1446 \header { tagline = ##f }
1449 \markup { \teeny 1 } #'(-3 . 0)
1450 \markup { 1. \bold Forte } \f
1452 \markup { \teeny b } #'(0 . 1.5)
1453 \markup { b. A slur } (
1455 \markup { \teeny 3 } #'(0 . -2)
1456 \markup { 3. Beam } [
1459 \markup { 4 } #'(1 . -1) #'Stem
1460 \markup { \bold 4. { This is a stem } }
1463 \markup \concat \teeny { "sharp (v)" }
1464 #'(0 . 0.5) #'AccidentalCautionary
1465 \markup \italic { v. A cautionary accidental }
1467 \markup \concat \teeny { "a" } #'(0.5 . -0.5)
1468 \markup \italic { a. Slow Down } _"rit."
1470 \markup { \teeny \musicglyph #"rests.4" }
1472 \markup { \null } \breathe
1477 L'annotation manuelle d'un @code{\markup} de haut niveau répond à la
1480 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1482 \header { tagline = ##f }
1483 \markup { "A simple tune" \footnote "*" \italic "* By me" }
1491 Manuel d'initiation :
1492 @rlearning{Objets et interfaces}.
1494 Manuel de notation :
1495 @ref{Commentaires textuels},
1496 @ref{Indications textuelles},
1498 @ref{Mise en forme de la page},
1499 @ref{Titres et entêtes}.
1501 Référence des propriétés internes :
1502 @rinternals{FootnoteEvent},
1503 @rinternals{FootnoteItem},
1504 @rinternals{FootnoteSpanner},
1505 @rinternals{Footnote_engraver}.
1508 Un silence multimesures ne peut se voir affecter une note de bas de
1511 Les notes de bas de page ne peuvent que s'empiler l'une au-dessus de
1512 l'autre ; elles ne seront jamais présentées à la queue leu leu.
1513 Les notes de bas de page peuvent générer des chevauchements quand elles
1514 sont trop nombreuses sur une même page.
1516 Dès lors que vous utilisez une commande de note de bas de page manuelle,
1517 le bloc @code{\paper} doit contenir la mention
1518 @w{@code{footnote-auto-number = ##f}}.
1521 @node Référencement des numéros de page
1522 @subsection Référencement des numéros de page
1523 @translationof Reference to page numbers
1525 LilyPond vous permet, à l'aide de la commande @code{\label}, d'insérer
1526 des points de référence dans un ouvrage, aussi bien en dehors qu'au fil
1527 de la musique. Ce point de référence pourra être ensuite repris à
1528 l'intérieur d'un @emph{markup} ; vous pourrez même y ajouter le
1529 numéro de page grâce à la commande de @emph{markup} @code{\page-ref}.
1532 @lilypond[verbatim,papersize=a8landscape]
1533 \header { tagline = ##f }
1539 \pageBreak \mark A \label #'markA
1544 \markup { Le premier mouvement débute à la page \page-ref #'firstScore "0" "?" }
1545 \markup { Le repère A est à la page \page-ref #'markA "0" "?" }
1549 L'instruction @code{\page-ref} prend trois arguments :
1552 le point de référence, sous la forme d'un symbole Scheme, comme par
1553 exemple @code{#'firstScore},
1556 un @qq{emporte-pièce} afin d'estimer la longueur totale du
1560 un texte de remplacement au cas où la référence ne serait pas retrouvée.
1563 La présence de l'emporte-pièce est rendue nécessaire par le fait que les
1564 @emph{markups} sont générés avant que les sauts de page ne soient
1565 positionnés. Bien que le numéro de page en question ne soit pas encore
1566 déterminé, LilyPond doit connaître les dimensions de ce @emph{markup}.
1567 Vous pouvez, lorsque l'ouvrage contiendra plus de dix pages, stipuler un
1568 emporte-pièce sur deux caractères -- soit @code{"00"}.
1578 @node Table des matières
1579 @subsection Table des matières
1580 @translationof Table of contents
1582 La commande @code{\markuplist \table-of-contents} vous permettra de
1583 générer une table des matières. Les éléments qui la composeront sont
1584 créés par la commande @code{\tocItem}, insérée indépendamment ou au sein
1585 d'une expression musicale.
1588 \markuplist \table-of-contents
1591 \tocItem \markup "Premier mouvement"
1595 \tocItem \markup "Passage spécifique du premier mouvement"
1600 \tocItem \markup "Second mouvement"
1608 Les @emph{markups} dévolus à la mise en forme de la table des matières
1609 se définissent dans le bloc @code{\paper}. Il s'agit par défaut de
1610 @code{tocTitleMarkup} pour le titre de la table, et de
1611 @code{tocItemMarkup} pour ses éléments -- composés de leur libellé et
1612 numéro de page. Vous pouvez bien entendu personnaliser ces variables :
1616 %% Translate the toc title into French:
1617 tocTitleMarkup = \markup \huge \column {
1618 \fill-line { \null "Table des matières" \null }
1621 %% use larger font size
1622 tocItemMarkup = \markup \large \fill-line {
1623 \fromproperty #'toc:text \fromproperty #'toc:page
1628 Notez bien la manière de référencer le libellé et le numéro de page dans
1629 la définition de @code{tocItemMarkup}.
1631 N'hésitez pas à définir vous-même d'autres commandes et @emph{markups}
1632 afin de construire une table plus élaborée :
1635 commencez par définir une nouvelle variable de type @code{markup} au
1636 sein du bloc @code{\paper},
1639 puis définissez une fonction musicale chargée d'insérer un élément de la
1640 table à partir de cette variable.
1643 Dans l'exemple qui suit, nous avons créé un nouveau style d'élément dans
1644 le but de mentionner les actes dans la table des matières d'un opéra :
1648 tocActMarkup = \markup \large \column {
1650 \fill-line { \null \italic \fromproperty #'toc:text \null }
1656 #(define-music-function (parser location text) (markup?)
1657 (add-toc-item! 'tocActMarkup text))
1660 @lilypond[line-width=10.0\cm]
1661 \header { tagline = ##f }
1663 tocActMarkup = \markup \large \column {
1665 \fill-line { \null \italic \fromproperty #'toc:text \null }
1671 #(define-music-function (parser location text) (markup?)
1672 (add-toc-item! 'tocActMarkup text))
1675 \markuplist \table-of-contents
1676 \tocAct \markup { Atto Primo }
1677 \tocItem \markup { Coro. Viva il nostro Alcide }
1678 \tocItem \markup { Cesare. Presti omai l'Egizzia terra }
1679 \tocAct \markup { Atto Secondo }
1680 \tocItem \markup { Sinfonia }
1681 \tocItem \markup { Cleopatra. V'adoro, pupille, saette d'Amore }
1686 L'élément et son numéro de page peuvent se rejoindre par une ligne
1689 @lilypond[verbatim,line-width=10.0\cm]
1690 \header { tagline = ##f }
1692 tocItemMarkup = \tocItemWithDotsMarkup
1696 \markuplist \table-of-contents
1697 \tocItem \markup { Allegro }
1698 \tocItem \markup { Largo }
1704 @funindex \table-of-contents
1705 @code{\table-of-contents},
1711 Fichiers d'initialisation :
1712 @file{../ly/toc-init.ly}.
1715 @node Travail sur des fichiers texte
1716 @section Travail sur des fichiers texte
1717 @translationof Working with input files
1720 * Insertion de fichiers LilyPond::
1721 * Différentes éditions à partir d'une même source::
1722 * Caractères spéciaux::
1726 @node Insertion de fichiers LilyPond
1727 @subsection Insertion de fichiers LilyPond
1728 @translationof Including LilyPond files
1731 @cindex inclusion de fichiers
1733 Lorsqu'un projet prend de l'importance en volume, il est judicieux de le
1734 scinder en plusieurs fichiers, auxquels vous ferez référence avec un
1738 \include "autrefichier.ly"
1741 Une ligne @code{\include "autrefichier.ly"} dans un fichier revient à
1742 recopier intégralement le contenu de @file{autrefichier.ly} à l'endroit
1743 même ou est placée l'instruction @code{\include}. Vous pouvez par
1744 exemple écrire un fichier individuel par instrument, puis les regrouper
1745 pour former le fichier @qq{conducteur}. Les différentes variables
1746 définies dans les fichiers séparés seront normalement reprises et
1747 utilisables dans le fichier formant le conducteur. Les sections
1748 balisées dans les fichiers individuels peuvent être réutilisées en
1749 différents endroit de la partition, comme expliqué à la rubrique
1750 @ref{Différentes éditions à partir d'une même source}.
1752 Lorsque le fichier auquel il est fait référence se trouve dans le même
1753 répertoire, donner seulement son nom en argument à la commande
1754 @code{\include} suffit. S'il se trouve ailleurs, vous devrez indiquer
1755 le chemin d'accès, absolu ou relatif, en respectant toutefois la syntaxe
1756 UNIX -- autrement dit, le séparateur de répertoire est une oblique
1757 normale @code{/} et non l'oblique inverse @code{\} de DOS ou Windows.
1758 Par exemple, si le fichier @file{truc.ly} se trouve dans le répertoire
1759 supérieur au répertoire de travail, la ligne devra être
1762 \include "../truc.ly"
1766 ou bien, si les fichiers correspondant aux parties d'orchestre se
1767 trouvent dans le sous-répertoire @file{parties} relativement au
1768 répertoire courant, vous devrez mentionner
1771 \include "parties/VI.ly"
1772 \include "parties/VII.ly"
1776 Les fichiers à inclure peuvent eux-mêmes contenir des instructions
1777 @code{\include}. Ces instructions @code{\include} de second niveau ne
1778 pourront, par défaut, être interprétées qu'une fois intégrées dans le
1779 fichier principal ; leur argument doit donc comporter le chemin
1780 relativement au fichier principal et non par rapport au fichier dans
1781 lequel cette inclusion est mentionnée. Vous pouvez toutefois influer
1782 sur ce comportement à l'aide de l'option @w{@code{-drelative-includes}}
1783 en ligne de commande ou en ajoutant une clause
1784 @code{#(ly:set-option 'relative-includes #t)} en tête du fichier
1785 principal. Une fois @code{relative-include} activé, le chemin à suivre
1786 pour chacune des commandes @code{\include} sera pris relativement au
1787 fichier qui la contient. Cette option est vouée à être activée par
1788 défaut dans une future version de LilyPond.
1790 Vous pouvez inclure des fichiers dont vous spécifierez le chemin d'accès
1791 sur la ligne de commande au moment de lancer la compilation. L'appel à
1792 ces fichiers ne mentionnera alors que leur nom. Par exemple, si vous
1793 voulez compiler avec cette méthode le fichier @file{principal.ly} qui
1794 inclut des fichiers situés dans le sous-répertoire @file{parties},
1795 placez vous dans le répertoire contenant @file{principal.ly}, puis tapez
1798 lilypond --include=parties principal.ly
1801 tout en ayant bien dans @file{principal.ly}
1809 Lorsqu'un fichier est voué à être inclus dans nombre de partitions, vous
1810 pouvez le placer dans le répertoire de LilyPond @file{../ly}.
1811 Attention : ce répertoire varie selon votre installation, comme
1812 indiqué au chapitre @rlearning{Autres sources de documentation}. Ce
1813 fichier sera inclus dès lors que vous fournirez uniquement son nom en
1814 argument à la fonction @code{\include}. C'est par exemple le cas du
1815 fichier de définition particulier @file{gregorian.ly}.
1817 Au moment où vous lancez LilyPond, un certain nombre de fichiers se
1818 retrouvent inclus par défaut ; il suffit d'activer le mode verbeux
1819 en faisant @w{@code{lilypond --verbose}} pour s'en rendre compte. Vous
1820 verrez ainsi défiler, en plus de nombreuses informations, le nom d'un
1821 certain nombre de fichiers et de chemins d'accès. Les fichiers les plus
1822 important sont mentionnés au chapitre
1823 @rlearning{Autres sources de documentation}. Si vous venez à les
1824 modifier, rappelez-vous qu'ils seront écrasés à l'installation d'une
1825 nouvelle version de LilyPond.
1827 Vous trouverez quelques exemples simples d'utilisation de la commande
1828 @code{\include} au chapitre @rlearning{Conducteurs et parties}.
1831 Manuel d'initiation :
1832 @rlearning{Autres sources de documentation},
1833 @rlearning{Conducteurs et parties}.
1836 Lorsque vous incluez un fichier qui porte le même nom que l'un des
1837 fichiers d'initialisation de LilyPond, le fichier de la distribution de
1838 LilyPond aura préséance.
1841 @node Différentes éditions à partir d'une même source
1842 @subsection Différentes éditions à partir d'une même source
1843 @translationof Different editions from one source
1845 Plusieurs méthodes permettent de générer différentes versions d'une
1846 partition à partir d'une même source. Les variables -- ou
1847 identificateurs -- sont sûrement le moyen le plus simple de combiner de
1848 différente manière des passages relativement longs, alors que les
1849 balises permettront de sélectionner de courts fragments selon leur
1852 Quelle que soit la méthode utilisée, séparer la notation de la structure
1853 de la partition vous donnera plus de liberté dans l'agencement de
1854 l'ouvrage final, puisque vous ne reviendrez pas sur la musique qui le
1858 * Utilisation de variables::
1859 * Utilisation de balises::
1860 * Globalisation des réglages::
1864 @node Utilisation de variables
1865 @unnumberedsubsubsec Utilisation de variables
1866 @translationof Using variables
1868 @cindex variables, utilisation de
1870 Un fragment musical identifié par une variable est réutilisable à divers
1871 endroits de la partition, comme nous l'avons vu à la rubrique
1872 @rlearning{Organisation du code source avec des variables}. Par
1873 exemple, une partition pour chœur @notation{a cappella} comporte souvent
1874 une réduction pour piano reprenant toutes les voix ; il s'agit de
1875 la même musique, et vous ne devrez donc la saisir qu'une seule fois.
1876 D'autre part, la musique issue de deux variables peut se combiner sur
1877 une seule portée, comme nous l'avons vu à la rubrique
1878 @ref{Regroupement automatique de parties}. Prenons l'exemple suivant :
1880 @lilypond[verbatim,quote]
1881 sopranoMusic = \relative c'' { a4 b c b8( a) }
1882 altoMusic = \relative g' { e4 e e f }
1883 tenorMusic = \relative c' { c4 b e d8( c) }
1884 bassMusic = \relative c' { a4 gis a d, }
1885 allLyrics = \lyricmode {King of glo -- ry }
1887 \new Staff = "Soprano" \sopranoMusic
1888 \new Lyrics \allLyrics
1889 \new Staff = "Alto" \altoMusic
1890 \new Lyrics \allLyrics
1891 \new Staff = "Tenor" {
1895 \new Lyrics \allLyrics
1896 \new Staff = "Bass" {
1900 \new Lyrics \allLyrics
1903 \set Staff.printPartCombineTexts = ##f
1909 \set Staff.printPartCombineTexts = ##f
1919 Générer une partition chorale ou la réduction pour piano ne requiert que
1920 de modifier la structure des éléments, sans aucunement toucher à la
1923 Dans le cas d'une partition relativement longue, vous pouvez isoler la
1924 définition des différentes variables dans des fichiers séparés que vous
1925 rappellerez ensuite, comme indiqué à la rubrique
1926 @ref{Insertion de fichiers LilyPond}.
1929 @node Utilisation de balises
1930 @unnumberedsubsubsec Utilisation de balises
1931 @translationof Using tags
1934 @funindex \keepWithTag
1935 @funindex \removeWithTag
1936 @funindex \pushToTag
1937 @funindex \appendToTag
1941 La commande @code{\tag #'@var{partieA}} affecte à une expression
1942 musicale le nom @var{partieA}. Les expressions ainsi balisées pourront
1943 être filtrées par la suite, à l'aide de @code{\keepWithTag #'@var{nom}}
1944 ou @code{\removeWithTag #'@var{nom}}. Ces filtres fonctionnent de la
1947 @multitable @columnfractions .5 .5
1952 Musique balisée précédée de @code{\keepWithTag #'@var{nom}}
1953 @tab Musique non balisée et musique balisée par @var{nom} seront
1954 incluses ; la musique balisée autrement est exclue.
1957 Musique balisée précédée de @code{\removeWithTag #'@var{nom}}
1958 @tab Musique non balisée et fragments appelés autrement que @var{nom}
1959 seront inclus ; la musique balisée par @var{nom} est exclue.
1962 Musique balisée non précédée de @code{\keepWithTag} ou
1963 @code{\removeWithTag}
1964 @tab Musique balisée et non balisée seront incluses.
1968 Les arguments des commandes @code{\tag}, @code{\keepWithTag} et
1969 @code{\removeWithTag} doivent être un symbole (tel que
1970 @code{#'conducteur} ou @code{#'partie}), suivi d'une expression
1973 Dans l'exemple qui suit, nous obtenons deux versions du même extrait,
1974 l'une pour le conducteur, l'autre pour l'instrumentiste qui, elle,
1975 comportera les ornements développés.
1977 @lilypond[verbatim,quote]
1978 music = \relative g' {
1980 \tag #'trills { d8.\trill }
1981 \tag #'expand { \repeat unfold 3 { e32 d } }
1986 \keepWithTag #'trills \music
1989 \keepWithTag #'expand \music
1994 Il est parfois plus aisé d'exclure des fragments :
1996 @lilypond[verbatim,quote]
1997 music = \relative g' {
1999 \tag #'trills { d8.\trill }
2000 \tag #'expand {\repeat unfold 3 { e32 d } }
2005 \removeWithTag #'expand
2009 \removeWithTag #'trills
2014 Ce principe de filtrage peut s'appliquer aux articulations, textes etc.
2015 Il suffit de positionner
2018 -\tag #@var{ma-balise}
2022 avant l'articulation ou le texte, comme ici :
2026 c1-\tag #'gaffe ^"Attention !"
2030 Ceci définira une note avec une indication conditionnelle de doigté ou
2033 Vous pouvez baliser différemment la même expression musicale en
2034 saisissant plusieurs @code{\tag} :
2036 @lilypond[quote,verbatim]
2037 music = \relative c'' {
2038 \tag #'a \tag #'both { a4 a a a }
2039 \tag #'b \tag #'both { b4 b b b }
2042 \keepWithTag #'a \music
2043 \keepWithTag #'b \music
2044 \keepWithTag #'both \music
2048 L'application concomitante de plusieurs filtres @code{\removeWithTag} à
2049 la même expression musicale permet d'exclure plusieurs balisages :
2051 @lilypond[verbatim,quote]
2052 music = \relative c'' {
2053 \tag #'A { a4 a a a }
2054 \tag #'B { b4 b b b }
2055 \tag #'C { c4 c c c }
2056 \tag #'D { d4 d d d }
2065 L'application de plus d'un filtre @code{\keepWithTag} à la même
2066 expression musicale aboutit à l'exclusion de @b{tous} les balisages.
2067 En effet, si le premier filtre exclut tous les autres balisages,
2068 l'application du second exclura les effets du premier.
2070 Il peut arriver que vous ayez besoin de raccorder quelque chose en un
2071 point particulier d'une expression musicale. Les commandes
2072 @code{\pushToTag} et @code{\appendToTag} permettent d'insérer du
2073 matériau, qu'il soit antérieur ou postérieur, à des @code{éléments}
2074 d'une construction musicale existante. La musique séquentielle ou
2075 simultanée comporte assurément des @code{éléments} :
2077 @lilypond[verbatim,quote]
2078 test = { \tag #'here { \tag #'here <<c''>> } }
2081 \pushToTag #'here c'
2082 \pushToTag #'here e'
2083 \pushToTag #'here g' \test
2084 \appendToTag #'here c'
2085 \appendToTag #'here e'
2086 \appendToTag #'here g' \test
2090 Ces deux instructions sont affectées d'une balise, le matériau à
2091 raccorder à chaque instance de la balise, et l'expression balisée.
2092 Ces instructions prennent soin de recopier tout ce qui doit être
2093 modifié, de telle sorte que l'expression @code{\test} originale conserve
2097 Manuel d'initiation :
2098 @rlearning{Organisation du code source avec des variables}.
2100 Manuel de notation :
2101 @ref{Regroupement automatique de parties},
2102 @ref{Insertion de fichiers LilyPond}.
2106 @c This warning is more general than this placement implies.
2107 @c Rests are not merged whether or not they come from tagged sections.
2108 @c Should be deleted? -td
2111 Lorsqu'elles comportent des silences, ceux-ci ne seront pas fusionnés
2112 si vous imprimez une partition avec les deux sections balisées.
2117 @node Globalisation des réglages
2118 @unnumberedsubsubsec Globalisation des réglages
2119 @translationof Using global settings
2121 @cindex include-settings
2123 Vous pouvez regrouper dans un fichier indépendant vos réglages
2124 personnels que vous inclurez au besoin :
2127 lilypond -dinclude-settings=MES_REGLAGES.ly MA_PARTITION.ly
2130 Vous pouvez ainsi stocker dans un fichier séparé vos réglages en matière
2131 de format de papier, de fontes utilisées ou vos définitions
2132 particulières. Selon le fichier de réglages que vous mentionnerez, vous
2133 obtiendrez facilement différentes éditions à partir d'une même source
2134 quelle qu'elle soit.
2136 Cette technique peut s'utiliser en combinaison avec des feuilles de
2137 styles, comme indiqué au chapitre @rlearning{Feuilles de style}.
2140 Manuel d'initiation :
2141 @rlearning{Organisation du code source avec des variables},
2142 @rlearning{Feuilles de style}.
2144 Manuel de notation :
2145 @ref{Insertion de fichiers LilyPond}.
2148 @node Caractères spéciaux
2149 @subsection Caractères spéciaux
2150 @translationof Special characters
2152 @cindex caractères spéciaux
2153 @cindex non-ASCII, caractères
2158 * Équivalents ASCII::
2162 @node Codage du texte
2163 @unnumberedsubsubsec Codage du texte
2164 @translationof Text encoding
2168 LilyPond utilise le jeu de caractères défini par le consortium Unicode
2169 et la norme ISO/CEI 10646. Chaque caractère est identifié par un
2170 nom unique et associé à un point de code, ce qui permet dans l'absolu de
2171 couvrir tous les langages. Unicode permet de coder tous les caractères
2172 utilisés par toutes les langues écrites du monde. LilyPond utilise le
2173 codage UTF-8 (UTF pour @emph{Unicode Transformation Format}) qui permet
2174 de représenter les caractères latins sur un octet et les autres sur une
2175 longueur allant jusqu'à quatre octets.
2177 L'apparence réelle des caractères est déterminée par les glyphes ou
2178 graphèmes tels que définis dans les différentes polices disponibles.
2179 Une police, ou une fonte, définit la mise en correspondance d'un
2180 sous-ensemble de points de code unicode en glyphes. LilyPond recourt à
2181 la bibliothèque Pango pour assurer le rendu des textes multilingues.
2183 LilyPond n'effectue aucune conversion d'encodage que ce soit. Ceci
2184 implique donc que tout texte -- un titre, des paroles ou même une
2185 instruction musicale -- comportant des caractères non ASCII soit
2186 codé en UTF-8. Le plus sûr moyen de saisir du texte de la sorte
2187 consiste à utiliser un éditeur supportant l'unicode et à enregistrer vos
2188 fichier en UTF-8. C'est le cas pour la plupart des éditeurs actuels,
2189 que ce soit vim, Emacs, jEdit et GEdit. Tous les systèmes Windows
2190 postérieurs à NT utilisent Unicode en natif ; même Notepad est
2191 capable d'éditer et sauvegarder un fichier en UTF-8 -- sans parler de
2192 l'excellente alternative qu'est BabelPad.
2194 La compilation d'un fichier LilyPond comportant des caractères non ASCII
2195 qui n'aurait pas été enregistré dans l'encodage UTF-8 vous renverra
2199 FT_Get_Glyph_Name () erreur : invalid argument
2202 Voici un exemple utilisant du texte en cyrillique, en hébreux et en
2206 %c No verbatim here as the code does not display correctly in PDF
2208 bulgarian = \lyricmode {
2209 Жълтата дюля беше щастлива, че пухът, който цъфна, замръзна като гьон.
2213 hebrew = \lyricmode {
2214 זה כיף סתם לשמוע איך תנצח קרפד עץ טוב בגן.
2218 portuguese = \lyricmode {
2219 à vo -- cê uma can -- ção legal
2225 \addlyrics { \bulgarian }
2226 \addlyrics { \hebrew }
2227 \addlyrics { \portuguese }
2232 @unnumberedsubsubsec Unicode
2233 @translationof Unicode
2237 Lorsque vous avez besoin d'un caractère dont vous connaissez le point de
2238 code mais que votre éditeur ne permet pas de saisir directement, vous
2239 pouvez utiliser les instructions @code{\char ##xhhhh} ou
2240 @code{\char #dddd} au sein d'un bloc @code{\markup} -- @code{hhhh}
2241 et @code{dddd} correspondant respectivement à la valeur hexadécimale ou
2242 décimale. Même s'il est inutile de saisir les zéros superflus, il est
2243 de bon ton de stipuler les quatre caractères formant la représentation
2244 hexadécimale. Évitez cependant l'encodage UTF-8 d'un point de code
2245 après un @code{\char} ; les encodages UTF-8 comprennent un bit
2246 supplémentaire indiquant le nombre d'octets. Une table de
2247 correspondance entre les codes Unicode et le nom des caractères ainsi
2248 que leur code hexadécimal est disponible sur le site du consortium
2249 Unicode, @uref{http://www.unicode.org/}.
2251 Par exemple, @code{\char ##x03BE} et @code{\char #958} correspondent
2252 tous deux au caractère unicode U+03BE, dénommé @qq{Greek Small Letter
2255 Quel que soit le point de code spécifié de cette manière, il ne vous
2256 sera alors pas nécessaire d'enregistrer votre fichier en UTF-8. Vous
2257 devrez toutefois disposer d'une fonte contenant ce caractère qui soit
2258 accessible à LilyPond.
2260 L'exemple suivant illustre la manière d'insérer un caractère sous sa
2261 forme hexadécimale, à la fois dans un repère, dans une articulation,
2262 dans des paroles et dans du texte indépendant.
2264 @lilypond[quote,verbatim]
2267 c1 \mark \markup { \char ##x03EE }
2268 c1_\markup { \tiny { \char ##x03B1 " to " \char ##x03C9 } }
2270 \addlyrics { O \markup { \concat { Ph \char ##x0153 be! } } }
2272 \markup { "Copyright 2008--2012" \char ##x00A9 }
2277 Le signe @emph{copyright} dans le champ de titrage consacré s'inscrit de
2278 la manière suivante :
2282 copyright = \markup @{ \char ##x00A9 "2008" @}
2287 @node Équivalents ASCII
2288 @unnumberedsubsubsec Équivalents ASCII
2289 @translationof ASCII aliases
2291 Dès lors que vous aurez inclus la liste de leur équivalent ASCII,
2292 LilyPond reconnaîtra un certain nombre de caractères spéciaux :
2294 @lilypond[quote,verbatim]
2296 #(include-special-characters)
2299 \markup "&flqq; – &OE;uvre incomplète… &frqq;"
2302 \new Staff { \repeat unfold 9 a'4 }
2304 This is al -- so wor -- kin'~in ly -- rics: –_&OE;…
2309 "The replacement can be disabled:"
2310 "– &OE; …"
2311 \override #'(replacement-alist . ()) "– &OE; …"
2315 L'extension de cette liste est possible aussi bien de manière globale :
2317 @lilypond[quote,verbatim]
2319 #(add-text-replacements!
2320 '(("100" . "hundred")
2321 ("dpi" . "dots per inch")))
2323 \markup "A 100 dpi."
2326 qu'en un point particulier de votre source :
2328 @lilypond[quote,verbatim]
2329 \markup \replace #'(("100" . "hundred")
2330 ("dpi" . "dots per inch")) "A 100 dpi."
2334 Manuel de notation :
2335 @ref{Liste des caractères spéciaux}.
2337 Fichiers d'initialisation :
2338 @file{ly/text-replacements.ly}.
2341 @node Contrôle des sorties
2342 @section Contrôle des sorties
2343 @translationof Controlling output
2346 * Extraction de fragments musicaux::
2347 * Ignorer des passages de la partition::
2348 * Formats de sortie alternatifs::
2349 * Changement des fontes musicales::
2353 @node Extraction de fragments musicaux
2354 @subsection Extraction de fragments musicaux
2355 @translationof Extracting fragments of music
2357 LilyPond permet d'extraire des fragments d'une partition à l'instar du
2358 choriste amateur qui alimente son album avec des coupures de journaux.
2360 Vous devrez pour cela définir les mesures à découper. La définition
2361 suivante, incluse dans votre fichier source,
2368 (make-rhythmic-location 5 1 2)
2369 (make-rhythmic-location 7 3 4)))
2374 vous permettra d'extraire un fragment compris entre le milieu de la
2375 cinquième mesure et quelque part dans la septième. Le triplet
2376 @code{5 1 2} signifie : après la durée d'une blanche dans la mesure 5 ;
2377 le @code{7 3 4} signifie quant à lui que l'on s'arrête à la mesure 7,
2378 après la durée de trois noires.
2380 Rien ne vous empêche d'extraire plusieurs fragments, dès lors que vous
2381 définissez dans la liste d'autres paires d'emplacements rythmiques.
2383 Cette fonctionnalité n'est toutefois effective que lorsque vous lancez
2384 LilyPond avec l'option @w{@code{-dclip-systems}}. Les @qq{coupures}
2385 seront générées sous la forme de fichiers EPS, convertis en PDF ou PNG
2386 selon le format que vous aurez stipulé.
2388 Pour de plus amples informations quant au format des résultats,
2389 consultez le chapitre @rprogram{Lancement de lilypond}.
2392 @node Ignorer des passages de la partition
2393 @subsection Ignorer des passages de la partition
2394 @translationof Skipping corrected music
2396 @funindex skipTypesetting
2397 @funindex showFirstLength
2398 @funindex showLastLength
2400 Dans un travail de transcription ou de recopie de la musique, ce qui
2401 vous intéresse plus particulièrement se situe à la fin, là même où vous
2402 en êtes dans la notation. Dans le but de gagner du temps dans le
2403 processus de correction, vous pouvez @qq{escamoter} le reste et ne
2404 générer que les dernières mesures en insérant
2407 showLastLength = R1*5
2412 dans votre fichier source. Ceci aura pour effet de ne générer que les
2413 cinq dernières mesures -- si tant est que le morceau soit à 4/4 -- de
2414 tous les @code{\score} de votre fichier. Dans le cas d'un œuvre
2415 conséquente, cette pratique s'avère fort utile puisqu'elle évite de tout
2416 générer. Vous pourriez aussi être amené à retravailler le début d'une
2417 œuvre, pour y ajouter une partie par exemple, auquel cas c'est la
2418 propriété @code{showFirstLength} que vous utiliserez.
2420 Vous pouvez contrôler très finement les parties à escamoter, grâce au
2421 commutateur @code{Score.skipTypesetting} : lorsqu'il est activé,
2422 aucune gravure n'est réalisée.
2424 Ce commutateur agit aussi sur la sortie MIDI. Notez bien que tous les
2425 événements seront escamotés, y compris les changements de tempo ou
2426 d'instrument -- vous voilà prévenu !
2428 @lilypond[quote,relative=2,ragged-right,verbatim]
2430 \set Score.skipTypesetting = ##t
2432 \set Score.skipTypesetting = ##f
2436 Dans le cadre de musique polyphonique, @code{Score.skipTypesetting}
2437 s'applique à toutes les voix et portées. Vous gagnerez donc encore plus
2441 @node Formats de sortie alternatifs
2442 @subsection Formats de sortie alternatifs
2443 @translationof Alternative output formats
2445 @cindex scalable vector graphics
2446 @cindex SVG, format de sortie
2447 @cindex encapsulated postscript
2448 @cindex EPS, format de sortie
2450 En matière de partition imprimable, LilyPond génère par défaut des
2451 documents au format PostScript (PS) et Portable Document Format (PDF).
2452 Vous pouvez aussi obtenir des documents au format Scalable Vector
2453 Graphics (SVG), Encapsulated PostScript (EPS) ou Portable Network
2454 Graphics (PNG) dès lors que vous aurez lancé LilyPond en ligne de
2455 commande avec l'option @i{ad hoc} -- voir
2456 @rprogram{Utilisation en ligne de commande} à ce sujet.
2459 @node Changement des fontes musicales
2460 @subsection Changement des fontes musicales
2461 @translationof Replacing the notation font
2463 Gonville est une alternative à la fonte Feta que LilyPond utilise par
2464 défaut. Vous pouvez la télécharger à partir de
2466 @uref{http://www.chiark.greenend.org.uk/~sgtatham/gonville/ ,http://www.chiark.greenend.org.uk/~sgtatham/gonville/}
2469 Voici quelques mesures utilisant la police Gonville :
2471 @c NOTE: these images are a bit big, but that's important
2472 @c for the font comparison. -gp
2473 @sourceimage{Gonville_after,,,}
2475 Et ces même mesures avec la police de LilyPond, Feta :
2477 @sourceimage{Gonville_before,,,}
2480 @subsubheading Instructions d'installation pour MacOS
2481 @translationof Installation Instructions for MacOS
2483 Téléchargez puis décompressez l'archive zip. Recopiez le répertoire
2484 @code{lilyfonts} dans @file{@var{SHARE_DIR}/lilypond/current} -- voir
2485 @rlearning{Autres sources de documentation} à ce sujet. Renommez le
2486 répertoire @code{fonts} qui s'y trouve en @code{fonts_orig}, puis le
2487 répertoire @code{lilyfonts} en @code{fonts}. Il vous suffira, pour
2488 retrouver la fonte Feta, de renommer @code{fonts_orig} en @code{fonts}.
2491 Manuel d'initiation :
2492 @rlearning{Autres sources de documentation}.
2495 Gonville ne permet pas de générer de la notation ancienne, et certains
2496 glyphes ajoutés depuis lors aux jeux de caractères en soient absent.
2497 Consultez le site de l'auteur pour de plus amples informations ainsi
2498 qu'à propos des conditions d'utilisation.
2502 @section Sortie MIDI
2503 @translationof MIDI output
2508 MIDI (Musical Instrument Digital Interface) constitue un standard en
2509 matière de connexion et de contrôle des instruments électroniques. Un
2510 fichier MIDI contient une série de notes réparties dans différentes
2511 pistes. Il ne s'agit en rien d'un fichier sonore ; il vous faudra
2512 un logiciel capable de traduire ces séries de notes en sons réels.
2514 Vous pouvez convertir vos partition en fichier MIDI de manière à
2515 entendre ce que vous avez saisi. Ceci vous permet de contrôler aisément
2516 ce que vous avez saisi : octaves et altérations erronées heurteront
2517 votre oreille avertie grâce au MIDI.
2519 Le fichier MIDI généré par LilyPond est relativement brut. Vous pouvez
2520 cependant obtenir un meilleur rendu avec @ref{Le script Articulate}.
2522 Dans une sortie MIDI, LilyPond alloue un canal à chaque portée, tout en
2523 réservant le canal 10 aux percussions. Dans la mesure ou un
2524 périphérique MIDI ne comprend que 16 canaux, un fichier MIDI qui
2525 comportera plus de quinze portées verra le même canal réutilisé.
2528 * Création de fichiers MIDI::
2530 * Contenu de la sortie MIDI::
2531 * Répétitions et MIDI::
2532 * Gestion des nuances en MIDI::
2533 * MIDI et percussions::
2534 * Le script Articulate::
2538 @node Création de fichiers MIDI
2539 @subsection Création de fichiers MIDI
2540 @translationof Creating MIDI files
2542 LilyPond générera un fichier MIDI dès que vous ajouterez un bloc
2543 @code{\midi} à la structure de votre partition, comme ici :
2552 Lorsque le bloc @code{\score} contient un bloc @code{\midi} mais pas de
2553 bloc @code{\layout}, LilyPond ne produira qu'une sortie MIDI. Si donc
2554 vous avez besoin aussi d'un support visuel, vous devrez aussi mentionner
2555 un bloc @code{\layout}.
2565 Hauteurs, durées, liaisons de prolongation, nuances et changements de
2566 tempo seront interprétés et traduits en événements MIDI. Les
2567 indications de nuances, crescendos et decrescendos sont traduits en
2568 niveau de volume ; les indications sous la forme d'une fraction
2569 déterminée du volume disponible, et crescendos et decrescendos sous la
2570 forme d'une progression linéaire entre les deux extrêmes. Le rendu des
2571 indications de nuance peut être désactivé pour le MIDI -- voir
2574 Le tempo initial ainsi que ses changements sont normalement indiqués au
2575 fil de la notation à l'aide de la commande @code{\tempo} ; ils seront
2576 retranscrits dans le fichier MIDI. La commande @code{\tempo} donne lieu
2577 à l'impression d'une indication métronomique que vous pouvez toutefois
2578 rendre invisible, comme indiqué à la rubrique
2579 @ref{Indication métronomique}. Une autre manière de spécifier le tempo
2580 initial pour un fichier MIDI est indiquée plus avant -- voir
2583 En raison de certaines limitations de Windows, les fichiers MIDI doivent
2584 y porter l'extension @code{.mid}. D'autres systèmes utilisent
2585 l'extension @code{.midi}. Si besoin est, placez la ligne suivante au
2586 début de votre fichier source, avant l'ouverture de tout bloc
2587 @code{\book}, @code{\bookpart} ou @code{\score} :
2590 #(ly:set-option 'midi-extension "midi")
2593 Cette ligne déterminera @code{.midi} comme extension par défaut pour les
2596 Vous pouvez aussi le faire en ligne de commande :
2599 lilypond … -dmidi-extension=midi fichierLily.ly
2603 @unnumberedsubsubsec Noms d'instrument
2604 @translationof Instrument names
2606 @cindex instrument, nom d'
2607 @funindex Staff.midiInstrument
2609 L'instrument MIDI affecté à un canal particulier est déterminé par la
2610 propriété @code{Staff.midiInstrument}. Vous pouvez choisir l'un des
2611 instruments répertoriés à l'annexe @ref{Instruments MIDI}.
2615 \set Staff.midiInstrument = #"glockenspiel"
2621 \new Staff \with @{midiInstrument = #"cello"@} @{
2626 Lorsque l'instrument choisi ne correspond pas exactement à l'une des
2627 dénominations consacrées, LilyPond le replacera par un piano de concert
2628 (@code{"acoustic grand"}).
2631 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
2632 {changing-midi-output-to-one-channel-per-voice.ly}
2635 @c In 2.11 the following no longer seems to be a problem -td
2637 Un (de)crescendo non terminé ne sera pas correctement rendu en MIDI --
2638 il y a nécessairement du silence. Il vous faut donc lui donner une fin
2639 explicite. Par exemple,
2646 ne fonctionnera pas correctement, contrairement à
2649 @{ a4\< b c d\!\f @}
2653 Un changement de volume ne peut intervenir que sur le démarrage d'une
2654 note. C'est la raison pour laquelle la succession d'un crescendo et
2655 d'un diminuendo ne peut se produire sur une même note.
2657 Certains lecteurs MIDI ne rendent pas correctement les changements de
2658 tempo. MS Windows Media Player et
2659 @uref{http://@/timidity@/.sourceforge@/.net/,timidity} le font sans
2664 @subsection Le bloc MIDI
2665 @translationof MIDI block
2667 Dès lors que vous désirez obtenir une sortie MIDI, vous devrez inscrire
2668 un bloc @code{\midi} au sein du bloc @code{\score}. Son fonctionnement
2669 est comparable à ce lui du bloc @code{\layout}, voire plus simple. Si
2670 le bloc @code{\midi} est la plupart du temps laissé vide, il peut
2671 contenir des aménagements pour certains contextes, la définition de
2672 contextes particuliers ou du code permettant de déterminer la valeur de
2673 certaines propriétés. L'exemple suivant détermine le tempo initial du
2674 fichier MIDI tout en se passant de son indication sur la partition
2686 Ici, le tempo est fixé à 72 noires à la minute. Spécifier un tempo de
2687 la sorte ne permet pas de donner une valeur pour une note pointée. Vous
2688 devrez, en pareil cas, subdiviser la note pointée en durée plus courte.
2689 Par exemple, indiquer 90 à la noire pointée est équivalent à spécifier
2690 270 croches à la minute :
2693 tempoWholesPerMinute = #(ly:make-moment 270 8)
2696 @cindex MIDI et définition de contexte
2697 @cindex contexte, définition en MIDI
2699 La syntaxe permettant de définir un contexte pour le @code{\midi} est en
2700 tout point identique à celle que vous utilisez dans le bloc
2701 @code{\layout}, à ceci près que le @qq{graveur} est remplacé par un
2702 @qq{interprète}. Les différents contextes disponibles en matière de
2703 MIDI sont répertoriés dans le fichier d'initialisation
2704 @file{../ly/performer-init.ly} -- pour plus de détail, voir
2705 @rlearning{Autres sources de documentation}.
2706 Si vous voulez vous passer des nuances dans votre fichier MIDI, il vous
2707 suffit d'insérer les lignes suivantes dans votre bloc
2715 \remove "Dynamic_performer"
2720 LilyPond ne générera de sortie MIDI que si vous incluez un bloc
2721 @code{\midi} dans la structure de la partition, initialisée par la
2722 commande @code{\score}.
2726 @{ @dots{}notes@dots{} @}
2732 @node Contenu de la sortie MIDI
2733 @subsection Contenu de la sortie MIDI
2734 @translationof What goes into the MIDI output?
2736 @c TODO Check grace notes - timing is suspect?
2739 @unnumberedsubsubsec Éléments pris en compte dans le MIDI
2740 @translationof Supported in MIDI
2742 @cindex hauteurs en MIDI
2743 @cindex MIDI, hauteurs
2744 @cindex quart de ton en MIDI
2745 @cindex MIDI, quart de ton
2746 @cindex microtonalité en MIDI
2747 @cindex MIDI, microtonalité
2748 @cindex accords nommés en MIDI
2749 @cindex MIDI, accords nommés
2750 @cindex Rythme en MIDI
2751 @cindex MIDI, Rythme
2752 @cindex articulations et MIDI
2753 @cindex MIDI et articulations
2754 @cindex trilles et MIDI
2755 @cindex MIDI et trilles
2758 Un fichier MIDI généré par LilyPond comprendra les éléments de notation
2766 les microtonalités -- voir @ref{Altérations}. Leur rendu nécessite
2767 cependant un lecteur qui prenne en charge la modulation ;
2770 les accords nommés ;
2773 le rythme en tant que durée de note, y compris les nolets ;
2776 les trémolos, exceptés ceux utilisant la syntaxe
2777 @qq{@code{:}[@var{nombre}]} ;
2780 les liaisons de prolongation ;
2783 les indications de nuance ;
2786 les crescendos et decrescendos s'étalant sur plusieurs notes ;
2789 les changements de tempo indiqués par un @code{\tempo} ;
2795 Si vous utilisez @ref{Le script Articulate}, d'autres éléments seront
2799 @item articulations (lié, staccato, etc.),
2800 @item trilles et groupettos,
2801 @item rallentando et accelerando.
2805 @unnumberedsubsubsec Éléments non pris en compte dans le MIDI
2806 @translationof Unsupported in MIDI
2808 @c TODO index as above
2810 LilyPond ne peut générer d'événement MIDI pour les éléments
2811 suivant, sauf à utiliser @ref{Le script Articulate} :
2815 le rythme indiqué sous forme d'annotation (par ex. @emph{swing}) ;
2818 les changements de tempo indiqués sous forme d'annotation (sans
2822 les staccatos et autres articulations ou ornementations ;
2825 les liaisons d'articulation et de phrasé ;
2828 les crescendos ou decrescendos sur une seule note ;
2831 les trémolos indiqués par la syntaxe @qq{@code{:}[@var{nombre}]} ;
2837 les accords en microtonalité.
2841 @node Répétitions et MIDI
2842 @subsection Répétitions et MIDI
2843 @translationof Repeats in MIDI
2845 @cindex reprises développées
2846 @cindex MIDI et reprises
2847 @funindex \unfoldRepeats
2849 Au prix de quelques réglages, les reprises de toutes sortes peuvent être
2850 rendues dans le fichier MIDI. Il suffit pour cela de recourir à la
2851 fonction @code{\unfoldRepeats}, qui développe toutes les reprises. En
2852 d'autre termes, @code{\unfoldRepeats} transforme toutes les reprises
2853 en reprises de type @code{unfold}.
2856 @lilypond[quote,verbatim]
2858 \repeat tremolo 8 {c'32 e' }
2859 \repeat percent 2 { c''8 d'' }
2860 \repeat volta 2 {c'4 d' e' f'}
2869 Dans une partition comportant plusieurs voix, le développement des
2870 reprises ne sera effectif en MIDI qu'à la condition que ces reprises
2871 soient mentionnée correctement dans @strong{toutes} les voix.
2873 Lorsque l'on veut utiliser @code{\unfoldRepeats} seulement pour le rendu
2874 MIDI, il faut établir deux blocs @code{\score} : un pour le MIDI,
2875 avec des reprises explicites, et l'autre pour la partition, avec des
2876 reprises notées sous forme de barres de reprise, de trémolo ou de
2877 symboles de pourcentage. Par exemple
2885 \unfoldRepeats @var{..musique..}
2891 @node Gestion des nuances en MIDI
2892 @subsection Gestion des nuances en MIDI
2893 @translationof Controlling MIDI dynamics
2895 Les nuances MIDI sont générées par le @code{Dynamic_performer}, affecté
2896 par défaut au contexte @code{Voice}. Vous pouvez contrôler à la fois le
2897 volume général, celui des indications de nuance ainsi que celui des
2898 différents instruments.
2901 @unnumberedsubsubsec Indications de nuance
2902 @translationof Dynamic marks
2904 Les indications de nuances sont transcrites en fraction du volume MIDI.
2905 Nous allons, par défaut, de 0,25 pour un @notation{ppppp} à 0,95 pour un
2906 @notation{fffff}. Les correspondances entre nuance et fraction de
2907 volume sont répertoriées dans le fichier @file{../scm/midi.scm} --
2908 consultez la rubrique @rlearning{Autres sources de documentation} si
2909 vous ne savez comment le localiser. Vous pouvez modifier ou étendre ce
2910 jeu grâce à une fonction qui prendra en argument une indication de
2911 nuance et renverra la fraction désirée, puis en affectant cette fonction
2912 à @code{Score.dynamicAbsoluteVolumeFunction}.
2914 Prenons un exemple. Votre partition comporte un @notation{rinforzando}
2915 que vous avez indiqué par @code{\rfz}. Cette indication de nuance
2916 n'étant pas répertoriée dans le jeu par défaut, elle ne produira aucun
2917 effet en MIDI. Il en sera d'ailleurs de même pour toute indication
2918 créée de toute pièce à l'aide de l'instruction
2919 @w{@code{make-dynamic-script}}. Voici comment procéder pour ajuster le
2920 volume MIDI de ce @notation{rinforzando} que le compositeur a indiqué.
2921 La fonction Scheme définit une fraction de 0,9 en cas de @notation{rfz},
2922 et demande d'utiliser la fonction par défaut dans les autre cas.
2924 @lilypond[verbatim,quote]
2925 #(define (myDynamics dynamic)
2926 (if (equal? dynamic "rfz")
2928 (default-dynamic-absolute-volume dynamic)))
2932 \set Staff.midiInstrument = #"cello"
2933 \set Score.dynamicAbsoluteVolumeFunction = #myDynamics
2945 Si vous étiez amené à devoir modifier l'intégralité du jeu des
2946 correspondances, nous vous conseillons d'utiliser la procédure
2947 @command{default-dynamic-absolute-volume} contenue dans le fichier
2948 @file{../scm/midi.scm} ainsi que la table d'association comme base.
2949 Le dernier exemple de cette partie illustre la manière de procéder.
2952 @unnumberedsubsubsec Amplitude du volume en MIDI
2953 @translationof Overall MIDI volume
2955 Les valeurs extrêmes du volume MIDI des nuances se contrôlent à l'aide
2956 des propriétés @code{midiMinimumVolume} et @code{midiMaximumVolume} qui
2957 agissent au niveau @code{Score}. Ces propriétés sont effectives dès
2958 lors qu'une nuance est indiquée ; une nuance de départ est donc
2959 requise pour que le volume soit ajusté dès le début de la partition.
2960 Vous pouvez alors modifier la fraction correspondant à chaque nuance à
2961 l'aide de la formule
2964 midiMinimumVolume + (midiMaximumVolume - midiMinimumVolume) * fraction
2967 Voici comment ajuster les nuances tout en limitant l'amplitude du volume
2970 @lilypond[verbatim,quote]
2976 \set Staff.midiInstrument = #"flute"
2977 \new Voice \relative c''' {
2985 \set Staff.midiInstrument = #"clarinet"
2986 \new Voice \relative c'' {
2997 tempoWholesPerMinute = #(ly:make-moment 72 2)
2998 midiMinimumVolume = #0.2
2999 midiMaximumVolume = #0.5
3006 @unnumberedsubsubsec Égalisation de plusieurs instruments (i)
3007 @translationof Equalizing different instruments (i)
3009 La définition de l'amplitude du volume MIDI au niveau d'un contexte
3010 @code{Staff} permet de gérer les volumes relatifs entre les différents
3011 instruments. Ceci constitue en quelque sorte un égaliseur, ce qui
3012 permet d'améliorer notablement la qualité de la sortie MIDI.
3014 La clarinette de l'exemple suivant jouera relativement moins fort que la
3015 flûte. Rappelez-vous que pour que cela fonctionne correctement, la
3016 première note de chacun des instruments doit être affublée d'une
3017 indication de nuance.
3019 @lilypond[verbatim,quote]
3025 \set Staff.midiInstrument = #"flute"
3026 \set Staff.midiMinimumVolume = #0.7
3027 \set Staff.midiMaximumVolume = #0.9
3028 \new Voice \relative c''' {
3036 \set Staff.midiInstrument = #"clarinet"
3037 \set Staff.midiMinimumVolume = #0.3
3038 \set Staff.midiMaximumVolume = #0.6
3039 \new Voice \relative c'' {
3054 @unnumberedsubsubsec Égalisation de plusieurs instruments (ii)
3055 @translationof Equalizing different instruments (ii)
3057 Lorsque les propriétés volume minimum et maximum n'ont pas été définies,
3058 LilyPond appliquera par défaut une légère égalisation pour quelques
3059 instruments. Les instrument concernés ainsi que le niveau d'égalisation
3060 sont répertoriés dans une table @notation{instrument-equalizer-alist}
3061 du fichier @file{../scm/midi.scm}.
3063 Vous pouvez remplacer l'égaliseur basique en définissant une nouvelle
3064 procédure Scheme @code{instrumentEqualizer} au sein du contexte
3065 @code{Score}. Cette procédure prend en unique argument le nom d'un
3066 instrument MIDI et renverra une paire de fractions correspondant au
3067 minimum et maximum de volume alloué à cet instrument. Cette
3068 substitution fonctionne selon le même principe que celui que nous avons
3069 vu en début de chapitre avec @code{dynamicAbsoluteVolumeFunction}.
3070 L'égaliseur par défaut, @notation{default-instrument-equalizer}, est
3071 défini dans le fichier @file{../scm/midi.scm} ; son analyse vous
3072 aidera à construire votre propre procédure.
3074 Nous allons, dans l'exemple suivant, régler le volume relatif de la
3075 flûte et de la clarinette -- au même niveau que dans le précédent.
3077 @lilypond[verbatim,quote]
3078 #(define my-instrument-equalizer-alist '())
3080 #(set! my-instrument-equalizer-alist
3083 ("flute" . (0.7 . 0.9))
3084 ("clarinet" . (0.3 . 0.6)))
3085 my-instrument-equalizer-alist))
3087 #(define (my-instrument-equalizer s)
3088 (let ((entry (assoc s my-instrument-equalizer-alist)))
3097 \set Score.instrumentEqualizer = #my-instrument-equalizer
3098 \set Staff.midiInstrument = #"flute"
3099 \new Voice \relative c''' {
3107 \set Staff.midiInstrument = #"clarinet"
3108 \new Voice \relative c'' {
3123 @c Delete when satisfied this is adequately covered elsewhere -td
3125 @n ode Microtones in MIDI
3126 @s ubsection Microtones in MIDI
3128 @cindex microtones in MIDI
3130 Microtones consisting of half sharps and half flats are exported
3131 to the MIDI file and render correctly in MIDI players which support
3132 pitch bending. See @ref{Note names in other languages}. Here is
3133 an example showing all the half sharps and half flats. It can be
3134 copied out and compiled to test microtones in your MIDI player.
3136 @lilypond[verbatim,quote]
3153 @node MIDI et percussions
3154 @subsection MIDI et percussions
3155 @translationof Percussion in MIDI
3157 La notation pour percussions recourt généralement à un contexte
3158 particulier -- le @code{DrumStaff} -- qui permet d'affecter directement
3159 les instruments concernés au canal 10 qui leur est réservé.
3161 Certains instruments, tels le xylophone, le marimba, le vibraphone ou
3162 les timbales, se traitent cependant comme des instruments
3163 @qq{classiques} puisqu'ils sont capables d'émettre des hauteurs
3164 différentes ; leurs notation relève donc d'un contexte @code{Staff}
3165 standard, et non d'un @code{DrumStaff} pour pouvoir être rendus
3166 correctement en MIDI.
3168 D'autres percussions, bien que n'émettant qu'un seul son et inclus dans
3169 le standard @emph{general MIDI}, comme le tom mélodique ou le tambour
3170 taiko, ne sont pas attachés au canal 10. Ces instruments doivent
3171 donc être saisi dans un contexte @code{Staff}, en utilisant la hauteur
3174 De nombreux instruments de la famille des percussions, les castagnettes
3175 par exemple, n'existent pas dans le standard @emph{general MIDI}.
3176 L'alternative, bien que peu satisfaisante, consiste à leur attribuer le
3177 son le plus proche dans la banque standard.
3179 @c TODO Expand with examples, and any other issues
3182 Le standard @emph{general MIDI} ne dispose pas du @emph{rim shot} ;
3183 LilyPond lui substitue un @emph{sidestick}.
3186 @node Le script Articulate
3187 @subsection Le script Articulate
3188 @translationof The Articulate script
3190 Vous obtiendrez un rendu MIDI plus @qq{réaliste} grâce au script
3191 @code{articulate}. Celui-ci va tout faire pour d'une part prendre en
3192 compte les articulations (liaisons, staccato etc.) -- en ajoutant un
3193 blanc aux notes raccourcies -- et, d'autre part, développer les trilles
3194 ou groupettos ainsi que tenir compte des éventuels rallentando et
3197 L'utilisation du script @code{articulate} se fait en deux temps. Vous
3198 devez dans un premier temps inclure son fichier d'initialisation en
3199 ajoutant en tête de votre fichier la ligne
3202 \include "articulate.ly"
3205 puis, dans le bloc @code{\score}, indiquer que toutes les répétitions
3206 seront développées et appliquer la commande à votre musique :
3209 \unfoldRepeats \articulate <<
3210 tout le reste du bloc contenant la partition...
3214 Une fois votre fichier modifié de la sorte, vous constaterez que la
3215 version imprimable aura été modifiée en profondeur. Le bloc
3216 @code{\midi} produira par contre un fichier MIDI de bien meilleure
3219 Bien que cela ne gène en rien le fonctionnement du script
3220 @code{articulate}, lui adjoindre la commande @code{\unfoldRepeats} comme
3221 illustré ci-dessus permettra le rendu d'un certain nombre
3222 d'articulations tels les trilles.
3225 Dans la mesure où le script @code{articulate} tend à raccourcir les
3226 accords, certaines musiques, notamment pour l'orgue, paraîtront de moins
3230 @node Extraction d'informations musicales
3231 @section Extraction d'informations musicales
3232 @translationof Extracting musical information
3234 En plus de générer du graphisme et du MIDI, LilyPond peut présenter
3235 l'information musicale sous forme textuelle.
3238 * Affichage de notation au format LilyPond::
3239 * Affichage de la musique sous forme d'expression Scheme::
3240 * Enregistrement d'événements musicaux dans un fichier::
3244 @node Affichage de notation au format LilyPond
3245 @subsection Affichage de notation au format LilyPond
3246 @translationof Displaying LilyPond notation
3248 @funindex \displayLilyMusic
3250 La fonction musicale @code{\displayLilyMusic} permet d'afficher en
3251 notation LilyPond une expression musicale. Le résultat défilera dans le
3252 terminal après avoir lancé LilyPond en ligne de commande. Par exemple,
3256 \displayLilyMusic \transpose c a, @{ c4 e g a bes @}
3263 @{ a,4 cis e fis g @}
3266 LilyPond affichera le résultat sous forme de message en console, au
3267 milieu de toutes les informations de compilation. Afin d'isoler ces
3268 messages et enregistrer le résultat de la fonction
3269 @code{\display@{MATÉRIAU@}}, pensez à rediriger la sortie vers un
3273 lilypond fichier.ly > affichage.txt
3278 Vous noterez que LilyPond ne se contente pas de simplement afficher
3279 l'expression musicale, mais procède aussi à son interprétation -- du
3280 fait que @code{\displayLilyMusic} renvoie l'expression tout en
3281 l'affichant. S'il est bien pratique d'insérer un
3282 @code{\displayLilyMusic} dans une expression musicale pour en obtenir
3283 des informations, l'interprétation de cette expression peut toutefois
3284 être évitée en ajoutant un @code{\void} avant l'instruction :
3288 \void \displayLilyMusic \transpose c a, @{ c4 e g a bes @}
3293 @node Affichage de la musique sous forme d'expression Scheme
3294 @subsection Affichage de la musique sous forme d'expression Scheme
3295 @translationof Displaying scheme music expressions
3297 Voir @rextend{Affichage d'expressions musicales}.
3300 @node Enregistrement d'événements musicaux dans un fichier
3301 @subsection Enregistrement d'événements musicaux dans un fichier
3302 @translationof Saving music events to a file
3304 LilyPond vous permet de sauvegarder dans un fichier séparé, sur la base
3305 de la portée, les événements musicaux. Vous devrez pour ce faire
3306 inclure dans votre fichier maître un fichier d'initialisation
3310 \include "event-listener.ly"
3313 Pour chaque portée que comporte votre partition, vous obtiendrez un
3314 fichier @file{NOMFICHIER-PORTÉENOMMÉE.notes} ou
3315 @file{NOMFICHIER-unnamed-staff.notes}. Notez bien que si plusieurs
3316 portées ne sont pas explicitement nommées, tous leurs événements seront
3317 regroupés et mélangés dans le même fichier. Le résultat ressemblera à
3321 0.000 note 57 4 p-c 2 12
3323 0.250 note 62 4 p-c 7 12
3324 0.500 note 66 8 p-c 9 12
3325 0.625 note 69 8 p-c 14 12
3330 Il s'agit d'un tableau dont les colonnes sont délimitées par une
3331 tabulation. Chaque ligne comporte deux champs fixes suivis d'un certain
3332 nombre de paramètres optionnels.
3335 @var{temps} @var{type} @var{...paramètres...}
3338 Ces informations peuvent faire l'objet d'un retraitement par d'autres
3339 programmes, comme des scripts python, aux fins de recherche en analyse
3340 musicologique ou des expériences à partir du rendu de LilyPond.
3343 Tous les événements ne sont pas pris en charge par
3344 @file{event-listener.ly}. Il s'agit en premier lieu d'une
3345 démonstration, un @qq{proof of concept} du potentiel de LilyPond. Si
3346 certains des éléments que vous cherchez à obtenir n'apparaissent pas,
3347 recopiez le fichier @file{event-listener.ly} dans votre répertoire et
3348 modifiez-le de telle sorte qu'il travaille selon vos attentes.