1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
4 Translation of GIT committish: 97ecad3753202d0b887c669c05a4ced18bca5acb
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::
1183 @node Utilisation de variables
1184 @unnumberedsubsubsec Utilisation de variables
1185 @translationof Using variables
1187 @cindex variables, utilisation de
1189 Un fragment musical identifié par une variable est réutilisable à divers
1190 endroits de la partition, comme nous l'avons vu à la rubrique
1191 @rlearning{Organisation du code source avec des variables}. Par
1192 exemple, une partition pour chœur @notation{a cappella} comporte souvent
1193 une réduction pour piano reprenant toutes les voix@tie{}; il s'agit de
1194 la même musique, et vous ne devrez donc la saisir qu'une seule fois.
1195 D'autre part, la musique issue de deux variables peut se combiner sur
1196 une seule portée, comme nous l'avons vu à la rubrique
1197 @ref{Regroupement automatique de parties}. Prenons l'exemple
1200 @lilypond[verbatim,quote]
1201 sopranoMusic = \relative c'' { a4 b c b8( a) }
1202 altoMusic = \relative g' { e4 e e f }
1203 tenorMusic = \relative c' { c4 b e d8( c) }
1204 bassMusic = \relative c' { a4 gis a d, }
1205 allLyrics = \lyricmode {King of glo -- ry }
1207 \new Staff = "Soprano" \sopranoMusic
1208 \new Lyrics \allLyrics
1209 \new Staff = "Alto" \altoMusic
1210 \new Lyrics \allLyrics
1211 \new Staff = "Tenor" {
1215 \new Lyrics \allLyrics
1216 \new Staff = "Bass" {
1220 \new Lyrics \allLyrics
1223 \set Staff.printPartCombineTexts = ##f
1229 \set Staff.printPartCombineTexts = ##f
1239 Générer une partition chorale ou la réduction pour piano ne requiert que
1240 de modifier la structure des éléments, sans aucunement toucher à la
1243 Dans le cas d'une partition relativement longue, vous pouvez isoler la
1244 définition des différentes variables dans des fichiers séparés que vous
1245 rappellerez ensuite, comme indiqué à la rubrique
1246 @ref{Insertion de fichiers LilyPond}.
1249 @node Utilisation de balises
1250 @unnumberedsubsubsec Utilisation de balises
1251 @translationof Using tags
1254 @funindex \keepWithTag
1255 @funindex \removeWithTag
1259 La commande @code{\tag #'@var{partieA}} affecte à une expression
1260 musicale le nom @var{partieA}. Les expressions ainsi balisées pourront
1261 être filtrées par la suite, à l'aide de
1262 @code{\keepWithTag@tie{}#'@var{nom}} ou
1263 @code{\removeWithTag@tie{}#'@var{nom}}. Ces filtres fonctionnent de la
1264 manière suivante@tie{}:
1266 @multitable @columnfractions .5 .5
1271 Musique balisée précédée de @code{\keepWithTag #'@var{nom}}
1272 @tab Musique non balisée et musique balisée par @var{nom} seront
1273 incluses@tie{}; la musique balisée autrement est exclue.
1276 Musique balisée précédée de @code{\removeWithTag #'@var{nom}}
1277 @tab Musique non balisée et fragments appelés autrement que @var{nom}
1278 seront inclus@tie{}; la musique balisée par @var{nom} est exclue.
1281 Musiqeu balisée non précédée de @code{\keepWithTag} ou
1282 @code{\removeWithTag}
1283 @tab Musique balisée et non balisée seront incluses.
1287 Les arguments des commandes @code{\tag}, @code{\keepWithTag} et
1288 @code{\removeWithTag} doivent être un symbole (tel que
1289 @code{#'conducteur} ou @code{#'partie}), suivi d'une expression
1292 Dans l'exemple qui suit, nous obtenons deux versions du même extrait,
1293 l'une pour le conducteur, l'autre pour l'instrumentiste, et qui
1294 comportera les ornements développés.
1296 @lilypond[verbatim,quote]
1297 music = \relative g' {
1299 \tag #'trills { d8.\trill }
1300 \tag #'expand { \repeat unfold 3 { e32 d } }
1305 \keepWithTag #'trills \music
1308 \keepWithTag #'expand \music
1313 Il est parfois plus aisé d'exclure des fragments@tie{}:
1315 @lilypond[verbatim,quote]
1316 music = \relative g' {
1318 \tag #'trills { d8.\trill }
1319 \tag #'expand {\repeat unfold 3 { e32 d } }
1324 \removeWithTag #'expand
1328 \removeWithTag #'trills
1333 Ce principe de filtrage peut s'appliquer aux articulations, textes, etc.
1334 Il suffit de positionner
1337 -\tag #@var{ma-balise}
1341 avant l'articulation ou le texte, comme ici :
1345 c1-\tag #'gaffe ^"Attention !"
1349 Ceci définira une note avec une indication conditionnelle de doigté ou
1352 Vous pouvez baliser différemment la même expression musicale en
1353 saisissant plusieurs @code{\tag}@tie{}:
1355 @lilypond[quote,verbatim]
1356 music = \relative c'' {
1357 \tag #'a \tag #'both { a4 a a a }
1358 \tag #'b \tag #'both { b4 b b b }
1361 \keepWithTag #'a \music
1362 \keepWithTag #'b \music
1363 \keepWithTag #'both \music
1367 L'application concomitante de plusieurs filtres @code{\removeWithTag} à
1368 la même expression musicale permet d'exclure plusieurs balisages@tie{}:
1370 @lilypond[verbatim,quote]
1371 music = \relative c'' {
1372 \tag #'A { a4 a a a }
1373 \tag #'B { b4 b b b }
1374 \tag #'C { c4 c c c }
1375 \tag #'D { d4 d d d }
1384 L'application de plus d'un filtre @code{\keepWithTag} à la même
1385 expression musicale aboutit à l'exclusion de @b{tous} les balisages.
1386 En effet, si le premier filtre exclut tous les autres balisages,
1387 l'application du second exclura les effets du premier.
1391 Manuel d'initiation :
1392 @rlearning{Organisation du code source avec des variables}.
1394 Manuel de notation :
1395 @ref{Regroupement automatique de parties},
1396 @ref{Insertion de fichiers LilyPond}.
1400 @c This warning is more general than this placement implies.
1401 @c Rests are not merged whether or not they come from tagged sections.
1402 @c Should be deleted? -td
1406 Lorsqu'elles comportent des silences, ceux-ci ne seront pas fusionnés
1407 si vous imprimez une partition avec les deux sections balisées.
1412 @node Codage du texte
1413 @subsection Codage du texte
1414 @translationof Text encoding
1418 @cindex non-ASCII characters
1420 LilyPond utilise le jeu de caractères défini par le consortium Unicode
1421 et la norme ISO/CEI@tie{}10646. Chaque caractère est identifié par un
1422 nom unique et associé à un point de code, ce qui permet dans l'absolu de
1423 couvrir tous les langages. Unicode permet de coder tous les caractères
1424 utilisés par toutes les langues écrites du monde. LilyPond utilise le
1425 codage UTF-8 (UTF pour @emph{Unicode Transformation Format}) qui permet
1426 de représenter les caractères latins sur un octet et les autres sur une
1427 longueur allant jusqu'à quatre octets.
1429 L'apparence réelle des caractères est déterminée par les glyphes ou
1430 graphèmes tels que définis dans les différentes polices disponibles.
1431 Une police, ou une fonte, définit la mise en correspondance d'un
1432 sous-ensemble de points de code unicode en glyphes. LilyPond recourt à
1433 la bibliothèque Pango pour assurer le rendu des textes multilingues.
1435 LilyPond n'effectue aucune conversion d'encodage que ce soit. Ceci
1436 implique donc que tout texte, qu'il s'agisse d'un titre, de paroles ou
1437 même d'instruction musicale, comportant des caractères non ASCII soit
1438 codé en UTF-8. Le plus sûr moyen de saisir du texte de la sorte
1439 consiste à utiliser un éditeur supportant l'unicode et à enregistrer vos
1440 fichier en UTF-8. C'est le cas pour la plupart des éditeurs actuels,
1441 que ce soit vim, Emacs, jEdit et GEdit. Tous les systèmes Windows
1442 postérieurs à NT utilisent Unicode en natif@tie{}; même Notepad est
1443 capable d'éditer et sauvegarder un fichie en UTF-8 -- sans parler de
1444 l'excellente alternative qu'est BabelPad.
1446 La compilation d'un fichier LilyPond comportant des caractères non ASCII
1447 qui n'aurait pas été enregistré dans l'encodage UTF-8 vous renverra
1451 FT_Get_Glyph_Name () erreur : invalid argument
1454 Voici un exemple utilisant du texte en cyrilique, en hébreux et en
1458 %c No verbatim here as the code does not display correctly in PDF
1460 bulgarian = \lyricmode {
1461 Жълтата дюля беше щастлива, че пухът, който цъфна, замръзна като гьон.
1465 hebrew = \lyricmode {
1466 זה כיף סתם לשמוע איך תנצח קרפד עץ טוב בגן.
1470 portuguese = \lyricmode {
1471 à vo -- cê uma can -- ção legal
1477 \addlyrics { \bulgarian }
1478 \addlyrics { \hebrew }
1479 \addlyrics { \portuguese }
1482 Lorsque vous avez besoin d'un caractère dont vous connaissez le point de
1483 code mais que votre éditeur ne permet pas de saisir directement, vous
1484 pouvez utitliser les instructions @code{\char@tie{}##xhhhh} ou
1485 @code{\char@tie{}#dddd} au sein d'un bloc @code{\markup} -- @code{hhhh}
1486 et @code{dddd} correspondant respectivement à la valeur hexadécimale ou
1487 décimale. Même s'il est inutile de saisir les zéros superflus, il est
1488 de bon ton de stipuler les quatre caractères formant la représentation
1489 hexadécimale. Évitez cependant l'encodage UTF-8 d'un point de code
1490 après un @code{\char}@tie{}; les encodages UTF-8 comprennent un bit
1491 supplémentaire indiquant le nombre d'octets. Une table de
1492 correspondance entre les codes Unicode et le nom des caractères ainsi
1493 que leur code hexadécimal est disponible sur le site du consortium
1494 Unicode, @uref{http://www.unicode.org/}.
1496 Par exemple, @code{\char ##x03BE} et @code{\char #958} correspondent
1497 tous deux au caractère unicode U+03BE, dénommé @qq{Greek Small Letter
1500 Quel que soit le point de code spécifié de cette manière, il ne vous
1501 sera alors pas nécessaire d'enregistrer votre fichier en UTF-8. Vous
1502 devrez toutefois disposer d'une fonte contenant ce caractère qui soit
1503 accessible à LilyPond.
1505 L'exemple suivant illustre la manière d'insérer un caractère sous sa
1506 forme hexadécimale, à la fois dans un repère, dans une articulation,
1507 dans des paroles et dans du texte indépendant.
1509 @lilypond[quote,verbatim]
1512 c1 \mark \markup { \char ##x03EE }
1513 c1_\markup { \tiny { \char ##x03B1 " to " \char ##x03C9 } }
1515 \addlyrics { O \markup { \concat { Ph \char ##x0153 be! } } }
1517 \markup { "Copyright 2008--2010" \char ##x00A9 }
1522 Le signe @emph{copyright} dans le champ de titrage consacré s'inscrit de
1523 la manière suivante@tie{}:
1527 copyright = \markup @{ \char ##x00A9 "2008" @}
1532 @node Affichage de notation au format LilyPond
1533 @subsection Affichage de notation au format LilyPond
1534 @translationof Displaying LilyPond notation
1536 @funindex \displayLilyMusic
1538 La fonction musicale @code{\displayLilyMusic}, disponible uniquement
1539 pour un traitement en ligne de commande, permet d'afficher en
1540 notation LilyPond une expression musicale. Par exemple,
1544 \displayLilyMusic \transpose c a, @{ c4 e g a bes @}
1551 @{ a,4 cis e fis g @}
1554 LilyPond affichera le résultat sous forme de message en console, au
1555 milieu de toutes les informations de compilation. Afin d'isoler ces
1556 messages et enregistrer le résultat de la fonction
1557 @code{\display@{STUFF@}}, pensez à rediriger la sortie vers un fichier.
1560 lilypond fichier.ly >display.txt
1564 @node Contrôle des sorties
1565 @section Contrôle des sorties
1566 @translationof Controlling output
1572 * Extraction de fragments musicaux::
1573 * Ignorer des passages de la partition::
1574 * Formats de sortie alternatifs::
1575 * Changement des fontes musicales::
1578 @node Extraction de fragments musicaux
1579 @subsection Extraction de fragments musicaux
1580 @translationof Extracting fragments of music
1585 @node Ignorer des passages de la partition
1586 @subsection Ignorer des passages de la partition
1587 @translationof Skipping corrected music
1592 @node Formats de sortie alternatifs
1593 @subsection Formats de sortie alternatifs
1594 @translationof Alternative output formats
1599 @node Changement des fontes musicales
1600 @subsection Changement des fontes musicales
1601 @translationof Replacing the notation font
1606 @subsubheading Instructions d'installation pour MacOS
1607 @translationof Installation Instructions for MacOS
1613 @section Sortie MIDI
1614 @translationof MIDI output
1620 * Création de fichiers MIDI::
1622 * Contenu de la sortie MIDI::
1623 * Répétitions et MIDI::
1624 * Gestion des nuances en MIDI::
1625 * MIDI et percussions::
1628 @node Création de fichiers MIDI
1629 @subsection Création de fichiers MIDI
1630 @translationof Creating MIDI files
1635 @unnumberedsubsubsec Noms d'instrument
1636 @translationof Instrument names
1640 @subsection Le bloc MIDI
1641 @translationof MIDI block
1646 @node Contenu de la sortie MIDI
1647 @subsection Contenu de la sortie MIDI
1648 @translationof What goes into the MIDI output?
1653 @unnumberedsubsubsec Éléments pris en compte dans le MIDI
1654 @translationof Supported in MIDI
1655 @unnumberedsubsubsec Éléments non pris en compte dans le MIDI
1656 @translationof Unsupported in MIDI
1658 @node Répétitions et MIDI
1659 @subsection Répétitions et MIDI
1660 @translationof Repeats in MIDI
1662 @cindex reprises développées
1663 @funindex \unfoldRepeats
1665 Au prix de quelques réglages, les reprises de toutes sortes peuvent être
1666 rendues dans le fichier MIDI. Il suffit pour cela de recourir à la
1667 fonction @code{\unfoldRepeats}, qui développe toutes les reprises. En
1668 d'autre termes, @code{\unfoldRepeats} transforme toutes les reprises
1669 en reprises de type @code{unfold}.
1672 @lilypond[quote,verbatim,fragment,line-width=8.0\cm]
1674 \repeat tremolo 8 {c'32 e' }
1675 \repeat percent 2 { c''8 d'' }
1676 \repeat volta 2 {c'4 d' e' f'}
1686 Lorsque l'on veut utiliser @code{\unfoldRepeats} seulement pour le rendu
1687 MIDI, il faut établir deux blocs @code{\score} : un pour le MIDI, avec
1688 des reprises explicites, et l'autre pour la partition, avec des reprises
1689 notées sous forme de barres de reprise, de trémolo ou de symboles de
1690 pourcentage. Par exemple
1698 \unfoldRepeats @var{..musique..}
1704 @node Gestion des nuances en MIDI
1705 @subsection Gestion des nuances en MIDI
1706 @translationof Controlling MIDI dynamics
1711 @unnumberedsubsubsec Indications de nuance
1712 @translationof Dynamic marks
1713 @unnumberedsubsubsec Amplitude du volume en MIDI
1714 @translationof Overall MIDI volume
1715 @unnumberedsubsubsec Égalisation de plusieurs instruments (i)
1716 @translationof Equalizing different instruments (i)
1717 @unnumberedsubsubsec Égalisation de plusieurs instruments (ii)
1718 @translationof Equalizing different instruments (ii)
1721 @node MIDI et percussions
1722 @subsection MIDI et percussions
1723 @translationof Percussion in MIDI