1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
4 Translation of GIT committish: d084673892e96cf36b6511e3b6e9a30c407fbd42
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: Ludovic Sardain, Jean-Charles Malahieude
14 @c Translation checkers: Jean-Yves Baudais, Valentin Villenave, John Mandereau
16 @node Suggestions pour la saisie de fichiers LilyPond
17 @chapter Suggestions pour la saisie de fichiers LilyPond
18 @translationof Suggestions for writing files
20 Maintenant vous êtes prêt à travailler sur de plus gros fichiers
21 LilyPond -- des pièces entières, et plus seulement les petits
22 exemples du tutoriel. Mais comment devriez-vous vous y prendre ?
24 Tant que LilyPond parvient à comprendre vos fichiers et produit le
25 résultat que vous souhaitez, peu importe la manière dont le code est
26 organisé. Néanmoins, quelques critères doivent être pris en compte
27 lorsque l'on écrit un fichier LilyPond.
31 Si vous faites une erreur, la structure même du fichier LilyPond
32 peut permettre de la localiser plus ou moins facilement.
35 Et si vous souhaitez partager vos fichiers avec quelqu'un d'autre, ou si
36 vous souhaitez modifier vos propres fichiers dans quelques années ?
37 Si certains fichiers LilyPond sont compréhensibles au premier coup
38 d'œil, d'autres vous feront vous arracher les cheveux pendant une heure.
41 Et si vous souhaitez mettre à jour votre fichier pour l'utiliser avec
42 une version plus récente de LilyPond ? La syntaxe du langage d'entrée
43 change parfois lorsque LilyPond s'améliore. La plupart des changements
44 peuvent être appliqués automatiquement avec @code{convert-ly}, mais
45 quelques-uns peuvent requérir une intervention manuelle. Vos fichiers
46 LilyPond peuvent être structurés de manière à faciliter leur mise à
51 * Suggestions générales::
52 * Gravure de musique existante::
53 * Projets d'envergure::
54 * Résolution de problèmes::
55 * De la commande make et des fichiers Makefile::
59 @node Suggestions générales
60 @section Suggestions générales
61 @translationof General suggestions
63 Voici quelques conseils qui vous permettront d'éviter, voire même
64 résoudre, la plupart des problèmes de saisie.
67 @item @strong{Ajoutez toujours le numéro de version dans chaque
68 fichier}, quelle que soit sa taille. Par expérience, il est très
69 difficile de se rappeler quelle version de LilyPond a servi au moment de
70 la création d'un fichier. Ceci s'avèrera d'autant plus utile lors d'une
71 @rprogramnamed{Mise à jour avec convert-ly, mise à jour}
72 (@command{convert-ly} requiert la présence d'une ligne @code{\version})
73 ou si vous transmettez votre fichier à d'autres utilisateurs -- y
74 compris pour demander de l'aide sur les listes de diffusion. Vous
75 noterez par ailleurs que tous les fichiers modèles de LilyPond ont une
76 mention @code{\version}.
78 @item @strong{Une mesure par ligne de texte}.
79 Si la musique en elle-même ou le résultat que vous désirez contient
80 quelque chose de compliqué, il est souvent bon de n'écrire qu'une seule
81 mesure par ligne. Économiser de la place en tassant huit mesures par
82 ligne, ça ne vaut pas vraiment le coup si l'on doit corriger vos
85 @item @strong{Ajoutez des contrôles
86 @rusernamed{Vérifications d'octave,d'octaviation} et
87 @rusernamed{Vérification des limites et numéros de mesure,de limite ou
88 numéro de mesure}}. Si vous avez ajouté des contrôles de loin en loin
89 et que vous faites une erreur, vous pourrez la retrouver plus
90 rapidement. « De loin en loin », qu'est-ce à dire ? Cela dépend
91 de la complexité de la musique. Pour de la musique très simple, à
92 certains endroits stratégiques. Pour de la musique très complexe ou
93 avec une multiplicité de voix, peut-être à chaque mesure.
95 @item @strong{Ajoutez des commentaires}.
96 Utilisez soit des numéros de mesure (assez souvent), soit des références
97 au contenu musical -- « second thème des violons », « quatrième
98 variation », etc. Vous pouvez ne pas avoir besoin des commentaires
99 lorsque vous écrivez une pièce pour la première fois, mais si vous
100 souhaitez y revenir deux ou trois ans plus tard pour changer quelque
101 chose, ou si vous donnez le fichier source à un ami, ce sera beaucoup
102 plus difficile de déterminer vos intentions ou la manière dont votre
103 fichier est structuré si vous n'y avez pas adjoint de commentaires.
105 @item @strong{Mentionnez les durées au début de chaque section ou
106 variable}. Si vous saisissez @code{c4 d e} au début d'une phrase, vous
107 vous épargnerez des problèmes si, plus tard, vous modifiez votre
110 @item @strong{Indentez les accolades et indications de musique en parallèle}.
111 Beaucoup de problèmes viennent d'un défaut de parité entre @code{@{} et
112 @code{@}} ou @code{<<} et @code{>>}. Par exemple,
132 est bien plus facile à appréhender que
135 \new Staff @{ \relative @{ r4 g'8 g c4 c8 d | e4 r8
137 << @{ f8 c c @} \new Staff @{ f8 f c @} >> r4 | @} @}
141 @item @strong{Séparez les affinages de mise en forme}
142 de la musique elle-même, ne serait-ce qu'en positionnant les dérogations
143 au sein du bloc @code{\layout} :
147 @var{@dots{}musique@dots{}}
149 \override TabStaff.Stemstencil = ##f
154 Ceci n'aura par pour effet de générer un contexte supplémentaire, mais
155 s'appliquera dès sa création. Voyez
156 @rlearning{Économie de saisie grâce aux identificateurs et fonctions} et
157 @rlearning{Feuilles de style}.
162 @node Gravure de musique existante
163 @section Gravure de musique existante
164 @translationof Typesetting existing music
166 Si vous saisissez de la musique à partir d'une partition existante,
167 c'est-à-dire de la musique déjà écrite,
172 n'entrez qu'un seul système de la partition originale
173 à la fois -- avec toujours une seule mesure par ligne de texte --,
174 et vérifiez chaque système lorsqu'il est terminé. Vous pouvez
175 utiliser les commandes @code{showLastLength} et @code{showFirstLength}
176 pour accélérer la compilation -- voir
177 @ruser{Ignorer des passages de la partition} ;
180 définissez @code{mBreak = @{ \break @}} et insérez @code{\mBreak} dans
181 le fichier d'entrée pour obtenir des sauts de ligne identiques à la
182 partition originale. Cela facilite la comparaison entre la partition
183 originale et la partition de LilyPond. Lorsque vous avez fini de relire
184 votre musique, vous pouvez définir @code{mBreak = @{ @}}
185 pour enlever tous ces sauts de ligne, et laisser LilyPond placer les
186 sauts de ligne selon son propre algorithme ;
189 encadrez les notes d'une partie pour instrument transpositeur dans un
192 \transpose c @var{tonalité-naturelle} @{@dots{}@}
196 (où @var{tonalité-naturelle} correspond à celle de l'instrument en
197 question) de telle sorte que la musique comprise dans cette variable se
198 retrouve en ut. Vous pourrez toujours transposer à l'inverse si besoin
199 lorsque vous ferez appel à cette variable. Des erreurs de transposition
200 seront moins susceptibles de se produire si la musique de toutes les
201 variables est dans la même et unique tonalité.
203 De la même manière, prenez toujours le do comme note de départ ou
204 d'arrivée. Ceci aura pour simple conséquence que les autres tonalités
205 que vous utiliserez seront celles propres à chacun des instruments --
206 sib pour une trompette en si bémol, ou lab pour une clarinette en la bémol.
211 @node Projets d'envergure
212 @section Projets d'envergure
213 @translationof Large projects
215 Lorsque l'on travaille sur un gros projet, il devient vital de
216 structurer clairement ses fichiers LilyPond.
220 @item @strong{Utilisez un identificateur pour chaque voix},
221 avec un minimum de structure dans la définition. La structure de la
222 section @code{\score} est la plus susceptible de changer, notamment
223 dans une nouvelle version de LilyPond, alors que la définition du
224 @code{violon} l'est beaucoup moins.
227 violon = \relative @{
240 @item @strong{Séparez les retouches des définitions de musique}.
241 Nous vous avons déjà invité à adopter une telle pratique, qui
242 par ailleurs devient vitale pour des projets d'importance. Nous
243 pouvons avoir besoin de changer la définition de @code{fpuisp}, mais
244 dans ce cas nous n'aurons besoin de le faire qu'une seule fois, et nous
245 pourrons encore éviter de modifier quoi que ce soit à l'intérieur de la
246 définition du @code{violon}.
250 \dynamic f \italic \small @{ 2nd @} \hspace #0.1 \dynamic p @}
251 violon = \relative @{
259 @node Résolution de problèmes
260 @section Résolution de problèmes
261 @translationof Troubleshooting
263 Tôt ou tard, vous écrirez un fichier que LilyPond ne peut pas
264 compiler. Les messages que LilyPond affiche peuvent vous aider à
265 trouver l'erreur, mais dans beaucoup de cas vous aurez besoin de faire
266 quelques recherches pour déterminer la source du problème.
268 Pour ce faire, les outils les plus puissants sont le commentaire de
269 fin de ligne, indiqué par @code{%}, et le commentaire multilignes (ou
270 bloc de commentaire), indiqué par @code{%@{ @dots{} %@}}. Si vous ne
271 pouvez localiser le problème, commencez par mettre en commentaire de
272 grandes parties de votre fichier source. Après avoir mis en
273 commentaire une section, essayez de compiler à nouveau. Si cela
274 fonctionne, c'est que le problème se situe dans cette partie du
275 fichier. Si cela ne fonctionne pas, continuez à mettre en commentaire
276 d'autres sections, jusqu'à ce que vous ayez quelque chose qui compile.
278 Dans un cas extrême, vous pourriez en arriver à
292 c'est-à-dire un fichier sans aucune musique.
294 Si cela se produit, ne vous découragez pas. Décommentez un peu, la
295 partie de basse par exemple, et voyez si ça fonctionne. Si ce n'est pas
296 le cas, placez en commentaire toute la partie de basse, mais laissez
297 @code{\basse} décommenté dans le bloc @code{\score}.
308 Maintenant commencez à décommenter petit à petit la partie de
309 @code{basse} jusqu'à ce que vous localisiez la ligne qui pose
312 Une autre technique de débogage très utile est la construction
313 d'un @rwebnamed{Exemples minimaux,exemple minimaliste}.
316 @node De la commande make et des fichiers Makefile
317 @section De la commande make et des fichiers Makefile
318 @translationof Make and Makefiles
323 La plupart des plates-formes sur lesquelles tourne LilyPond disposent
324 d'un logiciel appelé @code{make}. Ce logiciel va lire un fichier
325 spécial, nommé @code{Makefile}, qui contient tout ce qu'il
326 faut -- les dépendances entre certains fichiers, les instructions
327 successives à traiter par le système -- pour aboutir au fichier que
328 vous désirez obtenir. Il pourrait par exemple contenir tout ce qu'il
329 faut pour produire @file{ballade.pdf} et @file{ballade.midi} à partir de
330 @file{ballade.ly} en lançant LilyPond.
332 La création d'un @code{Makefile} peut se révéler pertinente pour
333 certains projets, que ce soit par simple goût personnel ou bien par
334 respect de ceux qui pourront accéder à vos sources. Cette manière de
335 procéder est particulièrement indiquée lorsque vous travaillez sur un
336 projet de grande envergure impliquant de nombreuses inclusions de
337 fichiers et différentes éditions -- par exemple un conducteur et un
338 matériel d'orchestre complet avec la partition pour le chef et une
339 partition séparée pour chacun des pupitres -- ou bien si votre projet
340 requiert certaines commandes particulières comme @code{lilypond-book}.
341 Les @emph{Makefiles} varient tant en complexité qu'en flexibilité selon
342 les besoin et les aptitudes de celui qui les crée. Le programme GNU
343 Make est installé par défaut sur les distributions GNU/Linux et sur
344 MacOS X, et il en existe une version pour les environnements Windows.
346 Consultez le @strong{GNU Make Manual} pour plus de détails sur ce dont
347 @code{make} est capable -- vous pourrez même en trouver des versions
348 françaises à l'aide des moteurs de recherche --, dans la mesure où ce
349 qui suit ne donne qu'un bref aperçu de ses possibilités.
351 Les commandes permettant de définir les règles diffèrent selon la
352 plate-forme : si les différents GNU/Linux et MacOS X utilisent
353 @code{bash}, Windows utilise @code{cmd}. Dans le cas de MacOS X,
354 vous devrez toutefois configurer votre système de telle sorte qu'il
355 utilise l'interpréteur en ligne de commande. Voici quelques exemples de
356 fichier @emph{Makefile}, avec une version pour GNU/Linux ou MacOS et une
359 Pour commencer, une pièce à quatre mouvements pour orchestre et dont les
360 fichiers sont répartis selon l'arborescence suivante :
379 | |-- symphonieIII.ly
383 | |-- symphonie-alto.ly
384 | |-- symphonie-cello.ly
385 | |-- symphonie-cor.ly
386 | |-- symphonie-hautbois.ly
387 | |-- symphonie-violonUn.ly
388 | `-- symphonie-violonDeux.ly
389 `-- symphonieDefs.ily
392 Les fichiers @file{.ly} des répertoires @code{Partitions} et
393 @code{Pupitres} récupéreront la notation des fichiers @file{.ily}
394 contenus dans le répertoire @code{Notes} :
397 %%% début du fichier "symphonie-cello.ly"
398 \include ../symphonieDefs.ily
399 \include ../Notes/cello.ily
402 Le @emph{Makefile} répertorie des cibles correspondant à @code{score}
403 (l'intégrale au format conducteur), @code{mouvements} (chacun des
404 mouvements au format conducteur) et @code{pupitres} (une partition par
405 pupitre). Il contient aussi une cible @code{archive} chargée de générer
406 une archive des fichiers source qui pourra être diffusée sur la toile ou
407 transmise par courriel. Voici ce que contiendrait ce @emph{Makefile}
408 pour GNU/Linux ou MacOS X. Ce fichier doit être enregistré sous le nom
409 de @code{Makefile} à la racine du projet -- ici @code{Symphonie}.
411 @warning{Lorsque vous définissez une cible ou une règle sur plusieurs
412 lignes, les lignes à partir de la deuxième @strong{doivent} débuter par
413 une tabulation, non pas par des espaces.}
416 # Le préfixe au nom des fichiers résultants
418 # Détermination du nombre de processeurs
419 CPU_CORES=`cat /proc/cpuinfo | grep -m1 "cpu cores" | sed s/".*: "//`
420 # La commande d'appel à lilypond
421 LILY_CMD = lilypond -ddelete-intermediate-files \
422 -dno-point-and-click -djob-count=$(CPU_CORES)
424 # Les suffixes utilisés dans ce Makefile
425 .SUFFIXES: .ly .ily .pdf .midi
427 # Les fichiers sources et résultants sont recherchés dans les répertoires
428 # listés dans la variable VPATH. Ceux-ci sont tous des sous-répertoires
429 # du répertoire courant (fourni par la variable de GNU make `CURDIR').
431 $(CURDIR)/Partitions \
436 # La règle type pour créer un PDF et un MIDI à partir d'un fichier
438 # Les .pdf résultants iront dans le sous-répertoire "PDF" et les fichiers
439 # .midi dans le sous-répertoire "MIDI".
441 $(LILY_CMD) $<; \ # cette ligne commence par une tabulation
442 if test -f "$*.pdf"; then \
445 if test -f "$*.midi"; then \
446 mv "$*.midi" MIDI/; \
457 # Les dépendances selon le mouvement.
458 $(piece)I.pdf: $(piece)I.ly $(notes)
459 $(piece)II.pdf: $(piece)II.ly $(notes)
460 $(piece)III.pdf: $(piece)III.ly $(notes)
461 $(piece)IV.pdf: $(piece)IV.ly $(notes)
463 # Les dépendances pour la partition intégrale.
464 $(piece).pdf: $(piece).ly $(notes)
466 # Les dépendances pour les pupitres.
467 $(piece)-alto.pdf: $(piece)-alto.ly alto.ily
468 $(piece)-cello.pdf: $(piece)-cello.ly cello.ily
469 $(piece)-cor.pdf: $(piece)-cor.ly cor.ily
470 $(piece)-hautbois.pdf: $(piece)-hautbois.ly hautbois.ily
471 $(piece)-violonUn.pdf: $(piece)-violonUn.ly violonUn.ily
472 $(piece)-violonDeux.pdf: $(piece)-violonDeux.ly violonDeux.ily
474 # Lancer `make score' pour générer l'intégrale des quatre mouvements
475 # en un seul fichier.
479 # Lancer `make parties' pour obtenir tous les pupitres.
480 # Lancer `make toto.pdf' pour obtenir la partie instrumentale de toto.
481 # Par exemple : `make symphonie-cello.pdf'.
483 parties: $(piece)-cello.pdf \
484 $(piece)-violonUn.pdf \
485 $(piece)-violonDeux.pdf \
487 $(piece)-hautbois.pdf \
490 # Lancer `make mouvements' pour générer un fichier séparé pour chacun
493 mouvements: $(piece)I.pdf \
498 all: score parties mouvements
501 tar -cvvf symphonie.tar \ # cette ligne commence par une tabulation
502 --exclude=*pdf --exclude=*~ \
503 --exclude=*midi --exclude=*.tar \
508 Les choses se compliquent sous Windows. Une fois GNU Make pour Windows
509 téléchargé et installé, il vous faudra correctement définir le chemin
510 d'accès au programme @emph{Make} -- dans les variables d'environnement
511 du système -- afin que l'interpréteur de commandes DOS puisse le
512 localiser. Pour cela, faites un clic droite sur « Poste de travail »,
513 choisissez @code{Propriétés} puis @code{Avancées}. Cliquez sur
514 @code{Variables d'environnement} puis, dans l'onglet
515 @code{Variables système}, mettez @code{path} en surbrillance et
516 cliquez sur @code{Modifier}. Ajoutez alors le chemin d'accès complet à
517 l'exécutable de GNU Make, qui devrait ressembler à :
520 C:\Program Files\GnuWin32\bin
523 Il va également falloir adapter le @emph{makefile} aux particularités de
524 l'interpréteur de commandes et à la présence d'espaces dans le nom de
525 certains répertoire de ce système.
526 La cible @code{archive} est tout bonnement supprimée, puisque Windows ne
527 dispose pas de la commande @code{tar}. Enfin, les fichiers MIDI ont une
528 extension par défaut propre à Windows.
532 ## VERSION POUR WINDOWS
535 LILY_CMD = lilypond -ddelete-intermediate-files \
536 -dno-point-and-click \
537 -djob-count=$(NUMBER_OF_PROCESSORS)
539 #Détermination du nom de CURDIR sous sa forme 8.3
540 #(solution pour les espaces dans le PATH)
541 workdir = $(shell for /f "tokens=*" %%b in ("$(CURDIR)") \
544 .SUFFIXES: .ly .ily .pdf .mid
547 $(workdir)/Partitions \
549 $(workdir)/Pupitress \
553 $(LILY_CMD) $< # cette ligne commence par une tabulation
554 if exist "$*.pdf" move /Y "$*.pdf" PDF/ # tabulation au début
555 if exist "$*.mid" move /Y "$*.mid" MIDI/ # tabulation au début
567 $(piece)I.pdf: $(piece)I.ly $(notes)
568 $(piece)II.pdf: $(piece)II.ly $(notes)
569 $(piece)III.pdf: $(piece)III.ly $(notes)
570 $(piece)IV.pdf: $(piece)IV.ly $(notes)
572 $(piece).pdf: $(piece).ly $(notes)
574 $(piece)-cello.pdf: $(piece)-cello.ly cello.ily
575 $(piece)-cor.pdf: $(piece)-cor.ly cor.ily
576 $(piece)-hautbois.pdf: $(piece)-hautbois.ly hautbois.ily
577 $(piece)-alto.pdf: $(piece)-alto.ly alto.ily
578 $(piece)-violonUn.pdf: $(piece)-violonUn.ly violonUn.ily
579 $(piece)-violonDeux.pdf: $(piece)-violonDeux.ly violonDeux.ily
585 parties: $(piece)-cello.pdf \
586 $(piece)-violonUn.pdf \
587 $(piece)-violonDeux.pdf \
589 $(piece)-hautbois.pdf \
593 mouvements: $(piece)I.pdf \
598 all: score parties mouvements
602 Le @emph{Makefile} suivant convient pour un document
603 @command{lilypond-book} réalisé avec @LaTeX{}. Ce projet contiendra un
604 index, ce qui nécessitera de lancer une deuxième fois @command{latex}
605 pour mettre à jour les liens. Les fichiers résultants iront dans le
606 répertoire @code{out} pour ce qui est des pdf et dans le répertoire
607 @code{htmlout} pour ce qui est du html.
616 LILYBOOK_PDF=lilypond-book --output=$(OUTDIR) --pdf $(FILE).lytex
617 LILYBOOK_HTML=lilypond-book --output=$(WEBDIR) $(FILE).lytex
618 PDF=cd $(OUTDIR) && pdflatex $(FILE)
619 HTML=cd $(WEBDIR) && latex2html $(FILE)
620 INDEX=cd $(OUTDIR) && makeindex $(FILE)
621 PREVIEW=$(VIEWER) $(OUTDIR)/$(FILE).pdf &
626 $(LILYBOOK_PDF) # tabulation en début de ligne
627 $(PDF) # tabulation en début de ligne
628 $(INDEX) # tabulation en début de ligne
629 $(PDF) # tabulation en début de ligne
630 $(PREVIEW) # tabulation en début de ligne
633 $(LILYBOOK_HTML) # tabulation en début de ligne
634 $(HTML) # tabulation en début de ligne
635 cp -R $(WEBDIR)/$(FILE)/ ./ # tabulation en début de ligne
636 $(BROWSER) $(FILE)/$(FILE).html & # tabulation en début de ligne
639 cp $(OUTDIR)/$(FILE).pdf $(FILE).pdf # tabulation en début de ligne
642 rm -rf $(OUTDIR) # tabulation en début de ligne
645 rm -rf $(WEBDIR) # tabulation en début de ligne
648 tar -cvvf monprojet.tar \ # tabulation en début de ligne
650 --exclude=htmlout/* \
651 --exclude=monprojet/* \
658 AVENIR: faire que ça marche sous Windows
660 Ce @emph{makefile} n'est malheureusement pas opérationnel sous Windows.
661 La seule alternative qui s'offre aux utilisateurs de Windows consiste à
662 créer un fichier de traitement par lot (@code{.bat}) qui contienne les
663 différentes commandes successives. Bien que cette manière de procéder
664 ne tienne aucun compte des dépendances entre fichiers, elle permet de
665 réduire le nombre de processus à lancer dans une seule commande. Vous
666 devrez enregistrer les lignes suivantes dans un fichier
667 @code{construire.bat} ou @code{construire.cmd}. Ce fichier pourra être
668 exécuté soit en ligne de commande, soit par un double clic sur son
672 lilypond-book --output=out --pdf monprojet.lytex
678 copy out\monprojet.pdf MonProjet.pdf
682 Manuel d'utilisation :
683 @ref{Utilisation en ligne de commande},