1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
4 Translation of GIT committish: a5b7cd343ce48d2e6f8e3f0e13881d2525209d98
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. For details, see the Contributors'
8 Guide, node Updating translation committishes..
13 @c Translators: Jean-Charles Malahieude, Valentin Villenave
15 @node Généralités en matière d'entrée et sortie
16 @chapter Généralités en matière d'entrée et sortie
17 @translationof General input and output
19 Nous n'allons pas, dans ce chapitre, parler directement de notation,
20 mais plutôt du contenu des fichiers source et du résultat produit par
24 * Agencement du code::
26 * Travail sur des fichiers texte::
27 * Contrôle des sorties::
28 * Génération de fichiers MIDI::
29 * Extraction d'informations musicales::
33 @node Agencement du code
34 @section Agencement du code
35 @translationof Input structure
37 LilyPond traite des fichiers textuels. Ces fichiers portent par
38 convention une extension @code{.ly}.
41 * Structure d'une partition::
42 * Plusieurs partitions dans un même ouvrage::
43 * Plusieurs éditions pour une même source::
44 * Nom des fichiers de sortie::
45 * Structure de fichier::
49 @node Structure d'une partition
50 @subsection Structure d'une partition
51 @translationof Structure of a score
55 Un bloc @code{\score} contient obligatoirement une seule expression
56 musicale délimitée par des accolades :
64 @warning{Il ne doit y avoir qu'@strong{une seule} expression musicale
65 globale dans un bloc @code{@bs{}score}, et elle @strong{doit} être
66 bornée par une paire d'accolades.}
68 Cette unique expression musicale peut être de n'importe quelle taille et
69 contenir d'autres expressions musicales aussi complexes soient elles.
70 Voici quelques exemples d'expression musicale :
76 @lilypond[verbatim,quote]
83 @lilypond[verbatim,quote]
85 \new Staff { c'4 c' c' c' }
86 \new Staff { d'4 d' d' d' }
94 \new Staff @{ \flute @}
95 \new Staff @{ \hautbois @}
98 \new Staff @{ \violonI @}
99 \new Staff @{ \violonII @}
105 Les commentaires constituent l'une des rares exceptions à cette règle
106 immuable -- voir @ref{Structure de fichier} pour les autres. Qu'il
107 s'agisse d'une seule ligne ou de tout un bloc -- délimité par
108 @code{%@{ @dots{} %@}} -- un commentaire peut se placer n'importe où
109 dans le fichier source, aussi bien à l'intérieur qu'à l'extérieur du
110 bloc @code{\score}, ou encore à l'intérieur ou à l'extérieur de
111 l'expression musicale contenue dans un bloc @code{\score}.
113 Lorsqu'un fichier ne comprend qu'un bloc @code{\score}, celui-ci est
114 implicitement inclus dans un bloc @code{\book}. Le bloc @code{\book}
115 d'un fichier source permet la production d'au moins un fichier dont le
116 nom sera, par défaut, déduit du fichier source : le traitement de
117 @file{fandangopourelephants.ly} produira donc
118 @file{fandangopourelephants.pdf}.
120 Pour de plus amples informations à propos du bloc @code{\book}, lisez
121 @ref{Plusieurs partitions dans un même ouvrage},
122 @ref{Plusieurs éditions pour une même source} et
123 @ref{Structure de fichier}.
126 Manuel d'initiation :
127 @rlearning{La partition est une (unique) expression musicale composée},
128 @rlearning{Les expressions musicales en clair},
129 @rlearning{Travail sur les fichiers d'entrée}.
132 @node Plusieurs partitions dans un même ouvrage
133 @subsection Plusieurs partitions dans un même ouvrage
134 @translationof Multiple scores in a book
136 @cindex mouvements, plusieurs
137 @cindex plusieurs mouvements
141 Un ouvrage peut se composer de plusieurs morceaux et de texte. C'est le
142 cas des cahiers d'exercices ou d'une partie d'orchestre avec ses
143 différents mouvements. Chaque mouvement fait l'objet d'un bloc
148 @var{@dots{}musique@dots{}}
152 et le texte est contenu dans un bloc @code{\markup},
156 @var{@dots{}texte@dots{}}
162 Les différents mouvements et textes qui apparaissent dans un même
163 fichier @file{.ly} ne composeront en principe qu'un seul fichier
178 Attention cependant si vous travaillez avec lilypond-book : il vous
179 faudra explicitement mentionner le bloc @code{\book}, en l'absence de
180 quoi seul le premier @code{\score} ou @code{\markup} apparaîtra après
183 L'entête de chaque pièce peut se placer au sein du bloc @code{\score} ;
184 le contenu du champ @code{piece} viendra s'imprimer avant chaque
185 mouvement. De même, le titre de l'ouvrage peut se placer au sein du
186 bloc @code{\book}. Dans le cas contraire, le contenu du bloc
187 @code{\header} placé en début de fichier sera utilisé.
191 title = "Huit miniatures"
192 composer = "Igor Stravinsky"
196 \header @{ piece = "Romance" @}
199 @dots{}texte du second couplet@dots{}
202 @dots{}texte du troisième couplet@dots{}
206 \header @{ piece = "Menuet" @}
212 Plusieurs pièces seront regroupées dans un même « chapitre » à l'aide
213 d'un bloc @code{\bookpart}. Ces différents « chapitres » sont séparés
214 par un saut de page et peuvent comporter un titre à l'instar de
215 l'ouvrage dès lors que vous y insérez un bloc @code{\header}.
220 title = "Titre de l'ouvrage"
221 subtitle = "Première partie"
228 subtitle = "Deuxième partie"
236 @node Plusieurs éditions pour une même source
237 @subsection Plusieurs éditions pour une même source
238 @translationof Multiple output files from one input file
240 Dès lors que vous inscrivez plusieurs blocs @code{\book} dans un même
241 fichier @file{.ly}, chacun d'eux donnera lieu à un résultat indépendant.
242 Lorsqu'aucun bloc @code{\book} n'est spécifié dans le fichier source,
243 LilyPond considère que l'intégralité du fichier constitue un bloc
244 @code{\book} unique, comme indiqué à la rubrique
245 @ref{Structure de fichier}.
247 LilyPond fait en sorte, lorsque plusieurs fichiers sont produits à
248 partir d'une même source, qu'aucun résultat d'un bloc @code{\book}
249 n'écrase celui qui a été généré pour un bloc @code{\book} précédent.
251 Dans les faits, et si le nom du fichier produit est repris de sa source
252 -- comportement par défaut --, un suffixe lui sera ajouté pour chaque
253 @code{\book}. Il s'agit en principe d'un pseudo numéro de version.
254 Ainsi, le fichier @file{huitminiatures.ly} qui contiendrait
275 @file{huitminiatures.pdf},
277 @file{huitminiatures-1.pdf} et
279 @file{huitminiatures-2.pdf}.
283 @node Nom des fichiers de sortie
284 @subsection Nom des fichiers de sortie
285 @translationof Output file names
287 @funindex \bookOutputSuffix
288 @funindex \bookOutputName
290 LilyPond vous permet de prendre le contrôle dans la dénomination des
291 fichiers que vous voulez générer, quel que soit le moteur de rendu
294 Nous avons vu dans la rubrique précédente que LilyPond évite les
295 conflits de nom des fichiers qu'il génère à partir d'une même source.
296 Vous pouvez même définir vous-même le suffixe qui sera appliqué à chacun
297 des blocs @code{\book}. Ainsi, en reprenant l'exemple ci-avant, vous
298 obtiendrez les fichiers @file{huitminiatures-Romance.pdf},
299 @file{huitminiatures-Menuet.pdf} et @file{huitminiatures-Nocturne.pdf}
300 en ajoutant simplement une déclaration @code{\bookOutputSuffix} au sein
301 de chaque bloc @code{\book}.
305 \bookOutputSuffix "Romance"
310 \bookOutputSuffix "Menuet"
315 \bookOutputSuffix "Nocturne"
321 La déclaration @code{\bookOutputName} vous permet de définir vous-même
322 le nom du fichier généré pour un bloc @code{\book} :
326 \bookOutputName "Romance"
331 \bookOutputName "Menuet"
336 \bookOutputName "Nocturne"
342 Le traitement de ce fichier produira :
354 @node Structure de fichier
355 @subsection Structure de fichier
356 @translationof File structure
366 Un fichier @code{.ly} peut contenir un certain nombre d'expressions de
367 haut niveau. Les expressions de haut niveau sont les suivantes :
371 Une définition de sortie, comme @code{\paper}, @code{\midi} et
372 @code{\layout}. Ces définitions, lorsqu'elles se trouvent à un niveau
373 supérieur, s'appliqueront à l'intégralité de l'ouvrage. Si l'une de ces
374 expression apparaît à plusieurs reprises à un niveau supérieur, les
375 différents contenus seront combinés, à ceci près qu'en cas de
376 déclarations conflictuelles, la dernière aura préséance. Des
377 informations complémentaires sont disponibles à la rubrique
378 @ref{Le bloc layout}.
381 Une expression Scheme pure, telle que
382 @w{@code{#(set-default-paper-size "a7" 'landscape)}} ou
383 @w{@code{#(ly:set-option 'point-and-click #f)}}.
386 Un bloc @code{\header}, dont le contenu sera valide pour tout le
387 fichier. Il comporte en général les valeurs par défaut des champs de
388 titrage, tels le titre ou l'auteur entre autres, communs à tous les
389 blocs @code{\book} inclus dans le fichier -- voir
390 @ref{Généralités en matière de titrages}.
393 Un bloc @code{\score} pour la partition. Cette partition sera assemblée
394 avec les autres partitions se trouvant au même niveau pour composer le
395 @code{\book}. Vous pouvez modifier ce comportement à l'aide de la
396 variable @code{toplevel-score-handler} placée en tête. Le gestionnaire
397 par défaut est défini dans le fichier d'initialisation
398 @file{../scm/lily.scm}.
401 Un bloc @code{\book} permet de regrouper naturellement plusieurs
402 mouvements -- autrement dit plusieurs blocs @code{\score} -- dans un
403 même document. Lorsqu'il y a plusieurs @code{\score}, LilyPond génère
404 un seul fichier dans lequel les mouvements sont mis les uns à la suite
405 des autres, ce pour chacun des blocs @code{\book} rencontrés. La seule
406 raison qui peut vous demander d'expliciter plusieurs blocs @code{\book}
407 dans un fichier @file{.ly} est lorsque vous avez besoin de générer
408 différents documents à partir d'une même source. La présence explicite
409 d'un bloc @code{\book} est aussi nécessaire lorsque vous travaillez sur
410 un document lilypond-book qui reprendrait plusieurs @code{\score} ou
411 @code{\markup} dans un même extrait. Vous pouvez modifier ce
412 comportement à l'aide de la variable @code{toplevel-book-handler}
413 placée en tête. Le gestionnaire par défaut est défini dans le fichier
414 d'initialisation @file{../scm/lily.scm}.
417 Un bloc @code{\bookpart}. Un ouvrage peut se découper en plusieurs
418 parties à l'aide de blocs @code{\bookpart}, aussi bien pour alléger le
419 travail de l'algorithme de calcul des sauts de page, que si les réglages
420 du bloc @code{\paper} diffèrent d'une partie à l'autre.
423 Une expression musicale telle que
428 Ce bout de code sera placé dans un @code{\score} et intégré à l'ouvrage
429 en même temps que tous les autres @code{\score} ou expressions
430 musicales. En d'autres termes, un fichier qui ne contiendrait que cette
431 simple expression musicale sera traduit en
448 Vous pouvez modifier ce comportement à l'aide de la variable
449 @code{toplevel-music-handler} placée en tête. Le gestionnaire par
450 défaut est défini dans le fichier d'initialisation
451 @file{../scm/lily.scm}.
454 Du texte sous forme de @emph{markup} comme les paroles d'un couplet
457 2. Le première ligne du deuxième couplet.
461 De tels @emph{markups} seront imprimés là où ils apparaissent,
462 avant, après ou entre les expressions musicales.
465 @cindex identificateurs
468 Une variable, ou identificateur, telle que
470 toto = @{ c4 d e d @}
473 Vous pourrez la réutiliser plus loin dans votre fichier en saisissant
474 simplement @code{\toto}. Le nom des identificateurs ne doit être
475 formés que de caractères alphabétiques -- sans chiffre ni caractère
480 Voici trois éléments que vous pouvez placer à un niveau supérieur :
484 % pas en pleine largeur
495 Vous pouvez placer, n'importe où dans votre fichier, les instructions
499 @item @code{\version}
500 @item @code{\include}
501 @item @code{\sourcefilename}
502 @item @code{\sourcefileline}
504 Une ligne de commentaire, introduite par le signe @code{%}.
507 Un bloc de commentaire, délimité par @code{%@{ @dots{} %@}}.
514 Vous pouvez insérer des espaces dans votre fichier source afin de lui
515 apporter une meilleure lisibilité. Les espaces superflus sont
516 normalement ignorés. Notez cependant qu'il est des cas où l'espace est
517 requis pour éviter tout risque d'erreur :
521 Autour d'une accolade, qu'elle soit ouvrante ou fermante ;
524 Après chaque commande ou variable, autrement dit tout élément qui
525 commence par un @code{\} ;
528 Après tout élément qui sera interprété comme une expression Scheme,
529 autrement dit tout élément qui commence par un @code{#} ;
532 Pour séparer les éléments d'une expression Scheme ;
535 En mode parole -- @code{lyricmode} -- avant et après les commandes
536 @code{\override} et @code{\set}.
541 Manuel d'initiation :
542 @rlearning{Organisation des fichiers LilyPond}.
545 @ref{Généralités en matière de titrages},
546 @ref{Le bloc layout}.
549 @node Titres et entêtes
550 @section Titres et entêtes
551 @translationof Titles and headers
553 La plupart de la musique qui est éditée comporte un titre et le nom de
554 son compositeur ; certains ouvrages dispensent beaucoup plus
558 * Création de titres et entête ou pied de page::
559 * Titrages personnalisés::
560 * Notes de bas de page::
561 * Référencement des numéros de page::
562 * Table des matières::
566 @node Création de titres et entête ou pied de page
567 @subsection Création de titres et entête ou pied de page
568 @translationof Creating titles headers and footers
571 * Généralités en matière de titrages::
572 * Mise en forme par défaut des titrages subalternes::
573 * Mise en forme par défaut des entête et pied de page::
577 @node Généralités en matière de titrages
578 @unnumberedsubsubsec Généralités en matière de titrages
579 @translationof Titles explained
581 Chaque bloc @code{\book} apparaissant dans un même fichier source
582 résultera en un fichier indépendant, comme indiqué à la rubrique
583 @ref{Structure de fichier}. Chacun de ces fichiers résultants comporte
584 trois endroits où placer des titrages : le @strong{titrage de l'ouvrage}
585 au début de chaque recueil (@emph{book}), les @strong{titrages de
586 partie} au début de chaque partie (@emph{bookpart}) et les
587 @strong{titrages de morceau} avant chaque pièce (@emph{score}).
589 La valeur des champs de titrage @code{title} (le titre) et
590 @code{composer} (le compositeur) se définissent dans des blocs
591 @code{\header} -- la syntaxe appropriée et la liste des différents
592 champs disponibles par défaut sont à la section
593 @ref{Mise en forme par défaut des titrages subalternes}.
594 Les titrages d'un ouvrage, de ses parties ou des morceaux qu'il contient
595 peuvent tous comporter les même champs bien que, par défaut, le titrage
596 d'un morceau se limite à @code{piece} et @code{opus}.
598 Les blocs @code{\header} peuvent se placer à quatre endroits différents
599 qui formeront une hiérarchie descendante :
604 En tête du fichier source, avant même tout bloc @code{\book},
605 @code{\bookpart} ou @code{\score} ;
608 Au sein d'un bloc @code{\book} et en dehors de tout bloc
609 @code{\bookpart} ou @code{\score} qu'il contient ;
612 Au sein d'un bloc @code{\bookpart} et en dehors de tout bloc
613 @code{\score} qu'il contient ;
616 Après l'expression musicale incluse dans un bloc @code{\score}.
620 La valeur des différents champs sera filtrée en respectant cette
621 hiérarchie ; les valeurs persisteront à moins d'être écrasées par une
622 autre valeur à un niveau inférieur. Ainsi :
626 Le titre d'un ouvrage découle des champs définis en tête de fichier
627 source, modifiés par les champs définis au sein du bloc @code{\book}.
628 Les champs résultants serviront à affecter un titre de recueil à
629 l'ouvrage, si tant est que quoi que ce soit génère une page au début de
630 cet ouvrage, avant la première partie -- un simple saut de page forcé
631 (@code{\pageBreak}) suffit.
634 Le titre d'une partie découle des champs définis en tête du fichier
635 source, modifiés par les champs définis au sein du bloc @code{\book}
636 puis par ceux définis au sein du bloc @code{\bookpart}. Les valeurs qui
637 en résulteront permettront d'imprimer les titrages de partie pour cette
641 Le titre d'un morceau découle des champs définis en tête du fichier
642 source, modifiés par les champs définis au sein du bloc @code{\book}
643 puis par ceux définis au sein du bloc @code{\bookpart}, et enfin par
644 ceux définis au sein du bloc @code{\score}. Les valeurs qui en
645 résulteront permettront d'imprimer les titrages de morceau pour ce
646 morceau. Notez toutefois que, pour un morceau, seuls les champs
647 @code{piece} et @code{opus} seront imprimés, à moins d'avoir valorisé
648 à @code{#t} la variable @code{print-all-headers} dans la section
653 @warning{N'oubliez pas que lorsqu'il est placé à l'intérieur d'un bloc
654 @code{@bs{}score}, le bloc @code{@bs{}header} doit impérativement se
655 trouver @strong{à la suite} de l'expression musicale.}
657 Nul n'est besoin de fournir un bloc @code{\header} à chacun des quatre
658 niveaux ; on peut se passer aussi bien de l'un d'eux que de tous. Dans
659 la même veine, un fichier source simpliste peut ne pas mentionner de
660 bloc @code{\book} ou @code{\bookpart} qui seront alors créés
663 Lorsque l'ouvrage ne comporte qu'un seul morceau, le bloc @code{\header}
664 devrait prendre place en tête de fichier, de telle sorte que soit produit
665 un titrage de partie qui met à disposition tous les champs de titrage.
667 Lorsque l'ouvrage comporte plusieurs morceaux, différents arrangements
668 du bloc @code{\header} permettent d'obtenir différents styles de
669 publication musicale. Par exemple, si la publication comprend plusieurs
670 pièces du même compositeur, un bloc @code{\header} placé en tête de
671 fichier définira le titre de l'ouvrage et le compositeur, que l'on
672 complètera par un bloc @code{\header} dans chaque bloc @code{\score}
673 pour définir les champs @code{piece} et @code{opus}, comme ici :
675 @lilypond[papersize=a5,quote,verbatim,noragged-right]
678 composer = "J. S. Bach."
682 \new Staff \relative {
685 \repeat unfold 2 { g,16( d' b') a b d, b' d, } |
686 \repeat unfold 2 { g,16( e' c') b c e, c' e, } |
694 \new Staff \relative {
698 <g, d' b'~>4 b'16 a( g fis) g( d e fis) g( a b c) |
699 d16( b g fis) g( e d c) b(c d e) fis( g a b) |
707 Des agencements plus élaborés sont aussi réalisables. Par exemple, les
708 champs appartenant au titrage principal d'un ouvrage peuvent se
709 reporter dans chaque bloc @code{\score}, certains étant modifiés voire
710 supprimés manuellement :
713 @lilypond[papersize=a5,quote,verbatim,noragged-right]
716 print-all-headers = ##t
719 title = "DAS WOHLTEMPERIRTE CLAVIER"
721 % Pas de mention spéciale pour cet ouvrage
724 \markup { \vspace #1 }
728 \new Staff { \clef "bass" s1 }
731 title = "PRAELUDIUM I"
733 % Pas de sous-titre pour ce morceau
740 \new Staff { \clef "bass" s1 }
744 subsubtitle = "A 4 VOCI"
746 % Pas de sous-titre pour ce morceau
755 @ref{Mise en forme par défaut des titrages subalternes},
756 @ref{Mise en forme personnalisée des titrages},
757 @ref{Structure de fichier}.
760 @node Mise en forme par défaut des titrages subalternes
761 @unnumberedsubsubsec Mise en forme par défaut des titrages subalternes
762 @translationof Default layout of bookpart and score titles
764 Voici les différentes variables attachées au bloc @code{\header} :
767 @lilypond[papersize=a6landscape,quote,verbatim,noragged-right]
770 % Les champs suivants sont centrés
771 dedication = "Dédicace"
773 subtitle = "Sous-titre"
774 subsubtitle = "Sous-sous-titre"
775 % Les champs suivants sont répartis sur une même ligne, et
776 % le champ "instrument" apparaîtra sur les pages suivantes
777 instrument = \markup \with-color #green "Instrument"
779 composer = "Compositeur"
780 % Les champs suivants sont en opposition sur la même ligne
782 arranger = "Arrangeur"
783 % Les champs suivants sont centrés en bas de page
784 tagline = "« tagline » ou mention spéciale en pied de dernière page"
785 copyright = "copyright en pied de première page"
790 % Les champs suivants sont en opposition sur la même ligne
798 % Les champs suivants sont en opposition sur la même ligne
799 piece = "Pièce 2 sur la même page"
807 % Les champs suivants sont en opposition sur la même ligne
808 piece = "Pièce 3 sur une nouvelle page"
815 Quelques précisions :
819 Le nom de l'instrument sera répété en tête de chaque page.
822 Seuls seront imprimés les champs @code{piece} et @code{opus} inclus dans
823 un bloc @code{\score} dès lors que la variable @code{print-all-headers}
824 reste désactivée (valeur à @code{##f}).
827 @c Is the bit about \null markups true? -mp
828 Les champs d'un bloc @code{\header} qui n'auront pas été alimentés
829 seront remplacés par un @emph{markup} @code{\null} de façon à ne pas
833 Par défaut, @code{scoreTitleMarkup} place les champs @code{piece} et
834 @code{opus} de part et d'autre sur une même ligne.
838 Les possibilités de modifier la mise en forme par défaut sont abordées à
839 la rubrique @ref{Mise en forme personnalisée des titrages}.
843 Un bloc @code{\book} qui commencerait directement par un bloc
844 @code{\bookpart} ne verra pas ses titrages apparaître puisqu'il n'y a
845 aucune page où imprimer le titre. Si toutefois le titre de l'ouvrage
846 est requis, le bloc @code{\book} devra commencer par un @emph{markup} ou
847 une commande @code{\pageBreak}.
849 La variable @code{breakbefore} activée dans un bloc @code{\header} situé
850 dans un bloc @code{\score} force le saut de page avant le morceau
851 contenu dans ce @code{\score}. Vous pourrez ainsi séparer le titre
852 principal de la musique.
854 @lilypond[papersize=c7landscape,verbatim,noragged-right]
857 title = "This is my Title"
858 subtitle = "This is my Subtitle"
859 copyright = "This is the bottom of the first page"
862 \repeat unfold 4 { e'' e'' e'' e'' }
864 piece = "This is the Music"
872 Manuel d'initiation :
873 @rlearning{Organisation des fichiers LilyPond}.
876 @ref{Mise en forme personnalisée des titrages},
877 @ref{Structure de fichier}.
879 Fichiers d'initialisation :
880 @file{ly/titling-init.ly}.
883 @node Mise en forme par défaut des entête et pied de page
884 @unnumberedsubsubsec Mise en forme par défaut des entête et pied de page
885 @translationof Default layout of headers and footers
887 Les entête et pied -- @emph{header} et @emph{footer} -- sont des
888 lignes de textes qui apparaissent en haut et en bas de chaque page,
889 indépendamment du texte de l'ouvrage. Ils sont contrôlés par les
890 variables suivantes, attachées au bloc @code{\paper} :
893 @item @code{oddHeaderMarkup} -- entête de page impaire
894 @item @code{evenHeaderMarkup} -- entête de page paire
895 @item @code{oddFooterMarkup} -- pied de page impaire
896 @item @code{evenFooterMarkup} -- pied de page paire
899 Ces variables @emph{markup} n'accèdent qu'au contenu des champs du bloc
900 @code{\header} principal, celui qui s'appliquera à tous les blocs
901 @code{\score} du document. Ces variables sont définies dans le fichier
902 @file{ly/titling-init.ly}, et sont par défaut :
907 les numéros sont placés en haut à gauche (si pair) ou à droite (si
908 impair) de chaque page à compter de la deuxième ;
911 le contenu du champ @code{instrument} est centré en haut de chaque page
912 à compter de la deuxième ;
915 le texte du @code{copyright} est centré au bas de la première page ;
918 le @code{tagline} -- mention spéciale -- se place au bas de la dernière
919 page, ou bien sous le @code{copyright} s'il n'y a qu'une seule page.
923 La mention spéciale se modifie en alimentant le champ @code{tagline} au
924 niveau du bloc @code{\header} principal.
926 @lilypond[papersize=a8landscape,verbatim]
929 tagline = "... music notation for Everyone"
939 Pour supprimer le @code{tagline}, il suffit de lui assigner la valeur
943 @node Titrages personnalisés
944 @subsection Titrages personnalisés
945 @translationof Custom titles headers and footers
947 @c TODO: somewhere put a link to header spacing info
948 @c (you'll have to explain it more in NR 4).
951 * Mise en forme personnalisée des champs de titrage::
952 * Mise en forme personnalisée des titrages::
953 * Mise en forme personnalisée des entête et pied de page::
957 @node Mise en forme personnalisée des champs de titrage
958 @unnumberedsubsubsec Mise en forme personnalisée des champs de titrage
959 @translationof Custom text formatting for title blocks
961 Toutes les commandes de mise en forme d'un @code{\markup} permettent de
962 personnaliser le texte des entête, pied de page et éléments de titrage
963 contenus dans un bloc @code{\header}.
965 @lilypond[quote,verbatim,noragged-right]
969 piece = \markup { \fontsize #4 \bold "PRAELUDIUM I" }
970 opus = \markup { \italic "BWV 846" }
977 @ref{Mise en forme du texte}.
980 @node Mise en forme personnalisée des titrages
981 @unnumberedsubsubsec Mise en forme personnalisée des titrages
982 @translationof Custom layout for titles
984 @cindex bookTitleMarkup
985 @cindex scoreTitleMarkup
986 @funindex bookTitleMarkup
987 @funindex scoreTitleMarkup
989 L'utilisation de commandes @code{\markup} au sein d'un bloc
990 @code{\header} permet de modifier aisément l'apparence du texte,
991 mais n'influence en rien le positionnement précis des éléments de
992 titrage. L'accès au positionnement des champs de titrage est géré par
993 les deux variables suivantes, attachées au bloc @code{\paper} :
996 @item @code{bookTitleMarkup}
997 @item @code{scoreTitleMarkup}
1000 Le positionnement des titres, avec les valeurs par défaut de ces
1001 variables @code{\markup}, est illustré à la rubrique
1002 @ref{Mise en forme par défaut des titrages subalternes}.
1004 Voici les réglages par défaut de @code{scoreTitleMarkup}, tels que
1005 définis dans le fichier @file{ly/titling-init.ly} :
1008 scoreTitleMarkup = \markup @{ \column @{
1009 \on-the-fly \print-all-headers @{ \bookTitleMarkup \hspace #1 @}
1011 \fromproperty #'header:piece
1012 \fromproperty #'header:opus
1018 Ceci aura donc pour effet de positionner les champs @code{piece} et
1019 @code{opus} sur la même ligne, en opposition :
1021 @lilypond[quote,verbatim,noragged-right]
1025 piece = "PRAELUDIUM I"
1031 Voici comment redéfinir le @code{scoreTitleMarkup} de telle sorte que le
1032 champ @code{piece}, dont nous modifions la taille et la graisse, se
1033 place au centre de cette ligne :
1035 @lilypond[papersize=a5,quote,verbatim,noragged-right]
1039 scoreTitleMarkup = \markup {
1042 \fontsize #4 \bold \fromproperty #'header:piece
1043 \fromproperty #'header:opus
1047 \header { tagline = ##f }
1051 piece = "PRAELUDIUM I"
1058 Les champs normalement absents du @code{\header} d'un bloc @code{\score}
1059 seront toutefois imprimés dès lors que vous aurez activé l'instruction
1060 @code{print-all-headers} au sein du bloc @code{\paper}. Le principal
1061 inconvénient de cette fonction réside dans le fait que les champs
1062 dévolus au titrage des parties devront être supprimés dans
1063 chacun des blocs @code{\score} de votre fichier source -- voir
1064 @ref{Généralités en matière de titrages}.
1066 Afin d'éviter ce désagrément, ajoutez le champ que vous désirez voir
1067 apparaître à la définition de @code{scoreTitleMarkup}. Nous allons,
1068 dans l'exemple suivant, ajouter au @code{scoreTitleMarkup} le champ
1069 @code{composer}, normalement associé au @code{bookTitleMarkup} ;
1070 chaque @code{\score} pourra alors mentionner un compositeur différent.
1072 @lilypond[papersize=a5,quote,verbatim,noragged-right]
1076 scoreTitleMarkup = \markup {
1079 \fontsize #4 \bold \fromproperty #'header:piece
1080 \fromproperty #'header:composer
1084 \header { tagline = ##f }
1089 composer = "Christian Petzold"
1096 composer = "François Couperin"
1102 Rien ne vous empêche de créer votre propre champ personnalisé, puis d'y
1103 faire référence dans la définition du @emph{markup}.
1105 @lilypond[papersize=a5,quote,verbatim,noragged-right]
1109 scoreTitleMarkup = \markup {
1112 \override #`(direction . ,UP) {
1114 \center-align \fontsize #-1 \bold
1115 \fromproperty #'header:mycustomtext %% User-defined field
1116 \center-align \fontsize #4 \bold
1117 \fromproperty #'header:piece
1120 \fromproperty #'header:opus
1124 \header { tagline = ##f }
1129 mycustomtext = "A 4 VOCI" %% User-defined field
1137 Manuel de notation :
1138 @ref{Généralités en matière de titrages}.
1141 @node Mise en forme personnalisée des entête et pied de page
1142 @unnumberedsubsubsec Mise en forme personnalisée des entête et pied de page
1143 @translationof Custom layout for headers and footers
1145 @c can make-header and make-footer be removed from
1146 @c paper-defaults-init.ly? -mp
1148 L'utilisation de commandes @code{\markup} au sein d'un bloc
1149 @code{\header} permet de modifier aisément l'apparence du texte,
1150 mais n'influence en rien le positionnement précis des entête et pied
1151 de page. L'accès au positionnement des champs concernés est géré par
1152 les quatre variables suivantes, attachées au bloc @code{\paper} :
1155 @item @code{oddHeaderMarkup}
1156 @item @code{evenHeaderMarkup}
1157 @item @code{oddFooterMarkup}
1158 @item @code{evenFooterMarkup}
1161 @cindex markup conditionnel
1162 @cindex condition et markup
1163 @cindex on-the-fly (à la volée)
1165 @funindex \on-the-fly
1167 L'instruction @code{\on-the-fly} au sein d'un @code{\markup} permet
1168 d'ajouter, lorsque certaines conditions sont respectées, des éléments
1169 au texte des entête et pied de page définis dans le bloc @code{\paper}.
1170 En voici la syntaxe :
1173 @code{variable} = @code{\markup} @{
1175 @code{\on-the-fly} \@var{procédure} @var{markup}
1180 La @var{procédure} est appelée à chaque fois que la commande
1181 @code{\markup} où elle apparaît est évaluée. La @var{procédure}
1182 effectuera un test de conformité particulier et interprètera, autrement
1183 dit imprimera l'argument @var{markup} si et seulement si cette
1184 condition est remplie.
1186 LilyPond dispose d'ores et déjà d'un certain nombre de procédures :
1189 @multitable {print-page-number-check-first-----} {ce n'est la première page du book--}
1191 @headitem Nom de la procédure @tab Condition testée
1193 @item print-page-number-check-first @tab il faut imprimer ce numéro de page.
1194 @item create-page-number-stencil @tab print-page-numbers est vrai.
1195 @item print-all-headers @tab print-all-headers est vrai.
1196 @item first-page @tab c'est la première page du @emph{book}.
1197 @item (on-page nombre) @tab numéro de page = nombre
1198 @item last-page @tab c'est la dernière page du @emph{book}.
1199 @item not-first-page @tab ce n'est la première page du @emph{book}.
1200 @item part-first-page @tab c'est la première page de la partie.
1201 @item part-last-page @tab c'est la dernière page de la partie.
1202 @item not-single-page @tab cette partie fait plus d'une page.
1207 L'exemple suivant illustre la manière de centrer son numéro au bas de
1208 chaque page. Il nous faut tout d'abord annuler les définitions de
1209 @code{oddHeaderMarkup} et @code{evenHeaderMarkup} à l'aide d'un
1210 @emph{markup} @code{\null}. Nous redéfinissons ensuite
1211 @code{oddFooterMarkup} pour qu'il contienne le numéro de page, centré.
1212 Enfin, nous appliquons le même paramétrage au @code{\oddFooterMarkup}.
1214 @lilypond[papersize=a8,quote,verbatim,noragged-right]
1217 print-page-number = ##t
1218 print-first-page-number = ##t
1219 oddHeaderMarkup = \markup \null
1220 evenHeaderMarkup = \markup \null
1221 oddFooterMarkup = \markup {
1223 \on-the-fly \print-page-number-check-first
1224 \fromproperty #'page:page-number-string
1227 evenFooterMarkup = \oddFooterMarkup
1230 \new Staff { s1 \break s1 \break s1 }
1235 Plusieurs conditions @code{\on-the-fly} mentionnées l'une à la suite de
1236 l'autre se cumulent. Ainsi, par exemple,
1239 @code{\on-the-fly \first-page}
1240 @code{\on-the-fly \last-page}
1241 @code{@{ \markup @dots{} \fromproperty #'header: @dots{} @}}
1244 teste si la sortie tient sur une page unique.
1247 Manuel de notation :
1248 @ref{Généralités en matière de titrages},
1249 @ref{Mise en forme par défaut des titrages subalternes}.
1251 fichiers d'initialisation :
1252 @file{../ly/titling-init.ly}.
1255 @node Notes de bas de page
1256 @subsection Notes de bas de page
1257 @translationof Creating footnotes
1259 @cindex bas de page, notes
1262 Les notes de bas de page sont utiles dans bien des situations. Dans
1263 tous les cas, un « appel de note » vient se placer en référence dans te
1264 texte ou la musique, et le « texte de la note » est reporté en bas de la
1267 Selon qu'elle est référencée dans une expression musicale ou dans du
1268 texte indépendant, une note de bas de page sera créée suivant une
1269 procédure différente.
1272 * Notes de bas de page dans une expression musicale::
1273 * Notes de bas de page dans du texte indépendant::
1277 @node Notes de bas de page dans une expression musicale
1278 @unnumberedsubsubsec Notes de bas de page dans une expression musicale
1279 @translationof Footnotes in music expressions
1281 @cindex musique et note de bas de page
1284 @subsubsubheading Généralités sur l'annotation de musique
1285 @c VO Music footnotes overview
1287 Il existe deux catégories d'annotation concernant une expression
1291 @item Les annotations événementielles
1292 se rattachent à des événements particuliers, comme une note individuelle,
1293 un élément d'interprétation (doigté, accent ou nuance) ou des événements
1294 postérieurs (liaison, ligature manuelle). Une note de bas de page
1295 événementielle se libelle généralement sous la forme :
1298 [@var{position}] \footnote [@var{marque}] @var{décalage} @var{annotation} @var{musique}
1301 @item Les annotations temporelles
1302 se rapportent à un point particulier du déroulement d'un contexte
1303 musical. Certaines commandes, telles @code{\time} et @code{\clef}, ne
1304 reposent pas sur un événement pour la création de l'objet métrique ou
1305 clef. Il en va de même pour un accord : sa hampe ou ses crochets ne
1306 sont créés qu'à la fin d'un moment (plus exactement au travers de l'un
1307 des événements note qui le composent). Il n'est pas possible de
1308 connaître assurément lequel des événements note d'un accord est
1309 plus particulièrement à l'origine de la hampe ou du crochet. Il
1310 est donc plus aisé, pour de tels éléments, d'utiliser des
1311 annotations temporelles.
1313 Une annotation temporelle permet d'annoter des objets de rendus
1314 sans se référer à un événement. Elle se libelle généralement sous
1318 \footnote [@var{marque}] @var{décalage} @var{annotation} [@var{Contexte}.]@var{nom-grob}
1323 Les arguments, quelle que soit la catégorie d'annotation, peuvent se
1328 Lorsque la commande @code{\footnote} s'applique à un élément
1329 d'interprétation ou un événement rattaché, et uniquement dans ces cas,
1330 elle doit être précédée d'un indicateur de positionnement (@code{-, _}
1331 ou @code{^}) de façon à rattacher @var{musique} (avec sa marque) à
1332 la note ou au silence qui précède.
1335 Un @emph{markup} ou une chaîne de caractères identifiant l'annotation
1336 tant au niveau de l'appel que de la note qui apparaîtra au bas de la
1337 page. L'absence de cet élément -- ou une valeur de @code{\default} --
1338 incrémentera automatiquement le compteur. Ce compteur est réinitialisé
1339 à chaque page comportant une annotation.
1342 Une paire de nombres -- @samp{#(2 . 1)} par exemple -- spécifiant le
1343 décalage de la marque, en abscisse et en ordonnée, par rapport au point
1344 de référence. Des valeurs positives décalent vers la droite ou le
1345 haut, des valeurs négatives vers la gauche ou le bas ; des valeurs à
1346 zéro centrent la marque sur le point de référence. Le décalage
1347 s'exprime en espace de portée.
1350 Le contexte auquel appartient l'objet à annoter. Cet argument
1351 peut être omis dès lors qu'il s'agit d'un contexte de bas niveau
1352 tel que @code{Voice}.
1355 Le type d'objet à annoter -- @samp{Flag} par exemple. Lorsque cet
1356 élément est spécifié, c'est l'objet en question qui servira de point de
1357 référence, même s'il trouve son origine non pas directement dans
1358 une expression musicale mais dans tout objet du type spécifié
1359 intervenant à cet instant précis de la partition.
1362 un @emph{markup} ou une chaîne de caractères qui sera reporté au bas de
1366 l'élément qui fait l'objet du commentaire, qu'il s'agisse d'un
1367 événement musical, de l'un des constituants d'un accord ou d'un
1373 @subsubsubheading Notes de bas de page événementielles
1374 @c VO Event-based footnotes
1376 @cindex événementielle, note de bas de page
1378 Ce type de note de bas de page s'attache à un objet de rendu
1379 généré directement par l'événement correspondant à @var{musique}.
1380 Il répond à la syntaxe :
1383 \footnote [@var{décalage}] @var{décalage} @var{annotation} @var{musique}
1387 @lilypond[quote,verbatim,papersize=a8landscape]
1389 \header { tagline = ##f }
1391 \footnote #'(-1 . 3) "Une note" a4
1393 \footnote #'(2 . 2) "Un silence" r4
1399 Un accord @emph{dans son intégralité} ne peut pas faire l'objet
1400 d'une note de bas de page événementielle : un accord, même s'il ne
1401 contient qu'une seule et unique note, ne génère aucun événement en
1402 propre. Une des notes @emph{au sein} de l'accord peut toutefois
1403 se voir attribuer une annotation :
1406 @lilypond[quote,verbatim,papersize=a8landscape]
1408 \header { tagline = ##f }
1410 \footnote #'(2 . 3) "Résultat non probant" <a-3>2
1411 <\footnote #'(-2 . -3) "Résultat probant" a-3>4
1412 <a-3 \footnote #'(3 . 1/2) "Tout aussi probant" c-5>4
1417 Lorsque l'annotation concerne un événement postérieur ou une
1418 articulation, la commande @code{\footnote} @strong{doit} être
1419 précédée d'un indicateur de position (@code{-, _} ou @code{^}) et
1420 suivie de l'événement postérieur ou l'articulation comme argument
1421 @var{musique}. Dans ce cas, la commande @code{\footnote} peut se
1422 considérer comme une copie de son dernier argument auquel on
1423 attache une annotation. La syntaxe consacrée est :
1426 @var{position} \footnote [@var{marque}] @var{décalage} @var{annotation} @var{musique}
1430 @lilypond[quote,verbatim,papersize=a8landscape]
1432 \header { tagline = ##f }
1434 a'4_\footnote #'(0 . -1) "Une liaison arbitrairement en dessous" (
1435 b8^\footnote #'(1 . 0.5) "Une ligature manuelle forcée en haut" [
1438 c-\footnote #'(1 . 1) "Tenuto" --
1443 Les appels de note peuvent être personnalisés, et le trait reliant
1444 l'objet à l'appel supprimé :
1447 @subsubsubheading Notes de bas de page temporelles
1448 @c VO Time-based footnotes
1450 @cindex temporelle, note de bas de page
1452 Lorsque la note de bas de page se réfère à un objet de rendu résultant
1453 d'un événement -- @code{Accidental} ou @code{Stem} découlent d'un
1454 @code{NoteHead} --, l'argument @var{nom-grob} de l'objet en question est
1455 requis après le texte de l'annotation, en lieu et place de
1459 @lilypond[quote,verbatim,papersize=a8landscape]
1461 \header { tagline = ##f }
1463 \footnote #'(-1 . -3) "Un bémol" Accidental
1465 \footnote #'(-1 . 0.5) "Un autre bémol" Accidental
1467 \footnote #'(1 . -2) "Une hampe" Stem
1473 Notez bien que, lorsque @var{nom-grob} est spécifié, tous les objets de
1474 ce type qui se trouvent à ce même instant se verront attacher une
1478 @lilypond[quote,verbatim,papersize=a8landscape]
1480 \header { tagline = ##f }
1482 \footnote #'(-1 . 3) "Un bémol" Accidental
1484 \footnote #'(2 . 0.5) "Une articulation" Script
1490 Une note incluse dans un accord peut individuellement se voir attribuer
1491 une annotation événementielle. Une tête de note (@code{NoteHead}) est
1492 le @emph{seul} objet directement généré par un constituant d'accord ;
1493 elle peut donc être affectée d'une annotation événementielle. Tous les
1494 autres objets constituant un accord sont générés indirectement. La
1495 commande @code{\footnote} ne dispose pas d'une syntaxe permettant de
1496 spécifier @emph{à la fois} un type d'objet @emph{et} un événement
1497 particulier auquel s'attacher. De tels objets pourront toutefois faire
1498 l'objet d'une annotation temporelle, préfixée d'un @code{\single} afin
1499 d'annoter l'événement directement consécutif :
1502 @lilypond[quote,verbatim,papersize=a8landscape]
1504 \header { tagline = ##f }
1506 < \footnote #'(1 . -2) "Un la" a
1507 \single \footnote #'(-1 . -1) "Un dièse" Accidental
1509 \single \footnote #'(0.5 . 0.5) "Un bémol" Accidental
1516 @warning{Lorsque plusieurs notes de bas de page se rapportent à un même
1517 empilement vertical comme ci-dessus, elles sont numérotées et
1518 apparaîtront selon l'ordre vertical des éléments présentés, autrement dit
1519 celui positionné le plus haut en premier, non dans leur ordre
1520 d'apparition dans le fichier source.}
1522 Les objets de rendu tels que changement de clef ou d'armure tirent leur
1523 origine dans la modification d'une propriété plutôt que d'un véritable
1524 événement. D'autres, comme les barres ou numéros de mesure, dépendent
1525 directement de la temporisation. C'est la raison pour laquelle de tels
1526 objets doivent s'annoter en fonction de leur survenance au fil de la
1527 musique. Les notes de bas de page temporelles sont la solution à
1528 privilégier lorsqu'il s'agit d'annoter les hampes ou ligatures affectant
1529 des accords : bien qu'une telle fonctionnalité puisse s'appliquer à l'un
1530 des événements constituant l'accord, rien ne laisse présager lequel
1531 serait le plus approprié.
1533 En matière de note de bas de page temporelle, l'objet de rendu considéré
1534 doit toujours être mentionné explicitement, ainsi que le contexte si
1535 l'objet est créé dans un autre contexte que celui du plus bas niveau.
1538 @lilypond[quote,verbatim,papersize=a8landscape]
1540 \header { tagline = ##f }
1543 \footnote #'(-0.5 . -1) "Changement de métrique" Staff.TimeSignature
1545 \footnote #'(1 . -1) "Hampe de l'accord" Stem
1547 \footnote #'(-0.5 . 1) "Barre de mesure" Staff.BarLine
1549 \footnote #'(0.5 . -1) "Changement d'armure" Staff.KeySignature
1556 Les appels de note peuvent être personnalisés, et le trait reliant
1557 l'objet à l'appel supprimé :
1560 @lilypond[quote,verbatim,papersize=a8landscape]
1562 \header { tagline = ##f }
1564 \footnote "*" #'(0.5 . -2) \markup { \italic "* La première note" }
1566 \footnote \markup { \super "$" } #'(0.5 . 1)
1567 \markup { \super "$" \italic " La deuxième note" }
1569 \once \override Score.FootnoteItem #'annotation-line = ##f
1570 b-\footnote \markup \tiny "+" #'(0.1 . 0.1)
1571 \markup { \super "+" \italic " Éditorial" } \p
1576 D'autres exemples de personnalisation des appels de note sont donnés à
1577 la rubrique @ref{Notes de bas de page dans du texte indépendant}.
1580 @node Notes de bas de page dans du texte indépendant
1581 @unnumberedsubsubsec Notes de bas de page dans du texte indépendant
1582 @translationof Footnotes in stand-alone text
1584 @cindex texte indépendant et note de bas de page
1586 De telles notes de bas de page affectent les @emph{markup} extérieurs
1587 aux expressions musicales. Il n'est pas nécessaire en pareil cas
1588 d'indiquer un point de référence par un trait ; l'appel de note vient
1589 juste s'accoler au @emph{markup} qui fait l'objet de l'annotation. Les
1590 appels de note peuvent être gérés automatiquement, auquel cas ils seront
1591 numériques, ou bien manuellement en fournissant un indicateur
1594 Les notes de bas de page concernant du texte indépendant se gèrent
1595 différemment selon qu'elles sont automatiques ou manuelles.
1598 @subsubsubheading Notes de bas de page automatiques dans du texte
1599 @c VO Footnotes in stand-alone text with automatic marks
1601 La syntaxe consacrée dans le cas d'une gestion automatique des appels
1605 \markup @{ @dots{} \auto-footnote @var{texte} @var{annotation} @dots{} @}
1608 Ses les éléments sont :
1613 le @emph{markup} ou la chaîne de caractères sur lequel porte
1617 un @emph{markup} ou une chaîne de caractères constituant le texte de
1618 l'annotation qui sera reportée en bas de page.
1624 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1626 \header { tagline = ##f }
1629 \auto-footnote "tune" \italic " By me"
1630 "is shown below. It is a"
1631 \auto-footnote "recent" \italic " Aug 2012"
1641 @subsubsubheading Notes de bas de page personnalisées dans du texte
1642 @c VO Footnotes in stand-alone text with custom marks
1644 La syntaxe consacrée dans le cas d'une gestion personnalisée des appels
1648 \markup @{ @dots{} \footnote @var{appel} @var{annotation} @dots{} @}
1651 Ses les éléments sont :
1656 un @emph{markup} ou une chaîne de caractères représentant l'appel de
1657 note affecté à ce point de référence. Notez bien que cette marque ne
1658 sera @strong{pas} reproduite automatiquement avant le texte proprement
1659 dit de l'annotation.
1662 un @emph{markup} ou une chaîne de caractères constituant le texte de
1663 l'annotation qui sera reportée en bas de page, précédé de l'@var{appel}.
1667 N'importe quel caractère simple tel que @code{*} ou @code{+} peut
1668 s'utiliser en tant qu'appel de note, comme nous l'avons vu à la rubrique
1669 @ref{Notes de bas de page dans une expression musicale}. D'autres
1670 caractères particuliers sont accessibles sous forme de raccourci -- voir
1671 la rubrique @ref{Équivalents ASCII} :
1673 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1675 \paper { #(include-special-characters) }
1676 \header { tagline = ##f }
1679 \footnote "*" \italic "* By me"
1680 "is shown below. It is a recent"
1681 \footnote \super † \concat {
1682 \super † \italic " Aug 2012"
1692 Un appel de note peut aussi se libeller sous la forme d'un point de code
1693 unicode -- voir la rubrique @ref{Unicode} :
1695 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1697 \header { tagline = ##f }
1700 \footnote \super \char##x00a7 \concat {
1701 \super \char##x00a7 \italic " By me"
1703 "is shown below. It is a recent"
1704 \footnote \super \char##x00b6 \concat {
1705 \super \char##x00b6 \italic " Aug 2012"
1716 Manuel d'initiation :
1717 @rlearning{Objets et interfaces}.
1719 Manuel de notation :
1720 @ref{Commentaires textuels},
1721 @ref{Équivalents ASCII},
1722 @ref{Indications textuelles},
1724 @ref{Liste des caractères spéciaux},
1727 Référence des propriétés internes :
1728 @rinternals{FootnoteEvent},
1729 @rinternals{FootnoteItem},
1730 @rinternals{FootnoteSpanner},
1731 @rinternals{Footnote_engraver}.
1734 Les notes de bas de page ne peuvent que s'empiler l'une au-dessus de
1735 l'autre ; elles ne seront jamais présentées à la queue leu leu.
1737 Silences multimesures, ligatures automatiques et paroles ne peuvent se
1738 voir affecter de note de bas de page.
1740 Les notes de bas de page peuvent générer des chevauchements quand elles
1741 sont trop nombreuses sur une même page.
1744 @node Référencement des numéros de page
1745 @subsection Référencement des numéros de page
1746 @translationof Reference to page numbers
1748 LilyPond vous permet, à l'aide de la commande @code{\label}, d'insérer
1749 des points de référence dans un ouvrage, aussi bien en dehors qu'au fil
1750 de la musique. Ce point de référence pourra être ensuite repris à
1751 l'intérieur d'un @emph{markup} ; vous pourrez même y ajouter le
1752 numéro de page grâce à la commande de @emph{markup} @code{\page-ref}.
1755 @lilypond[verbatim,papersize=a8landscape]
1756 \header { tagline = ##f }
1762 \pageBreak \mark A \label #'markA
1767 \markup { Le premier mouvement débute à la page \page-ref #'firstScore "0" "?" }
1768 \markup { Le repère A est à la page \page-ref #'markA "0" "?" }
1772 L'instruction @code{\page-ref} prend trois arguments :
1775 le point de référence, sous la forme d'un symbole Scheme, comme par
1776 exemple @code{#'firstScore},
1779 un « emporte-pièce » afin d'estimer la longueur totale du @emph{markup},
1783 un texte de remplacement au cas où la référence ne serait pas retrouvée.
1786 La présence de l'emporte-pièce est rendue nécessaire par le fait que les
1787 @emph{markups} sont générés avant que les sauts de page ne soient
1788 positionnés. Bien que le numéro de page en question ne soit pas encore
1789 déterminé, LilyPond doit connaître les dimensions de ce @emph{markup}.
1790 Vous pouvez, lorsque l'ouvrage contiendra plus de dix pages, stipuler un
1791 emporte-pièce sur deux caractères -- soit @code{"00"}.
1801 @node Table des matières
1802 @subsection Table des matières
1803 @translationof Table of contents
1805 La commande @code{\markuplist \table-of-contents} vous permettra de
1806 générer une table des matières. Les éléments qui la composeront sont
1807 créés par la commande @code{\tocItem}, insérée indépendamment ou au sein
1808 d'une expression musicale.
1811 \markuplist \table-of-contents
1814 \tocItem \markup "Premier mouvement"
1818 \tocItem \markup "Passage spécifique du premier mouvement"
1823 \tocItem \markup "Second mouvement"
1831 Les @emph{markups} dévolus à la mise en forme de la table des matières
1832 se définissent dans le bloc @code{\paper}. Il s'agit par défaut de
1833 @code{tocTitleMarkup} pour le titre de la table, et de
1834 @code{tocItemMarkup} pour ses éléments -- composés de leur libellé et
1835 numéro de page. Vous pouvez bien entendu personnaliser ces variables :
1839 %% Traduit le titre de la table des matières en français :
1840 tocTitleMarkup = \markup \huge \column {
1841 \fill-line { \null "Table des matières" \null }
1844 %% des fontes un peu plus grandes
1845 tocItemMarkup = \markup \large \fill-line {
1846 \fromproperty #'toc:text \fromproperty #'toc:page
1851 Notez bien la manière de référencer le libellé et le numéro de page dans
1852 la définition de @code{tocItemMarkup}.
1854 N'hésitez pas à définir vous-même d'autres commandes et @emph{markups}
1855 afin de construire une table plus élaborée :
1858 commencez par définir une nouvelle variable de type @code{markup} au
1859 sein du bloc @code{\paper},
1862 puis définissez une fonction musicale chargée d'insérer un élément de la
1863 table à partir de cette variable.
1866 Dans l'exemple qui suit, nous avons créé un nouveau style d'élément dans
1867 le but de mentionner les actes dans la table des matières d'un opéra :
1871 tocActMarkup = \markup \large \column {
1873 \fill-line { \null \italic \fromproperty #'toc:text \null }
1879 #(define-music-function (text) (markup?)
1880 (add-toc-item! 'tocActMarkup text))
1883 @lilypond[line-width=10.0\cm]
1884 \header { tagline = ##f }
1886 tocActMarkup = \markup \large \column {
1888 \fill-line { \null \italic \fromproperty #'toc:text \null }
1894 #(define-music-function (text) (markup?)
1895 (add-toc-item! 'tocActMarkup text))
1898 \markuplist \table-of-contents
1899 \tocAct \markup { Atto Primo }
1900 \tocItem \markup { Coro. Viva il nostro Alcide }
1901 \tocItem \markup { Cesare. Presti omai l'Egizzia terra }
1902 \tocAct \markup { Atto Secondo }
1903 \tocItem \markup { Sinfonia }
1904 \tocItem \markup { Cleopatra. V'adoro, pupille, saette d'Amore }
1909 L'élément et son numéro de page peuvent se rejoindre par une ligne
1912 @lilypond[verbatim,line-width=10.0\cm]
1913 \header { tagline = ##f }
1915 tocItemMarkup = \tocItemWithDotsMarkup
1919 \markuplist \table-of-contents
1920 \tocItem \markup { Allegro }
1921 \tocItem \markup { Largo }
1927 @funindex \table-of-contents
1928 @code{\table-of-contents},
1934 Fichiers d'initialisation :
1935 @file{../ly/toc-init.ly}.
1938 @node Travail sur des fichiers texte
1939 @section Travail sur des fichiers texte
1940 @translationof Working with input files
1943 * Insertion de fichiers LilyPond::
1944 * Différentes éditions à partir d'une même source::
1945 * Caractères spéciaux::
1949 @node Insertion de fichiers LilyPond
1950 @subsection Insertion de fichiers LilyPond
1951 @translationof Including LilyPond files
1954 @cindex inclusion de fichiers
1956 Lorsqu'un projet prend de l'importance en volume, il est judicieux de le
1957 scinder en plusieurs fichiers, auxquels vous ferez référence avec un
1961 \include "autrefichier.ly"
1964 Une ligne @code{\include "autrefichier.ly"} dans un fichier revient à
1965 recopier intégralement le contenu de @file{autrefichier.ly} à l'endroit
1966 même ou est placée l'instruction @code{\include}. Vous pouvez par
1967 exemple écrire un fichier individuel par instrument, puis les regrouper
1968 pour former le fichier @qq{conducteur}. Les différentes variables
1969 définies dans les fichiers séparés seront normalement reprises et
1970 utilisables dans le fichier formant le conducteur. Les sections
1971 balisées dans les fichiers individuels peuvent être réutilisées en
1972 différents endroit de la partition, comme expliqué à la rubrique
1973 @ref{Différentes éditions à partir d'une même source}.
1975 Lorsque le fichier auquel il est fait référence se trouve dans le même
1976 répertoire, donner seulement son nom en argument à la commande
1977 @code{\include} suffit. S'il se trouve ailleurs, vous devrez indiquer
1978 le chemin d'accès, absolu ou relatif, en respectant toutefois la syntaxe
1979 UNIX -- autrement dit, le séparateur de répertoire est une oblique
1980 normale @code{/} et non l'oblique inverse @code{\} de DOS ou Windows.
1981 Par exemple, si le fichier @file{truc.ly} se trouve dans le répertoire
1982 supérieur au répertoire de travail, la ligne devra être
1985 \include "../truc.ly"
1989 ou bien, si les fichiers correspondant aux parties d'orchestre se
1990 trouvent dans le sous-répertoire @file{parties} relativement au
1991 répertoire courant, vous devrez mentionner
1994 \include "parties/VI.ly"
1995 \include "parties/VII.ly"
1999 Les fichiers à inclure peuvent eux-mêmes contenir des instructions
2000 @code{\include}. Ces instructions @code{\include} de second niveau ne
2001 pourront, par défaut, être interprétées qu'une fois intégrées dans le
2002 fichier principal ; leur argument doit donc comporter le chemin
2003 relativement au fichier principal et non par rapport au fichier dans
2004 lequel cette inclusion est mentionnée. Vous pouvez toutefois influer
2005 sur ce comportement de manière globale à l'aide de l'option
2006 @w{@code{-drelative-includes}} en ligne de commande ou en ajoutant une
2007 clause @code{#(ly:set-option 'relative-includes #t)} en tête du fichier
2010 Lorsque @code{relative-include} est valorisé à @code{#t}, le chemin à
2011 suivre pour chacune des commandes @code{\include} sera pris relativement
2012 au fichier qui la contient. Cette option est vouée à être activée par
2013 défaut dans une future version de LilyPond.
2015 Selon l'endroit où @code{relative-includes} est valorisé à @code{#t} ou
2016 @code{#f}, la commande @code{\include} permettra d'incorporer des
2017 fichiers contenus dans l'arborescence du répertoire principal et des
2018 fichiers situés ailleurs. Si, par exemple, une biblothèque générale
2019 libA a été créée pour utiliser des sous-fichiers à l'aide
2020 d'inclusions dans un fichier catalogue, les clauses @code{\include}
2021 devront être précédées d'un
2022 @code{#(ly:set-option #relative-includes #t)} de telle sorte
2023 qu'elles soient interprétées correctement lorsque rapatriées dans
2024 le fichier @file{.ly} principal. Examinons cela dans les faits :
2035 puis le fichier catalogue, @code{libA.ly}, qui contient
2038 #(ly:set-option 'relative-includes #t)
2042 % retour au réglage par défaut
2043 #(ly:set-option 'relative-includes #f)
2046 Tout fichier @code{.ly} peut désormais consulter l'intégralité de cette
2047 bibliothèque grâce à un simple
2050 \include "~/libA/libA.ly"
2053 Un positionnement judicieux des commutateurs permet de gérer des
2054 structures de fichiers plus complexes.
2056 Vous pouvez inclure des fichiers dont vous spécifierez le chemin d'accès
2057 sur la ligne de commande au moment de lancer la compilation. L'appel à
2058 ces fichiers ne mentionnera alors que leur nom. Par exemple, si vous
2059 voulez compiler avec cette méthode le fichier @file{principal.ly} qui
2060 inclut des fichiers situés dans le sous-répertoire @file{parties},
2061 placez vous dans le répertoire contenant @file{principal.ly}, puis tapez
2064 lilypond --include=parties principal.ly
2067 tout en ayant bien dans @file{principal.ly}
2075 Lorsqu'un fichier est voué à être inclus dans nombre de partitions, vous
2076 pouvez le placer dans le répertoire de LilyPond @file{../ly}.
2077 Attention : ce répertoire varie selon votre installation, comme
2078 indiqué au chapitre @rlearning{Autres sources de documentation}. Ce
2079 fichier sera inclus dès lors que vous fournirez uniquement son nom en
2080 argument à la fonction @code{\include}. C'est par exemple le cas du
2081 fichier de définition particulier @file{gregorian.ly}.
2083 Au moment où vous lancez LilyPond, un certain nombre de fichiers se
2084 retrouvent inclus par défaut ; il suffit d'activer le mode verbeux
2085 en faisant @w{@code{lilypond --verbose}} pour s'en rendre compte. Vous
2086 verrez ainsi défiler, en plus de nombreuses informations, le nom d'un
2087 certain nombre de fichiers et de chemins d'accès. Les fichiers les plus
2088 important sont mentionnés au chapitre
2089 @rlearning{Autres sources de documentation}. Si vous venez à les
2090 modifier, rappelez-vous qu'ils seront écrasés à l'installation d'une
2091 nouvelle version de LilyPond.
2093 Vous trouverez quelques exemples simples d'utilisation de la commande
2094 @code{\include} au chapitre @rlearning{Conducteurs et parties}.
2097 Manuel d'initiation :
2098 @rlearning{Autres sources de documentation},
2099 @rlearning{Conducteurs et parties}.
2102 Lorsque vous incluez un fichier qui porte le même nom que l'un des
2103 fichiers d'initialisation de LilyPond, le fichier de la distribution de
2104 LilyPond aura préséance.
2107 @node Différentes éditions à partir d'une même source
2108 @subsection Différentes éditions à partir d'une même source
2109 @translationof Different editions from one source
2111 Plusieurs méthodes permettent de générer différentes versions d'une
2112 partition à partir d'une même source. Les variables -- ou
2113 identificateurs -- sont sûrement le moyen le plus simple de combiner de
2114 différente manière des passages relativement longs, alors que les
2115 balises permettront de sélectionner de courts fragments selon leur
2118 Quelle que soit la méthode utilisée, séparer la notation de la structure
2119 de la partition vous donnera plus de liberté dans l'agencement de
2120 l'ouvrage final, puisque vous ne reviendrez pas sur la musique qui le
2124 * Utilisation de variables::
2125 * Utilisation de balises::
2126 * Globalisation des réglages::
2130 @node Utilisation de variables
2131 @unnumberedsubsubsec Utilisation de variables
2132 @translationof Using variables
2134 @cindex variables, utilisation de
2136 Un fragment musical identifié par une variable est réutilisable à divers
2137 endroits de la partition, comme nous l'avons vu à la rubrique
2138 @rlearning{Organisation du code source avec des variables}. Par
2139 exemple, une partition pour chœur @notation{a cappella} comporte souvent
2140 une réduction pour piano reprenant toutes les voix ; il s'agit de
2141 la même musique, et vous ne devrez donc la saisir qu'une seule fois.
2142 D'autre part, la musique issue de deux variables peut se combiner sur
2143 une seule portée, comme nous l'avons vu à la rubrique
2144 @ref{Regroupement automatique de parties}. Prenons l'exemple suivant :
2146 @lilypond[verbatim,quote]
2147 sopranoMusic = \relative { a'4 b c b8( a) }
2148 altoMusic = \relative { e'4 e e f }
2149 tenorMusic = \relative { c'4 b e d8( c) }
2150 bassMusic = \relative { a4 gis a d, }
2151 allLyrics = \lyricmode {King of glo -- ry }
2153 \new Staff = "Soprano" \sopranoMusic
2154 \new Lyrics \allLyrics
2155 \new Staff = "Alto" \altoMusic
2156 \new Lyrics \allLyrics
2157 \new Staff = "Tenor" {
2161 \new Lyrics \allLyrics
2162 \new Staff = "Bass" {
2166 \new Lyrics \allLyrics
2169 \set Staff.printPartCombineTexts = ##f
2175 \set Staff.printPartCombineTexts = ##f
2185 Générer une partition chorale ou la réduction pour piano ne requiert que
2186 de modifier la structure des éléments, sans aucunement toucher à la
2189 Dans le cas d'une partition relativement longue, vous pouvez isoler la
2190 définition des différentes variables dans des fichiers séparés que vous
2191 rappellerez ensuite, comme indiqué à la rubrique
2192 @ref{Insertion de fichiers LilyPond}.
2195 @node Utilisation de balises
2196 @unnumberedsubsubsec Utilisation de balises
2197 @translationof Using tags
2200 @funindex \keepWithTag
2201 @funindex \removeWithTag
2204 @cindex regroupement de balises
2206 La commande @code{\tag #'@var{partieA}} affecte à une expression
2207 musicale le nom @var{partieA}. Les expressions ainsi balisées pourront
2208 être filtrées par la suite, à l'aide de @code{\keepWithTag #'@var{nom}}
2209 ou @code{\removeWithTag #'@var{nom}}. Ces filtres fonctionnent de la
2212 @multitable @columnfractions .5 .5
2217 Musique balisée précédée de @code{\keepWithTag #'@var{nom}} ou
2218 @code{\keepWithTag #'(@var{nom1} @var{nom2}@dots{})}
2219 @tab Musique non balisée et musique balisée par l'un des noms de
2220 balise fournis seront incluses ; la musique balisée
2221 autrement est exclue.
2224 Musique balisée précédée de @code{\removeWithTag #'@var{nom}} ou
2225 @code{\removeWithTag #'(@var{nom1} @var{nom2}@dots{})}
2226 @tab Musique non balisée et fragments appelés autrement que par
2227 l'un des noms fournis seront inclus ; la musique balisée
2228 par autre chose que les noms mentionnés est exclue.
2231 Musique balisée non précédée de @code{\keepWithTag} ou
2232 @code{\removeWithTag}
2233 @tab Musique balisée et non balisée seront incluses.
2237 L'argument des commandes @code{\tag}, @code{\keepWithTag} et
2238 @code{\removeWithTag} doit être un symbole ou une liste de symboles
2239 (tel que @code{#'conducteur} ou @code{#'(violonI violonII)}), suivi
2240 d'une expression musicale. Si, @emph{et seulement si} les symboles sont
2241 des indentifiants LilyPond valides (caractères alphabétiques uniquement,
2242 sans chiffre, souligné ou tiret) qui ne peuvent se confondre avec des
2243 notes, le @code{#'} peut s'omettre et, pour raccourcir, une liste de
2244 symbole peut utiliser le point en séparateur -- autrement dit,
2245 @code{\tag #'(violinI violinII)} peut s'écrire @code{\tag
2246 violinI.violinII}. Ceci s'applique aussi bien pour @code{\keepWithTag}
2247 que pour @code{\removeWithTag}.
2249 Dans l'exemple qui suit, nous obtenons deux versions du même extrait,
2250 l'une pour le conducteur, l'autre pour l'instrumentiste qui, elle,
2251 comportera les ornements développés.
2253 @lilypond[verbatim,quote]
2256 \tag #'trills { d8.\trill }
2257 \tag #'expand { \repeat unfold 3 { e32 d } }
2262 \keepWithTag #'trills \music
2265 \keepWithTag #'expand \music
2270 Il est parfois plus aisé d'exclure des fragments :
2272 @lilypond[verbatim,quote]
2275 \tag #'trills { d8.\trill }
2276 \tag #'expand {\repeat unfold 3 { e32 d } }
2281 \removeWithTag #'expand
2285 \removeWithTag #'trills
2290 Ce principe de filtrage peut s'appliquer aux articulations, textes, etc.
2291 Il suffit de positionner
2294 -\tag #@var{ma-balise}
2298 avant l'articulation ou le texte, comme ici :
2302 c1-\tag #'gaffe ^"Attention !"
2306 Ceci définira une note avec une indication conditionnelle de doigté ou
2309 Vous pouvez baliser différemment la même expression musicale en
2310 saisissant plusieurs @code{\tag} ou bien en combinant plusieurs
2311 balises dans une liste :
2313 @lilypond[quote,verbatim]
2314 music = \relative c'' {
2315 \tag #'a \tag #'both { a4 a a a }
2316 \tag #'(b both) { b4 b b b }
2319 \keepWithTag #'a \music
2320 \keepWithTag #'b \music
2321 \keepWithTag #'both \music
2325 L'application concomitante de plusieurs filtres @code{\removeWithTag} à
2326 la même expression musicale permet d'exclure plusieurs balisages.
2327 Une liste fournie en argument à un unique @code{\removeWithTag}
2328 produira le même effet :
2330 @lilypond[verbatim,quote]
2331 music = \relative c'' {
2332 \tag #'A { a4 a a a }
2333 \tag #'B { b4 b b b }
2334 \tag #'C { c4 c c c }
2335 \tag #'D { d4 d d d }
2341 \removeWithTag #'(B C)
2346 L'application de plus d'un filtre @code{\keepWithTag} à la même
2347 expression musicale aboutit à l'exclusion de @b{tous} les balisages.
2348 En effet, si le premier filtre exclut tous les autres balisages,
2349 l'application du second exclura les effets du premier.
2350 L'utilisation d'une unique commande @code{\keepWithTag} avec une
2351 liste de balises est en pareil cas des plus pertinente : seront
2352 exclus tous les fragments non concernés par l'une quelconque des
2353 balises mentionnées.
2355 @cindex regroupements de balises
2356 @cindex balises, regroupement
2359 Bien que @code{\keepWithTag} soit efficace pour gérer @emph{un} jeu
2360 d'alternatives, le rejet de musique filtrée par des balises
2361 @emph{étrangères} se révèle problématique lorsque les @code{\tag} sont
2362 utilisés à plusieurs fins. Des « groupements de balises » peuvent
2363 alors être déclarés :
2366 \tagGroup #'(violinI violinII viola cello)
2369 stipule que ces filtres respectifs appartiennent à un même groupe.
2372 \keepWithTag #'violinI @dots{}
2375 ne sera donc concerné que par les balises @code{violinI} contenues dans
2376 le groupe de filtres : tout élément de la musique incluse qui serait
2377 balisé par un ou plusieurs des filtres de ce jeu mais @emph{pas} par
2378 @code{violinI} sera rejeté.
2380 Pour toute commande @code{\keepWithTag}, seules les balises du
2381 regroupement mentionnées dans la commande seront visibles.
2383 Une balise ne peut faire partie que d'un seul regroupement.
2385 @funindex \pushToTag
2386 @funindex \appendToTag
2387 @cindex raccordement dans une balise
2389 Il peut arriver que vous ayez besoin de raccorder quelque chose en un
2390 point particulier d'une expression musicale. Les commandes
2391 @code{\pushToTag} et @code{\appendToTag} permettent d'insérer du
2392 matériau, qu'il soit antérieur ou postérieur, à des @code{éléments}
2393 d'une construction musicale existante. La musique séquentielle ou
2394 simultanée comporte assurément des @code{éléments} :
2396 @lilypond[verbatim,quote]
2397 test = { \tag #'here { \tag #'here <<c''>> } }
2400 \pushToTag #'here c'
2401 \pushToTag #'here e'
2402 \pushToTag #'here g' \test
2403 \appendToTag #'here c'
2404 \appendToTag #'here e'
2405 \appendToTag #'here g' \test
2409 Ces deux instructions sont affectées d'une balise, le matériau à
2410 raccorder à chaque instance de la balise, et l'expression balisée.
2413 Manuel d'initiation :
2414 @rlearning{Organisation du code source avec des variables}.
2416 Manuel de notation :
2417 @ref{Insertion de fichiers LilyPond},
2418 @ref{Regroupement automatique de parties}.
2421 L'application d'un @code{\relative} à une expression musicale
2422 obtenue par filtrage à l'aide de @code{\keepWithTag} ou
2423 @code{\removeWithTag} peut générer des changements d'octave,
2424 puisque seules les hauteurs récupérées dans ce filtre seront
2425 prises en considération. Une instruction @code{\relative} qui
2426 précède les commandes @code{\keepWithTag} ou
2427 @code{\removeWithTag} permet d'éviter ce risque, dans la mesure où
2428 elle viendra « recaler » ces hauteurs récupérées.
2431 @node Globalisation des réglages
2432 @unnumberedsubsubsec Globalisation des réglages
2433 @translationof Using global settings
2435 @cindex include-settings
2437 Vous pouvez regrouper dans un fichier indépendant vos réglages
2438 personnels que vous inclurez au besoin :
2441 lilypond -dinclude-settings=MES_REGLAGES.ly MA_PARTITION.ly
2444 Vous pouvez ainsi stocker dans un fichier séparé vos réglages en matière
2445 de format de papier, de fontes utilisées ou vos définitions
2446 particulières. Selon le fichier de réglages que vous mentionnerez, vous
2447 obtiendrez facilement différentes éditions à partir d'une même source
2448 quelle qu'elle soit.
2450 Cette technique peut s'utiliser en combinaison avec des feuilles de
2451 styles, comme indiqué au chapitre @rlearning{Feuilles de style}.
2454 Manuel d'initiation :
2455 @rlearning{Feuilles de style},
2456 @rlearning{Organisation du code source avec des variables}.
2458 Manuel de notation :
2459 @ref{Insertion de fichiers LilyPond}.
2462 @node Caractères spéciaux
2463 @subsection Caractères spéciaux
2464 @translationof Special characters
2466 @cindex caractères spéciaux
2467 @cindex non-ASCII, caractères
2472 * Équivalents ASCII::
2476 @node Codage du texte
2477 @unnumberedsubsubsec Codage du texte
2478 @translationof Text encoding
2482 LilyPond utilise le jeu de caractères défini par le consortium Unicode
2483 et la norme ISO/CEI 10646. Chaque caractère est identifié par un
2484 nom unique et associé à un point de code, ce qui permet dans l'absolu de
2485 couvrir tous les langages. Unicode permet de coder tous les caractères
2486 utilisés par toutes les langues écrites du monde. LilyPond utilise le
2487 codage UTF-8 (UTF pour @emph{Unicode Transformation Format}) qui permet
2488 de représenter les caractères latins sur un octet et les autres sur une
2489 longueur allant jusqu'à quatre octets.
2491 L'apparence réelle des caractères est déterminée par les glyphes ou
2492 graphèmes tels que définis dans les différentes polices disponibles.
2493 Une police, ou une fonte, définit la mise en correspondance d'un
2494 sous-ensemble de points de code unicode en glyphes. LilyPond recourt à
2495 la bibliothèque Pango pour assurer le rendu des textes multilingues.
2497 LilyPond n'effectue aucune conversion d'encodage que ce soit. Ceci
2498 implique donc que tout texte -- un titre, des paroles ou même une
2499 instruction musicale -- comportant des caractères non ASCII soit
2500 codé en UTF-8. Le plus sûr moyen de saisir du texte de la sorte
2501 consiste à utiliser un éditeur supportant l'unicode et à enregistrer vos
2502 fichier en UTF-8. C'est le cas pour la plupart des éditeurs actuels,
2503 que ce soit vim, Emacs, jEdit et GEdit. Tous les systèmes Windows
2504 postérieurs à NT utilisent Unicode en natif ; même Notepad est
2505 capable d'éditer et sauvegarder un fichier en UTF-8 -- sans parler de
2506 l'excellente alternative qu'est BabelPad.
2508 La compilation d'un fichier LilyPond comportant des caractères non ASCII
2509 qui n'aurait pas été enregistré dans l'encodage UTF-8 vous renverra
2513 FT_Get_Glyph_Name () erreur : invalid argument
2516 Voici un exemple utilisant du texte en cyrillique, en hébreux et en
2520 %c No verbatim here as the code does not display correctly in PDF
2521 % Font settings for Cyrillic and Hebrew
2522 % Linux Libertine fonts contain Cyrillic and Hebrew glyphs.
2526 #:roman "Linux Libertine O,serif"
2527 #:sans "Linux Biolinum O,sans-serif"
2528 #:typewriter "Linux Libertine Mono O,monospace"
2533 bulgarian = \lyricmode {
2534 Жълтата дюля беше щастлива, че пухът, който цъфна, замръзна като гьон.
2538 hebrew = \lyricmode {
2539 זה כיף סתם לשמוע איך תנצח קרפד עץ טוב בגן.
2543 portuguese = \lyricmode {
2544 à vo -- cê uma can -- ção legal
2550 \addlyrics { \bulgarian }
2551 \addlyrics { \hebrew }
2552 \addlyrics { \portuguese }
2557 @unnumberedsubsubsec Unicode
2558 @translationof Unicode
2562 Lorsque vous avez besoin d'un caractère dont vous connaissez le point de
2563 code mais que votre éditeur ne permet pas de saisir directement, vous
2564 pouvez utiliser les instructions @code{\char ##xhhhh} ou
2565 @code{\char #dddd} au sein d'un bloc @code{\markup} -- @code{hhhh}
2566 et @code{dddd} correspondant respectivement à la valeur hexadécimale ou
2567 décimale. Même s'il est inutile de saisir les zéros superflus, il est
2568 de bon ton de stipuler les quatre caractères formant la représentation
2569 hexadécimale. Évitez cependant l'encodage UTF-8 d'un point de code
2570 après un @code{\char} ; les encodages UTF-8 comprennent un bit
2571 supplémentaire indiquant le nombre d'octets. Une table de
2572 correspondance entre les codes Unicode et le nom des caractères ainsi
2573 que leur code hexadécimal est disponible sur le site du consortium
2574 Unicode, @uref{http://www.unicode.org/}.
2576 Par exemple, @code{\char ##x03BE} et @code{\char #958} correspondent
2577 tous deux au caractère unicode U+03BE, dénommé @qq{Greek Small Letter
2580 Quel que soit le point de code spécifié de cette manière, il ne vous
2581 sera alors pas nécessaire d'enregistrer votre fichier en UTF-8. Vous
2582 devrez toutefois disposer d'une fonte contenant ce caractère qui soit
2583 accessible à LilyPond.
2585 L'exemple suivant illustre la manière d'insérer un caractère sous sa
2586 forme hexadécimale, à la fois dans un repère, dans une articulation,
2587 dans des paroles et dans du texte indépendant.
2589 @lilypond[quote,verbatim]
2592 c''1 \mark \markup { \char ##x03EE }
2593 c1_\markup { \tiny { \char ##x03B1 " to " \char ##x03C9 } }
2595 \addlyrics { O \markup { \concat { Ph \char ##x0153 be! } } }
2597 \markup { "Copyright 2008--2015" \char ##x00A9 }
2602 Le signe @emph{copyright} dans le champ de titrage consacré s'inscrit de
2603 la manière suivante :
2607 copyright = \markup @{ \char ##x00A9 "2008" @}
2612 @node Équivalents ASCII
2613 @unnumberedsubsubsec Équivalents ASCII
2614 @translationof ASCII aliases
2616 Dès lors que vous aurez inclus la liste de leur équivalent ASCII,
2617 LilyPond reconnaîtra un certain nombre de caractères spéciaux :
2619 @lilypond[quote,verbatim]
2621 #(include-special-characters)
2624 \markup "&flqq; – &OE;uvre incomplète… &frqq;"
2627 \new Staff { \repeat unfold 9 a'4 }
2629 This is al -- so wor -- kin'~in ly -- rics: –_&OE;…
2634 "The replacement can be disabled:"
2635 "– &OE; …"
2636 \override #'(replacement-alist . ()) "– &OE; …"
2640 L'extension de cette liste est possible aussi bien de manière globale :
2642 @lilypond[quote,verbatim]
2644 #(add-text-replacements!
2645 '(("100" . "hundred")
2646 ("dpi" . "dots per inch")))
2648 \markup "A 100 dpi."
2651 qu'en un point particulier de votre source :
2653 @lilypond[quote,verbatim]
2654 \markup \replace #'(("100" . "hundred")
2655 ("dpi" . "dots per inch")) "A 100 dpi."
2659 Manuel de notation :
2660 @ref{Liste des caractères spéciaux}.
2662 Fichiers d'initialisation :
2663 @file{ly/text-replacements.ly}.
2666 @node Contrôle des sorties
2667 @section Contrôle des sorties
2668 @translationof Controlling output
2671 * Extraction de fragments musicaux::
2672 * Ignorer des passages de la partition::
2673 * Formats de sortie alternatifs::
2674 * Changement des fontes musicales::
2678 @node Extraction de fragments musicaux
2679 @subsection Extraction de fragments musicaux
2680 @translationof Extracting fragments of music
2682 @cindex fragments, extraction
2684 @funindex clip-regions
2686 LilyPond permet d'extraire des fragments d'une partition, une fois
2687 definis explicitement le ou les emplacements de la musique concernés au
2688 sein du bloc @code{\layout} du fichier source, grâce à la fonction
2689 @code{clip-regions}, puis en lançant @command{lilypond} avec l'option
2690 @w{@code{-dclip-systems}}.
2697 (make-rhythmic-location 5 1 2)
2698 (make-rhythmic-location 7 3 4)))
2703 L'exemple ci-dessus permet d'extraire un seul fragment @emph{débutant}
2704 après une blanche dans la cinquième mesure (@code{5 1 2}) et
2705 @emph{finissant} après trois noires dans la septième
2706 mesure (@code{7 3 4}).
2708 D'autres fragments seront extraits dès lors que d'autres paires de
2709 @w{@code{make-rhythmic-location}} auront été ajoutées à la liste de
2710 @w{@code{clip-regions}} présente dans le bloc @code{\layout}.
2712 Chaque fragment sera généré individuellement sous la forme d'un fichier
2713 @code{EPS}, converti en @code{PDF} ou @code{PNG} selon le format que
2714 vous aurez stipulé. La musique extraite est rendue comme si elle avait
2715 été littéralement « découpée » dans la partition. Par voie de
2716 conséquence, un fragment dépassant une ligne fera l'objet d'autant de
2717 fichiers séparés que de lignes de la partition complète.
2720 Manuel de notation :
2721 @ref{Le bloc layout}.
2723 Manuel d'utilisation :
2724 @rprogram{Utilisation en ligne de commande}.
2727 @node Ignorer des passages de la partition
2728 @subsection Ignorer des passages de la partition
2729 @translationof Skipping corrected music
2731 @funindex skipTypesetting
2732 @funindex showFirstLength
2733 @funindex showLastLength
2735 Dans un travail de transcription ou de recopie de la musique, ce qui
2736 vous intéresse plus particulièrement se situe à la fin, là même où vous
2737 en êtes dans la notation. Dans le but de gagner du temps dans le
2738 processus de correction, vous pouvez @qq{escamoter} le reste et ne
2739 générer que les dernières mesures en insérant
2742 showLastLength = R1*5
2743 \score @{ @dots{} @}
2747 dans votre fichier source. Ceci aura pour effet de ne générer que les
2748 cinq dernières mesures -- si tant est que le morceau soit à 4/4 -- de
2749 tous les @code{\score} de votre fichier. Dans le cas d'un œuvre
2750 conséquente, cette pratique s'avère fort utile puisqu'elle évite de tout
2751 générer. Vous pourriez aussi être amené à retravailler le début d'une
2752 œuvre, pour y ajouter une partie par exemple, auquel cas c'est la
2753 propriété @code{showFirstLength} que vous utiliserez.
2755 Vous pouvez contrôler très finement les parties à escamoter, grâce au
2756 commutateur @code{Score.skipTypesetting} : lorsqu'il est activé,
2757 aucune gravure n'est réalisée.
2759 Ce commutateur agit aussi sur la sortie MIDI. Notez bien que tous les
2760 événements seront escamotés, y compris les changements de tempo ou
2761 d'instrument -- vous voilà prévenu !
2763 @lilypond[quote,ragged-right,verbatim]
2766 \set Score.skipTypesetting = ##t
2769 \set Score.skipTypesetting = ##f
2774 Dans le cadre de musique polyphonique, @code{Score.skipTypesetting}
2775 s'applique à toutes les voix et portées. Vous gagnerez donc encore plus
2779 @node Formats de sortie alternatifs
2780 @subsection Formats de sortie alternatifs
2781 @translationof Alternative output formats
2783 @cindex scalable vector graphics
2784 @cindex SVG, format de sortie
2785 @cindex encapsulated postscript
2786 @cindex EPS, format de sortie
2788 En matière de partition imprimable, LilyPond génère par défaut des
2789 documents au format PostScript (PS) et Portable Document Format (PDF).
2790 Vous pouvez aussi obtenir des documents au format Scalable Vector
2791 Graphics (SVG), Encapsulated PostScript (EPS) ou Portable Network
2792 Graphics (PNG) dès lors que vous aurez lancé LilyPond en ligne de
2793 commande avec l'option @i{ad hoc} -- voir
2794 @rprogram{Utilisation en ligne de commande} à ce sujet.
2797 @node Changement des fontes musicales
2798 @subsection Changement des fontes musicales
2799 @translationof Replacing the notation font
2801 Gonville est une alternative à la fonte Feta que LilyPond utilise par
2802 défaut. Vous pouvez la télécharger à partir de
2804 @uref{http://www.chiark.greenend.org.uk/~sgtatham/gonville/ ,http://www.chiark.greenend.org.uk/~sgtatham/gonville/}
2807 Voici quelques mesures utilisant la police Gonville :
2809 @c NOTE: these images are a bit big, but that's important
2810 @c for the font comparison. -gp
2811 @sourceimage{Gonville_after,15cm,,}
2813 Et ces même mesures avec la police de LilyPond, Feta :
2815 @sourceimage{Gonville_before,15cm,,}
2818 @subsubheading Instructions d'installation pour MacOS
2819 @translationof Installation Instructions for MacOS
2821 Téléchargez puis décompressez l'archive zip. Recopiez le répertoire
2822 @code{lilyfonts} dans @file{@var{SHARE_DIR}/lilypond/current} -- voir
2823 @rlearning{Autres sources de documentation} à ce sujet. Renommez le
2824 répertoire @code{fonts} qui s'y trouve en @code{fonts_orig}, puis le
2825 répertoire @code{lilyfonts} en @code{fonts}. Il vous suffira, pour
2826 retrouver la fonte Feta, de renommer @code{fonts_orig} en @code{fonts}.
2829 Manuel d'initiation :
2830 @rlearning{Autres sources de documentation}.
2833 Gonville ne permet pas de générer de la notation ancienne, et certains
2834 glyphes ajoutés depuis lors aux jeux de caractères en soient absent.
2835 Consultez le site de l'auteur pour de plus amples informations ainsi
2836 qu'à propos des conditions d'utilisation.
2839 @node Génération de fichiers MIDI
2840 @section Génération de fichiers MIDI
2841 @translationof Creating MIDI output
2846 LilyPond peut produire des fichiers conformes au standard MIDI (Musical
2847 Instrument Digital Interface), ce qui permet de vérifier le rendu à
2848 l'oreille grace à un logiciel ou un périphérique sachant interpréter le
2849 MIDI. L'écoute du rendu en MIDI permet de contrôler aisément ce que
2850 vous avez saisi : octaves et altérations erronées heurteront votre
2853 Les fichiers MIDI, contrairement aux fichiers AAC, MP3 ou Vorbis, ne
2854 contiennent pas de son et nécessitent donc le recours à un logiciel
2855 supplémentaire pour les écouter.
2858 * Notation prise en compte dans le MIDI::
2859 * Notation non prise en compte dans le MIDI::
2861 * Gestion des nuances en MIDI::
2862 * Gestion des instruments MIDI::
2863 * Gestion des répétitions en MIDI::
2864 * Affectation des canaux MIDI::
2865 * Propriétés de contextes et effets MIDI::
2866 * Amélioration du rendu MIDI::
2869 @node Notation prise en compte dans le MIDI
2870 @subsection Notation prise en compte dans le MIDI
2871 @translationof Supported notation for MIDI
2873 @cindex MIDI, éléments pris en compte
2875 LilyPond retranscrit par défaut dans un fichier MIDI les éléments de
2879 @item les marques de respiration,
2880 @item les accords nommés,
2881 @item les crescendos et decrescendos s'étendant sur plusieurs notes --
2882 le volume s'ajuste linéairement entre les deux extrêmes,
2883 @item les indications de nuance, de @code{ppppp} à @code{fffff}, y compris
2884 @code{mp}, @code{mf} et @code{sf},
2885 @item les microtonalités mais @emph{pas} sous forme d'accord ; leur
2886 rendu nécessite cependant un lecteur qui prenne en charge la
2890 @item le rythme sous forme de durée de note, y compris les n-olets,
2891 @item les articulations « simples » comme staccato, staccatissimo,
2892 accent, marcato et portato,
2893 @item les changements de tempo indiqués par un @code{\tempo},
2894 @item les liaisons de tenue,
2895 @item les tremolos, excepté ceux utilisant la syntaxe
2896 « @code{:}[@var{nombre}] ».
2899 Spatialisation, balance, expression, réverbération et chorus peuvent se
2900 contrôler à l'aide de propriétés de contexte -- voir
2901 @ref{Propriétés de contextes et effets MIDI}.
2903 En combinaison avec le script @file{articulate}, d'autres éléments
2904 seront aussi reportés en MIDI :
2907 @item les appogiatures -- celles-ci prendront la moitié de la valeur,
2908 dépourvue de point, de la note qui les suit -- par exemple,
2911 \appoggiatura c8 d2.
2915 le do (noté @code{c}) prendra la valeur d'une noire.
2917 @item les ornements (mordants, trilles et groupettos, etc.),
2918 @item rallentando, accelerando, ritardando et a tempo,
2919 @item les liaisons y compris de phrasé,
2924 Voir @ref{Amélioration du rendu MIDI}.
2927 @node Notation non prise en compte dans le MIDI
2928 @subsection Notation non prise en compte dans le MIDI
2929 @translationof Unsupported notation for MIDI
2931 @cindex MIDI, éléments non pris en comte
2933 Certains éléments de notation ne peuvent être retranscrits dans un
2937 @item les articulations autres que staccato, staccatissimo, accent, marcato
2939 @item les crescendos et decrescendos sur @emph{une seule} note,
2940 @item les points d'orgue,
2941 @item la basse chiffrée,
2942 @item les glissandos,
2943 @item les chutes ou sauts,
2944 @item les accords en microtonalité,
2945 @item le rythme indiqué sous forme d'annotation, comme « swing »,
2946 @item les changements de tempo indiqués sous forme d'annotation (sans
2948 @item les trémolos indiqués par la syntaxe « @code{:}[@var{nombre}] ».
2953 @subsection Le bloc MIDI
2954 @translationof The MIDI block
2956 @cindex MIDI, le bloc
2958 LilyPond générera un fichier MIDI dès que vous ajouterez un bloc
2959 @code{\midi}, même vide, au sein du bloc @code{\score} :
2963 @var{@dots{}musique@dots{}}
2969 @warning{Lorsque le bloc @code{@bs{}score} contient uniquement un bloc
2970 @code{@bs{}midi} (autrement dit pas de bloc @code{@bs{}layout}),
2971 LilyPond produira uniquement la sortie MIDI -- aucun support visuel ne
2974 L'extension par défaut des fichiers MIDI générés (@code{.midi}) peut se
2975 modifier en ligne de commande :
2978 lilypond -dmidi-extension=mid MonFichier.ly
2981 Une autre manière de procéder consiste à placer la ligne suivante au
2982 début de votre fichier source, avant l'ouverture de tout bloc
2983 @code{\book}, @code{\bookpart} ou @code{\score} -- voir
2984 @ref{Structure de fichier} :
2987 #(ly:set-option 'midi-extension "mid")
2991 Manuel de notation :
2992 @ref{Structure de fichier}.
2994 Fichiers d'initialisation :
2995 @file{scm/midi.scm}.
2998 Le standard MIDI dispose de 15 canaux plus un (le numéro 10) affecté aux
2999 percussions. Les portées sont assignées l'une après l'autre à un canal.
3000 Dans la mesure où une partition comporte plus de 15 portées, les portées
3001 au-delà de la quinzième partageront un même canal MIDI, sans toutefois
3002 l'écraser. Ceci peut entraîner des conflits au niveau des canaux en
3003 raison des propriétés MIDI, notamment l'instrument utilisé.
3005 @node Gestion des nuances en MIDI
3006 @subsection Gestion des nuances en MIDI
3007 @translationof Controlling MIDI dynamics
3009 @cindex MIDI, gestion des nuances
3011 Le volume général de la sortie MIDI peut se définir, ainsi que ses
3012 modulations, en fonction des indications de nuance et les volumes
3013 relatifs entre les différents instruments.
3015 Les indications de nuance se traduisent automatiquement en niveau de
3016 volume dans l'amplitude disponible en MIDI alors que crescendos et
3017 diminuendos auront une progression linéaire entre les extrêmes.
3020 * Indication des nuances en MIDI::
3021 * Réglage du volume en MIDI::
3022 * Réglage de propriétés dans le bloc MIDI::
3026 @node Indication des nuances en MIDI
3027 @unnumberedsubsubsec Indication des nuances en MIDI
3028 @translationof Dynamic marks in MIDI
3030 @cindex MIDI, indications de nuance
3032 Les indications de nuance, de @code{ppppp} à @code{fffff} -- y compris
3033 @code{mp}, @code{mf} et @code{sf} -- ont des valeurs prédéfinies. Ce
3034 coefficient est alors appliqué pour corriger le volume général de façon
3035 à obtenir le niveau sonore qui sera retranscrit dans le fichier de
3036 sortie pour la nuance considérée. Nous allons, par défaut, de 0,25 pour
3037 un @notation{ppppp} à 0,95 pour un @notation{fffff}. Les
3038 correspondances entre nuance et fraction de volume sont répertoriées
3039 dans le fichier @file{scm/midi.scm}.
3042 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
3043 {creating-custom-dynamics-in-midi-output.ly}
3046 Fichiers d'initialisation :
3047 @file{ly/script-init.ly},
3048 @file{scm/midi.scm}.
3053 Référence des propriétés internes :
3054 @rinternals{Dynamic_performer}.
3056 @node Réglage du volume en MIDI
3057 @unnumberedsubsubsec Réglage du volume en MIDI
3058 @translationof Setting MIDI volume
3060 @cindex MIDI, réglage du volume
3062 Les valeurs extrêmes du volume MIDI des nuances se contrôlent à l'aide
3063 des propriétés @code{midiMinimumVolume} et @code{midiMaximumVolume} qui
3064 agissent au niveau @code{Score}. Ces propriétés sont effectives dès
3065 lors qu'une nuance est indiquée ; une nuance de départ explicite est donc
3066 requise pour que le volume soit ajusté dès le début de la partition.
3067 Vous pouvez alors modifier la fraction correspondant à chaque nuance à
3068 l'aide de la formule
3071 midiMinimumVolume + (midiMaximumVolume - midiMinimumVolume) * fraction
3074 Voici comment ajuster les nuances tout en limitant l'amplitude du volume
3081 \set Staff.midiInstrument = #"flute"
3082 @var{@dots{} music @dots{}}
3085 \set Staff.midiInstrument = #"clarinet"
3086 @var{@dots{} music @dots{}}
3092 midiMinimumVolume = #0.2
3093 midiMaximumVolume = #0.5
3099 La définition de l'amplitude du volume MIDI au niveau d'un contexte
3100 @code{Staff} -- grace aux propriétés @code{midiMinimumVolume} et
3101 @code{midiMaximumVolume} -- permet en quelque sorte d'égaliser un
3107 \set Staff.midiInstrument = #"flute"
3108 \set Staff.midiMinimumVolume = #0.7
3109 \set Staff.midiMaximumVolume = #0.9
3110 @var{@dots{} musique @dots{}}
3116 Dans le cas d'une partition à plusieurs portées et différents
3117 instruments, les volumes relatifs entre les différents instruments se
3118 gèrent individuellement :
3124 \set Staff.midiInstrument = #"flute"
3125 \set Staff.midiMinimumVolume = #0.7
3126 \set Staff.midiMaximumVolume = #0.9
3127 @var{@dots{} music @dots{}}
3130 \set Staff.midiInstrument = #"clarinet"
3131 \set Staff.midiMinimumVolume = #0.3
3132 \set Staff.midiMaximumVolume = #0.6
3133 @var{@dots{} music @dots{}}
3140 La clarinette de cet exemple jouera relativement moins fort que la
3143 En l'absence de tout réglage des propriétés de volume, LilyPond
3144 appliquera cependant un léger degré d'égalisation pour certains
3145 instruments -- voir @file{scm/midi.scm}.
3148 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
3149 {replacing-default-midi-instrument-equalization.ly}
3152 Fichiers d'initialisation :
3153 @file{scm/midi.scm}.
3155 Manuel de notation :
3156 @ref{Mise en forme de la partition}.
3158 Référence des propriétés internes :
3159 @rinternals{Dynamic_performer}.
3162 Les modifications apportées au volume MIDI n'interviennent que sur
3163 l'attaque d'une note, en conséquence de quoi crescendos et decrescendos
3164 n'affecteront pas le volume s'ils se produisent sur une même et unique
3168 @node Réglage de propriétés dans le bloc MIDI
3169 @unnumberedsubsubsec Réglage de propriétés dans le bloc MIDI
3170 @translationof Setting MIDI block properties
3172 Le bloc @code{\midi} peut contenir des aménagements pour certains
3173 contextes, la définition de contextes particuliers ou du code permettant
3174 de déterminer la valeur de certaines propriétés.
3178 @var{@dots{} music @dots{}}
3185 Le tempo est ici réglé à 72 noires par minute. Une indication de tempo
3186 inscrite dans le bloc @code{\midi} ne sera pas reportée sur la partition
3187 imprimable. Cependant, tout @code{\tempo} mentionné dans le bloc
3188 @code{\score} sera répercuté dans la sortie MIDI.
3190 Placée au sein d'un bloc @code{\midi}, la commande @code{\tempo}
3191 détermine des propriétés lors de la phase d'interprétation de la musique
3192 et dans le contexte de définition des sorties. Elle est alors
3193 considérée comme une modification de contexte.
3195 @cindex MIDI, définition de contexte
3196 @cindex contexte, définition en MIDI
3198 La syntaxe permettant de définir un contexte pour le @code{\midi} est en
3199 tout point identique à celle que vous utilisez dans le bloc
3204 @var{@dots{} musique @dots{}}
3208 \remove "Dynamic_performer"
3214 Ces quelques lignes ont pour effet de supprimer l'application des
3215 nuances à la sortie MIDI. Vous aurez noté que les modules de traduction
3216 de LilyPond en matière de son s'appelent @emph{performers} -- des
3220 Manuel d'initiation :
3221 @rlearning{Autres sources de documentation}.
3223 Manuel de notation :
3224 @ref{Mise en forme de la partition},
3225 @ref{Signes d'interprétation}.
3227 Fichiers d'initialisation :
3228 @file{ly/performer-init.ly}.
3233 Référence des propriétés internes :
3234 @rinternals{Dynamic_performer}.
3237 Certains lecteurs MIDI ne rendent pas correctement les changements de
3240 Les modifications de @code{midiInstrument} ou autres options MIDI en
3241 début de portée peuvent se retrouver dédoublées dans la sortie MIDI.
3243 @node Gestion des instruments MIDI
3244 @subsection Gestion des instruments MIDI
3245 @translationof Using MIDI Instruments
3247 @cindex instrument, nom d'
3248 @cindex MIDI, instruments
3249 @funindex Staff.midiInstrument
3251 L'instrument MIDI est déterminé par la propriété @code{midiInstrument},
3252 au sein d'un contexte @code{Staff}.
3257 \set Staff.midiInstrument = #"glockenspiel"
3258 @var{@dots{} music @dots{}}
3268 \new Staff \with @{midiInstrument = #"cello"@} @{
3269 @var{@dots{} music @dots{}}
3275 Lorsque l'instrument choisi ne correspond pas exactement à l'une des
3276 dénominations consacrées, LilyPond le remplacera par un piano de concert
3277 (@code{"acoustic grand"}) -- voir @ref{Instruments MIDI}.
3280 Manuel d'initiation :
3281 @rlearning{Autres sources de documentation}.
3283 Manuel de notation :
3284 @ref{Instruments MIDI},
3285 @ref{Mise en forme de la partition}.
3287 Référence des propriétés internes :
3288 @rinternals{Dynamic_performer}.
3290 Fichiers d'initialisation :
3291 @file{scm/midi.scm}.
3294 Les percussions gérées par un contexte @code{DrumStaff} sont affectées
3295 directement au canal 10 qui leur est réservé. Certains instruments, tels
3296 le xylophone, le marimba, le vibraphone ou les timbales, se traitent
3297 cependant comme des instruments « classiques » puisqu'ils sont capables
3298 d'émettre des hauteurs différentes ; leur notation relève donc d'un
3299 contexte @code{Staff} standard, et non d'un @code{DrumStaff} pour
3300 pouvoir être rendus correctement en MIDI. Une liste complète des
3301 percussions affectées au canal 10 (@code{channel 10 drum-kits}) est
3302 disponible dans le fichier @file{scm/midi.scm} -- voir
3303 @rlearning{Autres sources de documentation}.
3306 @node Gestion des répétitions en MIDI
3307 @subsection Gestion des répétitions en MIDI
3308 @translationof Using repeats with MIDI
3310 @cindex reprises développées
3311 @cindex MIDI et reprises
3312 @funindex \unfoldRepeats
3314 Les reprises de toutes sortes peuvent être rendues dans le fichier MIDI.
3315 Il suffit pour cela de recourir à la fonction @code{\unfoldRepeats}, qui
3316 développe toutes les reprises.
3321 \repeat tremolo 8 @{ c'32 e' @}
3322 \repeat percent 2 @{ c''8 d'' @}
3323 \repeat volta 2 @{ c'4 d' e' f' @}
3333 Lorsque l'on veut utiliser @code{\unfoldRepeats} seulement pour le rendu
3334 MIDI, il faut établir @b{deux} blocs @code{\score} : un pour le MIDI,
3335 avec des reprises explicites, et l'autre pour la partition, avec des
3336 reprises notées sous forme de barres de reprise, de trémolo ou de
3337 symboles de pourcentage. Par exemple
3341 @var{@dots{} musique @dots{}}
3345 \unfoldRepeats @var{@dots{} musique @dots{}}
3350 Dans une partition comportant plusieurs voix, le développement des
3351 reprises ne sera effectif en MIDI qu'à la condition que ces reprises
3352 soient mentionnée correctement dans @strong{toutes} les voix.
3355 Manuel de notation :
3356 @ref{Répétitions et reprises}.
3360 @node Affectation des canaux MIDI
3361 @subsection Affectation des canaux MIDI
3362 @translationof MIDI channel mapping
3364 @cindex MIDI, canaux
3365 @cindex MIDI, pistes
3366 @funindex midiChannelMapping
3368 Lorsque LilyPond génère un fichier MIDI à partir d'une partition, chaque
3369 note contenue dans cette partition sera automatiquement assignée à un
3370 canal MIDI, celui sur lequel elle devrait être jouée quand elle est
3371 transmise à un périphérique MIDI. Chaque canal MIDI dispose d'un
3372 certain nombre de contrôles pour, par exemple, sélectionner l'instrument
3373 +qui jouera les notes de ce canal ou bien demander au périphérique MIDI
3374 d'appliquer différents effets au son produit sur ce canal. En tout état
3375 de cause, chaque contrôle d'un canal MIDI ne peut se voir affecté que
3376 d'une seule valeur à la fois -- celle-ci peut toutefois être modifiée
3377 pour, par exemple, changer d'instrument au milieu du morceau.
3379 Le standard MIDI ne dispose que de 16 canaux par périphérique MIDI.
3380 Cette limite du nombre de canaux entraîne une limitation du nombre
3381 d'instruments pouvant jouer de concert.
3383 LilyPond crée une piste MIDI séparée pour chaque portée (ou chaque
3384 instrument ou voix selon la valeur de @code{Score.midiChannelMapping})
3385 ainsi que pour chaque contexte de paroles. Il n'y a pas de limite au
3388 Afin de contourner la limitation du nombre de canaux MIDI, LilyPond
3389 dispose de différents modes d'allocation d'un canal MIDI grâce à la
3390 propriété de contexte @code{Score.midiChannelMapping}. Dans tous les
3391 cas, lorsque la limite au nombre de canaux est atteinte, LilyPond repart
3392 du canal 0, ce qui peut affecter des notes au mauvais instrument. Cette
3393 propriété de contexte peut prendre les valeurs suivantes :
3399 Allocation d'un canal MIDI particulier à chacune des portées de la
3400 partition (option par défaut). Toutes les notes de toutes les voix
3401 d'une même portée partageront le canal MIDI affecté à la portée qui les
3402 englobe, et toutes seront encodées dans la même piste.
3404 La limite des 16 canaux s'applique au nombre total de portées augmenté
3405 des contextes de paroles même si les paroles MIDI n'occupent pas de
3408 @item @code{'instrument}
3410 Allocation d'un canal MIDI particulier à chaque instrument MIDI tel que
3411 spécifié dans la partition. En d'autre termes, des notes jouées par un
3412 même instrument MIDI partageront le même canal MIDI (et la même piste),
3413 même si elles proviennent de voix ou portées différentes.
3415 Dans ce cas particulier, les contextes de paroles ne sont pas pris en
3416 compte dans la limite des 16 canaux, puisqu'ils ne sont pas assignés à
3417 un instrument MIDI, ce qui permet une meilleure allocation des canaux
3418 MIDI lorsque le nombre de portées et de contextes de paroles dépasse 16.
3422 Allocation d'un canal MIDI particulier à chaque voix de la partition
3423 portant un nom unique parmi les voix de la portée considérée. Des voix
3424 appartenant à des portées différentes seront toujours affectées à des
3425 canaux MIDI différents, mais deux voix partageant la même portée
3426 partageront le même canal MIDI dès lors qu'elles porteront le même nom.
3427 Dans la mesure où @code{midiInstrument} et les différents contrôles
3428 d'effets MIDI sont des propriétés affectant le contexte de portée, ils
3429 ne peuvent se déterminer individuellement pour une voix. La première
3430 voix adoptera l'instrument et les effets spécifiés pour cette portée, et
3431 les voix dénommées différemment de la première se verront attribué
3432 l'instrument et le effets par défaut.
3434 Note : l'affectation d'instruments ou d'effets différents aux
3435 differentes voix d'une même portée s'obtient dès lors que le
3436 @code{Staff_performer} est déplacé du contexte @code{Staff} au contexte
3437 @code{Voice} tout en maintenant le @code{midiChannelMapping} dans le
3438 contexte @code{'staff} ou en le réglant sur @code{'instrument}.
3442 Par exemple, l'affectation par défaut des canaux MIDI d'une partition
3443 peut être réglée sur @code{'instrument} comme ceci :
3451 midiChannelMapping = #'instrument
3458 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
3459 {changing-midi-output-to-one-channel-per-voice.ly}
3462 @node Propriétés de contextes et effets MIDI
3463 @subsection Propriétés de contextes et effets MIDI
3464 @translationof Context properties for MIDI effects
3468 @cindex spatialisation (pan), MIDI
3469 @cindex stéréo MIDI, balance
3470 @cindex balance MIDI
3471 @cindex expression MIDI
3474 @funindex midiPanPosition
3475 @funindex midiBalance
3476 @funindex midiExpression
3477 @funindex midiReverbLevel
3478 @funindex midiChorusLevel
3480 Les différentes propriétés de contexte qui suivent permettnt d'appliquer
3481 différents effets MIDI aux notes contenues dans le canal MIDI associé à
3482 la portée courante, à l'instrument ou à la voix, selon la valeur
3483 affectée à la propriété de contexte @code{Score.midiChannelMapping} et
3484 le contexte dans lequel le @code{Staff_performer} réside -- voir
3485 @ref{Affectation des canaux MIDI}.
3487 Une adaptation de ces propriétés de contexte affectera toutes les notes
3488 jouées sur ce canal dès leur modification. Certains effets pourront
3489 même s'appliquer sur des notes déjà en cours, selon l'implémentation du
3490 périphérique de sortie MIDI.
3492 LilyPond dispose des propriétés de contexte suivantes :
3496 @item @code{Staff.midiPanPosition}
3498 La spatialisation (@emph{pan position}) contrôle le positionnement d'un
3499 canal MIDI entre les sorties stéréo droite et gauche. Cette propriété
3500 de contexte prend en argument une valeur entre -1.0 (@code{#LEFT})
3501 et 1.0 (@code{#RIGHT}). Une valeur de -1.0 enverra toute la puissance
3502 sonore sur le haut-parleur gauche (le droit sera silencieux), une
3503 vaaleur de 0.0 (@code{#CENTER}) distribuera équitablement le son entre
3504 les jaut-parleurs de gauche et de droite, et une valeur de 1.0 enverra
3505 tout le son sur le haut-parleur de droite. Des valeurs entre -1.0 et
3506 1.0 permettent d'obtenir une répartition du son entre les sorties
3507 gauche et droite d'un équipement stéréophonique.
3510 @item @code{Staff.midiBalance}
3512 La balance stéréo d'un canal MIDI. Tout comme la spatialisation, cette
3513 propriété de contexte prend en argument une valeur comprise entre -1.0
3514 (@code{#LEFT}) et 1.0 (@code{#RIGHT}). Elle permet de faire varier le
3515 volume relatif envoyé aux deux haut-parleurs stéréo sans pour autant
3516 affecter la distribution des signaux stéréo.
3518 @item @code{Staff.midiExpression}
3520 Le niveau d'expression, en tant que fraction du niveau maximum de volume
3521 disponible, à appliquer à un canal MIDI. Un périphérique MIDI combine
3522 le niveau d'expression des canaux MIDI et le niveau de nuance de la voix
3523 en cours (tel que défini par @code{\p} ou @code{\ff}) afin d'obtenir le
3524 volume total de chacune des notes de la voix. Un contrôle de
3525 l'expression permet, par exemple, d'implémenter des effets de crescendo
3526 ou decrescendo sur une note tenue, ce que LilyPond ne sait pas faire
3529 @c Issue 4059 contains an attached snippet which shows how this might
3530 @c be done, but this is too large and complex for the NR, even as a
3531 @c referenced snippet. It could be added to the LSR.
3533 Le niveau d'expression varie entre 0.0 (sans expression, autrement dit
3534 volume à zéro) et 1.0 (volume au maximum).
3536 @item @code{Staff.midiReverbLevel}
3538 Le niveau de réverbération, en tant que fraction du niveau maximum
3539 disponible, à appliquer à un canal MIDI. Cette propriété prend en
3540 argument une valeur entre 0.0 (pas d'écho) et 1.0 (effet maximal).
3542 @item @code{Staff.midiChorusLevel}
3544 Le niveau de chœur, en tant que fraction du niveau maximum disponible, à
3545 appliquer à un canal MIDI. Cette propriété prend en argument une valeur
3546 entre 0.0 (pas de chorus) et 1.0 (effet maximal).
3552 Dans la mesure où les fichiers MIDI ne comportent effectivement aucune
3553 donnée audio, les modifications des propriétés de contexte ne se
3554 traduisent qu'en requêtes de changement des contrôles du canal MIDI
3555 lorsque ces fichiers MIDI sont joués. La manière dont un périphérique
3556 MIDI particulier, tel un synthétiseur MIDI logiciel, gérera ces
3557 requêtes incluses dans un fichier MIDI dépend complètement de
3558 l'implémentation du périphérique : certains d'entre eux pourront
3559 simplement ignorer plusieurs, voire toutes ces requêtes. Par ailleurs,
3560 la manière dont un périphérique MIDI interprète les différentes valeurs
3561 de ces contrôles (en règle générale, le standard MIDI ne fixe le
3562 comportement qu'aux valeurs extrêmes de l'amplitude disponible pour
3563 chacun des contrôles) et leur modification alors qu'une note sur un
3564 canal est tenue, dépend de l'implémentation particulière à ce
3567 Lors de la génération d'un fichier MIDI, LilyPond transforme simplement
3568 les valeurs fractionnaires dans l'amplitude linéaire en valeurs entières
3569 correspondantes (de 0 à 127 et sur 7 octets, ou de 0 à 32767 et sur 14
3570 octets pour les contrôles MIDI supportant une résolution fine). Ces
3571 valeurs entières converties sont stockées telles quelles dans le
3572 fichier MIDI généré. Pour plus d'information sur la manière dont un
3573 périphérique MIDI interprète ces valeurs, se reporter à sa
3577 @node Amélioration du rendu MIDI
3578 @subsection Amélioration du rendu MIDI
3579 @translationof Enhancing MIDI output
3581 Le fichier MIDI généré par LilyPond est relativement brut. Il peut
3582 toutefois être amélioré en affectant des instruments MIDI, en réglant
3583 des propriétés au sein du bloc @code{\midi} ou en utilisant le script
3587 * Le script articulate::
3591 @node Le script articulate
3592 @unnumberedsubsubsec Le script @file{articulate}
3593 @translationof The articulate script
3595 @cindex MIDI, instruments
3596 @cindex articulate, script
3597 @funindex Staff.midiInstrument
3599 L'utilisation du script @file{articulate} se fait après avoir ajouté en
3600 tête de fichier la commande @code{\include} appropriée :
3603 \include "articulate.ly"
3606 Le script créera une sortie MIDI dont les notes seront échelonées de
3607 sorte à tenir compte de toute articulation ou changement de tempo. La
3608 sortie imprimable sera toutefois modifiée en profondeur, pour refléter
3609 littéralement la sortie MIDI.
3614 @var{@dots{} musique @dots{}}
3620 Le script @file{articulate} tient compte des abréviations telles que les
3621 trilles ou groupettos. L'intégralité des éléments traités est
3622 répertoriée dans le script lui-même -- voir @file{ly/articulate.ly}.
3625 Manuel d'initiation :
3626 @rlearning{Autres sources de documentation}.
3628 Manuel de notation :
3629 @ref{Mise en forme de la partition}.
3631 Fichiers d'initialisation :
3632 @file{ly/articulate.ly}.
3634 @warning{Dans la mesure où le script @file{articulate} tend à raccourcir
3635 les accords, certaines musiques, notamment pour l'orgue, paraîtront de
3636 moins bonne qualité. Les notes dépourvues d'articulation peuvent aussi
3637 se voir raccourcies ; pour pallier cet inconvénient, le recours à la
3638 fonction @code{@bs{}articulate} devrait ne concerner que de courts
3639 fragments, sauf à modifier les valeurs des variables contenues dans le
3640 script @file{articulate}.}
3643 @node Extraction d'informations musicales
3644 @section Extraction d'informations musicales
3645 @translationof Extracting musical information
3647 En plus de générer du graphisme et du MIDI, LilyPond peut présenter
3648 l'information musicale sous forme textuelle.
3651 * Affichage de notation au format LilyPond::
3652 * Affichage de la musique sous forme d'expression Scheme::
3653 * Enregistrement d'événements musicaux dans un fichier::
3657 @node Affichage de notation au format LilyPond
3658 @subsection Affichage de notation au format LilyPond
3659 @translationof Displaying LilyPond notation
3661 @funindex \displayLilyMusic
3663 La fonction musicale @code{\displayLilyMusic} permet d'afficher en
3664 notation LilyPond une expression musicale. Le résultat défilera dans le
3665 terminal après avoir lancé LilyPond en ligne de commande. Par exemple,
3669 \displayLilyMusic \transpose c a, @{ c4 e g a bes @}
3676 @{ a,4 cis4 e4 fis4 g4 @}
3679 LilyPond affichera le résultat sous forme de message en console, au
3680 milieu de toutes les informations de compilation. Afin d'isoler ces
3681 messages et enregistrer le résultat de la fonction
3682 @code{\displayLilyMusic}, pensez à rediriger la sortie vers un fichier.
3685 lilypond fichier.ly > affichage.txt
3690 Vous noterez que LilyPond ne se contente pas de simplement afficher
3691 l'expression musicale, mais procède aussi à son interprétation -- du
3692 fait que @code{\displayLilyMusic} renvoie l'expression tout en
3693 l'affichant. S'il est bien pratique d'insérer un
3694 @code{\displayLilyMusic} dans une expression musicale pour en obtenir
3695 des informations, l'interprétation de cette expression peut toutefois
3696 être évitée en ajoutant un @code{\void} avant l'instruction :
3700 \void \displayLilyMusic \transpose c a, @{ c4 e g a bes @}
3705 @node Affichage de la musique sous forme d'expression Scheme
3706 @subsection Affichage de la musique sous forme d'expression Scheme
3707 @translationof Displaying scheme music expressions
3709 Voir @rextend{Affichage d'expressions musicales}.
3712 @node Enregistrement d'événements musicaux dans un fichier
3713 @subsection Enregistrement d'événements musicaux dans un fichier
3714 @translationof Saving music events to a file
3716 LilyPond vous permet de sauvegarder dans un fichier séparé, sur la base
3717 de la portée, les événements musicaux. Vous devrez pour ce faire
3718 inclure dans votre fichier maître un fichier d'initialisation
3722 \include "event-listener.ly"
3725 Pour chaque portée que comporte votre partition, vous obtiendrez un
3726 fichier @file{NOMFICHIER-PORTÉENOMMÉE.notes} ou
3727 @file{NOMFICHIER-unnamed-staff.notes}. Notez bien que si plusieurs
3728 portées ne sont pas explicitement nommées, tous leurs événements seront
3729 regroupés et mélangés dans le même fichier. Le résultat ressemblera à
3733 0.000 note 57 4 p-c 2 12
3735 0.250 note 62 4 p-c 7 12
3736 0.500 note 66 8 p-c 9 12
3737 0.625 note 69 8 p-c 14 12
3742 Il s'agit d'un tableau dont les colonnes sont délimitées par une
3743 tabulation. Chaque ligne comporte deux champs fixes suivis d'un certain
3744 nombre de paramètres optionnels.
3747 @var{temps} @var{type} @var{@dots{}paramètres@dots{}}
3750 Ces informations peuvent faire l'objet d'un retraitement par d'autres
3751 programmes, comme des scripts python, aux fins de recherche en analyse
3752 musicologique ou des expériences à partir du rendu de LilyPond.
3755 Tous les événements ne sont pas pris en charge par
3756 @file{event-listener.ly}. Il s'agit en premier lieu d'une
3757 démonstration, un @qq{proof of concept} du potentiel de LilyPond. Si
3758 certains des éléments que vous cherchez à obtenir n'apparaissent pas,
3759 recopiez le fichier @file{event-listener.ly} dans votre répertoire et
3760 modifiez-le de telle sorte qu'il travaille selon vos attentes.