1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
4 Translation of GIT committish: f77212d801fa4603bf596a19cecf5a068f1d9d85
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
25 * Agencement du code::
27 * Travail sur des fichiers texte::
28 * Contrôle des sorties::
32 @node Agencement du code
33 @section Agencement du code
34 @translationof Input structure
36 LilyPond traite des fichiers textuels. Ces fichiers portent par
37 convention une extension @code{.ly}.
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::
48 @node Structure d'une partition
49 @subsection Structure d'une partition
50 @translationof Structure of a score
54 Un bloc @code{\score} contient obligatoirement une seule expression
55 musicale délimitée par des accolades@tie{}:
63 @warning{Il ne doit y avoir qu'@strong{une seule} expression musicale
64 globale dans un bloc @code{@bs{}score}, et elle @strong{doit} être
65 bornée par une paire d'accolades.}
67 Cette unique expression musicale peut être de n'importe quelle taille et
68 contenir d'autres expressions musicales aussi complexes soient elles.
69 Voici quelques exemples d'expression musicale@tie{}:
75 @lilypond[verbatim,quote]
82 @lilypond[verbatim,quote]
84 \new Staff { c'4 c' c' c' }
85 \new Staff { d'4 d' d' d' }
93 \new Staff @{ \flute @}
94 \new Staff @{ \hautbois @}
97 \new Staff @{ \violonI @}
98 \new Staff @{ \violonII @}
104 Les commentaires constituent l'une des rares exceptions à cette règle
105 immuable -- voir @ref{Structure de fichier} pour les autres. Qu'il
106 s'agisse d'une seule ligne ou de tout un bloc -- délimité par @code{%@{
107 .. %@}} -- un commentaire peut se placer n'importe où dans le fichier
108 source, aussi bien à l'intérieur qu'à l'extérieur du bloc @code{\score},
109 ou encore à l'intérieur ou à l'extérieur de l'expression musicale
110 contenue dans un bloc @code{\score}.
112 Lorsqu'un fichier ne comprend qu'un bloc @code{\score}, celui-ci est
113 implicitement inclus dans un bloc @code{\book}. Le bloc @code{\book}
114 d'un fichier source permet la production d'au moins un fichier dont le
115 nom sera, par défaut, déduit du fichier source@tie{}: le traitement de
116 @file{fandangopourelephants.ly} produira donc
117 @file{fandangopourelephants.pdf}. Pour de plus amples informations à
118 propos du bloc @code{\book}, lisez
119 @ref{Plusieurs partitions dans un même ouvrage},
120 @ref{Plusieurs éditions pour une même source} et
121 @ref{Structure de fichier}.
124 Manuel d'initiation :
125 @rlearning{Travail sur les fichiers d'entrée},
126 @rlearning{Les expressions musicales en clair},
127 @rlearning{La partition est une (unique) expression musicale composée}.
130 @node Plusieurs partitions dans un même ouvrage
131 @subsection Plusieurs partitions dans un même ouvrage
132 @translationof Multiple scores in a book
134 @cindex mouvements, plusieurs
135 @cindex plusieurs mouvements
139 Un ouvrage peut se composer de plusieurs morceaux et de texte. C'est le
140 cas des cahiers d'exercices ou d'une partie d'orchestre avec ses
141 différents mouvements. Chaque mouvement fait l'objet d'un bloc
150 et le texte est contenu dans un bloc @code{\markup},
160 Les différents mouvements et textes qui apparaissent dans un même
161 fichier @file{.ly} ne composeront en principe qu'un seul fichier
176 Attention cependant si vous travaillez avec lilypond-book@tie{}: il vous
177 faudra explicitement mentionner le bloc @code{\book}, en l'absence de
178 quoi seul le premier @code{\score} ou @code{\markup} apparaîtra après
181 L'entête de chaque pièce peut se placer au sein du bloc
182 @code{\score}@tie{}; le contenu du champ @code{piece} viendra s'imprimer
183 avant chaque mouvement. De même, le titre de l'ouvrage peut se placer
184 au sein du bloc @code{\book}. Dans le cas contraire, le contenu du bloc
185 @code{\header} placé en début de fichier sera utilisé.
189 title = "Huit miniatures"
190 composer = "Igor Stravinsky"
194 \header @{ piece = "Romance" @}
197 ..texte du second couplet..
200 ..texte du troisième couplet..
204 \header @{ piece = "Menuet" @}
210 Plusieurs pièces seront regroupées dans un même @qq{chapitre} à l'aide
211 d'un bloc @code{\bookpart}. Les différentes parties sont séparées par
212 un saut de page et peuvent comporter un titre à l'instar de l'ouvrage
213 dès lors que vous y insérez un bloc @code{\header}.
218 title = "Titre de l'ouvrage"
219 subtitle = "Première partie"
226 subtitle = "Deuxième partie"
234 @node Plusieurs éditions pour une même source
235 @subsection Plusieurs éditions pour une même source
236 @translationof Multiple output files from one input file
238 Dès lors que vous inscrivez plusieurs blocs @code{\book} dans un même
239 fichier @file{.ly}, chacun d'eux donnera lieu à un résultat indépendant.
240 Lorsqu'aucun bloc @code{\book} n'est spécifié dans le fichier source,
241 LilyPond considère que l'intégralité du fichier constitue un bloc
242 @code{\book} unique, comme indiqué à la rubrique
243 @ref{Structure de fichier}.
245 LilyPond fait en sorte, lorsque plusieurs fichiers sont produits à
246 partir d'une même source, qu'aucun résultat d'un bloc @code{\book}
247 n'écrase celui qui a été généré pour un bloc @code{\book} précédent.
249 Dans les faits, et si le nom du fichier produit est repris de sa source
250 -- comportement par défaut --, un suffixe lui sera ajouté pour chaque
251 @code{\book}. Il s'agit en principe d'un pseudo numéro de version.
252 Ainsi, le fichier @file{huitminiatures.ly} qui contiendrait
257 \layout @{ @dots{} @}
261 \layout @{ @dots{} @}
265 \layout @{ @dots{} @}
273 @file{huitminiatures.pdf},
275 @file{huitminiatures-1.pdf} et
277 @file{huitminiatures-2.pdf}.
281 @node Nom des fichiers de sortie
282 @subsection Nom des fichiers de sortie
283 @translationof Output file names
285 LilyPond vous permet de prendre le contrôle dans la dénomination des
286 fichiers que vous voulez générer, quel que soit le moteur de rendu
289 Nous avons vu dans la rubrique précédente que LilyPond évite les
290 conflits de nom des fichiers qu'il génère à partir d'une même source.
291 Vous pouvez même définir vous-même le suffixe qui sera appliqué à chacun
292 des blocs @code{\book}. Ainsi, en reprenant l'exemple ci-avant, vous
293 obtiendrez les fichiers @file{huitminiatures-Romance.pdf},
294 @file{huitminiatures-Menuet.pdf} et @file{huitminiatures-Nocturne.pdf}
295 en ajoutant simplement une déclaration @code{\bookOutputSuffix} au sein
296 de chaque bloc @code{\book}.
300 \bookOutputSuffix "Romance"
302 \layout @{ @dots{} @}
305 \bookOutputSuffix "Menuet"
307 \layout @{ @dots{} @}
310 \bookOutputSuffix "Nocturne"
312 \layout @{ @dots{} @}
316 La déclaration @code{\bookOutputName} vous permet de définir vous-même
317 le nom du fichier généré pour un bloc @code{\book}@tie{}:
321 \bookOutputName "Romance"
323 \layout @{ @dots{} @}
326 \bookOutputName "Menuet"
328 \layout @{ @dots{} @}
331 \bookOutputName "Nocturne"
333 \layout @{ @dots{} @}
337 Le traitement de ce fichier produira@tie{}:
349 @node Structure de fichier
350 @subsection Structure de fichier
351 @translationof File structure
361 Un fichier @code{.ly} peut contenir un certain nombre d'expression de
362 haut niveau. Les expressions de haut niveau sont les suivantes@tie{}:
366 Une définition de sortie, comme @code{\paper}, @code{\midi} et
367 @code{\layout}. Ces définitions, lorsqu'elles se trouvent à un niveau
368 supérieur, s'appliqueront à l'intégralité de l'ouvrage. Si l'une de ces
369 expression apparaît à plusieurs reprises, la dernière aura préséance.
372 Une expression scheme pure, telle que
373 @w{@code{#(set-default-paper-size@tie{}"a7"@tie{}'landscape)}} ou
374 @w{@code{#(ly:set-option@tie{}'point-and-click@tie{}#f)}}.
377 Un bloc @code{\header}, dont le contenu sera de portée globale -- ce qui
378 est le cas en général pour le titre ou l'auteur entre autres.
381 Un bloc @code{\score} pour la partition. Cette partition sera assemblée
382 avec les autres partitions se trouvant au même niveau pour composer le
383 @code{\book}. Vous pouvez modifier ce comportement à l'aide de la
384 variable @code{toplevel-score-handler} placée en tête.
386 @c FIXME - I cannot read "toplevel-score-handler" in scm/lily.scm -jcm
387 The default handler is defined in the init file @file{../scm/lily.scm}.
391 Un bloc @code{\book} permet de regrouper naturellement plusieurs
392 mouvements -- autrement dit plusieurs blocs @code{\score} -- dans un
393 même document. Lorsqu'il y a plusieurs @code{\score}s, LilyPond génère
394 un seul fichier dans lequel les mouvements sont mis les uns à la suite
395 des autres, ce pour chacun des blocs @code{\book} rencontrés. La seule
396 raison qui peut vous demander d'expliciter plusieurs blocs @code{\book}
397 dans un fichier @file{.ly} est lorsque vous avez besoin de générer
398 différents documents à partir d'une même source. La présence explicite
399 d'un bloc @code{\book} est aussi nécessaire lorsque vous travaillez sur
400 un document lilypond-book qui reprendrait plusieurs @code{\score}s ou
401 @code{\markup}s dans un même extrait. Vous pouvez modifier ce
402 comportement à l'aide de la variable @code{toplevel-score-handler}
405 @c FIXME - I cannot read "toplevel-book-handler" in scm/lily.scm -jcm
406 The default handler is defined in the init file @file{../scm/lily.scm}.
410 Un bloc @code{\bookpart}. Un ouvrage peut se découper en plusieurs
411 parties à l'aide de blocs @code{\bookpart}, aussi bien pour alléger le
412 travail de l'algorithme de calcul des sauts de page, que si les réglages
413 du bloc @code{\paper} diffèrent d'une partie à l'autre.
416 Une expression musicale telle que
421 Ce bout de code sera placé dans un @code{\score} et intégré à l'ouvrage
422 en même temps que tous les autres @code{\score}s ou expressions
423 musicales. En d'autres termes, un fichier qui ne contiendrait que cette
424 simple expression musicale sera traduit en
440 Vous pouvez modifier ce comportement à l'aide de la variable
441 @code{toplevel-music-handler} placée en tête.
443 @c FIXME - I cannot read "toplevel-music-handler" in scm/lily.scm -jcm
444 The default handler is defined in the init file @file{../scm/lily.scm}.
448 Du texte sous forme de @emph{markup} comme les paroles d'un couplet
451 2. Le première ligne du deuxième couplet.
455 De tels @emph{markups} seront imprimés là où ils apparaissent,
456 avant, après ou entre les expressions musicales.
459 @cindex identificateurs
462 Une variable, ou identificateur, telle que
464 toto = @{ c4 d e d @}
467 Vous pourrez la réutiliser plus loin dans votre fichier en saisissant
468 simplement @code{\toto}. Le nom des indentificateurs ne doit être
469 formés que de caractères alphabétiques -- sans chiffre ni caractère
474 Voici trois éléments que vous pouvez placer à un niveau supérieur@tie{}:
478 % pas en pleine largeur
489 Vous pouvez placer, n'importe où dans votre fichier, les instruction
493 @item @code{\version}
494 @item @code{\include}
495 @item @code{\sourcefilename}
496 @item @code{\sourcefileline}
498 Une ligne de commentaire, introduite par le signe @code{%}.
501 Un bloc de commentaire, délimité par @code{%@{ .. %@}}.
508 Vous pouvez insérer des espaces dans votre fichier source afin de lui
509 apporter une meilleure lisibilité. Les espaces superflus sont
510 normalement ignorés. Notez cependant qu'il est des cas où l'espace est
511 requis pour éviter tout risque d'erreur@tie{}:
515 Autour d'une accolade, qu'elle soit ouvrant ou fermante ;
518 Après chaque commande ou variable, autrement dit tout élément qui
519 commence par un @code{\}@tie{};
522 Après tout élément qui sera interprété comme une expression Scheme,
523 autrement dit tout élément qui commence par un @code{#}@tie{};
526 Pour séparer les éléments d'une expression Scheme ;
529 En mode parole -- @code{lyricmode} -- pour séparer les termes des
530 commandes @code{\override} et @code{\set}. Précisons à ce sujet qu'en
531 plus d'ajouter une espace avant et après l'intégralité de la commande,
532 vous devrez encadrer d'espace le point et le signe égal qu'elle peut
534 @w{@code{\override Score . LyricText #'font-size = #5}}.
540 Manuel d'initiation :
541 @rlearning{Organisation des fichiers LilyPond}.
544 @node Titres et entêtes
545 @section Titres et entêtes
546 @translationof Titles and headers
548 La plupart de la musique qui est éditée comporte un titre et le nom de
549 son compositeur@tie{}; certains ouvrages divulguent beaucoup plus
554 * Création de titres::
555 * Titrages personnalisés::
556 * Référencement des numéros de page::
557 * Table des matières::
560 @node Création de titres
561 @subsection Création de titres
562 @translationof Creating titles
564 Des éléments de titrage peuvent s'attacher à un bloc @code{\score}, une
565 partie -- créée par un bloc @code{\bookpart} -- ou bien un ouvrage
566 entier créé par un bloc @code{\book}.
568 Les différents éléments du titrage sont contenus dans un bloc
569 @code{\header}. Un ouvrage complet peut comporter@tie{}:
575 Le dédicataire de l'œuvre, centré en haut de la première page.
579 Le titre de l'œuvre, centré en dessous de la dédicace.
583 Le sous-titre, centré sous le titre.
585 @funindex subsubtitle
587 Un niveau supplémentaire de sous-titre, centré en dessous du sous-titre.
591 Le poète, parolier ou librétiste, aligné à gauche en dessous du
596 L'instrument, centré en dessous du deuxième sous-titre. Il sera rappelé
597 sur les pages suivant la première, centré sur la ligne d'entête.
601 Le compositeur, aligné à droite en dessous du deuxième sous-titre.
605 Le libellé du tempo, aligné à gauche sous le poète.
609 L'arrangeur, aligné à droite sous le compositeur.
613 La pièce ou le mouvement, aligné à gauche sous le tempo.
617 L'opus ou le numéro au catalogue, aligné à droite sous l'arrangeur.
619 @cindex page breaks, forcing
620 @funindex breakbefore
622 Ce commutateur (activé par ##t@tie{}; ##f pour le désactiver) permet de
623 forcer le saut de page avant d'afficher les titres.
627 La notice de droits d'auteur, centrée en pied de la première page. Pour
628 imprimer le symbole @emph{copyright}, consultez la rubrique
629 @ref{Codage du texte}.
633 Mention spéciale imprimée en pied de la dernière page.
637 Voici ce que cela peut donner lorsque tout ces champs sont utilisés.
638 Les différentes commandes mentionnées à la rubrique
639 @ref{Mise en forme du texte} sont opérationnelles pour tous ces
643 @lilypond[quote,verbatim,line-width=11.0\cm]
646 paper-height = 10.0\cm
651 dedication = "dédié à moi-même"
652 title = \markup \center-column { "Première ligne de titre" "Deuxième
653 ligne de titre, plus longue" }
654 subtitle = "un sous-titre,"
655 subsubtitle = #(string-append "sous-sous-titre LilyPond version "
658 composer = \markup \center-column { "compositeur" \small "(1847-1973)" }
659 texttranslator = "Traduit par"
660 meter = \markup { \teeny "m" \tiny "e" \normalsize "t" \large "e" \huge
662 arranger = \markup { \fontsize #8.5 "a" \fontsize #2.5 "r" \fontsize
663 #-2.5 "r" \fontsize #-5.3 "a" \fontsize #7.5 "ngeur" }
664 instrument = \markup \bold \italic "instrument"
688 Comme nous venons de la voir, vous pouvez multiplier les blocs
689 @code{\header}. Lorsqu'un même champ apparaît dans plusieurs blocs,
690 LilyPond utilisera le dernier mentionné@tie{}:
694 composer = "Compositeur"
702 piece = "Nouveau morceau" % remplace le précédent
707 Lorsque le bloc @code{\header} est défini à l'intérieur du bloc
708 @code{\score}, seul les champs @code{piece} et @code{opus} seront
709 imprimés. Attention cependant à toujours placer le bloc @code{\header}
710 après l'expression musicale.
712 @lilypond[quote,verbatim,line-width=11.0\cm]
716 title = "title" % not printed
723 @funindex print-all-headers
725 Vous pouvez modifer ce comportement et imprimer tous les champs d'un
726 bloc @code{\header} défini dans un bloc @code{\score} en ajoutant
730 print-all-headers = ##t
737 Les pieds de page sont vides, hormis pour la première page qui portera
738 la champ @code{copyright} du @code{\header}, et pour la dernière page où
739 apparaîtra le @code{tagline}. Celui-ci est par défaut @qq{Music
740 engraving by LilyPond (@var{version})}.@footnote{Afin que l'on sache qui
741 est capable d'une telle qualité, nous vous saurons gré de ne pas
742 suprimer cette mention spéciale, autant que faire se peut.}
744 Un champ de titrage peut être désactivé@tie{}:
754 @node Titrages personnalisés
755 @subsection Titrages personnalisés
756 @translationof Custom headers footers and titles
758 Vous pouvez personnaliser, dans le bloc @code{\paper}, la définition des
759 variables listées ci-dessous. Leur mise en forme par défaut est
760 inscrite dans le fichier d'initialisation @file{../ly/titling-init.ly}.
763 @funindex bookTitleMarkup
764 @item bookTitleMarkup
765 Ce titre est apposé au début du document final. Il comprend normalement
766 le compositeur et le titre de l'œuvre.
768 @funindex scoreTitleMarkup
769 @item scoreTitleMarkup
770 Ce titre est attaché à un bloc @code{\score}. Il comprend normalement
771 le nom du mouvement -- le champ @code{piece}.
773 @funindex oddHeaderMarkup
774 @item oddHeaderMarkup
775 L'entête des pages impaires.
777 @funindex evenHeaderMarkup
778 @item evenHeaderMarkup
779 L'entête des pages paires. Lorsqu'il n'est pas défini, LilyPond utilise
780 celui des pages impaires.
782 Les entêtes comportent par défaut le nom de l'instrument, au centre, et
783 le numéro de page, sur le bord extérieur de la page.
785 @funindex oddFooterMarkup
786 @item oddFooterMarkup
787 Le pied de page impaire.
789 @funindex evenFooterMarkup
790 @item evenFooterMarkup
791 Le pied de page paire. Lorsqu'il n'est pas défini, LilyPond utilise
792 celui des pages impaires.
794 Par défaut, le pied de la première page comporte la notice de droits
795 d'auteur, et celui de la dernière page la @qq{mention spéciale} -- le
808 La définition suivante permt d'obtenir, sur la même ligne, le titre
809 aligné à gauche et le compositeur aligné à droite.
813 bookTitleMarkup = \markup @{
815 \fromproperty #'header:title
816 \fromproperty #'header:composer
822 Les entêtes et pieds de page sont créés respectivement par les fonctions
823 @code{make-header} and @code{make-footer}, que vous pouvez définir au
824 sein du bloc @code{\paper}. Leur implémentation est contenue dans les
825 fichiers d'initialisation @file{ly/paper-defaults-init.ly} et
826 @file{ly/titling-init.ly}.
828 Voici comment centrer le numéro en pied de chaque page@tie{}:
832 print-page-number = ##t
833 print-first-page-number = ##t
834 oddHeaderMarkup = \markup \fill-line @{ " " @}
835 evenHeaderMarkup = \markup \fill-line @{ " " @}
836 oddFooterMarkup = \markup @{
839 \on-the-fly #print-page-number-check-first
840 \fromproperty #'page:page-number-string
843 evenFooterMarkup = \markup @{
846 \on-the-fly #print-page-number-check-first
847 \fromproperty #'page:page-number-string
854 @node Référencement des numéros de page
855 @subsection Référencement des numéros de page
856 @translationof Reference to page numbers
858 LilyPond vous permet, à l'aide de la commande @code{\label}, d'insérer
859 des points de référence dans un ouvrage, aussi bien en dehors qu'au fil
860 de la musique. Ce point de référence pourra être ensuite repris à
861 l'intérieur d'un @emph{markup}@tie{}; vous pourrez même y ajouter le
862 numéro de page grâce à la commande de @emph{markup} @code{\page-ref}.
865 @lilypond[verbatim,line-width=11.0\cm]
866 \header { tagline = ##f }
872 \pageBreak \mark A \label #'markA
877 \markup { Le premier mouvement débute à la page \page-ref #'firstScore "0" "?" }
878 \markup { Le repère A est à la page \page-ref #'markA "0" "?" }
882 L'instruction @code{\page-ref} prend trois arguments@tie{}:
885 le point de référence, sous la forme d'un symbole scheme, comme par
886 exemple @code{#'firstScore},
889 un @qq{emporte-pièce} afin d'estimer la longueur totale du
893 un texte de remplacement au cas où la référence ne serait pas retrouvée.
896 La présence de l'emporte-pièce est rendue nécessaire par le fait que les
897 @emph{markups} sont générés avant que les sauts de page ne soient
898 positionnés. Bien que le numéro de page en question ne soit pas encore
899 déterminé, LilyPond doit connaître les dimensions de ce @emph{markup}.
900 Vous pouvez, lorsque l'ouvrage contiendra plus de dix pages, stipuler un
901 emporte-pièce sur deux caractères -- soit @code{"00"}.
912 @node Table des matières
913 @subsection Table des matières
914 @translationof Table of contents
916 La commande @code{\markuplines \table-of-contents} vous permettra de
917 générer une table des matières. Les éléments qui la composeront sont
918 créés par la commande @code{\tocItem}, insérée indépendamment ou au sein
919 d'une expression musicale.
922 \markuplines \table-of-contents
925 \tocItem \markup "Premier mouvement"
929 \tocItem \markup "Passage spécifique du premier mouvement"
934 \tocItem \markup "Second mouvement"
942 Les @emph{markups} dévolus à la mise en forme de la table des matières
943 se définissent dans le bloc @code{\paper}. Il s'agit par défaut de
944 @code{tocTitleMarkup} pour le titre de la table, et de
945 @code{tocItemMarkup} pour ses éléments -- composés de leur libellé et
946 numéro de page. Vous pouvez bien entendu personnaliser ces
951 %% Translate the toc title into French:
952 tocTitleMarkup = \markup \huge \column {
953 \fill-line { \null "Table des matières" \null }
956 %% use larger font size
957 tocItemMarkup = \markup \large \fill-line {
958 \fromproperty #'toc:text \fromproperty #'toc:page
963 Notez bien la manière de référencer le libellé et le numéro de page dans
964 la définition de @code{tocItemMarkup}.
966 N'hésitez pas à définir vous-même d'autres commandes et @emph{markups}
967 afin de construire une table plus élaborée@tie{}:
970 commencez par définir une nouvelle variable de type @code{markup} au
971 sein du bloc @code{\paper},
974 puis définissez une fonction musicale chargée d'insérer un élément de la
975 table à partir de cette variable.
978 Dans l'exemple qui suit, nous avons créé un nouveau style d'élément dans
979 le but de mentionner les actes dans la table des matières d'un
984 tocActMarkup = \markup \large \column {
986 \fill-line { \null \italic \fromproperty #'toc:text \null }
992 #(define-music-function (parser location text) (markup?)
993 (add-toc-item! 'tocActMarkup text))
996 @lilypond[line-width=11.0\cm]
997 \header { tagline = ##f }
999 tocActMarkup = \markup \large \column {
1001 \fill-line { \null \italic \fromproperty #'toc:text \null }
1007 #(define-music-function (parser location text) (markup?)
1008 (add-toc-item! 'tocActMarkup text))
1011 \markuplines \table-of-contents
1012 \tocAct \markup { Atto Primo }
1013 \tocItem \markup { Coro. Viva il nostro Alcide }
1014 \tocItem \markup { Cesare. Presti omai l'Egizzia terra }
1015 \tocAct \markup { Atto Secondo }
1016 \tocItem \markup { Sinfonia }
1017 \tocItem \markup { Cleopatra. V'adoro, pupille, saette d'Amore }
1022 L'élément et son numéro de page peuvent se rejoindre par une ligne
1025 @lilypond[verbatim,quote]
1026 \header { tagline = ##f }
1028 tocItemMarkup = \tocItemWithDotsMarkup
1032 \markuplines \table-of-contents
1033 \tocItem \markup { Allegro }
1034 \tocItem \markup { Largo }
1041 Fichiers d'initialisation :
1042 @file{../ly/toc-init.ly}.
1046 @funindex \table-of-contents
1047 @code{\table-of-contents},
1053 @node Travail sur des fichiers texte
1054 @section Travail sur des fichiers texte
1055 @translationof Working with input files
1058 * Insertion de fichiers LilyPond::
1059 * Différentes éditions à partir d'une même source::
1061 * Affichage de notation au format LilyPond::
1064 @node Insertion de fichiers LilyPond
1065 @subsection Insertion de fichiers LilyPond
1066 @translationof Including LilyPond files
1069 @cindex inclusion de fichiers
1071 Lorsqu'un projet prend de l'importance en volume, il est judicieux de le
1072 scinder en plusieurs fichiers, auxquels vous fereez référence avec un
1076 \include "autrefichier.ly"
1079 Une ligne @code{\include "autrefichier.ly"} dans un fichier revient à
1080 recopier intégralement le contenu de @file{autrefichier.ly} à l'endroit
1081 même ou est placée l'instruction @code{\include}. Vous pouvez par
1082 exemple écrire un fichier individuel par instrument, puis les regrouper
1083 pour former le fichier @qq{conducteur}. Les différentes variables
1084 définies dans les fichiers séparés seront normalement reprises et
1085 utilisables dans le fichier formant le conducteur. Les sections
1086 balisées dans les fichiers individuels peuvent être réutilisées en
1087 différents endroit de la partition , comme expliqué à la rubrique
1088 @ref{Différentes éditions à partir d'une même source}.
1090 Lorsque le fichier auquel il est fait référence se trouve dans le même
1091 répertoire, donner seulement son nom en argument à la commande
1092 @code{\include} suffit. S'il se trouve ailleurs, vous devrez indiquer
1093 le chemin d'accès, absolu ou relatif, en respectant toutefois la syntaxe
1094 UNIX -- autrement dit, le séparateur de répertoire est une oblique
1095 normale @code{/} et non l'oblique inverse @code{\} de DOS/Windows. Par
1096 exemple, si le fichier @file{truc.ly} se trouve dans le répertoire
1097 supérieur au répertoire de travail, la ligne devra être
1100 \include "../stuff.ly"
1104 ou bien, si les fichiers correspondant aux parties d'orchestre se
1105 trouvent dans le sous-répertoire @file{parties} relativement au
1106 répertoire courant, vous devrez mentionner
1109 \include "parties/VI.ly"
1110 \include "parties/VII.ly"
1114 Les fichiers à inclure peuvent eux-même contenir des instructions
1115 @code{\include}. Ces instructions @code{\include} de second niveau ne
1116 pourront, par défaut, être interprétées qu'une fois intégrées dans le
1117 fichier principal@tie{}; leur argument doit donc comporter le chemin
1118 relativement au fichier principal et non par rapport au fichier dan
1119 lesquel cette inclusion est mentionnée. Vous pouvez toutefois influer
1120 sur ce comportement à l'aide de l'option @code{-drelative-includes} en
1121 ligne de commande ou en ajoutant une clause
1122 @code{@w{#(ly:set-option 'relative-includes #t)}} en tête du fichier
1123 principal. Une fois @code{relative-include} activé, le chemin à suivre
1124 pour chacune des commandes @code{\include} sera pris relativement au
1125 fichier qui la contient.
1127 Vous pouvez inclure des fichiers dont vous spécifierez le chemin d'accès
1128 sur la ligne de commande au moment de lancer la compilation. L'appel à
1129 ces fichiers ne mentionnerra alors que leur nom. Par exemple, si vous
1130 voulez compiler avec cette méthode le fichier @file{principal.ly} qui
1131 inclut des fichiers situés dans le sous-répertoire @file{parties},
1132 placez vous dans le répertoire contenant @file{principal.ly}, puis tapez
1135 lilypond --include=parties principal.ly
1138 tout en ayant bien dans @file{principal.ly}
1146 Lorsqu'un fichier est voué à être inclus dans nombre de partitions, vous
1147 pouvez le placer dans le répertoire de LilyPond @file{../ly}.
1148 Attention@tie{}: ce répertoire varie selon votre installation, comme
1149 indiqué au chapitre @rlearning{Autres sources de documentation}. Ce
1150 fichier sera inclus dès lors que vous fournirez uniquement son nom en
1151 argument à la fonction @code{\include}. C'est par exemple le cas du
1152 fichier de définition particulier @file{gregorian.ly}.
1154 Au moment où vous lancez LilyPond, un certain nombre de fichiers se
1155 retrouvent inclus par défaut@tie{}; il suffit d'activer le mode verbeux
1156 en faisant @code{lilypond --verbose} pour s'en rendre compte. Vous
1157 verrez ainsi défiler, en plus de nombreuses informations, le nom d'un
1158 certain nombre de fichier et de chemins d'accès. Les fichiers les plus
1159 important sont mentionnés au chapitre
1160 @rlearning{Autres sources de documentation}. Si vous venez à les
1161 modifier, rappelez-vous qu'ils seront écrasés à l'installation d'une
1162 nouvelle version de LilyPond.
1164 Vous trouverez quelques exemples simples d'utilisation de la commande
1165 @code{\include} au chapitre @rlearning{Conducteurs et parties}.
1169 Manuel d'initiation :
1170 @rlearning{Autres sources de documentation},
1171 @rlearning{Conducteurs et parties}.
1176 Lorsque vous incluez un fichier qui porte le même nom que l'un des
1177 fichiers d'initialisation de LilyPond, le fichier de la distribution de
1178 LilyPond aura préséance.
1181 @node Différentes éditions à partir d'une même source
1182 @subsection Différentes éditions à partir d'une même source
1183 @translationof Different editions from one source
1185 Différents mécanismes permettent de générer plusieurs versions d'une
1186 partition à partir d'une même source. Les variables -- ou
1187 idendificateurs -- sont sûrement le moyen le plus simple de combiner de
1188 différente manière des passages relativement longs, alors que les
1189 balises permettront de sélectionner de courts fragments selon leur
1190 utilisation. Quelle que soit la méthode utilisée, séparer la notation
1191 de la structure de la partition vous donnera plus de liberté dans
1192 l'agencement de l'ouvrage final, puisque vous ne reviendrez pas sur la
1193 musique qui le compose.
1196 * Utilisation de variables::
1197 * Utilisation de balises::
1198 * Globalisation des réglages::
1201 @node Utilisation de variables
1202 @unnumberedsubsubsec Utilisation de variables
1203 @translationof Using variables
1205 @cindex variables, utilisation de
1207 Un fragment musical identifié par une variable est réutilisable à divers
1208 endroits de la partition, comme nous l'avons vu à la rubrique
1209 @rlearning{Organisation du code source avec des variables}. Par
1210 exemple, une partition pour chœur @notation{a cappella} comporte souvent
1211 une réduction pour piano reprenant toutes les voix@tie{}; il s'agit de
1212 la même musique, et vous ne devrez donc la saisir qu'une seule fois.
1213 D'autre part, la musique issue de deux variables peut se combiner sur
1214 une seule portée, comme nous l'avons vu à la rubrique
1215 @ref{Regroupement automatique de parties}. Prenons l'exemple
1218 @lilypond[verbatim,quote]
1219 sopranoMusic = \relative c'' { a4 b c b8( a) }
1220 altoMusic = \relative g' { e4 e e f }
1221 tenorMusic = \relative c' { c4 b e d8( c) }
1222 bassMusic = \relative c' { a4 gis a d, }
1223 allLyrics = \lyricmode {King of glo -- ry }
1225 \new Staff = "Soprano" \sopranoMusic
1226 \new Lyrics \allLyrics
1227 \new Staff = "Alto" \altoMusic
1228 \new Lyrics \allLyrics
1229 \new Staff = "Tenor" {
1233 \new Lyrics \allLyrics
1234 \new Staff = "Bass" {
1238 \new Lyrics \allLyrics
1241 \set Staff.printPartCombineTexts = ##f
1247 \set Staff.printPartCombineTexts = ##f
1257 Générer une partition chorale ou la réduction pour piano ne requiert que
1258 de modifier la structure des éléments, sans aucunement toucher à la
1261 Dans le cas d'une partition relativement longue, vous pouvez isoler la
1262 définition des différentes variables dans des fichiers séparés que vous
1263 rappellerez ensuite, comme indiqué à la rubrique
1264 @ref{Insertion de fichiers LilyPond}.
1267 @node Utilisation de balises
1268 @unnumberedsubsubsec Utilisation de balises
1269 @translationof Using tags
1272 @funindex \keepWithTag
1273 @funindex \removeWithTag
1277 La commande @code{\tag #'@var{partieA}} affecte à une expression
1278 musicale le nom @var{partieA}. Les expressions ainsi balisées pourront
1279 être filtrées par la suite, à l'aide de
1280 @code{\keepWithTag@tie{}#'@var{nom}} ou
1281 @code{\removeWithTag@tie{}#'@var{nom}}. Ces filtres fonctionnent de la
1282 manière suivante@tie{}:
1284 @multitable @columnfractions .5 .5
1289 Musique balisée précédée de @code{\keepWithTag #'@var{nom}}
1290 @tab Musique non balisée et musique balisée par @var{nom} seront
1291 incluses@tie{}; la musique balisée autrement est exclue.
1294 Musique balisée précédée de @code{\removeWithTag #'@var{nom}}
1295 @tab Musique non balisée et fragments appelés autrement que @var{nom}
1296 seront inclus@tie{}; la musique balisée par @var{nom} est exclue.
1299 Musiqeu balisée non précédée de @code{\keepWithTag} ou
1300 @code{\removeWithTag}
1301 @tab Musique balisée et non balisée seront incluses.
1305 Les arguments des commandes @code{\tag}, @code{\keepWithTag} et
1306 @code{\removeWithTag} doivent être un symbole (tel que
1307 @code{#'conducteur} ou @code{#'partie}), suivi d'une expression
1310 Dans l'exemple qui suit, nous obtenons deux versions du même extrait,
1311 l'une pour le conducteur, l'autre pour l'instrumentiste, et qui
1312 comportera les ornements développés.
1314 @lilypond[verbatim,quote]
1315 music = \relative g' {
1317 \tag #'trills { d8.\trill }
1318 \tag #'expand { \repeat unfold 3 { e32 d } }
1323 \keepWithTag #'trills \music
1326 \keepWithTag #'expand \music
1331 Il est parfois plus aisé d'exclure des fragments@tie{}:
1333 @lilypond[verbatim,quote]
1334 music = \relative g' {
1336 \tag #'trills { d8.\trill }
1337 \tag #'expand {\repeat unfold 3 { e32 d } }
1342 \removeWithTag #'expand
1346 \removeWithTag #'trills
1351 Ce principe de filtrage peut s'appliquer aux articulations, textes, etc.
1352 Il suffit de positionner
1355 -\tag #@var{ma-balise}
1359 avant l'articulation ou le texte, comme ici@tie{}:
1363 c1-\tag #'gaffe ^"Attention !"
1367 Ceci définira une note avec une indication conditionnelle de doigté ou
1370 Vous pouvez baliser différemment la même expression musicale en
1371 saisissant plusieurs @code{\tag}@tie{}:
1373 @lilypond[quote,verbatim]
1374 music = \relative c'' {
1375 \tag #'a \tag #'both { a4 a a a }
1376 \tag #'b \tag #'both { b4 b b b }
1379 \keepWithTag #'a \music
1380 \keepWithTag #'b \music
1381 \keepWithTag #'both \music
1385 L'application concomitante de plusieurs filtres @code{\removeWithTag} à
1386 la même expression musicale permet d'exclure plusieurs balisages@tie{}:
1388 @lilypond[verbatim,quote]
1389 music = \relative c'' {
1390 \tag #'A { a4 a a a }
1391 \tag #'B { b4 b b b }
1392 \tag #'C { c4 c c c }
1393 \tag #'D { d4 d d d }
1402 L'application de plus d'un filtre @code{\keepWithTag} à la même
1403 expression musicale aboutit à l'exclusion de @b{tous} les balisages.
1404 En effet, si le premier filtre exclut tous les autres balisages,
1405 l'application du second exclura les effets du premier.
1409 Manuel d'initiation :
1410 @rlearning{Organisation du code source avec des variables}.
1412 Manuel de notation :
1413 @ref{Regroupement automatique de parties},
1414 @ref{Insertion de fichiers LilyPond}.
1418 @c This warning is more general than this placement implies.
1419 @c Rests are not merged whether or not they come from tagged sections.
1420 @c Should be deleted? -td
1424 Lorsqu'elles comportent des silences, ceux-ci ne seront pas fusionnés
1425 si vous imprimez une partition avec les deux sections balisées.
1430 @node Globalisation des réglages
1431 @unnumberedsubsubsec Globalisation des réglages
1432 @translationof Using global settings
1434 @cindex include-settings
1436 Vous pouvez regrouper dans un fichier indépendant vos réglages
1437 personnels que vous incluerez au besoin@tie{}:
1440 lilypond -dinclude-settings=MES_REGLAGES.ly MA_PARTITION.ly
1443 Vous pouvez ainsi stocker dans un fichier séparé vos réglages en matière
1444 de format de papier, de fontes utilisées ou vos définitions
1445 particulières. Selon le fichier de réglages que vous mentionnerez, vous
1446 obtiendrez facilement différentes éditions à partir d'une même source
1447 quelle qu'elle soit.
1449 Ceete technique peut s'utiliser en combinaison avec des feuilles de
1450 styles, comme indiqué au chapitre @rlearning{Feuilles de style}.
1453 Manuel d'initiation :
1454 @rlearning{Organisation du code source avec des variables},
1455 @rlearning{Feuilles de style}.
1457 Manuel de notation :
1458 @ref{Insertion de fichiers LilyPond}.
1461 @node Codage du texte
1462 @subsection Codage du texte
1463 @translationof Text encoding
1467 @cindex non-ASCII characters
1469 LilyPond utilise le jeu de caractères défini par le consortium Unicode
1470 et la norme ISO/CEI@tie{}10646. Chaque caractère est identifié par un
1471 nom unique et associé à un point de code, ce qui permet dans l'absolu de
1472 couvrir tous les langages. Unicode permet de coder tous les caractères
1473 utilisés par toutes les langues écrites du monde. LilyPond utilise le
1474 codage UTF-8 (UTF pour @emph{Unicode Transformation Format}) qui permet
1475 de représenter les caractères latins sur un octet et les autres sur une
1476 longueur allant jusqu'à quatre octets.
1478 L'apparence réelle des caractères est déterminée par les glyphes ou
1479 graphèmes tels que définis dans les différentes polices disponibles.
1480 Une police, ou une fonte, définit la mise en correspondance d'un
1481 sous-ensemble de points de code unicode en glyphes. LilyPond recourt à
1482 la bibliothèque Pango pour assurer le rendu des textes multilingues.
1484 LilyPond n'effectue aucune conversion d'encodage que ce soit. Ceci
1485 implique donc que tout texte, qu'il s'agisse d'un titre, de paroles ou
1486 même d'instruction musicale, comportant des caractères non ASCII soit
1487 codé en UTF-8. Le plus sûr moyen de saisir du texte de la sorte
1488 consiste à utiliser un éditeur supportant l'unicode et à enregistrer vos
1489 fichier en UTF-8. C'est le cas pour la plupart des éditeurs actuels,
1490 que ce soit vim, Emacs, jEdit et GEdit. Tous les systèmes Windows
1491 postérieurs à NT utilisent Unicode en natif@tie{}; même Notepad est
1492 capable d'éditer et sauvegarder un fichie en UTF-8 -- sans parler de
1493 l'excellente alternative qu'est BabelPad.
1495 La compilation d'un fichier LilyPond comportant des caractères non ASCII
1496 qui n'aurait pas été enregistré dans l'encodage UTF-8 vous renverra
1500 FT_Get_Glyph_Name () erreur : invalid argument
1503 Voici un exemple utilisant du texte en cyrilique, en hébreux et en
1507 %c No verbatim here as the code does not display correctly in PDF
1509 bulgarian = \lyricmode {
1510 Жълтата дюля беше щастлива, че пухът, който цъфна, замръзна като гьон.
1514 hebrew = \lyricmode {
1515 זה כיף סתם לשמוע איך תנצח קרפד עץ טוב בגן.
1519 portuguese = \lyricmode {
1520 à vo -- cê uma can -- ção legal
1526 \addlyrics { \bulgarian }
1527 \addlyrics { \hebrew }
1528 \addlyrics { \portuguese }
1531 Lorsque vous avez besoin d'un caractère dont vous connaissez le point de
1532 code mais que votre éditeur ne permet pas de saisir directement, vous
1533 pouvez utitliser les instructions @code{\char@tie{}##xhhhh} ou
1534 @code{\char@tie{}#dddd} au sein d'un bloc @code{\markup} -- @code{hhhh}
1535 et @code{dddd} correspondant respectivement à la valeur hexadécimale ou
1536 décimale. Même s'il est inutile de saisir les zéros superflus, il est
1537 de bon ton de stipuler les quatre caractères formant la représentation
1538 hexadécimale. Évitez cependant l'encodage UTF-8 d'un point de code
1539 après un @code{\char}@tie{}; les encodages UTF-8 comprennent un bit
1540 supplémentaire indiquant le nombre d'octets. Une table de
1541 correspondance entre les codes Unicode et le nom des caractères ainsi
1542 que leur code hexadécimal est disponible sur le site du consortium
1543 Unicode, @uref{http://www.unicode.org/}.
1545 Par exemple, @code{\char ##x03BE} et @code{\char #958} correspondent
1546 tous deux au caractère unicode U+03BE, dénommé @qq{Greek Small Letter
1549 Quel que soit le point de code spécifié de cette manière, il ne vous
1550 sera alors pas nécessaire d'enregistrer votre fichier en UTF-8. Vous
1551 devrez toutefois disposer d'une fonte contenant ce caractère qui soit
1552 accessible à LilyPond.
1554 L'exemple suivant illustre la manière d'insérer un caractère sous sa
1555 forme hexadécimale, à la fois dans un repère, dans une articulation,
1556 dans des paroles et dans du texte indépendant.
1558 @lilypond[quote,verbatim]
1561 c1 \mark \markup { \char ##x03EE }
1562 c1_\markup { \tiny { \char ##x03B1 " to " \char ##x03C9 } }
1564 \addlyrics { O \markup { \concat { Ph \char ##x0153 be! } } }
1566 \markup { "Copyright 2008--2011" \char ##x00A9 }
1571 Le signe @emph{copyright} dans le champ de titrage consacré s'inscrit de
1572 la manière suivante@tie{}:
1576 copyright = \markup @{ \char ##x00A9 "2008" @}
1581 @node Affichage de notation au format LilyPond
1582 @subsection Affichage de notation au format LilyPond
1583 @translationof Displaying LilyPond notation
1585 @funindex \displayLilyMusic
1587 La fonction musicale @code{\displayLilyMusic}, disponible uniquement
1588 pour un traitement en ligne de commande, permet d'afficher en
1589 notation LilyPond une expression musicale. Par exemple,
1593 \displayLilyMusic \transpose c a, @{ c4 e g a bes @}
1600 @{ a,4 cis e fis g @}
1603 LilyPond affichera le résultat sous forme de message en console, au
1604 milieu de toutes les informations de compilation. Afin d'isoler ces
1605 messages et enregistrer le résultat de la fonction
1606 @code{\display@{STUFF@}}, pensez à rediriger la sortie vers un fichier.
1609 lilypond fichier.ly >display.txt
1613 @node Contrôle des sorties
1614 @section Contrôle des sorties
1615 @translationof Controlling output
1618 * Extraction de fragments musicaux::
1619 * Ignorer des passages de la partition::
1620 * Formats de sortie alternatifs::
1621 * Changement des fontes musicales::
1624 @node Extraction de fragments musicaux
1625 @subsection Extraction de fragments musicaux
1626 @translationof Extracting fragments of music
1628 LilyPond vous permet d'extraire des fragments d'une partition à l'instar
1629 du choriste amateur qui alimente son album avec des coupures de
1632 Vous devrez pour cela définir les mesures à découper. La définition
1633 suivante, incluse dans votre fichier source,
1640 (make-rhythmic-location 5 1 2)
1641 (make-rhythmic-location 7 3 4)))
1646 vous permettra d'extraire un fragment compris entre le milieu de la
1647 cinquième mesure et quelque part dans la septième. Le triplet
1648 @code{5@tie{}1@tie{}2} signifie@tie{}: après la durée d'une blanche dans
1649 la mesure 5@tie{}; le @code{7@tie{}3@tie{}4} signifie quant à lui que
1650 l'on s'arrête à la mesure 7, après la durée de trois noires.
1652 Rien ne vous empêche d'extraire plusieurs fragments, dès lors que vous
1653 définissez dans la liste d'autres paires d'emplacements ryhtmiques.
1655 Cette fonctionnalité n'est toutefois effective que lorsque vous lancez
1656 LilyPond avec l'option @code{-dclip-systems}. Les @qq{coupures} seront
1657 générées sous la forme de fichiers EPS, convertis en PDF ou PNG selon le
1658 format que vous aurez stipulé.
1660 Pour de plus amples informations quant au format des résultats,
1661 consultez le chapitre @rprogram{Lancement de lilypond}.
1664 @node Ignorer des passages de la partition
1665 @subsection Ignorer des passages de la partition
1666 @translationof Skipping corrected music
1668 @funindex skipTypesetting
1669 @funindex showFirstLength
1670 @funindex showLastLength
1672 Dans un travail de transcription ou de recopie de la musique, ce qui
1673 vous intéresse plus particulièrement se situe à la fin, là même où vous
1674 en êtes dans la notation. Dans le but de gagner du temps dans le
1675 processus de correction, vous pouvez @qq{escamoter} le reste et ne
1676 générer que les dernières mesures en insérant
1679 showLastLength = R1*5
1684 dans votre fichier source. Ceci aura pour effet de ne générer que les
1685 cinq dernières mesures -- si tant est que le morceau soit à 4/4 -- de
1686 tous les @code{\score} de votre fichier. Dans le cas d'un œuvre
1687 conséquente, cette pratique s'avère fort utile puisqu'elle évite de tout
1688 générer. Vous pourriez aussi être amené à retravailler le début d'une
1689 œuvre, pour y ajouter une partie par exemple, auquel cas c'est la
1690 propriété @code{showFirstLength} que vous utiliserez.
1692 Vous pouvez contrôler très finement les parties à escamoter, grâce u
1693 commutateur @code{Score.skipTypesetting}@tie{}: lorsqu'il est activé,
1694 aucune gravure n'est réalisée.
1696 Ce commutateur agit aussi sur la sortie MIDI. Notez bien que tous les
1697 événements seront escamotés, y compris les changements de tempo ou
1698 d'instrument -- vous voilà prévenu@tie{}!
1700 @lilypond[quote,relative=2,ragged-right,verbatim]
1702 \set Score.skipTypesetting = ##t
1704 \set Score.skipTypesetting = ##f
1708 Dans le cadre de musique polyphonique, @code{Score.skipTypesetting}
1709 s'applique à toutes les voix et portées. Vous gagnerez donc encore plus
1713 @node Formats de sortie alternatifs
1714 @subsection Formats de sortie alternatifs
1715 @translationof Alternative output formats
1717 @cindex scalable vector graphics
1718 @cindex SVG, format de sortie
1719 @cindex encapsulated postscript
1720 @cindex EPS, format de sortie
1722 En matière de partition imprimable, LilyPond génère par défaut des
1723 documents au format PstScript (PS) et Portable Document Format (PDF).
1724 Vous pouvez aussi obtenir des documents au format Scalable Vector
1725 Graphics (SVG), Encapsulated PostScript (EPS) ou Portable Network
1726 Graphics (PNG) dès lors que vous aurez lancé LilyPond en ligne de
1727 commande avec l'option @i{ad hoc} -- voir
1728 @rprogram{Options en ligne de commande pour lilypond} à ce sujet.
1731 @node Changement des fontes musicales
1732 @subsection Changement des fontes musicales
1733 @translationof Replacing the notation font
1735 Gonville est ube alternative à la fonte Feta que LilyPond utilise par
1736 défaut. Vous pouvez la télécharger à partir de
1738 @uref{http://www.chiark.greenend.org.uk/~sgtatham/gonville/ ,http://www.chiark.greenend.org.uk/~sgtatham/gonville/}
1741 Voici quelques mesures utilisant la police Gonville@tie{}:
1743 @c NOTE: these images are a bit big, but that's important
1744 @c for the font comparison. -gp
1745 @sourceimage{Gonville_after,,,}
1747 Et ces même mesures avec la police de LilyPond, Feta@tie{}:
1749 @sourceimage{Gonville_before,,,}
1752 @subsubheading Instructions d'installation pour MacOS
1753 @translationof Installation Instructions for MacOS
1755 Téléchargez puis décompressez l'archive zip. Recopiez le répertoire
1756 @code{lilyfonts} dans @file{@var{SHARE_DIR}/lilypond/current} -- voir
1757 @rlearning{Autres sources de documentation} à ce sujet. Renommez le
1758 répertoire @code{fonts} qui s'y trouve en @code{fonts_orig}, puis les
1759 répertoire @code{lilyfonts} en @code{fonts}. Il vous suffira, pour
1760 retrouver la fonte Feta, de renommer @code{fonts_orig} en @code{fonts}.
1764 Manuel d'initiation :
1765 @rlearning{Autres sources de documentation}.
1769 Gonville ne permet pas de générer de la notation ancienne. Consultez le
1770 site de l'auteur pour de plus amples informations ainsi qu'à propos des
1771 conditions d'utilisation.
1775 @section Sortie MIDI
1776 @translationof MIDI output
1778 MIDI (Musical Instrument Digital Interface) constitue un standard en
1779 matière de connexion et de contrôle des instruments électroniques. Un
1780 fichier MIDI contient une série de notes réparties dans différentes
1781 pistes. Il ne s'agit en rien d'un fichier sonore@tie{}; il vous faudra
1782 un logiciel capable de traduire ces séries de notes en sons.
1784 Vous pouvez convertir vos partition en fichier MIDI de manière à
1785 entendre ce que vous avez saisi. Ceci vous permet de contrôler aisément
1786 ce que vous avez saisi@tie{}: octaves et altérations erronées heuteront
1787 votre oreille avertie grâce au MIDI.
1790 Dans une sortie MIDI, LilyPond alloue un canal à chaque portée, plus un
1791 pour les réglages globaux. Par voie de conséquence, un fichier MIDI ne
1792 peut comporter au maximmum que quinze portées (quatorze en l'absence de
1793 percussions)@tie{}; les portées supplémentaires seront tout simplement
1797 * Création de fichiers MIDI::
1799 * Contenu de la sortie MIDI::
1800 * Répétitions et MIDI::
1801 * Gestion des nuances en MIDI::
1802 * MIDI et percussions::
1806 @node Création de fichiers MIDI
1807 @subsection Création de fichiers MIDI
1808 @translationof Creating MIDI files
1810 LilyPond génèrera un fichier MIDI dès que vous ajouterez un bloc
1811 @code{\midi} à la structure de votre partition, comme ici@tie{}:
1820 Lorsque le bloc @code{\score} contient un bloc @code{\midi} mais pas de
1821 bloc @code{\layout}, LilyPond ne produira qu'une sortie MIDI. Si donc
1822 vous avez besoin aussi d'un support visuel, vous devrez aussi mentionner
1823 un bloc @code{\layout}.
1833 Hauteurs, durées, liaisons de prolongation, nuances et changements de
1834 tempo seront interprétés et traduits en événements MIDI. Les
1835 indications de nuances, crescendos et decrescendos sont traduits en
1836 niveau de volume@tie{}; les indications sous la forme d'une fraction
1837 déterminée du volume disponible, et crescendos et decrescendos sous la
1838 forme d'une progression linéaire entre les deux extrêmes. Le rendu des
1839 indications de nuance peut être désactivé pour le MIDI -- voir
1842 Le tempo initial ainsi que ses changements sont normalement indiqués au
1843 fil de la notation à l'aide de la commande @code{\tempo}@tie{}; ils
1844 seront retranscrits dans le fichier MIDI. La commande @code{\tempo}
1845 donne lieu à l'impression d'une indication métronomique que vous pouvez
1846 toutefois rendre invisible, comme indiqué à la rubrique
1847 @ref{Indication métronomique}. Une autre manière de spécifier le tempo
1848 initial pour un fichier MIDI est indiquée plus avant -- voir
1851 En raison de certaines limitations de Windows, les fichiers MIDI doivent
1852 y porter l'extension @code{.mid}. D'autres systèmes utilisent
1853 l'extension @code{.midi}. Si besoin est, placez la ligne suivante au
1854 début de votre fichier source, avant l'ouverture de tout bloc
1855 @code{\book}, @code{\bookpart} ou @code{\score}@tie{}:
1858 #(ly:set-option 'midi-extension "midi")
1861 Cette ligne déterminera @code{.midi} comme extension par défaut pour les
1864 Vous pouvez aussi le faire en ligne de commande@tie{}:
1867 lilypond … -dmidi-extension=midi fichierLily.ly
1871 @unnumberedsubsubsec Noms d'instrument
1872 @translationof Instrument names
1874 @cindex instrument, nom d'
1875 @funindex Staff.midiInstrument
1877 L'instrument MIDI affecté à un canal particulier est déterminé par la
1878 propiété @code{Staff.midiInstrument}. Vous pouvez choisr l'un des
1879 instruments répertoriés à l'annexe @ref{Instruments MIDI}.
1883 \set Staff.midiInstrument = #"glockenspiel"
1889 \new Staff \with @{midiInstrument = #"cello"@} @{
1894 Lorsque l'instrument choisi ne correspond pas exactement à l'une des
1895 dénominations consacrées, LilyPond le replacera par un piano de concert
1896 (@code{"acoustic grand"}).
1901 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
1902 {changing-midi-output-to-one-channel-per-voice.ly}
1906 @c In 2.11 the following no longer seems to be a problem -td
1908 Un (de)crescendo non terminé ne sera pas correctement rendu en MIDI --
1909 il y a nécessairement du silence. Il vous faut donc lui donner une fin
1910 explicite. Par exemple,
1917 ne fonctionnera pas correctement, contrairement à
1920 @{ a4\< b c d\!\f @}
1924 Un changement de volume ne peut intervenir que sur le démarrage d'une
1925 note. C'est la raison pour laquelle la succession d'un crescendo et
1926 d'un diminuendo ne peut se produire sur une même note.
1928 Certains lecteurs MIDI ne rendent pas correctement les changements de
1929 tempo. MS Windows Media Player et
1930 @uref{http://@/timidity@/.sourceforge@/.net/,timidity} le font sans
1935 @subsection Le bloc MIDI
1936 @translationof MIDI block
1938 Dès lors que vous désirez obtenir une sortie MIDI, vous devrez inscrire
1939 un bloc @code{\midi} au sein du bloc @code{\score}. Son fonctionnement
1940 est comparable à ce lui du bloc @code{\layout}, voire plus simple. Si
1941 le bloc @code{\midi} est la plupart du temps laissé vide, il peut
1942 contenir des aménagements pour certains contextes, la définition de
1943 contextes particuliers ou du code permettant de déterminer la valeur de
1944 certianes propriétés. L'exemple suivant détermine le tempo initial du
1945 fichier MIDI tout en se passant de son indication sur la partition
1954 tempoWholesPerMinute = #(ly:make-moment 72 4)
1960 Ici, le tempo est fixé à 72 noires à la minute. Spécifier un tempo de
1961 la sorte ne permet pas de doner une valeur pour une note pointée. Vous
1962 devrez, en pareil cas, subdiviser la note pointée en durée plus courte.
1963 Par exemple, indiquer 90 à la noire pointée est équivalent à spécifier
1964 270 croches à la minute@tie{}:
1967 tempoWholesPerMinute = #(ly:make-moment 270 8)
1970 @cindex MIDI et définition de contexte
1971 @cindex contexte, définition en MIDI
1973 La syntaxe permettant de définir un contexte pour le @code{\midi} est en
1974 tout point identique à celle que vous utilisez dans le bloc
1975 @code{\layout}, à ceci près que le @qq{graveur} est remplacé par un
1976 @qq{interprète}. Les différents contextes disponibles en matière de
1977 MIDI sont répertoriés dans le fichier d'initialisation
1978 @file{../ly/performer-init.ly} -- pour plus de détail, voir
1979 @rlearning{Autres sources de documentation}.
1980 Si vous voulez vous passer des nuances dans votre fichier MIDI, il vous
1981 suffit d'insérer les lignes suivantes dans votre bloc
1989 \remove "Dynamic_performer"
1994 LilyPond ne génèrera de sortie MIDI que si vous incluez un bloc
1995 @code{\midi} dans la structure de la partition, initialisée par la
1996 commande @code{\score}.
2000 @{ @dots{}notes@dots{} @}
2006 @node Contenu de la sortie MIDI
2007 @subsection Contenu de la sortie MIDI
2008 @translationof What goes into the MIDI output?
2010 @c TODO Check grace notes - timing is suspect?
2013 @unnumberedsubsubsec Éléments pris en compte dans le MIDI
2014 @translationof Supported in MIDI
2016 @cindex hauteurs en MIDI
2017 @cindex MIDI, hauteurs
2018 @cindex quart de ton en MIDI
2019 @cindex MIDI, quart de ton
2020 @cindex microtonalité en MIDI
2021 @cindex MIDI, microtonalité
2022 @cindex accords nommés en MIDI
2023 @cindex MIDI, accords nommés
2024 @cindex Rythme en MIDI
2025 @cindex MIDI, Rythme
2028 Un fichier MIDI généré par LilyPond comprendra les éléments de notation
2036 les microtonalités -- voir @ref{Altérations}. Leur rendu nécessite
2037 cependant un lecteur qui prenne en charge la modulation@tie{};
2040 les accords nommés ;
2043 le rythme en tant que durée de note, y compris les nolets ;
2046 les tremolos, exceptés ceux utilisant la syntaxe
2047 @qq{@code{:}[@var{nombre}]}@tie{};
2050 les liaisons de prolongation ;
2053 les indications de nuance
2056 les crescendos et decrescendos s'étalant sur plusieurs notes@tie{};
2059 les changements de tempo indiqués par un @code{\tempo}@tie{};
2066 @unnumberedsubsubsec Éléments non pris en compte dans le MIDI
2067 @translationof Unsupported in MIDI
2069 @c TODO index as above
2071 LilyPond ne peut générer d'événement MIDI pour les éléments
2076 le rythme indiqué sous forme d'annotation (p.ex. @emph{swing})@tie{};
2079 les changements de tempo indiqués sous forme d'annotation (sans
2080 @code{\tempo})@tie{};
2083 les staccatos et autres articulations ou ornementations@tie{};
2086 les liaisons d'articulation et de prhasé@tie{};
2089 les crescendos ou decrescendos sur une sele note@tie{};
2092 les tremolos indiqués par la syntaxe @qq{@code{:}[@var{nombre}]}@tie{};
2098 les accords en microtonalité.
2102 @node Répétitions et MIDI
2103 @subsection Répétitions et MIDI
2104 @translationof Repeats in MIDI
2106 @cindex reprises développées
2107 @funindex \unfoldRepeats
2109 Au prix de quelques réglages, les reprises de toutes sortes peuvent être
2110 rendues dans le fichier MIDI. Il suffit pour cela de recourir à la
2111 fonction @code{\unfoldRepeats}, qui développe toutes les reprises. En
2112 d'autre termes, @code{\unfoldRepeats} transforme toutes les reprises
2113 en reprises de type @code{unfold}.
2116 @lilypond[quote,verbatim]
2118 \repeat tremolo 8 {c'32 e' }
2119 \repeat percent 2 { c''8 d'' }
2120 \repeat volta 2 {c'4 d' e' f'}
2129 Lorsque l'on veut utiliser @code{\unfoldRepeats} seulement pour le rendu
2130 MIDI, il faut établir deux blocs @code{\score}@tie{}: un pour le MIDI,
2131 avec des reprises explicites, et l'autre pour la partition, avec des
2132 reprises notées sous forme de barres de reprise, de trémolo ou de
2133 symboles de pourcentage. Par exemple
2141 \unfoldRepeats @var{..musique..}
2147 @node Gestion des nuances en MIDI
2148 @subsection Gestion des nuances en MIDI
2149 @translationof Controlling MIDI dynamics
2151 Les nuances MIDI sont générées par le @code{Dynamic_performer}, affecté
2152 par défaut au contexte @code{Voice}. Vous pouvez contrôler à la fois le
2153 volume général, celui des indications de nuance ainsi que celui des
2154 différents instruments.
2157 @unnumberedsubsubsec Indications de nuance
2158 @translationof Dynamic marks
2160 Les indications de nuances sont transcrites en fraction du volume MIDI.
2161 Nous allons, par défaut, de 0,25 pour un @notation{ppppp} à 0,95 pour un
2162 @notation{fffff}. Les correspondances entre nuance et fraction de
2163 volume sont répertoriées dans le fichier @file{../scm/midi.scm} --
2164 consultez la rubrique @rlearning{Autres sources de documentation} si
2165 vous ne savez comment le localiser. Vous pouvez modifier ou étendre ce
2166 jeu grâce à une fonction qui prendra en argument une indication de
2167 nuance et renverra la fraction désirée, puis en affectant cette fonction
2168 à @code{Score.dynamicAbsoluteVolumeFunction}.
2170 Prenons un exemple. Votre partition comporte un @notation{rinforzando}
2171 que vous avez indiqué par @code{\rfz}. Cette indication de nuance
2172 n'étant pas répertoriée dans le jeu par défaut, elle ne produira aucun
2173 effet en MIDI. Il en sera d'ailleurs de même pour toute indication
2174 créée de toute pièce à l'aide de l'instruction
2175 @code{make-dynamic-script}. Voici comment procéder pour ajuster le
2176 volume MIDI de ce @notation{rinforzando} que le compositeur a indiqué.
2177 La fonction Scheme définit une fraction de 0,9 en cas de @notation{rfz},
2178 et demande d'utiliser la fonction par défaut dans les autre cas.
2180 @lilypond[verbatim,quote]
2181 #(define (myDynamics dynamic)
2182 (if (equal? dynamic "rfz")
2184 (default-dynamic-absolute-volume dynamic)))
2188 \set Staff.midiInstrument = #"cello"
2189 \set Score.dynamicAbsoluteVolumeFunction = #myDynamics
2201 Si vous étiez amené à devoir modifier l'intégralité du jeu des
2202 correspondances, nous vous conseillons d'utiliser la procédure
2203 @command{default-dynamic-absolute-volume} contenue dans le fichier
2204 @file{../scm/midi.scm} ansi que la table d'association comme base. Le
2205 dernier exemple de cette partie illustre la manière de procéder.
2208 @unnumberedsubsubsec Amplitude du volume en MIDI
2209 @translationof Overall MIDI volume
2211 Les valeurs extrêmes du volume MIDI des nuances se contrôlent à l'aide
2212 des propriétés @code{midiMinimumVolume} et @code{midiMaximumVolume} qui
2213 agissent au niveau @code{Score}. Ces propriétés sont effectives dès
2214 lors qu'une nuance est indiquée@tie{}; une nuance de départ est donc
2215 requise pour que le volume soit ajusté dès le début de la partition.
2216 Vous pouvez alors modifier la fraction correspondant à chaque nuance à
2217 l'aide de la formule
2220 midiMinimumVolume + (midiMaximumVolume - midiMinimumVolume) * fraction
2223 Voici comment ajuster les nuances tout en limitant l'amplitude du volume
2224 entre 0,2 et 0,5@tie{}:
2226 @lilypond[verbatim,quote]
2232 \set Staff.midiInstrument = #"flute"
2233 \new Voice \relative c''' {
2241 \set Staff.midiInstrument = #"clarinet"
2242 \new Voice \relative c'' {
2253 tempoWholesPerMinute = #(ly:make-moment 72 2)
2254 midiMinimumVolume = #0.2
2255 midiMaximumVolume = #0.5
2262 @unnumberedsubsubsec Égalisation de plusieurs instruments (i)
2263 @translationof Equalizing different instruments (i)
2265 La définition de l'amplitude du volume MIDI au niveau d'un contexte
2266 @code{Staff} permet de gérer les volumes relatifs entre les différents
2267 instruments. Ceci constitue en quelque sorte un égaliseur, ce qui
2268 permet d'améliorer notablement la qualité de la sortie MIDI.
2270 La clarinette de l'exemple suivant jouera relativement moins fort que la
2271 flûte. Rappelez-vous que pour que cela fonctionne correctement, la
2272 première note de chacun des instruments doit être affublée d'une
2273 indication de nuance.
2275 @lilypond[verbatim,quote]
2281 \set Staff.midiInstrument = #"flute"
2282 \set Staff.midiMinimumVolume = #0.7
2283 \set Staff.midiMaximumVolume = #0.9
2284 \new Voice \relative c''' {
2292 \set Staff.midiInstrument = #"clarinet"
2293 \set Staff.midiMinimumVolume = #0.3
2294 \set Staff.midiMaximumVolume = #0.6
2295 \new Voice \relative c'' {
2306 tempoWholesPerMinute = #(ly:make-moment 72 2)
2313 @unnumberedsubsubsec Égalisation de plusieurs instruments (ii)
2314 @translationof Equalizing different instruments (ii)
2316 Lorsque les propriétés volume minimum et maximum n'ont pas été définies,
2317 LilyPond appliquera par défaut une légère égalisation pour quelques
2318 instruments. Les instrument concernés ainsi que le niveau d'égalisation
2319 sont répertoriés dans une table @notation{instrument-equalizer-alist}
2320 du fichier @file{../scm/midi.scm}.
2322 Vous pouvez remplacer l'égaliseur basique en définissant une nouvelle
2323 procédure Scheme @code{instrumentEqualizer} au sein du contexte
2324 @code{Score}. Cette procédure prend en unique argument le nom d'un
2325 instrument MIDI et renverra une paire de fractions correspondant au
2326 minimum et maximum de volume alloué à cet instrument. Cette
2327 substitution fonctionne selon le même principe que celui que nous avons
2328 vu en dédut de chapitre avec @code{dynamicAbsoluteVolumeFunction}.
2329 L'égaliseur par défaut, @notation{default-instrument-equalizer}, est
2330 défini dans le fichier @file{../scm/midi.scm}@tie{}; son analyse vous
2331 aidera à construire votre propre procédure.
2333 Nous allons, dans l'exemple suivant, régler le volume relatif de la
2334 flûte et de la clarinette -- au même niveau que dans le précédent.
2336 @lilypond[verbatim,quote]
2337 #(define my-instrument-equalizer-alist '())
2339 #(set! my-instrument-equalizer-alist
2342 ("flute" . (0.7 . 0.9))
2343 ("clarinet" . (0.3 . 0.6)))
2344 my-instrument-equalizer-alist))
2346 #(define (my-instrument-equalizer s)
2347 (let ((entry (assoc s my-instrument-equalizer-alist)))
2356 \set Score.instrumentEqualizer = #my-instrument-equalizer
2357 \set Staff.midiInstrument = #"flute"
2358 \new Voice \relative c''' {
2366 \set Staff.midiInstrument = #"clarinet"
2367 \new Voice \relative c'' {
2378 tempoWholesPerMinute = #(ly:make-moment 72 2)
2385 @c Delete when satisfied this is adequately covered elsewhere -td
2387 @n ode Microtones in MIDI
2388 @s ubsection Microtones in MIDI
2390 @cindex microtones in MIDI
2392 Microtones consisting of half sharps and half flats are exported
2393 to the MIDI file and render correctly in MIDI players which support
2394 pitch bending. See @ref{Note names in other languages}. Here is
2395 an example showing all the half sharps and half flats. It can be
2396 copied out and compiled to test microtones in your MIDI player.
2398 @lilypond[verbatim,quote]
2415 @node MIDI et percussions
2416 @subsection MIDI et percussions
2417 @translationof Percussion in MIDI
2419 La notation pour percussions recourt généralement à un contexte
2420 particulier -- le @code{DrumStaff} -- qui permet d'affecter directement
2421 les instruments concernés au canal@tie{}10 qui leur est réservé.
2423 Certains instruments, tels le xylophone, le marimba, le vibraphone ou
2424 les timbales, se traitent cependant comme des instruments
2425 @qq{classiques} puisqu'ils sont capables d'émettre des hauteurs
2426 différentes@tie{}; leurs notation relève donc d'un contexte @code{Staff}
2427 standard, et non d'un @code{DrumStaff} pour pouvoir être rendus
2428 correctement en MIDI.
2430 D'autres percussions, bien que n'émettant qu'un seul son et inclus dans
2431 le standard @emph{general MIDI}, comme le tom mélodique ou le tambour
2432 taiko, ne sont pas attachés au canal@tie{}10. Ces instruments doivent
2433 donc être saisi dans un contexte @code{Staff}, en utilisant la hauteur
2436 De nombreux instruments de la famille des percussions, les castagnettes
2437 par exemple, n'existent pas dans le standard @emph{general MIDI}.
2438 L'alternative, bien que peu satisfaisante, consiste à leur attribuer le
2439 son le plus proche dans la banque standard.
2441 @c TODO Expand with examples, and any other issues
2445 Le standard @emph{general MIDI} ne dispose pas du @emph{rim shot}@tie{};
2446 LilyPond lui subtitue un @emph{sidestick}.