1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
4 Translation of GIT committish: 58aaa226bb22be92f59fec8da680d135666222cc
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. For details, see the Contributors'
8 Guide, node Updating translation committishes..
13 @c Translators: Jean-Charles Malahieude, Valentin Villenave
15 @node Généralités en matière d'entrée et sortie
16 @chapter Généralités en matière d'entrée et sortie
17 @translationof General input and output
19 Nous n'allons pas, dans ce chapitre, parler directement de notation,
20 mais plutôt du contenu des fichiers source et du résultat produit par
24 * Agencement du code::
26 * Travail sur des fichiers texte::
27 * Contrôle des sorties::
29 * Extraction d'informations musicales::
33 @node Agencement du code
34 @section Agencement du code
35 @translationof Input structure
37 LilyPond traite des fichiers textuels. Ces fichiers portent par
38 convention une extension @code{.ly}.
41 * Structure d'une partition::
42 * Plusieurs partitions dans un même ouvrage::
43 * Plusieurs éditions pour une même source::
44 * Nom des fichiers de sortie::
45 * Structure de fichier::
49 @node Structure d'une partition
50 @subsection Structure d'une partition
51 @translationof Structure of a score
55 Un bloc @code{\score} contient obligatoirement une seule expression
56 musicale délimitée par des accolades :
64 @warning{Il ne doit y avoir qu'@strong{une seule} expression musicale
65 globale dans un bloc @code{@bs{}score}, et elle @strong{doit} être
66 bornée par une paire d'accolades.}
68 Cette unique expression musicale peut être de n'importe quelle taille et
69 contenir d'autres expressions musicales aussi complexes soient elles.
70 Voici quelques exemples d'expression musicale :
76 @lilypond[verbatim,quote]
83 @lilypond[verbatim,quote]
85 \new Staff { c'4 c' c' c' }
86 \new Staff { d'4 d' d' d' }
94 \new Staff @{ \flute @}
95 \new Staff @{ \hautbois @}
98 \new Staff @{ \violonI @}
99 \new Staff @{ \violonII @}
105 Les commentaires constituent l'une des rares exceptions à cette règle
106 immuable -- voir @ref{Structure de fichier} pour les autres. Qu'il
107 s'agisse d'une seule ligne ou de tout un bloc -- délimité par @code{%@{
108 .. %@}} -- un commentaire peut se placer n'importe où dans le fichier
109 source, aussi bien à l'intérieur qu'à l'extérieur du bloc @code{\score},
110 ou encore à l'intérieur ou à l'extérieur de l'expression musicale
111 contenue dans un bloc @code{\score}.
113 Lorsqu'un fichier ne comprend qu'un bloc @code{\score}, celui-ci est
114 implicitement inclus dans un bloc @code{\book}. Le bloc @code{\book}
115 d'un fichier source permet la production d'au moins un fichier dont le
116 nom sera, par défaut, déduit du fichier source : le traitement de
117 @file{fandangopourelephants.ly} produira donc
118 @file{fandangopourelephants.pdf}.
120 Pour de plus amples informations à propos du bloc @code{\book}, lisez
121 @ref{Plusieurs partitions dans un même ouvrage},
122 @ref{Plusieurs éditions pour une même source} et
123 @ref{Structure de fichier}.
126 Manuel d'initiation :
127 @rlearning{La partition est une (unique) expression musicale composée},
128 @rlearning{Les expressions musicales en clair},
129 @rlearning{Travail sur les fichiers d'entrée}.
132 @node Plusieurs partitions dans un même ouvrage
133 @subsection Plusieurs partitions dans un même ouvrage
134 @translationof Multiple scores in a book
136 @cindex mouvements, plusieurs
137 @cindex plusieurs mouvements
141 Un ouvrage peut se composer de plusieurs morceaux et de texte. C'est le
142 cas des cahiers d'exercices ou d'une partie d'orchestre avec ses
143 différents mouvements. Chaque mouvement fait l'objet d'un bloc
152 et le texte est contenu dans un bloc @code{\markup},
162 Les différents mouvements et textes qui apparaissent dans un même
163 fichier @file{.ly} ne composeront en principe qu'un seul fichier
178 Attention cependant si vous travaillez avec lilypond-book : il vous
179 faudra explicitement mentionner le bloc @code{\book}, en l'absence de
180 quoi seul le premier @code{\score} ou @code{\markup} apparaîtra après
183 L'entête de chaque pièce peut se placer au sein du bloc @code{\score} ;
184 le contenu du champ @code{piece} viendra s'imprimer avant chaque
185 mouvement. De même, le titre de l'ouvrage peut se placer au sein du
186 bloc @code{\book}. Dans le cas contraire, le contenu du bloc
187 @code{\header} placé en début de fichier sera utilisé.
191 title = "Huit miniatures"
192 composer = "Igor Stravinsky"
196 \header @{ piece = "Romance" @}
199 ..texte du second couplet..
202 ..texte du troisième couplet..
206 \header @{ piece = "Menuet" @}
212 Plusieurs pièces seront regroupées dans un même « 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
259 \layout @{ @dots{} @}
263 \layout @{ @dots{} @}
267 \layout @{ @dots{} @}
275 @file{huitminiatures.pdf},
277 @file{huitminiatures-1.pdf} et
279 @file{huitminiatures-2.pdf}.
283 @node Nom des fichiers de sortie
284 @subsection Nom des fichiers de sortie
285 @translationof Output file names
287 @funindex \bookOutputSuffix
288 @funindex \bookOutputName
290 LilyPond vous permet de prendre le contrôle dans la dénomination des
291 fichiers que vous voulez générer, quel que soit le moteur de rendu
294 Nous avons vu dans la rubrique précédente que LilyPond évite les
295 conflits de nom des fichiers qu'il génère à partir d'une même source.
296 Vous pouvez même définir vous-même le suffixe qui sera appliqué à chacun
297 des blocs @code{\book}. Ainsi, en reprenant l'exemple ci-avant, vous
298 obtiendrez les fichiers @file{huitminiatures-Romance.pdf},
299 @file{huitminiatures-Menuet.pdf} et @file{huitminiatures-Nocturne.pdf}
300 en ajoutant simplement une déclaration @code{\bookOutputSuffix} au sein
301 de chaque bloc @code{\book}.
305 \bookOutputSuffix "Romance"
310 \bookOutputSuffix "Menuet"
315 \bookOutputSuffix "Nocturne"
321 La déclaration @code{\bookOutputName} vous permet de définir vous-même
322 le nom du fichier généré pour un bloc @code{\book} :
326 \bookOutputName "Romance"
331 \bookOutputName "Menuet"
336 \bookOutputName "Nocturne"
342 Le traitement de ce fichier produira :
354 @node Structure de fichier
355 @subsection Structure de fichier
356 @translationof File structure
366 Un fichier @code{.ly} peut contenir un certain nombre d'expressions de
367 haut niveau. Les expressions de haut niveau sont les suivantes :
371 Une définition de sortie, comme @code{\paper}, @code{\midi} et
372 @code{\layout}. Ces définitions, lorsqu'elles se trouvent à un niveau
373 supérieur, s'appliqueront à l'intégralité de l'ouvrage. Si l'une de ces
374 expression apparaît à plusieurs reprises à un niveau supérieur, les
375 différents contenus seront combinés, à ceci près qu'en cas de
376 déclarations conflictuelles, la dernière aura préséance. Des
377 informations complémentaires sont disponibles à la rubrique
378 @ref{Le bloc \layout}.
381 Une expression Scheme pure, telle que
382 @w{@code{#(set-default-paper-size "a7" 'landscape)}} ou
383 @w{@code{#(ly:set-option 'point-and-click #f)}}.
386 Un bloc @code{\header}, dont le contenu sera valide pour tout le
387 fichier. Il comporte en général les valeurs par défaut des champs de
388 titrage, tels le titre ou l'auteur entre autres, communs à tous les
389 blocs @code{\book} inclus dans le fichier -- voir
390 @ref{Généralités en matière de titrages}.
393 Un bloc @code{\score} pour la partition. Cette partition sera assemblée
394 avec les autres partitions se trouvant au même niveau pour composer le
395 @code{\book}. Vous pouvez modifier ce comportement à l'aide de la
396 variable @code{toplevel-score-handler} placée en tête. Le gestionnaire
397 par défaut est défini dans le fichier d'initialisation
398 @file{../scm/lily.scm}.
401 Un bloc @code{\book} permet de regrouper naturellement plusieurs
402 mouvements -- autrement dit plusieurs blocs @code{\score} -- dans un
403 même document. Lorsqu'il y a plusieurs @code{\score}, LilyPond génère
404 un seul fichier dans lequel les mouvements sont mis les uns à la suite
405 des autres, ce pour chacun des blocs @code{\book} rencontrés. La seule
406 raison qui peut vous demander d'expliciter plusieurs blocs @code{\book}
407 dans un fichier @file{.ly} est lorsque vous avez besoin de générer
408 différents documents à partir d'une même source. La présence explicite
409 d'un bloc @code{\book} est aussi nécessaire lorsque vous travaillez sur
410 un document lilypond-book qui reprendrait plusieurs @code{\score} ou
411 @code{\markup} dans un même extrait. Vous pouvez modifier ce
412 comportement à l'aide de la variable @code{toplevel-book-handler}
413 placée en tête. Le gestionnaire par défaut est défini dans le fichier
414 d'initialisation @file{../scm/lily.scm}.
417 Un bloc @code{\bookpart}. Un ouvrage peut se découper en plusieurs
418 parties à l'aide de blocs @code{\bookpart}, aussi bien pour alléger le
419 travail de l'algorithme de calcul des sauts de page, que si les réglages
420 du bloc @code{\paper} diffèrent d'une partie à l'autre.
423 Une expression musicale telle que
428 Ce bout de code sera placé dans un @code{\score} et intégré à l'ouvrage
429 en même temps que tous les autres @code{\score} ou expressions
430 musicales. En d'autres termes, un fichier qui ne contiendrait que cette
431 simple expression musicale sera traduit en
448 Vous pouvez modifier ce comportement à l'aide de la variable
449 @code{toplevel-music-handler} placée en tête. Le gestionnaire par
450 défaut est défini dans le fichier d'initialisation
451 @file{../scm/lily.scm}.
454 Du texte sous forme de @emph{markup} comme les paroles d'un couplet
457 2. Le première ligne du deuxième couplet.
461 De tels @emph{markups} seront imprimés là où ils apparaissent,
462 avant, après ou entre les expressions musicales.
465 @cindex identificateurs
468 Une variable, ou identificateur, telle que
470 toto = @{ c4 d e d @}
473 Vous pourrez la réutiliser plus loin dans votre fichier en saisissant
474 simplement @code{\toto}. Le nom des identificateurs ne doit être
475 formés que de caractères alphabétiques -- sans chiffre ni caractère
480 Voici trois éléments que vous pouvez placer à un niveau supérieur :
484 % pas en pleine largeur
495 Vous pouvez placer, n'importe où dans votre fichier, les instructions
499 @item @code{\version}
500 @item @code{\include}
501 @item @code{\sourcefilename}
502 @item @code{\sourcefileline}
504 Une ligne de commentaire, introduite par le signe @code{%}.
507 Un bloc de commentaire, délimité par @code{%@{ .. %@}}.
514 Vous pouvez insérer des espaces dans votre fichier source afin de lui
515 apporter une meilleure lisibilité. Les espaces superflus sont
516 normalement ignorés. Notez cependant qu'il est des cas où l'espace est
517 requis pour éviter tout risque d'erreur :
521 Autour d'une accolade, qu'elle soit ouvrante ou fermante ;
524 Après chaque commande ou variable, autrement dit tout élément qui
525 commence par un @code{\} ;
528 Après tout élément qui sera interprété comme une expression Scheme,
529 autrement dit tout élément qui commence par un @code{#} ;
532 Pour séparer les éléments d'une expression Scheme ;
535 En mode parole -- @code{lyricmode} -- avant et après les commandes
536 @code{\override} et @code{\set}.
541 Manuel d'initiation :
542 @rlearning{Organisation des fichiers LilyPond}.
545 @ref{Généralités en matière de titrages},
546 @ref{Le bloc \layout}.
549 @node Titres et entêtes
550 @section Titres et entêtes
551 @translationof Titles and headers
553 La plupart de la musique qui est éditée comporte un titre et le nom de
554 son compositeur ; certains ouvrages dispensent beaucoup plus
558 * Création de titres et entête ou pied de page::
559 * Titrages personnalisés::
560 * Notes de bas de page::
561 * Référencement des numéros de page::
562 * Table des matières::
566 @node Création de titres et entête ou pied de page
567 @subsection Création de titres et entête ou pied de page
568 @translationof Creating titles headers and footers
571 * Généralités en matière de titrages::
572 * Mise en forme par défaut des titrages subalternes::
573 * Mise en forme par défaut des entête et pied de page::
577 @node Généralités en matière de titrages
578 @unnumberedsubsubsec Généralités en matière de titrages
579 @translationof Titles explained
581 Chaque bloc @code{\book} apparaissant dans un même fichier source
582 résultera en un fichier indépendant, comme indiqué à la rubrique
583 @ref{Structure de fichier}. Chacun de ces fichiers résultants comporte
584 trois endroits où placer des titrages : le @strong{titrage de l'ouvrage}
585 au début de chaque recueil (@emph{book}), les @strong{titrages de
586 partie} au début de chaque partie (@emph{bookpart}) et les
587 @strong{titrages de morceau} avant chaque pièce (@emph{score}).
589 La valeur des champs de titrage @code{title} (le titre) et
590 @code{composer} (le compositeur) se définissent dans des blocs
591 @code{\header} -- la syntaxe appropriée et la liste des différents
592 champs disponibles par défaut sont à la section
593 @ref{Mise en forme par défaut des titrages subalternes}.
594 Les titrages d'un ouvrage, de ses parties ou des morceaux qu'il contient
595 peuvent tous comporter les même champs bien que, par défaut, le titrage
596 d'un morceau se limite à @code{piece} et @code{opus}.
598 Les blocs @code{\header} peuvent se placer à quatre endroits différents
599 qui formeront une hiérarchie descendante :
604 En tête du fichier source, avant même tout bloc @code{\book},
605 @code{\bookpart} ou @code{\score} ;
608 Au sein d'un bloc @code{\book} et en dehors de tout bloc
609 @code{\bookpart} ou @code{\score} qu'il contient ;
612 Au sein d'un bloc @code{\bookpart} et en dehors de tout bloc
613 @code{\score} qu'il contient ;
616 Après l'expression musicale incluse dans un bloc @code{\score}.
620 La valeur des différents champs sera filtrée en respectant cette
621 hiérarchie ; les valeurs persisteront à moins d'être écrasées par une
622 autre valeur à un niveau inférieur. Ainsi :
626 Le titre d'un ouvrage découle des champs définis en tête de fichier
627 source, modifiés par les champs définis au sein du bloc @code{\book}.
628 Les champs résultants serviront à affecter un titre de recueil à
629 l'ouvrage, si tant est que quoi que ce soit génère une page au début de
630 cet ouvrage, avant la première partie -- un simple saut de page forcé
631 (@code{\pageBreak}) suffit.
634 Le titre d'une partie découle des champs définis en tête du fichier
635 source, modifiés par les champs définis au sein du bloc @code{\book}
636 puis par ceux définis au sein du bloc @code{\bookpart}. Les valeurs qui
637 en résulteront permettront d'imprimer les titrages de partie pour cette
641 Le titre d'un morceau découle des champs définis en tête du fichier
642 source, modifiés par les champs définis au sein du bloc @code{\book}
643 puis par ceux définis au sein du bloc @code{\bookpart}, et enfin par
644 ceux définis au sein du bloc @code{\score}. Les valeurs qui en
645 résulteront permettront d'imprimer les titrages de morceau pour ce
646 morceau. Notez toutefois que, pour un morceau, seuls les champs
647 @code{piece} et @code{opus} seront imprimés, à moins d'avoir valorisé
648 à @code{#t} la variable @code{print-all-headers} dans la section
653 @warning{N'oubliez pas que lorsqu'il est placé à l'intérieur d'un bloc
654 @code{@bs{}score}, le bloc @code{@bs{}header} doit impérativement se
655 trouver @strong{à la suite} de l'expression musicale.}
657 Nul n'est besoin de fournir un bloc @code{\header} à chacun des quatre
658 niveaux ; on peut se passer aussi bien de l'un d'eux que de tous. Dans
659 la même veine, un fichier source simpliste peut ne pas mentionner de
660 bloc @code{\book} ou @code{\bookpart} qui seront alors créés
663 Lorsque l'ouvrage ne comporte qu'un seul morceau, le bloc @code{\header}
664 devrait prendre place en tête de fichier, de telle sorte que soit produit
665 un titrage de partie qui met à disposition tous les champs de titrage.
667 Lorsque l'ouvrage comporte plusieurs morceaux, différents arrangements
668 du bloc @code{\header} permettent d'obtenir différents styles de
669 publication musicale. Par exemple, si la publication comprend plusieurs
670 pièces du même compositeur, un bloc @code{\header} placé en tête de
671 fichier définira le titre de l'ouvrage et le compositeur, que l'on
672 complètera par un bloc @code{\header} dans chaque bloc @code{\score}
673 pour définir les champs @code{piece} et @code{opus}, comme ici :
675 @lilypond[papersize=a5,quote,verbatim,noragged-right]
678 composer = "J. S. Bach."
682 \new Staff \relative g, {
685 \repeat unfold 2 { g16( d' b') a b d, b' d, } |
686 \repeat unfold 2 { g,16( e' c') b c e, c' e, } |
694 \new Staff \relative b {
698 <g, d' b'~>4 b'16 a( g fis) g( d e fis) g( a b c) |
699 d16( b g fis) g( e d c) b(c d e) fis( g a b) |
707 Des agencements plus élaborés sont aussi réalisables. Par exemple, les
708 champs appartenant au titrage principal d'un ouvrage peuvent se
709 reporter dans chaque bloc @code{\score}, certains étant modifiés voire
710 supprimés manuellement :
713 @lilypond[papersize=a5,quote,verbatim,noragged-right]
716 print-all-headers = ##t
719 title = "DAS WOHLTEMPERIRTE CLAVIER"
721 % Pas de mention spéciale pour cet ouvrage
724 \markup { \vspace #1 }
728 \new Staff { \clef "bass" s1 }
731 title = "PRAELUDIUM I"
733 % Pas de sous-titre pour ce morceau
740 \new Staff { \clef "bass" s1 }
744 subsubtitle = "A 4 VOCI"
746 % Pas de sous-titre pour ce morceau
755 @ref{Structure de fichier},
756 @ref{Mise en forme par défaut des titrages subalternes},
757 @ref{Mise en forme personnalisée des titrages}.
760 @node Mise en forme par défaut des titrages subalternes
761 @unnumberedsubsubsec Mise en forme par défaut des titrages subalternes
762 @translationof Default layout of bookpart and score titles
764 Voici les différentes variables attachées au bloc @code{\header} :
767 @lilypond[papersize=a7,quote,verbatim,noragged-right]
770 % Les champs suivants sont centrés
771 dedication = "Dédicace"
773 subtitle = "Sous-titre"
774 subsubtitle = "Sous-sous-titre"
775 % Les champs suivants sont répartis sur une même ligne, et
776 % le champ "instrument" apparaîtra sur les pages suivantes
777 instrument = \markup \with-color #green "Instrument"
779 composer = "Compositeur"
780 % Les champs suivants sont en opposition sur la même ligne
782 arranger = "Arrangeur"
783 % Les champs suivants sont centrés en bas de page
784 tagline = "« tagline » ou mention spéciale en pied de dernière page"
785 copyright = "copyright en pied de première page"
790 % Les champs suivants sont en opposition sur la même ligne
798 % Les champs suivants sont en opposition sur la même ligne
799 piece = "Pièce 2 sur la même page"
807 % Les champs suivants sont en opposition sur la même ligne
808 piece = "Pièce 3 sur une nouvelle page"
815 Quelques précisions :
819 Le nom de l'instrument sera répété en tête de chaque page.
822 Seuls seront imprimés les champs @code{piece} et @code{opus} inclus dans
823 un bloc @code{\score} dès lors que la variable @code{print-all-headers}
824 reste désactivée (valeur à @code{##f}).
827 @c Is the bit about \null markups true? -mp
828 Les champs d'un bloc @code{\header} qui n'auront pas été alimentés
829 seront remplacés par un @emph{markup} @code{\null} de façon à ne pas
833 Par défaut, @code{scoreTitleMarkup} place les champs @code{piece} et
834 @code{opus} de part et d'autre sur une même ligne.
838 Les possibilités de modifier la mise en forme par défaut sont abordées à
839 la rubrique @ref{Mise en forme personnalisée des titrages}.
843 Un bloc @code{\book} qui commencerait directement par un bloc
844 @code{\bookpart} ne verra pas ses titrages apparaître puisqu'il n'y a
845 aucune page où imprimer le titre. Si toutefois le titre de l'ouvrage
846 est requis, le bloc @code{\book} devra commencer par un @emph{markup} ou
847 une commande @code{\pageBreak}.
849 La variable @code{breakbefore} activée dans un bloc @code{\header} situé
850 dans un bloc @code{\score} force le saut de page avant le morceau
851 contenu dans ce @code{\score}. Vous pourrez ainsi séparer le titre
852 principal de la musique.
854 @lilypond[papersize=a8landscape,verbatim,noragged-right]
857 title = "This is my Title"
858 subtitle = "This is my Subtitle"
859 copyright = "This is the bottom of the first page"
862 \repeat unfold 4 { e'' e'' e'' e'' }
864 piece = "This is the Music"
872 Manuel d'initiation :
873 @rlearning{Organisation des fichiers LilyPond}.
876 @ref{Mise en forme personnalisée des titrages},
877 @ref{Structure de fichier}.
879 Fichiers d'initialisation :
880 @file{ly/titling-init.ly}.
883 @node Mise en forme par défaut des entête et pied de page
884 @unnumberedsubsubsec Mise en forme par défaut des entête et pied de page
885 @translationof Default layout of headers and footers
887 Les entête et pied -- @emph{header} et @emph{footer} -- sont des
888 lignes de textes qui apparaissent en haut et en bas de chaque page,
889 indépendamment du texte de l'ouvrage. Ils sont contrôlés par les
890 variables suivantes, attachées au bloc @code{\paper} :
893 @item @code{oddHeaderMarkup} -- entête de page impaire
894 @item @code{evenHeaderMarkup} -- entête de page paire
895 @item @code{oddFooterMarkup} -- pied de page impaire
896 @item @code{evenFooterMarkup} -- pied de page paire
899 Ces variables @emph{markup} n'accèdent qu'au contenu des champs du bloc
900 @code{\header} principal, celui qui s'appliquera à tous les blocs
901 @code{\score} du document. Ces variables sont définies dans le fichier
902 @file{ly/titling-init.ly}, et sont par défaut :
907 les numéros sont placés en haut à gauche (si pair) ou à droite (si
908 impair) de chaque page à compter de la deuxième ;
911 le contenu du champ @code{instrument} est centré en haut de chaque page
912 à compter de la deuxième ;
915 le texte du @code{copyright} est centré au bas de la première page ;
918 le @code{tagline} -- mention spéciale -- se place au bas de la dernière
919 page, ou bien sous le @code{copyright} s'il n'y a qu'une seule page.
923 @lilypond[papersize=a8landscape]
933 La mention spéciale se modifie en alimentant le champ @code{tagline} au
934 niveau du bloc @code{\header} principal.
936 @lilypond[papersize=a8landscape,verbatim]
939 tagline = "... music notation for Everyone"
949 Pour supprimer le @code{tagline}, il suffit de lui assigner la valeur
953 @node Titrages personnalisés
954 @subsection Titrages personnalisés
955 @translationof Custom titles headers and footers
957 @c TODO: somewhere put a link to header spacing info
958 @c (you'll have to explain it more in NR 4).
961 * Mise en forme personnalisée des champs de titrage::
962 * Mise en forme personnalisée des titrages::
963 * Mise en forme personnalisée des entête et pied de page::
967 @node Mise en forme personnalisée des champs de titrage
968 @unnumberedsubsubsec Mise en forme personnalisée des champs de titrage
969 @translationof Custom text formatting for title blocks
971 Toutes les commandes de mise en forme d'un @code{\markup} permettent de
972 personnaliser le texte des entête, pied de page et éléments de titrage
973 contenus dans un bloc @code{\header}.
975 @lilypond[quote,verbatim,noragged-right]
979 piece = \markup { \fontsize #4 \bold "PRAELUDIUM I" }
980 opus = \markup { \italic "(Excerpt)" }
987 @ref{Mise en forme du texte}.
990 @node Mise en forme personnalisée des titrages
991 @unnumberedsubsubsec Mise en forme personnalisée des titrages
992 @translationof Custom layout for titles
994 @cindex bookTitleMarkup
995 @cindex scoreTitleMarkup
996 @funindex bookTitleMarkup
997 @funindex scoreTitleMarkup
999 L'utilisation de commandes @code{\markup} au sein d'un bloc
1000 @code{\header} permet de modifier aisément l'apparence du texte,
1001 mais n'influence en rien le positionnement précis des éléments de
1002 titrage. L'accès au positionnement des champs de titrage est géré par
1003 les deux variables suivantes, attachées au bloc @code{\paper} :
1006 @item @code{bookTitleMarkup}
1007 @item @code{scoreTitleMarkup}
1010 Le positionnement des titres, avec les valeurs par défaut de ces
1011 variables @code{\markup}, est illustré à la rubrique
1012 @ref{Mise en forme par défaut des titrages subalternes}.
1014 Voici les réglages par défaut de @code{scoreTitleMarkup}, tels que
1015 définis dans le fichier @file{ly/titling-init.ly} :
1018 scoreTitleMarkup = \markup @{ \column @{
1019 \on-the-fly \print-all-headers @{ \bookTitleMarkup \hspace #1 @}
1021 \fromproperty #'header:piece
1022 \fromproperty #'header:opus
1028 Ceci aura donc pour effet de positionner les champs @code{piece} et
1029 @code{opus} sur la même ligne, en opposition :
1031 @lilypond[quote,verbatim,noragged-right]
1035 piece = "PRAELUDIUM I"
1041 Voici comment redéfinir le @code{scoreTitleMarkup} de telle sorte que le
1042 champ @code{piece}, dont nous modifions la taille et la graisse, se
1043 place au centre de cette ligne :
1045 @lilypond[papersize=a5,quote,verbatim,noragged-right]
1049 scoreTitleMarkup = \markup {
1052 \fontsize #4 \bold \fromproperty #'header:piece
1053 \fromproperty #'header:opus
1057 \header { tagline = ##f }
1061 piece = "PRAELUDIUM I"
1068 Les champs normalement absents du @code{\header} d'un bloc @code{\score}
1069 seront toutefois imprimés dès lors que vous aurez activé l'instruction
1070 @code{print-all-headers} au sein du bloc @code{\paper}. Le principal
1071 inconvénient de cette fonction réside dans le fait que les champs
1072 dévolus au titrage des parties devront être supprimés dans
1073 chacun des blocs @code{\score} de votre fichier source -- voir
1074 @ref{Généralités en matière de titrages}.
1076 Afin d'éviter ce désagrément, ajoutez le champ que vous désirez voir
1077 apparaître à la définition de @code{scoreTitleMarkup}. Nous allons,
1078 dans l'exemple suivant, ajouter au @code{scoreTitleMarkup} le champ
1079 @code{composer}, normalement associé au @code{bookTitleMarkup} ;
1080 chaque @code{\score} pourra alors mentionner un compositeur différent.
1082 @lilypond[papersize=a5,quote,verbatim,noragged-right]
1086 scoreTitleMarkup = \markup {
1089 \fontsize #4 \bold \fromproperty #'header:piece
1090 \fromproperty #'header:composer
1094 \header { tagline = ##f }
1099 composer = "Christian Petzold"
1106 composer = "François Couperin"
1112 Rien ne vous empêche de créer votre propre champ personnalisé, puis d'y
1113 faire référence dans la définition du @emph{markup}.
1115 @lilypond[papersize=a5,quote,verbatim,noragged-right]
1119 scoreTitleMarkup = \markup {
1122 \override #`(direction . ,UP) {
1124 \center-align \fontsize #-1 \bold
1125 \fromproperty #'header:mycustomtext %% User-defined field
1126 \center-align \fontsize #4 \bold
1127 \fromproperty #'header:piece
1130 \fromproperty #'header:opus
1134 \header { tagline = ##f }
1139 mycustomtext = "A 4 VOCI" %% User-defined field
1147 Manuel de notation :
1148 @ref{Généralités en matière de titrages}.
1151 @node Mise en forme personnalisée des entête et pied de page
1152 @unnumberedsubsubsec Mise en forme personnalisée des entête et pied de page
1153 @translationof Custom layout for headers and footers
1155 @c can make-header and make-footer be removed from
1156 @c paper-defaults-init.ly? -mp
1158 L'utilisation de commandes @code{\markup} au sein d'un bloc
1159 @code{\header} permet de modifier aisément l'apparence du texte,
1160 mais n'influence en rien le positionnement précis des entête et pied
1161 de page. L'accès au positionnement des champs concernés est géré par
1162 les quatre variables suivantes, attachées au bloc @code{\paper} :
1165 @item @code{oddHeaderMarkup}
1166 @item @code{evenHeaderMarkup}
1167 @item @code{oddFooterMarkup}
1168 @item @code{evenFooterMarkup}
1171 @cindex markup conditionnel
1172 @cindex condition et markup
1173 @cindex on-the-fly (à la volée)
1175 @funindex \on-the-fly
1177 L'instruction @code{\on-the-fly} au sein d'un @code{\markup} permet
1178 d'ajouter, lorsque certaines conditions sont respectées, des éléments
1179 au texte des entête et pied de page définis dans le bloc @code{\paper}.
1180 En voici la syntaxe :
1183 @code{variable} = @code{\markup} @{
1185 @code{\on-the-fly} \@var{procédure} @var{markup}
1190 La @var{procédure} est appelée à chaque fois que la commande
1191 @code{\markup} où elle apparaît est évaluée. La @var{procédure}
1192 effectuera un test de conformité particulier et interprètera, autrement
1193 dit imprimera l'argument @var{markup} si et seulement si cette
1194 condition est remplie.
1196 LilyPond dispose d'ores et déjà d'un certain nombre de procédures :
1199 @multitable {print-page-number-check-first-----} {ce n'est la première page du book--}
1201 @headitem Nom de la procédure @tab Condition testée
1203 @item print-page-number-check-first @tab il faut imprimer ce numéro de page.
1204 @item create-page-number-stencil @tab print-page-numbers est vrai.
1205 @item print-all-headers @tab print-all-headers est vrai.
1206 @item first-page @tab c'est la première page du @emph{book}.
1207 @item (on-page nombre) @tab numéro de page = nombre
1208 @item last-page @tab c'est la dernière page du @emph{book}.
1209 @item not-first-page @tab ce n'est la première page du @emph{book}.
1210 @item part-first-page @tab c'est la première page de la partie.
1211 @item part-last-page @tab c'est la dernière page de la partie.
1212 @item not-single-page @tab cette partie fait plus d'une page.
1217 L'exemple suivant illustre la manière de centrer son numéro au bas de
1218 chaque page. Il nous faut tout d'abord annuler les définitions de
1219 @code{oddHeaderMarkup} et @code{evenHeaderMarkup} à l'aide d'un
1220 @emph{markup} @code{\null}. Nous redéfinissons ensuite
1221 @code{oddFooterMarkup} pour qu'il contienne le numéro de page, centré.
1222 Enfin, nous appliquons le même paramétrage au @code{\oddFooterMarkup}.
1224 @lilypond[papersize=a8,quote,verbatim,noragged-right]
1227 print-page-number = ##t
1228 print-first-page-number = ##t
1229 oddHeaderMarkup = \markup \null
1230 evenHeaderMarkup = \markup \null
1231 oddFooterMarkup = \markup {
1233 \on-the-fly \print-page-number-check-first
1234 \fromproperty #'page:page-number-string
1237 evenFooterMarkup = \oddFooterMarkup
1240 \new Staff { s1 \break s1 \break s1 }
1245 Plusieurs conditions @code{\on-the-fly} mentionnées l'une à la suite de
1246 l'autre se cumulent. Ainsi, par exemple,
1249 @code{\on-the-fly \first-page}
1250 @code{\on-the-fly \last-page}
1251 @code{@{ \markup ... \fromproperty #'header: ... @}}
1254 teste si la sortie tient sur une page unique.
1257 Manuel de notation :
1258 @ref{Généralités en matière de titrages},
1259 @ref{Mise en forme par défaut des titrages subalternes}.
1261 fichiers d'initialisation :
1262 @file{../ly/titling-init.ly}.
1265 @node Notes de bas de page
1266 @subsection Notes de bas de page
1267 @translationof Creating footnotes
1269 @cindex bas de page, notes
1272 Les notes de bas de page sont utiles dans bien des situations. Dans
1273 tous les cas, un « appel de note » vient se placer en référence dans te
1274 texte ou la musique, et le « texte de la note » est reporté en bas de la
1277 Selon qu'elle est référencée dans une expression musicale ou dans du
1278 texte indépendant, une note de bas de page sera créée suivant une
1279 procédure différente.
1282 * Notes de bas de page dans une expression musicale::
1283 * Notes de bas de page dans du texte indépendant::
1287 @node Notes de bas de page dans une expression musicale
1288 @unnumberedsubsubsec Notes de bas de page dans une expression musicale
1289 @translationof Footnotes in music expressions
1291 @cindex musique et note de bas de page
1294 @subsubsubheading Généralités sur l'annotation de musique
1295 @c VO Music footnotes overview
1297 Il existe deux catégories d'annotation concernant une expression
1301 @item Les annotations événementielles
1302 se rattachent à des événements particuliers, comme une note individuelle,
1303 un élément d'interprétation (doigté, accent ou nuance) ou des événements
1304 postérieurs (liaison, ligature manuelle). Une note de bas de page
1305 événementielle se libelle généralement sous la forme :
1308 [@var{position}] \footnote [@var{marque}] @var{décalage} @var{annotation} @var{musique}
1311 @item Les annotations temporelles
1312 se rapportent à un point particulier du déroulement d'un contexte
1313 musical. Certaines commandes, telles @code{\time} et @code{\clef}, ne
1314 reposent pas sur un événement pour la création de l'objet métrique ou
1315 clef. Il en va de même pour un accord : sa hampe ou ses crochets ne
1316 sont créés qu'à la fin d'un moment (plus exactement au travers de l'un
1317 des événements note qui le composent). Il n'est pas possible de
1318 connaître assurément lequel des événements note d'un accord est
1319 plus particulièrement à l'origine de la hampe ou du crochet. Il
1320 est donc plus aisé, pour de tels éléments, d'utiliser des
1321 annotations temporelles.
1323 Une annotation temporelle permet d'annoter des objets de rendus
1324 sans se référer à un événement. Elle se libelle généralement sous
1328 \footnote [@var{marque}] @var{décalage} @var{annotation} [@var{Contexte}.]@var{nom-grob}
1333 Les arguments, quelle que soit la catégorie d'annotation, peuvent se
1338 Lorsque la commande @code{\footnote} s'applique à un élément
1339 d'interprétation ou un événement rattaché, et uniquement dans ces cas,
1340 elle doit être précédée d'un indicateur de positionnement (@code{-, _}
1341 ou @code{^}) de façon à rattacher @var{musique} (avec sa marque) à
1342 la note ou au silence qui précède.
1345 Un @emph{markup} ou une chaîne de caractères identifiant l'annotation
1346 tant au niveau de l'appel que de la note qui apparaîtra au bas de la
1347 page. L'absence de cet élément -- ou une valeur de @code{\default} --
1348 incrémentera automatiquement le compteur. Ce compteur est réinitialisé
1349 à chaque page comportant une annotation.
1352 Une paire de nombres -- @samp{#(2 . 1)} par exemple -- spécifiant le
1353 décalage de la marque, en abscisse et en ordonnée, par rapport au point
1354 de référence. Des valeurs positives décalent vers la droite ou le
1355 haut, des valeurs négatives vers la gauche ou le bas ; des valeurs à
1356 zéro centrent la marque sur le point de référence. Le décalage
1357 s'exprime en espace de portée.
1360 Le contexte auquel appartient l'objet à annoter. Cet argument
1361 peut être omis dès lors qu'il s'agit d'un contexte de bas niveau
1362 tel que @code{Voice}.
1365 Le type d'objet à annoter -- @samp{Flag} par exemple. Lorsque cet
1366 élément est spécifié, c'est l'objet en question qui servira de point de
1367 référence, même s'il trouve son origine non pas directement dans
1368 une expression musicale mais dans tout objet du type spécifié
1369 intervenant à cet instant précis de la partition.
1372 un @emph{markup} ou une chaîne de caractères qui sera reporté au bas de
1376 l'élément qui fait l'objet du commentaire, qu'il s'agisse d'un
1377 événement musical, de l'un des constituants d'un accord ou d'un
1383 @subsubsubheading Notes de bas de page événementielles
1384 @c VO Event-based footnotes
1386 @cindex événementielle, note de bas de page
1388 Ce type de note de bas de page s'attache à un objet de rendu
1389 généré directement par l'événement correspondant à @var{musique}.
1390 Il répond à la syntaxe :
1393 \footnote [@var{décalage}] @var{décalage} @var{annotation} @var{musique}
1397 @lilypond[quote,verbatim,papersize=a8landscape]
1399 \header { tagline = ##f }
1401 \footnote #'(-1 . 3) "Une note" a4
1403 \footnote #'(2 . 2) "Un silence" r4
1409 Un accord @emph{dans son intégralité} ne peut pas faire l'objet
1410 d'une note de bas de page événementielle : un accord, même s'il ne
1411 contient qu'une seule et unique note, ne génère aucun événement en
1412 propre. Une des notes @emph{au sein} de l'accord peut toutefois
1413 se voir attribuer une annotation :
1416 @lilypond[quote,verbatim,papersize=a8landscape]
1418 \header { tagline = ##f }
1420 \footnote #'(2 . 3) "Résultat non probant" <a-3>2
1421 <\footnote #'(-2 . -3) "Résultat probant" a-3>4
1422 <a-3 \footnote #'(3 . 1/2) "Tout aussi probant" c-5>4
1427 Lorsque l'annotation concerne un événement postérieur ou une
1428 articulation, la commande @code{\footnote} @strong{doit} être
1429 précédée d'un indicateur de position (@code{-, _} ou @code{^}) et
1430 suivie de l'événement postérieur ou l'articulation comme argument
1431 @var{musique}. Dans ce cas, la commande @code{\footnote} peut se
1432 considérer comme une copie de son dernier argument auquel on
1433 attache une annotation. La syntaxe consacrée est :
1436 @var{position} \footnote [@var{marque}] @var{décalage} @var{annotation} @var{musique}
1440 @lilypond[quote,verbatim,papersize=a8landscape]
1442 \header { tagline = ##f }
1444 a4_\footnote #'(0 . -1) "Une liaison arbitrairement en dessous" (
1445 b8^\footnote #'(1 . 0.5) "Une ligature manuelle forcée en haut" [
1448 c-\footnote #'(1 . 1) "Tenuto" --
1453 Les appels de note peuvent être personnalisés, et le trait reliant
1454 l'objet à l'appel supprimé :
1457 @subsubsubheading Notes de bas de page temporelles
1458 @c VO Time-based footnotes
1460 @cindex temporelle, note de bas de page
1462 Lorsque la note de bas de page se réfère à un objet de rendu résultant
1463 d'un événement -- @code{Accidental} ou @code{Stem} découlent d'un
1464 @code{NoteHead} --, l'argument @var{nom-grob} de l'objet en question est
1465 requis après le texte de l'annotation, en lieu et place de
1469 @lilypond[quote,verbatim,papersize=a8landscape]
1471 \header { tagline = ##f }
1473 \footnote #'(-1 . -3) "Un bémol" Accidental
1475 \footnote #'(-1 . 0.5) "Un autre bémol" Accidental
1477 \footnote #'(1 . -2) "Une hampe" Stem
1483 Notez bien que, lorsque @var{nom-grob} est spécifié, tous les objets de
1484 ce type qui se trouvent à ce même instant se verront attacher une
1488 @lilypond[quote,verbatim,papersize=a8landscape]
1490 \header { tagline = ##f }
1492 \footnote #'(-1 . 3) "Un bémol" Accidental
1494 \footnote #'(2 . 0.5) "Une articulation" Script
1500 Une note incluse dans un accord peut individuellement se voir attribuer
1501 une annotation événementielle. Une tête de note (@code{NoteHead}) est
1502 le @emph{seul} objet directement généré par un constituant d'accord ;
1503 elle peut donc être affectée d'une annotation événementielle. Tous les
1504 autres objets constituant un accord sont générés indirectement. La
1505 commande @code{\footnote} ne dispose pas d'une syntaxe permettant de
1506 spécifier @emph{à la fois} un type d'objet @emph{et} un événement
1507 particulier auquel s'attacher. De tels objets pourront toutefois faire
1508 l'objet d'une annotation temporelle, préfixée d'un @code{\single} afin
1509 d'annoter l'événement directement consécutif :
1512 @lilypond[quote,verbatim,papersize=a8landscape]
1514 \header { tagline = ##f }
1516 < \footnote #'(1 . -2) "Un la" a
1517 \single \footnote #'(-1 . -1) "Un dièse" Accidental
1519 \single \footnote #'(0.5 . 0.5) "Un bémol" Accidental
1526 @warning{Lorsque plusieurs notes de bas de page se rapportent à un même
1527 empilement vertical comme ci-dessus, elles sont numérotées et
1528 apparaîtront selon l'ordre vertical des éléments présentés, autrement dit
1529 celui positionné le plus haut en premier, non dans leur ordre
1530 d'apparition dans le fichier source.}
1532 Les objets de rendu tels que changement de clef ou d'armure tirent leur
1533 origine dans la modification d'une propriété plutôt que d'un véritable
1534 événement. D'autres, comme les barres ou numéros de mesure, dépendent
1535 directement de la temporisation. C'est la raison pour laquelle de tels
1536 objets doivent s'annoter en fonction de leur survenance au fil de la
1537 musique. Les notes de bas de page temporelles sont la solution à
1538 privilégier lorsqu'il s'agit d'annoter les hampes ou ligatures affectant
1539 des accords : bien qu'une telle fonctionnalité puisse s'appliquer à l'un
1540 des événements constituant l'accord, rien ne laisse présager lequel
1541 serait le plus approprié.
1543 En matière de note de bas de page temporelle, l'objet de rendu considéré
1544 doit toujours être mentionné explicitement, ainsi que le contexte si
1545 l'objet est créé dans un autre contexte que celui du plus bas niveau.
1548 @lilypond[quote,verbatim,papersize=a8landscape]
1550 \header { tagline = ##f }
1553 \footnote #'(-0.5 . -1) "Changement de métrique" Staff.TimeSignature
1555 \footnote #'(1 . -1) "Hampe de l'accord" Stem
1557 \footnote #'(-0.5 . 1) "Barre de mesure" Staff.BarLine
1559 \footnote #'(0.5 . -1) "Changement d'armure" Staff.KeySignature
1566 Les appels de note peuvent être personnalisés, et le trait reliant
1567 l'objet à l'appel supprimé :
1570 @lilypond[quote,verbatim,papersize=a8landscape]
1572 \header { tagline = ##f }
1574 \footnote "*" #'(0.5 . -2) \markup { \italic "* La première note" }
1576 \footnote \markup { \super "$" } #'(0.5 . 1)
1577 \markup { \super "$" \italic " La deuxième note" }
1579 \once \override Score.FootnoteItem #'annotation-line = ##f
1580 b-\footnote \markup \tiny "+" #'(0.1 . 0.1)
1581 \markup { \super "+" \italic " Éditorial" } \p
1586 D'autres exemples de personnalisation des appels de note sont donnés à
1587 la rubrique @ref{Notes de bas de page dans du texte indépendant}.
1590 @node Notes de bas de page dans du texte indépendant
1591 @unnumberedsubsubsec Notes de bas de page dans du texte indépendant
1592 @translationof Footnotes in stand-alone text
1594 @cindex texte indépendant et note de bas de page
1596 De telles notes de bas de page affectent les @emph{markup} extérieurs
1597 aux expressions musicales. Il n'est pas nécessaire en pareil cas
1598 d'indiquer un point de référence par un trait ; l'appel de note vient
1599 juste s'accoler au @emph{markup} qui fait l'objet de l'annotation. Les
1600 appels de note peuvent être gérés automatiquement, auquel cas ils seront
1601 numériques, ou bien manuellement en fournissant un indicateur
1604 Les notes de bas de page concernant du texte indépendant se gèrent
1605 différemment selon qu'elles sont automatiques ou manuelles.
1608 @subsubsubheading Notes de bas de page automatiques dans du texte
1609 @c VO Footnotes in stand-alone text with automatic marks
1611 La syntaxe consacrée dans le cas d'une gestion automatique des appels
1615 \markup @{ ... \auto-footnote @var{texte} @var{annotation} ... @}
1618 Ses les éléments sont :
1623 le @emph{markup} ou la chaîne de caractères sur lequel porte
1627 un @emph{markup} ou une chaîne de caractères constituant le texte de
1628 l'annotation qui sera reportée en bas de page.
1634 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1636 \header { tagline = ##f }
1639 \auto-footnote "tune" \italic " By me"
1640 "is shown below. It is a"
1641 \auto-footnote "recent" \italic " Aug 2012"
1651 @subsubsubheading Notes de bas de page personnalisées dans du texte
1652 @c VO Footnotes in stand-alone text with custom marks
1654 La syntaxe consacrée dans le cas d'une gestion personnalisée des appels
1658 \markup @{ ... \footnote @var{appel} @var{annotation} ... @}
1661 Ses les éléments sont :
1666 un @emph{markup} ou une chaîne de caractères représentant l'appel de
1667 note affecté à ce point de référence. Notez bien que cette marque ne
1668 sera @strong{pas} reproduite automatiquement avant le texte proprement
1669 dit de l'annotation.
1672 un @emph{markup} ou une chaîne de caractères constituant le texte de
1673 l'annotation qui sera reportée en bas de page, précédé de l'@var{appel}.
1677 N'importe quel caractère simple tel que @code{*} ou @code{+} peut
1678 s'utiliser en tant qu'appel de note, comme nous l'avons vu à la rubrique
1679 @ref{Notes de bas de page dans une expression musicale}. D'autres
1680 caractères particuliers sont accessibles sous forme de raccourci -- voir
1681 la rubrique @ref{Équivalents ASCII} :
1683 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1685 \paper { #(include-special-characters) }
1686 \header { tagline = ##f }
1689 \footnote "*" \italic "* By me"
1690 "is shown below. It is a recent"
1691 \footnote \super † \concat {
1692 \super † \italic " Aug 2012"
1702 Un appel de note peut aussi se libeller sous la forme d'un point de code
1703 unicode -- voir la rubrique @ref{Unicode} :
1705 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1707 \header { tagline = ##f }
1710 \footnote \super \char##x00a7 \concat {
1711 \super \char##x00a7 \italic " By me"
1713 "is shown below. It is a recent"
1714 \footnote \super \char##x00b6 \concat {
1715 \super \char##x00b6 \italic " Aug 2012"
1726 Manuel d'initiation :
1727 @rlearning{Objets et interfaces}.
1729 Manuel de notation :
1730 @ref{Commentaires textuels},
1731 @ref{Équivalents ASCII},
1732 @ref{Indications textuelles},
1734 @ref{Liste des caractères spéciaux},
1737 Référence des propriétés internes :
1738 @rinternals{FootnoteEvent},
1739 @rinternals{FootnoteItem},
1740 @rinternals{FootnoteSpanner},
1741 @rinternals{Footnote_engraver}.
1744 Les notes de bas de page ne peuvent que s'empiler l'une au-dessus de
1745 l'autre ; elles ne seront jamais présentées à la queue leu leu.
1747 Silences multimesures, ligatures automatiques et paroles ne peuvent se
1748 voir affecter de note de bas de page.
1750 Les notes de bas de page peuvent générer des chevauchements quand elles
1751 sont trop nombreuses sur une même page.
1754 @node Référencement des numéros de page
1755 @subsection Référencement des numéros de page
1756 @translationof Reference to page numbers
1758 LilyPond vous permet, à l'aide de la commande @code{\label}, d'insérer
1759 des points de référence dans un ouvrage, aussi bien en dehors qu'au fil
1760 de la musique. Ce point de référence pourra être ensuite repris à
1761 l'intérieur d'un @emph{markup} ; vous pourrez même y ajouter le
1762 numéro de page grâce à la commande de @emph{markup} @code{\page-ref}.
1765 @lilypond[verbatim,papersize=a8landscape]
1766 \header { tagline = ##f }
1772 \pageBreak \mark A \label #'markA
1777 \markup { Le premier mouvement débute à la page \page-ref #'firstScore "0" "?" }
1778 \markup { Le repère A est à la page \page-ref #'markA "0" "?" }
1782 L'instruction @code{\page-ref} prend trois arguments :
1785 le point de référence, sous la forme d'un symbole Scheme, comme par
1786 exemple @code{#'firstScore},
1789 un @qq{emporte-pièce} afin d'estimer la longueur totale du
1793 un texte de remplacement au cas où la référence ne serait pas retrouvée.
1796 La présence de l'emporte-pièce est rendue nécessaire par le fait que les
1797 @emph{markups} sont générés avant que les sauts de page ne soient
1798 positionnés. Bien que le numéro de page en question ne soit pas encore
1799 déterminé, LilyPond doit connaître les dimensions de ce @emph{markup}.
1800 Vous pouvez, lorsque l'ouvrage contiendra plus de dix pages, stipuler un
1801 emporte-pièce sur deux caractères -- soit @code{"00"}.
1811 @node Table des matières
1812 @subsection Table des matières
1813 @translationof Table of contents
1815 La commande @code{\markuplist \table-of-contents} vous permettra de
1816 générer une table des matières. Les éléments qui la composeront sont
1817 créés par la commande @code{\tocItem}, insérée indépendamment ou au sein
1818 d'une expression musicale.
1821 \markuplist \table-of-contents
1824 \tocItem \markup "Premier mouvement"
1828 \tocItem \markup "Passage spécifique du premier mouvement"
1833 \tocItem \markup "Second mouvement"
1841 Les @emph{markups} dévolus à la mise en forme de la table des matières
1842 se définissent dans le bloc @code{\paper}. Il s'agit par défaut de
1843 @code{tocTitleMarkup} pour le titre de la table, et de
1844 @code{tocItemMarkup} pour ses éléments -- composés de leur libellé et
1845 numéro de page. Vous pouvez bien entendu personnaliser ces variables :
1849 %% Traduit le titre de la table des matières en français :
1850 tocTitleMarkup = \markup \huge \column {
1851 \fill-line { \null "Table des matières" \null }
1854 %% des fontes un peu plus grandes
1855 tocItemMarkup = \markup \large \fill-line {
1856 \fromproperty #'toc:text \fromproperty #'toc:page
1861 Notez bien la manière de référencer le libellé et le numéro de page dans
1862 la définition de @code{tocItemMarkup}.
1864 N'hésitez pas à définir vous-même d'autres commandes et @emph{markups}
1865 afin de construire une table plus élaborée :
1868 commencez par définir une nouvelle variable de type @code{markup} au
1869 sein du bloc @code{\paper},
1872 puis définissez une fonction musicale chargée d'insérer un élément de la
1873 table à partir de cette variable.
1876 Dans l'exemple qui suit, nous avons créé un nouveau style d'élément dans
1877 le but de mentionner les actes dans la table des matières d'un opéra :
1881 tocActMarkup = \markup \large \column {
1883 \fill-line { \null \italic \fromproperty #'toc:text \null }
1889 #(define-music-function (parser location text) (markup?)
1890 (add-toc-item! 'tocActMarkup text))
1893 @lilypond[line-width=10.0\cm]
1894 \header { tagline = ##f }
1896 tocActMarkup = \markup \large \column {
1898 \fill-line { \null \italic \fromproperty #'toc:text \null }
1904 #(define-music-function (parser location text) (markup?)
1905 (add-toc-item! 'tocActMarkup text))
1908 \markuplist \table-of-contents
1909 \tocAct \markup { Atto Primo }
1910 \tocItem \markup { Coro. Viva il nostro Alcide }
1911 \tocItem \markup { Cesare. Presti omai l'Egizzia terra }
1912 \tocAct \markup { Atto Secondo }
1913 \tocItem \markup { Sinfonia }
1914 \tocItem \markup { Cleopatra. V'adoro, pupille, saette d'Amore }
1919 L'élément et son numéro de page peuvent se rejoindre par une ligne
1922 @lilypond[verbatim,line-width=10.0\cm]
1923 \header { tagline = ##f }
1925 tocItemMarkup = \tocItemWithDotsMarkup
1929 \markuplist \table-of-contents
1930 \tocItem \markup { Allegro }
1931 \tocItem \markup { Largo }
1937 @funindex \table-of-contents
1938 @code{\table-of-contents},
1944 Fichiers d'initialisation :
1945 @file{../ly/toc-init.ly}.
1948 @node Travail sur des fichiers texte
1949 @section Travail sur des fichiers texte
1950 @translationof Working with input files
1953 * Insertion de fichiers LilyPond::
1954 * Différentes éditions à partir d'une même source::
1955 * Caractères spéciaux::
1959 @node Insertion de fichiers LilyPond
1960 @subsection Insertion de fichiers LilyPond
1961 @translationof Including LilyPond files
1964 @cindex inclusion de fichiers
1966 Lorsqu'un projet prend de l'importance en volume, il est judicieux de le
1967 scinder en plusieurs fichiers, auxquels vous ferez référence avec un
1971 \include "autrefichier.ly"
1974 Une ligne @code{\include "autrefichier.ly"} dans un fichier revient à
1975 recopier intégralement le contenu de @file{autrefichier.ly} à l'endroit
1976 même ou est placée l'instruction @code{\include}. Vous pouvez par
1977 exemple écrire un fichier individuel par instrument, puis les regrouper
1978 pour former le fichier @qq{conducteur}. Les différentes variables
1979 définies dans les fichiers séparés seront normalement reprises et
1980 utilisables dans le fichier formant le conducteur. Les sections
1981 balisées dans les fichiers individuels peuvent être réutilisées en
1982 différents endroit de la partition, comme expliqué à la rubrique
1983 @ref{Différentes éditions à partir d'une même source}.
1985 Lorsque le fichier auquel il est fait référence se trouve dans le même
1986 répertoire, donner seulement son nom en argument à la commande
1987 @code{\include} suffit. S'il se trouve ailleurs, vous devrez indiquer
1988 le chemin d'accès, absolu ou relatif, en respectant toutefois la syntaxe
1989 UNIX -- autrement dit, le séparateur de répertoire est une oblique
1990 normale @code{/} et non l'oblique inverse @code{\} de DOS ou Windows.
1991 Par exemple, si le fichier @file{truc.ly} se trouve dans le répertoire
1992 supérieur au répertoire de travail, la ligne devra être
1995 \include "../truc.ly"
1999 ou bien, si les fichiers correspondant aux parties d'orchestre se
2000 trouvent dans le sous-répertoire @file{parties} relativement au
2001 répertoire courant, vous devrez mentionner
2004 \include "parties/VI.ly"
2005 \include "parties/VII.ly"
2009 Les fichiers à inclure peuvent eux-mêmes contenir des instructions
2010 @code{\include}. Ces instructions @code{\include} de second niveau ne
2011 pourront, par défaut, être interprétées qu'une fois intégrées dans le
2012 fichier principal ; leur argument doit donc comporter le chemin
2013 relativement au fichier principal et non par rapport au fichier dans
2014 lequel cette inclusion est mentionnée. Vous pouvez toutefois influer
2015 sur ce comportement de manière globale à l'aide de l'option
2016 @w{@code{-drelative-includes}} en ligne de commande ou en ajoutant une
2017 clause @code{#(ly:set-option 'relative-includes #t)} en tête du fichier
2020 Lorsque @code{relative-include} est valorisé à @code{#t}, le chemin à
2021 suivre pour chacune des commandes @code{\include} sera pris relativement
2022 au fichier qui la contient. Cette option est vouée à être activée par
2023 défaut dans une future version de LilyPond.
2025 Selon l'endroit où @code{relative-includes} est valorisé à @code{#t} ou
2026 @code{#f}, la commande @code{\include} permettra d'incorporer des
2027 fichiers contenus dans l'arborescence du répertoire principal et des
2028 fichiers situés ailleurs. Si, par exemple, une biblothèque générale
2029 libA a été créée pour utiliser des sous-fichiers à l'aide
2030 d'inclusions dans un fichier catalogue, les clauses @code{\include}
2031 devront être précédées d'un
2032 @code{#(ly:set-option #relative-includes #t)} de telle sorte
2033 qu'elles soient interprétées correctement lorsque rapatriées dans
2034 le fichier @file{.ly} principal. Examinons cela dans les faits :
2045 puis le fichier catalogue, @code{libA.ly}, qui contient
2048 #(ly:set-option 'relative-includes #t)
2052 % retour au réglage par défaut
2053 #(ly:set-option 'relative-includes #f)
2056 Tout fichier @code{.ly} peut désormais consulter l'intégralité de cette
2057 bibliothèque grâce à un simple
2060 \include "~/libA/libA.ly"
2063 Un positionnement judicieux des commutateurs permet de gérer des
2064 structures de fichiers plus complexes.
2066 Vous pouvez inclure des fichiers dont vous spécifierez le chemin d'accès
2067 sur la ligne de commande au moment de lancer la compilation. L'appel à
2068 ces fichiers ne mentionnera alors que leur nom. Par exemple, si vous
2069 voulez compiler avec cette méthode le fichier @file{principal.ly} qui
2070 inclut des fichiers situés dans le sous-répertoire @file{parties},
2071 placez vous dans le répertoire contenant @file{principal.ly}, puis tapez
2074 lilypond --include=parties principal.ly
2077 tout en ayant bien dans @file{principal.ly}
2085 Lorsqu'un fichier est voué à être inclus dans nombre de partitions, vous
2086 pouvez le placer dans le répertoire de LilyPond @file{../ly}.
2087 Attention : ce répertoire varie selon votre installation, comme
2088 indiqué au chapitre @rlearning{Autres sources de documentation}. Ce
2089 fichier sera inclus dès lors que vous fournirez uniquement son nom en
2090 argument à la fonction @code{\include}. C'est par exemple le cas du
2091 fichier de définition particulier @file{gregorian.ly}.
2093 Au moment où vous lancez LilyPond, un certain nombre de fichiers se
2094 retrouvent inclus par défaut ; il suffit d'activer le mode verbeux
2095 en faisant @w{@code{lilypond --verbose}} pour s'en rendre compte. Vous
2096 verrez ainsi défiler, en plus de nombreuses informations, le nom d'un
2097 certain nombre de fichiers et de chemins d'accès. Les fichiers les plus
2098 important sont mentionnés au chapitre
2099 @rlearning{Autres sources de documentation}. Si vous venez à les
2100 modifier, rappelez-vous qu'ils seront écrasés à l'installation d'une
2101 nouvelle version de LilyPond.
2103 Vous trouverez quelques exemples simples d'utilisation de la commande
2104 @code{\include} au chapitre @rlearning{Conducteurs et parties}.
2107 Manuel d'initiation :
2108 @rlearning{Autres sources de documentation},
2109 @rlearning{Conducteurs et parties}.
2112 Lorsque vous incluez un fichier qui porte le même nom que l'un des
2113 fichiers d'initialisation de LilyPond, le fichier de la distribution de
2114 LilyPond aura préséance.
2117 @node Différentes éditions à partir d'une même source
2118 @subsection Différentes éditions à partir d'une même source
2119 @translationof Different editions from one source
2121 Plusieurs méthodes permettent de générer différentes versions d'une
2122 partition à partir d'une même source. Les variables -- ou
2123 identificateurs -- sont sûrement le moyen le plus simple de combiner de
2124 différente manière des passages relativement longs, alors que les
2125 balises permettront de sélectionner de courts fragments selon leur
2128 Quelle que soit la méthode utilisée, séparer la notation de la structure
2129 de la partition vous donnera plus de liberté dans l'agencement de
2130 l'ouvrage final, puisque vous ne reviendrez pas sur la musique qui le
2134 * Utilisation de variables::
2135 * Utilisation de balises::
2136 * Globalisation des réglages::
2140 @node Utilisation de variables
2141 @unnumberedsubsubsec Utilisation de variables
2142 @translationof Using variables
2144 @cindex variables, utilisation de
2146 Un fragment musical identifié par une variable est réutilisable à divers
2147 endroits de la partition, comme nous l'avons vu à la rubrique
2148 @rlearning{Organisation du code source avec des variables}. Par
2149 exemple, une partition pour chœur @notation{a cappella} comporte souvent
2150 une réduction pour piano reprenant toutes les voix ; il s'agit de
2151 la même musique, et vous ne devrez donc la saisir qu'une seule fois.
2152 D'autre part, la musique issue de deux variables peut se combiner sur
2153 une seule portée, comme nous l'avons vu à la rubrique
2154 @ref{Regroupement automatique de parties}. Prenons l'exemple suivant :
2156 @lilypond[verbatim,quote]
2157 sopranoMusic = \relative c'' { a4 b c b8( a) }
2158 altoMusic = \relative g' { e4 e e f }
2159 tenorMusic = \relative c' { c4 b e d8( c) }
2160 bassMusic = \relative c' { a4 gis a d, }
2161 allLyrics = \lyricmode {King of glo -- ry }
2163 \new Staff = "Soprano" \sopranoMusic
2164 \new Lyrics \allLyrics
2165 \new Staff = "Alto" \altoMusic
2166 \new Lyrics \allLyrics
2167 \new Staff = "Tenor" {
2171 \new Lyrics \allLyrics
2172 \new Staff = "Bass" {
2176 \new Lyrics \allLyrics
2179 \set Staff.printPartCombineTexts = ##f
2185 \set Staff.printPartCombineTexts = ##f
2195 Générer une partition chorale ou la réduction pour piano ne requiert que
2196 de modifier la structure des éléments, sans aucunement toucher à la
2199 Dans le cas d'une partition relativement longue, vous pouvez isoler la
2200 définition des différentes variables dans des fichiers séparés que vous
2201 rappellerez ensuite, comme indiqué à la rubrique
2202 @ref{Insertion de fichiers LilyPond}.
2205 @node Utilisation de balises
2206 @unnumberedsubsubsec Utilisation de balises
2207 @translationof Using tags
2210 @funindex \keepWithTag
2211 @funindex \removeWithTag
2212 @funindex \pushToTag
2213 @funindex \appendToTag
2217 La commande @code{\tag #'@var{partieA}} affecte à une expression
2218 musicale le nom @var{partieA}. Les expressions ainsi balisées pourront
2219 être filtrées par la suite, à l'aide de @code{\keepWithTag #'@var{nom}}
2220 ou @code{\removeWithTag #'@var{nom}}. Ces filtres fonctionnent de la
2223 @multitable @columnfractions .5 .5
2228 Musique balisée précédée de @code{\keepWithTag #'@var{nom}} ou
2229 @code{\keepWithTag #'(@var{nom1} @var{nom2}@dots{})}
2230 @tab Musique non balisée et musique balisée par l'un des noms de
2231 balise fournis seront incluses ; la musique balisée
2232 autrement est exclue.
2235 Musique balisée précédée de @code{\removeWithTag #'@var{nom}} ou
2236 @code{\removeWithTag #'(@var{nom1} @var{nom2}@dots{})}
2237 @tab Musique non balisée et fragments appelés autrement que par
2238 l'un des noms fournis seront inclus ; la musique balisée
2239 par autre chose que les noms mentionnés est exclue.
2242 Musique balisée non précédée de @code{\keepWithTag} ou
2243 @code{\removeWithTag}
2244 @tab Musique balisée et non balisée seront incluses.
2248 Les arguments des commandes @code{\tag}, @code{\keepWithTag} et
2249 @code{\removeWithTag} doivent être un symbole (tel que
2250 @code{#'conducteur} ou @code{#'partie}), suivi d'une expression
2253 Dans l'exemple qui suit, nous obtenons deux versions du même extrait,
2254 l'une pour le conducteur, l'autre pour l'instrumentiste qui, elle,
2255 comportera les ornements développés.
2257 @lilypond[verbatim,quote]
2258 music = \relative g' {
2260 \tag #'trills { d8.\trill }
2261 \tag #'expand { \repeat unfold 3 { e32 d } }
2266 \keepWithTag #'trills \music
2269 \keepWithTag #'expand \music
2274 Il est parfois plus aisé d'exclure des fragments :
2276 @lilypond[verbatim,quote]
2277 music = \relative g' {
2279 \tag #'trills { d8.\trill }
2280 \tag #'expand {\repeat unfold 3 { e32 d } }
2285 \removeWithTag #'expand
2289 \removeWithTag #'trills
2294 Ce principe de filtrage peut s'appliquer aux articulations, textes, etc.
2295 Il suffit de positionner
2298 -\tag #@var{ma-balise}
2302 avant l'articulation ou le texte, comme ici :
2306 c1-\tag #'gaffe ^"Attention !"
2310 Ceci définira une note avec une indication conditionnelle de doigté ou
2313 Vous pouvez baliser différemment la même expression musicale en
2314 saisissant plusieurs @code{\tag} ou bien en combinant plusieurs
2315 balises dans une liste :
2317 @lilypond[quote,verbatim]
2318 music = \relative c'' {
2319 \tag #'a \tag #'both { a4 a a a }
2320 \tag #'(b both) { b4 b b b }
2323 \keepWithTag #'a \music
2324 \keepWithTag #'b \music
2325 \keepWithTag #'both \music
2329 L'application concomitante de plusieurs filtres @code{\removeWithTag} à
2330 la même expression musicale permet d'exclure plusieurs balisages.
2331 Une liste fournie en argument à un unique @code{\removeWithTag}
2332 produira le même effet :
2334 @lilypond[verbatim,quote]
2335 music = \relative c'' {
2336 \tag #'A { a4 a a a }
2337 \tag #'B { b4 b b b }
2338 \tag #'C { c4 c c c }
2339 \tag #'D { d4 d d d }
2345 \removeWithTag #'(B C)
2350 L'application de plus d'un filtre @code{\keepWithTag} à la même
2351 expression musicale aboutit à l'exclusion de @b{tous} les balisages.
2352 En effet, si le premier filtre exclut tous les autres balisages,
2353 l'application du second exclura les effets du premier.
2354 L'utilisation d'une unique commande @code{\keepWithTag} avec une
2355 liste de balises est en pareil cas des plus pertinente : seront
2356 exclus tous les fragments non concernés par l'une quelconque des
2357 balises mentionnées.
2359 Il peut arriver que vous ayez besoin de raccorder quelque chose en un
2360 point particulier d'une expression musicale. Les commandes
2361 @code{\pushToTag} et @code{\appendToTag} permettent d'insérer du
2362 matériau, qu'il soit antérieur ou postérieur, à des @code{éléments}
2363 d'une construction musicale existante. La musique séquentielle ou
2364 simultanée comporte assurément des @code{éléments} :
2366 @lilypond[verbatim,quote]
2367 test = { \tag #'here { \tag #'here <<c''>> } }
2370 \pushToTag #'here c'
2371 \pushToTag #'here e'
2372 \pushToTag #'here g' \test
2373 \appendToTag #'here c'
2374 \appendToTag #'here e'
2375 \appendToTag #'here g' \test
2379 Ces deux instructions sont affectées d'une balise, le matériau à
2380 raccorder à chaque instance de la balise, et l'expression balisée.
2381 Ces instructions prennent soin de recopier tout ce qui doit être
2382 modifié, de telle sorte que l'expression @code{\test} originale conserve
2386 Manuel d'initiation :
2387 @rlearning{Organisation du code source avec des variables}.
2389 Manuel de notation :
2390 @ref{Regroupement automatique de parties},
2391 @ref{Insertion de fichiers LilyPond}.
2394 L'application d'un @code{\relative} à une expression musicale
2395 obtenue par filtrage à l'aide de @code{\keepWithTag} ou
2396 @code{\removeWithTag} peut générer des changements d'octave,
2397 puisque seules les hauteurs récupérées dans ce filtre seront
2398 prises en considération. Une instruction @code{\relative} qui
2399 précède les commandes @code{\keepWithTag} ou
2400 @code{\removeWithTag} permet d'éviter ce risque, dans la mesure où
2401 elle viendra « recaler » ces hauteurs récupérées.
2404 @node Globalisation des réglages
2405 @unnumberedsubsubsec Globalisation des réglages
2406 @translationof Using global settings
2408 @cindex include-settings
2410 Vous pouvez regrouper dans un fichier indépendant vos réglages
2411 personnels que vous inclurez au besoin :
2414 lilypond -dinclude-settings=MES_REGLAGES.ly MA_PARTITION.ly
2417 Vous pouvez ainsi stocker dans un fichier séparé vos réglages en matière
2418 de format de papier, de fontes utilisées ou vos définitions
2419 particulières. Selon le fichier de réglages que vous mentionnerez, vous
2420 obtiendrez facilement différentes éditions à partir d'une même source
2421 quelle qu'elle soit.
2423 Cette technique peut s'utiliser en combinaison avec des feuilles de
2424 styles, comme indiqué au chapitre @rlearning{Feuilles de style}.
2427 Manuel d'initiation :
2428 @rlearning{Organisation du code source avec des variables},
2429 @rlearning{Feuilles de style}.
2431 Manuel de notation :
2432 @ref{Insertion de fichiers LilyPond}.
2435 @node Caractères spéciaux
2436 @subsection Caractères spéciaux
2437 @translationof Special characters
2439 @cindex caractères spéciaux
2440 @cindex non-ASCII, caractères
2445 * Équivalents ASCII::
2449 @node Codage du texte
2450 @unnumberedsubsubsec Codage du texte
2451 @translationof Text encoding
2455 LilyPond utilise le jeu de caractères défini par le consortium Unicode
2456 et la norme ISO/CEI 10646. Chaque caractère est identifié par un
2457 nom unique et associé à un point de code, ce qui permet dans l'absolu de
2458 couvrir tous les langages. Unicode permet de coder tous les caractères
2459 utilisés par toutes les langues écrites du monde. LilyPond utilise le
2460 codage UTF-8 (UTF pour @emph{Unicode Transformation Format}) qui permet
2461 de représenter les caractères latins sur un octet et les autres sur une
2462 longueur allant jusqu'à quatre octets.
2464 L'apparence réelle des caractères est déterminée par les glyphes ou
2465 graphèmes tels que définis dans les différentes polices disponibles.
2466 Une police, ou une fonte, définit la mise en correspondance d'un
2467 sous-ensemble de points de code unicode en glyphes. LilyPond recourt à
2468 la bibliothèque Pango pour assurer le rendu des textes multilingues.
2470 LilyPond n'effectue aucune conversion d'encodage que ce soit. Ceci
2471 implique donc que tout texte -- un titre, des paroles ou même une
2472 instruction musicale -- comportant des caractères non ASCII soit
2473 codé en UTF-8. Le plus sûr moyen de saisir du texte de la sorte
2474 consiste à utiliser un éditeur supportant l'unicode et à enregistrer vos
2475 fichier en UTF-8. C'est le cas pour la plupart des éditeurs actuels,
2476 que ce soit vim, Emacs, jEdit et GEdit. Tous les systèmes Windows
2477 postérieurs à NT utilisent Unicode en natif ; même Notepad est
2478 capable d'éditer et sauvegarder un fichier en UTF-8 -- sans parler de
2479 l'excellente alternative qu'est BabelPad.
2481 La compilation d'un fichier LilyPond comportant des caractères non ASCII
2482 qui n'aurait pas été enregistré dans l'encodage UTF-8 vous renverra
2486 FT_Get_Glyph_Name () erreur : invalid argument
2489 Voici un exemple utilisant du texte en cyrillique, en hébreux et en
2493 %c No verbatim here as the code does not display correctly in PDF
2495 bulgarian = \lyricmode {
2496 Жълтата дюля беше щастлива, че пухът, който цъфна, замръзна като гьон.
2500 hebrew = \lyricmode {
2501 זה כיף סתם לשמוע איך תנצח קרפד עץ טוב בגן.
2505 portuguese = \lyricmode {
2506 à vo -- cê uma can -- ção legal
2512 \addlyrics { \bulgarian }
2513 \addlyrics { \hebrew }
2514 \addlyrics { \portuguese }
2519 @unnumberedsubsubsec Unicode
2520 @translationof Unicode
2524 Lorsque vous avez besoin d'un caractère dont vous connaissez le point de
2525 code mais que votre éditeur ne permet pas de saisir directement, vous
2526 pouvez utiliser les instructions @code{\char ##xhhhh} ou
2527 @code{\char #dddd} au sein d'un bloc @code{\markup} -- @code{hhhh}
2528 et @code{dddd} correspondant respectivement à la valeur hexadécimale ou
2529 décimale. Même s'il est inutile de saisir les zéros superflus, il est
2530 de bon ton de stipuler les quatre caractères formant la représentation
2531 hexadécimale. Évitez cependant l'encodage UTF-8 d'un point de code
2532 après un @code{\char} ; les encodages UTF-8 comprennent un bit
2533 supplémentaire indiquant le nombre d'octets. Une table de
2534 correspondance entre les codes Unicode et le nom des caractères ainsi
2535 que leur code hexadécimal est disponible sur le site du consortium
2536 Unicode, @uref{http://www.unicode.org/}.
2538 Par exemple, @code{\char ##x03BE} et @code{\char #958} correspondent
2539 tous deux au caractère unicode U+03BE, dénommé @qq{Greek Small Letter
2542 Quel que soit le point de code spécifié de cette manière, il ne vous
2543 sera alors pas nécessaire d'enregistrer votre fichier en UTF-8. Vous
2544 devrez toutefois disposer d'une fonte contenant ce caractère qui soit
2545 accessible à LilyPond.
2547 L'exemple suivant illustre la manière d'insérer un caractère sous sa
2548 forme hexadécimale, à la fois dans un repère, dans une articulation,
2549 dans des paroles et dans du texte indépendant.
2551 @lilypond[quote,verbatim]
2554 c1 \mark \markup { \char ##x03EE }
2555 c1_\markup { \tiny { \char ##x03B1 " to " \char ##x03C9 } }
2557 \addlyrics { O \markup { \concat { Ph \char ##x0153 be! } } }
2559 \markup { "Copyright 2008--2012" \char ##x00A9 }
2564 Le signe @emph{copyright} dans le champ de titrage consacré s'inscrit de
2565 la manière suivante :
2569 copyright = \markup @{ \char ##x00A9 "2008" @}
2574 @node Équivalents ASCII
2575 @unnumberedsubsubsec Équivalents ASCII
2576 @translationof ASCII aliases
2578 Dès lors que vous aurez inclus la liste de leur équivalent ASCII,
2579 LilyPond reconnaîtra un certain nombre de caractères spéciaux :
2581 @lilypond[quote,verbatim]
2583 #(include-special-characters)
2586 \markup "&flqq; – &OE;uvre incomplète… &frqq;"
2589 \new Staff { \repeat unfold 9 a'4 }
2591 This is al -- so wor -- kin'~in ly -- rics: –_&OE;…
2596 "The replacement can be disabled:"
2597 "– &OE; …"
2598 \override #'(replacement-alist . ()) "– &OE; …"
2602 L'extension de cette liste est possible aussi bien de manière globale :
2604 @lilypond[quote,verbatim]
2606 #(add-text-replacements!
2607 '(("100" . "hundred")
2608 ("dpi" . "dots per inch")))
2610 \markup "A 100 dpi."
2613 qu'en un point particulier de votre source :
2615 @lilypond[quote,verbatim]
2616 \markup \replace #'(("100" . "hundred")
2617 ("dpi" . "dots per inch")) "A 100 dpi."
2621 Manuel de notation :
2622 @ref{Liste des caractères spéciaux}.
2624 Fichiers d'initialisation :
2625 @file{ly/text-replacements.ly}.
2628 @node Contrôle des sorties
2629 @section Contrôle des sorties
2630 @translationof Controlling output
2633 * Extraction de fragments musicaux::
2634 * Ignorer des passages de la partition::
2635 * Formats de sortie alternatifs::
2636 * Changement des fontes musicales::
2640 @node Extraction de fragments musicaux
2641 @subsection Extraction de fragments musicaux
2642 @translationof Extracting fragments of music
2644 LilyPond permet d'extraire des fragments d'une partition à l'instar du
2645 choriste amateur qui alimente son album avec des coupures de journaux.
2647 Vous devrez pour cela définir les mesures à découper. La définition
2648 suivante, incluse dans votre fichier source,
2655 (make-rhythmic-location 5 1 2)
2656 (make-rhythmic-location 7 3 4)))
2661 vous permettra d'extraire un fragment compris entre le milieu de la
2662 cinquième mesure et quelque part dans la septième. Le triplet
2663 @code{5 1 2} signifie : après la durée d'une blanche dans la mesure 5 ;
2664 le @code{7 3 4} signifie quant à lui que l'on s'arrête à la mesure 7,
2665 après la durée de trois noires.
2667 Rien ne vous empêche d'extraire plusieurs fragments, dès lors que vous
2668 définissez dans la liste d'autres paires d'emplacements rythmiques.
2670 Cette fonctionnalité n'est toutefois effective que lorsque vous lancez
2671 LilyPond avec l'option @w{@code{-dclip-systems}}. Les @qq{coupures}
2672 seront générées sous la forme de fichiers EPS, convertis en PDF ou PNG
2673 selon le format que vous aurez stipulé.
2675 Pour de plus amples informations quant au format des résultats,
2676 consultez le chapitre @rprogram{Lancement de lilypond}.
2679 @node Ignorer des passages de la partition
2680 @subsection Ignorer des passages de la partition
2681 @translationof Skipping corrected music
2683 @funindex skipTypesetting
2684 @funindex showFirstLength
2685 @funindex showLastLength
2687 Dans un travail de transcription ou de recopie de la musique, ce qui
2688 vous intéresse plus particulièrement se situe à la fin, là même où vous
2689 en êtes dans la notation. Dans le but de gagner du temps dans le
2690 processus de correction, vous pouvez @qq{escamoter} le reste et ne
2691 générer que les dernières mesures en insérant
2694 showLastLength = R1*5
2699 dans votre fichier source. Ceci aura pour effet de ne générer que les
2700 cinq dernières mesures -- si tant est que le morceau soit à 4/4 -- de
2701 tous les @code{\score} de votre fichier. Dans le cas d'un œuvre
2702 conséquente, cette pratique s'avère fort utile puisqu'elle évite de tout
2703 générer. Vous pourriez aussi être amené à retravailler le début d'une
2704 œuvre, pour y ajouter une partie par exemple, auquel cas c'est la
2705 propriété @code{showFirstLength} que vous utiliserez.
2707 Vous pouvez contrôler très finement les parties à escamoter, grâce au
2708 commutateur @code{Score.skipTypesetting} : lorsqu'il est activé,
2709 aucune gravure n'est réalisée.
2711 Ce commutateur agit aussi sur la sortie MIDI. Notez bien que tous les
2712 événements seront escamotés, y compris les changements de tempo ou
2713 d'instrument -- vous voilà prévenu !
2715 @lilypond[quote,relative=2,ragged-right,verbatim]
2717 \set Score.skipTypesetting = ##t
2719 \set Score.skipTypesetting = ##f
2723 Dans le cadre de musique polyphonique, @code{Score.skipTypesetting}
2724 s'applique à toutes les voix et portées. Vous gagnerez donc encore plus
2728 @node Formats de sortie alternatifs
2729 @subsection Formats de sortie alternatifs
2730 @translationof Alternative output formats
2732 @cindex scalable vector graphics
2733 @cindex SVG, format de sortie
2734 @cindex encapsulated postscript
2735 @cindex EPS, format de sortie
2737 En matière de partition imprimable, LilyPond génère par défaut des
2738 documents au format PostScript (PS) et Portable Document Format (PDF).
2739 Vous pouvez aussi obtenir des documents au format Scalable Vector
2740 Graphics (SVG), Encapsulated PostScript (EPS) ou Portable Network
2741 Graphics (PNG) dès lors que vous aurez lancé LilyPond en ligne de
2742 commande avec l'option @i{ad hoc} -- voir
2743 @rprogram{Utilisation en ligne de commande} à ce sujet.
2746 @node Changement des fontes musicales
2747 @subsection Changement des fontes musicales
2748 @translationof Replacing the notation font
2750 Gonville est une alternative à la fonte Feta que LilyPond utilise par
2751 défaut. Vous pouvez la télécharger à partir de
2753 @uref{http://www.chiark.greenend.org.uk/~sgtatham/gonville/ ,http://www.chiark.greenend.org.uk/~sgtatham/gonville/}
2756 Voici quelques mesures utilisant la police Gonville :
2758 @c NOTE: these images are a bit big, but that's important
2759 @c for the font comparison. -gp
2760 @sourceimage{Gonville_after,,,}
2762 Et ces même mesures avec la police de LilyPond, Feta :
2764 @sourceimage{Gonville_before,,,}
2767 @subsubheading Instructions d'installation pour MacOS
2768 @translationof Installation Instructions for MacOS
2770 Téléchargez puis décompressez l'archive zip. Recopiez le répertoire
2771 @code{lilyfonts} dans @file{@var{SHARE_DIR}/lilypond/current} -- voir
2772 @rlearning{Autres sources de documentation} à ce sujet. Renommez le
2773 répertoire @code{fonts} qui s'y trouve en @code{fonts_orig}, puis le
2774 répertoire @code{lilyfonts} en @code{fonts}. Il vous suffira, pour
2775 retrouver la fonte Feta, de renommer @code{fonts_orig} en @code{fonts}.
2778 Manuel d'initiation :
2779 @rlearning{Autres sources de documentation}.
2782 Gonville ne permet pas de générer de la notation ancienne, et certains
2783 glyphes ajoutés depuis lors aux jeux de caractères en soient absent.
2784 Consultez le site de l'auteur pour de plus amples informations ainsi
2785 qu'à propos des conditions d'utilisation.
2789 @section Sortie MIDI
2790 @translationof MIDI output
2795 MIDI (Musical Instrument Digital Interface) constitue un standard en
2796 matière de connexion et de contrôle des instruments électroniques. Un
2797 fichier MIDI contient une série de notes réparties dans différentes
2798 pistes. Il ne s'agit en rien d'un fichier sonore ; il vous faudra
2799 un logiciel capable de traduire ces séries de notes en sons réels.
2801 Vous pouvez convertir vos partition en fichier MIDI de manière à
2802 entendre ce que vous avez saisi. Ceci vous permet de contrôler aisément
2803 ce que vous avez saisi : octaves et altérations erronées heurteront
2804 votre oreille avertie grâce au MIDI.
2806 Le fichier MIDI généré par LilyPond est relativement brut. Vous pouvez
2807 cependant obtenir un meilleur rendu avec @ref{Le script Articulate}.
2809 Dans une sortie MIDI, LilyPond alloue un canal à chaque portée, tout en
2810 réservant le canal 10 aux percussions. Dans la mesure ou un
2811 périphérique MIDI ne comprend que 16 canaux, un fichier MIDI qui
2812 comportera plus de quinze portées verra le même canal réutilisé.
2815 * Création de fichiers MIDI::
2818 * Contenu de la sortie MIDI::
2819 * Répétitions et MIDI::
2820 * Gestion des nuances en MIDI::
2821 * MIDI et percussions::
2822 * Le script Articulate::
2826 @node Création de fichiers MIDI
2827 @subsection Création de fichiers MIDI
2828 @translationof Creating MIDI files
2830 LilyPond générera un fichier MIDI dès que vous ajouterez un bloc
2831 @code{\midi} à la structure de votre partition, comme ici :
2840 Lorsque le bloc @code{\score} contient un bloc @code{\midi} mais pas de
2841 bloc @code{\layout}, LilyPond ne produira qu'une sortie MIDI. Si donc
2842 vous avez besoin aussi d'un support visuel, vous devrez aussi mentionner
2843 un bloc @code{\layout}.
2853 Hauteurs, durées, liaisons de prolongation, nuances et changements de
2854 tempo seront interprétés et traduits en événements MIDI. Les
2855 indications de nuances, crescendos et decrescendos sont traduits en
2856 niveau de volume ; les indications sous la forme d'une fraction
2857 déterminée du volume disponible, et crescendos et decrescendos sous la
2858 forme d'une progression linéaire entre les deux extrêmes. Le rendu des
2859 indications de nuance peut être désactivé pour le MIDI -- voir
2862 Le tempo initial ainsi que ses changements sont normalement indiqués au
2863 fil de la notation à l'aide de la commande @code{\tempo} ; ils seront
2864 retranscrits dans le fichier MIDI. La commande @code{\tempo} donne lieu
2865 à l'impression d'une indication métronomique que vous pouvez toutefois
2866 rendre invisible, comme indiqué à la rubrique
2867 @ref{Indication métronomique}. Une autre manière de spécifier le tempo
2868 initial pour un fichier MIDI est indiquée plus avant -- voir
2871 En raison de certaines limitations de Windows, les fichiers MIDI doivent
2872 y porter l'extension @code{.mid}. D'autres systèmes utilisent
2873 l'extension @code{.midi}. Si besoin est, placez la ligne suivante au
2874 début de votre fichier source, avant l'ouverture de tout bloc
2875 @code{\book}, @code{\bookpart} ou @code{\score} :
2878 #(ly:set-option 'midi-extension "midi")
2881 Cette ligne déterminera @code{.midi} comme extension par défaut pour les
2884 Vous pouvez aussi le faire en ligne de commande :
2887 lilypond … -dmidi-extension=midi fichierLily.ly
2891 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
2892 {changing-midi-output-to-one-channel-per-voice.ly}
2895 @c In 2.11 the following no longer seems to be a problem -td
2897 Un (de)crescendo non terminé ne sera pas correctement rendu en MIDI --
2898 il y a nécessairement du silence. Il vous faut donc lui donner une fin
2899 explicite. Par exemple,
2906 ne fonctionnera pas correctement, contrairement à
2909 @{ a4\< b c d\!\f @}
2913 Un changement de volume ne peut intervenir que sur le démarrage d'une
2914 note. C'est la raison pour laquelle la succession d'un crescendo et
2915 d'un diminuendo ne peut se produire sur une même note.
2917 Certains lecteurs MIDI ne rendent pas correctement les changements de
2918 tempo. MS Windows Media Player et
2919 @uref{http://@/timidity@/.sourceforge@/.net/,timidity} le font sans
2922 @node Instrument MIDI
2923 @subsection Instrument MIDI
2924 @translationof MIDI Instruments
2926 @cindex instrument, nom d'
2927 @cindex MIDI, instruments
2928 @funindex Staff.midiInstrument
2930 L'instrument MIDI affecté à un canal particulier est déterminé par la
2931 propriété @code{Staff.midiInstrument}. Vous pouvez choisir l'un des
2932 instruments répertoriés à l'annexe @ref{Instruments MIDI}.
2936 \set Staff.midiInstrument = #"glockenspiel"
2942 \new Staff \with @{midiInstrument = #"cello"@} @{
2947 Lorsque l'instrument choisi ne correspond pas exactement à l'une des
2948 dénominations consacrées, LilyPond le replacera par un piano de concert
2949 (@code{"acoustic grand"}).
2953 @subsection Le bloc MIDI
2954 @translationof MIDI block
2956 Dès lors que vous désirez obtenir une sortie MIDI, vous devrez inscrire
2957 un bloc @code{\midi} au sein du bloc @code{\score}. Son fonctionnement
2958 est comparable à ce lui du bloc @code{\layout}, voire plus simple. Si
2959 le bloc @code{\midi} est la plupart du temps laissé vide, il peut
2960 contenir des aménagements pour certains contextes, la définition de
2961 contextes particuliers ou du code permettant de déterminer la valeur de
2962 certaines propriétés. L'exemple suivant détermine le tempo initial du
2963 fichier MIDI tout en se passant de son indication sur la partition
2975 Ici, le tempo est fixé à 72 noires à la minute. Spécifier un tempo de
2976 la sorte ne permet pas de donner une valeur pour une note pointée. Vous
2977 devrez, en pareil cas, subdiviser la note pointée en durée plus courte.
2978 Par exemple, indiquer 90 à la noire pointée est équivalent à spécifier
2979 270 croches à la minute :
2982 tempoWholesPerMinute = #(ly:make-moment 270/8)
2985 @cindex MIDI et définition de contexte
2986 @cindex contexte, définition en MIDI
2988 La syntaxe permettant de définir un contexte pour le @code{\midi} est en
2989 tout point identique à celle que vous utilisez dans le bloc
2990 @code{\layout}, à ceci près que le @qq{graveur} est remplacé par un
2991 @qq{interprète}. Les différents contextes disponibles en matière de
2992 MIDI sont répertoriés dans le fichier d'initialisation
2993 @file{../ly/performer-init.ly} -- pour plus de détail, voir
2994 @rlearning{Autres sources de documentation}.
2995 Si vous voulez vous passer des nuances dans votre fichier MIDI, il vous
2996 suffit d'insérer les lignes suivantes dans votre bloc
3004 \remove "Dynamic_performer"
3009 LilyPond ne générera de sortie MIDI que si vous incluez un bloc
3010 @code{\midi} dans la structure de la partition, initialisée par la
3011 commande @code{\score}.
3015 @{ @dots{}notes@dots{} @}
3021 @node Contenu de la sortie MIDI
3022 @subsection Contenu de la sortie MIDI
3023 @translationof What goes into the MIDI output?
3025 @c TODO Check grace notes - timing is suspect?
3028 * Éléments pris en compte dans le MIDI::
3029 * Éléments non pris en compte dans le MIDI::
3033 @node Éléments pris en compte dans le MIDI
3034 @unnumberedsubsubsec Éléments pris en compte dans le MIDI
3035 @translationof Supported in MIDI
3037 @cindex hauteurs en MIDI
3038 @cindex MIDI, hauteurs
3039 @cindex quart de ton en MIDI
3040 @cindex MIDI, quart de ton
3041 @cindex microtonalité en MIDI
3042 @cindex MIDI, microtonalité
3043 @cindex accords nommés en MIDI
3044 @cindex MIDI, accords nommés
3045 @cindex Rythme en MIDI
3046 @cindex MIDI, Rythme
3047 @cindex articulations et MIDI
3048 @cindex MIDI et articulations
3049 @cindex trilles et MIDI
3050 @cindex MIDI et trilles
3053 Un fichier MIDI généré par LilyPond comprendra les éléments de notation
3061 les microtonalités -- voir @ref{Altérations}. Leur rendu nécessite
3062 cependant un lecteur qui prenne en charge la modulation ;
3065 les accords nommés ;
3068 le rythme en tant que durée de note, y compris les nolets ;
3071 les trémolos, exceptés ceux utilisant la syntaxe
3072 @qq{@code{:}[@var{nombre}]} ;
3075 les liaisons de prolongation ;
3078 les indications de nuance ;
3081 les crescendos et decrescendos s'étalant sur plusieurs notes ;
3084 les changements de tempo indiqués par un @code{\tempo} ;
3090 Si vous utilisez @ref{Le script Articulate}, d'autres éléments seront
3094 @item articulations (lié, staccato, etc.),
3095 @item trilles et groupettos,
3096 @item rallentando et accelerando.
3100 @node Éléments non pris en compte dans le MIDI
3101 @unnumberedsubsubsec Éléments non pris en compte dans le MIDI
3102 @translationof Unsupported in MIDI
3104 @c TODO index as above
3106 LilyPond ne peut générer d'événement MIDI pour les éléments
3107 suivant, sauf à utiliser @ref{Le script Articulate} :
3111 le rythme indiqué sous forme d'annotation (par ex. @emph{swing}) ;
3114 les changements de tempo indiqués sous forme d'annotation (sans
3118 les staccatos et autres articulations ou ornementations ;
3121 les liaisons d'articulation et de phrasé ;
3124 les crescendos ou decrescendos sur une seule note ;
3127 les trémolos indiqués par la syntaxe @qq{@code{:}[@var{nombre}]} ;
3133 les accords en microtonalité.
3137 @node Répétitions et MIDI
3138 @subsection Répétitions et MIDI
3139 @translationof Repeats in MIDI
3141 @cindex reprises développées
3142 @cindex MIDI et reprises
3143 @funindex \unfoldRepeats
3145 Au prix de quelques réglages, les reprises de toutes sortes peuvent être
3146 rendues dans le fichier MIDI. Il suffit pour cela de recourir à la
3147 fonction @code{\unfoldRepeats}, qui développe toutes les reprises. En
3148 d'autre termes, @code{\unfoldRepeats} transforme toutes les reprises
3149 en reprises de type @code{unfold}.
3152 @lilypond[quote,verbatim]
3154 \repeat tremolo 8 {c'32 e' }
3155 \repeat percent 2 { c''8 d'' }
3156 \repeat volta 2 {c'4 d' e' f'}
3165 Dans une partition comportant plusieurs voix, le développement des
3166 reprises ne sera effectif en MIDI qu'à la condition que ces reprises
3167 soient mentionnée correctement dans @strong{toutes} les voix.
3169 Lorsque l'on veut utiliser @code{\unfoldRepeats} seulement pour le rendu
3170 MIDI, il faut établir deux blocs @code{\score} : un pour le MIDI,
3171 avec des reprises explicites, et l'autre pour la partition, avec des
3172 reprises notées sous forme de barres de reprise, de trémolo ou de
3173 symboles de pourcentage. Par exemple
3181 \unfoldRepeats @var{..musique..}
3187 @node Gestion des nuances en MIDI
3188 @subsection Gestion des nuances en MIDI
3189 @translationof Controlling MIDI dynamics
3191 Les nuances MIDI sont générées par le @code{Dynamic_performer}, affecté
3192 par défaut au contexte @code{Voice}. Vous pouvez contrôler à la fois le
3193 volume général, celui des indications de nuance ainsi que celui des
3194 différents instruments.
3197 * Indications de nuance::
3198 * Amplitude du volume en MIDI::
3199 * Égalisation de plusieurs instruments (i)::
3200 * Égalisation de plusieurs instruments (ii)::
3204 @node Indications de nuance
3205 @unnumberedsubsubsec Indications de nuance
3206 @translationof Dynamic marks
3208 Les indications de nuances sont transcrites en fraction du volume MIDI.
3209 Nous allons, par défaut, de 0,25 pour un @notation{ppppp} à 0,95 pour un
3210 @notation{fffff}. Les correspondances entre nuance et fraction de
3211 volume sont répertoriées dans le fichier @file{../scm/midi.scm} --
3212 consultez la rubrique @rlearning{Autres sources de documentation} si
3213 vous ne savez comment le localiser. Vous pouvez modifier ou étendre ce
3214 jeu grâce à une fonction qui prendra en argument une indication de
3215 nuance et renverra la fraction désirée, puis en affectant cette fonction
3216 à @code{Score.dynamicAbsoluteVolumeFunction}.
3218 Prenons un exemple. Votre partition comporte un @notation{rinforzando}
3219 que vous avez indiqué par @code{\rfz}. Cette indication de nuance
3220 n'étant pas répertoriée dans le jeu par défaut, elle ne produira aucun
3221 effet en MIDI. Il en sera d'ailleurs de même pour toute indication
3222 créée de toute pièce à l'aide de l'instruction
3223 @w{@code{make-dynamic-script}}. Voici comment procéder pour ajuster le
3224 volume MIDI de ce @notation{rinforzando} que le compositeur a indiqué.
3225 La fonction Scheme définit une fraction de 0,9 en cas de @notation{rfz},
3226 et demande d'utiliser la fonction par défaut dans les autre cas.
3228 @lilypond[verbatim,quote]
3229 #(define (myDynamics dynamic)
3230 (if (equal? dynamic "rfz")
3232 (default-dynamic-absolute-volume dynamic)))
3236 \set Staff.midiInstrument = #"cello"
3237 \set Score.dynamicAbsoluteVolumeFunction = #myDynamics
3249 Si vous étiez amené à devoir modifier l'intégralité du jeu des
3250 correspondances, nous vous conseillons d'utiliser la procédure
3251 @command{default-dynamic-absolute-volume} contenue dans le fichier
3252 @file{../scm/midi.scm} ainsi que la table d'association comme base.
3253 Le dernier exemple de cette partie illustre la manière de procéder.
3256 @node Amplitude du volume en MIDI
3257 @unnumberedsubsubsec Amplitude du volume en MIDI
3258 @translationof Overall MIDI volume
3260 Les valeurs extrêmes du volume MIDI des nuances se contrôlent à l'aide
3261 des propriétés @code{midiMinimumVolume} et @code{midiMaximumVolume} qui
3262 agissent au niveau @code{Score}. Ces propriétés sont effectives dès
3263 lors qu'une nuance est indiquée ; une nuance de départ est donc
3264 requise pour que le volume soit ajusté dès le début de la partition.
3265 Vous pouvez alors modifier la fraction correspondant à chaque nuance à
3266 l'aide de la formule
3269 midiMinimumVolume + (midiMaximumVolume - midiMinimumVolume) * fraction
3272 Voici comment ajuster les nuances tout en limitant l'amplitude du volume
3275 @lilypond[verbatim,quote]
3281 \set Staff.midiInstrument = #"flute"
3282 \new Voice \relative c''' {
3290 \set Staff.midiInstrument = #"clarinet"
3291 \new Voice \relative c'' {
3303 midiMinimumVolume = #0.2
3304 midiMaximumVolume = #0.5
3311 @node Égalisation de plusieurs instruments (i)
3312 @unnumberedsubsubsec Égalisation de plusieurs instruments (i)
3313 @translationof Equalizing different instruments (i)
3315 La définition de l'amplitude du volume MIDI au niveau d'un contexte
3316 @code{Staff} permet de gérer les volumes relatifs entre les différents
3317 instruments. Ceci constitue en quelque sorte un égaliseur, ce qui
3318 permet d'améliorer notablement la qualité de la sortie MIDI.
3320 La clarinette de l'exemple suivant jouera relativement moins fort que la
3321 flûte. Rappelez-vous que pour que cela fonctionne correctement, la
3322 première note de chacun des instruments doit être affublée d'une
3323 indication de nuance.
3325 @lilypond[verbatim,quote]
3331 \set Staff.midiInstrument = #"flute"
3332 \set Staff.midiMinimumVolume = #0.7
3333 \set Staff.midiMaximumVolume = #0.9
3334 \new Voice \relative c''' {
3342 \set Staff.midiInstrument = #"clarinet"
3343 \set Staff.midiMinimumVolume = #0.3
3344 \set Staff.midiMaximumVolume = #0.6
3345 \new Voice \relative c'' {
3360 @node Égalisation de plusieurs instruments (ii)
3361 @unnumberedsubsubsec Égalisation de plusieurs instruments (ii)
3362 @translationof Equalizing different instruments (ii)
3364 Lorsque les propriétés volume minimum et maximum n'ont pas été définies,
3365 LilyPond appliquera par défaut une légère égalisation pour quelques
3366 instruments. Les instrument concernés ainsi que le niveau d'égalisation
3367 sont répertoriés dans une table @notation{instrument-equalizer-alist}
3368 du fichier @file{../scm/midi.scm}.
3370 Vous pouvez remplacer l'égaliseur basique en définissant une nouvelle
3371 procédure Scheme @code{instrumentEqualizer} au sein du contexte
3372 @code{Score}. Cette procédure prend en unique argument le nom d'un
3373 instrument MIDI et renverra une paire de fractions correspondant au
3374 minimum et maximum de volume alloué à cet instrument. Cette
3375 substitution fonctionne selon le même principe que celui que nous avons
3376 vu en début de chapitre avec @code{dynamicAbsoluteVolumeFunction}.
3377 L'égaliseur par défaut, @notation{default-instrument-equalizer}, est
3378 défini dans le fichier @file{../scm/midi.scm} ; son analyse vous
3379 aidera à construire votre propre procédure.
3381 Nous allons, dans l'exemple suivant, régler le volume relatif de la
3382 flûte et de la clarinette -- au même niveau que dans le précédent.
3384 @lilypond[verbatim,quote]
3385 #(define my-instrument-equalizer-alist '())
3387 #(set! my-instrument-equalizer-alist
3390 ("flute" . (0.7 . 0.9))
3391 ("clarinet" . (0.3 . 0.6)))
3392 my-instrument-equalizer-alist))
3394 #(define (my-instrument-equalizer s)
3395 (let ((entry (assoc s my-instrument-equalizer-alist)))
3404 \set Score.instrumentEqualizer = #my-instrument-equalizer
3405 \set Staff.midiInstrument = #"flute"
3406 \new Voice \relative c''' {
3414 \set Staff.midiInstrument = #"clarinet"
3415 \new Voice \relative c'' {
3430 @c Delete when satisfied this is adequately covered elsewhere -td
3432 @n ode Microtones in MIDI
3433 @s ubsection Microtones in MIDI
3435 @cindex microtones in MIDI
3437 Microtones consisting of half sharps and half flats are exported
3438 to the MIDI file and render correctly in MIDI players which support
3439 pitch bending. See @ref{Note names in other languages}. Here is
3440 an example showing all the half sharps and half flats. It can be
3441 copied out and compiled to test microtones in your MIDI player.
3443 @lilypond[verbatim,quote]
3460 @node MIDI et percussions
3461 @subsection MIDI et percussions
3462 @translationof Percussion in MIDI
3464 La notation pour percussions recourt généralement à un contexte
3465 particulier -- le @code{DrumStaff} -- qui permet d'affecter directement
3466 les instruments concernés au canal 10 qui leur est réservé.
3468 Certains instruments, tels le xylophone, le marimba, le vibraphone ou
3469 les timbales, se traitent cependant comme des instruments
3470 @qq{classiques} puisqu'ils sont capables d'émettre des hauteurs
3471 différentes ; leurs notation relève donc d'un contexte @code{Staff}
3472 standard, et non d'un @code{DrumStaff} pour pouvoir être rendus
3473 correctement en MIDI.
3475 D'autres percussions, bien que n'émettant qu'un seul son et inclus dans
3476 le standard @emph{general MIDI}, comme le tom mélodique ou le tambour
3477 taiko, ne sont pas attachés au canal 10. Ces instruments doivent
3478 donc être saisi dans un contexte @code{Staff}, en utilisant la hauteur
3481 De nombreux instruments de la famille des percussions, les castagnettes
3482 par exemple, n'existent pas dans le standard @emph{general MIDI}.
3483 L'alternative, bien que peu satisfaisante, consiste à leur attribuer le
3484 son le plus proche dans la banque standard.
3486 @c TODO Expand with examples, and any other issues
3489 Le standard @emph{general MIDI} ne dispose pas du @emph{rim shot} ;
3490 LilyPond lui substitue un @emph{sidestick}.
3493 @node Le script Articulate
3494 @subsection Le script Articulate
3495 @translationof The Articulate script
3497 Vous obtiendrez un rendu MIDI plus @qq{réaliste} grâce au script
3498 @code{articulate}. Celui-ci va tout faire pour d'une part prendre en
3499 compte les articulations (liaisons, staccato etc.) -- en ajoutant un
3500 blanc aux notes raccourcies -- et, d'autre part, développer les trilles
3501 ou groupettos ainsi que tenir compte des éventuels rallentando et
3504 L'utilisation du script @code{articulate} se fait en deux temps. Vous
3505 devez dans un premier temps inclure son fichier d'initialisation en
3506 ajoutant en tête de votre fichier la ligne
3509 \include "articulate.ly"
3512 puis, dans le bloc @code{\score}, indiquer que toutes les répétitions
3513 seront développées et appliquer la commande à votre musique :
3516 \unfoldRepeats \articulate <<
3517 tout le reste du bloc contenant la partition...
3521 Une fois votre fichier modifié de la sorte, vous constaterez que la
3522 version imprimable aura été modifiée en profondeur. Le bloc
3523 @code{\midi} produira par contre un fichier MIDI de bien meilleure
3526 Bien que cela ne gène en rien le fonctionnement du script
3527 @code{articulate}, lui adjoindre la commande @code{\unfoldRepeats} comme
3528 illustré ci-dessus permettra le rendu d'un certain nombre
3529 d'articulations tels les trilles.
3532 Dans la mesure où le script @code{articulate} tend à raccourcir les
3533 accords, certaines musiques, notamment pour l'orgue, paraîtront de moins
3537 @node Extraction d'informations musicales
3538 @section Extraction d'informations musicales
3539 @translationof Extracting musical information
3541 En plus de générer du graphisme et du MIDI, LilyPond peut présenter
3542 l'information musicale sous forme textuelle.
3545 * Affichage de notation au format LilyPond::
3546 * Affichage de la musique sous forme d'expression Scheme::
3547 * Enregistrement d'événements musicaux dans un fichier::
3551 @node Affichage de notation au format LilyPond
3552 @subsection Affichage de notation au format LilyPond
3553 @translationof Displaying LilyPond notation
3555 @funindex \displayLilyMusic
3557 La fonction musicale @code{\displayLilyMusic} permet d'afficher en
3558 notation LilyPond une expression musicale. Le résultat défilera dans le
3559 terminal après avoir lancé LilyPond en ligne de commande. Par exemple,
3563 \displayLilyMusic \transpose c a, @{ c4 e g a bes @}
3570 @{ a,4 cis e fis g @}
3573 LilyPond affichera le résultat sous forme de message en console, au
3574 milieu de toutes les informations de compilation. Afin d'isoler ces
3575 messages et enregistrer le résultat de la fonction
3576 @code{\display@{MATÉRIAU@}}, pensez à rediriger la sortie vers un
3580 lilypond fichier.ly > affichage.txt
3585 Vous noterez que LilyPond ne se contente pas de simplement afficher
3586 l'expression musicale, mais procède aussi à son interprétation -- du
3587 fait que @code{\displayLilyMusic} renvoie l'expression tout en
3588 l'affichant. S'il est bien pratique d'insérer un
3589 @code{\displayLilyMusic} dans une expression musicale pour en obtenir
3590 des informations, l'interprétation de cette expression peut toutefois
3591 être évitée en ajoutant un @code{\void} avant l'instruction :
3595 \void \displayLilyMusic \transpose c a, @{ c4 e g a bes @}
3600 @node Affichage de la musique sous forme d'expression Scheme
3601 @subsection Affichage de la musique sous forme d'expression Scheme
3602 @translationof Displaying scheme music expressions
3604 Voir @rextend{Affichage d'expressions musicales}.
3607 @node Enregistrement d'événements musicaux dans un fichier
3608 @subsection Enregistrement d'événements musicaux dans un fichier
3609 @translationof Saving music events to a file
3611 LilyPond vous permet de sauvegarder dans un fichier séparé, sur la base
3612 de la portée, les événements musicaux. Vous devrez pour ce faire
3613 inclure dans votre fichier maître un fichier d'initialisation
3617 \include "event-listener.ly"
3620 Pour chaque portée que comporte votre partition, vous obtiendrez un
3621 fichier @file{NOMFICHIER-PORTÉENOMMÉE.notes} ou
3622 @file{NOMFICHIER-unnamed-staff.notes}. Notez bien que si plusieurs
3623 portées ne sont pas explicitement nommées, tous leurs événements seront
3624 regroupés et mélangés dans le même fichier. Le résultat ressemblera à
3628 0.000 note 57 4 p-c 2 12
3630 0.250 note 62 4 p-c 7 12
3631 0.500 note 66 8 p-c 9 12
3632 0.625 note 69 8 p-c 14 12
3637 Il s'agit d'un tableau dont les colonnes sont délimitées par une
3638 tabulation. Chaque ligne comporte deux champs fixes suivis d'un certain
3639 nombre de paramètres optionnels.
3642 @var{temps} @var{type} @var{...paramètres...}
3645 Ces informations peuvent faire l'objet d'un retraitement par d'autres
3646 programmes, comme des scripts python, aux fins de recherche en analyse
3647 musicologique ou des expériences à partir du rendu de LilyPond.
3650 Tous les événements ne sont pas pris en charge par
3651 @file{event-listener.ly}. Il s'agit en premier lieu d'une
3652 démonstration, un @qq{proof of concept} du potentiel de LilyPond. Si
3653 certains des éléments que vous cherchez à obtenir n'apparaissent pas,
3654 recopiez le fichier @file{event-listener.ly} dans votre répertoire et
3655 modifiez-le de telle sorte qu'il travaille selon vos attentes.