1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
4 Translation of GIT committish: c768a19db993a4688e44db2b6e689cdebbffa860
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 }
1024 Fichiers d'initialisation :
1025 @file{../ly/toc-init.ly}.
1029 @funindex \table-of-contents
1030 @code{\table-of-contents},
1036 @node Travail sur des fichiers texte
1037 @section Travail sur des fichiers texte
1038 @translationof Working with input files
1041 * Insertion de fichiers LilyPond::
1042 * Différentes éditions à partir d'une même source::
1044 * Affichage de notation au format LilyPond::
1047 @node Insertion de fichiers LilyPond
1048 @subsection Insertion de fichiers LilyPond
1049 @translationof Including LilyPond files
1052 @cindex inclusion de fichiers
1054 Lorsqu'un projet prend de l'importance en volume, il est judicieux de le
1055 scinder en plusieurs fichiers, auxquels vous fereez référence avec un
1059 \include "autrefichier.ly"
1062 Une ligne @code{\include "autrefichier.ly"} dans un fichier revient à
1063 recopier intégralement le contenu de @file{autrefichier.ly} à l'endroit
1064 même ou est placée l'instruction @code{\include}. Vous pouvez par
1065 exemple écrire un fichier individuel par instrument, puis les regrouper
1066 pour former le fichier @qq{conducteur}. Les différentes variables
1067 définies dans les fichiers séparés seront normalement reprises et
1068 utilisables dans le fichier formant le conducteur. Les sections
1069 balisées dans les fichiers individuels peuvent être réutilisées en
1070 différents endroit de la partition , comme expliqué à la rubrique
1071 @ref{Différentes éditions à partir d'une même source}.
1073 Lorsque le fichier auquel il est fait référence se trouve dans le même
1074 répertoire, donner seulement son nom en argument à la commande
1075 @code{\include} suffit. S'il se trouve ailleurs, vous devrez indiquer
1076 le chemin d'accès, absolu ou relatif, en respectant toutefois la syntaxe
1077 UNIX -- autrement dit, le séparateur de répertoire est une oblique
1078 normale @code{/} et non l'oblique inverse @code{\} de DOS/Windows. Par
1079 exemple, si le fichier @file{truc.ly} se trouve dans le répertoire
1080 supérieur au répertoire de travail, la ligne devra être
1083 \include "../stuff.ly"
1087 ou bien, si les fichiers correspondant aux parties d'orchestre se
1088 trouvent dans le sous-répertoire @file{parties} relativement au
1089 répertoire courant, vous devrez mentionner
1092 \include "parties/VI.ly"
1093 \include "parties/VII.ly"
1097 Les fichiers à inclure peuvent eux-même contenir des instructions
1098 @code{\include}. Ces instructions @code{\include} de second niveau ne
1099 pourront, par défaut, être interprétées qu'une fois intégrées dans le
1100 fichier principal@tie{}; leur argument doit donc comporter le chemin
1101 relativement au fichier principal et non par rapport au fichier dan
1102 lesquel cette inclusion est mentionnée. Vous pouvez toutefois influer
1103 sur ce comportement à l'aide de l'option @code{-drelative-includes} en
1104 ligne de commande ou en ajoutant une clause
1105 @code{@w{#(ly:set-option 'relative-includes #t)}} en tête du fichier
1106 principal. Une fois @code{relative-include} activé, le chemin à suivre
1107 pour chacune des commandes @code{\include} sera pris relativement au
1108 fichier qui la contient.
1110 Vous pouvez inclure des fichiers dont vous spécifierez le chemin d'accès
1111 sur la ligne de commande au moment de lancer la compilation. L'appel à
1112 ces fichiers ne mentionnerra alors que leur nom. Par exemple, si vous
1113 voulez compiler avec cette méthode le fichier @file{principal.ly} qui
1114 inclut des fichiers situés dans le sous-répertoire @file{parties},
1115 placez vous dans le répertoire contenant @file{principal.ly}, puis tapez
1118 lilypond --include=parties principal.ly
1121 tout en ayant bien dans @file{principal.ly}
1129 Lorsqu'un fichier est voué à être inclus dans nombre de partitions, vous
1130 pouvez le placer dans le répertoire de LilyPond @file{../ly}.
1131 Attention@tie{}: ce répertoire varie selon votre installation, comme
1132 indiqué au chapitre @rlearning{Autres sources de documentation}. Ce
1133 fichier sera inclus dès lors que vous fournirez uniquement son nom en
1134 argument à la fonction @code{\include}. C'est par exemple le cas du
1135 fichier de définition particulier @file{gregorian.ly}.
1137 Au moment où vous lancez LilyPond, un certain nombre de fichiers se
1138 retrouvent inclus par défaut@tie{}; il suffit d'activer le mode verbeux
1139 en faisant @code{lilypond --verbose} pour s'en rendre compte. Vous
1140 verrez ainsi défiler, en plus de nombreuses informations, le nom d'un
1141 certain nombre de fichier et de chemins d'accès. Les fichiers les plus
1142 important sont mentionnés au chapitre
1143 @rlearning{Autres sources de documentation}. Si vous venez à les
1144 modifier, rappelez-vous qu'ils seront écrasés à l'installation d'une
1145 nouvelle version de LilyPond.
1147 Vous trouverez quelques exemples simples d'utilisation de la commande
1148 @code{\include} au chapitre @rlearning{Conducteurs et parties}.
1152 Manuel d'initiation :
1153 @rlearning{Autres sources de documentation},
1154 @rlearning{Conducteurs et parties}.
1159 Lorsque vous incluez un fichier qui porte le même nom que l'un des
1160 fichiers d'initialisation de LilyPond, le fichier de la distribution de
1161 LilyPond aura préséance.
1164 @node Différentes éditions à partir d'une même source
1165 @subsection Différentes éditions à partir d'une même source
1166 @translationof Different editions from one source
1168 Différents mécanismes permettent de générer plusieurs versions d'une
1169 partition à partir d'une même source. Les variables -- ou
1170 idendificateurs -- sont sûrement le moyen le plus simple de combiner de
1171 différente manière des passages relativement longs, alors que les
1172 balises permettront de sélectionner de courts fragments selon leur
1173 utilisation. Quelle que soit la méthode utilisée, séparer la notation
1174 de la structure de la partition vous donnera plus de liberté dans
1175 l'agencement de l'ouvrage final, puisque vous ne reviendrez pas sur la
1176 musique qui le compose.
1179 * Utilisation de variables::
1180 * Utilisation de balises::
1181 * Globalisation des réglages::
1184 @node Utilisation de variables
1185 @unnumberedsubsubsec Utilisation de variables
1186 @translationof Using variables
1188 @cindex variables, utilisation de
1190 Un fragment musical identifié par une variable est réutilisable à divers
1191 endroits de la partition, comme nous l'avons vu à la rubrique
1192 @rlearning{Organisation du code source avec des variables}. Par
1193 exemple, une partition pour chœur @notation{a cappella} comporte souvent
1194 une réduction pour piano reprenant toutes les voix@tie{}; il s'agit de
1195 la même musique, et vous ne devrez donc la saisir qu'une seule fois.
1196 D'autre part, la musique issue de deux variables peut se combiner sur
1197 une seule portée, comme nous l'avons vu à la rubrique
1198 @ref{Regroupement automatique de parties}. Prenons l'exemple
1201 @lilypond[verbatim,quote]
1202 sopranoMusic = \relative c'' { a4 b c b8( a) }
1203 altoMusic = \relative g' { e4 e e f }
1204 tenorMusic = \relative c' { c4 b e d8( c) }
1205 bassMusic = \relative c' { a4 gis a d, }
1206 allLyrics = \lyricmode {King of glo -- ry }
1208 \new Staff = "Soprano" \sopranoMusic
1209 \new Lyrics \allLyrics
1210 \new Staff = "Alto" \altoMusic
1211 \new Lyrics \allLyrics
1212 \new Staff = "Tenor" {
1216 \new Lyrics \allLyrics
1217 \new Staff = "Bass" {
1221 \new Lyrics \allLyrics
1224 \set Staff.printPartCombineTexts = ##f
1230 \set Staff.printPartCombineTexts = ##f
1240 Générer une partition chorale ou la réduction pour piano ne requiert que
1241 de modifier la structure des éléments, sans aucunement toucher à la
1244 Dans le cas d'une partition relativement longue, vous pouvez isoler la
1245 définition des différentes variables dans des fichiers séparés que vous
1246 rappellerez ensuite, comme indiqué à la rubrique
1247 @ref{Insertion de fichiers LilyPond}.
1250 @node Utilisation de balises
1251 @unnumberedsubsubsec Utilisation de balises
1252 @translationof Using tags
1255 @funindex \keepWithTag
1256 @funindex \removeWithTag
1260 La commande @code{\tag #'@var{partieA}} affecte à une expression
1261 musicale le nom @var{partieA}. Les expressions ainsi balisées pourront
1262 être filtrées par la suite, à l'aide de
1263 @code{\keepWithTag@tie{}#'@var{nom}} ou
1264 @code{\removeWithTag@tie{}#'@var{nom}}. Ces filtres fonctionnent de la
1265 manière suivante@tie{}:
1267 @multitable @columnfractions .5 .5
1272 Musique balisée précédée de @code{\keepWithTag #'@var{nom}}
1273 @tab Musique non balisée et musique balisée par @var{nom} seront
1274 incluses@tie{}; la musique balisée autrement est exclue.
1277 Musique balisée précédée de @code{\removeWithTag #'@var{nom}}
1278 @tab Musique non balisée et fragments appelés autrement que @var{nom}
1279 seront inclus@tie{}; la musique balisée par @var{nom} est exclue.
1282 Musiqeu balisée non précédée de @code{\keepWithTag} ou
1283 @code{\removeWithTag}
1284 @tab Musique balisée et non balisée seront incluses.
1288 Les arguments des commandes @code{\tag}, @code{\keepWithTag} et
1289 @code{\removeWithTag} doivent être un symbole (tel que
1290 @code{#'conducteur} ou @code{#'partie}), suivi d'une expression
1293 Dans l'exemple qui suit, nous obtenons deux versions du même extrait,
1294 l'une pour le conducteur, l'autre pour l'instrumentiste, et qui
1295 comportera les ornements développés.
1297 @lilypond[verbatim,quote]
1298 music = \relative g' {
1300 \tag #'trills { d8.\trill }
1301 \tag #'expand { \repeat unfold 3 { e32 d } }
1306 \keepWithTag #'trills \music
1309 \keepWithTag #'expand \music
1314 Il est parfois plus aisé d'exclure des fragments@tie{}:
1316 @lilypond[verbatim,quote]
1317 music = \relative g' {
1319 \tag #'trills { d8.\trill }
1320 \tag #'expand {\repeat unfold 3 { e32 d } }
1325 \removeWithTag #'expand
1329 \removeWithTag #'trills
1334 Ce principe de filtrage peut s'appliquer aux articulations, textes, etc.
1335 Il suffit de positionner
1338 -\tag #@var{ma-balise}
1342 avant l'articulation ou le texte, comme ici@tie{}:
1346 c1-\tag #'gaffe ^"Attention !"
1350 Ceci définira une note avec une indication conditionnelle de doigté ou
1353 Vous pouvez baliser différemment la même expression musicale en
1354 saisissant plusieurs @code{\tag}@tie{}:
1356 @lilypond[quote,verbatim]
1357 music = \relative c'' {
1358 \tag #'a \tag #'both { a4 a a a }
1359 \tag #'b \tag #'both { b4 b b b }
1362 \keepWithTag #'a \music
1363 \keepWithTag #'b \music
1364 \keepWithTag #'both \music
1368 L'application concomitante de plusieurs filtres @code{\removeWithTag} à
1369 la même expression musicale permet d'exclure plusieurs balisages@tie{}:
1371 @lilypond[verbatim,quote]
1372 music = \relative c'' {
1373 \tag #'A { a4 a a a }
1374 \tag #'B { b4 b b b }
1375 \tag #'C { c4 c c c }
1376 \tag #'D { d4 d d d }
1385 L'application de plus d'un filtre @code{\keepWithTag} à la même
1386 expression musicale aboutit à l'exclusion de @b{tous} les balisages.
1387 En effet, si le premier filtre exclut tous les autres balisages,
1388 l'application du second exclura les effets du premier.
1392 Manuel d'initiation :
1393 @rlearning{Organisation du code source avec des variables}.
1395 Manuel de notation :
1396 @ref{Regroupement automatique de parties},
1397 @ref{Insertion de fichiers LilyPond}.
1401 @c This warning is more general than this placement implies.
1402 @c Rests are not merged whether or not they come from tagged sections.
1403 @c Should be deleted? -td
1407 Lorsqu'elles comportent des silences, ceux-ci ne seront pas fusionnés
1408 si vous imprimez une partition avec les deux sections balisées.
1413 @node Globalisation des réglages
1414 @unnumberedsubsubsec Globalisation des réglages
1415 @translationof Using global settings
1417 @cindex include-settings
1419 Vous pouvez regrouper dans un fichier indépendant vos réglages
1420 personnels que vous incluerez au besoin@tie{}:
1423 lilypond -dinclude-settings=MES_REGLAGES.ly MA_PARTITION.ly
1426 Vous pouvez ainsi stocker dans un fichier séparé vos réglages en matière
1427 de format de papier, de fontes utilisées ou vos définitions
1428 particulières. Selon le fichier de réglages que vous mentionnerez, vous
1429 obtiendrez facilement différentes éditions à partir d'une même source
1430 quelle qu'elle soit.
1432 Ceete technique peut s'utiliser en combinaison avec des feuilles de
1433 styles, comme indiqué au chapitre @rlearning{Feuilles de style}.
1436 Manuel d'initiation :
1437 @rlearning{Organisation du code source avec des variables},
1438 @rlearning{Feuilles de style}.
1440 Manuel de notation :
1441 @ref{Insertion de fichiers LilyPond}.
1444 @node Codage du texte
1445 @subsection Codage du texte
1446 @translationof Text encoding
1450 @cindex non-ASCII characters
1452 LilyPond utilise le jeu de caractères défini par le consortium Unicode
1453 et la norme ISO/CEI@tie{}10646. Chaque caractère est identifié par un
1454 nom unique et associé à un point de code, ce qui permet dans l'absolu de
1455 couvrir tous les langages. Unicode permet de coder tous les caractères
1456 utilisés par toutes les langues écrites du monde. LilyPond utilise le
1457 codage UTF-8 (UTF pour @emph{Unicode Transformation Format}) qui permet
1458 de représenter les caractères latins sur un octet et les autres sur une
1459 longueur allant jusqu'à quatre octets.
1461 L'apparence réelle des caractères est déterminée par les glyphes ou
1462 graphèmes tels que définis dans les différentes polices disponibles.
1463 Une police, ou une fonte, définit la mise en correspondance d'un
1464 sous-ensemble de points de code unicode en glyphes. LilyPond recourt à
1465 la bibliothèque Pango pour assurer le rendu des textes multilingues.
1467 LilyPond n'effectue aucune conversion d'encodage que ce soit. Ceci
1468 implique donc que tout texte, qu'il s'agisse d'un titre, de paroles ou
1469 même d'instruction musicale, comportant des caractères non ASCII soit
1470 codé en UTF-8. Le plus sûr moyen de saisir du texte de la sorte
1471 consiste à utiliser un éditeur supportant l'unicode et à enregistrer vos
1472 fichier en UTF-8. C'est le cas pour la plupart des éditeurs actuels,
1473 que ce soit vim, Emacs, jEdit et GEdit. Tous les systèmes Windows
1474 postérieurs à NT utilisent Unicode en natif@tie{}; même Notepad est
1475 capable d'éditer et sauvegarder un fichie en UTF-8 -- sans parler de
1476 l'excellente alternative qu'est BabelPad.
1478 La compilation d'un fichier LilyPond comportant des caractères non ASCII
1479 qui n'aurait pas été enregistré dans l'encodage UTF-8 vous renverra
1483 FT_Get_Glyph_Name () erreur : invalid argument
1486 Voici un exemple utilisant du texte en cyrilique, en hébreux et en
1490 %c No verbatim here as the code does not display correctly in PDF
1492 bulgarian = \lyricmode {
1493 Жълтата дюля беше щастлива, че пухът, който цъфна, замръзна като гьон.
1497 hebrew = \lyricmode {
1498 זה כיף סתם לשמוע איך תנצח קרפד עץ טוב בגן.
1502 portuguese = \lyricmode {
1503 à vo -- cê uma can -- ção legal
1509 \addlyrics { \bulgarian }
1510 \addlyrics { \hebrew }
1511 \addlyrics { \portuguese }
1514 Lorsque vous avez besoin d'un caractère dont vous connaissez le point de
1515 code mais que votre éditeur ne permet pas de saisir directement, vous
1516 pouvez utitliser les instructions @code{\char@tie{}##xhhhh} ou
1517 @code{\char@tie{}#dddd} au sein d'un bloc @code{\markup} -- @code{hhhh}
1518 et @code{dddd} correspondant respectivement à la valeur hexadécimale ou
1519 décimale. Même s'il est inutile de saisir les zéros superflus, il est
1520 de bon ton de stipuler les quatre caractères formant la représentation
1521 hexadécimale. Évitez cependant l'encodage UTF-8 d'un point de code
1522 après un @code{\char}@tie{}; les encodages UTF-8 comprennent un bit
1523 supplémentaire indiquant le nombre d'octets. Une table de
1524 correspondance entre les codes Unicode et le nom des caractères ainsi
1525 que leur code hexadécimal est disponible sur le site du consortium
1526 Unicode, @uref{http://www.unicode.org/}.
1528 Par exemple, @code{\char ##x03BE} et @code{\char #958} correspondent
1529 tous deux au caractère unicode U+03BE, dénommé @qq{Greek Small Letter
1532 Quel que soit le point de code spécifié de cette manière, il ne vous
1533 sera alors pas nécessaire d'enregistrer votre fichier en UTF-8. Vous
1534 devrez toutefois disposer d'une fonte contenant ce caractère qui soit
1535 accessible à LilyPond.
1537 L'exemple suivant illustre la manière d'insérer un caractère sous sa
1538 forme hexadécimale, à la fois dans un repère, dans une articulation,
1539 dans des paroles et dans du texte indépendant.
1541 @lilypond[quote,verbatim]
1544 c1 \mark \markup { \char ##x03EE }
1545 c1_\markup { \tiny { \char ##x03B1 " to " \char ##x03C9 } }
1547 \addlyrics { O \markup { \concat { Ph \char ##x0153 be! } } }
1549 \markup { "Copyright 2008--2011" \char ##x00A9 }
1554 Le signe @emph{copyright} dans le champ de titrage consacré s'inscrit de
1555 la manière suivante@tie{}:
1559 copyright = \markup @{ \char ##x00A9 "2008" @}
1564 @node Affichage de notation au format LilyPond
1565 @subsection Affichage de notation au format LilyPond
1566 @translationof Displaying LilyPond notation
1568 @funindex \displayLilyMusic
1570 La fonction musicale @code{\displayLilyMusic}, disponible uniquement
1571 pour un traitement en ligne de commande, permet d'afficher en
1572 notation LilyPond une expression musicale. Par exemple,
1576 \displayLilyMusic \transpose c a, @{ c4 e g a bes @}
1583 @{ a,4 cis e fis g @}
1586 LilyPond affichera le résultat sous forme de message en console, au
1587 milieu de toutes les informations de compilation. Afin d'isoler ces
1588 messages et enregistrer le résultat de la fonction
1589 @code{\display@{STUFF@}}, pensez à rediriger la sortie vers un fichier.
1592 lilypond fichier.ly >display.txt
1596 @node Contrôle des sorties
1597 @section Contrôle des sorties
1598 @translationof Controlling output
1601 * Extraction de fragments musicaux::
1602 * Ignorer des passages de la partition::
1603 * Formats de sortie alternatifs::
1604 * Changement des fontes musicales::
1607 @node Extraction de fragments musicaux
1608 @subsection Extraction de fragments musicaux
1609 @translationof Extracting fragments of music
1611 LilyPond vous permet d'extraire des fragments d'une partition à l'instar
1612 du choriste amateur qui alimente son album avec des coupures de
1615 Vous devrez pour cela définir les mesures à découper. La définition
1616 suivante, incluse dans votre fichier source,
1623 (make-rhythmic-location 5 1 2)
1624 (make-rhythmic-location 7 3 4)))
1629 vous permettra d'extraire un fragment compris entre le milieu de la
1630 cinquième mesure et quelque part dans la septième. Le triplet
1631 @code{5@tie{}1@tie{}2} signifie@tie{}: après la durée d'une blanche dans
1632 la mesure 5@tie{}; le @code{7@tie{}3@tie{}4} signifie quant à lui que
1633 l'on s'arrête à la mesure 7, après la durée de trois noires.
1635 Rien ne vous empêche d'extraire plusieurs fragments, dès lors que vous
1636 définissez dans la liste d'autres paires d'emplacements ryhtmiques.
1638 Cette fonctionnalité n'est toutefois effective que lorsque vous lancez
1639 LilyPond avec l'option @code{-dclip-systems}. Les @qq{coupures} seront
1640 générées sous la forme de fichiers EPS, convertis en PDF ou PNG selon le
1641 format que vous aurez stipulé.
1643 Pour de plus amples informations quant au format des résultats,
1644 consultez le chapitre @rprogram{Lancement de lilypond}.
1647 @node Ignorer des passages de la partition
1648 @subsection Ignorer des passages de la partition
1649 @translationof Skipping corrected music
1651 @funindex skipTypesetting
1652 @funindex showFirstLength
1653 @funindex showLastLength
1655 Dans un travail de transcription ou de recopie de la musique, ce qui
1656 vous intéresse plus particulièrement se situe à la fin, là même où vous
1657 en êtes dans la notation. Dans le but de gagner du temps dans le
1658 processus de correction, vous pouvez @qq{escamoter} le reste et ne
1659 générer que les dernières mesures en insérant
1662 showLastLength = R1*5
1667 dans votre fichier source. Ceci aura pour effet de ne générer que les
1668 cinq dernières mesures -- si tant est que le morceau soit à 4/4 -- de
1669 tous les @code{\score} de votre fichier. Dans le cas d'un œuvre
1670 conséquente, cette pratique s'avère fort utile puisqu'elle évite de tout
1671 générer. Vous pourriez aussi être amené à retravailler le début d'une
1672 œuvre, pour y ajouter une partie par exemple, auquel cas c'est la
1673 propriété @code{showFirstLength} que vous utiliserez.
1675 Vous pouvez contrôler très finement les parties à escamoter, grâce u
1676 commutateur @code{Score.skipTypesetting}@tie{}: lorsqu'il est activé,
1677 aucune gravure n'est réalisée.
1679 Ce commutateur agit aussi sur la sortie MIDI. Notez bien que tous les
1680 événements seront escamotés, y compris les changements de tempo ou
1681 d'instrument -- vous voilà prévenu@tie{}!
1683 @lilypond[quote,relative=2,ragged-right,verbatim]
1685 \set Score.skipTypesetting = ##t
1687 \set Score.skipTypesetting = ##f
1691 Dans le cadre de musique polyphonique, @code{Score.skipTypesetting}
1692 s'applique à toutes les voix et portées. Vous gagnerez donc encore plus
1696 @node Formats de sortie alternatifs
1697 @subsection Formats de sortie alternatifs
1698 @translationof Alternative output formats
1700 @cindex scalable vector graphics
1701 @cindex SVG, format de sortie
1702 @cindex encapsulated postscript
1703 @cindex EPS, format de sortie
1705 En matière de partition imprimable, LilyPond génère par défaut des
1706 documents au format PstScript (PS) et Portable Document Format (PDF).
1707 Vous pouvez aussi obtenir des documents au format Scalable Vector
1708 Graphics (SVG), Encapsulated PostScript (EPS) ou Portable Network
1709 Graphics (PNG) dès lors que vous aurez lancé LilyPond en ligne de
1710 commande avec l'option @i{ad hoc} -- voir
1711 @rprogram{Options en ligne de commande pour lilypond} à ce sujet.
1714 @node Changement des fontes musicales
1715 @subsection Changement des fontes musicales
1716 @translationof Replacing the notation font
1718 Gonville est ube alternative à la fonte Feta que LilyPond utilise par
1719 défaut. Vous pouvez la télécharger à partir de
1721 @uref{http://www.chiark.greenend.org.uk/~sgtatham/gonville/ ,http://www.chiark.greenend.org.uk/~sgtatham/gonville/}
1724 Voici quelques mesures utilisant la police Gonville@tie{}:
1726 @c NOTE: these images are a bit big, but that's important
1727 @c for the font comparison. -gp
1728 @sourceimage{Gonville_after,,,}
1730 Et ces même mesures avec la police de LilyPond, Feta@tie{}:
1732 @sourceimage{Gonville_before,,,}
1735 @subsubheading Instructions d'installation pour MacOS
1736 @translationof Installation Instructions for MacOS
1738 Téléchargez puis décompressez l'archive zip. Recopiez le répertoire
1739 @code{lilyfonts} dans @file{@var{SHARE_DIR}/lilypond/current} -- voir
1740 @rlearning{Autres sources de documentation} à ce sujet. Renommez le
1741 répertoire @code{fonts} qui s'y trouve en @code{fonts_orig}, puis les
1742 répertoire @code{lilyfonts} en @code{fonts}. Il vous suffira, pour
1743 retrouver la fonte Feta, de renommer @code{fonts_orig} en @code{fonts}.
1747 Manuel d'initiation :
1748 @rlearning{Autres sources de documentation}.
1752 Gonville ne permet pas de générer de la notation ancienne. Consultez le
1753 site de l'auteur pour de plus amples informations ainsi qu'à propos des
1754 conditions d'utilisation.
1758 @section Sortie MIDI
1759 @translationof MIDI output
1761 MIDI (Musical Instrument Digital Interface) constitue un standard en
1762 matière de connexion et de contrôle des instruments électroniques. Un
1763 fichier MIDI contient une série de notes réparties dans différentes
1764 pistes. Il ne s'agit en rien d'un fichier sonore@tie{}; il vous faudra
1765 un logiciel capable de traduire ces séries de notes en sons.
1767 Vous pouvez convertir vos partition en fichier MIDI de manière à
1768 entendre ce que vous avez saisi. Ceci vous permet de contrôler aisément
1769 ce que vous avez saisi@tie{}: octaves et altérations erronées heuteront
1770 votre oreille avertie grâce au MIDI.
1773 Dans une sortie MIDI, LilyPond alloue un canal à chaque portée, plus un
1774 pour les réglages globaux. Par voie de conséquence, un fichier MIDI ne
1775 peut comporter au maximmum que quinze portées (quatorze en l'absence de
1776 percussions)@tie{}; les portées supplémentaires seront tout simplement
1780 * Création de fichiers MIDI::
1782 * Contenu de la sortie MIDI::
1783 * Répétitions et MIDI::
1784 * Gestion des nuances en MIDI::
1785 * MIDI et percussions::
1789 @node Création de fichiers MIDI
1790 @subsection Création de fichiers MIDI
1791 @translationof Creating MIDI files
1793 LilyPond génèrera un fichier MIDI dès que vous ajouterez un bloc
1794 @code{\midi} à la structure de votre partition, comme ici@tie{}:
1803 Lorsque le bloc @code{\score} contient un bloc @code{\midi} mais pas de
1804 bloc @code{\layout}, LilyPond ne produira qu'une sortie MIDI. Si donc
1805 vous avez besoin aussi d'un support visuel, vous devrez aussi mentionner
1806 un bloc @code{\layout}.
1816 Hauteurs, durées, liaisons de prolongation, nuances et changements de
1817 tempo seront interprétés et traduits en événements MIDI. Les
1818 indications de nuances, crescendos et decrescendos sont traduits en
1819 niveau de volume@tie{}; les indications sous la forme d'une fraction
1820 déterminée du volume disponible, et crescendos et decrescendos sous la
1821 forme d'une progression linéaire entre les deux extrêmes. Le rendu des
1822 indications de nuance peut être désactivé pour le MIDI -- voir
1825 Le tempo initial ainsi que ses changements sont normalement indiqués au
1826 fil de la notation à l'aide de la commande @code{\tempo}@tie{}; ils
1827 seront retranscrits dans le fichier MIDI. La commande @code{\tempo}
1828 donne lieu à l'impression d'une indication métronomique que vous pouvez
1829 toutefois rendre invisible, comme indiqué à la rubrique
1830 @ref{Indication métronomique}. Une autre manière de spécifier le tempo
1831 initial pour un fichier MIDI est indiquée plus avant -- voir
1834 En raison de certaines limitations de Windows, les fichiers MIDI doivent
1835 y porter l'extension @code{.mid}. D'autres systèmes utilisent
1836 l'extension @code{.midi}. Si besoin est, placez la ligne suivante au
1837 début de votre fichier source, avant l'ouverture de tout bloc
1838 @code{\book}, @code{\bookpart} ou @code{\score}@tie{}:
1841 #(ly:set-option 'midi-extension "midi")
1844 Cette ligne déterminera @code{.midi} comme extension par défaut pour les
1847 Vous pouvez aussi le faire en ligne de commande@tie{}:
1850 lilypond … -dmidi-extension=midi fichierLily.ly
1854 @unnumberedsubsubsec Noms d'instrument
1855 @translationof Instrument names
1857 @cindex instrument, nom d'
1858 @funindex Staff.midiInstrument
1860 L'instrument MIDI affecté à un canal particulier est déterminé par la
1861 propiété @code{Staff.midiInstrument}. Vous pouvez choisr l'un des
1862 instruments répertoriés à l'annexe @ref{Instruments MIDI}.
1866 \set Staff.midiInstrument = #"glockenspiel"
1872 \new Staff \with @{midiInstrument = #"cello"@} @{
1877 Lorsque l'instrument choisi ne correspond pas exactement à l'une des
1878 dénominations consacrées, LilyPond le replacera par un piano de concert
1879 (@code{"acoustic grand"}).
1884 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
1885 {changing-midi-output-to-one-channel-per-voice.ly}
1889 @c In 2.11 the following no longer seems to be a problem -td
1891 Un (de)crescendo non terminé ne sera pas correctement rendu en MIDI --
1892 il y a nécessairement du silence. Il vous faut donc lui donner une fin
1893 explicite. Par exemple,
1900 ne fonctionnera pas correctement, contrairement à
1903 @{ a4\< b c d\!\f @}
1907 Un changement de volume ne peut intervenir que sur le démarrage d'une
1908 note. C'est la raison pour laquelle la succession d'un crescendo et
1909 d'un diminuendo ne peut se produire sur une même note.
1911 Certains lecteurs MIDI ne rendent pas correctement les changements de
1912 tempo. MS Windows Media Player et
1913 @uref{http://@/timidity@/.sourceforge@/.net/,timidity} le font sans
1918 @subsection Le bloc MIDI
1919 @translationof MIDI block
1921 Dès lors que vous désirez obtenir une sortie MIDI, vous devrez inscrire
1922 un bloc @code{\midi} au sein du bloc @code{\score}. Son fonctionnement
1923 est comparable à ce lui du bloc @code{\layout}, voire plus simple. Si
1924 le bloc @code{\midi} est la plupart du temps laissé vide, il peut
1925 contenir des aménagements pour certains contextes, la définition de
1926 contextes particuliers ou du code permettant de déterminer la valeur de
1927 certianes propriétés. L'exemple suivant détermine le tempo initial du
1928 fichier MIDI tout en se passant de son indication sur la partition
1937 tempoWholesPerMinute = #(ly:make-moment 72 4)
1943 Ici, le tempo est fixé à 72 noires à la minute. Spécifier un tempo de
1944 la sorte ne permet pas de doner une valeur pour une note pointée. Vous
1945 devrez, en pareil cas, subdiviser la note pointée en durée plus courte.
1946 Par exemple, indiquer 90 à la noire pointée est équivalent à spécifier
1947 270 croches à la minute@tie{}:
1950 tempoWholesPerMinute = #(ly:make-moment 270 8)
1953 @cindex MIDI et définition de contexte
1954 @cindex contexte, définition en MIDI
1956 La syntaxe permettant de définir un contexte pour le @code{\midi} est en
1957 tout point identique à celle que vous utilisez dans le bloc
1958 @code{\layout}, à ceci près que le @qq{graveur} est remplacé par un
1959 @qq{interprète}. Les différents contextes disponibles en matière de
1960 MIDI sont répertoriés dans le fichier d'initialisation
1961 @file{../ly/performer-init.ly} -- pour plus de détail, voir
1962 @rlearning{Autres sources de documentation}.
1963 Si vous voulez vous passer des nuances dans votre fichier MIDI, il vous
1964 suffit d'insérer les lignes suivantes dans votre bloc
1972 \remove "Dynamic_performer"
1977 LilyPond ne génèrera de sortie MIDI que si vous incluez un bloc
1978 @code{\midi} dans la structure de la partition, initialisée par la
1979 commande @code{\score}.
1983 @{ @dots{}notes@dots{} @}
1989 @node Contenu de la sortie MIDI
1990 @subsection Contenu de la sortie MIDI
1991 @translationof What goes into the MIDI output?
1993 @c TODO Check grace notes - timing is suspect?
1996 @unnumberedsubsubsec Éléments pris en compte dans le MIDI
1997 @translationof Supported in MIDI
1999 @cindex hauteurs en MIDI
2000 @cindex MIDI, hauteurs
2001 @cindex quart de ton en MIDI
2002 @cindex MIDI, quart de ton
2003 @cindex microtonalité en MIDI
2004 @cindex MIDI, microtonalité
2005 @cindex accords nommés en MIDI
2006 @cindex MIDI, accords nommés
2007 @cindex Rythme en MIDI
2008 @cindex MIDI, Rythme
2011 Un fichier MIDI généré par LilyPond comprendra les éléments de notation
2019 les microtonalités -- voir @ref{Altérations}. Leur rendu nécessite
2020 cependant un lecteur qui prenne en charge la modulation@tie{};
2023 les accords nommés ;
2026 le rythme en tant que durée de note, y compris les nolets ;
2029 les tremolos, exceptés ceux utilisant la syntaxe
2030 @qq{@code{:}[@var{nombre}]}@tie{};
2033 les liaisons de prolongation ;
2036 les indications de nuance
2039 les crescendos et decrescendos s'étalant sur plusieurs notes@tie{};
2042 les changements de tempo indiqués par un @code{\tempo}@tie{};
2049 @unnumberedsubsubsec Éléments non pris en compte dans le MIDI
2050 @translationof Unsupported in MIDI
2052 @c TODO index as above
2054 LilyPond ne peut générer d'événement MIDI pour les éléments
2059 le rythme indiqué sous forme d'annotation (p.ex. @emph{swing})@tie{};
2062 les changements de tempo indiqués sous forme d'annotation (sans
2063 @code{\tempo})@tie{};
2066 les staccatos et autres articulations ou ornementations@tie{};
2069 les liaisons d'articulation et de prhasé@tie{};
2072 les crescendos ou decrescendos sur une sele note@tie{};
2075 les tremolos indiqués par la syntaxe @qq{@code{:}[@var{nombre}]}@tie{};
2081 les accords en microtonalité.
2085 @node Répétitions et MIDI
2086 @subsection Répétitions et MIDI
2087 @translationof Repeats in MIDI
2089 @cindex reprises développées
2090 @funindex \unfoldRepeats
2092 Au prix de quelques réglages, les reprises de toutes sortes peuvent être
2093 rendues dans le fichier MIDI. Il suffit pour cela de recourir à la
2094 fonction @code{\unfoldRepeats}, qui développe toutes les reprises. En
2095 d'autre termes, @code{\unfoldRepeats} transforme toutes les reprises
2096 en reprises de type @code{unfold}.
2099 @lilypond[quote,verbatim]
2101 \repeat tremolo 8 {c'32 e' }
2102 \repeat percent 2 { c''8 d'' }
2103 \repeat volta 2 {c'4 d' e' f'}
2112 Lorsque l'on veut utiliser @code{\unfoldRepeats} seulement pour le rendu
2113 MIDI, il faut établir deux blocs @code{\score}@tie{}: un pour le MIDI,
2114 avec des reprises explicites, et l'autre pour la partition, avec des
2115 reprises notées sous forme de barres de reprise, de trémolo ou de
2116 symboles de pourcentage. Par exemple
2124 \unfoldRepeats @var{..musique..}
2130 @node Gestion des nuances en MIDI
2131 @subsection Gestion des nuances en MIDI
2132 @translationof Controlling MIDI dynamics
2134 Les nuances MIDI sont générées par le @code{Dynamic_performer}, affecté
2135 par défaut au contexte @code{Voice}. Vous pouvez contrôler à la fois le
2136 volume général, celui des indications de nuance ainsi que celui des
2137 différents instruments.
2140 @unnumberedsubsubsec Indications de nuance
2141 @translationof Dynamic marks
2143 Les indications de nuances sont transcrites en fraction du volume MIDI.
2144 Nous allons, par défaut, de 0,25 pour un @notation{ppppp} à 0,95 pour un
2145 @notation{fffff}. Les correspondances entre nuance et fraction de
2146 volume sont répertoriées dans le fichier @file{../scm/midi.scm} --
2147 consultez la rubrique @rlearning{Autres sources de documentation} si
2148 vous ne savez comment le localiser. Vous pouvez modifier ou étendre ce
2149 jeu grâce à une fonction qui prendra en argument une indication de
2150 nuance et renverra la fraction désirée, puis en affectant cette fonction
2151 à @code{Score.dynamicAbsoluteVolumeFunction}.
2153 Prenons un exemple. Votre partition comporte un @notation{rinforzando}
2154 que vous avez indiqué par @code{\rfz}. Cette indication de nuance
2155 n'étant pas répertoriée dans le jeu par défaut, elle ne produira aucun
2156 effet en MIDI. Il en sera d'ailleurs de même pour toute indication
2157 créée de toute pièce à l'aide de l'instruction
2158 @code{make-dynamic-script}. Voici comment procéder pour ajuster le
2159 volume MIDI de ce @notation{rinforzando} que le compositeur a indiqué.
2160 La fonction Scheme définit une fraction de 0,9 en cas de @notation{rfz},
2161 et demande d'utiliser la fonction par défaut dans les autre cas.
2163 @lilypond[verbatim,quote]
2164 #(define (myDynamics dynamic)
2165 (if (equal? dynamic "rfz")
2167 (default-dynamic-absolute-volume dynamic)))
2171 \set Staff.midiInstrument = #"cello"
2172 \set Score.dynamicAbsoluteVolumeFunction = #myDynamics
2184 Si vous étiez amené à devoir modifier l'intégralité du jeu des
2185 correspondances, nous vous conseillons d'utiliser la procédure
2186 @command{default-dynamic-absolute-volume} contenue dans le fichier
2187 @file{../scm/midi.scm} ansi que la table d'association comme base. Le
2188 dernier exemple de cette partie illustre la manière de procéder.
2191 @unnumberedsubsubsec Amplitude du volume en MIDI
2192 @translationof Overall MIDI volume
2194 Les valeurs extrêmes du volume MIDI des nuances se contrôlent à l'aide
2195 des propriétés @code{midiMinimumVolume} et @code{midiMaximumVolume} qui
2196 agissent au niveau @code{Score}. Ces propriétés sont effectives dès
2197 lors qu'une nuance est indiquée@tie{}; une nuance de départ est donc
2198 requise pour que le volume soit ajusté dès le début de la partition.
2199 Vous pouvez alors modifier la fraction correspondant à chaque nuance à
2200 l'aide de la formule
2203 midiMinimumVolume + (midiMaximumVolume - midiMinimumVolume) * fraction
2206 Voici comment ajuster les nuances tout en limitant l'amplitude du volume
2207 entre 0,2 et 0,5@tie{}:
2209 @lilypond[verbatim,quote]
2215 \set Staff.midiInstrument = #"flute"
2216 \new Voice \relative c''' {
2224 \set Staff.midiInstrument = #"clarinet"
2225 \new Voice \relative c'' {
2236 tempoWholesPerMinute = #(ly:make-moment 72 2)
2237 midiMinimumVolume = #0.2
2238 midiMaximumVolume = #0.5
2245 @unnumberedsubsubsec Égalisation de plusieurs instruments (i)
2246 @translationof Equalizing different instruments (i)
2248 La définition de l'amplitude du volume MIDI au niveau d'un contexte
2249 @code{Staff} permet de gérer les volumes relatifs entre les différents
2250 instruments. Ceci constitue en quelque sorte un égaliseur, ce qui
2251 permet d'améliorer notablement la qualité de la sortie MIDI.
2253 La clarinette de l'exemple suivant jouera relativement moins fort que la
2254 flûte. Rappelez-vous que pour que cela fonctionne correctement, la
2255 première note de chacun des instruments doit être affublée d'une
2256 indication de nuance.
2258 @lilypond[verbatim,quote]
2264 \set Staff.midiInstrument = #"flute"
2265 \set Staff.midiMinimumVolume = #0.7
2266 \set Staff.midiMaximumVolume = #0.9
2267 \new Voice \relative c''' {
2275 \set Staff.midiInstrument = #"clarinet"
2276 \set Staff.midiMinimumVolume = #0.3
2277 \set Staff.midiMaximumVolume = #0.6
2278 \new Voice \relative c'' {
2289 tempoWholesPerMinute = #(ly:make-moment 72 2)
2296 @unnumberedsubsubsec Égalisation de plusieurs instruments (ii)
2297 @translationof Equalizing different instruments (ii)
2299 Lorsque les propriétés volume minimum et maximum n'ont pas été définies,
2300 LilyPond appliquera par défaut une légère égalisation pour quelques
2301 instruments. Les instrument concernés ainsi que le niveau d'égalisation
2302 sont répertoriés dans une table @notation{instrument-equalizer-alist}
2303 du fichier @file{../scm/midi.scm}.
2305 Vous pouvez remplacer l'égaliseur basique en définissant une nouvelle
2306 procédure Scheme @code{instrumentEqualizer} au sein du contexte
2307 @code{Score}. Cette procédure prend en unique argument le nom d'un
2308 instrument MIDI et renverra une paire de fractions correspondant au
2309 minimum et maximum de volume alloué à cet instrument. Cette
2310 substitution fonctionne selon le même principe que celui que nous avons
2311 vu en dédut de chapitre avec @code{dynamicAbsoluteVolumeFunction}.
2312 L'égaliseur par défaut, @notation{default-instrument-equalizer}, est
2313 défini dans le fichier @file{../scm/midi.scm}@tie{}; son analyse vous
2314 aidera à construire votre propre procédure.
2316 Nous allons, dans l'exemple suivant, régler le volume relatif de la
2317 flûte et de la clarinette -- au même niveau que dans le précédent.
2319 @lilypond[verbatim,quote]
2320 #(define my-instrument-equalizer-alist '())
2322 #(set! my-instrument-equalizer-alist
2325 ("flute" . (0.7 . 0.9))
2326 ("clarinet" . (0.3 . 0.6)))
2327 my-instrument-equalizer-alist))
2329 #(define (my-instrument-equalizer s)
2330 (let ((entry (assoc s my-instrument-equalizer-alist)))
2339 \set Score.instrumentEqualizer = #my-instrument-equalizer
2340 \set Staff.midiInstrument = #"flute"
2341 \new Voice \relative c''' {
2349 \set Staff.midiInstrument = #"clarinet"
2350 \new Voice \relative c'' {
2361 tempoWholesPerMinute = #(ly:make-moment 72 2)
2368 @c Delete when satisfied this is adequately covered elsewhere -td
2370 @n ode Microtones in MIDI
2371 @s ubsection Microtones in MIDI
2373 @cindex microtones in MIDI
2375 Microtones consisting of half sharps and half flats are exported
2376 to the MIDI file and render correctly in MIDI players which support
2377 pitch bending. See @ref{Note names in other languages}. Here is
2378 an example showing all the half sharps and half flats. It can be
2379 copied out and compiled to test microtones in your MIDI player.
2381 @lilypond[verbatim,quote]
2398 @node MIDI et percussions
2399 @subsection MIDI et percussions
2400 @translationof Percussion in MIDI
2402 La notation pour percussions recourt généralement à un contexte
2403 particulier -- le @code{DrumStaff} -- qui permet d'affecter directement
2404 les instruments concernés au canal@tie{}10 qui leur est réservé.
2406 Certains instruments, tels le xylophone, le marimba, le vibraphone ou
2407 les timbales, se traitent cependant comme des instruments
2408 @qq{classiques} puisqu'ils sont capables d'émettre des hauteurs
2409 différentes@tie{}; leurs notation relève donc d'un contexte @code{Staff}
2410 standard, et non d'un @code{DrumStaff} pour pouvoir être rendus
2411 correctement en MIDI.
2413 D'autres percussions, bien que n'émettant qu'un seul son et inclus dans
2414 le standard @emph{general MIDI}, comme le tom mélodique ou le tambour
2415 taiko, ne sont pas attachés au canal@tie{}10. Ces instruments doivent
2416 donc être saisi dans un contexte @code{Staff}, en utilisant la hauteur
2419 De nombreux instruments de la famille des percussions, les castagnettes
2420 par exemple, n'existent pas dans le standard @emph{general MIDI}.
2421 L'alternative, bien que peu satisfaisante, consiste à leur attribuer le
2422 son le plus proche dans la banque standard.
2424 @c TODO Expand with examples, and any other issues
2428 Le standard @emph{general MIDI} ne dispose pas du @emph{rim shot}@tie{};
2429 LilyPond lui subtitue un @emph{sidestick}.