1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
3 Translation of GIT committish: c610645cc9a77cba1a2798280965db142d649ac5
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@tie{}:
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@tie{}:
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@tie{}: 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@tie{}: 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
183 @code{\score}@tie{}; le contenu du champ @code{piece} viendra s'imprimer
184 avant chaque mouvement. De même, le titre de l'ouvrage peut se placer
185 au sein du 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}@tie{}:
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@tie{}:
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'expression de
366 haut niveau. Les expressions de haut niveau sont les suivantes@tie{}:
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, la dernière aura préséance.
376 Une expression Scheme pure, telle que
377 @w{@code{#(set-default-paper-size@tie{}"a7"@tie{}'landscape)}} ou
378 @w{@code{#(ly:set-option@tie{}'point-and-click@tie{}#f)}}.
381 Un bloc @code{\header}, dont le contenu sera de portée globale -- ce qui
382 est le cas en général pour le titre ou l'auteur entre autres.
385 Un bloc @code{\score} pour la partition. Cette partition sera assemblée
386 avec les autres partitions se trouvant au même niveau pour composer le
387 @code{\book}. Vous pouvez modifier ce comportement à l'aide de la
388 variable @code{toplevel-score-handler} placée en tête.
390 @c FIXME - I cannot read "toplevel-score-handler" in scm/lily.scm -jcm
391 The default handler is defined in the init file @file{../scm/lily.scm}.
395 Un bloc @code{\book} permet de regrouper naturellement plusieurs
396 mouvements -- autrement dit plusieurs blocs @code{\score} -- dans un
397 même document. Lorsqu'il y a plusieurs @code{\score}s, LilyPond génère
398 un seul fichier dans lequel les mouvements sont mis les uns à la suite
399 des autres, ce pour chacun des blocs @code{\book} rencontrés. La seule
400 raison qui peut vous demander d'expliciter plusieurs blocs @code{\book}
401 dans un fichier @file{.ly} est lorsque vous avez besoin de générer
402 différents documents à partir d'une même source. La présence explicite
403 d'un bloc @code{\book} est aussi nécessaire lorsque vous travaillez sur
404 un document lilypond-book qui reprendrait plusieurs @code{\score}s ou
405 @code{\markup}s dans un même extrait. Vous pouvez modifier ce
406 comportement à l'aide de la variable @code{toplevel-book-handler}
409 @c FIXME - I cannot read "toplevel-book-handler" in scm/lily.scm -jcm
410 The default handler is defined in the init file @file{../scm/lily.scm}.
414 Un bloc @code{\bookpart}. Un ouvrage peut se découper en plusieurs
415 parties à l'aide de blocs @code{\bookpart}, aussi bien pour alléger le
416 travail de l'algorithme de calcul des sauts de page, que si les réglages
417 du bloc @code{\paper} diffèrent d'une partie à l'autre.
420 Une expression musicale telle que
425 Ce bout de code sera placé dans un @code{\score} et intégré à l'ouvrage
426 en même temps que tous les autres @code{\score}s ou expressions
427 musicales. En d'autres termes, un fichier qui ne contiendrait que cette
428 simple expression musicale sera traduit en
445 Vous pouvez modifier ce comportement à l'aide de la variable
446 @code{toplevel-music-handler} placée en tête.
448 @c FIXME - I cannot read "toplevel-music-handler" in scm/lily.scm -jcm
449 The default handler is defined in the init file @file{../scm/lily.scm}.
453 Du texte sous forme de @emph{markup} comme les paroles d'un couplet
456 2. Le première ligne du deuxième couplet.
460 De tels @emph{markups} seront imprimés là où ils apparaissent,
461 avant, après ou entre les expressions musicales.
464 @cindex identificateurs
467 Une variable, ou identificateur, telle que
469 toto = @{ c4 d e d @}
472 Vous pourrez la réutiliser plus loin dans votre fichier en saisissant
473 simplement @code{\toto}. Le nom des identificateurs ne doit être
474 formés que de caractères alphabétiques -- sans chiffre ni caractère
479 Voici trois éléments que vous pouvez placer à un niveau supérieur@tie{}:
483 % pas en pleine largeur
494 Vous pouvez placer, n'importe où dans votre fichier, les instructions
498 @item @code{\version}
499 @item @code{\include}
500 @item @code{\sourcefilename}
501 @item @code{\sourcefileline}
503 Une ligne de commentaire, introduite par le signe @code{%}.
506 Un bloc de commentaire, délimité par @code{%@{ .. %@}}.
513 Vous pouvez insérer des espaces dans votre fichier source afin de lui
514 apporter une meilleure lisibilité. Les espaces superflus sont
515 normalement ignorés. Notez cependant qu'il est des cas où l'espace est
516 requis pour éviter tout risque d'erreur@tie{}:
520 Autour d'une accolade, qu'elle soit ouvrant ou fermante ;
523 Après chaque commande ou variable, autrement dit tout élément qui
524 commence par un@tie{}@code{\}@tie{};
527 Après tout élément qui sera interprété comme une expression Scheme,
528 autrement dit tout élément qui commence par un @code{#}@tie{};
531 Pour séparer les éléments d'une expression Scheme ;
534 En mode parole -- @code{lyricmode} -- pour séparer les termes des
535 commandes @code{\override} et @code{\set}. Précisons à ce sujet qu'en
536 plus d'ajouter une espace avant et après l'intégralité de la commande,
537 vous devrez encadrer d'espaces le point et le signe égal qu'elle peut
539 @w{@code{\override Score . LyricText #'font-size = #5}}.
544 Manuel d'initiation :
545 @rlearning{Organisation des fichiers LilyPond}.
548 @node Titres et entêtes
549 @section Titres et entêtes
550 @translationof Titles and headers
552 La plupart de la musique qui est éditée comporte un titre et le nom de
553 son compositeur@tie{}; certains ouvrages divulguent beaucoup plus
557 * Création de titres et entête ou pied de page::
558 * Titrages personnalisés::
559 * Notes de bas de page::
560 * Référencement des numéros de page::
561 * Table des matières::
565 @node Création de titres et entête ou pied de page
566 @subsection Création de titres et entête ou pied de page
567 @translationof Creating titles headers and footers
570 * Contenu des blocs de titrage::
571 * Mise en forme par défaut des titrages::
572 * Mise en forme par défaut des entête et pied de page::
576 @node Contenu des blocs de titrage
577 @unnumberedsubsubsec Contenu des blocs de titrage
578 @translationof Title blocks explained
580 @c TODO: figure out how \bookpart titles work
582 Il existe en fait deux types de blocs de titrage@tie{}: un bloc pour
583 contenir le titre principal qui doit apparaître avant le tout premier
584 @code{\score} d'un ouvrage, et un autre attaché à chacun des blocs
585 @code{\score} qui le composent. Dans les deux cas, les champs qui
586 composent un bloc de titrage se saisissent dans un bloc @code{\header}.
588 Lorsque l'ouvrage ne comporte qu'un seul morceau, le bloc @code{\header}
589 peut se placer en dehors ou au sein même du bloc @code{\score}.
591 Dans le cas où le bloc @code{\header} est défini à l'intérieur du bloc
592 @code{\score}, seuls les champs @code{piece} et @code{opus} seront
595 @lilypond[papersize=a5,quote,verbatim,noragged-right]
599 title = "title" % not printed
606 @funindex print-all-headers
608 Vous pouvez modifier ce comportement et imprimer tous les champs d'un
609 bloc @code{\header} défini dans un bloc @code{\score} en ajoutant
613 print-all-headers = ##t
617 @warning{N'oubliez pas que lorsqu'il est placé à l'intérieur d'un bloc
618 @code{@bs{}score}, le bloc @code{@bs{}header} doit impérativement se
619 trouver @strong{à la suite} de l'expression musicale.}
621 @lilypond[papersize=a5,quote,verbatim,noragged-right]
624 composer = "J. S. Bach."
628 \new Staff \relative g, {
631 \repeat unfold 2 { g16( d' b') a b d, b' d, } |
632 \repeat unfold 2 { g,16( e' c') b c e, c' e, } |
640 \new Staff \relative b {
644 <g, d' b'~>4 b'16 a( g fis) g( d e fis) g( a b c) |
645 d16( b g fis) g( e d c) b(c d e) fis( g a b) |
653 Tous les champs appartenant au titrage principal d'un ouvrage peuvent se
654 reporter dans chaque bloc @code{\score} ou être supprimés
658 @lilypond[papersize=a5,quote,verbatim,noragged-right]
661 print-all-headers = ##t
664 title = "DAS WOHLTEMPERIRTE CLAVIER"
666 % Pas de mention spéciale pour cet ouvrage
669 \markup { \vspace #1 }
673 \new Staff { \clef "bass" s1 }
676 title = "PRAELUDIUM I"
678 % Pas de sous-titre pour ce morceau
685 \new Staff { \clef "bass" s1 }
689 subsubtitle = "A 4 VOCI"
691 % Pas de sous-titre pour ce morceau
700 @ref{Structure de fichier},
701 @ref{Mise en forme personnalisée des blocs de titrage}.
704 @node Mise en forme par défaut des titrages
705 @unnumberedsubsubsec Mise en forme par défaut des titrages
706 @translationof Default layout of book and score title blocks
708 La mise en forme des blocs de titrage est contrôlée par deux variables
709 attachées au bloc @code{\paper}@tie{}: @code{bookTitleMarkup} pour le
710 bloc @code{\header} principal, et @code{scoreTitleMarkup} pour les blocs
711 @code{\header} relevant des blocs @code{\score}.
714 @lilypond[papersize=a6,quote,verbatim,noragged-right]
716 % Les champs suivants sont centrés
717 dedication = "Dédicace"
719 subtitle = "Sous-titre"
720 subsubtitle = "Sous-sous-titre"
721 instrument = "Instrument"
723 % Les champs suivants sont alignés par la gauche
727 % Les champs suivants sont alignés par la droite
728 composer = "Compositeur"
729 arranger = "Arrangeur"
735 % Les champs suivants sont en opposition sur la même ligne
742 @c Is the bit about \null markups true? -mp
744 Les champs d'un bloc @code{\header} qui n'auront pas été alimentés
745 seront remplacés par un @emph{markup} @code{\null} de façon à ne pas
748 Par défaut, @code{scoreTitleMarkup} place les champs @code{piece} et
749 @code{opus} de part et d'autre sur une même ligne.
753 La variable @code{breakbefore} activée dans un bloc @code{\header} situé
754 dans un bloc @code{\score} force le saut de page avant le morceau
755 contenu dans ce @code{\score}. Vous pourrez ainsi séparer le titre
756 principal de la musique.
758 @lilypond[papersize=a8landscape,verbatim,noragged-right]
761 title = "This is my Title"
762 subtitle = "This is my Subtitle"
763 copyright = "This is the bottom of the first page"
766 \repeat unfold 4 { e'' e'' e'' e'' }
768 piece = "This is the Music"
776 Manuel d'initiation :
777 @rlearning{Organisation des fichiers LilyPond}.
780 @ref{Structure de fichier}.
782 Fichiers d'initialisation :
783 @file{ly/titling-init.ly}.
786 @node Mise en forme par défaut des entête et pied de page
787 @unnumberedsubsubsec Mise en forme par défaut des entête et pied de page
788 @translationof Default layout of headers and footers
790 Les entête et pied -- @emph{headers} et @emph{footers} -- sont des
791 lignes de textes qui apparaissent en haut et en bas de chaque page,
792 indépendamment du texte de l'ouvrage. Ils sont contrôlés par les
793 variables suivantes, attachées au bloc @code{\paper}@tie{}:
796 @item @code{oddHeaderMarkup} -- entête de page impaire
797 @item @code{evenHeaderMarkup} -- entête de page paire
798 @item @code{oddFooterMarkup} -- pied de page impaire
799 @item @code{evenFooterMarkup} -- pied de page paire
802 Ces variables @emph{markup} n'accèdent qu'au contenu des champs du bloc
803 @code{\header} principal, celui qui s'appliquera à tous les blocs
804 @code{\score} du document. Ces variables sont définies dans le fichier
805 @file{ly/titling-init.ly}, et sont par défaut@tie{}:
810 les numéros sont placés en haut à gauche (si pair) ou à droite (si
811 impair) de chaque page à compter de la deuxième@tie{};
814 le contenu du champ @code{instrument} est centré en haut de chaque page
815 à compter de la deuxième@tie{};
818 le texte du @code{copyright} est centré au bas de la première
822 le @code{tagline} -- mention spéciale -- se place au bas de la dernière
823 page, ou bien sous le @code{copyright} s'il n'y a qu'une seule page.
827 @lilypond[papersize=a8landscape]
837 La mention spéciale se modifie en alimentant le champ @code{tagline} au
838 niveau du bloc @code{\header} principal.
840 @lilypond[papersize=a8landscape,verbatim]
843 tagline = "... music notation for Everyone"
853 Pour supprimer le @code{tagline}, il suffit de lui assigner la valeur
857 @node Titrages personnalisés
858 @subsection Titrages personnalisés
859 @translationof Custom headers footers and titles
861 @c TODO: somewhere put a link to header spacing info
862 @c (you'll have to explain it more in NR 4).
865 * Mise en forme personnalisée des champs de titrage::
866 * Mise en forme personnalisée des blocs de titrage::
867 * Mise en forme personnalisée des entête et pied de page::
871 @node Mise en forme personnalisée des champs de titrage
872 @unnumberedsubsubsec Mise en forme personnalisée des champs de titrage
873 @translationof Custom text formatting for title blocks
875 Toutes les commandes de mise en forme d'un @code{\markup} permettent de
876 personnaliser le texte des entête, pied de page et éléments de titre
877 contenus dans un bloc @code{\header}.
879 @lilypond[quote,verbatim,noragged-right]
883 piece = \markup { \fontsize #4 \bold "PRAELUDIUM I" }
884 opus = \markup { \italic "(Excerpt)" }
891 @ref{Mise en forme du texte}.
894 @node Mise en forme personnalisée des blocs de titrage
895 @unnumberedsubsubsec Mise en forme personnalisée des blocs de titrage
896 @translationof Custom layout for title blocks
898 L'utilisation de commandes @code{\markup} au sein d'un bloc
899 @code{\header} permet de modifier aisément l'apparence du texte,
900 mais n'influence en rien le positionnement précis des éléments de
901 titrage. L'accès au positionnement des champs de titrage est géré par
902 les deux variables suivantes, attachées au bloc @code{\paper}@tie{}:
905 @item @code{bookTitleMarkup}
906 @item @code{scoreTitleMarkup}
909 Ces variables sont abordées à la rubrique
910 @ref{Mise en forme par défaut des titrages}.
912 Voici les réglages par défaut de @code{scoreTitleMarkup}, tels que
913 définis dans le fichier @file{ly/titling-init.ly}@tie{}:
916 scoreTitleMarkup = \markup @{ \column @{
917 \on-the-fly #print-all-headers @{ \bookTitleMarkup \hspace #1 @}
919 \fromproperty #'header:piece
920 \fromproperty #'header:opus
926 Ceci aura donc pour effet de positionner les champs @code{piece} et
927 @code{opus} sur la même ligne, en opposition@tie{}:
929 @lilypond[quote,verbatim,noragged-right]
933 piece = "PRAELUDIUM I"
939 Voici comment positionner le champ @code{piece}, dont nous modifions
940 la taille et la graisse, au centre de cette ligne@tie{}:
942 @lilypond[papersize=a5,quote,verbatim,noragged-right]
946 scoreTitleMarkup = \markup {
949 \fontsize #4 \bold \fromproperty #'header:piece
950 \fromproperty #'header:opus
954 \header { tagline = ##f }
958 piece = "PRAELUDIUM I"
965 Les champs normalement réservés au bloc de titrage principal seront
966 reportés au niveau au niveau inférieur dès lors que vous aurez activé
967 l'instruction @code{print-all-headers} au sein du bloc @code{\paper}.
968 Le principal inconvénient de cette fonction réside dans le fait que les
969 champs réservés au bloc @code{\header} principal devront être supprimés
970 dans chacun des blocs @code{\score} de votre fichier source -- voir
971 @ref{Contenu des blocs de titrage}.
973 Afin d'éviter ce désagrément, ajoutez le champ que vous désirez voir
974 apparaître à la définition de @code{scoreTitleMarkup}. Nous allons,
975 dans l'exemple suivant, ajouter au @code{scoreTitleMarkup} le champ
976 @code{composer}, normalement associé au @code{bookTitleMarkup}@tie{};
977 chaque @code{\score} pourra mentionner un compositeur différent.
979 @lilypond[papersize=a5,quote,verbatim,noragged-right]
983 scoreTitleMarkup = \markup {
986 \fontsize #4 \bold \fromproperty #'header:piece
987 \fromproperty #'header:composer
991 \header { tagline = ##f }
996 composer = "Christian Petzold"
1003 composer = "François Couperin"
1009 Rien ne vous empêche de créer votre propre champ personnalisé, puis d'y
1010 faire référence dans la définition du @emph{markup}.
1012 @lilypond[papersize=a5,quote,verbatim,noragged-right]
1016 scoreTitleMarkup = \markup {
1019 \override #`(direction . ,UP) {
1021 \center-align \fontsize #-1 \bold
1022 \fromproperty #'header:mycustomtext %% User-defined field
1023 \center-align \fontsize #4 \bold
1024 \fromproperty #'header:piece
1027 \fromproperty #'header:opus
1031 \header { tagline = ##f }
1036 mycustomtext = "A 4 VOCI" %% User-defined field
1044 Manuel de notation :
1045 @ref{Contenu des blocs de titrage}.
1048 @node Mise en forme personnalisée des entête et pied de page
1049 @unnumberedsubsubsec Mise en forme personnalisée des entête et pied de page
1050 @translationof Custom layout for headers and footers
1052 @c can make-header and make-footer be removed from
1053 @c paper-defaults-init.ly? -mp
1055 L'utilisation de commandes @code{\markup} au sein d'un bloc
1056 @code{\header} permet de modifier aisément l'apparence du texte,
1057 mais n'influence en rien le positionnement précis des entête et pied
1058 de page. L'accès au positionnement des champs concernés est géré par
1059 les quatre variables suivantes, attachées au bloc @code{\paper}@tie{}:
1062 @item @code{oddHeaderMarkup}
1063 @item @code{evenHeaderMarkup}
1064 @item @code{oddFooterMarkup}
1065 @item @code{evenFooterMarkup}
1068 L'exemple suivant illustre la manière de centrer son numéro au bas de
1069 chaque page. Il nous faut tout d'abord annuler la définition de
1070 @code{oddHeaderMarkup} et @code{evenHeaderMarkup} à l'aide d'un
1071 @emph{markup} @code{\null}. Nous redéfinissons ensuite
1072 @code{oddFooterMarkup} pour qu'il contienne le numéro de page, centré.
1073 Enfin, nous appliquons le même paramétrage au @code{\oddFooterMarkup}.
1075 @lilypond[papersize=a8,quote,verbatim,noragged-right]
1078 print-page-number = ##t
1079 print-first-page-number = ##t
1080 oddHeaderMarkup = \markup \null
1081 evenHeaderMarkup = \markup \null
1082 oddFooterMarkup = \markup {
1084 \on-the-fly #print-page-number-check-first
1085 \fromproperty #'page:page-number-string
1088 evenFooterMarkup = \oddFooterMarkup
1091 \new Staff { s1 \break s1 \break s1 }
1097 Manuel de notation :
1098 @ref{Contenu des blocs de titrage},
1099 @ref{Mise en forme par défaut des titrages}.
1102 @node Notes de bas de page
1103 @subsection Notes de bas de page
1104 @translationof Creating footnotes
1106 LilyPond dispose de deux méthodes pour créer des notes de bas de page,
1107 l'une automatisée, et l'autre manuelle.
1110 * Considérations générales en matière de note de bas de page::
1111 * Notes de bas de page automatiques::
1112 * Notes de bas de page manuelles::
1116 @node Considérations générales en matière de note de bas de page
1117 @unnumberedsubsubsec Considérations générales en matière de note de bas de page
1118 @translationof Footnotes overview
1120 Il est parfois judicieux, notamment lorsqu'une annotation ou un
1121 commentaire gênerait la lecture de la partition, de les reporter en bas
1124 Les notes de bas de page automatiques font appel à un compteur
1125 numérique incrémenté automatiquement@tie{}; les notes de bas de page
1126 manuelles vous laissent le libre choix de l'appel (l'indicateur). Tout
1127 objet graphique, @code{\markup} de haut niveau ou les notes d'un accord
1128 peuvent faire l'objet d'une annotation.
1130 L'ordre dans lequel les objets seront dessinés détermine l'ordre des
1131 appels et comment les annotations seront créées lors de la compilation.
1134 @node Notes de bas de page automatiques
1135 @unnumberedsubsubsec Notes de bas de page automatiques
1136 @translationof Automatic footnotes
1138 @cindex note de bas de page automatique
1139 @cindex bas de page, note automatique
1143 La commande @code{\footnote} permet de générer automatiquement des notes
1144 de bas de page. Elle requiert trois arguments@tie{}: l'@var{Objet de
1145 Rendu} auquel s'applique le commentaire rapporté en bas de page, la
1146 position @samp{(x@tie{}.@tie{}y)} de l'appel de note, et enfin un
1147 @code{\markup} contenant l'annotation qui apparaîtra en bas de la page.
1149 La commande @code{\footnote} doit être mentionnée @strong{avant}
1150 l'objet auquel la note est attachée.
1153 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1155 \header { tagline = ##f }
1157 <>\footnote #'(0.5 . -2) #'NoteHead
1158 \markup { La première note }
1160 <>\footnote #'(0.5 . 1) #'NoteHead
1161 \markup { La troisième note }
1167 Lorsqu'il s'agit de notes inscrites dans un accord, la commande
1168 @code{\footnote} doit être mentionnée @strong{après} la note à laquelle
1169 le @code{TextScript} fait référence.
1172 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1174 \header { tagline = ##f }
1177 c\footnote #'(1 . -1.25) "Voici un do"
1178 es\footnote #'(2 . -0.25) \markup { \italic "Un mi bémol" }
1179 g\footnote #'(2 . 3) \markup { \bold "Ceci est un sol" }
1185 @warning{Lorsque plusieurs notes de bas de page se rapportent à un même
1186 empilement vertical, les notes apparaîtront dans l'ordre vertical des
1187 appels, autrement dit celui positionné le plus haut en premier, et ainsi
1190 Voici quelques exemples d'objets annotés automatiquement. Vous pouvez
1191 constater l'agencement des annotations correspondantes avec le copyright
1194 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1196 \header { copyright = \markup { "Copyright 1970" } }
1198 <>\footnote #'(-3 . 0) #'DynamicText
1199 \markup { \bold Forte }
1201 <>\footnote #'(0 . 1.5) #'Slur
1205 <>\footnote #'(0 . -2) #'Beam
1209 <>\footnote #'(1 . -1) #'Stem
1210 \markup { \teeny { This is a stem } }
1213 <>\footnote #'(0 . 0.5) #'AccidentalCautionary
1214 \markup \italic { A cautionary accidental }
1216 <>\footnote #'(0.5 . -0.5) #'TextScript
1217 \markup \italic { Slow Down }
1223 Une note de bas de page affectant un @code{\markup} de haut niveau
1224 s'introduit par la commande @code{\auto-footnote}@tie{}:
1226 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1228 \header { tagline = ##f }
1229 \markup { \auto-footnote "A simple tune" \italic "By me" }
1237 @node Notes de bas de page manuelles
1238 @unnumberedsubsubsec Notes de bas de page manuelles
1239 @translationof Manual footnotes
1241 @cindex note de bas de page manuelle
1242 @cindex bas de page, note manuelle
1245 @funindex \footnoteGrob
1247 LilyPond permet aussi de créer des notes de bas de page manuelles@tie{}:
1248 la commande @code{\footnote} prend alors quatre arguments@tie{}:
1249 l'@var{Objet de Rendu} devant être annoté, la position
1250 @samp{(x@tie{}.@tie{}y)} de l'appel de note, et deux @code{\markup} --
1251 le premier contient l'appel qui s'attache à la note ou à l'objet
1252 référencé, le second contient l'annotation qui est reportée en bas de
1255 Tout comme dans le cas d'une note de bas de page automatique, la commande
1256 @code{\footnote} doit être mentionnée comme s'il s'agissait d'une
1257 articulation, donc @strong{avant} l'objet auquel l'annotation fait
1260 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1262 \header { tagline = ##f }
1265 "1" #'(0.5 . -2) #'NoteHead \markup { \italic "1. The first note" }
1268 \markup { \bold "2" } #'(0.5 . 1) #'NoteHead "2. The second note"
1270 d\p\footnote "3" #'(0.5 . -1) #'DynamicText "3. Piano"
1275 S'agissant d'annoter l'une des notes d'un accord, la commande
1276 @code{\footnote} doit être mentionnée @strong{après} la note à laquelle
1277 l'annotation fait référence, comme s'il s'agissait d'une articulation.
1279 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1281 \header { tagline = ##f }
1284 c\footnote "1" #'(1 . -1.25) "1. C"
1286 \markup { \bold "b" } #'(2 . -0.25) "b. E-flat"
1287 g\footnote "3" #'(2 . 3) \markup { \italic "iii. G" }
1293 @warning{Lorsque plusieurs notes de bas de page se rapportent à un même
1294 empilement vertical, les notes apparaîtront dans l'ordre vertical des
1295 appels, autrement dit celui positionné le plus haut en premier, et ainsi
1298 Voici quelques exemples d'objets annotés manuellement. Vous pouvez
1299 constater l'agencement des annotations correspondantes avec le copyright
1302 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1304 \header { tagline = ##f }
1307 \markup { \teeny 1 } #'(-3 . 0) #'DynamicText
1308 \markup { 1. \bold Forte }
1311 \markup { \teeny b } #'(0 . 1.5) #'Slur
1312 \markup { b. A slur }
1316 \markup { \teeny 3 } #'(0 . -2) #'Beam
1321 \markup { 4 } #'(1 . -1) #'Stem
1322 \markup { \bold 4. { This is a stem } }
1326 \markup \concat \teeny { "sharp (v)" }
1327 #'(0 . 0.5) #'AccidentalCautionary
1328 \markup \italic { v. A cautionary accidental }
1331 \markup \concat \teeny { "a" } #'(0.5 . -0.5) #'TextScript
1332 \markup \italic { a. Slow Down }
1337 \markup { \teeny \musicglyph #"rests.4" }
1338 #'(1.5 . -0.25) #'BreathingSign
1344 L'annotation manuelle d'un @code{\markup} de haut niveau répond à la
1345 syntaxe suivante@tie{}:
1347 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1349 \header { tagline = ##f }
1350 \markup { "A simple tune" \footnote "*" \italic "* By me" }
1358 Manuel d'initiation :
1359 @rlearning{Objets et interfaces}.
1361 Manuel de notation :
1362 @ref{Commentaires textuels},
1363 @ref{Indications textuelles},
1365 @ref{Mise en forme de la page},
1366 @ref{Titres et entêtes}.
1368 Référence des propriétés internes :
1369 @rinternals{FootnoteEvent},
1370 @rinternals{FootnoteItem},
1371 @rinternals{FootnoteSpanner},
1372 @rinternals{Footnote_engraver}.
1375 Un silence multimesures ne peut se voir affecter une note de bas de
1378 Les notes de bas de page ne peuvent que s'empiler l'une au-dessus de
1379 l'autre@tie{}; elles ne seront jamais présentées à la queue leu leu.
1380 Les notes de bas de page peuvent générer des chevauchements quand elles
1381 sont trop nombreuses sur une même page.
1383 Dès lors que vous utilisez une commande de note de bas de page manuelle,
1384 le bloc @code{\paper} doit contenir la mention
1385 @w{@code{footnote-auto-number@tie{}=@tie{}##f}}.
1388 @node Référencement des numéros de page
1389 @subsection Référencement des numéros de page
1390 @translationof Reference to page numbers
1392 LilyPond vous permet, à l'aide de la commande @code{\label}, d'insérer
1393 des points de référence dans un ouvrage, aussi bien en dehors qu'au fil
1394 de la musique. Ce point de référence pourra être ensuite repris à
1395 l'intérieur d'un @emph{markup}@tie{}; vous pourrez même y ajouter le
1396 numéro de page grâce à la commande de @emph{markup} @code{\page-ref}.
1400 \header { tagline = ##f }
1406 \pageBreak \mark A \label #'markA
1411 \markup { Le premier mouvement débute à la page \page-ref #'firstScore "0" "?" }
1412 \markup { Le repère A est à la page \page-ref #'markA "0" "?" }
1416 L'instruction @code{\page-ref} prend trois arguments@tie{}:
1419 le point de référence, sous la forme d'un symbole Scheme, comme par
1420 exemple @code{#'firstScore},
1423 un @qq{emporte-pièce} afin d'estimer la longueur totale du
1427 un texte de remplacement au cas où la référence ne serait pas retrouvée.
1430 La présence de l'emporte-pièce est rendue nécessaire par le fait que les
1431 @emph{markups} sont générés avant que les sauts de page ne soient
1432 positionnés. Bien que le numéro de page en question ne soit pas encore
1433 déterminé, LilyPond doit connaître les dimensions de ce @emph{markup}.
1434 Vous pouvez, lorsque l'ouvrage contiendra plus de dix pages, stipuler un
1435 emporte-pièce sur deux caractères -- soit @code{"00"}.
1445 @node Table des matières
1446 @subsection Table des matières
1447 @translationof Table of contents
1449 La commande @code{\markuplist \table-of-contents} vous permettra de
1450 générer une table des matières. Les éléments qui la composeront sont
1451 créés par la commande @code{\tocItem}, insérée indépendamment ou au sein
1452 d'une expression musicale.
1455 \markuplist \table-of-contents
1458 \tocItem \markup "Premier mouvement"
1462 \tocItem \markup "Passage spécifique du premier mouvement"
1467 \tocItem \markup "Second mouvement"
1475 Les @emph{markups} dévolus à la mise en forme de la table des matières
1476 se définissent dans le bloc @code{\paper}. Il s'agit par défaut de
1477 @code{tocTitleMarkup} pour le titre de la table, et de
1478 @code{tocItemMarkup} pour ses éléments -- composés de leur libellé et
1479 numéro de page. Vous pouvez bien entendu personnaliser ces
1484 %% Translate the toc title into French:
1485 tocTitleMarkup = \markup \huge \column {
1486 \fill-line { \null "Table des matières" \null }
1489 %% use larger font size
1490 tocItemMarkup = \markup \large \fill-line {
1491 \fromproperty #'toc:text \fromproperty #'toc:page
1496 Notez bien la manière de référencer le libellé et le numéro de page dans
1497 la définition de @code{tocItemMarkup}.
1499 N'hésitez pas à définir vous-même d'autres commandes et @emph{markups}
1500 afin de construire une table plus élaborée@tie{}:
1503 commencez par définir une nouvelle variable de type @code{markup} au
1504 sein du bloc @code{\paper},
1507 puis définissez une fonction musicale chargée d'insérer un élément de la
1508 table à partir de cette variable.
1511 Dans l'exemple qui suit, nous avons créé un nouveau style d'élément dans
1512 le but de mentionner les actes dans la table des matières d'un
1517 tocActMarkup = \markup \large \column {
1519 \fill-line { \null \italic \fromproperty #'toc:text \null }
1525 #(define-music-function (parser location text) (markup?)
1526 (add-toc-item! 'tocActMarkup text))
1529 @lilypond[line-width=11.0\cm]
1530 \header { tagline = ##f }
1532 tocActMarkup = \markup \large \column {
1534 \fill-line { \null \italic \fromproperty #'toc:text \null }
1540 #(define-music-function (parser location text) (markup?)
1541 (add-toc-item! 'tocActMarkup text))
1544 \markuplist \table-of-contents
1545 \tocAct \markup { Atto Primo }
1546 \tocItem \markup { Coro. Viva il nostro Alcide }
1547 \tocItem \markup { Cesare. Presti omai l'Egizzia terra }
1548 \tocAct \markup { Atto Secondo }
1549 \tocItem \markup { Sinfonia }
1550 \tocItem \markup { Cleopatra. V'adoro, pupille, saette d'Amore }
1555 L'élément et son numéro de page peuvent se rejoindre par une ligne
1558 @lilypond[verbatim,quote]
1559 \header { tagline = ##f }
1561 tocItemMarkup = \tocItemWithDotsMarkup
1565 \markuplist \table-of-contents
1566 \tocItem \markup { Allegro }
1567 \tocItem \markup { Largo }
1573 @funindex \table-of-contents
1574 @code{\table-of-contents},
1580 Fichiers d'initialisation :
1581 @file{../ly/toc-init.ly}.
1584 @node Travail sur des fichiers texte
1585 @section Travail sur des fichiers texte
1586 @translationof Working with input files
1589 * Insertion de fichiers LilyPond::
1590 * Différentes éditions à partir d'une même source::
1591 * Caractères spéciaux::
1595 @node Insertion de fichiers LilyPond
1596 @subsection Insertion de fichiers LilyPond
1597 @translationof Including LilyPond files
1600 @cindex inclusion de fichiers
1602 Lorsqu'un projet prend de l'importance en volume, il est judicieux de le
1603 scinder en plusieurs fichiers, auxquels vous ferez référence avec un
1607 \include "autrefichier.ly"
1610 Une ligne @code{\include "autrefichier.ly"} dans un fichier revient à
1611 recopier intégralement le contenu de @file{autrefichier.ly} à l'endroit
1612 même ou est placée l'instruction @code{\include}. Vous pouvez par
1613 exemple écrire un fichier individuel par instrument, puis les regrouper
1614 pour former le fichier @qq{conducteur}. Les différentes variables
1615 définies dans les fichiers séparés seront normalement reprises et
1616 utilisables dans le fichier formant le conducteur. Les sections
1617 balisées dans les fichiers individuels peuvent être réutilisées en
1618 différents endroit de la partition , comme expliqué à la rubrique
1619 @ref{Différentes éditions à partir d'une même source}.
1621 Lorsque le fichier auquel il est fait référence se trouve dans le même
1622 répertoire, donner seulement son nom en argument à la commande
1623 @code{\include} suffit. S'il se trouve ailleurs, vous devrez indiquer
1624 le chemin d'accès, absolu ou relatif, en respectant toutefois la syntaxe
1625 UNIX -- autrement dit, le séparateur de répertoire est une oblique
1626 normale @code{/} et non l'oblique inverse @code{\} de DOS ou Windows.
1627 Par exemple, si le fichier @file{truc.ly} se trouve dans le répertoire
1628 supérieur au répertoire de travail, la ligne devra être
1631 \include "../truc.ly"
1635 ou bien, si les fichiers correspondant aux parties d'orchestre se
1636 trouvent dans le sous-répertoire @file{parties} relativement au
1637 répertoire courant, vous devrez mentionner
1640 \include "parties/VI.ly"
1641 \include "parties/VII.ly"
1645 Les fichiers à inclure peuvent eux-mêmes contenir des instructions
1646 @code{\include}. Ces instructions @code{\include} de second niveau ne
1647 pourront, par défaut, être interprétées qu'une fois intégrées dans le
1648 fichier principal@tie{}; leur argument doit donc comporter le chemin
1649 relativement au fichier principal et non par rapport au fichier dans
1650 lequel cette inclusion est mentionnée. Vous pouvez toutefois influer
1651 sur ce comportement à l'aide de l'option @w{@code{-drelative-includes}}
1652 en ligne de commande ou en ajoutant une clause
1653 @code{@w{#(ly:set-option 'relative-includes #t)}} en tête du fichier
1654 principal. Une fois @code{relative-include} activé, le chemin à suivre
1655 pour chacune des commandes @code{\include} sera pris relativement au
1656 fichier qui la contient. Cette option est vouée à être activée par
1657 défaut dans une future version de LilyPond.
1659 Vous pouvez inclure des fichiers dont vous spécifierez le chemin d'accès
1660 sur la ligne de commande au moment de lancer la compilation. L'appel à
1661 ces fichiers ne mentionnera alors que leur nom. Par exemple, si vous
1662 voulez compiler avec cette méthode le fichier @file{principal.ly} qui
1663 inclut des fichiers situés dans le sous-répertoire @file{parties},
1664 placez vous dans le répertoire contenant @file{principal.ly}, puis tapez
1667 lilypond --include=parties principal.ly
1670 tout en ayant bien dans @file{principal.ly}
1678 Lorsqu'un fichier est voué à être inclus dans nombre de partitions, vous
1679 pouvez le placer dans le répertoire de LilyPond @file{../ly}.
1680 Attention@tie{}: ce répertoire varie selon votre installation, comme
1681 indiqué au chapitre @rlearning{Autres sources de documentation}. Ce
1682 fichier sera inclus dès lors que vous fournirez uniquement son nom en
1683 argument à la fonction @code{\include}. C'est par exemple le cas du
1684 fichier de définition particulier @file{gregorian.ly}.
1686 Au moment où vous lancez LilyPond, un certain nombre de fichiers se
1687 retrouvent inclus par défaut@tie{}; il suffit d'activer le mode verbeux
1688 en faisant @w{@code{lilypond --verbose}} pour s'en rendre compte. Vous
1689 verrez ainsi défiler, en plus de nombreuses informations, le nom d'un
1690 certain nombre de fichiers et de chemins d'accès. Les fichiers les plus
1691 important sont mentionnés au chapitre
1692 @rlearning{Autres sources de documentation}. Si vous venez à les
1693 modifier, rappelez-vous qu'ils seront écrasés à l'installation d'une
1694 nouvelle version de LilyPond.
1696 Vous trouverez quelques exemples simples d'utilisation de la commande
1697 @code{\include} au chapitre @rlearning{Conducteurs et parties}.
1700 Manuel d'initiation :
1701 @rlearning{Autres sources de documentation},
1702 @rlearning{Conducteurs et parties}.
1705 Lorsque vous incluez un fichier qui porte le même nom que l'un des
1706 fichiers d'initialisation de LilyPond, le fichier de la distribution de
1707 LilyPond aura préséance.
1710 @node Différentes éditions à partir d'une même source
1711 @subsection Différentes éditions à partir d'une même source
1712 @translationof Different editions from one source
1714 Plusieurs méthodes permettent de générer différentes versions d'une
1715 partition à partir d'une même source. Les variables -- ou
1716 identificateurs -- sont sûrement le moyen le plus simple de combiner de
1717 différente manière des passages relativement longs, alors que les
1718 balises permettront de sélectionner de courts fragments selon leur
1721 Quelle que soit la méthode utilisée, séparer la notation de la structure
1722 de la partition vous donnera plus de liberté dans l'agencement de
1723 l'ouvrage final, puisque vous ne reviendrez pas sur la musique qui le
1727 * Utilisation de variables::
1728 * Utilisation de balises::
1729 * Globalisation des réglages::
1733 @node Utilisation de variables
1734 @unnumberedsubsubsec Utilisation de variables
1735 @translationof Using variables
1737 @cindex variables, utilisation de
1739 Un fragment musical identifié par une variable est réutilisable à divers
1740 endroits de la partition, comme nous l'avons vu à la rubrique
1741 @rlearning{Organisation du code source avec des variables}. Par
1742 exemple, une partition pour chœur @notation{a cappella} comporte souvent
1743 une réduction pour piano reprenant toutes les voix@tie{}; il s'agit de
1744 la même musique, et vous ne devrez donc la saisir qu'une seule fois.
1745 D'autre part, la musique issue de deux variables peut se combiner sur
1746 une seule portée, comme nous l'avons vu à la rubrique
1747 @ref{Regroupement automatique de parties}. Prenons l'exemple
1750 @lilypond[verbatim,quote]
1751 sopranoMusic = \relative c'' { a4 b c b8( a) }
1752 altoMusic = \relative g' { e4 e e f }
1753 tenorMusic = \relative c' { c4 b e d8( c) }
1754 bassMusic = \relative c' { a4 gis a d, }
1755 allLyrics = \lyricmode {King of glo -- ry }
1757 \new Staff = "Soprano" \sopranoMusic
1758 \new Lyrics \allLyrics
1759 \new Staff = "Alto" \altoMusic
1760 \new Lyrics \allLyrics
1761 \new Staff = "Tenor" {
1765 \new Lyrics \allLyrics
1766 \new Staff = "Bass" {
1770 \new Lyrics \allLyrics
1773 \set Staff.printPartCombineTexts = ##f
1779 \set Staff.printPartCombineTexts = ##f
1789 Générer une partition chorale ou la réduction pour piano ne requiert que
1790 de modifier la structure des éléments, sans aucunement toucher à la
1793 Dans le cas d'une partition relativement longue, vous pouvez isoler la
1794 définition des différentes variables dans des fichiers séparés que vous
1795 rappellerez ensuite, comme indiqué à la rubrique
1796 @ref{Insertion de fichiers LilyPond}.
1799 @node Utilisation de balises
1800 @unnumberedsubsubsec Utilisation de balises
1801 @translationof Using tags
1804 @funindex \keepWithTag
1805 @funindex \removeWithTag
1806 @funindex \pushToTag
1807 @funindex \appendToTag
1811 La commande @code{\tag #'@var{partieA}} affecte à une expression
1812 musicale le nom @var{partieA}. Les expressions ainsi balisées pourront
1813 être filtrées par la suite, à l'aide de
1814 @code{\keepWithTag@tie{}#'@var{nom}} ou
1815 @code{\removeWithTag@tie{}#'@var{nom}}. Ces filtres fonctionnent de la
1816 manière suivante@tie{}:
1818 @multitable @columnfractions .5 .5
1823 Musique balisée précédée de @code{\keepWithTag #'@var{nom}}
1824 @tab Musique non balisée et musique balisée par @var{nom} seront
1825 incluses@tie{}; la musique balisée autrement est exclue.
1828 Musique balisée précédée de @code{\removeWithTag #'@var{nom}}
1829 @tab Musique non balisée et fragments appelés autrement que @var{nom}
1830 seront inclus@tie{}; la musique balisée par @var{nom} est exclue.
1833 Musique balisée non précédée de @code{\keepWithTag} ou
1834 @code{\removeWithTag}
1835 @tab Musique balisée et non balisée seront incluses.
1839 Les arguments des commandes @code{\tag}, @code{\keepWithTag} et
1840 @code{\removeWithTag} doivent être un symbole (tel que
1841 @code{#'conducteur} ou @code{#'partie}), suivi d'une expression
1844 Dans l'exemple qui suit, nous obtenons deux versions du même extrait,
1845 l'une pour le conducteur, l'autre pour l'instrumentiste, et qui
1846 comportera les ornements développés.
1848 @lilypond[verbatim,quote]
1849 music = \relative g' {
1851 \tag #'trills { d8.\trill }
1852 \tag #'expand { \repeat unfold 3 { e32 d } }
1857 \keepWithTag #'trills \music
1860 \keepWithTag #'expand \music
1865 Il est parfois plus aisé d'exclure des fragments@tie{}:
1867 @lilypond[verbatim,quote]
1868 music = \relative g' {
1870 \tag #'trills { d8.\trill }
1871 \tag #'expand {\repeat unfold 3 { e32 d } }
1876 \removeWithTag #'expand
1880 \removeWithTag #'trills
1885 Ce principe de filtrage peut s'appliquer aux articulations, textes, etc.
1886 Il suffit de positionner
1889 -\tag #@var{ma-balise}
1893 avant l'articulation ou le texte, comme ici@tie{}:
1897 c1-\tag #'gaffe ^"Attention !"
1901 Ceci définira une note avec une indication conditionnelle de doigté ou
1904 Vous pouvez baliser différemment la même expression musicale en
1905 saisissant plusieurs @code{\tag}@tie{}:
1907 @lilypond[quote,verbatim]
1908 music = \relative c'' {
1909 \tag #'a \tag #'both { a4 a a a }
1910 \tag #'b \tag #'both { b4 b b b }
1913 \keepWithTag #'a \music
1914 \keepWithTag #'b \music
1915 \keepWithTag #'both \music
1919 L'application concomitante de plusieurs filtres @code{\removeWithTag} à
1920 la même expression musicale permet d'exclure plusieurs balisages@tie{}:
1922 @lilypond[verbatim,quote]
1923 music = \relative c'' {
1924 \tag #'A { a4 a a a }
1925 \tag #'B { b4 b b b }
1926 \tag #'C { c4 c c c }
1927 \tag #'D { d4 d d d }
1936 L'application de plus d'un filtre @code{\keepWithTag} à la même
1937 expression musicale aboutit à l'exclusion de @b{tous} les balisages.
1938 En effet, si le premier filtre exclut tous les autres balisages,
1939 l'application du second exclura les effets du premier.
1941 Il peut arriver que vous ayez besoin de raccorder quelque chose en un
1942 point particulier d'une expression musicale. Les commandes
1943 @code{\pushToTag} et @code{\appendToTag} permettent d'insérer du
1944 matériau, qu'il soit antérieur ou postérieur à des @code{éléments}
1945 d'une construction musicale existante. La musique séquentielle ou
1946 simultanée comporte assurément des @code{éléments}@tie{}:
1948 @lilypond[verbatim,quote]
1949 test = { \tag #'here { \tag #'here <<c''>> } }
1952 \pushToTag #'here c'
1953 \pushToTag #'here e'
1954 \pushToTag #'here g' \test
1955 \appendToTag #'here c'
1956 \appendToTag #'here e'
1957 \appendToTag #'here g' \test
1961 Ces deux instructions sont affectées d'une balise, le matériau à
1962 raccorder à chaque instance de la balise, et l'expression balisée.
1963 Ces instructions prennent soin de recopier tout ce qui doit être
1964 modifié, de telle sorte que l'expression @code{\test} originale conserve
1968 Manuel d'initiation :
1969 @rlearning{Organisation du code source avec des variables}.
1971 Manuel de notation :
1972 @ref{Regroupement automatique de parties},
1973 @ref{Insertion de fichiers LilyPond}.
1977 @c This warning is more general than this placement implies.
1978 @c Rests are not merged whether or not they come from tagged sections.
1979 @c Should be deleted? -td
1982 Lorsqu'elles comportent des silences, ceux-ci ne seront pas fusionnés
1983 si vous imprimez une partition avec les deux sections balisées.
1988 @node Globalisation des réglages
1989 @unnumberedsubsubsec Globalisation des réglages
1990 @translationof Using global settings
1992 @cindex include-settings
1994 Vous pouvez regrouper dans un fichier indépendant vos réglages
1995 personnels que vous inclurez au besoin@tie{}:
1998 lilypond -dinclude-settings=MES_REGLAGES.ly MA_PARTITION.ly
2001 Vous pouvez ainsi stocker dans un fichier séparé vos réglages en matière
2002 de format de papier, de fontes utilisées ou vos définitions
2003 particulières. Selon le fichier de réglages que vous mentionnerez, vous
2004 obtiendrez facilement différentes éditions à partir d'une même source
2005 quelle qu'elle soit.
2007 Cette technique peut s'utiliser en combinaison avec des feuilles de
2008 styles, comme indiqué au chapitre @rlearning{Feuilles de style}.
2011 Manuel d'initiation :
2012 @rlearning{Organisation du code source avec des variables},
2013 @rlearning{Feuilles de style}.
2015 Manuel de notation :
2016 @ref{Insertion de fichiers LilyPond}.
2019 @node Caractères spéciaux
2020 @subsection Caractères spéciaux
2021 @translationof Special characters
2023 @cindex caractères spéciaux
2024 @cindex non-ASCII, caractères
2029 * Équivalents ASCII::
2033 @node Codage du texte
2034 @unnumberedsubsubsec Codage du texte
2035 @translationof Text encoding
2039 LilyPond utilise le jeu de caractères défini par le consortium Unicode
2040 et la norme ISO/CEI@tie{}10646. Chaque caractère est identifié par un
2041 nom unique et associé à un point de code, ce qui permet dans l'absolu de
2042 couvrir tous les langages. Unicode permet de coder tous les caractères
2043 utilisés par toutes les langues écrites du monde. LilyPond utilise le
2044 codage UTF-8 (UTF pour @emph{Unicode Transformation Format}) qui permet
2045 de représenter les caractères latins sur un octet et les autres sur une
2046 longueur allant jusqu'à quatre octets.
2048 L'apparence réelle des caractères est déterminée par les glyphes ou
2049 graphèmes tels que définis dans les différentes polices disponibles.
2050 Une police, ou une fonte, définit la mise en correspondance d'un
2051 sous-ensemble de points de code unicode en glyphes. LilyPond recourt à
2052 la bibliothèque Pango pour assurer le rendu des textes multilingues.
2054 LilyPond n'effectue aucune conversion d'encodage que ce soit. Ceci
2055 implique donc que tout texte, qu'il s'agisse d'un titre, de paroles ou
2056 même d'instruction musicale, comportant des caractères non ASCII, soit
2057 codé en UTF-8. Le plus sûr moyen de saisir du texte de la sorte
2058 consiste à utiliser un éditeur supportant l'unicode et à enregistrer vos
2059 fichier en UTF-8. C'est le cas pour la plupart des éditeurs actuels,
2060 que ce soit vim, Emacs, jEdit et GEdit. Tous les systèmes Windows
2061 postérieurs à NT utilisent Unicode en natif@tie{}; même Notepad est
2062 capable d'éditer et sauvegarder un fichier en UTF-8 -- sans parler de
2063 l'excellente alternative qu'est BabelPad.
2065 La compilation d'un fichier LilyPond comportant des caractères non ASCII
2066 qui n'aurait pas été enregistré dans l'encodage UTF-8 vous renverra
2070 FT_Get_Glyph_Name () erreur : invalid argument
2073 Voici un exemple utilisant du texte en cyrillique, en hébreux et en
2077 %c No verbatim here as the code does not display correctly in PDF
2079 bulgarian = \lyricmode {
2080 Жълтата дюля беше щастлива, че пухът, който цъфна, замръзна като гьон.
2084 hebrew = \lyricmode {
2085 זה כיף סתם לשמוע איך תנצח קרפד עץ טוב בגן.
2089 portuguese = \lyricmode {
2090 à vo -- cê uma can -- ção legal
2096 \addlyrics { \bulgarian }
2097 \addlyrics { \hebrew }
2098 \addlyrics { \portuguese }
2103 @unnumberedsubsubsec Unicode
2104 @translationof Unicode
2108 Lorsque vous avez besoin d'un caractère dont vous connaissez le point de
2109 code mais que votre éditeur ne permet pas de saisir directement, vous
2110 pouvez utiliser les instructions @code{\char@tie{}##xhhhh} ou
2111 @code{\char@tie{}#dddd} au sein d'un bloc @code{\markup} -- @code{hhhh}
2112 et @code{dddd} correspondant respectivement à la valeur hexadécimale ou
2113 décimale. Même s'il est inutile de saisir les zéros superflus, il est
2114 de bon ton de stipuler les quatre caractères formant la représentation
2115 hexadécimale. Évitez cependant l'encodage UTF-8 d'un point de code
2116 après un @code{\char}@tie{}; les encodages UTF-8 comprennent un bit
2117 supplémentaire indiquant le nombre d'octets. Une table de
2118 correspondance entre les codes Unicode et le nom des caractères ainsi
2119 que leur code hexadécimal est disponible sur le site du consortium
2120 Unicode, @uref{http://www.unicode.org/}.
2122 Par exemple, @code{\char ##x03BE} et @code{\char #958} correspondent
2123 tous deux au caractère unicode U+03BE, dénommé @qq{Greek Small Letter
2126 Quel que soit le point de code spécifié de cette manière, il ne vous
2127 sera alors pas nécessaire d'enregistrer votre fichier en UTF-8. Vous
2128 devrez toutefois disposer d'une fonte contenant ce caractère qui soit
2129 accessible à LilyPond.
2131 L'exemple suivant illustre la manière d'insérer un caractère sous sa
2132 forme hexadécimale, à la fois dans un repère, dans une articulation,
2133 dans des paroles et dans du texte indépendant.
2135 @lilypond[quote,verbatim]
2138 c1 \mark \markup { \char ##x03EE }
2139 c1_\markup { \tiny { \char ##x03B1 " to " \char ##x03C9 } }
2141 \addlyrics { O \markup { \concat { Ph \char ##x0153 be! } } }
2143 \markup { "Copyright 2008--2012" \char ##x00A9 }
2148 Le signe @emph{copyright} dans le champ de titrage consacré s'inscrit de
2149 la manière suivante@tie{}:
2153 copyright = \markup @{ \char ##x00A9 "2008" @}
2158 @node Équivalents ASCII
2159 @unnumberedsubsubsec Équivalents ASCII
2160 @translationof ASCII aliases
2162 Dès lors que vous aurez inclus la liste de leur équivalent ASCII,
2163 LilyPond reconnaîtra un certain nombre de caractères spéciaux@tie{}:
2165 @lilypond[quote,verbatim]
2167 #(include-special-characters)
2170 \markup "&flqq; – &OE;uvre incomplète… &frqq;"
2173 \new Staff { \repeat unfold 9 a'4 }
2175 This is al -- so wor -- kin'~in ly -- rics: –_&OE;…
2180 "The replacement can be disabled:"
2181 "– &OE; …"
2182 \override #'(replacement-alist . ()) "– &OE; …"
2186 L'extension de cette liste est possible aussi bien de manière globale :
2188 @lilypond[quote,verbatim]
2190 #(add-text-replacements!
2191 '(("100" . "hundred")
2192 ("dpi" . "dots per inch")))
2194 \markup "A 100 dpi."
2197 qu'en un point particulier de votre source :
2199 @lilypond[quote,verbatim]
2200 \markup \replace #'(("100" . "hundred")
2201 ("dpi" . "dots per inch")) "A 100 dpi."
2205 Manuel de notation :
2206 @ref{Liste des caractères spéciaux}.
2208 Fichiers d'initialisation :
2209 @file{ly/text-replacements.ly}.
2212 @node Contrôle des sorties
2213 @section Contrôle des sorties
2214 @translationof Controlling output
2217 * Extraction de fragments musicaux::
2218 * Ignorer des passages de la partition::
2219 * Formats de sortie alternatifs::
2220 * Changement des fontes musicales::
2224 @node Extraction de fragments musicaux
2225 @subsection Extraction de fragments musicaux
2226 @translationof Extracting fragments of music
2228 LilyPond vous permet d'extraire des fragments d'une partition à l'instar
2229 du choriste amateur qui alimente son album avec des coupures de
2232 Vous devrez pour cela définir les mesures à découper. La définition
2233 suivante, incluse dans votre fichier source,
2240 (make-rhythmic-location 5 1 2)
2241 (make-rhythmic-location 7 3 4)))
2246 vous permettra d'extraire un fragment compris entre le milieu de la
2247 cinquième mesure et quelque part dans la septième. Le triplet
2248 @code{5@tie{}1@tie{}2} signifie@tie{}: après la durée d'une blanche dans
2249 la mesure 5@tie{}; le @code{7@tie{}3@tie{}4} signifie quant à lui que
2250 l'on s'arrête à la mesure 7, après la durée de trois noires.
2252 Rien ne vous empêche d'extraire plusieurs fragments, dès lors que vous
2253 définissez dans la liste d'autres paires d'emplacements rythmiques.
2255 Cette fonctionnalité n'est toutefois effective que lorsque vous lancez
2256 LilyPond avec l'option @w{@code{-dclip-systems}}. Les @qq{coupures}
2257 seront générées sous la forme de fichiers EPS, convertis en PDF ou PNG
2258 selon le format que vous aurez stipulé.
2260 Pour de plus amples informations quant au format des résultats,
2261 consultez le chapitre @rprogram{Lancement de lilypond}.
2264 @node Ignorer des passages de la partition
2265 @subsection Ignorer des passages de la partition
2266 @translationof Skipping corrected music
2268 @funindex skipTypesetting
2269 @funindex showFirstLength
2270 @funindex showLastLength
2272 Dans un travail de transcription ou de recopie de la musique, ce qui
2273 vous intéresse plus particulièrement se situe à la fin, là même où vous
2274 en êtes dans la notation. Dans le but de gagner du temps dans le
2275 processus de correction, vous pouvez @qq{escamoter} le reste et ne
2276 générer que les dernières mesures en insérant
2279 showLastLength = R1*5
2284 dans votre fichier source. Ceci aura pour effet de ne générer que les
2285 cinq dernières mesures -- si tant est que le morceau soit à 4/4 -- de
2286 tous les @code{\score} de votre fichier. Dans le cas d'un œuvre
2287 conséquente, cette pratique s'avère fort utile puisqu'elle évite de tout
2288 générer. Vous pourriez aussi être amené à retravailler le début d'une
2289 œuvre, pour y ajouter une partie par exemple, auquel cas c'est la
2290 propriété @code{showFirstLength} que vous utiliserez.
2292 Vous pouvez contrôler très finement les parties à escamoter, grâce au
2293 commutateur @code{Score.skipTypesetting}@tie{}: lorsqu'il est activé,
2294 aucune gravure n'est réalisée.
2296 Ce commutateur agit aussi sur la sortie MIDI. Notez bien que tous les
2297 événements seront escamotés, y compris les changements de tempo ou
2298 d'instrument -- vous voilà prévenu@tie{}!
2300 @lilypond[quote,relative=2,ragged-right,verbatim]
2302 \set Score.skipTypesetting = ##t
2304 \set Score.skipTypesetting = ##f
2308 Dans le cadre de musique polyphonique, @code{Score.skipTypesetting}
2309 s'applique à toutes les voix et portées. Vous gagnerez donc encore plus
2313 @node Formats de sortie alternatifs
2314 @subsection Formats de sortie alternatifs
2315 @translationof Alternative output formats
2317 @cindex scalable vector graphics
2318 @cindex SVG, format de sortie
2319 @cindex encapsulated postscript
2320 @cindex EPS, format de sortie
2322 En matière de partition imprimable, LilyPond génère par défaut des
2323 documents au format PostScript (PS) et Portable Document Format (PDF).
2324 Vous pouvez aussi obtenir des documents au format Scalable Vector
2325 Graphics (SVG), Encapsulated PostScript (EPS) ou Portable Network
2326 Graphics (PNG) dès lors que vous aurez lancé LilyPond en ligne de
2327 commande avec l'option @i{ad hoc} -- voir
2328 @rprogram{Utilisation en ligne de commande} à ce sujet.
2331 @node Changement des fontes musicales
2332 @subsection Changement des fontes musicales
2333 @translationof Replacing the notation font
2335 Gonville est une alternative à la fonte Feta que LilyPond utilise par
2336 défaut. Vous pouvez la télécharger à partir de
2338 @uref{http://www.chiark.greenend.org.uk/~sgtatham/gonville/ ,http://www.chiark.greenend.org.uk/~sgtatham/gonville/}
2341 Voici quelques mesures utilisant la police Gonville@tie{}:
2343 @c NOTE: these images are a bit big, but that's important
2344 @c for the font comparison. -gp
2345 @sourceimage{Gonville_after,,,}
2347 Et ces même mesures avec la police de LilyPond, Feta@tie{}:
2349 @sourceimage{Gonville_before,,,}
2352 @subsubheading Instructions d'installation pour MacOS
2353 @translationof Installation Instructions for MacOS
2355 Téléchargez puis décompressez l'archive zip. Recopiez le répertoire
2356 @code{lilyfonts} dans @file{@var{SHARE_DIR}/lilypond/current} -- voir
2357 @rlearning{Autres sources de documentation} à ce sujet. Renommez le
2358 répertoire @code{fonts} qui s'y trouve en @code{fonts_orig}, puis le
2359 répertoire @code{lilyfonts} en @code{fonts}. Il vous suffira, pour
2360 retrouver la fonte Feta, de renommer @code{fonts_orig} en @code{fonts}.
2363 Manuel d'initiation :
2364 @rlearning{Autres sources de documentation}.
2367 Gonville ne permet pas de générer de la notation ancienne, et certains
2368 glyphes ajoutés depuis lors aux jeux de caractères en soient absent.
2369 Consultez le site de l'auteur pour de plus amples informations ainsi
2370 qu'à propos des conditions d'utilisation.
2374 @section Sortie MIDI
2375 @translationof MIDI output
2380 MIDI (Musical Instrument Digital Interface) constitue un standard en
2381 matière de connexion et de contrôle des instruments électroniques. Un
2382 fichier MIDI contient une série de notes réparties dans différentes
2383 pistes. Il ne s'agit en rien d'un fichier sonore@tie{}; il vous faudra
2384 un logiciel capable de traduire ces séries de notes en sons réels.
2386 Vous pouvez convertir vos partition en fichier MIDI de manière à
2387 entendre ce que vous avez saisi. Ceci vous permet de contrôler aisément
2388 ce que vous avez saisi@tie{}: octaves et altérations erronées heurteront
2389 votre oreille avertie grâce au MIDI.
2391 Le fichier MIDI généré par LilyPond est relativement brut. Vous pouvez
2392 cependant obtenir un meilleur rendu avec @ref{Le script Articulate}.
2394 Dans une sortie MIDI, LilyPond alloue un canal à chaque portée, tout en
2395 réservant le canal@tie{}10 aux percussions. Dans la mesure ou un
2396 périphérique MIDI ne comprend que 16 canaux, un fichier MIDI qui
2397 comportera plus de quinze portées verra le même canal réutilisé.
2400 * Création de fichiers MIDI::
2402 * Contenu de la sortie MIDI::
2403 * Répétitions et MIDI::
2404 * Gestion des nuances en MIDI::
2405 * MIDI et percussions::
2406 * Le script Articulate::
2410 @node Création de fichiers MIDI
2411 @subsection Création de fichiers MIDI
2412 @translationof Creating MIDI files
2414 LilyPond générera un fichier MIDI dès que vous ajouterez un bloc
2415 @code{\midi} à la structure de votre partition, comme ici@tie{}:
2424 Lorsque le bloc @code{\score} contient un bloc @code{\midi} mais pas de
2425 bloc @code{\layout}, LilyPond ne produira qu'une sortie MIDI. Si donc
2426 vous avez besoin aussi d'un support visuel, vous devrez aussi mentionner
2427 un bloc @code{\layout}.
2437 Hauteurs, durées, liaisons de prolongation, nuances et changements de
2438 tempo seront interprétés et traduits en événements MIDI. Les
2439 indications de nuances, crescendos et decrescendos sont traduits en
2440 niveau de volume@tie{}; les indications sous la forme d'une fraction
2441 déterminée du volume disponible, et crescendos et decrescendos sous la
2442 forme d'une progression linéaire entre les deux extrêmes. Le rendu des
2443 indications de nuance peut être désactivé pour le MIDI -- voir
2446 Le tempo initial ainsi que ses changements sont normalement indiqués au
2447 fil de la notation à l'aide de la commande @code{\tempo}@tie{}; ils
2448 seront retranscrits dans le fichier MIDI. La commande @code{\tempo}
2449 donne lieu à l'impression d'une indication métronomique que vous pouvez
2450 toutefois rendre invisible, comme indiqué à la rubrique
2451 @ref{Indication métronomique}. Une autre manière de spécifier le tempo
2452 initial pour un fichier MIDI est indiquée plus avant -- voir
2455 En raison de certaines limitations de Windows, les fichiers MIDI doivent
2456 y porter l'extension @code{.mid}. D'autres systèmes utilisent
2457 l'extension @code{.midi}. Si besoin est, placez la ligne suivante au
2458 début de votre fichier source, avant l'ouverture de tout bloc
2459 @code{\book}, @code{\bookpart} ou @code{\score}@tie{}:
2462 #(ly:set-option 'midi-extension "midi")
2465 Cette ligne déterminera @code{.midi} comme extension par défaut pour les
2468 Vous pouvez aussi le faire en ligne de commande@tie{}:
2471 lilypond … -dmidi-extension=midi fichierLily.ly
2475 @unnumberedsubsubsec Noms d'instrument
2476 @translationof Instrument names
2478 @cindex instrument, nom d'
2479 @funindex Staff.midiInstrument
2481 L'instrument MIDI affecté à un canal particulier est déterminé par la
2482 propriété @code{Staff.midiInstrument}. Vous pouvez choisir l'un des
2483 instruments répertoriés à l'annexe @ref{Instruments MIDI}.
2487 \set Staff.midiInstrument = #"glockenspiel"
2493 \new Staff \with @{midiInstrument = #"cello"@} @{
2498 Lorsque l'instrument choisi ne correspond pas exactement à l'une des
2499 dénominations consacrées, LilyPond le replacera par un piano de concert
2500 (@code{"acoustic grand"}).
2503 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
2504 {changing-midi-output-to-one-channel-per-voice.ly}
2507 @c In 2.11 the following no longer seems to be a problem -td
2509 Un (de)crescendo non terminé ne sera pas correctement rendu en MIDI --
2510 il y a nécessairement du silence. Il vous faut donc lui donner une fin
2511 explicite. Par exemple,
2518 ne fonctionnera pas correctement, contrairement à
2521 @{ a4\< b c d\!\f @}
2525 Un changement de volume ne peut intervenir que sur le démarrage d'une
2526 note. C'est la raison pour laquelle la succession d'un crescendo et
2527 d'un diminuendo ne peut se produire sur une même note.
2529 Certains lecteurs MIDI ne rendent pas correctement les changements de
2530 tempo. MS Windows Media Player et
2531 @uref{http://@/timidity@/.sourceforge@/.net/,timidity} le font sans
2536 @subsection Le bloc MIDI
2537 @translationof MIDI block
2539 Dès lors que vous désirez obtenir une sortie MIDI, vous devrez inscrire
2540 un bloc @code{\midi} au sein du bloc @code{\score}. Son fonctionnement
2541 est comparable à ce lui du bloc @code{\layout}, voire plus simple. Si
2542 le bloc @code{\midi} est la plupart du temps laissé vide, il peut
2543 contenir des aménagements pour certains contextes, la définition de
2544 contextes particuliers ou du code permettant de déterminer la valeur de
2545 certaines propriétés. L'exemple suivant détermine le tempo initial du
2546 fichier MIDI tout en se passant de son indication sur la partition
2558 Ici, le tempo est fixé à 72 noires à la minute. Spécifier un tempo de
2559 la sorte ne permet pas de donner une valeur pour une note pointée. Vous
2560 devrez, en pareil cas, subdiviser la note pointée en durée plus courte.
2561 Par exemple, indiquer 90 à la noire pointée est équivalent à spécifier
2562 270 croches à la minute@tie{}:
2565 tempoWholesPerMinute = #(ly:make-moment 270 8)
2568 @cindex MIDI et définition de contexte
2569 @cindex contexte, définition en MIDI
2571 La syntaxe permettant de définir un contexte pour le @code{\midi} est en
2572 tout point identique à celle que vous utilisez dans le bloc
2573 @code{\layout}, à ceci près que le @qq{graveur} est remplacé par un
2574 @qq{interprète}. Les différents contextes disponibles en matière de
2575 MIDI sont répertoriés dans le fichier d'initialisation
2576 @file{../ly/performer-init.ly} -- pour plus de détail, voir
2577 @rlearning{Autres sources de documentation}.
2578 Si vous voulez vous passer des nuances dans votre fichier MIDI, il vous
2579 suffit d'insérer les lignes suivantes dans votre bloc
2587 \remove "Dynamic_performer"
2592 LilyPond ne générera de sortie MIDI que si vous incluez un bloc
2593 @code{\midi} dans la structure de la partition, initialisée par la
2594 commande @code{\score}.
2598 @{ @dots{}notes@dots{} @}
2604 @node Contenu de la sortie MIDI
2605 @subsection Contenu de la sortie MIDI
2606 @translationof What goes into the MIDI output?
2608 @c TODO Check grace notes - timing is suspect?
2611 @unnumberedsubsubsec Éléments pris en compte dans le MIDI
2612 @translationof Supported in MIDI
2614 @cindex hauteurs en MIDI
2615 @cindex MIDI, hauteurs
2616 @cindex quart de ton en MIDI
2617 @cindex MIDI, quart de ton
2618 @cindex microtonalité en MIDI
2619 @cindex MIDI, microtonalité
2620 @cindex accords nommés en MIDI
2621 @cindex MIDI, accords nommés
2622 @cindex Rythme en MIDI
2623 @cindex MIDI, Rythme
2624 @cindex articulations et MIDI
2625 @cindex MIDI et articulations
2626 @cindex trilles et MIDI
2627 @cindex MIDI et trilles
2630 Un fichier MIDI généré par LilyPond comprendra les éléments de notation
2638 les microtonalités -- voir @ref{Altérations}. Leur rendu nécessite
2639 cependant un lecteur qui prenne en charge la modulation@tie{};
2642 les accords nommés ;
2645 le rythme en tant que durée de note, y compris les nolets ;
2648 les trémolos, exceptés ceux utilisant la syntaxe
2649 @qq{@code{:}[@var{nombre}]}@tie{};
2652 les liaisons de prolongation ;
2655 les indications de nuance ;
2658 les crescendos et decrescendos s'étalant sur plusieurs notes@tie{};
2661 les changements de tempo indiqués par un @code{\tempo}@tie{};
2667 Si vous utilisez @ref{Le script Articulate}, d'autres éléments seront
2671 @item articulations (lié, staccato, etc.),
2672 @item trilles et groupettos,
2673 @item rallentando et accelerando.
2677 @unnumberedsubsubsec Éléments non pris en compte dans le MIDI
2678 @translationof Unsupported in MIDI
2680 @c TODO index as above
2682 LilyPond ne peut générer d'événement MIDI pour les éléments
2683 suivant, sauf à utiliser @ref{Le script Articulate}@tie{}:
2687 le rythme indiqué sous forme d'annotation (par ex. @emph{swing})@tie{};
2690 les changements de tempo indiqués sous forme d'annotation (sans
2691 @code{\tempo})@tie{};
2694 les staccatos et autres articulations ou ornementations@tie{};
2697 les liaisons d'articulation et de prhasé@tie{};
2700 les crescendos ou decrescendos sur une seule note@tie{};
2703 les trémolos indiqués par la syntaxe @qq{@code{:}[@var{nombre}]}@tie{};
2709 les accords en microtonalité.
2713 @node Répétitions et MIDI
2714 @subsection Répétitions et MIDI
2715 @translationof Repeats in MIDI
2717 @cindex reprises développées
2718 @cindex MIDI et reprises
2719 @funindex \unfoldRepeats
2721 Au prix de quelques réglages, les reprises de toutes sortes peuvent être
2722 rendues dans le fichier MIDI. Il suffit pour cela de recourir à la
2723 fonction @code{\unfoldRepeats}, qui développe toutes les reprises. En
2724 d'autre termes, @code{\unfoldRepeats} transforme toutes les reprises
2725 en reprises de type @code{unfold}.
2728 @lilypond[quote,verbatim]
2730 \repeat tremolo 8 {c'32 e' }
2731 \repeat percent 2 { c''8 d'' }
2732 \repeat volta 2 {c'4 d' e' f'}
2741 Dans une partition comportant plusieurs voix, le développement des
2742 reprises ne sera effectif en MIDI qu'à la condition que ces reprises
2743 soient mentionnée correctement dans @strong{toutes} les voix.
2745 Lorsque l'on veut utiliser @code{\unfoldRepeats} seulement pour le rendu
2746 MIDI, il faut établir deux blocs @code{\score}@tie{}: un pour le MIDI,
2747 avec des reprises explicites, et l'autre pour la partition, avec des
2748 reprises notées sous forme de barres de reprise, de trémolo ou de
2749 symboles de pourcentage. Par exemple
2757 \unfoldRepeats @var{..musique..}
2763 @node Gestion des nuances en MIDI
2764 @subsection Gestion des nuances en MIDI
2765 @translationof Controlling MIDI dynamics
2767 Les nuances MIDI sont générées par le @code{Dynamic_performer}, affecté
2768 par défaut au contexte @code{Voice}. Vous pouvez contrôler à la fois le
2769 volume général, celui des indications de nuance ainsi que celui des
2770 différents instruments.
2773 @unnumberedsubsubsec Indications de nuance
2774 @translationof Dynamic marks
2776 Les indications de nuances sont transcrites en fraction du volume MIDI.
2777 Nous allons, par défaut, de 0,25 pour un @notation{ppppp} à 0,95 pour un
2778 @notation{fffff}. Les correspondances entre nuance et fraction de
2779 volume sont répertoriées dans le fichier @file{../scm/midi.scm} --
2780 consultez la rubrique @rlearning{Autres sources de documentation} si
2781 vous ne savez comment le localiser. Vous pouvez modifier ou étendre ce
2782 jeu grâce à une fonction qui prendra en argument une indication de
2783 nuance et renverra la fraction désirée, puis en affectant cette fonction
2784 à @code{Score.dynamicAbsoluteVolumeFunction}.
2786 Prenons un exemple. Votre partition comporte un @notation{rinforzando}
2787 que vous avez indiqué par @code{\rfz}. Cette indication de nuance
2788 n'étant pas répertoriée dans le jeu par défaut, elle ne produira aucun
2789 effet en MIDI. Il en sera d'ailleurs de même pour toute indication
2790 créée de toute pièce à l'aide de l'instruction
2791 @w{@code{make-dynamic-script}}. Voici comment procéder pour ajuster le
2792 volume MIDI de ce @notation{rinforzando} que le compositeur a indiqué.
2793 La fonction Scheme définit une fraction de 0,9 en cas de @notation{rfz},
2794 et demande d'utiliser la fonction par défaut dans les autre cas.
2796 @lilypond[verbatim,quote]
2797 #(define (myDynamics dynamic)
2798 (if (equal? dynamic "rfz")
2800 (default-dynamic-absolute-volume dynamic)))
2804 \set Staff.midiInstrument = #"cello"
2805 \set Score.dynamicAbsoluteVolumeFunction = #myDynamics
2817 Si vous étiez amené à devoir modifier l'intégralité du jeu des
2818 correspondances, nous vous conseillons d'utiliser la procédure
2819 @command{default-dynamic-absolute-volume} contenue dans le fichier
2820 @file{../scm/midi.scm} ainsi que la table d'association comme base.
2821 Le dernier exemple de cette partie illustre la manière de procéder.
2824 @unnumberedsubsubsec Amplitude du volume en MIDI
2825 @translationof Overall MIDI volume
2827 Les valeurs extrêmes du volume MIDI des nuances se contrôlent à l'aide
2828 des propriétés @code{midiMinimumVolume} et @code{midiMaximumVolume} qui
2829 agissent au niveau @code{Score}. Ces propriétés sont effectives dès
2830 lors qu'une nuance est indiquée@tie{}; une nuance de départ est donc
2831 requise pour que le volume soit ajusté dès le début de la partition.
2832 Vous pouvez alors modifier la fraction correspondant à chaque nuance à
2833 l'aide de la formule
2836 midiMinimumVolume + (midiMaximumVolume - midiMinimumVolume) * fraction
2839 Voici comment ajuster les nuances tout en limitant l'amplitude du volume
2840 entre 0,2 et 0,5@tie{}:
2842 @lilypond[verbatim,quote]
2848 \set Staff.midiInstrument = #"flute"
2849 \new Voice \relative c''' {
2857 \set Staff.midiInstrument = #"clarinet"
2858 \new Voice \relative c'' {
2869 tempoWholesPerMinute = #(ly:make-moment 72 2)
2870 midiMinimumVolume = #0.2
2871 midiMaximumVolume = #0.5
2878 @unnumberedsubsubsec Égalisation de plusieurs instruments (i)
2879 @translationof Equalizing different instruments (i)
2881 La définition de l'amplitude du volume MIDI au niveau d'un contexte
2882 @code{Staff} permet de gérer les volumes relatifs entre les différents
2883 instruments. Ceci constitue en quelque sorte un égaliseur, ce qui
2884 permet d'améliorer notablement la qualité de la sortie MIDI.
2886 La clarinette de l'exemple suivant jouera relativement moins fort que la
2887 flûte. Rappelez-vous que pour que cela fonctionne correctement, la
2888 première note de chacun des instruments doit être affublée d'une
2889 indication de nuance.
2891 @lilypond[verbatim,quote]
2897 \set Staff.midiInstrument = #"flute"
2898 \set Staff.midiMinimumVolume = #0.7
2899 \set Staff.midiMaximumVolume = #0.9
2900 \new Voice \relative c''' {
2908 \set Staff.midiInstrument = #"clarinet"
2909 \set Staff.midiMinimumVolume = #0.3
2910 \set Staff.midiMaximumVolume = #0.6
2911 \new Voice \relative c'' {
2926 @unnumberedsubsubsec Égalisation de plusieurs instruments (ii)
2927 @translationof Equalizing different instruments (ii)
2929 Lorsque les propriétés volume minimum et maximum n'ont pas été définies,
2930 LilyPond appliquera par défaut une légère égalisation pour quelques
2931 instruments. Les instrument concernés ainsi que le niveau d'égalisation
2932 sont répertoriés dans une table @notation{instrument-equalizer-alist}
2933 du fichier @file{../scm/midi.scm}.
2935 Vous pouvez remplacer l'égaliseur basique en définissant une nouvelle
2936 procédure Scheme @code{instrumentEqualizer} au sein du contexte
2937 @code{Score}. Cette procédure prend en unique argument le nom d'un
2938 instrument MIDI et renverra une paire de fractions correspondant au
2939 minimum et maximum de volume alloué à cet instrument. Cette
2940 substitution fonctionne selon le même principe que celui que nous avons
2941 vu en début de chapitre avec @code{dynamicAbsoluteVolumeFunction}.
2942 L'égaliseur par défaut, @notation{default-instrument-equalizer}, est
2943 défini dans le fichier @file{../scm/midi.scm}@tie{}; son analyse vous
2944 aidera à construire votre propre procédure.
2946 Nous allons, dans l'exemple suivant, régler le volume relatif de la
2947 flûte et de la clarinette -- au même niveau que dans le précédent.
2949 @lilypond[verbatim,quote]
2950 #(define my-instrument-equalizer-alist '())
2952 #(set! my-instrument-equalizer-alist
2955 ("flute" . (0.7 . 0.9))
2956 ("clarinet" . (0.3 . 0.6)))
2957 my-instrument-equalizer-alist))
2959 #(define (my-instrument-equalizer s)
2960 (let ((entry (assoc s my-instrument-equalizer-alist)))
2969 \set Score.instrumentEqualizer = #my-instrument-equalizer
2970 \set Staff.midiInstrument = #"flute"
2971 \new Voice \relative c''' {
2979 \set Staff.midiInstrument = #"clarinet"
2980 \new Voice \relative c'' {
2995 @c Delete when satisfied this is adequately covered elsewhere -td
2997 @n ode Microtones in MIDI
2998 @s ubsection Microtones in MIDI
3000 @cindex microtones in MIDI
3002 Microtones consisting of half sharps and half flats are exported
3003 to the MIDI file and render correctly in MIDI players which support
3004 pitch bending. See @ref{Note names in other languages}. Here is
3005 an example showing all the half sharps and half flats. It can be
3006 copied out and compiled to test microtones in your MIDI player.
3008 @lilypond[verbatim,quote]
3025 @node MIDI et percussions
3026 @subsection MIDI et percussions
3027 @translationof Percussion in MIDI
3029 La notation pour percussions recourt généralement à un contexte
3030 particulier -- le @code{DrumStaff} -- qui permet d'affecter directement
3031 les instruments concernés au canal@tie{}10 qui leur est réservé.
3033 Certains instruments, tels le xylophone, le marimba, le vibraphone ou
3034 les timbales, se traitent cependant comme des instruments
3035 @qq{classiques} puisqu'ils sont capables d'émettre des hauteurs
3036 différentes@tie{}; leurs notation relève donc d'un contexte @code{Staff}
3037 standard, et non d'un @code{DrumStaff} pour pouvoir être rendus
3038 correctement en MIDI.
3040 D'autres percussions, bien que n'émettant qu'un seul son et inclus dans
3041 le standard @emph{general MIDI}, comme le tom mélodique ou le tambour
3042 taiko, ne sont pas attachés au canal@tie{}10. Ces instruments doivent
3043 donc être saisi dans un contexte @code{Staff}, en utilisant la hauteur
3046 De nombreux instruments de la famille des percussions, les castagnettes
3047 par exemple, n'existent pas dans le standard @emph{general MIDI}.
3048 L'alternative, bien que peu satisfaisante, consiste à leur attribuer le
3049 son le plus proche dans la banque standard.
3051 @c TODO Expand with examples, and any other issues
3054 Le standard @emph{general MIDI} ne dispose pas du @emph{rim shot}@tie{};
3055 LilyPond lui substitue un @emph{sidestick}.
3058 @node Le script Articulate
3059 @subsection Le script Articulate
3060 @translationof The Articulate script
3062 Vous obtiendrez un rendu MIDI plus @qq{réaliste} grâce au script
3063 @code{articulate}. Celui-ci va tout faire pour d'une part prendre en
3064 compte les articulations (liaisons, staccato, etc.) -- en ajoutant un
3065 blanc aux notes raccourcies -- et, d'autre part, développer les trilles
3066 ou groupettos ainsi que tenir compte des éventuels rallentando et
3069 L'utilisation du script @code{articulate} se fait en deux temps. Vous
3070 devez dans un premier temps inclure son fichier d'initialisation en
3071 ajoutant en tête de votre fichier la ligne
3074 \include "articulate.ly"
3077 puis, dans le bloc @code{\score}, indiquer que toutes les répétitions
3078 seront développées et appliquer la commande à votre musique@tie{}:
3081 \unfoldRepeats \articulate <<
3082 tout le reste du bloc contenant la partition...
3086 Une fois votre fichier modifié de la sorte, vous constaterez que la
3087 version imprimable aura été modifiée en profondeur. Le bloc
3088 @code{\midi} produira par contre un fichier MIDI de bien meilleure
3091 Bien que cela ne gène en rien le fonctionnement du script
3092 @code{articulate}, lui adjoindre la commande @code{\unfoldRepeats} comme
3093 illustré ci-dessus permettra le rendu d'un certain nombre
3094 d'articulations tels les trilles.
3097 Dans la mesure où la script @code{articulate} tend à raccourcir les
3098 accords, certaines musiques, notamment pour l'orgue, paraîtront de moins
3102 @node Extraction d'informations musicales
3103 @section Extraction d'informations musicales
3104 @translationof Extracting musical information
3106 En plus de générer du graphisme et du MIDI, LilyPond peut présenter
3107 l'information musicale sous forme textuelle.
3110 * Affichage de notation au format LilyPond::
3111 * Affichage de la musique sous forme d'expression Scheme::
3112 * Enregistrement d'événements musicaux dans un fichier::
3116 @node Affichage de notation au format LilyPond
3117 @subsection Affichage de notation au format LilyPond
3118 @translationof Displaying LilyPond notation
3120 @funindex \displayLilyMusic
3122 La fonction musicale @code{\displayLilyMusic} permet d'afficher en
3123 notation LilyPond une expression musicale. Le résultat défilera dans le
3124 terminal après avoir lancé LilyPond en ligne de commande. Par exemple,
3128 \displayLilyMusic \transpose c a, @{ c4 e g a bes @}
3135 @{ a,4 cis e fis g @}
3138 LilyPond affichera le résultat sous forme de message en console, au
3139 milieu de toutes les informations de compilation. Afin d'isoler ces
3140 messages et enregistrer le résultat de la fonction
3141 @code{\display@{MATÉRIAU@}}, pensez à rediriger la sortie vers un
3145 lilypond fichier.ly >affichage.txt
3150 Vous noterez que LilyPond ne se contente pas de simplement afficher
3151 l'expression musicale, mais procède aussi à son interprétation -- du
3152 fait que @code{\displayLilyMusic} renvoie l'expression tout en
3153 l'affichant. S'il est bien pratique d'insérer un
3154 @code{\displayLilyMusic} dans une expression musicale pour en obtenir
3155 des informations, l'interprétation de cette expression peut toutefois
3156 être évitée en ajoutant un @code{\void} avant l'instruction@tie{}:
3160 \void \displayLilyMusic \transpose c a, @{ c4 e g a bes @}
3165 @node Affichage de la musique sous forme d'expression Scheme
3166 @subsection Affichage de la musique sous forme d'expression Scheme
3167 @translationof Displaying scheme music expressions
3169 Voir @rextend{Affichage d'expressions musicales}.
3172 @node Enregistrement d'événements musicaux dans un fichier
3173 @subsection Enregistrement d'événements musicaux dans un fichier
3174 @translationof Saving music events to a file
3176 LilyPond vous permet de sauvegarder dans un fichier séparé, sur la base
3177 de la portée, les événements musicaux. Vous devrez pour ce faire
3178 inclure dans votre fichier maître un fichier d'initialisation
3182 \include "event-listener.ly"
3185 Pour chaque portée que comporte votre partition, vous obtiendrez un
3186 fichier @file{NOMFICHIER-PORTÉENOMMÉE.notes} ou
3187 @file{NOMFICHIER-unnamed-staff.notes}. Notez bien que si plusieurs
3188 portées ne sont pas explicitement nommées, tous leurs événements seront
3189 regroupés et mélangés dans le même fichier. Le résultat ressemblera à
3193 0.000 note 57 4 p-c 2 12
3195 0.250 note 62 4 p-c 7 12
3196 0.500 note 66 8 p-c 9 12
3197 0.625 note 69 8 p-c 14 12
3202 Il s'agit d'un tableau dont les colonnes sont délimitées par une
3203 tabulation. Chaque ligne comporte deux champs fixes suivis d'un certain
3204 nombre de paramètres optionnels.
3207 @var{temps} @var{type} @var{...paramètres...}
3210 Ces informations peuvent faire l'objet d'un retraitement par d'autres
3211 programmes, comme des scripts python, aux fins de recherche en analyse
3212 musicologique ou des expériences à partir du rendu de LilyPond.
3215 Tous les événements ne sont pas pris en charge par
3216 @file{event-listener.ly}. Il s'agit en premier lieu d'une
3217 démonstration, un @qq{proof of concept} du potentiel de LilyPond. Si
3218 certains des éléments que vous cherchez à obtenir n'apparaissent pas,
3219 recopiez le fichier @file{event-listener.ly} dans votre répertoire et
3220 modifiez-le de telle sorte qu'il travaille selon vos attentes.