1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
4 Translation of GIT committish: 3f80e0ae5eb8cea0a7a6a72fac289ea5d71d63c8
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}, et les réglages par défaut dans le fichier
399 @file{../ly/declarations-init.ly}.
402 Un bloc @code{\book} permet de regrouper naturellement plusieurs
403 mouvements -- autrement dit plusieurs blocs @code{\score} -- dans un
404 même document. Lorsqu'il y a plusieurs @code{\score}, LilyPond génère
405 un seul fichier dans lequel les mouvements sont mis les uns à la suite
406 des autres, ce pour chacun des blocs @code{\book} rencontrés. La seule
407 raison qui peut vous demander d'expliciter plusieurs blocs @code{\book}
408 dans un fichier @file{.ly} est lorsque vous avez besoin de générer
409 différents documents à partir d'une même source. La présence explicite
410 d'un bloc @code{\book} est aussi nécessaire lorsque vous travaillez sur
411 un document lilypond-book qui reprendrait plusieurs @code{\score} ou
412 @code{\markup} dans un même extrait. Vous pouvez modifier ce
413 comportement à l'aide de la variable @code{toplevel-book-handler}
414 placée en tête. Le gestionnaire par défaut est défini dans le fichier
415 d'initialisation @file{../scm/lily.scm}.
418 Un bloc @code{\bookpart}. Un ouvrage peut se découper en plusieurs
419 parties à l'aide de blocs @code{\bookpart}, aussi bien pour alléger le
420 travail de l'algorithme de calcul des sauts de page, que si les réglages
421 du bloc @code{\paper} diffèrent d'une partie à l'autre.
424 Une expression musicale telle que
429 Ce bout de code sera placé dans un @code{\score} et intégré à l'ouvrage
430 en même temps que tous les autres @code{\score} ou expressions
431 musicales. En d'autres termes, un fichier qui ne contiendrait que cette
432 simple expression musicale sera traduit en
449 Vous pouvez modifier ce comportement à l'aide de la variable
450 @code{toplevel-music-handler} placée en tête. Le gestionnaire par
451 défaut est défini dans le fichier d'initialisation
452 @file{../scm/lily.scm}.
455 Du texte sous forme de @emph{markup} comme les paroles d'un couplet
458 2. Le première ligne du deuxième couplet.
462 De tels @emph{markups} seront imprimés là où ils apparaissent,
463 avant, après ou entre les expressions musicales.
466 @cindex identificateurs
469 Une variable, ou identificateur, telle que
471 toto = @{ c4 d e d @}
474 Vous pourrez la réutiliser plus loin dans votre fichier en saisissant
475 simplement @code{\toto}. Le nom des identificateurs ne doit être
476 formés que de caractères alphabétiques -- sans chiffre ni caractère
481 Voici trois éléments que vous pouvez placer à un niveau supérieur :
485 % pas en pleine largeur
496 Vous pouvez placer, n'importe où dans votre fichier, les instructions
500 @item @code{\version}
501 @item @code{\include}
502 @item @code{\sourcefilename}
503 @item @code{\sourcefileline}
505 Une ligne de commentaire, introduite par le signe @code{%}.
508 Un bloc de commentaire, délimité par @code{%@{ @dots{} %@}}.
515 Vous pouvez insérer des espaces dans votre fichier source afin de lui
516 apporter une meilleure lisibilité. Les espaces superflus sont
517 normalement ignorés. Notez cependant qu'il est des cas où l'espace est
518 requis pour éviter tout risque d'erreur :
522 Autour d'une accolade, qu'elle soit ouvrante ou fermante ;
525 Après chaque commande ou variable, autrement dit tout élément qui
526 commence par un @code{\} ;
529 Après tout élément qui sera interprété comme une expression Scheme,
530 autrement dit tout élément qui commence par un @code{#} ;
533 Pour séparer les éléments d'une expression Scheme ;
536 En mode parole -- @code{lyricmode} -- avant et après les commandes
537 @code{\override} et @code{\set}.
542 Manuel d'initiation :
543 @rlearning{Organisation des fichiers LilyPond}.
546 @ref{Généralités en matière de titrages},
547 @ref{Le bloc layout}.
550 @node Titres et entêtes
551 @section Titres et entêtes
552 @translationof Titles and headers
558 La plupart de la musique qui est éditée comporte un titre et le nom de
559 son compositeur ; certains ouvrages dispensent beaucoup plus
563 * Création de titres et entête ou pied de page::
564 * Titrages personnalisés::
565 * Création des métadonnées des fichiers de sortie::
566 * Notes de bas de page::
567 * Référencement des numéros de page::
568 * Table des matières::
572 @node Création de titres et entête ou pied de page
573 @subsection Création de titres et entête ou pied de page
574 @translationof Creating titles headers and footers
577 * Généralités en matière de titrages::
578 * Mise en forme par défaut des titrages subalternes::
579 * Mise en forme par défaut des entête et pied de page::
583 @node Généralités en matière de titrages
584 @unnumberedsubsubsec Généralités en matière de titrages
585 @translationof Titles explained
587 Chaque bloc @code{\book} apparaissant dans un même fichier source
588 résultera en un fichier indépendant, comme indiqué à la rubrique
589 @ref{Structure de fichier}. Chacun de ces fichiers résultants comporte
590 trois endroits où placer des titrages : le @strong{titrage de l'ouvrage}
591 au début de chaque recueil (@emph{book}), les @strong{titrages de
592 partie} au début de chaque partie (@emph{bookpart}) et les
593 @strong{titrages de morceau} avant chaque pièce (@emph{score}).
595 La valeur des champs de titrage @code{title} (le titre) et
596 @code{composer} (le compositeur) se définissent dans des blocs
597 @code{\header} -- la syntaxe appropriée et la liste des différents
598 champs disponibles par défaut sont à la section
599 @ref{Mise en forme par défaut des titrages subalternes}.
600 Les titrages d'un ouvrage, de ses parties ou des morceaux qu'il contient
601 peuvent tous comporter les même champs bien que, par défaut, le titrage
602 d'un morceau se limite à @code{piece} et @code{opus}.
604 Les blocs @code{\header} peuvent se placer à quatre endroits différents
605 qui formeront une hiérarchie descendante :
610 En tête du fichier source, avant même tout bloc @code{\book},
611 @code{\bookpart} ou @code{\score} ;
614 Au sein d'un bloc @code{\book} et en dehors de tout bloc
615 @code{\bookpart} ou @code{\score} qu'il contient ;
618 Au sein d'un bloc @code{\bookpart} et en dehors de tout bloc
619 @code{\score} qu'il contient ;
622 Après l'expression musicale incluse dans un bloc @code{\score}.
626 La valeur des différents champs sera filtrée en respectant cette
627 hiérarchie ; les valeurs persisteront à moins d'être écrasées par une
628 autre valeur à un niveau inférieur. Ainsi :
632 Le titre d'un ouvrage découle des champs définis en tête de fichier
633 source, modifiés par les champs définis au sein du bloc @code{\book}.
634 Les champs résultants serviront à affecter un titre de recueil à
635 l'ouvrage, si tant est que quoi que ce soit génère une page au début de
636 cet ouvrage, avant la première partie -- un simple saut de page forcé
637 (@code{\pageBreak}) suffit.
640 Le titre d'une partie découle des champs définis en tête du fichier
641 source, modifiés par les champs définis au sein du bloc @code{\book}
642 puis par ceux définis au sein du bloc @code{\bookpart}. Les valeurs qui
643 en résulteront permettront d'imprimer les titrages de partie pour cette
647 Le titre d'un morceau découle des champs définis en tête du fichier
648 source, modifiés par les champs définis au sein du bloc @code{\book}
649 puis par ceux définis au sein du bloc @code{\bookpart}, et enfin par
650 ceux définis au sein du bloc @code{\score}. Les valeurs qui en
651 résulteront permettront d'imprimer les titrages de morceau pour ce
652 morceau. Notez toutefois que, pour un morceau, seuls les champs
653 @code{piece} et @code{opus} seront imprimés, à moins d'avoir valorisé
654 à @code{#t} la variable @code{print-all-headers} dans la section
659 @warning{N'oubliez pas que lorsqu'il est placé à l'intérieur d'un bloc
660 @code{@bs{}score}, le bloc @code{@bs{}header} doit impérativement se
661 trouver @strong{à la suite} de l'expression musicale.}
663 Nul n'est besoin de fournir un bloc @code{\header} à chacun des quatre
664 niveaux ; on peut se passer aussi bien de l'un d'eux que de tous. Dans
665 la même veine, un fichier source simpliste peut ne pas mentionner de
666 bloc @code{\book} ou @code{\bookpart} qui seront alors créés
669 Lorsque l'ouvrage ne comporte qu'un seul morceau, le bloc @code{\header}
670 devrait prendre place en tête de fichier, de telle sorte que soit produit
671 un titrage de partie qui met à disposition tous les champs de titrage.
673 Lorsque l'ouvrage comporte plusieurs morceaux, différents arrangements
674 du bloc @code{\header} permettent d'obtenir différents styles de
675 publication musicale. Par exemple, si la publication comprend plusieurs
676 pièces du même compositeur, un bloc @code{\header} placé en tête de
677 fichier définira le titre de l'ouvrage et le compositeur, que l'on
678 complètera par un bloc @code{\header} dans chaque bloc @code{\score}
679 pour définir les champs @code{piece} et @code{opus}, comme ici :
681 @lilypond[papersize=a5,quote,verbatim,noragged-right]
684 composer = "J. S. Bach."
688 \new Staff \relative {
691 \repeat unfold 2 { g,16( d' b') a b d, b' d, } |
692 \repeat unfold 2 { g,16( e' c') b c e, c' e, } |
700 \new Staff \relative {
704 <g, d' b'~>4 b'16 a( g fis) g( d e fis) g( a b c) |
705 d16( b g fis) g( e d c) b(c d e) fis( g a b) |
713 Des agencements plus élaborés sont aussi réalisables. Par exemple, les
714 champs appartenant au titrage principal d'un ouvrage peuvent se
715 reporter dans chaque bloc @code{\score}, certains étant modifiés voire
716 supprimés manuellement :
719 @lilypond[papersize=a5,quote,verbatim,noragged-right]
722 print-all-headers = ##t
725 title = "DAS WOHLTEMPERIRTE CLAVIER"
727 % Pas de mention spéciale par défaut pour cet ouvrage
730 \markup { \vspace #1 }
734 \new Staff { \clef "bass" s1 }
737 title = "PRAELUDIUM I"
739 % Pas de sous-titre pour ce morceau
746 \new Staff { \clef "bass" s1 }
750 subsubtitle = "A 4 VOCI"
752 % Pas de sous-titre pour ce morceau
761 @ref{Mise en forme par défaut des titrages subalternes},
762 @ref{Mise en forme personnalisée des titrages},
763 @ref{Structure de fichier}.
766 @node Mise en forme par défaut des titrages subalternes
767 @unnumberedsubsubsec Mise en forme par défaut des titrages subalternes
768 @translationof Default layout of bookpart and score titles
770 Voici les différentes variables imprimables attachées au bloc
774 @lilypond[papersize=a6landscape,quote,verbatim,noragged-right]
777 % Les champs suivants sont centrés
778 dedication = "Dédicace"
780 subtitle = "Sous-titre"
781 subsubtitle = "Sous-sous-titre"
782 % Les champs suivants sont répartis sur une même ligne, et
783 % le champ "instrument" apparaîtra sur les pages suivantes
784 instrument = \markup \with-color #green "Instrument"
786 composer = "Compositeur"
787 % Les champs suivants sont en opposition sur la même ligne
789 arranger = "Arrangeur"
790 % Les champs suivants sont centrés en bas de page
791 tagline = "Le « tagline » ou mention spéciale va en pied de dernière page"
792 copyright = "Le copyright va en pied de première page"
797 % Les champs suivants sont en opposition sur la même ligne
805 % Les champs suivants sont en opposition sur la même ligne
806 piece = "Pièce 2 sur la même page"
814 % Les champs suivants sont en opposition sur la même ligne
815 piece = "Pièce 3 sur une nouvelle page"
822 Quelques précisions :
826 Le nom de l'instrument sera répété en tête de chaque page.
829 Seuls seront imprimés les champs @code{piece} et @code{opus} inclus dans
830 un bloc @code{\score} dès lors que la variable @code{print-all-headers}
831 reste désactivée (valeur à @code{##f}).
834 @c Is the bit about \null markups true? -mp
835 Les champs d'un bloc @code{\header} qui n'auront pas été alimentés
836 seront remplacés par un @emph{markup} @code{\null} de façon à ne pas
840 Par défaut, @code{scoreTitleMarkup} place les champs @code{piece} et
841 @code{opus} de part et d'autre sur une même ligne.
845 Les possibilités de modifier la mise en forme par défaut sont abordées à
846 la rubrique @ref{Mise en forme personnalisée des titrages}.
850 Un bloc @code{\book} qui commencerait directement par un bloc
851 @code{\bookpart} ne verra pas ses titrages apparaître puisqu'il n'y a
852 aucune page où imprimer le titre. Si toutefois le titre de l'ouvrage
853 est requis, le bloc @code{\book} devra commencer par un @emph{markup} ou
854 une commande @code{\pageBreak}.
856 La variable @code{breakbefore} activée dans un bloc @code{\header} situé
857 dans un bloc @code{\score} force le saut de page avant le morceau
858 contenu dans ce @code{\score}. Vous pourrez ainsi séparer le titre
859 principal de la musique.
861 @lilypond[papersize=c7landscape,verbatim,noragged-right]
864 title = "This is my Title"
865 subtitle = "This is my Subtitle"
866 copyright = "This is the bottom of the first page"
869 \repeat unfold 4 { e'' e'' e'' e'' }
871 piece = "This is the Music"
879 Manuel d'initiation :
880 @rlearning{Organisation des fichiers LilyPond}.
883 @ref{Mise en forme personnalisée des titrages},
884 @ref{Structure de fichier}.
886 Fichiers d'initialisation :
887 @file{ly/titling-init.ly}.
890 @node Mise en forme par défaut des entête et pied de page
891 @unnumberedsubsubsec Mise en forme par défaut des entête et pied de page
892 @translationof Default layout of headers and footers
894 Les entête et pied -- @emph{header} et @emph{footer} -- sont des
895 lignes de textes qui apparaissent en haut et en bas de chaque page,
896 indépendamment du texte de l'ouvrage. Ils sont contrôlés par les
897 variables suivantes, attachées au bloc @code{\paper} :
900 @item @code{oddHeaderMarkup} -- entête de page impaire
901 @item @code{evenHeaderMarkup} -- entête de page paire
902 @item @code{oddFooterMarkup} -- pied de page impaire
903 @item @code{evenFooterMarkup} -- pied de page paire
906 Ces variables @emph{markup} n'accèdent qu'au contenu des champs du bloc
907 @code{\header} principal, celui qui s'appliquera à tous les blocs
908 @code{\score} du document. Ces variables sont définies dans le fichier
909 @file{ly/titling-init.ly}, et sont par défaut :
914 les numéros sont placés en haut à gauche (si pair) ou à droite (si
915 impair) de chaque page à compter de la deuxième ;
918 le contenu du champ @code{instrument} est centré en haut de chaque page
919 à compter de la deuxième ;
922 le texte du @code{copyright} est centré au bas de la première page ;
925 le @code{tagline} -- mention spéciale -- se place au bas de la dernière
926 page, ou bien sous le @code{copyright} s'il n'y a qu'une seule page.
930 Le texte de la mention spéciale par défaut se modifie en alimentant le
931 champ @code{tagline} au niveau du bloc @code{\header} principal.
933 @lilypond[papersize=a8landscape,verbatim]
936 tagline = "... la notation musicale pour Tous"
946 Pour supprimer le @code{tagline} par défaut, il suffit de lui assigner
947 la valeur @code{##f}.
950 @node Titrages personnalisés
951 @subsection Titrages personnalisés
952 @translationof Custom titles headers and footers
954 @c TODO: somewhere put a link to header spacing info
955 @c (you'll have to explain it more in NR 4).
958 * Mise en forme personnalisée des champs de titrage::
959 * Mise en forme personnalisée des titrages::
960 * Mise en forme personnalisée des entête et pied de page::
964 @node Mise en forme personnalisée des champs de titrage
965 @unnumberedsubsubsec Mise en forme personnalisée des champs de titrage
966 @translationof Custom text formatting for title blocks
968 Toutes les commandes de mise en forme d'un @code{\markup} permettent de
969 personnaliser le texte des entête, pied de page et éléments de titrage
970 contenus dans un bloc @code{\header}.
972 @lilypond[quote,verbatim,noragged-right]
976 piece = \markup { \fontsize #4 \bold "PRAELUDIUM I" }
977 opus = \markup { \italic "BWV 846" }
984 @ref{Mise en forme du texte}.
987 @node Mise en forme personnalisée des titrages
988 @unnumberedsubsubsec Mise en forme personnalisée des titrages
989 @translationof Custom layout for titles
991 @cindex bookTitleMarkup
992 @cindex scoreTitleMarkup
993 @funindex bookTitleMarkup
994 @funindex scoreTitleMarkup
996 L'utilisation de commandes @code{\markup} au sein d'un bloc
997 @code{\header} permet de modifier aisément l'apparence du texte,
998 mais n'influence en rien le positionnement précis des éléments de
999 titrage. L'accès au positionnement des champs de titrage est géré par
1000 les deux variables suivantes, attachées au bloc @code{\paper} :
1003 @item @code{bookTitleMarkup}
1004 @item @code{scoreTitleMarkup}
1007 Le positionnement des titres, avec les valeurs par défaut de ces
1008 variables @code{\markup}, est illustré à la rubrique
1009 @ref{Mise en forme par défaut des titrages subalternes}.
1011 Voici les réglages par défaut de @code{scoreTitleMarkup}, tels que
1012 définis dans le fichier @file{ly/titling-init.ly} :
1015 scoreTitleMarkup = \markup @{ \column @{
1016 \on-the-fly \print-all-headers @{ \bookTitleMarkup \hspace #1 @}
1018 \fromproperty #'header:piece
1019 \fromproperty #'header:opus
1025 Ceci aura donc pour effet de positionner les champs @code{piece} et
1026 @code{opus} sur la même ligne, en opposition :
1028 @lilypond[quote,verbatim,noragged-right]
1032 piece = "PRAELUDIUM I"
1038 Voici comment redéfinir le @code{scoreTitleMarkup} de telle sorte que le
1039 champ @code{piece}, dont nous modifions la taille et la graisse, se
1040 place au centre de cette ligne :
1042 @lilypond[papersize=a5,quote,verbatim,noragged-right]
1046 scoreTitleMarkup = \markup {
1049 \fontsize #4 \bold \fromproperty #'header:piece
1050 \fromproperty #'header:opus
1054 \header { tagline = ##f }
1058 piece = "PRAELUDIUM I"
1065 Les champs normalement absents du @code{\header} d'un bloc @code{\score}
1066 seront toutefois imprimés dès lors que vous aurez activé l'instruction
1067 @code{print-all-headers} au sein du bloc @code{\paper}. Le principal
1068 inconvénient de cette fonction réside dans le fait que les champs
1069 dévolus au titrage des parties devront être supprimés dans
1070 chacun des blocs @code{\score} de votre fichier source -- voir
1071 @ref{Généralités en matière de titrages}.
1073 Afin d'éviter ce désagrément, ajoutez le champ que vous désirez voir
1074 apparaître à la définition de @code{scoreTitleMarkup}. Nous allons,
1075 dans l'exemple suivant, ajouter au @code{scoreTitleMarkup} le champ
1076 @code{composer}, normalement associé au @code{bookTitleMarkup} ;
1077 chaque @code{\score} pourra alors mentionner un compositeur différent.
1079 @lilypond[papersize=a5,quote,verbatim,noragged-right]
1083 scoreTitleMarkup = \markup {
1086 \fontsize #4 \bold \fromproperty #'header:piece
1087 \fromproperty #'header:composer
1091 \header { tagline = ##f }
1096 composer = "Christian Petzold"
1103 composer = "François Couperin"
1109 Rien ne vous empêche de créer votre propre champ personnalisé, puis d'y
1110 faire référence dans la définition du @emph{markup}.
1112 @lilypond[papersize=a5,quote,verbatim,noragged-right]
1116 scoreTitleMarkup = \markup {
1119 \override #`(direction . ,UP) {
1121 \center-align \fontsize #-1 \bold
1122 \fromproperty #'header:mycustomtext %% User-defined field
1123 \center-align \fontsize #4 \bold
1124 \fromproperty #'header:piece
1127 \fromproperty #'header:opus
1131 \header { tagline = ##f }
1136 mycustomtext = "A 4 VOCI" %% User-defined field
1144 Manuel de notation :
1145 @ref{Généralités en matière de titrages}.
1148 @node Mise en forme personnalisée des entête et pied de page
1149 @unnumberedsubsubsec Mise en forme personnalisée des entête et pied de page
1150 @translationof Custom layout for headers and footers
1152 @c can make-header and make-footer be removed from
1153 @c paper-defaults-init.ly? -mp
1155 L'utilisation de commandes @code{\markup} au sein d'un bloc
1156 @code{\header} permet de modifier aisément l'apparence du texte,
1157 mais n'influence en rien le positionnement précis des entête et pied
1158 de page. L'accès au positionnement des champs concernés est géré par
1159 les quatre variables suivantes, attachées au bloc @code{\paper} :
1162 @item @code{oddHeaderMarkup}
1163 @item @code{evenHeaderMarkup}
1164 @item @code{oddFooterMarkup}
1165 @item @code{evenFooterMarkup}
1168 @cindex markup conditionnel
1169 @cindex condition et markup
1170 @cindex on-the-fly (à la volée)
1172 @funindex \on-the-fly
1174 L'instruction @code{\on-the-fly} au sein d'un @code{\markup} permet
1175 d'ajouter, lorsque certaines conditions sont respectées, des éléments
1176 au texte des entête et pied de page définis dans le bloc @code{\paper}.
1177 En voici la syntaxe :
1180 variable = \markup @{
1182 \on-the-fly \@var{procédure} @var{markup}
1187 La @var{procédure} est appelée à chaque fois que la commande
1188 @code{\markup} où elle apparaît est évaluée. La @var{procédure}
1189 effectuera un test de conformité particulier et interprètera, autrement
1190 dit imprimera l'argument @var{markup} si et seulement si cette
1191 condition est remplie.
1193 LilyPond dispose d'ores et déjà d'un certain nombre de procédures :
1196 @multitable {print-page-number-check-first-----} {ce n'est la première page du book--}
1198 @headitem Nom de la procédure @tab Condition testée
1200 @item print-page-number-check-first @tab il faut imprimer ce numéro de page.
1201 @item create-page-number-stencil @tab print-page-numbers est vrai.
1202 @item print-all-headers @tab print-all-headers est vrai.
1203 @item first-page @tab c'est la première page du @emph{book}.
1204 @item not-first-page @tab ce n'est pas la première page du @emph{book}.
1205 @item (on-page nombre) @tab numéro de page = nombre
1206 @item last-page @tab c'est la dernière page du @emph{book}.
1207 @item not-first-page @tab ce n'est la première page du @emph{book}.
1208 @item part-first-page @tab c'est la première page de la partie.
1209 @item not-part-first-page @tab ce n'est pas la première page de la partie.
1210 @item part-last-page @tab c'est la dernière page de la partie.
1211 @item not-single-page @tab cette partie fait plus d'une page.
1216 L'exemple suivant illustre la manière de centrer son numéro au bas de
1217 chaque page. Il nous faut tout d'abord annuler les définitions de
1218 @code{oddHeaderMarkup} et @code{evenHeaderMarkup} à l'aide d'un
1219 @emph{markup} @code{\null}. Nous redéfinissons ensuite
1220 @code{oddFooterMarkup} pour qu'il contienne le numéro de page, centré.
1221 Enfin, nous appliquons le même paramétrage au @code{\oddFooterMarkup}.
1223 @lilypond[papersize=a8,quote,verbatim,noragged-right]
1226 print-page-number = ##t
1227 print-first-page-number = ##t
1228 oddHeaderMarkup = \markup \null
1229 evenHeaderMarkup = \markup \null
1230 oddFooterMarkup = \markup {
1232 \on-the-fly \print-page-number-check-first
1233 \fromproperty #'page:page-number-string
1236 evenFooterMarkup = \oddFooterMarkup
1239 \new Staff { s1 \break s1 \break s1 }
1244 Plusieurs conditions @code{\on-the-fly} mentionnées l'une à la suite de
1245 l'autre se cumulent. Ainsi, par exemple,
1248 \on-the-fly \first-page
1249 \on-the-fly \last-page
1250 @code{@{ \markup @dots{} \fromproperty #'header: @dots{} @}}
1253 teste si la sortie tient sur une page unique.
1256 Manuel de notation :
1257 @ref{Généralités en matière de titrages},
1258 @ref{Mise en forme par défaut des titrages subalternes}.
1260 fichiers d'initialisation :
1261 @file{../ly/titling-init.ly}.
1264 @node Création des métadonnées des fichiers de sortie
1265 @subsection Création des métadonnées des fichiers de sortie
1266 @translationof Creating output file metadata
1268 @cindex PDF metadata
1269 @cindex MIDI metadata
1270 @cindex métadonnées PDF
1271 @cindex métadonnées MIDI
1273 En plus de s'imprimer sur la partition, les variables du bloc
1274 @code{\header} permettent de générer les métadonnées des fichiers de
1275 sortie. Dans le cas d'un fichier PDF, ces métadonnées pourront être
1276 affichées par le lecteur en tant que propriétés du document. Quel que
1277 soit le type de fichier de sortie, seules seront analysées les variables
1278 déterminées dans le @code{\header} du bloc définissant le fichier à
1279 générer, ainsi que celles des blocs hiérarchiquement supérieurs. Pour les
1280 fichiers PDF, seules les définitions du @code{\header} en dehors ou au
1281 niveau d'un bloc @code{\book} affecteront les métadonnées des documents
1282 PDF ; pour les fichiers MIDI seront utilisées les définitions jusqu'au
1283 niveau @code{\score}.
1285 Par exemple, affecter « Symphony I » à la propriété @code{title} dans le
1286 bloc @code{\header} donnera aussi ce titre au document PDF et à la
1291 title = "Symphony I"
1295 Lorsque le titre imprimé diffère de celui affiché en tant que propriété
1296 du PDF, devra être renseignée la propriété @code{pdftitle}.
1300 title = "Symphony I"
1301 pdftitle = "Symphony I by Beethoven"
1305 Les variables @code{title}, @code{subject}, @code{keywords},
1306 @code{subtitle}, @code{composer}, @code{arranger}, @code{poet},
1307 @code{author} et @code{copyright} initialisent toutes les propriétés
1308 PDF, qu'il suffit de préfixer d'un « pdf » pour affecter aux propriétés
1309 PDF une valeur divergente de la sortie imprimable.
1311 La propriété PDF @code{Creator} prend automatiquement la valeur
1312 « LilyPond » additionnée deu numéro de version ; les valeurs de
1313 @code{CreationDate} et @code{ModDate} sont définies à la date et l'heure
1314 courantes -- @code{ModDate} peut être écrasé par la variable de
1315 @code{\header} @code{moddate} (ou @code{pdfmoddate}) pour un horodatage
1318 La variable @code{title} détermine aussi le nom de la séquence MIDI.
1319 L'utilisation de la variable @code{midititle} permet d'attribuer à la
1320 séquence MIDI un nom différent de celui attribué au fichier imprimable.
1323 @node Notes de bas de page
1324 @subsection Notes de bas de page
1325 @translationof Creating footnotes
1327 @cindex bas de page, notes
1330 Les notes de bas de page sont utiles dans bien des situations. Dans
1331 tous les cas, un « appel de note » vient se placer en référence dans te
1332 texte ou la musique, et le « texte de la note » est reporté en bas de la
1335 Selon qu'elle est référencée dans une expression musicale ou dans du
1336 texte indépendant, une note de bas de page sera créée suivant une
1337 procédure différente.
1340 * Notes de bas de page dans une expression musicale::
1341 * Notes de bas de page dans du texte indépendant::
1345 @node Notes de bas de page dans une expression musicale
1346 @unnumberedsubsubsec Notes de bas de page dans une expression musicale
1347 @translationof Footnotes in music expressions
1349 @cindex musique et note de bas de page
1352 @subsubsubheading Généralités sur l'annotation de musique
1353 @c VO Music footnotes overview
1355 Il existe deux catégories d'annotation concernant une expression
1359 @item Les annotations événementielles
1360 se rattachent à des événements particuliers, comme une note individuelle,
1361 un élément d'interprétation (doigté, accent ou nuance) ou des événements
1362 postérieurs (liaison, ligature manuelle). Une note de bas de page
1363 événementielle se libelle généralement sous la forme :
1366 [@var{position}] \footnote [@var{marque}] @var{décalage} @var{annotation} @var{musique}
1369 @item Les annotations temporelles
1370 se rapportent à un point particulier du déroulement d'un contexte
1371 musical. Certaines commandes, telles @code{\time} et @code{\clef}, ne
1372 reposent pas sur un événement pour la création de l'objet métrique ou
1373 clef. Il en va de même pour un accord : sa hampe ou ses crochets ne
1374 sont créés qu'à la fin d'un moment (plus exactement au travers de l'un
1375 des événements note qui le composent). Il n'est pas possible de
1376 connaître assurément lequel des événements note d'un accord est
1377 plus particulièrement à l'origine de la hampe ou du crochet. Il
1378 est donc plus aisé, pour de tels éléments, d'utiliser des
1379 annotations temporelles.
1381 Une annotation temporelle permet d'annoter des objets de rendus
1382 sans se référer à un événement. Elle se libelle généralement sous
1386 \footnote [@var{marque}] @var{décalage} @var{annotation} [@var{Contexte}.]@var{nom-grob}
1391 Les arguments, quelle que soit la catégorie d'annotation, peuvent se
1396 Lorsque la commande @code{\footnote} s'applique à un élément
1397 d'interprétation ou un événement rattaché, et uniquement dans ces cas,
1398 elle doit être précédée d'un indicateur de positionnement (@code{-, _}
1399 ou @code{^}) de façon à rattacher @var{musique} (avec sa marque) à
1400 la note ou au silence qui précède.
1403 Un @emph{markup} ou une chaîne de caractères identifiant l'annotation
1404 tant au niveau de l'appel que de la note qui apparaîtra au bas de la
1405 page. L'absence de cet élément -- ou une valeur de @code{\default} --
1406 incrémentera automatiquement le compteur. Ce compteur est réinitialisé
1407 à chaque page comportant une annotation.
1410 Une paire de nombres -- @samp{#(2 . 1)} par exemple -- spécifiant le
1411 décalage de la marque, en abscisse et en ordonnée, par rapport au point
1412 de référence. Des valeurs positives décalent vers la droite ou le
1413 haut, des valeurs négatives vers la gauche ou le bas ; des valeurs à
1414 zéro centrent la marque sur le point de référence. Le décalage
1415 s'exprime en espace de portée.
1418 Le contexte auquel appartient l'objet à annoter. Cet argument
1419 peut être omis dès lors qu'il s'agit d'un contexte de bas niveau
1420 tel que @code{Voice}.
1423 Le type d'objet à annoter -- @samp{Flag} par exemple. Lorsque cet
1424 élément est spécifié, c'est l'objet en question qui servira de point de
1425 référence, même s'il trouve son origine non pas directement dans
1426 une expression musicale mais dans tout objet du type spécifié
1427 intervenant à cet instant précis de la partition.
1430 un @emph{markup} ou une chaîne de caractères qui sera reporté au bas de
1434 l'élément qui fait l'objet du commentaire, qu'il s'agisse d'un
1435 événement musical, de l'un des constituants d'un accord ou d'un
1441 @subsubsubheading Notes de bas de page événementielles
1442 @c VO Event-based footnotes
1444 @cindex événementielle, note de bas de page
1446 Ce type de note de bas de page s'attache à un objet de rendu
1447 généré directement par l'événement correspondant à @var{musique}.
1448 Il répond à la syntaxe :
1451 \footnote [@var{décalage}] @var{décalage} @var{annotation} @var{musique}
1455 @lilypond[quote,verbatim,papersize=a8landscape]
1457 \header { tagline = ##f }
1459 \footnote #'(-1 . 3) "Une note" a4
1461 \footnote #'(2 . 2) "Un silence" r4
1467 Un accord @emph{dans son intégralité} ne peut pas faire l'objet
1468 d'une note de bas de page événementielle : un accord, même s'il ne
1469 contient qu'une seule et unique note, ne génère aucun événement en
1470 propre. Une des notes @emph{au sein} de l'accord peut toutefois
1471 se voir attribuer une annotation :
1474 @lilypond[quote,verbatim,papersize=a8landscape]
1476 \header { tagline = ##f }
1478 \footnote #'(2 . 3) "Résultat non probant" <a-3>2
1479 <\footnote #'(-2 . -3) "Résultat probant" a-3>4
1480 <a-3 \footnote #'(3 . 1/2) "Tout aussi probant" c-5>4
1485 Lorsque l'annotation concerne un événement postérieur ou une
1486 articulation, la commande @code{\footnote} @strong{doit} être
1487 précédée d'un indicateur de position (@code{-, _} ou @code{^}) et
1488 suivie de l'événement postérieur ou l'articulation comme argument
1489 @var{musique}. Dans ce cas, la commande @code{\footnote} peut se
1490 considérer comme une copie de son dernier argument auquel on
1491 attache une annotation. La syntaxe consacrée est :
1494 @var{position} \footnote [@var{marque}] @var{décalage} @var{annotation} @var{musique}
1498 @lilypond[quote,verbatim,papersize=a8landscape]
1500 \header { tagline = ##f }
1502 a'4_\footnote #'(0 . -1) "Une liaison arbitrairement en dessous" (
1503 b8^\footnote #'(1 . 0.5) "Une ligature manuelle forcée en haut" [
1506 c-\footnote #'(1 . 1) "Tenuto" --
1511 Les appels de note peuvent être personnalisés, et le trait reliant
1512 l'objet à l'appel supprimé :
1515 @subsubsubheading Notes de bas de page temporelles
1516 @c VO Time-based footnotes
1518 @cindex temporelle, note de bas de page
1520 Lorsque la note de bas de page se réfère à un objet de rendu résultant
1521 d'un événement -- @code{Accidental} ou @code{Stem} découlent d'un
1522 @code{NoteHead} --, l'argument @var{nom-grob} de l'objet en question est
1523 requis après le texte de l'annotation, en lieu et place de
1527 @lilypond[quote,verbatim,papersize=a8landscape]
1529 \header { tagline = ##f }
1531 \footnote #'(-1 . -3) "Un bémol" Accidental
1533 \footnote #'(-1 . 0.5) "Un autre bémol" Accidental
1535 \footnote #'(1 . -2) "Une hampe" Stem
1541 Notez bien que, lorsque @var{nom-grob} est spécifié, tous les objets de
1542 ce type qui se trouvent à ce même instant se verront attacher une
1546 @lilypond[quote,verbatim,papersize=a8landscape]
1548 \header { tagline = ##f }
1550 \footnote #'(-1 . 3) "Un bémol" Accidental
1552 \footnote #'(2 . 0.5) "Une articulation" Script
1558 Une note incluse dans un accord peut individuellement se voir attribuer
1559 une annotation événementielle. Une tête de note (@code{NoteHead}) est
1560 le @emph{seul} objet directement généré par un constituant d'accord ;
1561 elle peut donc être affectée d'une annotation événementielle. Tous les
1562 autres objets constituant un accord sont générés indirectement. La
1563 commande @code{\footnote} ne dispose pas d'une syntaxe permettant de
1564 spécifier @emph{à la fois} un type d'objet @emph{et} un événement
1565 particulier auquel s'attacher. De tels objets pourront toutefois faire
1566 l'objet d'une annotation temporelle, préfixée d'un @code{\single} afin
1567 d'annoter l'événement directement consécutif :
1570 @lilypond[quote,verbatim,papersize=a8landscape]
1572 \header { tagline = ##f }
1574 < \footnote #'(1 . -2) "Un la" a
1575 \single \footnote #'(-1 . -1) "Un dièse" Accidental
1577 \single \footnote #'(0.5 . 0.5) "Un bémol" Accidental
1584 @warning{Lorsque plusieurs notes de bas de page se rapportent à un même
1585 empilement vertical comme ci-dessus, elles sont numérotées et
1586 apparaîtront selon l'ordre vertical des éléments présentés, autrement dit
1587 celui positionné le plus haut en premier, non dans leur ordre
1588 d'apparition dans le fichier source.}
1590 Les objets de rendu tels que changement de clef ou d'armure tirent leur
1591 origine dans la modification d'une propriété plutôt que d'un véritable
1592 événement. D'autres, comme les barres ou numéros de mesure, dépendent
1593 directement de la temporisation. C'est la raison pour laquelle de tels
1594 objets doivent s'annoter en fonction de leur survenance au fil de la
1595 musique. Les notes de bas de page temporelles sont la solution à
1596 privilégier lorsqu'il s'agit d'annoter les hampes ou ligatures affectant
1597 des accords : bien qu'une telle fonctionnalité puisse s'appliquer à l'un
1598 des événements constituant l'accord, rien ne laisse présager lequel
1599 serait le plus approprié.
1601 En matière de note de bas de page temporelle, l'objet de rendu considéré
1602 doit toujours être mentionné explicitement, ainsi que le contexte si
1603 l'objet est créé dans un autre contexte que celui du plus bas niveau.
1606 @lilypond[quote,verbatim,papersize=a8landscape]
1608 \header { tagline = ##f }
1611 \footnote #'(-0.5 . -1) "Changement de métrique" Staff.TimeSignature
1613 \footnote #'(1 . -1) "Hampe de l'accord" Stem
1615 \footnote #'(-0.5 . 1) "Barre de mesure" Staff.BarLine
1617 \footnote #'(0.5 . -1) "Changement d'armure" Staff.KeySignature
1624 Les appels de note peuvent être personnalisés, et le trait reliant
1625 l'objet à l'appel supprimé :
1628 @lilypond[quote,verbatim,papersize=a8landscape]
1630 \header { tagline = ##f }
1632 \footnote "*" #'(0.5 . -2) \markup { \italic "* La première note" }
1634 \footnote \markup { \super "$" } #'(0.5 . 1)
1635 \markup { \super "$" \italic " La deuxième note" }
1637 \once \override Score.FootnoteItem #'annotation-line = ##f
1638 b-\footnote \markup \tiny "+" #'(0.1 . 0.1)
1639 \markup { \super "+" \italic " Éditorial" } \p
1644 D'autres exemples de personnalisation des appels de note sont donnés à
1645 la rubrique @ref{Notes de bas de page dans du texte indépendant}.
1648 @node Notes de bas de page dans du texte indépendant
1649 @unnumberedsubsubsec Notes de bas de page dans du texte indépendant
1650 @translationof Footnotes in stand-alone text
1652 @cindex texte indépendant et note de bas de page
1654 De telles notes de bas de page affectent les @emph{markup} extérieurs
1655 aux expressions musicales. Il n'est pas nécessaire en pareil cas
1656 d'indiquer un point de référence par un trait ; l'appel de note vient
1657 juste s'accoler au @emph{markup} qui fait l'objet de l'annotation. Les
1658 appels de note peuvent être gérés automatiquement, auquel cas ils seront
1659 numériques, ou bien manuellement en fournissant un indicateur
1662 Les notes de bas de page concernant du texte indépendant se gèrent
1663 différemment selon qu'elles sont automatiques ou manuelles.
1666 @subsubsubheading Notes de bas de page automatiques dans du texte
1667 @c VO Footnotes in stand-alone text with automatic marks
1669 La syntaxe consacrée dans le cas d'une gestion automatique des appels
1673 \markup @{ @dots{} \auto-footnote @var{texte} @var{annotation} @dots{} @}
1676 Ses les éléments sont :
1681 le @emph{markup} ou la chaîne de caractères sur lequel porte
1685 un @emph{markup} ou une chaîne de caractères constituant le texte de
1686 l'annotation qui sera reportée en bas de page.
1692 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1694 \header { tagline = ##f }
1697 \auto-footnote "tune" \italic " By me"
1698 "is shown below. It is a"
1699 \auto-footnote "recent" \italic " Aug 2012"
1709 @subsubsubheading Notes de bas de page personnalisées dans du texte
1710 @c VO Footnotes in stand-alone text with custom marks
1712 La syntaxe consacrée dans le cas d'une gestion personnalisée des appels
1716 \markup @{ @dots{} \footnote @var{appel} @var{annotation} @dots{} @}
1719 Ses les éléments sont :
1724 un @emph{markup} ou une chaîne de caractères représentant l'appel de
1725 note affecté à ce point de référence. Notez bien que cette marque ne
1726 sera @strong{pas} reproduite automatiquement avant le texte proprement
1727 dit de l'annotation.
1730 un @emph{markup} ou une chaîne de caractères constituant le texte de
1731 l'annotation qui sera reportée en bas de page, précédé de l'@var{appel}.
1735 N'importe quel caractère simple tel que @code{*} ou @code{+} peut
1736 s'utiliser en tant qu'appel de note, comme nous l'avons vu à la rubrique
1737 @ref{Notes de bas de page dans une expression musicale}. D'autres
1738 caractères particuliers sont accessibles sous forme de raccourci -- voir
1739 la rubrique @ref{Équivalents ASCII} :
1741 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1743 \paper { #(include-special-characters) }
1744 \header { tagline = ##f }
1747 \footnote "*" \italic "* By me"
1748 "is shown below. It is a recent"
1749 \footnote \super † \concat {
1750 \super † \italic " Aug 2012"
1760 Un appel de note peut aussi se libeller sous la forme d'un point de code
1761 unicode -- voir la rubrique @ref{Unicode} :
1763 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1765 \header { tagline = ##f }
1768 \footnote \super \char##x00a7 \concat {
1769 \super \char##x00a7 \italic " By me"
1771 "is shown below. It is a recent"
1772 \footnote \super \char##x00b6 \concat {
1773 \super \char##x00b6 \italic " Aug 2012"
1784 Manuel d'initiation :
1785 @rlearning{Objets et interfaces}.
1787 Manuel de notation :
1788 @ref{Commentaires textuels},
1789 @ref{Équivalents ASCII},
1790 @ref{Indications textuelles},
1792 @ref{Liste des caractères spéciaux},
1795 Référence des propriétés internes :
1796 @rinternals{FootnoteEvent},
1797 @rinternals{FootnoteItem},
1798 @rinternals{FootnoteSpanner},
1799 @rinternals{Footnote_engraver}.
1802 Les notes de bas de page ne peuvent que s'empiler l'une au-dessus de
1803 l'autre ; elles ne seront jamais présentées à la queue leu leu.
1805 Silences multimesures, ligatures automatiques et paroles ne peuvent se
1806 voir affecter de note de bas de page.
1808 Les notes de bas de page peuvent générer des chevauchements quand elles
1809 sont trop nombreuses sur une même page.
1812 @node Référencement des numéros de page
1813 @subsection Référencement des numéros de page
1814 @translationof Reference to page numbers
1816 LilyPond vous permet, à l'aide de la commande @code{\label}, d'insérer
1817 des points de référence dans un ouvrage, aussi bien en dehors qu'au fil
1818 de la musique. Ce point de référence pourra être ensuite repris à
1819 l'intérieur d'un @emph{markup} ; vous pourrez même y ajouter le
1820 numéro de page grâce à la commande de @emph{markup} @code{\page-ref}.
1823 @lilypond[verbatim,papersize=a8landscape]
1824 \header { tagline = ##f }
1830 \pageBreak \mark A \label #'markA
1835 \markup { Le premier mouvement débute à la page \page-ref #'firstScore "0" "?" }
1836 \markup { Le repère A est à la page \page-ref #'markA "0" "?" }
1840 L'instruction @code{\page-ref} prend trois arguments :
1843 le point de référence, sous la forme d'un symbole Scheme, comme par
1844 exemple @code{#'firstScore},
1847 un « emporte-pièce » afin d'estimer la longueur totale du @emph{markup},
1851 un texte de remplacement au cas où la référence ne serait pas retrouvée.
1854 La présence de l'emporte-pièce est rendue nécessaire par le fait que les
1855 @emph{markups} sont générés avant que les sauts de page ne soient
1856 positionnés. Bien que le numéro de page en question ne soit pas encore
1857 déterminé, LilyPond doit connaître les dimensions de ce @emph{markup}.
1858 Vous pouvez, lorsque l'ouvrage contiendra plus de dix pages, stipuler un
1859 emporte-pièce sur deux caractères -- soit @code{"00"}.
1869 @node Table des matières
1870 @subsection Table des matières
1871 @translationof Table of contents
1873 La commande @code{\markuplist \table-of-contents} vous permettra de
1874 générer une table des matières. Les éléments qui la composeront sont
1875 créés par la commande @code{\tocItem}, insérée indépendamment ou au sein
1876 d'une expression musicale.
1879 \markuplist \table-of-contents
1882 \tocItem \markup "Premier mouvement"
1886 \tocItem \markup "Passage spécifique du premier mouvement"
1891 \tocItem \markup "Second mouvement"
1899 Les @emph{markups} dévolus à la mise en forme de la table des matières
1900 se définissent dans le bloc @code{\paper}. LilyPond dispose de deux
1901 @emph{markups} prédéfinis :
1906 @code{tocTitleMarkup}
1909 Utilisé pour mettre en forme le titre de la table des matières.
1912 tocTitleMarkup = \markup \huge \column {
1913 \fill-line { \null "Table of Contents" \null }
1919 @code{tocItemMarkup}
1922 Utilisé pour mettre en forme les éléments au sein de la table des
1926 tocItemMarkup = \markup \fill-line {
1927 \fromproperty #'toc:text \fromproperty #'toc:page
1934 Ces variables sont adaptables.
1936 Voici comment, par exemple, franciser le titre :
1940 tocTitleMarkup = \markup \huge \column {
1941 \fill-line { \null "Table des matières" \null }
1946 L'exemple suivant illustre la manière de modifier la taille des éléments
1947 de la table des matières :
1950 tocItemMarkup = \markup \large \fill-line {
1951 \fromproperty #'toc:text \fromproperty #'toc:page
1955 Notez bien la manière de référencer le libellé et le numéro de page dans
1956 la définition de @code{tocItemMarkup}.
1958 L'élément et son numéro de page peuvent se rejoindre par une ligne
1961 @lilypond[verbatim,line-width=10.0\cm]
1962 \header { tagline = ##f }
1964 tocItemMarkup = \tocItemWithDotsMarkup
1968 \markuplist \table-of-contents
1969 \tocItem \markup { Allegro }
1970 \tocItem \markup { Largo }
1975 N'hésitez pas à définir vous-même d'autres commandes et @emph{markups}
1976 afin de construire une table plus élaborée. Dans l'exemple qui suit,
1977 nous créons un nouveau style d'élément dans le but de mentionner les
1978 actes dans la table des matières d'un opéra :
1981 Commençons par définir une nouvelle variable de type @code{markup} --
1982 appelée @code{tocActMarkup} -- au sein du bloc @code{\paper}.
1986 tocActMarkup = \markup \large \column {
1988 \fill-line { \null \italic \fromproperty #'toc:text \null }
1995 Créons ensuite une fonction musicale (@code{tocAct}) utilisant la
1996 nouvelle définition de @emph{markup} @code{tocActMarkup}.
2000 #(define-music-function (text) (markup?)
2001 (add-toc-item! 'tocActMarkup text))
2005 Dans un fichier LilyPond, l'utilisation de cette définition
2006 personnalisée pourrait ressembler à ceci :
2008 @lilypond[line-width=10.0\cm]
2009 \header { tagline = ##f }
2011 tocActMarkup = \markup \large \column {
2013 \fill-line { \null \italic \fromproperty #'toc:text \null }
2019 #(define-music-function (text) (markup?)
2020 (add-toc-item! 'tocActMarkup text))
2023 \markuplist \table-of-contents
2024 \tocAct \markup { Atto Primo }
2025 \tocItem \markup { Coro. Viva il nostro Alcide }
2026 \tocItem \markup { Cesare. Presti omai l'Egizia terra }
2027 \tocAct \markup { Atto Secondo }
2028 \tocItem \markup { Sinfonia }
2029 \tocItem \markup { Cleopatra. V'adoro, pupille, saette d'Amore }
2034 Voici comment utiliser la commande @code{\fill-with-pattern} dans le
2035 cadre d'une table des matières :
2038 tocItemMarkup = \markup { \fill-line {
2039 \override #'(line-width . 70)
2040 \fill-with-pattern #1.5 #CENTER . \fromproperty #'toc:text \fromproperty #'toc:page
2046 @funindex \table-of-contents
2047 @code{\table-of-contents},
2053 Fichiers d'initialisation :
2054 @file{../ly/toc-init.ly}.
2057 @node Travail sur des fichiers texte
2058 @section Travail sur des fichiers texte
2059 @translationof Working with input files
2062 * Insertion de fichiers LilyPond::
2063 * Différentes éditions à partir d'une même source::
2064 * Caractères spéciaux::
2068 @node Insertion de fichiers LilyPond
2069 @subsection Insertion de fichiers LilyPond
2070 @translationof Including LilyPond files
2073 @cindex inclusion de fichiers
2075 Lorsqu'un projet prend de l'importance en volume, il est judicieux de le
2076 scinder en plusieurs fichiers, auxquels vous ferez référence avec un
2080 \include "autrefichier.ly"
2083 Une ligne @code{\include "autrefichier.ly"} dans un fichier revient à
2084 recopier intégralement le contenu de @file{autrefichier.ly} à l'endroit
2085 même ou est placée l'instruction @code{\include}. Vous pouvez par
2086 exemple écrire un fichier individuel par instrument, puis les regrouper
2087 pour former le fichier @qq{conducteur}. Les différentes variables
2088 définies dans les fichiers séparés seront normalement reprises et
2089 utilisables dans le fichier formant le conducteur. Les sections
2090 balisées dans les fichiers individuels peuvent être réutilisées en
2091 différents endroit de la partition, comme expliqué à la rubrique
2092 @ref{Différentes éditions à partir d'une même source}.
2094 Lorsque le fichier auquel il est fait référence se trouve dans le même
2095 répertoire, donner seulement son nom en argument à la commande
2096 @code{\include} suffit. S'il se trouve ailleurs, vous devrez indiquer
2097 le chemin d'accès, absolu ou relatif, en respectant toutefois la syntaxe
2098 UNIX -- autrement dit, le séparateur de répertoire est une oblique
2099 normale @code{/} et non l'oblique inverse @code{\} de DOS ou Windows.
2100 Par exemple, si le fichier @file{truc.ly} se trouve dans le répertoire
2101 supérieur au répertoire de travail, la ligne devra être
2104 \include "../truc.ly"
2108 ou bien, si les fichiers correspondant aux parties d'orchestre se
2109 trouvent dans le sous-répertoire @file{parties} relativement au
2110 répertoire courant, vous devrez mentionner
2113 \include "parties/VI.ly"
2114 \include "parties/VII.ly"
2118 Les fichiers à inclure peuvent eux-mêmes contenir des instructions
2119 @code{\include}. Ces instructions @code{\include} de second niveau ne
2120 pourront, par défaut, être interprétées qu'une fois intégrées dans le
2121 fichier principal ; leur argument doit donc comporter le chemin
2122 relativement au fichier principal et non par rapport au fichier dans
2123 lequel cette inclusion est mentionnée. Vous pouvez toutefois influer
2124 sur ce comportement de manière globale à l'aide de l'option
2125 @w{@code{-drelative-includes}} en ligne de commande ou en ajoutant une
2126 clause @code{#(ly:set-option 'relative-includes #t)} en tête du fichier
2129 Lorsque @code{relative-include} est valorisé à @code{#t}, le chemin à
2130 suivre pour chacune des commandes @code{\include} sera pris relativement
2131 au fichier qui la contient. Cette option est vouée à être activée par
2132 défaut dans une future version de LilyPond.
2134 Selon l'endroit où @code{relative-includes} est valorisé à @code{#t} ou
2135 @code{#f}, la commande @code{\include} permettra d'incorporer des
2136 fichiers contenus dans l'arborescence du répertoire principal et des
2137 fichiers situés ailleurs. Si, par exemple, une biblothèque générale
2138 libA a été créée pour utiliser des sous-fichiers à l'aide
2139 d'inclusions dans un fichier catalogue, les clauses @code{\include}
2140 devront être précédées d'un
2141 @code{#(ly:set-option #relative-includes #t)} de telle sorte
2142 qu'elles soient interprétées correctement lorsque rapatriées dans
2143 le fichier @file{.ly} principal. Examinons cela dans les faits :
2154 puis le fichier catalogue, @code{libA.ly}, qui contient
2157 #(ly:set-option 'relative-includes #t)
2161 % retour au réglage par défaut
2162 #(ly:set-option 'relative-includes #f)
2165 Tout fichier @code{.ly} peut désormais consulter l'intégralité de cette
2166 bibliothèque grâce à un simple
2169 \include "~/libA/libA.ly"
2172 Un positionnement judicieux des commutateurs permet de gérer des
2173 structures de fichiers plus complexes.
2175 Vous pouvez inclure des fichiers dont vous spécifierez le chemin d'accès
2176 sur la ligne de commande au moment de lancer la compilation. L'appel à
2177 ces fichiers ne mentionnera alors que leur nom. Par exemple, si vous
2178 voulez compiler avec cette méthode le fichier @file{principal.ly} qui
2179 inclut des fichiers situés dans le sous-répertoire @file{parties},
2180 placez vous dans le répertoire contenant @file{principal.ly}, puis tapez
2183 lilypond --include=parties principal.ly
2186 tout en ayant bien dans @file{principal.ly}
2194 Lorsqu'un fichier est voué à être inclus dans nombre de partitions, vous
2195 pouvez le placer dans le répertoire de LilyPond @file{../ly}.
2196 Attention : ce répertoire varie selon votre installation, comme
2197 indiqué au chapitre @rlearning{Autres sources de documentation}. Ce
2198 fichier sera inclus dès lors que vous fournirez uniquement son nom en
2199 argument à la fonction @code{\include}. C'est par exemple le cas du
2200 fichier de définition particulier @file{gregorian.ly}.
2202 Au moment où vous lancez LilyPond, un certain nombre de fichiers se
2203 retrouvent inclus par défaut ; il suffit d'activer le mode verbeux
2204 en faisant @w{@code{lilypond --verbose}} pour s'en rendre compte. Vous
2205 verrez ainsi défiler, en plus de nombreuses informations, le nom d'un
2206 certain nombre de fichiers et de chemins d'accès. Les fichiers les plus
2207 important sont mentionnés au chapitre
2208 @rlearning{Autres sources de documentation}. Si vous venez à les
2209 modifier, rappelez-vous qu'ils seront écrasés à l'installation d'une
2210 nouvelle version de LilyPond.
2212 Vous trouverez quelques exemples simples d'utilisation de la commande
2213 @code{\include} au chapitre @rlearning{Conducteurs et parties}.
2216 Manuel d'initiation :
2217 @rlearning{Autres sources de documentation},
2218 @rlearning{Conducteurs et parties}.
2221 Lorsque vous incluez un fichier qui porte le même nom que l'un des
2222 fichiers d'initialisation de LilyPond, le fichier de la distribution de
2223 LilyPond aura préséance.
2226 @node Différentes éditions à partir d'une même source
2227 @subsection Différentes éditions à partir d'une même source
2228 @translationof Different editions from one source
2230 Plusieurs méthodes permettent de générer différentes versions d'une
2231 partition à partir d'une même source. Les variables -- ou
2232 identificateurs -- sont sûrement le moyen le plus simple de combiner de
2233 différente manière des passages relativement longs, alors que les
2234 balises permettront de sélectionner de courts fragments selon leur
2237 Quelle que soit la méthode utilisée, séparer la notation de la structure
2238 de la partition vous donnera plus de liberté dans l'agencement de
2239 l'ouvrage final, puisque vous ne reviendrez pas sur la musique qui le
2243 * Utilisation de variables::
2244 * Utilisation de balises::
2245 * Globalisation des réglages::
2249 @node Utilisation de variables
2250 @unnumberedsubsubsec Utilisation de variables
2251 @translationof Using variables
2253 @cindex variables, utilisation de
2255 Un fragment musical identifié par une variable est réutilisable à divers
2256 endroits de la partition, comme nous l'avons vu à la rubrique
2257 @rlearning{Organisation du code source avec des variables}. Par
2258 exemple, une partition pour chœur @notation{a cappella} comporte souvent
2259 une réduction pour piano reprenant toutes les voix ; il s'agit de
2260 la même musique, et vous ne devrez donc la saisir qu'une seule fois.
2261 D'autre part, la musique issue de deux variables peut se combiner sur
2262 une seule portée, comme nous l'avons vu à la rubrique
2263 @ref{Regroupement automatique de parties}. Prenons l'exemple suivant :
2265 @lilypond[verbatim,quote]
2266 sopranoMusic = \relative { a'4 b c b8( a) }
2267 altoMusic = \relative { e'4 e e f }
2268 tenorMusic = \relative { c'4 b e d8( c) }
2269 bassMusic = \relative { a4 gis a d, }
2270 allLyrics = \lyricmode { King of glo -- ry }
2272 \new Staff = "Soprano" \sopranoMusic
2273 \new Lyrics \allLyrics
2274 \new Staff = "Alto" \altoMusic
2275 \new Lyrics \allLyrics
2276 \new Staff = "Tenor" {
2280 \new Lyrics \allLyrics
2281 \new Staff = "Bass" {
2285 \new Lyrics \allLyrics
2288 \set Staff.printPartCombineTexts = ##f
2289 \partcombine \sopranoMusic \altoMusic
2292 \set Staff.printPartCombineTexts = ##f
2294 \partcombine \tenorMusic \bassMusic
2300 Générer une partition chorale ou la réduction pour piano ne requiert que
2301 de modifier la structure des éléments, sans aucunement toucher à la
2304 Dans le cas d'une partition relativement longue, vous pouvez isoler la
2305 définition des différentes variables dans des fichiers séparés que vous
2306 rappellerez ensuite, comme indiqué à la rubrique
2307 @ref{Insertion de fichiers LilyPond}.
2310 @node Utilisation de balises
2311 @unnumberedsubsubsec Utilisation de balises
2312 @translationof Using tags
2315 @funindex \keepWithTag
2316 @funindex \removeWithTag
2319 @cindex regroupement de balises
2321 La commande @code{\tag #'@var{partieA}} affecte à une expression
2322 musicale le nom @var{partieA}. Les expressions ainsi balisées pourront
2323 être filtrées par la suite, à l'aide de @code{\keepWithTag #'@var{nom}}
2324 ou @code{\removeWithTag #'@var{nom}}. Ces filtres fonctionnent de la
2327 @multitable @columnfractions .5 .5
2332 Musique balisée précédée de @code{\keepWithTag #'@var{nom}} ou
2333 @code{\keepWithTag #'(@var{nom1} @var{nom2}@dots{})}
2334 @tab Musique non balisée et musique balisée par l'un des noms de
2335 balise fournis seront incluses ; la musique balisée
2336 autrement est exclue.
2339 Musique balisée précédée de @code{\removeWithTag #'@var{nom}} ou
2340 @code{\removeWithTag #'(@var{nom1} @var{nom2}@dots{})}
2341 @tab Musique non balisée et fragments appelés autrement que par
2342 l'un des noms fournis seront inclus ; la musique balisée
2343 par autre chose que les noms mentionnés est exclue.
2346 Musique balisée non précédée de @code{\keepWithTag} ou
2347 @code{\removeWithTag}
2348 @tab Musique balisée et non balisée seront incluses.
2352 L'argument des commandes @code{\tag}, @code{\keepWithTag} et
2353 @code{\removeWithTag} doit être un symbole ou une liste de symboles
2354 (tel que @code{#'conducteur} ou @code{#'(violonI violonII)}), suivi
2355 d'une expression musicale. Si, @emph{et seulement si} les symboles sont
2356 des indentifiants LilyPond valides (caractères alphabétiques uniquement,
2357 sans chiffre, souligné ou tiret) qui ne peuvent se confondre avec des
2358 notes, le @code{#'} peut s'omettre et, pour raccourcir, une liste de
2359 symbole peut utiliser le point en séparateur -- autrement dit,
2360 @code{\tag #'(violinI violinII)} peut s'écrire @code{\tag
2361 violinI.violinII}. Ceci s'applique aussi bien pour @code{\keepWithTag}
2362 que pour @code{\removeWithTag}.
2364 Dans l'exemple qui suit, nous obtenons deux versions du même extrait,
2365 l'une pour le conducteur, l'autre pour l'instrumentiste qui, elle,
2366 comportera les ornements développés.
2368 @lilypond[verbatim,quote]
2371 \tag #'trills { d8.\trill }
2372 \tag #'expand { \repeat unfold 3 { e32 d } }
2377 \keepWithTag #'trills \music
2380 \keepWithTag #'expand \music
2385 Il est parfois plus aisé d'exclure des fragments :
2387 @lilypond[verbatim,quote]
2390 \tag #'trills { d8.\trill }
2391 \tag #'expand {\repeat unfold 3 { e32 d } }
2396 \removeWithTag #'expand
2400 \removeWithTag #'trills
2405 Ce principe de filtrage peut s'appliquer aux articulations, textes, etc.
2406 Il suffit de positionner
2409 -\tag #@var{ma-balise}
2413 avant l'articulation ou le texte, comme ici :
2417 c1-\tag #'gaffe ^"Attention !"
2421 Ceci définira une note avec une indication conditionnelle de doigté ou
2424 Vous pouvez baliser différemment la même expression musicale en
2425 saisissant plusieurs @code{\tag} ou bien en combinant plusieurs
2426 balises dans une liste :
2428 @lilypond[quote,verbatim]
2429 music = \relative c'' {
2430 \tag #'a \tag #'both { a4 a a a }
2431 \tag #'(b both) { b4 b b b }
2434 \keepWithTag #'a \music
2435 \keepWithTag #'b \music
2436 \keepWithTag #'both \music
2440 L'application concomitante de plusieurs filtres @code{\removeWithTag} à
2441 la même expression musicale permet d'exclure plusieurs balisages.
2442 Une liste fournie en argument à un unique @code{\removeWithTag}
2443 produira le même effet :
2445 @lilypond[verbatim,quote]
2446 music = \relative c'' {
2447 \tag #'A { a4 a a a }
2448 \tag #'B { b4 b b b }
2449 \tag #'C { c4 c c c }
2450 \tag #'D { d4 d d d }
2456 \removeWithTag #'(B C)
2461 L'application de plus d'un filtre @code{\keepWithTag} à la même
2462 expression musicale aboutit à l'exclusion de @b{tous} les balisages.
2463 En effet, si le premier filtre exclut tous les autres balisages,
2464 l'application du second exclura les effets du premier.
2465 L'utilisation d'une unique commande @code{\keepWithTag} avec une
2466 liste de balises est en pareil cas des plus pertinente : seront
2467 exclus tous les fragments non concernés par l'une quelconque des
2468 balises mentionnées.
2470 @lilypond[verbatim,quote]
2471 music = \relative c'' {
2472 \tag #'violinI { a4 a a a }
2473 \tag #'violinII { b4 b b b }
2474 \tag #'viola { c4 c c c }
2475 \tag #'cello { d4 d d d }
2479 \keepWithTag #'(violinI violinII)
2485 imprimera les @code{\tag}s @var{violinI} et @var{violinII}, mais ni
2486 @var{viola} ni @var{cello}.
2488 @cindex regroupements de balises
2489 @cindex balises, regroupement
2492 Bien que @code{\keepWithTag} soit efficace pour gérer @emph{un} jeu
2493 d'alternatives, le rejet de musique filtrée par des balises
2494 @emph{étrangères} se révèle problématique lorsque les @code{\tag} sont
2495 utilisés à plusieurs fins. Des « groupements de balises » peuvent
2496 alors être déclarés :
2499 \tagGroup #'(violinI violinII viola cello)
2503 Les différents filtres appartiennent désormais tous à un seul
2504 regroupement. Notez bien qu'une balise ne saurait être membre de
2505 plusieurs regroupements.
2508 \keepWithTag #'violinI @dots{}
2512 ne prendra désormais en compte que la musique concernée par la balise
2513 @code{violinI} du groupe de filtres : tout élément de la musique qui
2514 serait balisé par l'un des autres filtres de ce jeu sera rejeté.
2516 @lilypond[verbatim,quote]
2518 \tagGroup #'(violinI violinII viola cello)
2519 \tag #'violinI { c''4^"violinI" c c c }
2520 \tag #'violinII { a2 a }
2521 \tag #'viola { e8 e e2. }
2522 \tag #'cello { d'2 d4 d }
2527 \keepWithTag #'violinI
2532 Dans le cadre de la commande @code{\keepWithTag}, seules les balises du
2533 regroupement mentionnées dans la commande seront visibles.
2535 @funindex \pushToTag
2536 @funindex \appendToTag
2537 @cindex raccordement dans une balise
2539 Il peut arriver que vous ayez besoin de raccorder quelque chose en un
2540 point particulier d'une expression musicale. Les commandes
2541 @code{\pushToTag} et @code{\appendToTag} permettent d'insérer du
2542 matériau, qu'il soit antérieur ou postérieur, à des @code{éléments}
2543 d'une construction musicale existante. La musique séquentielle ou
2544 simultanée comporte assurément des @code{éléments} :
2546 @lilypond[verbatim,quote]
2547 music = { \tag #'here { \tag #'here <<c''>> } }
2550 \pushToTag #'here c'
2551 \pushToTag #'here e'
2552 \pushToTag #'here g' \music
2553 \appendToTag #'here c'
2554 \appendToTag #'here e'
2555 \appendToTag #'here g' \music
2559 Ces deux instructions sont affectées d'une balise, le matériau à
2560 raccorder à chaque instance de la balise, et l'expression balisée.
2563 Manuel d'initiation :
2564 @rlearning{Organisation du code source avec des variables}.
2566 Manuel de notation :
2567 @ref{Insertion de fichiers LilyPond},
2568 @ref{Regroupement automatique de parties}.
2571 L'application d'un @code{\relative} à une expression musicale
2572 obtenue par filtrage à l'aide de @code{\keepWithTag} ou
2573 @code{\removeWithTag} peut générer des changements d'octave,
2574 puisque seules les hauteurs récupérées dans ce filtre seront
2575 prises en considération. Une instruction @code{\relative} qui
2576 précède les commandes @code{\keepWithTag} ou
2577 @code{\removeWithTag} permet d'éviter ce risque, dans la mesure où
2578 elle viendra « recaler » ces hauteurs récupérées.
2581 @node Globalisation des réglages
2582 @unnumberedsubsubsec Globalisation des réglages
2583 @translationof Using global settings
2585 @cindex include-settings
2587 Vous pouvez regrouper dans un fichier indépendant vos réglages
2588 personnels que vous inclurez au besoin :
2591 lilypond -dinclude-settings=MES_REGLAGES.ly MA_PARTITION.ly
2594 Vous pouvez ainsi stocker dans un fichier séparé vos réglages en matière
2595 de format de papier, de fontes utilisées ou vos définitions
2596 particulières. Selon le fichier de réglages que vous mentionnerez, vous
2597 obtiendrez facilement différentes éditions à partir d'une même source
2598 quelle qu'elle soit.
2600 Cette technique peut s'utiliser en combinaison avec des feuilles de
2601 styles, comme indiqué au chapitre @rlearning{Feuilles de style}.
2604 Manuel d'initiation :
2605 @rlearning{Feuilles de style},
2606 @rlearning{Organisation du code source avec des variables}.
2608 Manuel de notation :
2609 @ref{Insertion de fichiers LilyPond}.
2612 @node Caractères spéciaux
2613 @subsection Caractères spéciaux
2614 @translationof Special characters
2616 @cindex caractères spéciaux
2617 @cindex non-ASCII, caractères
2622 * Équivalents ASCII::
2626 @node Codage du texte
2627 @unnumberedsubsubsec Codage du texte
2628 @translationof Text encoding
2632 LilyPond utilise le jeu de caractères défini par le consortium Unicode
2633 et la norme ISO/CEI 10646. Chaque caractère est identifié par un
2634 nom unique et associé à un point de code, ce qui permet dans l'absolu de
2635 couvrir tous les langages. Unicode permet de coder tous les caractères
2636 utilisés par toutes les langues écrites du monde. LilyPond utilise le
2637 codage UTF-8 (UTF pour @emph{Unicode Transformation Format}) qui permet
2638 de représenter les caractères latins sur un octet et les autres sur une
2639 longueur allant jusqu'à quatre octets.
2641 L'apparence réelle des caractères est déterminée par les glyphes ou
2642 graphèmes tels que définis dans les différentes polices disponibles.
2643 Une police, ou une fonte, définit la mise en correspondance d'un
2644 sous-ensemble de points de code unicode en glyphes. LilyPond recourt à
2645 la bibliothèque Pango pour assurer le rendu des textes multilingues.
2647 LilyPond n'effectue aucune conversion d'encodage que ce soit. Ceci
2648 implique donc que tout texte -- un titre, des paroles ou même une
2649 instruction musicale -- comportant des caractères non ASCII soit
2650 codé en UTF-8. Le plus sûr moyen de saisir du texte de la sorte
2651 consiste à utiliser un éditeur supportant l'unicode et à enregistrer vos
2652 fichier en UTF-8. C'est le cas pour la plupart des éditeurs actuels,
2653 que ce soit vim, Emacs, jEdit et Gedit. Tous les systèmes Windows
2654 postérieurs à NT utilisent Unicode en natif ; même Notepad est
2655 capable d'éditer et sauvegarder un fichier en UTF-8 -- sans parler de
2656 l'excellente alternative qu'est BabelPad.
2658 La compilation d'un fichier LilyPond comportant des caractères non ASCII
2659 qui n'aurait pas été enregistré dans l'encodage UTF-8 vous renverra
2663 FT_Get_Glyph_Name () erreur : invalid argument
2666 Voici un exemple utilisant du texte en cyrillique, en hébreux et en
2669 @c NOTE: No verbatim in the following example as the code does not
2670 @c display correctly in PDF Font settings for Cyrillic and Hebrew
2673 % Linux Libertine fonts contain Cyrillic and Hebrew glyphs.
2677 #:roman "Linux Libertine O,serif"
2678 #:sans "Linux Biolinum O,sans-serif"
2679 #:typewriter "Linux Libertine Mono O,monospace"
2684 bulgarian = \lyricmode {
2685 Жълтата дюля беше щастлива, че пухът, който цъфна, замръзна като гьон.
2689 hebrew = \lyricmode {
2690 זה כיף סתם לשמוע איך תנצח קרפד עץ טוב בגן.
2694 portuguese = \lyricmode {
2695 à vo -- cê uma can -- ção legal
2701 \addlyrics { \bulgarian }
2702 \addlyrics { \hebrew }
2703 \addlyrics { \portuguese }
2708 @unnumberedsubsubsec Unicode
2709 @translationof Unicode
2713 Lorsque vous avez besoin d'un caractère dont vous connaissez le point de
2714 code mais que votre éditeur ne permet pas de saisir directement, vous
2715 pouvez utiliser les instructions @code{\char ##xhhhh} ou
2716 @code{\char #dddd} au sein d'un bloc @code{\markup} -- @code{hhhh}
2717 et @code{dddd} correspondant respectivement à la valeur hexadécimale ou
2718 décimale. Même s'il est inutile de saisir les zéros superflus, il est
2719 de bon ton de stipuler les quatre caractères formant la représentation
2720 hexadécimale. Évitez cependant l'encodage UTF-8 d'un point de code
2721 après un @code{\char} ; les encodages UTF-8 comprennent un bit
2722 supplémentaire indiquant le nombre d'octets. Une table de
2723 correspondance entre les codes Unicode et le nom des caractères ainsi
2724 que leur code hexadécimal est disponible sur le site du consortium
2725 Unicode, @uref{http://www.unicode.org/}.
2727 Par exemple, @code{\char ##x03BE} et @code{\char #958} correspondent
2728 tous deux au caractère unicode U+03BE, dénommé @qq{Greek Small Letter
2731 Quel que soit le point de code spécifié de cette manière, il ne vous
2732 sera alors pas nécessaire d'enregistrer votre fichier en UTF-8. Vous
2733 devrez toutefois disposer d'une fonte contenant ce caractère qui soit
2734 accessible à LilyPond.
2736 L'exemple suivant illustre la manière d'insérer un caractère sous sa
2737 forme hexadécimale, à la fois dans un repère, dans une articulation,
2738 dans des paroles et dans du texte indépendant.
2740 @lilypond[quote,verbatim]
2743 c''1 \mark \markup { \char ##x03EE }
2744 c1_\markup { \tiny { \char ##x03B1 " to " \char ##x03C9 } }
2746 \addlyrics { O \markup { \concat { Ph \char ##x0153 be! } } }
2748 \markup { "Copyright 2008--2015" \char ##x00A9 }
2753 Le signe @emph{copyright} dans le champ de titrage consacré s'inscrit de
2754 la manière suivante :
2758 copyright = \markup @{ \char ##x00A9 "2008" @}
2763 @node Équivalents ASCII
2764 @unnumberedsubsubsec Équivalents ASCII
2765 @translationof ASCII aliases
2767 Dès lors que vous aurez inclus la liste de leur équivalent ASCII,
2768 LilyPond reconnaîtra un certain nombre de caractères spéciaux :
2770 @lilypond[quote,verbatim]
2772 #(include-special-characters)
2775 \markup "&flqq; – &OE;uvre incomplète… &frqq;"
2778 \new Staff { \repeat unfold 9 a'4 }
2780 This is al -- so wor -- kin'~in ly -- rics: –_&OE;…
2785 "The replacement can be disabled:"
2786 "– &OE; …"
2787 \override #'(replacement-alist . ()) "– &OE; …"
2791 L'extension de cette liste est possible aussi bien de manière globale :
2793 @lilypond[quote,verbatim]
2795 #(add-text-replacements!
2796 '(("100" . "hundred")
2797 ("dpi" . "dots per inch")))
2799 \markup "A 100 dpi."
2802 qu'en un point particulier de votre source :
2804 @lilypond[quote,verbatim]
2805 \markup \replace #'(("100" . "hundred")
2806 ("dpi" . "dots per inch")) "A 100 dpi."
2810 Manuel de notation :
2811 @ref{Liste des caractères spéciaux}.
2813 Fichiers d'initialisation :
2814 @file{ly/text-replacements.ly}.
2817 @node Contrôle des sorties
2818 @section Contrôle des sorties
2819 @translationof Controlling output
2822 * Extraction de fragments musicaux::
2823 * Ignorer des passages de la partition::
2824 * Formats de sortie alternatifs::
2825 * Changement des fontes musicales::
2829 @node Extraction de fragments musicaux
2830 @subsection Extraction de fragments musicaux
2831 @translationof Extracting fragments of music
2833 @cindex fragments, extraction
2835 @funindex clip-regions
2837 LilyPond permet d'extraire des fragments d'une partition, une fois
2838 definis explicitement le ou les emplacements de la musique concernés au
2839 sein du bloc @code{\layout} du fichier source, grâce à la fonction
2840 @code{clip-regions}, puis en lançant @command{lilypond} avec l'option
2841 @w{@code{-dclip-systems}}.
2848 (make-rhythmic-location 5 1 2)
2849 (make-rhythmic-location 7 3 4)))
2854 L'exemple ci-dessus permet d'extraire un seul fragment @emph{débutant}
2855 après une blanche dans la cinquième mesure (@code{5 1 2}) et
2856 @emph{finissant} après trois noires dans la septième
2857 mesure (@code{7 3 4}).
2859 D'autres fragments seront extraits dès lors que d'autres paires de
2860 @w{@code{make-rhythmic-location}} auront été ajoutées à la liste de
2861 @w{@code{clip-regions}} présente dans le bloc @code{\layout}.
2863 Chaque fragment sera généré individuellement sous la forme d'un fichier
2864 @code{EPS}, converti en @code{PDF} ou @code{PNG} selon le format que
2865 vous aurez stipulé. La musique extraite est rendue comme si elle avait
2866 été littéralement « découpée » dans la partition. Par voie de
2867 conséquence, un fragment dépassant une ligne fera l'objet d'autant de
2868 fichiers séparés que de lignes de la partition complète.
2871 Manuel de notation :
2872 @ref{Le bloc layout}.
2874 Manuel d'utilisation :
2875 @rprogram{Utilisation en ligne de commande}.
2878 @node Ignorer des passages de la partition
2879 @subsection Ignorer des passages de la partition
2880 @translationof Skipping corrected music
2882 @funindex skipTypesetting
2883 @funindex showFirstLength
2884 @funindex showLastLength
2886 Dans un travail de transcription ou de recopie de la musique, ce qui
2887 vous intéresse plus particulièrement se situe à la fin, là même où vous
2888 en êtes dans la notation. Dans le but de gagner du temps dans le
2889 processus de correction, vous pouvez @qq{escamoter} le reste et ne
2890 générer que les dernières mesures en insérant
2893 showLastLength = R1*5
2894 \score @{ @dots{} @}
2898 dans votre fichier source. Ceci aura pour effet de ne générer que les
2899 cinq dernières mesures -- si tant est que le morceau soit à 4/4 -- de
2900 tous les @code{\score} de votre fichier. Dans le cas d'un œuvre
2901 conséquente, cette pratique s'avère fort utile puisqu'elle évite de tout
2902 générer. Vous pourriez aussi être amené à retravailler le début d'une
2903 œuvre, pour y ajouter une partie par exemple, auquel cas c'est la
2904 propriété @code{showFirstLength} que vous utiliserez.
2906 Vous pouvez contrôler très finement les parties à escamoter, grâce au
2907 commutateur @code{Score.skipTypesetting} : lorsqu'il est activé,
2908 aucune gravure n'est réalisée.
2910 Ce commutateur agit aussi sur la sortie MIDI. Notez bien que tous les
2911 événements seront escamotés, y compris les changements de tempo ou
2912 d'instrument -- vous voilà prévenu !
2914 @lilypond[quote,ragged-right,verbatim]
2917 \set Score.skipTypesetting = ##t
2920 \set Score.skipTypesetting = ##f
2925 Dans le cadre de musique polyphonique, @code{Score.skipTypesetting}
2926 s'applique à toutes les voix et portées. Vous gagnerez donc encore plus
2930 @node Formats de sortie alternatifs
2931 @subsection Formats de sortie alternatifs
2932 @translationof Alternative output formats
2934 @cindex scalable vector graphics
2935 @cindex SVG, format de sortie
2936 @cindex encapsulated postscript
2937 @cindex EPS, format de sortie
2939 En matière de partition imprimable, LilyPond génère par défaut des
2940 documents au format PostScript (PS) et Portable Document Format (PDF).
2941 Vous pouvez aussi obtenir des documents au format Scalable Vector
2942 Graphics (SVG), Encapsulated PostScript (EPS) ou Portable Network
2943 Graphics (PNG) dès lors que vous aurez lancé LilyPond en ligne de
2944 commande avec l'option @i{ad hoc} -- voir
2945 @rprogram{Utilisation en ligne de commande} à ce sujet.
2948 @node Changement des fontes musicales
2949 @subsection Changement des fontes musicales
2950 @translationof Replacing the notation font
2952 Gonville est une alternative à la fonte Feta que LilyPond utilise par
2953 défaut. Vous pouvez la télécharger à partir de
2955 @uref{http://www.chiark.greenend.org.uk/~sgtatham/gonville/ ,http://www.chiark.greenend.org.uk/~sgtatham/gonville/}
2958 Voici quelques mesures utilisant la police Gonville :
2960 @c NOTE: these images are a bit big, but that's important
2961 @c for the font comparison. -gp
2962 @sourceimage{Gonville_after,15cm,,}
2964 Et ces même mesures avec la police de LilyPond, Feta :
2966 @sourceimage{Gonville_before,15cm,,}
2969 @subsubheading Instructions d'installation pour MacOS
2970 @translationof Installation Instructions for MacOS
2972 Téléchargez puis décompressez l'archive zip. Recopiez le répertoire
2973 @code{lilyfonts} dans @file{@var{SHARE_DIR}/lilypond/current} -- voir
2974 @rlearning{Autres sources de documentation} à ce sujet. Renommez le
2975 répertoire @code{fonts} qui s'y trouve en @code{fonts_orig}, puis le
2976 répertoire @code{lilyfonts} en @code{fonts}. Il vous suffira, pour
2977 retrouver la fonte Feta, de renommer @code{fonts_orig} en @code{fonts}.
2980 Manuel d'initiation :
2981 @rlearning{Autres sources de documentation}.
2984 Gonville ne permet pas de générer de la notation ancienne, et certains
2985 glyphes ajoutés depuis lors aux jeux de caractères en soient absent.
2986 Consultez le site de l'auteur pour de plus amples informations ainsi
2987 qu'à propos des conditions d'utilisation.
2990 @node Génération de fichiers MIDI
2991 @section Génération de fichiers MIDI
2992 @translationof Creating MIDI output
2997 LilyPond peut produire des fichiers conformes au standard MIDI (Musical
2998 Instrument Digital Interface), ce qui permet de vérifier le rendu à
2999 l'oreille grace à un logiciel ou un périphérique sachant interpréter le
3000 MIDI. L'écoute du rendu en MIDI permet de contrôler aisément ce que
3001 vous avez saisi : octaves et altérations erronées heurteront votre
3004 Les fichiers MIDI, contrairement aux fichiers AAC, MP3 ou Vorbis, ne
3005 contiennent pas de son et nécessitent donc le recours à un logiciel
3006 supplémentaire pour les écouter.
3009 * Notation prise en compte dans le MIDI::
3010 * Notation non prise en compte dans le MIDI::
3012 * Gestion des nuances en MIDI::
3013 * Gestion des instruments MIDI::
3014 * Gestion des répétitions en MIDI::
3015 * Affectation des canaux MIDI::
3016 * Propriétés de contextes et effets MIDI::
3017 * Amélioration du rendu MIDI::
3020 @node Notation prise en compte dans le MIDI
3021 @subsection Notation prise en compte dans le MIDI
3022 @translationof Supported notation for MIDI
3024 @cindex MIDI, éléments pris en compte
3026 LilyPond retranscrit par défaut dans un fichier MIDI les éléments de
3030 @item les marques de respiration,
3031 @item les accords nommés,
3032 @item les crescendos et decrescendos s'étendant sur plusieurs notes --
3033 le volume s'ajuste linéairement entre les deux extrêmes,
3034 @item les indications de nuance, de @code{ppppp} à @code{fffff}, y compris
3035 @code{mp}, @code{mf} et @code{sf},
3036 @item les microtonalités mais @emph{pas} sous forme d'accord ; leur
3037 rendu nécessite cependant un lecteur qui prenne en charge la
3041 @item le rythme sous forme de durée de note, y compris les n-olets,
3042 @item les articulations « simples » comme staccato, staccatissimo,
3043 accent, marcato et portato,
3044 @item les changements de tempo indiqués par un @code{\tempo},
3045 @item les liaisons de tenue,
3046 @item les tremolos, excepté ceux utilisant la syntaxe
3047 « @code{:}[@var{nombre}] ».
3050 Spatialisation, balance, expression, réverbération et chorus peuvent se
3051 contrôler à l'aide de propriétés de contexte -- voir
3052 @ref{Propriétés de contextes et effets MIDI}.
3054 En combinaison avec le script @file{articulate}, d'autres éléments
3055 seront aussi reportés en MIDI :
3058 @item les appoggiatures -- celles-ci prendront la moitié de la valeur,
3059 dépourvue de point, de la note qui les suit -- par exemple,
3062 \appoggiatura c8 d2.
3066 le do (noté @code{c}) prendra la valeur d'une noire.
3068 @item les ornements (mordants, trilles et groupettos, etc.),
3069 @item rallentando, accelerando, ritardando et a tempo,
3070 @item les liaisons y compris de phrasé,
3075 Voir @ref{Amélioration du rendu MIDI}.
3078 @node Notation non prise en compte dans le MIDI
3079 @subsection Notation non prise en compte dans le MIDI
3080 @translationof Unsupported notation for MIDI
3082 @cindex MIDI, éléments non pris en comte
3084 Certains éléments de notation ne peuvent être retranscrits dans un
3088 @item les articulations autres que staccato, staccatissimo, accent, marcato
3090 @item les crescendos et decrescendos sur @emph{une seule} note,
3091 @item les points d'orgue,
3092 @item la basse chiffrée,
3093 @item les glissandos,
3094 @item les chutes ou sauts,
3095 @item les accords en microtonalité,
3096 @item le rythme indiqué sous forme d'annotation, comme « swing »,
3097 @item les changements de tempo indiqués sous forme d'annotation (sans
3099 @item les trémolos indiqués par la syntaxe « @code{:}[@var{nombre}] ».
3104 @subsection Le bloc MIDI
3105 @translationof The MIDI block
3107 @cindex MIDI, le bloc
3109 LilyPond générera un fichier MIDI dès que vous ajouterez un bloc
3110 @code{\midi}, même vide, au sein du bloc @code{\score} :
3114 @var{@dots{}musique@dots{}}
3120 @warning{Lorsque le bloc @code{@bs{}score} contient uniquement un bloc
3121 @code{@bs{}midi} (autrement dit pas de bloc @code{@bs{}layout}),
3122 LilyPond produira uniquement la sortie MIDI -- aucun support visuel ne
3125 L'extension par défaut des fichiers MIDI générés (@code{.midi}) peut se
3126 modifier en ligne de commande :
3129 lilypond -dmidi-extension=mid MonFichier.ly
3132 Une autre manière de procéder consiste à placer la ligne suivante au
3133 début de votre fichier source, avant l'ouverture de tout bloc
3134 @code{\book}, @code{\bookpart} ou @code{\score} -- voir
3135 @ref{Structure de fichier} :
3138 #(ly:set-option 'midi-extension "mid")
3142 Manuel de notation :
3143 @ref{Structure de fichier}.
3145 Fichiers d'initialisation :
3146 @file{scm/midi.scm}.
3149 Le standard MIDI dispose de 15 canaux plus un (le numéro 10) affecté aux
3150 percussions. Les portées sont assignées l'une après l'autre à un canal.
3151 Dans la mesure où une partition comporte plus de 15 portées, les portées
3152 au-delà de la quinzième partageront un même canal MIDI, sans toutefois
3153 l'écraser. Ceci peut entraîner des conflits au niveau des canaux en
3154 raison des propriétés MIDI, notamment l'instrument utilisé.
3156 @node Gestion des nuances en MIDI
3157 @subsection Gestion des nuances en MIDI
3158 @translationof Controlling MIDI dynamics
3160 @cindex MIDI, gestion des nuances
3162 Le volume général de la sortie MIDI peut se définir, ainsi que ses
3163 modulations, en fonction des indications de nuance et les volumes
3164 relatifs entre les différents instruments.
3166 Les indications de nuance se traduisent automatiquement en niveau de
3167 volume dans l'amplitude disponible en MIDI alors que crescendos et
3168 diminuendos auront une progression linéaire entre les extrêmes.
3171 * Indication des nuances en MIDI::
3172 * Réglage du volume en MIDI::
3173 * Réglage de propriétés dans le bloc MIDI::
3177 @node Indication des nuances en MIDI
3178 @unnumberedsubsubsec Indication des nuances en MIDI
3179 @translationof Dynamic marks in MIDI
3181 @cindex MIDI, indications de nuance
3183 Les indications de nuance, de @code{ppppp} à @code{fffff} -- y compris
3184 @code{mp}, @code{mf} et @code{sf} -- ont des valeurs prédéfinies. Ce
3185 coefficient est alors appliqué pour corriger le volume général de façon
3186 à obtenir le niveau sonore qui sera retranscrit dans le fichier de
3187 sortie pour la nuance considérée. Nous allons, par défaut, de 0,25 pour
3188 un @notation{ppppp} à 0,95 pour un @notation{fffff}. Les
3189 correspondances entre nuance et fraction de volume sont répertoriées
3190 dans le fichier @file{scm/midi.scm}.
3193 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
3194 {creating-custom-dynamics-in-midi-output.ly}
3197 Fichiers d'initialisation :
3198 @file{ly/script-init.ly},
3199 @file{scm/midi.scm}.
3204 Référence des propriétés internes :
3205 @rinternals{Dynamic_performer}.
3207 @node Réglage du volume en MIDI
3208 @unnumberedsubsubsec Réglage du volume en MIDI
3209 @translationof Setting MIDI volume
3211 @cindex MIDI, réglage du volume
3213 Les valeurs extrêmes du volume MIDI des nuances se contrôlent à l'aide
3214 des propriétés @code{midiMinimumVolume} et @code{midiMaximumVolume} qui
3215 agissent au niveau @code{Score}. Ces propriétés sont effectives dès
3216 lors qu'une nuance est indiquée ; une nuance de départ explicite est donc
3217 requise pour que le volume soit ajusté dès le début de la partition.
3218 Vous pouvez alors modifier la fraction correspondant à chaque nuance à
3219 l'aide de la formule
3222 midiMinimumVolume + (midiMaximumVolume - midiMinimumVolume) * fraction
3225 Voici comment ajuster les nuances tout en limitant l'amplitude du volume
3232 \set Staff.midiInstrument = #"flute"
3233 @var{@dots{} music @dots{}}
3236 \set Staff.midiInstrument = #"clarinet"
3237 @var{@dots{} music @dots{}}
3243 midiMinimumVolume = #0.2
3244 midiMaximumVolume = #0.5
3250 La définition de l'amplitude du volume MIDI au niveau d'un contexte
3251 @code{Staff} -- grace aux propriétés @code{midiMinimumVolume} et
3252 @code{midiMaximumVolume} -- permet en quelque sorte d'égaliser un
3258 \set Staff.midiInstrument = #"flute"
3259 \set Staff.midiMinimumVolume = #0.7
3260 \set Staff.midiMaximumVolume = #0.9
3261 @var{@dots{} musique @dots{}}
3267 Dans le cas d'une partition à plusieurs portées et différents
3268 instruments, les volumes relatifs entre les différents instruments se
3269 gèrent individuellement :
3275 \set Staff.midiInstrument = #"flute"
3276 \set Staff.midiMinimumVolume = #0.7
3277 \set Staff.midiMaximumVolume = #0.9
3278 @var{@dots{} music @dots{}}
3281 \set Staff.midiInstrument = #"clarinet"
3282 \set Staff.midiMinimumVolume = #0.3
3283 \set Staff.midiMaximumVolume = #0.6
3284 @var{@dots{} music @dots{}}
3291 La clarinette de cet exemple jouera relativement moins fort que la
3294 En l'absence de tout réglage des propriétés de volume, LilyPond
3295 appliquera cependant un léger degré d'égalisation pour certains
3296 instruments -- voir @file{scm/midi.scm}.
3299 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
3300 {replacing-default-midi-instrument-equalization.ly}
3303 Fichiers d'initialisation :
3304 @file{scm/midi.scm}.
3306 Manuel de notation :
3307 @ref{Mise en forme de la partition}.
3309 Référence des propriétés internes :
3310 @rinternals{Dynamic_performer}.
3313 Les modifications apportées au volume MIDI n'interviennent que sur
3314 l'attaque d'une note, en conséquence de quoi crescendos et decrescendos
3315 n'affecteront pas le volume s'ils se produisent sur une même et unique
3319 @node Réglage de propriétés dans le bloc MIDI
3320 @unnumberedsubsubsec Réglage de propriétés dans le bloc MIDI
3321 @translationof Setting MIDI block properties
3323 Le bloc @code{\midi} peut contenir des aménagements pour certains
3324 contextes, la définition de contextes particuliers ou du code permettant
3325 de déterminer la valeur de certaines propriétés.
3329 @var{@dots{} music @dots{}}
3336 Le tempo est ici réglé à 72 noires par minute. Une indication de tempo
3337 inscrite dans le bloc @code{\midi} ne sera pas reportée sur la partition
3338 imprimable. Cependant, tout @code{\tempo} mentionné dans le bloc
3339 @code{\score} sera répercuté dans la sortie MIDI.
3341 Placée au sein d'un bloc @code{\midi}, la commande @code{\tempo}
3342 détermine des propriétés lors de la phase d'interprétation de la musique
3343 et dans le contexte de définition des sorties. Elle est alors
3344 considérée comme une modification de contexte.
3346 @cindex MIDI, définition de contexte
3347 @cindex contexte, définition en MIDI
3349 La syntaxe permettant de définir un contexte pour le @code{\midi} est en
3350 tout point identique à celle que vous utilisez dans le bloc
3355 @var{@dots{} musique @dots{}}
3359 \remove "Dynamic_performer"
3365 Ces quelques lignes ont pour effet de supprimer l'application des
3366 nuances à la sortie MIDI. Vous aurez noté que les modules de traduction
3367 de LilyPond en matière de son s'appelent @emph{performers} -- des
3371 Manuel d'initiation :
3372 @rlearning{Autres sources de documentation}.
3374 Manuel de notation :
3375 @ref{Mise en forme de la partition},
3376 @ref{Signes d'interprétation}.
3378 Fichiers d'initialisation :
3379 @file{ly/performer-init.ly}.
3384 Référence des propriétés internes :
3385 @rinternals{Dynamic_performer}.
3388 Certains lecteurs MIDI ne rendent pas correctement les changements de
3391 Les modifications de @code{midiInstrument} ou autres options MIDI en
3392 début de portée peuvent se retrouver dédoublées dans la sortie MIDI.
3394 @node Gestion des instruments MIDI
3395 @subsection Gestion des instruments MIDI
3396 @translationof Using MIDI Instruments
3398 @cindex instrument, nom d'
3399 @cindex MIDI, instruments
3400 @funindex Staff.midiInstrument
3402 L'instrument MIDI est déterminé par la propriété @code{midiInstrument},
3403 au sein d'un contexte @code{Staff}.
3408 \set Staff.midiInstrument = #"glockenspiel"
3409 @var{@dots{} music @dots{}}
3419 \new Staff \with @{midiInstrument = #"cello"@} @{
3420 @var{@dots{} music @dots{}}
3426 Lorsque l'instrument choisi ne correspond pas exactement à l'une des
3427 dénominations consacrées, LilyPond le remplacera par un piano de concert
3428 (@code{"acoustic grand"}) -- voir @ref{Instruments MIDI}.
3431 Manuel d'initiation :
3432 @rlearning{Autres sources de documentation}.
3434 Manuel de notation :
3435 @ref{Instruments MIDI},
3436 @ref{Mise en forme de la partition}.
3438 Référence des propriétés internes :
3439 @rinternals{Dynamic_performer}.
3441 Fichiers d'initialisation :
3442 @file{scm/midi.scm}.
3445 Les percussions gérées par un contexte @code{DrumStaff} sont affectées
3446 directement au canal 10 qui leur est réservé. Certains instruments, tels
3447 le xylophone, le marimba, le vibraphone ou les timbales, se traitent
3448 cependant comme des instruments « classiques » puisqu'ils sont capables
3449 d'émettre des hauteurs différentes ; leur notation relève donc d'un
3450 contexte @code{Staff} standard, et non d'un @code{DrumStaff} pour
3451 pouvoir être rendus correctement en MIDI. Une liste complète des
3452 percussions affectées au canal 10 (@code{channel 10 drum-kits}) est
3453 disponible dans le fichier @file{scm/midi.scm} -- voir
3454 @rlearning{Autres sources de documentation}.
3457 @node Gestion des répétitions en MIDI
3458 @subsection Gestion des répétitions en MIDI
3459 @translationof Using repeats with MIDI
3461 @cindex reprises développées
3462 @cindex MIDI et reprises
3463 @funindex \unfoldRepeats
3465 Les reprises de toutes sortes peuvent être rendues dans le fichier MIDI.
3466 Il suffit pour cela de recourir à la fonction @code{\unfoldRepeats}, qui
3467 développe toutes les reprises.
3472 \repeat tremolo 8 @{ c'32 e' @}
3473 \repeat percent 2 @{ c''8 d'' @}
3474 \repeat volta 2 @{ c'4 d' e' f' @}
3484 Lorsque l'on veut utiliser @code{\unfoldRepeats} seulement pour le rendu
3485 MIDI, il faut établir @b{deux} blocs @code{\score} : un pour le MIDI,
3486 avec des reprises explicites, et l'autre pour la partition, avec des
3487 reprises notées sous forme de barres de reprise, de trémolo ou de
3488 symboles de pourcentage. Par exemple
3492 @var{@dots{} musique @dots{}}
3496 \unfoldRepeats @var{@dots{} musique @dots{}}
3501 Dans une partition comportant plusieurs voix, le développement des
3502 reprises ne sera effectif en MIDI qu'à la condition que ces reprises
3503 soient mentionnée correctement dans @strong{toutes} les voix.
3506 Manuel de notation :
3507 @ref{Répétitions et reprises}.
3511 @node Affectation des canaux MIDI
3512 @subsection Affectation des canaux MIDI
3513 @translationof MIDI channel mapping
3515 @cindex MIDI, canaux
3516 @cindex MIDI, pistes
3517 @funindex midiChannelMapping
3519 Lorsque LilyPond génère un fichier MIDI à partir d'une partition, chaque
3520 note contenue dans cette partition sera automatiquement assignée à un
3521 canal MIDI, celui sur lequel elle devrait être jouée quand elle est
3522 transmise à un périphérique MIDI. Chaque canal MIDI dispose d'un
3523 certain nombre de contrôles pour, par exemple, sélectionner l'instrument
3524 +qui jouera les notes de ce canal ou bien demander au périphérique MIDI
3525 d'appliquer différents effets au son produit sur ce canal. En tout état
3526 de cause, chaque contrôle d'un canal MIDI ne peut se voir affecté que
3527 d'une seule valeur à la fois -- celle-ci peut toutefois être modifiée
3528 pour, par exemple, changer d'instrument au milieu du morceau.
3530 Le standard MIDI ne dispose que de 16 canaux par périphérique MIDI.
3531 Cette limite du nombre de canaux entraîne une limitation du nombre
3532 d'instruments pouvant jouer de concert.
3534 LilyPond crée une piste MIDI séparée pour chaque portée (ou chaque
3535 instrument ou voix selon la valeur de @code{Score.midiChannelMapping})
3536 ainsi que pour chaque contexte de paroles. Il n'y a pas de limite au
3539 Afin de contourner la limitation du nombre de canaux MIDI, LilyPond
3540 dispose de différents modes d'allocation d'un canal MIDI grâce à la
3541 propriété de contexte @code{Score.midiChannelMapping}. Dans tous les
3542 cas, lorsque la limite au nombre de canaux est atteinte, LilyPond repart
3543 du canal 0, ce qui peut affecter des notes au mauvais instrument. Cette
3544 propriété de contexte peut prendre les valeurs suivantes :
3550 Allocation d'un canal MIDI particulier à chacune des portées de la
3551 partition (option par défaut). Toutes les notes de toutes les voix
3552 d'une même portée partageront le canal MIDI affecté à la portée qui les
3553 englobe, et toutes seront encodées dans la même piste.
3555 La limite des 16 canaux s'applique au nombre total de portées augmenté
3556 des contextes de paroles même si les paroles MIDI n'occupent pas de
3559 @item @code{'instrument}
3561 Allocation d'un canal MIDI particulier à chaque instrument MIDI tel que
3562 spécifié dans la partition. En d'autre termes, des notes jouées par un
3563 même instrument MIDI partageront le même canal MIDI (et la même piste),
3564 même si elles proviennent de voix ou portées différentes.
3566 Dans ce cas particulier, les contextes de paroles ne sont pas pris en
3567 compte dans la limite des 16 canaux, puisqu'ils ne sont pas assignés à
3568 un instrument MIDI, ce qui permet une meilleure allocation des canaux
3569 MIDI lorsque le nombre de portées et de contextes de paroles dépasse 16.
3573 Allocation d'un canal MIDI particulier à chaque voix de la partition
3574 portant un nom unique parmi les voix de la portée considérée. Des voix
3575 appartenant à des portées différentes seront toujours affectées à des
3576 canaux MIDI différents, mais deux voix partageant la même portée
3577 partageront le même canal MIDI dès lors qu'elles porteront le même nom.
3578 Dans la mesure où @code{midiInstrument} et les différents contrôles
3579 d'effets MIDI sont des propriétés affectant le contexte de portée, ils
3580 ne peuvent se déterminer individuellement pour une voix. La première
3581 voix adoptera l'instrument et les effets spécifiés pour cette portée, et
3582 les voix dénommées différemment de la première se verront attribué
3583 l'instrument et le effets par défaut.
3585 Note : l'affectation d'instruments ou d'effets différents aux
3586 differentes voix d'une même portée s'obtient dès lors que le
3587 @code{Staff_performer} est déplacé du contexte @code{Staff} au contexte
3588 @code{Voice} tout en maintenant le @code{midiChannelMapping} dans le
3589 contexte @code{'staff} ou en le réglant sur @code{'instrument}.
3593 Par exemple, l'affectation par défaut des canaux MIDI d'une partition
3594 peut être réglée sur @code{'instrument} comme ceci :
3602 midiChannelMapping = #'instrument
3609 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
3610 {changing-midi-output-to-one-channel-per-voice.ly}
3613 @node Propriétés de contextes et effets MIDI
3614 @subsection Propriétés de contextes et effets MIDI
3615 @translationof Context properties for MIDI effects
3619 @cindex spatialisation (pan), MIDI
3620 @cindex stéréo MIDI, balance
3621 @cindex balance MIDI
3622 @cindex expression MIDI
3625 @funindex midiPanPosition
3626 @funindex midiBalance
3627 @funindex midiExpression
3628 @funindex midiReverbLevel
3629 @funindex midiChorusLevel
3631 Les différentes propriétés de contexte qui suivent permettnt d'appliquer
3632 différents effets MIDI aux notes contenues dans le canal MIDI associé à
3633 la portée courante, à l'instrument ou à la voix, selon la valeur
3634 affectée à la propriété de contexte @code{Score.midiChannelMapping} et
3635 le contexte dans lequel le @code{Staff_performer} réside -- voir
3636 @ref{Affectation des canaux MIDI}.
3638 Une adaptation de ces propriétés de contexte affectera toutes les notes
3639 jouées sur ce canal dès leur modification. Certains effets pourront
3640 même s'appliquer sur des notes déjà en cours, selon l'implémentation du
3641 périphérique de sortie MIDI.
3643 LilyPond dispose des propriétés de contexte suivantes :
3647 @item @code{Staff.midiPanPosition}
3649 La spatialisation (@emph{pan position}) contrôle le positionnement d'un
3650 canal MIDI entre les sorties stéréo droite et gauche. Cette propriété
3651 de contexte prend en argument une valeur entre -1.0 (@code{#LEFT})
3652 et 1.0 (@code{#RIGHT}). Une valeur de -1.0 enverra toute la puissance
3653 sonore sur le haut-parleur gauche (le droit sera silencieux), une
3654 vaaleur de 0.0 (@code{#CENTER}) distribuera équitablement le son entre
3655 les jaut-parleurs de gauche et de droite, et une valeur de 1.0 enverra
3656 tout le son sur le haut-parleur de droite. Des valeurs entre -1.0 et
3657 1.0 permettent d'obtenir une répartition du son entre les sorties
3658 gauche et droite d'un équipement stéréophonique.
3661 @item @code{Staff.midiBalance}
3663 La balance stéréo d'un canal MIDI. Tout comme la spatialisation, cette
3664 propriété de contexte prend en argument une valeur comprise entre -1.0
3665 (@code{#LEFT}) et 1.0 (@code{#RIGHT}). Elle permet de faire varier le
3666 volume relatif envoyé aux deux haut-parleurs stéréo sans pour autant
3667 affecter la distribution des signaux stéréo.
3669 @item @code{Staff.midiExpression}
3671 Le niveau d'expression, en tant que fraction du niveau maximum de volume
3672 disponible, à appliquer à un canal MIDI. Un périphérique MIDI combine
3673 le niveau d'expression des canaux MIDI et le niveau de nuance de la voix
3674 en cours (tel que défini par @code{\p} ou @code{\ff}) afin d'obtenir le
3675 volume total de chacune des notes de la voix. Un contrôle de
3676 l'expression permet, par exemple, d'implémenter des effets de crescendo
3677 ou decrescendo sur une note tenue, ce que LilyPond ne sait pas faire
3680 @c Issue 4059 contains an attached snippet which shows how this might
3681 @c be done, but this is too large and complex for the NR, even as a
3682 @c referenced snippet. It could be added to the LSR.
3684 Le niveau d'expression varie entre 0.0 (sans expression, autrement dit
3685 volume à zéro) et 1.0 (volume au maximum).
3687 @item @code{Staff.midiReverbLevel}
3689 Le niveau de réverbération, en tant que fraction du niveau maximum
3690 disponible, à appliquer à un canal MIDI. Cette propriété prend en
3691 argument une valeur entre 0.0 (pas d'écho) et 1.0 (effet maximal).
3693 @item @code{Staff.midiChorusLevel}
3695 Le niveau de chœur, en tant que fraction du niveau maximum disponible, à
3696 appliquer à un canal MIDI. Cette propriété prend en argument une valeur
3697 entre 0.0 (pas de chorus) et 1.0 (effet maximal).
3703 Dans la mesure où les fichiers MIDI ne comportent effectivement aucune
3704 donnée audio, les modifications des propriétés de contexte ne se
3705 traduisent qu'en requêtes de changement des contrôles du canal MIDI
3706 lorsque ces fichiers MIDI sont joués. La manière dont un périphérique
3707 MIDI particulier, tel un synthétiseur MIDI logiciel, gérera ces
3708 requêtes incluses dans un fichier MIDI dépend complètement de
3709 l'implémentation du périphérique : certains d'entre eux pourront
3710 simplement ignorer plusieurs, voire toutes ces requêtes. Par ailleurs,
3711 la manière dont un périphérique MIDI interprète les différentes valeurs
3712 de ces contrôles (en règle générale, le standard MIDI ne fixe le
3713 comportement qu'aux valeurs extrêmes de l'amplitude disponible pour
3714 chacun des contrôles) et leur modification alors qu'une note sur un
3715 canal est tenue, dépend de l'implémentation particulière à ce
3718 Lors de la génération d'un fichier MIDI, LilyPond transforme simplement
3719 les valeurs fractionnaires dans l'amplitude linéaire en valeurs entières
3720 correspondantes (de 0 à 127 et sur 7 octets, ou de 0 à 32767 et sur 14
3721 octets pour les contrôles MIDI supportant une résolution fine). Ces
3722 valeurs entières converties sont stockées telles quelles dans le
3723 fichier MIDI généré. Pour plus d'information sur la manière dont un
3724 périphérique MIDI interprète ces valeurs, se reporter à sa
3728 @node Amélioration du rendu MIDI
3729 @subsection Amélioration du rendu MIDI
3730 @translationof Enhancing MIDI output
3732 Le fichier MIDI généré par LilyPond est relativement brut. Il peut
3733 toutefois être amélioré en affectant des instruments MIDI, en réglant
3734 des propriétés au sein du bloc @code{\midi} ou en utilisant le script
3738 * Le script articulate::
3742 @node Le script articulate
3743 @unnumberedsubsubsec Le script @file{articulate}
3744 @translationof The articulate script
3746 @cindex MIDI, instruments
3747 @cindex articulate, script
3748 @funindex Staff.midiInstrument
3750 L'utilisation du script @file{articulate} se fait après avoir ajouté en
3751 tête de fichier la commande @code{\include} appropriée :
3754 \include "articulate.ly"
3757 Le script créera une sortie MIDI dont les notes seront échelonées de
3758 sorte à tenir compte de toute articulation ou changement de tempo. La
3759 sortie imprimable sera toutefois modifiée en profondeur, pour refléter
3760 littéralement la sortie MIDI.
3765 @var{@dots{} musique @dots{}}
3771 Le script @file{articulate} tient compte des abréviations telles que les
3772 trilles ou groupettos. L'intégralité des éléments traités est
3773 répertoriée dans le script lui-même -- voir @file{ly/articulate.ly}.
3776 Manuel d'initiation :
3777 @rlearning{Autres sources de documentation}.
3779 Manuel de notation :
3780 @ref{Mise en forme de la partition}.
3782 Fichiers d'initialisation :
3783 @file{ly/articulate.ly}.
3785 @warning{Dans la mesure où le script @file{articulate} tend à raccourcir
3786 les accords, certaines musiques, notamment pour l'orgue, paraîtront de
3787 moins bonne qualité. Les notes dépourvues d'articulation peuvent aussi
3788 se voir raccourcies ; pour pallier cet inconvénient, le recours à la
3789 fonction @code{@bs{}articulate} devrait ne concerner que de courts
3790 fragments, sauf à modifier les valeurs des variables contenues dans le
3791 script @file{articulate}.}
3794 @node Extraction d'informations musicales
3795 @section Extraction d'informations musicales
3796 @translationof Extracting musical information
3798 En plus de générer du graphisme et du MIDI, LilyPond peut présenter
3799 l'information musicale sous forme textuelle.
3802 * Affichage de notation au format LilyPond::
3803 * Affichage de la musique sous forme d'expression Scheme::
3804 * Enregistrement d'événements musicaux dans un fichier::
3808 @node Affichage de notation au format LilyPond
3809 @subsection Affichage de notation au format LilyPond
3810 @translationof Displaying LilyPond notation
3812 @funindex \displayLilyMusic
3814 La fonction musicale @code{\displayLilyMusic} permet d'afficher en
3815 notation LilyPond une expression musicale. Le résultat défilera dans le
3816 terminal après avoir lancé LilyPond en ligne de commande. Par exemple,
3820 \displayLilyMusic \transpose c a, @{ c4 e g a bes @}
3827 @{ a,4 cis4 e4 fis4 g4 @}
3830 LilyPond affichera le résultat sous forme de message en console, au
3831 milieu de toutes les informations de compilation. Afin d'isoler ces
3832 messages et enregistrer le résultat de la fonction
3833 @code{\displayLilyMusic}, pensez à rediriger la sortie vers un fichier.
3836 lilypond fichier.ly > affichage.txt
3841 Vous noterez que LilyPond ne se contente pas de simplement afficher
3842 l'expression musicale, mais procède aussi à son interprétation -- du
3843 fait que @code{\displayLilyMusic} renvoie l'expression tout en
3844 l'affichant. La simple insertion d'un @code{\displayLilyMusic} dans une
3845 expression musicale permet d'obtenir l'information la concernant.
3847 Si l'instruction @code{\displayLilyMusic} interprète et affiche des
3848 informations sur un fragment, la faire précéder d'un @code{\void} aura
3849 pour effet de l'exclure du fichier résultant.
3853 \void \displayLilyMusic \transpose c a, @{ c4 e g a bes @}
3859 @node Affichage de la musique sous forme d'expression Scheme
3860 @subsection Affichage de la musique sous forme d'expression Scheme
3861 @translationof Displaying scheme music expressions
3863 Voir @rextend{Affichage d'expressions musicales}.
3866 @node Enregistrement d'événements musicaux dans un fichier
3867 @subsection Enregistrement d'événements musicaux dans un fichier
3868 @translationof Saving music events to a file
3870 LilyPond vous permet de sauvegarder dans un fichier séparé, sur la base
3871 de la portée, les événements musicaux. Vous devrez pour ce faire
3872 inclure dans votre fichier maître un fichier d'initialisation
3876 \include "event-listener.ly"
3879 Pour chaque portée que comporte votre partition, vous obtiendrez un
3880 fichier @file{NOMFICHIER-PORTÉENOMMÉE.notes} ou
3881 @file{NOMFICHIER-unnamed-staff.notes}. Notez bien que si plusieurs
3882 portées ne sont pas explicitement nommées, tous leurs événements seront
3883 regroupés et mélangés dans le même fichier. Le résultat ressemblera à
3887 0.000 note 57 4 p-c 2 12
3889 0.250 note 62 4 p-c 7 12
3890 0.500 note 66 8 p-c 9 12
3891 0.625 note 69 8 p-c 14 12
3896 Il s'agit d'un tableau dont les colonnes sont délimitées par une
3897 tabulation. Chaque ligne comporte deux champs fixes suivis d'un certain
3898 nombre de paramètres optionnels.
3901 @var{temps} @var{type} @var{@dots{}paramètres@dots{}}
3904 Ces informations peuvent faire l'objet d'un retraitement par d'autres
3905 programmes, comme des scripts python, aux fins de recherche en analyse
3906 musicologique ou des expériences à partir du rendu de LilyPond.
3909 Tous les événements ne sont pas pris en charge par
3910 @file{event-listener.ly}. Il s'agit en premier lieu d'une
3911 démonstration, un @qq{proof of concept} du potentiel de LilyPond. Si
3912 certains des éléments que vous cherchez à obtenir n'apparaissent pas,
3913 recopiez le fichier @file{event-listener.ly} dans votre répertoire et
3914 modifiez-le de telle sorte qu'il travaille selon vos attentes.