1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
4 Translation of GIT committish: 95b372c451ea1586db8db66d3d00334382e8e103
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"
307 \layout @{ @dots{} @}
310 \bookOutputSuffix "Menuet"
312 \layout @{ @dots{} @}
315 \bookOutputSuffix "Nocturne"
317 \layout @{ @dots{} @}
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"
328 \layout @{ @dots{} @}
331 \bookOutputName "Menuet"
333 \layout @{ @dots{} @}
336 \bookOutputName "Nocturne"
338 \layout @{ @dots{} @}
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 ouvrant 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} -- pour séparer les termes des
536 commandes @code{\override} et @code{\set}. Précisons à ce sujet qu'en
537 plus d'ajouter une espace avant et après l'intégralité de la commande,
538 vous devrez encadrer d'espaces le point et le signe égal qu'elle peut
540 @w{@code{\override Score . LyricText #'font-size = #5}}.
545 Manuel d'initiation :
546 @rlearning{Organisation des fichiers LilyPond}.
549 @ref{Généralités en matière de titrages},
550 @ref{Le bloc \layout}.
553 @node Titres et entêtes
554 @section Titres et entêtes
555 @translationof Titles and headers
557 La plupart de la musique qui est éditée comporte un titre et le nom de
558 son compositeur ; certains ouvrages dispensent beaucoup plus
562 * Création de titres et entête ou pied de page::
563 * Titrages personnalisés::
564 * Notes de bas de page::
565 * Référencement des numéros de page::
566 * Table des matières::
570 @node Création de titres et entête ou pied de page
571 @subsection Création de titres et entête ou pied de page
572 @translationof Creating titles headers and footers
575 * Généralités en matière de titrages::
576 * Mise en forme par défaut des titrages subalternes::
577 * Mise en forme par défaut des entête et pied de page::
581 @node Généralités en matière de titrages
582 @unnumberedsubsubsec Généralités en matière de titrages
583 @translationof Titles explained
585 Chaque bloc @code{\book} apparaissant dans un même fichier source
586 résultera en un fichier indépendant, comme indiqué à la rubrique
587 @ref{Structure de fichier}. Chacun de ces fichiers résultants
588 comporte deux endroits où placer des titrages : les @strong{titrages
589 de partie} au début de chaque partie (@emph{bookpart}) et les
590 @strong{titrages de morceau} avant chaque pièce (@emph{score}). Tous
591 deux peuvent comporter les mêmes champs bien que, par défaut, le titrage
592 d'un morceau se limite à @code{piece} et @code{opus}.
594 Les blocs @code{\header} peuvent se placer à quatre endroits différents
595 qui formeront une hiérarchie descendante :
600 En tête du fichier source, avant même tout bloc @code{\book},
601 @code{\bookpart} ou @code{\score} ;
604 Au sein d'un bloc @code{\book} et en dehors de tout bloc
605 @code{\bookpart} ou @code{\score} qu'il contient ;
608 Au sein d'un bloc @code{\bookpart} et en dehors de tout bloc
609 @code{\score} qu'il contient ;
612 Après l'expression musicale incluse dans un bloc @code{\score}.
616 La valeur des différents champs sera filtrée en respectant cette
617 hiérarchie ; les valeurs persisteront à moins d'être écrasées par une
618 autre valeur à un niveau inférieur. Ainsi :
622 Le titre d'une partie découle des champs définis en tête du fichier
623 source, modifiés par les champs définis au sein du bloc @code{\book}
624 puis par ceux définis au sein du bloc @code{\bookpart}. Les valeurs qui
625 en résulteront permettront d'imprimer les titrages de partie pour cette
629 Le titre d'un morceau découle des champs définis en tête du fichier
630 source, modifiés par les champs définis au sein du bloc @code{\book}
631 puis par ceux définis au sein du bloc @code{\bookpart}, et enfin par
632 ceux définis au sein du bloc @code{\score}. Les valeurs qui en
633 résulteront permettront d'imprimer les titrages de morceau pour ce
634 morceau. Notez toutefois que, pour un morceau, seuls les champs
635 @code{piece} et @code{opus} seront imprimés, à moins d'avoir valorisé
636 à @code{#t} la variable @code{print-all-headers} dans la section
641 @warning{N'oubliez pas que lorsqu'il est placé à l'intérieur d'un bloc
642 @code{@bs{}score}, le bloc @code{@bs{}header} doit impérativement se
643 trouver @strong{à la suite} de l'expression musicale.}
645 Nul n'est besoin de fournir un bloc @code{\header} à chacun des quatre
646 niveaux ; on peut se passer aussi bien de l'un d'eux que de tous. Dans
647 la même veine, un fichier source simpliste peut ne pas mentionner de
648 bloc @code{\book} ou @code{\bookpart} qui seront alors créés
651 Lorsque l'ouvrage ne comporte qu'un seul morceau, le bloc @code{\header}
652 devrait prendre place en tête de fichier, de telle sorte que soit produit
653 un titrage de partie qui met à disposition tous les champs de titrage.
655 Lorsque l'ouvrage comporte plusieurs morceaux, différents arrangements
656 du bloc @code{\header} permettent d'obtenir différents styles de
657 publication musicale. Par exemple, si la publication comprend plusieurs
658 pièces du même compositeur, un bloc @code{\header} placé en tête de
659 fichier définira le titre de l'ouvrage et le compositeur, que l'on
660 complètera par un bloc @code{\header} dans chaque bloc @code{\score}
661 pour définir les champs @code{piece} et @code{opus}, comme ici :
663 @lilypond[papersize=a5,quote,verbatim,noragged-right]
666 composer = "J. S. Bach."
670 \new Staff \relative g, {
673 \repeat unfold 2 { g16( d' b') a b d, b' d, } |
674 \repeat unfold 2 { g,16( e' c') b c e, c' e, } |
682 \new Staff \relative b {
686 <g, d' b'~>4 b'16 a( g fis) g( d e fis) g( a b c) |
687 d16( b g fis) g( e d c) b(c d e) fis( g a b) |
695 Des agencements plus élaborés sont aussi réalisables. Par exemple, les
696 champs appartenant au titrage principal d'un ouvrage peuvent se
697 reporter dans chaque bloc @code{\score}, certains étant modifiés voire
698 supprimés manuellement :
701 @lilypond[papersize=a5,quote,verbatim,noragged-right]
704 print-all-headers = ##t
707 title = "DAS WOHLTEMPERIRTE CLAVIER"
709 % Pas de mention spéciale pour cet ouvrage
712 \markup { \vspace #1 }
716 \new Staff { \clef "bass" s1 }
719 title = "PRAELUDIUM I"
721 % Pas de sous-titre pour ce morceau
728 \new Staff { \clef "bass" s1 }
732 subsubtitle = "A 4 VOCI"
734 % Pas de sous-titre pour ce morceau
743 @ref{Structure de fichier},
744 @ref{Mise en forme par défaut des titrages subalternes},
745 @ref{Mise en forme personnalisée des titrages}.
748 @node Mise en forme par défaut des titrages subalternes
749 @unnumberedsubsubsec Mise en forme par défaut des titrages subalternes
750 @translationof Default layout of bookpart and score titles
752 Voici les différentes variables attachées au bloc @code{\header} :
755 @lilypond[papersize=a7,quote,verbatim,noragged-right]
758 % Les champs suivants sont centrés
759 dedication = "Dédicace"
761 subtitle = "Sous-titre"
762 subsubtitle = "Sous-sous-titre"
763 % Les champs suivants sont répartis sur une même ligne, et
764 % le champ "instrument" apparaîtra sur les pages suivantes
765 instrument = \markup \with-color #green "Instrument"
767 composer = "Compositeur"
768 % Les champs suivants sont en opposition sur la même ligne
770 arranger = "Arrangeur"
771 % Les champs suivants sont centrés en bas de page
772 tagline = "« tagline » ou mention spéciale en pied de dernière page"
773 copyright = "copyright en pied de première page"
778 % Les champs suivants sont en opposition sur la même ligne
786 % Les champs suivants sont en opposition sur la même ligne
787 piece = "Pièce 2 sur la même page"
795 % Les champs suivants sont en opposition sur la même ligne
796 piece = "Pièce 3 sur une nouvelle page"
803 Quelques précisions :
807 Le nom de l'instrument sera répété en tête de chaque page.
810 Seuls seront imprimés les champs @code{piece} et @code{opus} inclus dans
811 un bloc @code{\score} dès lors que la variable @code{print-all-headers}
812 reste désactivée (valeur à @code{##f}).
815 @c Is the bit about \null markups true? -mp
816 Les champs d'un bloc @code{\header} qui n'auront pas été alimentés
817 seront remplacés par un @emph{markup} @code{\null} de façon à ne pas
821 Par défaut, @code{scoreTitleMarkup} place les champs @code{piece} et
822 @code{opus} de part et d'autre sur une même ligne.
826 Les possibilités de modifier la mise en forme par défaut sont abordées à
827 la rubrique @ref{Mise en forme personnalisée des titrages}.
831 La variable @code{breakbefore} activée dans un bloc @code{\header} situé
832 dans un bloc @code{\score} force le saut de page avant le morceau
833 contenu dans ce @code{\score}. Vous pourrez ainsi séparer le titre
834 principal de la musique.
836 @lilypond[papersize=a8landscape,verbatim,noragged-right]
839 title = "This is my Title"
840 subtitle = "This is my Subtitle"
841 copyright = "This is the bottom of the first page"
844 \repeat unfold 4 { e'' e'' e'' e'' }
846 piece = "This is the Music"
854 Manuel d'initiation :
855 @rlearning{Organisation des fichiers LilyPond}.
858 @ref{Mise en forme personnalisée des titrages},
859 @ref{Structure de fichier}.
861 Fichiers d'initialisation :
862 @file{ly/titling-init.ly}.
865 @node Mise en forme par défaut des entête et pied de page
866 @unnumberedsubsubsec Mise en forme par défaut des entête et pied de page
867 @translationof Default layout of headers and footers
869 Les entête et pied -- @emph{header} et @emph{footer} -- sont des
870 lignes de textes qui apparaissent en haut et en bas de chaque page,
871 indépendamment du texte de l'ouvrage. Ils sont contrôlés par les
872 variables suivantes, attachées au bloc @code{\paper} :
875 @item @code{oddHeaderMarkup} -- entête de page impaire
876 @item @code{evenHeaderMarkup} -- entête de page paire
877 @item @code{oddFooterMarkup} -- pied de page impaire
878 @item @code{evenFooterMarkup} -- pied de page paire
881 Ces variables @emph{markup} n'accèdent qu'au contenu des champs du bloc
882 @code{\header} principal, celui qui s'appliquera à tous les blocs
883 @code{\score} du document. Ces variables sont définies dans le fichier
884 @file{ly/titling-init.ly}, et sont par défaut :
889 les numéros sont placés en haut à gauche (si pair) ou à droite (si
890 impair) de chaque page à compter de la deuxième ;
893 le contenu du champ @code{instrument} est centré en haut de chaque page
894 à compter de la deuxième ;
897 le texte du @code{copyright} est centré au bas de la première page ;
900 le @code{tagline} -- mention spéciale -- se place au bas de la dernière
901 page, ou bien sous le @code{copyright} s'il n'y a qu'une seule page.
905 @lilypond[papersize=a8landscape]
915 La mention spéciale se modifie en alimentant le champ @code{tagline} au
916 niveau du bloc @code{\header} principal.
918 @lilypond[papersize=a8landscape,verbatim]
921 tagline = "... music notation for Everyone"
931 Pour supprimer le @code{tagline}, il suffit de lui assigner la valeur
935 @node Titrages personnalisés
936 @subsection Titrages personnalisés
937 @translationof Custom titles headers and footers
939 @c TODO: somewhere put a link to header spacing info
940 @c (you'll have to explain it more in NR 4).
943 * Mise en forme personnalisée des champs de titrage::
944 * Mise en forme personnalisée des titrages::
945 * Mise en forme personnalisée des entête et pied de page::
949 @node Mise en forme personnalisée des champs de titrage
950 @unnumberedsubsubsec Mise en forme personnalisée des champs de titrage
951 @translationof Custom text formatting for title blocks
953 Toutes les commandes de mise en forme d'un @code{\markup} permettent de
954 personnaliser le texte des entête, pied de page et éléments de titrage
955 contenus dans un bloc @code{\header}.
957 @lilypond[quote,verbatim,noragged-right]
961 piece = \markup { \fontsize #4 \bold "PRAELUDIUM I" }
962 opus = \markup { \italic "(Excerpt)" }
969 @ref{Mise en forme du texte}.
972 @node Mise en forme personnalisée des titrages
973 @unnumberedsubsubsec Mise en forme personnalisée des titrages
974 @translationof Custom layout for titles
976 @cindex bookTitleMarkup
977 @cindex scoreTitleMarkup
978 @funindex bookTitleMarkup
979 @funindex scoreTitleMarkup
981 L'utilisation de commandes @code{\markup} au sein d'un bloc
982 @code{\header} permet de modifier aisément l'apparence du texte,
983 mais n'influence en rien le positionnement précis des éléments de
984 titrage. L'accès au positionnement des champs de titrage est géré par
985 les deux variables suivantes, attachées au bloc @code{\paper} :
988 @item @code{bookTitleMarkup}
989 @item @code{scoreTitleMarkup}
992 Le positionnement des titres, avec les valeurs par défaut de ces
993 variables @code{\markup}, est illustré à la rubrique
994 @ref{Mise en forme par défaut des titrages subalternes}.
996 Voici les réglages par défaut de @code{scoreTitleMarkup}, tels que
997 définis dans le fichier @file{ly/titling-init.ly} :
1000 scoreTitleMarkup = \markup @{ \column @{
1001 \on-the-fly #print-all-headers @{ \bookTitleMarkup \hspace #1 @}
1003 \fromproperty #'header:piece
1004 \fromproperty #'header:opus
1010 Ceci aura donc pour effet de positionner les champs @code{piece} et
1011 @code{opus} sur la même ligne, en opposition :
1013 @lilypond[quote,verbatim,noragged-right]
1017 piece = "PRAELUDIUM I"
1023 Voici comment redéfinir le @code{scoreTitleMarkup} de telle sorte que le
1024 champ @code{piece}, dont nous modifions la taille et la graisse, se
1025 place au centre de cette ligne :
1027 @lilypond[papersize=a5,quote,verbatim,noragged-right]
1031 scoreTitleMarkup = \markup {
1034 \fontsize #4 \bold \fromproperty #'header:piece
1035 \fromproperty #'header:opus
1039 \header { tagline = ##f }
1043 piece = "PRAELUDIUM I"
1050 Les champs normalement absents du @code{\header} d'un bloc @code{\score}
1051 seront toutefois imprimés dès lors que vous aurez activé l'instruction
1052 @code{print-all-headers} au sein du bloc @code{\paper}. Le principal
1053 inconvénient de cette fonction réside dans le fait que les champs
1054 dévolus au titrage des parties devront être supprimés dans
1055 chacun des blocs @code{\score} de votre fichier source -- voir
1056 @ref{Généralités en matière de titrages}.
1058 Afin d'éviter ce désagrément, ajoutez le champ que vous désirez voir
1059 apparaître à la définition de @code{scoreTitleMarkup}. Nous allons,
1060 dans l'exemple suivant, ajouter au @code{scoreTitleMarkup} le champ
1061 @code{composer}, normalement associé au @code{bookTitleMarkup} ;
1062 chaque @code{\score} pourra alors mentionner un compositeur différent.
1064 @lilypond[papersize=a5,quote,verbatim,noragged-right]
1068 scoreTitleMarkup = \markup {
1071 \fontsize #4 \bold \fromproperty #'header:piece
1072 \fromproperty #'header:composer
1076 \header { tagline = ##f }
1081 composer = "Christian Petzold"
1088 composer = "François Couperin"
1094 Rien ne vous empêche de créer votre propre champ personnalisé, puis d'y
1095 faire référence dans la définition du @emph{markup}.
1097 @lilypond[papersize=a5,quote,verbatim,noragged-right]
1101 scoreTitleMarkup = \markup {
1104 \override #`(direction . ,UP) {
1106 \center-align \fontsize #-1 \bold
1107 \fromproperty #'header:mycustomtext %% User-defined field
1108 \center-align \fontsize #4 \bold
1109 \fromproperty #'header:piece
1112 \fromproperty #'header:opus
1116 \header { tagline = ##f }
1121 mycustomtext = "A 4 VOCI" %% User-defined field
1129 Manuel de notation :
1130 @ref{Généralités en matière de titrages}.
1133 @node Mise en forme personnalisée des entête et pied de page
1134 @unnumberedsubsubsec Mise en forme personnalisée des entête et pied de page
1135 @translationof Custom layout for headers and footers
1137 @c can make-header and make-footer be removed from
1138 @c paper-defaults-init.ly? -mp
1140 L'utilisation de commandes @code{\markup} au sein d'un bloc
1141 @code{\header} permet de modifier aisément l'apparence du texte,
1142 mais n'influence en rien le positionnement précis des entête et pied
1143 de page. L'accès au positionnement des champs concernés est géré par
1144 les quatre variables suivantes, attachées au bloc @code{\paper} :
1147 @item @code{oddHeaderMarkup}
1148 @item @code{evenHeaderMarkup}
1149 @item @code{oddFooterMarkup}
1150 @item @code{evenFooterMarkup}
1153 @cindex markup conditionnel
1154 @cindex condition et markup
1155 @cindex on-the-fly (à la volée)
1157 @funindex \on-the-fly
1159 L'instruction @code{\on-the-fly} au sein d'un @code{\markup} permet
1160 d'ajouter, lorsque certaines conditions sont respectées, des éléments
1161 au texte des entête et pied de page définis dans le bloc @code{\paper}.
1162 En voici la syntaxe :
1165 @code{variable} = @code{\markup} @{
1167 @code{\on-the-fly} #@var{procédure} @var{markup}
1172 La @var{procédure} est appelée à chaque fois que la commande
1173 @code{\markup} où elle apparaît est évaluée. La @var{procédure}
1174 effectuera un test de conformité particulier et interprètera, autrement
1175 dit imprimera l'argument @var{markup} si et seulement si cette
1176 condition est remplie.
1178 LilyPond dispose d'ores et déjà d'un certain nombre de procédures :
1181 @multitable {print-page-number-check-first-----} {ce n'est la première page du book--}
1183 @headitem Nom de la procédure @tab Condition testée
1185 @item print-page-number-check-first @tab il faut imprimer ce numéro de page.
1186 @item create-page-number-stencil @tab 'print-page-numbers est vrai.
1187 @item print-all-headers @tab 'print-all-headers est vrai.
1188 @item first-page @tab c'est la première page du @emph{book}.
1189 @item (on-page nombre) @tab numéro de page = nombre
1190 @item last-page @tab c'est la dernière page du @emph{book}.
1191 @item not-first-page @tab ce n'est la première page du @emph{book}.
1192 @item part-first-page @tab c'est la première page de la partie.
1193 @item part-last-page @tab c'est la dernière page de la partie.
1194 @item not-single-page @tab cette partie fait plus d'une page.
1199 L'exemple suivant illustre la manière de centrer son numéro au bas de
1200 chaque page. Il nous faut tout d'abord annuler les définitions de
1201 @code{oddHeaderMarkup} et @code{evenHeaderMarkup} à l'aide d'un
1202 @emph{markup} @code{\null}. Nous redéfinissons ensuite
1203 @code{oddFooterMarkup} pour qu'il contienne le numéro de page, centré.
1204 Enfin, nous appliquons le même paramétrage au @code{\oddFooterMarkup}.
1206 @lilypond[papersize=a8,quote,verbatim,noragged-right]
1209 print-page-number = ##t
1210 print-first-page-number = ##t
1211 oddHeaderMarkup = \markup \null
1212 evenHeaderMarkup = \markup \null
1213 oddFooterMarkup = \markup {
1215 \on-the-fly #print-page-number-check-first
1216 \fromproperty #'page:page-number-string
1219 evenFooterMarkup = \oddFooterMarkup
1222 \new Staff { s1 \break s1 \break s1 }
1227 Plusieurs conditions @code{\on-the-fly} mentionnées l'une à la suite de
1228 l'autre se cumulent. Ainsi, par exemple,
1231 @code{\on-the-fly #first-page}
1232 @code{\on-the-fly #last-page}
1233 @code{@{ \markup ... \fromproperty #'header: ... @}}
1236 teste si la sortie tient sur une page unique.
1239 Manuel de notation :
1240 @ref{Généralités en matière de titrages},
1241 @ref{Mise en forme par défaut des titrages subalternes}.
1243 fichiers d'initialisation :
1244 @file{../ly/titling-init.ly}.
1247 @node Notes de bas de page
1248 @subsection Notes de bas de page
1249 @translationof Creating footnotes
1251 @cindex bas de page, notes
1254 Les notes de bas de page sont utiles dans bien des situations. Dans
1255 tous les cas, un « appel de note » vient se placer en référence dans te
1256 texte ou la musique, et le « texte de la note » est reporté en bas de la
1259 Selon qu'elle est référencée dans une expression musicale ou dans du
1260 texte indépendant, une note de bas de page sera créée suivant une
1261 procédure différente.
1264 * Notes de bas de page dans une expression musicale::
1265 * Notes de bas de page dans du texte indépendant::
1269 @node Notes de bas de page dans une expression musicale
1270 @unnumberedsubsubsec Notes de bas de page dans une expression musicale
1271 @translationof Footnotes in music expressions
1273 @cindex musique et note de bas de page
1276 @subsubsubheading Généralités sur l'annotation de musique
1277 @c VO Music footnotes overview
1279 Il existe deux catégories d'annotation concernant une expression
1283 @item Les annotations événementielles
1284 se rattachent à des événements particuliers, comme une note individuelle
1285 ou au sein d'un accord, un élément d'interprétation (ligature, liaison,
1286 doigté, accent ou nuance) et des paroles.
1288 @item Les annotations temporelles
1289 se rapportent à un point particulier du déroulement d'un contexte
1290 musical. Certaines commandes, telles @code{\time} et @code{\clef}, ne
1291 reposent pas sur un événement pour la création de l'objet métrique ou
1292 clef. Il en va de même pour un accord : sa hampe ou ses crochets ne
1293 sont créés qu'à la fin d'un moment (plus exactement au travers de l'un
1294 des événements note qui le composent). Une annotation temporelle permet
1295 d'annoter ces objets de rendus sans se référer à un événement.
1299 Examinons la forme développée d'une commande de note de bas de page,
1300 qu'elle soit événementielle ou temporelle :
1303 [@var{position}] \footnote [@var{marque}] @var{décalage} [@var{nom-grob}] @var{annotation} @var{musique}
1306 Ses arguments peuvent se définir ainsi :
1310 Lorsque la commande @code{\footnote} s'applique à un élément
1311 d'interprétation ou un événement rattaché, et uniquement dans ces cas,
1312 elle doit être précédée d'un indicateur de positionnement (@code{-, _
1313 ou ^}) de façon à rattacher @var{musique} (avec sa marque) à la note ou
1314 au silence qui précède.
1317 Un @emph{markup} ou une chaîne de caractères identifiant l'annotation
1318 tant au niveau de l'appel que de la note qui apparaîtra au bas de la
1319 page. L'absence de cet élément -- ou une valeur de @code{\default} --
1320 incrémentera automatiquement le compteur. Ce compteur est réinitialisé
1321 à chaque page comportant une annotation.
1324 Une paire de nombres -- @samp{#(2 . 1)} par exemple -- spécifiant le
1325 décalage de la marque, en abscisse et en ordonnée, par rapport au point
1326 de référence. Des valeurs positives décalent vers la droite ou le
1327 haut, des valeurs négatives vers la gauche ou le bas ; des valeurs à
1328 zéro centrent la marque sur le point de référence. Le décalage
1329 s'exprime en espace de portée.
1332 Le type d'objet à annoter -- @samp{#'Flag} par exemple. Lorsque cet
1333 élément est spécifié, c'est l'objet en question qui servira de point de
1334 référence, même s'il trouve son origine non pas directement dans
1335 l'élément @var{musique} mais dans un objet en résultant. Son absence ou
1336 une valeur de @code{\default} ne permet d'annoter que des objets
1340 un @emph{markup} ou une chaîne de caractères qui sera reporté au bas de
1344 l'élément qui fait l'objet du commentaire, qu'il s'agisse d'un
1345 événement musical, de l'un des constituants d'un accord ou d'un
1346 événement rattaché. Bien qu'il ne puisse être omis, il peut être
1347 remplacé par @code{\default}, auquel cas l'annotation ne sera pas
1348 rattachée à une expression musicale particulière, mais plutôt à un
1349 instant précis. L'argument @var{nom-grob} est alors obligatoire pour
1350 sélectionner le type d'objet affecté -- @samp{#'TimeSignature} par
1355 @subsubsubheading Notes de bas de page événementielles
1356 @c VO Event-based footnotes
1358 @cindex événementielle, note de bas de page
1360 Le moyen le plus simple d'annoter un événement est :
1363 \footnote @var{décalage} @var{annotation} @var{musique}
1366 Ce type de note de bas de page s'attache à un objet de rendu généré par
1367 l'événement correspondant à @var{musique}.
1370 @lilypond[quote,verbatim,papersize=a8landscape]
1372 \header { tagline = ##f }
1374 a4_\footnote #'(0 . -1) "Une liaison arbitrairement en dessous" (
1375 b8^\footnote #'(1 . 0.5) "Une ligature manuelle forcée en haut" [
1378 c-\footnote #'(1 . 1) "Tenuto" --
1383 Les appels de note peuvent être personnalisés, et le trait reliant
1384 l'objet à l'appel supprimé :
1387 @lilypond[quote,verbatim,papersize=a8landscape]
1389 \header { tagline = ##f }
1391 \footnote "*" #'(0.5 . -2) \markup { \italic "* La première note" }
1393 \footnote \markup { \super "$" } #'(0.5 . 1)
1394 \markup { \super "$" \italic " La deuxième note" }
1396 \once \override Score.FootnoteItem #'annotation-line = ##f
1397 b-\footnote \markup \tiny "+" #'(0.1 . 0.1)
1398 \markup { \super "+" \italic " Éditorial" } \p
1403 D'autres exemples de personnalisation des appels de note sont donnés à
1404 la rubrique @ref{Notes de bas de page dans du texte indépendant}.
1406 L'annotation d'un accord dans sa globalité n'est pas réalisable de cette
1407 manière dans la mesure où un accord ne génère pas d'événement en dehors
1408 de ses constituants. Les notes qui le composent peuvent cependant faire
1409 l'objet d'une annotation.
1411 Lorsque la note de bas de page se réfère à un objet de rendu résultant
1412 d'un événement -- @code{Accidental} ou @code{Stem} découlent d'un
1413 @code{NoteHead} --, l'argument additionnel @var{nom-grob} est requis
1414 avant le texte de l'annotation :
1417 @lilypond[quote,verbatim,papersize=a8landscape]
1419 \header { tagline = ##f }
1421 % footnotes may be added to chord constituents
1422 < \single\footnote #'(-1 . -3) "Un autre bémol" Accidental aes
1424 \single\footnote #'(-1 . 0.5) "Un bémol" Accidental ees
1426 \single\footnote #'(-1 . 2) "Une hampe" Stem ees2
1431 @warning{Lorsque plusieurs notes de bas de page se rapportent à un même
1432 empilement vertical, elles sont numérotées et apparaîtront selon
1433 l'ordre vertical des éléments présentés, autrement dit celui positionné
1434 le plus haut en premier, non dans leur ordre d'apparition dans le
1437 @subsubsubheading Notes de bas de page temporelles
1438 @c VO Time-based footnotes
1440 @cindex temporelle, note de bas de page
1442 Les objets de rendu tels que changement de clef ou d'armure tirent leur
1443 origine dans la modification d'une propriété plutôt que d'un véritable
1444 événement. D'autres, comme les barres ou numéros de mesure, dépendent
1445 directement de la temporisation. C'est la raison pour laquelle de tels
1446 objets doivent s'annoter en fonction de leur survenance au fil de la
1447 musique. Les notes de bas de page temporelles sont la solution à
1448 privilégier lorsqu'il s'agit d'annoter les hampes ou ligature affectant
1449 des accords : bien qu'une telle fonctionnalité puisse s'appliquer à l'un
1450 des événements constituant l'accord, rien ne laisse présager lequel
1451 serait le plus adéquat.
1453 Une note de bas de page temporelle s'introduit de la même manière qu'une
1454 note événementielle, à ceci près que la mention @code{\default}
1455 remplacera l'argument @var{musique} qui indique l'événement à annoter.
1456 En matière de note de bas de page temporelle, l'objet de rendu considéré
1457 devrait toujours être mentionné explicitement, de telle sorte qu'il n'y
1458 ait pas d'erreur quant au positionnement de l'appel de note.
1461 @lilypond[quote,verbatim,papersize=a8landscape]
1463 \header { tagline = ##f }
1466 \footnote #'(-0.5 . -1) #'TimeSignature "Changement de métrique" \default
1468 \footnote #'(1 . -1) #'Stem "Hampe de l'accord" \default
1470 \footnote #'(-0.5 . 1) #'BarLine "Barre de mesure" \default
1472 \footnote #'(0.5 . -1) #'KeySignature "Changement d'armure" \default
1480 @node Notes de bas de page dans du texte indépendant
1481 @unnumberedsubsubsec Notes de bas de page dans du texte indépendant
1482 @translationof Footnotes in stand-alone text
1484 @cindex texte indépendant et note de bas de page
1486 De telles notes de bas de page affectent les @emph{markup} extérieurs
1487 aux expressions musicales. Il n'est pas nécessaire en pareil cas
1488 d'indiquer un point de référence par un trait ; l'appel de note vient
1489 juste s'accoler au @emph{markup} qui fait l'objet de l'annotation. Les
1490 appels de note peuvent être gérés automatiquement, auquel cas ils seront
1491 numériques, ou bien manuellement en fournissant un indicateur
1494 Les notes de bas de page concernant du texte indépendant se gèrent
1495 différemment selon qu'elles sont automatiques ou manuelles.
1498 @subsubsubheading Notes de bas de page automatiques dans du texte
1499 @c VO Footnotes in stand-alone text with automatic marks
1501 La syntaxe consacrée dans le cas d'une gestion automatique des appels
1505 \markup @{ ... \auto-footnote @var{texte} @var{annotation} ... @}
1508 Dont les éléments sont :
1513 le @emph{markup} ou la chaîne de caractères sur lequel porte
1517 un @emph{markup} ou une chaîne de caractères constituant le texte de
1518 l'annotation qui sera reportée en bas de page.
1524 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1526 \header { tagline = ##f }
1529 \auto-footnote "tune" \italic " By me"
1530 "is shown below. It is a"
1531 \auto-footnote "recent" \italic " Aug 2012"
1541 @subsubsubheading Notes de bas de page personnalisées dans du texte
1542 @c VO Footnotes in stand-alone text with custom marks
1544 La syntaxe consacrée dans le cas d'une gestion personnalisée des appels
1548 \markup @{ ... \footnote @var{appel} @var{annotation} ... @}
1551 Dont les éléments sont :
1556 un @emph{markup} ou une chaîne de caractères représentant l'appel de
1557 note affecté à ce point de référence. Notez bien que cette marque ne
1558 sera @strong{pas} reproduite automatiquement avant le texte proprement
1559 dit de l'annotation.
1562 un @emph{markup} ou une chaîne de caractères constituant le texte de
1563 l'annotation qui sera reportée en bas de page, précédé de l'@var{appel}.
1567 N'importe quel caractère simple tel que @code{*} ou @code{+} peut
1568 s'utiliser en tant qu'appel de note, comme nous l'avons vu à la rubrique
1569 @ref{Notes de bas de page dans une expression musicale}. D'autres
1570 caractères particuliers sont accessibles sous forme de raccourci -- voir
1571 la rubrique @ref{Équivalents ASCII} :
1573 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1575 \paper { #(include-special-characters) }
1576 \header { tagline = ##f }
1579 \footnote "*" \italic "* By me"
1580 "is shown below. It is a recent"
1581 \footnote \super † \concat {
1582 \super † \italic " Aug 2012"
1592 Un appel de note peut aussi se libeller sous la forme d'un point de code
1593 unicode -- voir la rubrique @ref{Unicode} :
1595 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1597 \header { tagline = ##f }
1600 \footnote \super \char##x00a7 \concat {
1601 \super \char##x00a7 \italic " By me"
1603 "is shown below. It is a recent"
1604 \footnote \super \char##x00b6 \concat {
1605 \super \char##x00b6 \italic " Aug 2012"
1616 Manuel d'initiation :
1617 @rlearning{Objets et interfaces}.
1619 Manuel de notation :
1620 @ref{Commentaires textuels},
1621 @ref{Équivalents ASCII},
1622 @ref{Indications textuelles},
1624 @ref{Liste des caractères spéciaux},
1627 Référence des propriétés internes :
1628 @rinternals{FootnoteEvent},
1629 @rinternals{FootnoteItem},
1630 @rinternals{FootnoteSpanner},
1631 @rinternals{Footnote_engraver}.
1634 Les notes de bas de page ne peuvent que s'empiler l'une au-dessus de
1635 l'autre ; elles ne seront jamais présentées à la queue leu leu.
1637 Silence multimesures et ligatures automatiques ne peuvent se voir
1638 affecter de note de bas de page.
1640 Les notes de bas de page peuvent générer des chevauchements quand elles
1641 sont trop nombreuses sur une même page.
1644 @node Référencement des numéros de page
1645 @subsection Référencement des numéros de page
1646 @translationof Reference to page numbers
1648 LilyPond vous permet, à l'aide de la commande @code{\label}, d'insérer
1649 des points de référence dans un ouvrage, aussi bien en dehors qu'au fil
1650 de la musique. Ce point de référence pourra être ensuite repris à
1651 l'intérieur d'un @emph{markup} ; vous pourrez même y ajouter le
1652 numéro de page grâce à la commande de @emph{markup} @code{\page-ref}.
1655 @lilypond[verbatim,papersize=a8landscape]
1656 \header { tagline = ##f }
1662 \pageBreak \mark A \label #'markA
1667 \markup { Le premier mouvement débute à la page \page-ref #'firstScore "0" "?" }
1668 \markup { Le repère A est à la page \page-ref #'markA "0" "?" }
1672 L'instruction @code{\page-ref} prend trois arguments :
1675 le point de référence, sous la forme d'un symbole Scheme, comme par
1676 exemple @code{#'firstScore},
1679 un @qq{emporte-pièce} afin d'estimer la longueur totale du
1683 un texte de remplacement au cas où la référence ne serait pas retrouvée.
1686 La présence de l'emporte-pièce est rendue nécessaire par le fait que les
1687 @emph{markups} sont générés avant que les sauts de page ne soient
1688 positionnés. Bien que le numéro de page en question ne soit pas encore
1689 déterminé, LilyPond doit connaître les dimensions de ce @emph{markup}.
1690 Vous pouvez, lorsque l'ouvrage contiendra plus de dix pages, stipuler un
1691 emporte-pièce sur deux caractères -- soit @code{"00"}.
1701 @node Table des matières
1702 @subsection Table des matières
1703 @translationof Table of contents
1705 La commande @code{\markuplist \table-of-contents} vous permettra de
1706 générer une table des matières. Les éléments qui la composeront sont
1707 créés par la commande @code{\tocItem}, insérée indépendamment ou au sein
1708 d'une expression musicale.
1711 \markuplist \table-of-contents
1714 \tocItem \markup "Premier mouvement"
1718 \tocItem \markup "Passage spécifique du premier mouvement"
1723 \tocItem \markup "Second mouvement"
1731 Les @emph{markups} dévolus à la mise en forme de la table des matières
1732 se définissent dans le bloc @code{\paper}. Il s'agit par défaut de
1733 @code{tocTitleMarkup} pour le titre de la table, et de
1734 @code{tocItemMarkup} pour ses éléments -- composés de leur libellé et
1735 numéro de page. Vous pouvez bien entendu personnaliser ces variables :
1739 %% Translate the toc title into French:
1740 tocTitleMarkup = \markup \huge \column {
1741 \fill-line { \null "Table des matières" \null }
1744 %% use larger font size
1745 tocItemMarkup = \markup \large \fill-line {
1746 \fromproperty #'toc:text \fromproperty #'toc:page
1751 Notez bien la manière de référencer le libellé et le numéro de page dans
1752 la définition de @code{tocItemMarkup}.
1754 N'hésitez pas à définir vous-même d'autres commandes et @emph{markups}
1755 afin de construire une table plus élaborée :
1758 commencez par définir une nouvelle variable de type @code{markup} au
1759 sein du bloc @code{\paper},
1762 puis définissez une fonction musicale chargée d'insérer un élément de la
1763 table à partir de cette variable.
1766 Dans l'exemple qui suit, nous avons créé un nouveau style d'élément dans
1767 le but de mentionner les actes dans la table des matières d'un opéra :
1771 tocActMarkup = \markup \large \column {
1773 \fill-line { \null \italic \fromproperty #'toc:text \null }
1779 #(define-music-function (parser location text) (markup?)
1780 (add-toc-item! 'tocActMarkup text))
1783 @lilypond[line-width=10.0\cm]
1784 \header { tagline = ##f }
1786 tocActMarkup = \markup \large \column {
1788 \fill-line { \null \italic \fromproperty #'toc:text \null }
1794 #(define-music-function (parser location text) (markup?)
1795 (add-toc-item! 'tocActMarkup text))
1798 \markuplist \table-of-contents
1799 \tocAct \markup { Atto Primo }
1800 \tocItem \markup { Coro. Viva il nostro Alcide }
1801 \tocItem \markup { Cesare. Presti omai l'Egizzia terra }
1802 \tocAct \markup { Atto Secondo }
1803 \tocItem \markup { Sinfonia }
1804 \tocItem \markup { Cleopatra. V'adoro, pupille, saette d'Amore }
1809 L'élément et son numéro de page peuvent se rejoindre par une ligne
1812 @lilypond[verbatim,line-width=10.0\cm]
1813 \header { tagline = ##f }
1815 tocItemMarkup = \tocItemWithDotsMarkup
1819 \markuplist \table-of-contents
1820 \tocItem \markup { Allegro }
1821 \tocItem \markup { Largo }
1827 @funindex \table-of-contents
1828 @code{\table-of-contents},
1834 Fichiers d'initialisation :
1835 @file{../ly/toc-init.ly}.
1838 @node Travail sur des fichiers texte
1839 @section Travail sur des fichiers texte
1840 @translationof Working with input files
1843 * Insertion de fichiers LilyPond::
1844 * Différentes éditions à partir d'une même source::
1845 * Caractères spéciaux::
1849 @node Insertion de fichiers LilyPond
1850 @subsection Insertion de fichiers LilyPond
1851 @translationof Including LilyPond files
1854 @cindex inclusion de fichiers
1856 Lorsqu'un projet prend de l'importance en volume, il est judicieux de le
1857 scinder en plusieurs fichiers, auxquels vous ferez référence avec un
1861 \include "autrefichier.ly"
1864 Une ligne @code{\include "autrefichier.ly"} dans un fichier revient à
1865 recopier intégralement le contenu de @file{autrefichier.ly} à l'endroit
1866 même ou est placée l'instruction @code{\include}. Vous pouvez par
1867 exemple écrire un fichier individuel par instrument, puis les regrouper
1868 pour former le fichier @qq{conducteur}. Les différentes variables
1869 définies dans les fichiers séparés seront normalement reprises et
1870 utilisables dans le fichier formant le conducteur. Les sections
1871 balisées dans les fichiers individuels peuvent être réutilisées en
1872 différents endroit de la partition, comme expliqué à la rubrique
1873 @ref{Différentes éditions à partir d'une même source}.
1875 Lorsque le fichier auquel il est fait référence se trouve dans le même
1876 répertoire, donner seulement son nom en argument à la commande
1877 @code{\include} suffit. S'il se trouve ailleurs, vous devrez indiquer
1878 le chemin d'accès, absolu ou relatif, en respectant toutefois la syntaxe
1879 UNIX -- autrement dit, le séparateur de répertoire est une oblique
1880 normale @code{/} et non l'oblique inverse @code{\} de DOS ou Windows.
1881 Par exemple, si le fichier @file{truc.ly} se trouve dans le répertoire
1882 supérieur au répertoire de travail, la ligne devra être
1885 \include "../truc.ly"
1889 ou bien, si les fichiers correspondant aux parties d'orchestre se
1890 trouvent dans le sous-répertoire @file{parties} relativement au
1891 répertoire courant, vous devrez mentionner
1894 \include "parties/VI.ly"
1895 \include "parties/VII.ly"
1899 Les fichiers à inclure peuvent eux-mêmes contenir des instructions
1900 @code{\include}. Ces instructions @code{\include} de second niveau ne
1901 pourront, par défaut, être interprétées qu'une fois intégrées dans le
1902 fichier principal ; leur argument doit donc comporter le chemin
1903 relativement au fichier principal et non par rapport au fichier dans
1904 lequel cette inclusion est mentionnée. Vous pouvez toutefois influer
1905 sur ce comportement de manière globale à l'aide de l'option
1906 @w{@code{-drelative-includes}} en ligne de commande ou en ajoutant une
1907 clause @code{#(ly:set-option 'relative-includes #t)} en tête du fichier
1910 Lorsque @code{relative-include} est valorisé à @code{#t}, le chemin à
1911 suivre pour chacune des commandes @code{\include} sera pris relativement
1912 au fichier qui la contient. Cette option est vouée à être activée par
1913 défaut dans une future version de LilyPond.
1915 Selon l'endroit où @code{relative-includes} est valorisé à @code{#t} ou
1916 @code{#f}, la commande @code{\include} permettra d'incorporer des
1917 fichiers contenus dans l'arborescence du répertoire principal et des
1918 fichiers situés ailleurs. Si, par exemple, une biblothèque générale
1919 libA a été créée pour utiliser des sous-fichiers à l'aide de
1920 d'inclusions dans un fichier catalogue, les clauses @code{\include}
1921 devront être précédées d'un@code{#(ly:set-option #relative-includes #t)}
1922 de telle sorte qu'elles soient interprétées correctement lorsque
1923 rapatriées dans le fichier @file{.ly} principal. Examinons cela dans
1935 puis le fichier catalogue, @code{libA.ly}, qui contient
1938 #(ly:set-option 'relative-includes #t)
1942 % retour au réglage par défaut
1943 #(ly:set-option 'relative-includes #f)
1946 Tout fichier @code{.ly} peut désormais consulter l'intégralité de cette
1947 bibliothèque grâce à un simple
1950 \include "~/libA/libA.ly"
1953 Un positionnement judicieux des commutateurs permet de gérer des
1954 structures de fichiers plus complexes.
1956 Vous pouvez inclure des fichiers dont vous spécifierez le chemin d'accès
1957 sur la ligne de commande au moment de lancer la compilation. L'appel à
1958 ces fichiers ne mentionnera alors que leur nom. Par exemple, si vous
1959 voulez compiler avec cette méthode le fichier @file{principal.ly} qui
1960 inclut des fichiers situés dans le sous-répertoire @file{parties},
1961 placez vous dans le répertoire contenant @file{principal.ly}, puis tapez
1964 lilypond --include=parties principal.ly
1967 tout en ayant bien dans @file{principal.ly}
1975 Lorsqu'un fichier est voué à être inclus dans nombre de partitions, vous
1976 pouvez le placer dans le répertoire de LilyPond @file{../ly}.
1977 Attention : ce répertoire varie selon votre installation, comme
1978 indiqué au chapitre @rlearning{Autres sources de documentation}. Ce
1979 fichier sera inclus dès lors que vous fournirez uniquement son nom en
1980 argument à la fonction @code{\include}. C'est par exemple le cas du
1981 fichier de définition particulier @file{gregorian.ly}.
1983 Au moment où vous lancez LilyPond, un certain nombre de fichiers se
1984 retrouvent inclus par défaut ; il suffit d'activer le mode verbeux
1985 en faisant @w{@code{lilypond --verbose}} pour s'en rendre compte. Vous
1986 verrez ainsi défiler, en plus de nombreuses informations, le nom d'un
1987 certain nombre de fichiers et de chemins d'accès. Les fichiers les plus
1988 important sont mentionnés au chapitre
1989 @rlearning{Autres sources de documentation}. Si vous venez à les
1990 modifier, rappelez-vous qu'ils seront écrasés à l'installation d'une
1991 nouvelle version de LilyPond.
1993 Vous trouverez quelques exemples simples d'utilisation de la commande
1994 @code{\include} au chapitre @rlearning{Conducteurs et parties}.
1997 Manuel d'initiation :
1998 @rlearning{Autres sources de documentation},
1999 @rlearning{Conducteurs et parties}.
2002 Lorsque vous incluez un fichier qui porte le même nom que l'un des
2003 fichiers d'initialisation de LilyPond, le fichier de la distribution de
2004 LilyPond aura préséance.
2007 @node Différentes éditions à partir d'une même source
2008 @subsection Différentes éditions à partir d'une même source
2009 @translationof Different editions from one source
2011 Plusieurs méthodes permettent de générer différentes versions d'une
2012 partition à partir d'une même source. Les variables -- ou
2013 identificateurs -- sont sûrement le moyen le plus simple de combiner de
2014 différente manière des passages relativement longs, alors que les
2015 balises permettront de sélectionner de courts fragments selon leur
2018 Quelle que soit la méthode utilisée, séparer la notation de la structure
2019 de la partition vous donnera plus de liberté dans l'agencement de
2020 l'ouvrage final, puisque vous ne reviendrez pas sur la musique qui le
2024 * Utilisation de variables::
2025 * Utilisation de balises::
2026 * Globalisation des réglages::
2030 @node Utilisation de variables
2031 @unnumberedsubsubsec Utilisation de variables
2032 @translationof Using variables
2034 @cindex variables, utilisation de
2036 Un fragment musical identifié par une variable est réutilisable à divers
2037 endroits de la partition, comme nous l'avons vu à la rubrique
2038 @rlearning{Organisation du code source avec des variables}. Par
2039 exemple, une partition pour chœur @notation{a cappella} comporte souvent
2040 une réduction pour piano reprenant toutes les voix ; il s'agit de
2041 la même musique, et vous ne devrez donc la saisir qu'une seule fois.
2042 D'autre part, la musique issue de deux variables peut se combiner sur
2043 une seule portée, comme nous l'avons vu à la rubrique
2044 @ref{Regroupement automatique de parties}. Prenons l'exemple suivant :
2046 @lilypond[verbatim,quote]
2047 sopranoMusic = \relative c'' { a4 b c b8( a) }
2048 altoMusic = \relative g' { e4 e e f }
2049 tenorMusic = \relative c' { c4 b e d8( c) }
2050 bassMusic = \relative c' { a4 gis a d, }
2051 allLyrics = \lyricmode {King of glo -- ry }
2053 \new Staff = "Soprano" \sopranoMusic
2054 \new Lyrics \allLyrics
2055 \new Staff = "Alto" \altoMusic
2056 \new Lyrics \allLyrics
2057 \new Staff = "Tenor" {
2061 \new Lyrics \allLyrics
2062 \new Staff = "Bass" {
2066 \new Lyrics \allLyrics
2069 \set Staff.printPartCombineTexts = ##f
2075 \set Staff.printPartCombineTexts = ##f
2085 Générer une partition chorale ou la réduction pour piano ne requiert que
2086 de modifier la structure des éléments, sans aucunement toucher à la
2089 Dans le cas d'une partition relativement longue, vous pouvez isoler la
2090 définition des différentes variables dans des fichiers séparés que vous
2091 rappellerez ensuite, comme indiqué à la rubrique
2092 @ref{Insertion de fichiers LilyPond}.
2095 @node Utilisation de balises
2096 @unnumberedsubsubsec Utilisation de balises
2097 @translationof Using tags
2100 @funindex \keepWithTag
2101 @funindex \removeWithTag
2102 @funindex \pushToTag
2103 @funindex \appendToTag
2107 La commande @code{\tag #'@var{partieA}} affecte à une expression
2108 musicale le nom @var{partieA}. Les expressions ainsi balisées pourront
2109 être filtrées par la suite, à l'aide de @code{\keepWithTag #'@var{nom}}
2110 ou @code{\removeWithTag #'@var{nom}}. Ces filtres fonctionnent de la
2113 @multitable @columnfractions .5 .5
2118 Musique balisée précédée de @code{\keepWithTag #'@var{nom}}
2119 @tab Musique non balisée et musique balisée par @var{nom} seront
2120 incluses ; la musique balisée autrement est exclue.
2123 Musique balisée précédée de @code{\removeWithTag #'@var{nom}}
2124 @tab Musique non balisée et fragments appelés autrement que @var{nom}
2125 seront inclus ; la musique balisée par @var{nom} est exclue.
2128 Musique balisée non précédée de @code{\keepWithTag} ou
2129 @code{\removeWithTag}
2130 @tab Musique balisée et non balisée seront incluses.
2134 Les arguments des commandes @code{\tag}, @code{\keepWithTag} et
2135 @code{\removeWithTag} doivent être un symbole (tel que
2136 @code{#'conducteur} ou @code{#'partie}), suivi d'une expression
2139 Dans l'exemple qui suit, nous obtenons deux versions du même extrait,
2140 l'une pour le conducteur, l'autre pour l'instrumentiste qui, elle,
2141 comportera les ornements développés.
2143 @lilypond[verbatim,quote]
2144 music = \relative g' {
2146 \tag #'trills { d8.\trill }
2147 \tag #'expand { \repeat unfold 3 { e32 d } }
2152 \keepWithTag #'trills \music
2155 \keepWithTag #'expand \music
2160 Il est parfois plus aisé d'exclure des fragments :
2162 @lilypond[verbatim,quote]
2163 music = \relative g' {
2165 \tag #'trills { d8.\trill }
2166 \tag #'expand {\repeat unfold 3 { e32 d } }
2171 \removeWithTag #'expand
2175 \removeWithTag #'trills
2180 Ce principe de filtrage peut s'appliquer aux articulations, textes etc.
2181 Il suffit de positionner
2184 -\tag #@var{ma-balise}
2188 avant l'articulation ou le texte, comme ici :
2192 c1-\tag #'gaffe ^"Attention !"
2196 Ceci définira une note avec une indication conditionnelle de doigté ou
2199 Vous pouvez baliser différemment la même expression musicale en
2200 saisissant plusieurs @code{\tag} :
2202 @lilypond[quote,verbatim]
2203 music = \relative c'' {
2204 \tag #'a \tag #'both { a4 a a a }
2205 \tag #'b \tag #'both { b4 b b b }
2208 \keepWithTag #'a \music
2209 \keepWithTag #'b \music
2210 \keepWithTag #'both \music
2214 L'application concomitante de plusieurs filtres @code{\removeWithTag} à
2215 la même expression musicale permet d'exclure plusieurs balisages :
2217 @lilypond[verbatim,quote]
2218 music = \relative c'' {
2219 \tag #'A { a4 a a a }
2220 \tag #'B { b4 b b b }
2221 \tag #'C { c4 c c c }
2222 \tag #'D { d4 d d d }
2231 L'application de plus d'un filtre @code{\keepWithTag} à la même
2232 expression musicale aboutit à l'exclusion de @b{tous} les balisages.
2233 En effet, si le premier filtre exclut tous les autres balisages,
2234 l'application du second exclura les effets du premier.
2236 Il peut arriver que vous ayez besoin de raccorder quelque chose en un
2237 point particulier d'une expression musicale. Les commandes
2238 @code{\pushToTag} et @code{\appendToTag} permettent d'insérer du
2239 matériau, qu'il soit antérieur ou postérieur, à des @code{éléments}
2240 d'une construction musicale existante. La musique séquentielle ou
2241 simultanée comporte assurément des @code{éléments} :
2243 @lilypond[verbatim,quote]
2244 test = { \tag #'here { \tag #'here <<c''>> } }
2247 \pushToTag #'here c'
2248 \pushToTag #'here e'
2249 \pushToTag #'here g' \test
2250 \appendToTag #'here c'
2251 \appendToTag #'here e'
2252 \appendToTag #'here g' \test
2256 Ces deux instructions sont affectées d'une balise, le matériau à
2257 raccorder à chaque instance de la balise, et l'expression balisée.
2258 Ces instructions prennent soin de recopier tout ce qui doit être
2259 modifié, de telle sorte que l'expression @code{\test} originale conserve
2263 Manuel d'initiation :
2264 @rlearning{Organisation du code source avec des variables}.
2266 Manuel de notation :
2267 @ref{Regroupement automatique de parties},
2268 @ref{Insertion de fichiers LilyPond}.
2272 @c This warning is more general than this placement implies.
2273 @c Rests are not merged whether or not they come from tagged sections.
2274 @c Should be deleted? -td
2277 Lorsqu'elles comportent des silences, ceux-ci ne seront pas fusionnés
2278 si vous imprimez une partition avec les deux sections balisées.
2283 @node Globalisation des réglages
2284 @unnumberedsubsubsec Globalisation des réglages
2285 @translationof Using global settings
2287 @cindex include-settings
2289 Vous pouvez regrouper dans un fichier indépendant vos réglages
2290 personnels que vous inclurez au besoin :
2293 lilypond -dinclude-settings=MES_REGLAGES.ly MA_PARTITION.ly
2296 Vous pouvez ainsi stocker dans un fichier séparé vos réglages en matière
2297 de format de papier, de fontes utilisées ou vos définitions
2298 particulières. Selon le fichier de réglages que vous mentionnerez, vous
2299 obtiendrez facilement différentes éditions à partir d'une même source
2300 quelle qu'elle soit.
2302 Cette technique peut s'utiliser en combinaison avec des feuilles de
2303 styles, comme indiqué au chapitre @rlearning{Feuilles de style}.
2306 Manuel d'initiation :
2307 @rlearning{Organisation du code source avec des variables},
2308 @rlearning{Feuilles de style}.
2310 Manuel de notation :
2311 @ref{Insertion de fichiers LilyPond}.
2314 @node Caractères spéciaux
2315 @subsection Caractères spéciaux
2316 @translationof Special characters
2318 @cindex caractères spéciaux
2319 @cindex non-ASCII, caractères
2324 * Équivalents ASCII::
2328 @node Codage du texte
2329 @unnumberedsubsubsec Codage du texte
2330 @translationof Text encoding
2334 LilyPond utilise le jeu de caractères défini par le consortium Unicode
2335 et la norme ISO/CEI 10646. Chaque caractère est identifié par un
2336 nom unique et associé à un point de code, ce qui permet dans l'absolu de
2337 couvrir tous les langages. Unicode permet de coder tous les caractères
2338 utilisés par toutes les langues écrites du monde. LilyPond utilise le
2339 codage UTF-8 (UTF pour @emph{Unicode Transformation Format}) qui permet
2340 de représenter les caractères latins sur un octet et les autres sur une
2341 longueur allant jusqu'à quatre octets.
2343 L'apparence réelle des caractères est déterminée par les glyphes ou
2344 graphèmes tels que définis dans les différentes polices disponibles.
2345 Une police, ou une fonte, définit la mise en correspondance d'un
2346 sous-ensemble de points de code unicode en glyphes. LilyPond recourt à
2347 la bibliothèque Pango pour assurer le rendu des textes multilingues.
2349 LilyPond n'effectue aucune conversion d'encodage que ce soit. Ceci
2350 implique donc que tout texte -- un titre, des paroles ou même une
2351 instruction musicale -- comportant des caractères non ASCII soit
2352 codé en UTF-8. Le plus sûr moyen de saisir du texte de la sorte
2353 consiste à utiliser un éditeur supportant l'unicode et à enregistrer vos
2354 fichier en UTF-8. C'est le cas pour la plupart des éditeurs actuels,
2355 que ce soit vim, Emacs, jEdit et GEdit. Tous les systèmes Windows
2356 postérieurs à NT utilisent Unicode en natif ; même Notepad est
2357 capable d'éditer et sauvegarder un fichier en UTF-8 -- sans parler de
2358 l'excellente alternative qu'est BabelPad.
2360 La compilation d'un fichier LilyPond comportant des caractères non ASCII
2361 qui n'aurait pas été enregistré dans l'encodage UTF-8 vous renverra
2365 FT_Get_Glyph_Name () erreur : invalid argument
2368 Voici un exemple utilisant du texte en cyrillique, en hébreux et en
2372 %c No verbatim here as the code does not display correctly in PDF
2374 bulgarian = \lyricmode {
2375 Жълтата дюля беше щастлива, че пухът, който цъфна, замръзна като гьон.
2379 hebrew = \lyricmode {
2380 זה כיף סתם לשמוע איך תנצח קרפד עץ טוב בגן.
2384 portuguese = \lyricmode {
2385 à vo -- cê uma can -- ção legal
2391 \addlyrics { \bulgarian }
2392 \addlyrics { \hebrew }
2393 \addlyrics { \portuguese }
2398 @unnumberedsubsubsec Unicode
2399 @translationof Unicode
2403 Lorsque vous avez besoin d'un caractère dont vous connaissez le point de
2404 code mais que votre éditeur ne permet pas de saisir directement, vous
2405 pouvez utiliser les instructions @code{\char ##xhhhh} ou
2406 @code{\char #dddd} au sein d'un bloc @code{\markup} -- @code{hhhh}
2407 et @code{dddd} correspondant respectivement à la valeur hexadécimale ou
2408 décimale. Même s'il est inutile de saisir les zéros superflus, il est
2409 de bon ton de stipuler les quatre caractères formant la représentation
2410 hexadécimale. Évitez cependant l'encodage UTF-8 d'un point de code
2411 après un @code{\char} ; les encodages UTF-8 comprennent un bit
2412 supplémentaire indiquant le nombre d'octets. Une table de
2413 correspondance entre les codes Unicode et le nom des caractères ainsi
2414 que leur code hexadécimal est disponible sur le site du consortium
2415 Unicode, @uref{http://www.unicode.org/}.
2417 Par exemple, @code{\char ##x03BE} et @code{\char #958} correspondent
2418 tous deux au caractère unicode U+03BE, dénommé @qq{Greek Small Letter
2421 Quel que soit le point de code spécifié de cette manière, il ne vous
2422 sera alors pas nécessaire d'enregistrer votre fichier en UTF-8. Vous
2423 devrez toutefois disposer d'une fonte contenant ce caractère qui soit
2424 accessible à LilyPond.
2426 L'exemple suivant illustre la manière d'insérer un caractère sous sa
2427 forme hexadécimale, à la fois dans un repère, dans une articulation,
2428 dans des paroles et dans du texte indépendant.
2430 @lilypond[quote,verbatim]
2433 c1 \mark \markup { \char ##x03EE }
2434 c1_\markup { \tiny { \char ##x03B1 " to " \char ##x03C9 } }
2436 \addlyrics { O \markup { \concat { Ph \char ##x0153 be! } } }
2438 \markup { "Copyright 2008--2012" \char ##x00A9 }
2443 Le signe @emph{copyright} dans le champ de titrage consacré s'inscrit de
2444 la manière suivante :
2448 copyright = \markup @{ \char ##x00A9 "2008" @}
2453 @node Équivalents ASCII
2454 @unnumberedsubsubsec Équivalents ASCII
2455 @translationof ASCII aliases
2457 Dès lors que vous aurez inclus la liste de leur équivalent ASCII,
2458 LilyPond reconnaîtra un certain nombre de caractères spéciaux :
2460 @lilypond[quote,verbatim]
2462 #(include-special-characters)
2465 \markup "&flqq; – &OE;uvre incomplète… &frqq;"
2468 \new Staff { \repeat unfold 9 a'4 }
2470 This is al -- so wor -- kin'~in ly -- rics: –_&OE;…
2475 "The replacement can be disabled:"
2476 "– &OE; …"
2477 \override #'(replacement-alist . ()) "– &OE; …"
2481 L'extension de cette liste est possible aussi bien de manière globale :
2483 @lilypond[quote,verbatim]
2485 #(add-text-replacements!
2486 '(("100" . "hundred")
2487 ("dpi" . "dots per inch")))
2489 \markup "A 100 dpi."
2492 qu'en un point particulier de votre source :
2494 @lilypond[quote,verbatim]
2495 \markup \replace #'(("100" . "hundred")
2496 ("dpi" . "dots per inch")) "A 100 dpi."
2500 Manuel de notation :
2501 @ref{Liste des caractères spéciaux}.
2503 Fichiers d'initialisation :
2504 @file{ly/text-replacements.ly}.
2507 @node Contrôle des sorties
2508 @section Contrôle des sorties
2509 @translationof Controlling output
2512 * Extraction de fragments musicaux::
2513 * Ignorer des passages de la partition::
2514 * Formats de sortie alternatifs::
2515 * Changement des fontes musicales::
2519 @node Extraction de fragments musicaux
2520 @subsection Extraction de fragments musicaux
2521 @translationof Extracting fragments of music
2523 LilyPond permet d'extraire des fragments d'une partition à l'instar du
2524 choriste amateur qui alimente son album avec des coupures de journaux.
2526 Vous devrez pour cela définir les mesures à découper. La définition
2527 suivante, incluse dans votre fichier source,
2534 (make-rhythmic-location 5 1 2)
2535 (make-rhythmic-location 7 3 4)))
2540 vous permettra d'extraire un fragment compris entre le milieu de la
2541 cinquième mesure et quelque part dans la septième. Le triplet
2542 @code{5 1 2} signifie : après la durée d'une blanche dans la mesure 5 ;
2543 le @code{7 3 4} signifie quant à lui que l'on s'arrête à la mesure 7,
2544 après la durée de trois noires.
2546 Rien ne vous empêche d'extraire plusieurs fragments, dès lors que vous
2547 définissez dans la liste d'autres paires d'emplacements rythmiques.
2549 Cette fonctionnalité n'est toutefois effective que lorsque vous lancez
2550 LilyPond avec l'option @w{@code{-dclip-systems}}. Les @qq{coupures}
2551 seront générées sous la forme de fichiers EPS, convertis en PDF ou PNG
2552 selon le format que vous aurez stipulé.
2554 Pour de plus amples informations quant au format des résultats,
2555 consultez le chapitre @rprogram{Lancement de lilypond}.
2558 @node Ignorer des passages de la partition
2559 @subsection Ignorer des passages de la partition
2560 @translationof Skipping corrected music
2562 @funindex skipTypesetting
2563 @funindex showFirstLength
2564 @funindex showLastLength
2566 Dans un travail de transcription ou de recopie de la musique, ce qui
2567 vous intéresse plus particulièrement se situe à la fin, là même où vous
2568 en êtes dans la notation. Dans le but de gagner du temps dans le
2569 processus de correction, vous pouvez @qq{escamoter} le reste et ne
2570 générer que les dernières mesures en insérant
2573 showLastLength = R1*5
2578 dans votre fichier source. Ceci aura pour effet de ne générer que les
2579 cinq dernières mesures -- si tant est que le morceau soit à 4/4 -- de
2580 tous les @code{\score} de votre fichier. Dans le cas d'un œuvre
2581 conséquente, cette pratique s'avère fort utile puisqu'elle évite de tout
2582 générer. Vous pourriez aussi être amené à retravailler le début d'une
2583 œuvre, pour y ajouter une partie par exemple, auquel cas c'est la
2584 propriété @code{showFirstLength} que vous utiliserez.
2586 Vous pouvez contrôler très finement les parties à escamoter, grâce au
2587 commutateur @code{Score.skipTypesetting} : lorsqu'il est activé,
2588 aucune gravure n'est réalisée.
2590 Ce commutateur agit aussi sur la sortie MIDI. Notez bien que tous les
2591 événements seront escamotés, y compris les changements de tempo ou
2592 d'instrument -- vous voilà prévenu !
2594 @lilypond[quote,relative=2,ragged-right,verbatim]
2596 \set Score.skipTypesetting = ##t
2598 \set Score.skipTypesetting = ##f
2602 Dans le cadre de musique polyphonique, @code{Score.skipTypesetting}
2603 s'applique à toutes les voix et portées. Vous gagnerez donc encore plus
2607 @node Formats de sortie alternatifs
2608 @subsection Formats de sortie alternatifs
2609 @translationof Alternative output formats
2611 @cindex scalable vector graphics
2612 @cindex SVG, format de sortie
2613 @cindex encapsulated postscript
2614 @cindex EPS, format de sortie
2616 En matière de partition imprimable, LilyPond génère par défaut des
2617 documents au format PostScript (PS) et Portable Document Format (PDF).
2618 Vous pouvez aussi obtenir des documents au format Scalable Vector
2619 Graphics (SVG), Encapsulated PostScript (EPS) ou Portable Network
2620 Graphics (PNG) dès lors que vous aurez lancé LilyPond en ligne de
2621 commande avec l'option @i{ad hoc} -- voir
2622 @rprogram{Utilisation en ligne de commande} à ce sujet.
2625 @node Changement des fontes musicales
2626 @subsection Changement des fontes musicales
2627 @translationof Replacing the notation font
2629 Gonville est une alternative à la fonte Feta que LilyPond utilise par
2630 défaut. Vous pouvez la télécharger à partir de
2632 @uref{http://www.chiark.greenend.org.uk/~sgtatham/gonville/ ,http://www.chiark.greenend.org.uk/~sgtatham/gonville/}
2635 Voici quelques mesures utilisant la police Gonville :
2637 @c NOTE: these images are a bit big, but that's important
2638 @c for the font comparison. -gp
2639 @sourceimage{Gonville_after,,,}
2641 Et ces même mesures avec la police de LilyPond, Feta :
2643 @sourceimage{Gonville_before,,,}
2646 @subsubheading Instructions d'installation pour MacOS
2647 @translationof Installation Instructions for MacOS
2649 Téléchargez puis décompressez l'archive zip. Recopiez le répertoire
2650 @code{lilyfonts} dans @file{@var{SHARE_DIR}/lilypond/current} -- voir
2651 @rlearning{Autres sources de documentation} à ce sujet. Renommez le
2652 répertoire @code{fonts} qui s'y trouve en @code{fonts_orig}, puis le
2653 répertoire @code{lilyfonts} en @code{fonts}. Il vous suffira, pour
2654 retrouver la fonte Feta, de renommer @code{fonts_orig} en @code{fonts}.
2657 Manuel d'initiation :
2658 @rlearning{Autres sources de documentation}.
2661 Gonville ne permet pas de générer de la notation ancienne, et certains
2662 glyphes ajoutés depuis lors aux jeux de caractères en soient absent.
2663 Consultez le site de l'auteur pour de plus amples informations ainsi
2664 qu'à propos des conditions d'utilisation.
2668 @section Sortie MIDI
2669 @translationof MIDI output
2674 MIDI (Musical Instrument Digital Interface) constitue un standard en
2675 matière de connexion et de contrôle des instruments électroniques. Un
2676 fichier MIDI contient une série de notes réparties dans différentes
2677 pistes. Il ne s'agit en rien d'un fichier sonore ; il vous faudra
2678 un logiciel capable de traduire ces séries de notes en sons réels.
2680 Vous pouvez convertir vos partition en fichier MIDI de manière à
2681 entendre ce que vous avez saisi. Ceci vous permet de contrôler aisément
2682 ce que vous avez saisi : octaves et altérations erronées heurteront
2683 votre oreille avertie grâce au MIDI.
2685 Le fichier MIDI généré par LilyPond est relativement brut. Vous pouvez
2686 cependant obtenir un meilleur rendu avec @ref{Le script Articulate}.
2688 Dans une sortie MIDI, LilyPond alloue un canal à chaque portée, tout en
2689 réservant le canal 10 aux percussions. Dans la mesure ou un
2690 périphérique MIDI ne comprend que 16 canaux, un fichier MIDI qui
2691 comportera plus de quinze portées verra le même canal réutilisé.
2694 * Création de fichiers MIDI::
2696 * Contenu de la sortie MIDI::
2697 * Répétitions et MIDI::
2698 * Gestion des nuances en MIDI::
2699 * MIDI et percussions::
2700 * Le script Articulate::
2704 @node Création de fichiers MIDI
2705 @subsection Création de fichiers MIDI
2706 @translationof Creating MIDI files
2708 LilyPond générera un fichier MIDI dès que vous ajouterez un bloc
2709 @code{\midi} à la structure de votre partition, comme ici :
2718 Lorsque le bloc @code{\score} contient un bloc @code{\midi} mais pas de
2719 bloc @code{\layout}, LilyPond ne produira qu'une sortie MIDI. Si donc
2720 vous avez besoin aussi d'un support visuel, vous devrez aussi mentionner
2721 un bloc @code{\layout}.
2731 Hauteurs, durées, liaisons de prolongation, nuances et changements de
2732 tempo seront interprétés et traduits en événements MIDI. Les
2733 indications de nuances, crescendos et decrescendos sont traduits en
2734 niveau de volume ; les indications sous la forme d'une fraction
2735 déterminée du volume disponible, et crescendos et decrescendos sous la
2736 forme d'une progression linéaire entre les deux extrêmes. Le rendu des
2737 indications de nuance peut être désactivé pour le MIDI -- voir
2740 Le tempo initial ainsi que ses changements sont normalement indiqués au
2741 fil de la notation à l'aide de la commande @code{\tempo} ; ils seront
2742 retranscrits dans le fichier MIDI. La commande @code{\tempo} donne lieu
2743 à l'impression d'une indication métronomique que vous pouvez toutefois
2744 rendre invisible, comme indiqué à la rubrique
2745 @ref{Indication métronomique}. Une autre manière de spécifier le tempo
2746 initial pour un fichier MIDI est indiquée plus avant -- voir
2749 En raison de certaines limitations de Windows, les fichiers MIDI doivent
2750 y porter l'extension @code{.mid}. D'autres systèmes utilisent
2751 l'extension @code{.midi}. Si besoin est, placez la ligne suivante au
2752 début de votre fichier source, avant l'ouverture de tout bloc
2753 @code{\book}, @code{\bookpart} ou @code{\score} :
2756 #(ly:set-option 'midi-extension "midi")
2759 Cette ligne déterminera @code{.midi} comme extension par défaut pour les
2762 Vous pouvez aussi le faire en ligne de commande :
2765 lilypond … -dmidi-extension=midi fichierLily.ly
2769 @unnumberedsubsubsec Noms d'instrument
2770 @translationof Instrument names
2772 @cindex instrument, nom d'
2773 @funindex Staff.midiInstrument
2775 L'instrument MIDI affecté à un canal particulier est déterminé par la
2776 propriété @code{Staff.midiInstrument}. Vous pouvez choisir l'un des
2777 instruments répertoriés à l'annexe @ref{Instruments MIDI}.
2781 \set Staff.midiInstrument = #"glockenspiel"
2787 \new Staff \with @{midiInstrument = #"cello"@} @{
2792 Lorsque l'instrument choisi ne correspond pas exactement à l'une des
2793 dénominations consacrées, LilyPond le replacera par un piano de concert
2794 (@code{"acoustic grand"}).
2797 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
2798 {changing-midi-output-to-one-channel-per-voice.ly}
2801 @c In 2.11 the following no longer seems to be a problem -td
2803 Un (de)crescendo non terminé ne sera pas correctement rendu en MIDI --
2804 il y a nécessairement du silence. Il vous faut donc lui donner une fin
2805 explicite. Par exemple,
2812 ne fonctionnera pas correctement, contrairement à
2815 @{ a4\< b c d\!\f @}
2819 Un changement de volume ne peut intervenir que sur le démarrage d'une
2820 note. C'est la raison pour laquelle la succession d'un crescendo et
2821 d'un diminuendo ne peut se produire sur une même note.
2823 Certains lecteurs MIDI ne rendent pas correctement les changements de
2824 tempo. MS Windows Media Player et
2825 @uref{http://@/timidity@/.sourceforge@/.net/,timidity} le font sans
2830 @subsection Le bloc MIDI
2831 @translationof MIDI block
2833 Dès lors que vous désirez obtenir une sortie MIDI, vous devrez inscrire
2834 un bloc @code{\midi} au sein du bloc @code{\score}. Son fonctionnement
2835 est comparable à ce lui du bloc @code{\layout}, voire plus simple. Si
2836 le bloc @code{\midi} est la plupart du temps laissé vide, il peut
2837 contenir des aménagements pour certains contextes, la définition de
2838 contextes particuliers ou du code permettant de déterminer la valeur de
2839 certaines propriétés. L'exemple suivant détermine le tempo initial du
2840 fichier MIDI tout en se passant de son indication sur la partition
2852 Ici, le tempo est fixé à 72 noires à la minute. Spécifier un tempo de
2853 la sorte ne permet pas de donner une valeur pour une note pointée. Vous
2854 devrez, en pareil cas, subdiviser la note pointée en durée plus courte.
2855 Par exemple, indiquer 90 à la noire pointée est équivalent à spécifier
2856 270 croches à la minute :
2859 tempoWholesPerMinute = #(ly:make-moment 270 8)
2862 @cindex MIDI et définition de contexte
2863 @cindex contexte, définition en MIDI
2865 La syntaxe permettant de définir un contexte pour le @code{\midi} est en
2866 tout point identique à celle que vous utilisez dans le bloc
2867 @code{\layout}, à ceci près que le @qq{graveur} est remplacé par un
2868 @qq{interprète}. Les différents contextes disponibles en matière de
2869 MIDI sont répertoriés dans le fichier d'initialisation
2870 @file{../ly/performer-init.ly} -- pour plus de détail, voir
2871 @rlearning{Autres sources de documentation}.
2872 Si vous voulez vous passer des nuances dans votre fichier MIDI, il vous
2873 suffit d'insérer les lignes suivantes dans votre bloc
2881 \remove "Dynamic_performer"
2886 LilyPond ne générera de sortie MIDI que si vous incluez un bloc
2887 @code{\midi} dans la structure de la partition, initialisée par la
2888 commande @code{\score}.
2892 @{ @dots{}notes@dots{} @}
2898 @node Contenu de la sortie MIDI
2899 @subsection Contenu de la sortie MIDI
2900 @translationof What goes into the MIDI output?
2902 @c TODO Check grace notes - timing is suspect?
2905 @unnumberedsubsubsec Éléments pris en compte dans le MIDI
2906 @translationof Supported in MIDI
2908 @cindex hauteurs en MIDI
2909 @cindex MIDI, hauteurs
2910 @cindex quart de ton en MIDI
2911 @cindex MIDI, quart de ton
2912 @cindex microtonalité en MIDI
2913 @cindex MIDI, microtonalité
2914 @cindex accords nommés en MIDI
2915 @cindex MIDI, accords nommés
2916 @cindex Rythme en MIDI
2917 @cindex MIDI, Rythme
2918 @cindex articulations et MIDI
2919 @cindex MIDI et articulations
2920 @cindex trilles et MIDI
2921 @cindex MIDI et trilles
2924 Un fichier MIDI généré par LilyPond comprendra les éléments de notation
2932 les microtonalités -- voir @ref{Altérations}. Leur rendu nécessite
2933 cependant un lecteur qui prenne en charge la modulation ;
2936 les accords nommés ;
2939 le rythme en tant que durée de note, y compris les nolets ;
2942 les trémolos, exceptés ceux utilisant la syntaxe
2943 @qq{@code{:}[@var{nombre}]} ;
2946 les liaisons de prolongation ;
2949 les indications de nuance ;
2952 les crescendos et decrescendos s'étalant sur plusieurs notes ;
2955 les changements de tempo indiqués par un @code{\tempo} ;
2961 Si vous utilisez @ref{Le script Articulate}, d'autres éléments seront
2965 @item articulations (lié, staccato, etc.),
2966 @item trilles et groupettos,
2967 @item rallentando et accelerando.
2971 @unnumberedsubsubsec Éléments non pris en compte dans le MIDI
2972 @translationof Unsupported in MIDI
2974 @c TODO index as above
2976 LilyPond ne peut générer d'événement MIDI pour les éléments
2977 suivant, sauf à utiliser @ref{Le script Articulate} :
2981 le rythme indiqué sous forme d'annotation (par ex. @emph{swing}) ;
2984 les changements de tempo indiqués sous forme d'annotation (sans
2988 les staccatos et autres articulations ou ornementations ;
2991 les liaisons d'articulation et de phrasé ;
2994 les crescendos ou decrescendos sur une seule note ;
2997 les trémolos indiqués par la syntaxe @qq{@code{:}[@var{nombre}]} ;
3003 les accords en microtonalité.
3007 @node Répétitions et MIDI
3008 @subsection Répétitions et MIDI
3009 @translationof Repeats in MIDI
3011 @cindex reprises développées
3012 @cindex MIDI et reprises
3013 @funindex \unfoldRepeats
3015 Au prix de quelques réglages, les reprises de toutes sortes peuvent être
3016 rendues dans le fichier MIDI. Il suffit pour cela de recourir à la
3017 fonction @code{\unfoldRepeats}, qui développe toutes les reprises. En
3018 d'autre termes, @code{\unfoldRepeats} transforme toutes les reprises
3019 en reprises de type @code{unfold}.
3022 @lilypond[quote,verbatim]
3024 \repeat tremolo 8 {c'32 e' }
3025 \repeat percent 2 { c''8 d'' }
3026 \repeat volta 2 {c'4 d' e' f'}
3035 Dans une partition comportant plusieurs voix, le développement des
3036 reprises ne sera effectif en MIDI qu'à la condition que ces reprises
3037 soient mentionnée correctement dans @strong{toutes} les voix.
3039 Lorsque l'on veut utiliser @code{\unfoldRepeats} seulement pour le rendu
3040 MIDI, il faut établir deux blocs @code{\score} : un pour le MIDI,
3041 avec des reprises explicites, et l'autre pour la partition, avec des
3042 reprises notées sous forme de barres de reprise, de trémolo ou de
3043 symboles de pourcentage. Par exemple
3051 \unfoldRepeats @var{..musique..}
3057 @node Gestion des nuances en MIDI
3058 @subsection Gestion des nuances en MIDI
3059 @translationof Controlling MIDI dynamics
3061 Les nuances MIDI sont générées par le @code{Dynamic_performer}, affecté
3062 par défaut au contexte @code{Voice}. Vous pouvez contrôler à la fois le
3063 volume général, celui des indications de nuance ainsi que celui des
3064 différents instruments.
3067 @unnumberedsubsubsec Indications de nuance
3068 @translationof Dynamic marks
3070 Les indications de nuances sont transcrites en fraction du volume MIDI.
3071 Nous allons, par défaut, de 0,25 pour un @notation{ppppp} à 0,95 pour un
3072 @notation{fffff}. Les correspondances entre nuance et fraction de
3073 volume sont répertoriées dans le fichier @file{../scm/midi.scm} --
3074 consultez la rubrique @rlearning{Autres sources de documentation} si
3075 vous ne savez comment le localiser. Vous pouvez modifier ou étendre ce
3076 jeu grâce à une fonction qui prendra en argument une indication de
3077 nuance et renverra la fraction désirée, puis en affectant cette fonction
3078 à @code{Score.dynamicAbsoluteVolumeFunction}.
3080 Prenons un exemple. Votre partition comporte un @notation{rinforzando}
3081 que vous avez indiqué par @code{\rfz}. Cette indication de nuance
3082 n'étant pas répertoriée dans le jeu par défaut, elle ne produira aucun
3083 effet en MIDI. Il en sera d'ailleurs de même pour toute indication
3084 créée de toute pièce à l'aide de l'instruction
3085 @w{@code{make-dynamic-script}}. Voici comment procéder pour ajuster le
3086 volume MIDI de ce @notation{rinforzando} que le compositeur a indiqué.
3087 La fonction Scheme définit une fraction de 0,9 en cas de @notation{rfz},
3088 et demande d'utiliser la fonction par défaut dans les autre cas.
3090 @lilypond[verbatim,quote]
3091 #(define (myDynamics dynamic)
3092 (if (equal? dynamic "rfz")
3094 (default-dynamic-absolute-volume dynamic)))
3098 \set Staff.midiInstrument = #"cello"
3099 \set Score.dynamicAbsoluteVolumeFunction = #myDynamics
3111 Si vous étiez amené à devoir modifier l'intégralité du jeu des
3112 correspondances, nous vous conseillons d'utiliser la procédure
3113 @command{default-dynamic-absolute-volume} contenue dans le fichier
3114 @file{../scm/midi.scm} ainsi que la table d'association comme base.
3115 Le dernier exemple de cette partie illustre la manière de procéder.
3118 @unnumberedsubsubsec Amplitude du volume en MIDI
3119 @translationof Overall MIDI volume
3121 Les valeurs extrêmes du volume MIDI des nuances se contrôlent à l'aide
3122 des propriétés @code{midiMinimumVolume} et @code{midiMaximumVolume} qui
3123 agissent au niveau @code{Score}. Ces propriétés sont effectives dès
3124 lors qu'une nuance est indiquée ; une nuance de départ est donc
3125 requise pour que le volume soit ajusté dès le début de la partition.
3126 Vous pouvez alors modifier la fraction correspondant à chaque nuance à
3127 l'aide de la formule
3130 midiMinimumVolume + (midiMaximumVolume - midiMinimumVolume) * fraction
3133 Voici comment ajuster les nuances tout en limitant l'amplitude du volume
3136 @lilypond[verbatim,quote]
3142 \set Staff.midiInstrument = #"flute"
3143 \new Voice \relative c''' {
3151 \set Staff.midiInstrument = #"clarinet"
3152 \new Voice \relative c'' {
3163 tempoWholesPerMinute = #(ly:make-moment 72 2)
3164 midiMinimumVolume = #0.2
3165 midiMaximumVolume = #0.5
3172 @unnumberedsubsubsec Égalisation de plusieurs instruments (i)
3173 @translationof Equalizing different instruments (i)
3175 La définition de l'amplitude du volume MIDI au niveau d'un contexte
3176 @code{Staff} permet de gérer les volumes relatifs entre les différents
3177 instruments. Ceci constitue en quelque sorte un égaliseur, ce qui
3178 permet d'améliorer notablement la qualité de la sortie MIDI.
3180 La clarinette de l'exemple suivant jouera relativement moins fort que la
3181 flûte. Rappelez-vous que pour que cela fonctionne correctement, la
3182 première note de chacun des instruments doit être affublée d'une
3183 indication de nuance.
3185 @lilypond[verbatim,quote]
3191 \set Staff.midiInstrument = #"flute"
3192 \set Staff.midiMinimumVolume = #0.7
3193 \set Staff.midiMaximumVolume = #0.9
3194 \new Voice \relative c''' {
3202 \set Staff.midiInstrument = #"clarinet"
3203 \set Staff.midiMinimumVolume = #0.3
3204 \set Staff.midiMaximumVolume = #0.6
3205 \new Voice \relative c'' {
3220 @unnumberedsubsubsec Égalisation de plusieurs instruments (ii)
3221 @translationof Equalizing different instruments (ii)
3223 Lorsque les propriétés volume minimum et maximum n'ont pas été définies,
3224 LilyPond appliquera par défaut une légère égalisation pour quelques
3225 instruments. Les instrument concernés ainsi que le niveau d'égalisation
3226 sont répertoriés dans une table @notation{instrument-equalizer-alist}
3227 du fichier @file{../scm/midi.scm}.
3229 Vous pouvez remplacer l'égaliseur basique en définissant une nouvelle
3230 procédure Scheme @code{instrumentEqualizer} au sein du contexte
3231 @code{Score}. Cette procédure prend en unique argument le nom d'un
3232 instrument MIDI et renverra une paire de fractions correspondant au
3233 minimum et maximum de volume alloué à cet instrument. Cette
3234 substitution fonctionne selon le même principe que celui que nous avons
3235 vu en début de chapitre avec @code{dynamicAbsoluteVolumeFunction}.
3236 L'égaliseur par défaut, @notation{default-instrument-equalizer}, est
3237 défini dans le fichier @file{../scm/midi.scm} ; son analyse vous
3238 aidera à construire votre propre procédure.
3240 Nous allons, dans l'exemple suivant, régler le volume relatif de la
3241 flûte et de la clarinette -- au même niveau que dans le précédent.
3243 @lilypond[verbatim,quote]
3244 #(define my-instrument-equalizer-alist '())
3246 #(set! my-instrument-equalizer-alist
3249 ("flute" . (0.7 . 0.9))
3250 ("clarinet" . (0.3 . 0.6)))
3251 my-instrument-equalizer-alist))
3253 #(define (my-instrument-equalizer s)
3254 (let ((entry (assoc s my-instrument-equalizer-alist)))
3263 \set Score.instrumentEqualizer = #my-instrument-equalizer
3264 \set Staff.midiInstrument = #"flute"
3265 \new Voice \relative c''' {
3273 \set Staff.midiInstrument = #"clarinet"
3274 \new Voice \relative c'' {
3289 @c Delete when satisfied this is adequately covered elsewhere -td
3291 @n ode Microtones in MIDI
3292 @s ubsection Microtones in MIDI
3294 @cindex microtones in MIDI
3296 Microtones consisting of half sharps and half flats are exported
3297 to the MIDI file and render correctly in MIDI players which support
3298 pitch bending. See @ref{Note names in other languages}. Here is
3299 an example showing all the half sharps and half flats. It can be
3300 copied out and compiled to test microtones in your MIDI player.
3302 @lilypond[verbatim,quote]
3319 @node MIDI et percussions
3320 @subsection MIDI et percussions
3321 @translationof Percussion in MIDI
3323 La notation pour percussions recourt généralement à un contexte
3324 particulier -- le @code{DrumStaff} -- qui permet d'affecter directement
3325 les instruments concernés au canal 10 qui leur est réservé.
3327 Certains instruments, tels le xylophone, le marimba, le vibraphone ou
3328 les timbales, se traitent cependant comme des instruments
3329 @qq{classiques} puisqu'ils sont capables d'émettre des hauteurs
3330 différentes ; leurs notation relève donc d'un contexte @code{Staff}
3331 standard, et non d'un @code{DrumStaff} pour pouvoir être rendus
3332 correctement en MIDI.
3334 D'autres percussions, bien que n'émettant qu'un seul son et inclus dans
3335 le standard @emph{general MIDI}, comme le tom mélodique ou le tambour
3336 taiko, ne sont pas attachés au canal 10. Ces instruments doivent
3337 donc être saisi dans un contexte @code{Staff}, en utilisant la hauteur
3340 De nombreux instruments de la famille des percussions, les castagnettes
3341 par exemple, n'existent pas dans le standard @emph{general MIDI}.
3342 L'alternative, bien que peu satisfaisante, consiste à leur attribuer le
3343 son le plus proche dans la banque standard.
3345 @c TODO Expand with examples, and any other issues
3348 Le standard @emph{general MIDI} ne dispose pas du @emph{rim shot} ;
3349 LilyPond lui substitue un @emph{sidestick}.
3352 @node Le script Articulate
3353 @subsection Le script Articulate
3354 @translationof The Articulate script
3356 Vous obtiendrez un rendu MIDI plus @qq{réaliste} grâce au script
3357 @code{articulate}. Celui-ci va tout faire pour d'une part prendre en
3358 compte les articulations (liaisons, staccato etc.) -- en ajoutant un
3359 blanc aux notes raccourcies -- et, d'autre part, développer les trilles
3360 ou groupettos ainsi que tenir compte des éventuels rallentando et
3363 L'utilisation du script @code{articulate} se fait en deux temps. Vous
3364 devez dans un premier temps inclure son fichier d'initialisation en
3365 ajoutant en tête de votre fichier la ligne
3368 \include "articulate.ly"
3371 puis, dans le bloc @code{\score}, indiquer que toutes les répétitions
3372 seront développées et appliquer la commande à votre musique :
3375 \unfoldRepeats \articulate <<
3376 tout le reste du bloc contenant la partition...
3380 Une fois votre fichier modifié de la sorte, vous constaterez que la
3381 version imprimable aura été modifiée en profondeur. Le bloc
3382 @code{\midi} produira par contre un fichier MIDI de bien meilleure
3385 Bien que cela ne gène en rien le fonctionnement du script
3386 @code{articulate}, lui adjoindre la commande @code{\unfoldRepeats} comme
3387 illustré ci-dessus permettra le rendu d'un certain nombre
3388 d'articulations tels les trilles.
3391 Dans la mesure où le script @code{articulate} tend à raccourcir les
3392 accords, certaines musiques, notamment pour l'orgue, paraîtront de moins
3396 @node Extraction d'informations musicales
3397 @section Extraction d'informations musicales
3398 @translationof Extracting musical information
3400 En plus de générer du graphisme et du MIDI, LilyPond peut présenter
3401 l'information musicale sous forme textuelle.
3404 * Affichage de notation au format LilyPond::
3405 * Affichage de la musique sous forme d'expression Scheme::
3406 * Enregistrement d'événements musicaux dans un fichier::
3410 @node Affichage de notation au format LilyPond
3411 @subsection Affichage de notation au format LilyPond
3412 @translationof Displaying LilyPond notation
3414 @funindex \displayLilyMusic
3416 La fonction musicale @code{\displayLilyMusic} permet d'afficher en
3417 notation LilyPond une expression musicale. Le résultat défilera dans le
3418 terminal après avoir lancé LilyPond en ligne de commande. Par exemple,
3422 \displayLilyMusic \transpose c a, @{ c4 e g a bes @}
3429 @{ a,4 cis e fis g @}
3432 LilyPond affichera le résultat sous forme de message en console, au
3433 milieu de toutes les informations de compilation. Afin d'isoler ces
3434 messages et enregistrer le résultat de la fonction
3435 @code{\display@{MATÉRIAU@}}, pensez à rediriger la sortie vers un
3439 lilypond fichier.ly > affichage.txt
3444 Vous noterez que LilyPond ne se contente pas de simplement afficher
3445 l'expression musicale, mais procède aussi à son interprétation -- du
3446 fait que @code{\displayLilyMusic} renvoie l'expression tout en
3447 l'affichant. S'il est bien pratique d'insérer un
3448 @code{\displayLilyMusic} dans une expression musicale pour en obtenir
3449 des informations, l'interprétation de cette expression peut toutefois
3450 être évitée en ajoutant un @code{\void} avant l'instruction :
3454 \void \displayLilyMusic \transpose c a, @{ c4 e g a bes @}
3459 @node Affichage de la musique sous forme d'expression Scheme
3460 @subsection Affichage de la musique sous forme d'expression Scheme
3461 @translationof Displaying scheme music expressions
3463 Voir @rextend{Affichage d'expressions musicales}.
3466 @node Enregistrement d'événements musicaux dans un fichier
3467 @subsection Enregistrement d'événements musicaux dans un fichier
3468 @translationof Saving music events to a file
3470 LilyPond vous permet de sauvegarder dans un fichier séparé, sur la base
3471 de la portée, les événements musicaux. Vous devrez pour ce faire
3472 inclure dans votre fichier maître un fichier d'initialisation
3476 \include "event-listener.ly"
3479 Pour chaque portée que comporte votre partition, vous obtiendrez un
3480 fichier @file{NOMFICHIER-PORTÉENOMMÉE.notes} ou
3481 @file{NOMFICHIER-unnamed-staff.notes}. Notez bien que si plusieurs
3482 portées ne sont pas explicitement nommées, tous leurs événements seront
3483 regroupés et mélangés dans le même fichier. Le résultat ressemblera à
3487 0.000 note 57 4 p-c 2 12
3489 0.250 note 62 4 p-c 7 12
3490 0.500 note 66 8 p-c 9 12
3491 0.625 note 69 8 p-c 14 12
3496 Il s'agit d'un tableau dont les colonnes sont délimitées par une
3497 tabulation. Chaque ligne comporte deux champs fixes suivis d'un certain
3498 nombre de paramètres optionnels.
3501 @var{temps} @var{type} @var{...paramètres...}
3504 Ces informations peuvent faire l'objet d'un retraitement par d'autres
3505 programmes, comme des scripts python, aux fins de recherche en analyse
3506 musicologique ou des expériences à partir du rendu de LilyPond.
3509 Tous les événements ne sont pas pris en charge par
3510 @file{event-listener.ly}. Il s'agit en premier lieu d'une
3511 démonstration, un @qq{proof of concept} du potentiel de LilyPond. Si
3512 certains des éléments que vous cherchez à obtenir n'apparaissent pas,
3513 recopiez le fichier @file{event-listener.ly} dans votre répertoire et
3514 modifiez-le de telle sorte qu'il travaille selon vos attentes.