@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
@c This file is part of lilypond.tely
@ignore
- Translation of GIT committish: bfbaf6488d99ab4cdfcb4efdc67eaca63a636106
+ Translation of GIT committish: 148e80b8992a7fb9d59ec439c00b79decbbe3bad
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
@end ignore
-@c \version "2.11.38"
+@c \version "2.12.0"
@c Translators: Ludovic Sardain
@c Translation checkers: Jean-Yves Baudais, Valentin Villenave, John Mandereau, Jean-Charles Malahieude
de même pas votre temps à lire ce chapitre.
@menu
-* Suggestions for writing LilyPond files::
-* Saving typing with identifiers and functions::
-* Style sheets::
-* Updating old files::
-* Troubleshooting (taking it all apart)::
-* Minimal examples::
+* Suggestions for writing LilyPond input files::
+* When things don't work::
+* Scores and parts::
@end menu
-@node Suggestions for writing LilyPond files
-@section Suggestions for writing LilyPond files
+@node Suggestions for writing LilyPond input files
+@section Suggestions for writing LilyPond input files
Maintenant vous êtes prêt à travailler sur de plus gros fichiers
LilyPond --- des pièces entières, et plus seulement les petits
organisé. Néanmoins, quelques critères doivent être pris en compte
lorsque l'on écrit un fichier LilyPond.
-@itemize @bullet
+@itemize
@item Si vous faites une erreur, la structure même du fichier LilyPond
peut permettre de la localiser plus ou moins facilement.
@end itemize
@menu
-* General suggestions::
-* Typesetting existing music::
-* Large projects::
+* General suggestions::
+* Typesetting existing music::
+* Large projects::
+* Saving typing with variables and functions::
+* Style sheets::
@end menu
@node General suggestions
années auparavant. L'utilitaire @command{convert-ly} demande que vous
spécifiiez la version de LilyPond vous utilisiez alors.
-@item @strong{Ajoutez des contrôles}: @ruser{Bar check}, @ruser{Octave
-check} et @ruser{Barnumber check}. Si vous avez ajouté des contrôles de
-loin en loin, et que vous faites une erreur, vous pourrez la retrouver
-plus rapidement. @qq{De loin en loin}, qu'est-ce à dire ? Cela
-dépend de la complexité de la musique. Pour de la musique très
+@item @strong{Ajoutez des contrôles}: @ruser{Octave checks}, et
+@ruser{Bar and bar number checks}. Si vous avez ajouté des contrôles
+de loin en loin, et que vous faites une erreur, vous pourrez la
+retrouver plus rapidement. @qq{De loin en loin}, qu'est-ce à dire ?
+Cela dépend de la complexité de la musique. Pour de la musique très
simple, peut-être une ou deux fois. Pour de la musique très complexe,
peut-être à chaque mesure.
@item @strong{Indentez les accolades}. Beaucoup de problèmes
viennent d'un défaut de parité entre @code{@{} et @code{@}}.
+@item @strong{Mentionnez les durées} au début de chaque section ou
+variable. Si vous saisissez @code{c4 d e} au début d'une phrase, vous
+vous épargnerez des problèmes si, plus tard, vous modifiez votre musique.
+
@item @strong{Séparez les affinages de mise en forme} de la musique
-elle-même. Voyez @ruser{Saving typing with identifiers and functions} et
-@ruser{Style sheets}.
+elle-même. Voyez @ref{Saving typing with variables and functions} et
+@ref{Style sheets}.
@end itemize
Si vous saisissez de la musique à partir d'une partition existante,
c'est-à-dire de la musique déjà écrite,
-@itemize @bullet
+@itemize
@item n'entrez qu'un seul système de la partition originale
à la fois --- mais toujours une seule mesure par ligne de texte ---,
et vérifiez chaque système lorsqu'il est terminé. Vous pouvez
-utiliser la commande @code{showLastLength} pour accélérer la
-compilation --- voir @ruser{Skipping corrected music} ;
+utiliser les commandes @code{showLastLength} et @code{showFirstLength}
+pour accélérer la compilation --- voir @ruser{Skipping corrected music} ;
@item définissez @code{mBreak = @{\break @}} et insérez
@code{\mBreak} dans le fichier d'entrée pour obtenir des sauts de
définir @code{mBreak = @{ @}} pour enlever tous ces sauts de ligne, et
laisser LilyPond placer les sauts de ligne selon son propre algorithme.
+@item encadrez les notes d'une partie pour instrument transpositeur
+dans un
+
+@example
+\transpose c tonalite-naturelle @{...@}
+@end example
+(où @code{tonatilte-naturelle} correspond à celle de l'instrument en
+question) de telle sorte que la musique comprise dans cette variable se
+retrouve en ut. Vous pourrez toujours transposer à l'inverse si besoin
+lorsque vous ferez appel à cette variable. Des erreurs de transposition
+seront moins susceptibles de se produire si la musique de toutes les
+variables est dans la même et unique tonalité.
+
+De la même manière, prénez toujours le do comme note de départ ou
+d'arrivée. Ceci aura pour simple conséquence que les autres tonalités
+que vous utiliserez seront celles propres à chacun des instruments --
+sib pour une trompette en si bémol, ou lab pour une clarinette en la bémol.
+
@end itemize
@end example
@item @strong{Séparez les retouches} des définitions de
-musique. Ce conseil a été vu dans @ruser{General suggestions},
-mais pour les projets d'importance c'est absolument vital. Nous
+musique. Nous vous avons déjà invité à adopter une telle pratique, qui
+par ailleurs devient vitale pour des projets d'importance. Nous
pouvons avoir besoin de changer la définition de
-@code{fthenp}, mais dans ce cas nous n'aurons besoin de le faire
+@code{fpuisp}, mais dans ce cas nous n'aurons besoin de le faire
qu'une seule fois, et nous pourrons encore éviter de
modifier quoi que ce soit à l'intérieur de la définition
du @code{violon}.
@end itemize
-@node Saving typing with identifiers and functions
-@section Saving typing with identifiers and functions
+@node Saving typing with variables and functions
+@subsection Saving typing with variables and functions
@cindex variables
@cindex identificateurs
musique minimaliste :
@lilypond[quote,verbatim,ragged-right]
-fragA = \relative c'' { a4 a8. b16 }
-fragB = \relative c'' { a8. gis16 ees4 }
-violin = \new Staff { \fragA \fragA \fragB \fragA }
+fragmentA = \relative c'' { a4 a8. b16 }
+fragmentB = \relative c'' { a8. gis16 ees4 }
+violin = \new Staff { \fragmentA \fragmentA \fragmentB \fragmentA }
\score {
{
\violin
}
@end lilypond
-Cependant, vous pouvez aussi utiliser ces identificateurs
+Néanmoins vous pouvez aussi utiliser ces identificateurs
--- aussi connus sous le nom de variables, macros, ou commandes
(définies par l'utilisateur) --- pour des retouches :
@}
@end example
+@c TODO Replace the following with a better example -td
+@c Skylining handles this correctly without padText
+
Jusqu'ici nous avons vu des substitutions statiques : quand LilyPond
rencontre @code{\padText}, il le remplace par le contenu que nous lui
avons défini --- c'est-à-dire le contenu à droite de @code{padText=}.
Utiliser les identificateurs est aussi un bon moyen pour vous épargner
du travail si la syntaxe de LilyPond change un jour --- voir
-@ruser{Updating old files}. Si vous avez une seule définition, par
-exemple @code{\dolce}, pour tous vos fichiers (voir @ruser{Style
-sheets}), et que la syntaxe change, alors vous n'aurez qu'à mettre à
+@ref{Updating old input files}. Si vous avez une seule définition, par
+exemple @code{\dolce}, pour tous vos fichiers (voir @ref{Style sheets}),
+et que la syntaxe change, alors vous n'aurez qu'à mettre à
jour votre seule définition @code{\dolce}, au lieu de devoir modifier
chaque fichier @code{.ly}.
@node Style sheets
-@section Style sheets
+@subsection Style sheets
La sortie que produit LilyPond peut être largement modifiée --- voir
-@ruser{Tweaking output} pour plus de détails. Mais que faire si vous
+@ref{Tweaking output} pour plus de détails. Mais que faire si vous
avez beaucoup de fichiers auxquels vous souhaitez appliquer vos
retouches ? Ou si vous souhaitez simplement séparer les retouches de
la musique elle-même ? Rien de plus facile.
Prenons un exemple. Ne vous inquiétez pas si vous ne comprenez pas
les parties avec tous les @code{#()}. Celles-ci sont expliquées dans
-@ruser{Advanced tweaks with Scheme}.
+@ref{Advanced tweaks with Scheme}.
@lilypond[quote,verbatim,ragged-right]
mpdolce = #(make-dynamic-script (markup #:hspace 1 #:translate (cons 5 0)
@end lilypond
Il y a quelques problèmes de chevauchement ; nous allons arranger
-cela en utilisant les techniques de @ruser{Moving objects}. On peut
+cela en utilisant les techniques de @ref{Moving objects}. On peut
aussi faire quelque chose pour les définitions de @code{mpdolce}
et @code{tempoMark}. Elles produisent le résultat que nous désirons,
mais nous pourrions aussi vouloir les utiliser dans une autre pièce.
-Il suffirait de les copier et les coller au début de chaque
+Il suffirait de les copier et coller au début de chaque
fichier, mais c'est fastidieux. De plus, cela laisse les définitions
dans nos fichiers de musique, et je trouve personnellement tous ces
@code{#()} assez laids. Stockons-les dans un autre fichier :
C'est mieux, mais effectuons encore quelques retouches. Le glissando
est peu visible, c'est pourquoi nous allons l'épaissir et le
-rapprocher des têtes de notes. Déplaçons l'indication métronomique
+rapprocher des têtes de note. Déplaçons l'indication métronomique
au-dessus de la clef, au lieu de la laisser au-dessus de la première
note. Et pour finir, mon professeur de composition déteste les
chiffrages de mesure en @qq{C}, nous allons donc le transformer en @qq{4/4}.
\include "../init/init-papier.ly"
@end example
-@node Updating old files
-@section Updating old files
+@node When things don't work
+@section When things don't work
+
+@menu
+* Updating old files::
+* Troubleshooting (taking it all apart)::
+* Minimal examples::
+@end menu
+
+@node Updating old input files
+@subsection Updating old input files
La syntaxe de LilyPond change de temps en temps. Ces changements de
syntaxe du langage d'entrée accompagnent les améliorations du
@node Troubleshooting (taking it all apart)
-@section Troubleshooting (taking it all apart)
+@subsection Troubleshooting (taking it all apart)
Tôt ou tard, vous écrirez un fichier que LilyPond ne peut pas
compiler. Les messages que LilyPond affiche peuvent vous aider à
Une autre technique de déboguage très utile est la construction
@iftex
-de @ruser{Minimal examples}.
+de @ref{Minimal examples}.
@end iftex
@ifnottex
-d'@ruser{Minimal examples}.
+d'@ref{Minimal examples}.
@end ifnottex
@node Minimal examples
-@section Minimal examples
+@subsection Minimal examples
Un exemple minimal est un exemple de code aussi court que possible.
De tels exemples sont bien plus compréhensibles que des exemples
@end itemize
Tout l'intérêt d'un exemple minimal réside dans sa facilité de lecture :
+
@itemize
@item évitez d'utiliser des notes, armures ou métriques compliquées, à
moins que vous ne vouliez montrer quelque chose en rapport avec
@item n'utilisez pas de commandes @code{\override} sauf si elles font
l'intérêt de l'exemple.
@end itemize
+
+@node Scores and parts
+@section Scores and parts
+
+Dans la musique d'orchestre, toutes les notes sont imprimées deux fois.
+D'abord dans les parties séparées destinées aux musiciens, et ensuite
+dans le conducteur destiné au chef. Les variables sont là pour vous éviter
+un double travail. La musique n'est entrée qu'une seule fois, et stockée dans
+une variable, dont le contenu servira à imprimer à la fois la partie
+séparée et la partition d'orchestre.
+
+Il est judicieux de définir les notes dans un fichier séparé. Par
+exemple, supposons que le fichier @file{musique-Cor.ly} contienne la
+partie suivante pour un duo cor/@/basson.
+
+@example
+notesCor = \relative c @{
+ \time 2/4
+ r4 f8 a cis4 f e d
+@}
+@end example
+
+@noindent
+On établira alors une partie séparée en constituant un nouveau fichier :
+
+@example
+\include "musique-Cor.ly"
+\header @{
+ instrument = "Cor en Fa"
+@}
+
+@{
+ \transpose f c' \notesCor
+@}
+@end example
+
+À la ligne
+
+@example
+\include "musique-Cor.ly"
+@end example
+
+@noindent
+sera substitué le contenu du fichier @file{musique-Cor.ly}, et de ce
+fait la variable @code{notesCor} se trouvera définie. La commande
+@code{\transpose f@tie{}c'} indique que son argument @code{\notesCor}
+sera transposé à la quinte supérieure : le son réel @samp{f} s'écrit
+@code{c'}, ce qui est la caractéristique d'un Cor en fa. La
+transposition est visible comme suit :
+
+@lilypond[quote,ragged-right]
+\transpose f c' \relative c {
+ \time 2/4
+ r4 f8 a cis4 f e d
+}
+@end lilypond
+
+Dans les pièces d'ensemble, il arrive souvent qu'une voix ne joue pas
+pendant plusieurs mesures. Un silence spécial, appelé silence multi-mesures,
+l'indique alors. On l'obtient par un @samp{R} majuscule, suivi d'une
+durée : @code{1}@tie{}pour une pause, @code{2}@tie{}pour une demi-pause,
+etc. Cette durée peut être multipliée pour établir de plus longs silences.
+Par exemple, le silence suivant dure 3@tie{}mesures à 2/4.
+
+@example
+R2*3
+@end example
+
+Dans une partie séparée, les silences multi-mesures sont compressés.
+Il faut pour cela définir la propriété @code{skipBars} à @q{vrai} :
+
+@example
+\set Score.skipBars = ##t
+@end example
+
+@noindent
+Cette commande assigne la valeur @q{vrai} --- @emph{true} en anglais, et
+@samp{#t} dans le langage Scheme --- à cette propriété dans le
+contexte @code{Score}. Si l'on ajoute dans la musique ci-dessus le
+silence multi-mesures et cette option, on obtient le résultat suivant :
+
+@lilypond[quote,ragged-right]
+\transpose f c' \relative c {
+ \time 2/4
+ \set Score.skipBars = ##t
+ R2*3
+ r4 f8 a cis4 f e d
+}
+@end lilypond
+
+Le conducteur rassemble toute la musique. Si l'on suppose que l'autre
+voix de notre duo se trouve dans le fichier @file{musique-Basson.ly} en
+tant que variable @code{notesBasson}, on établira un conducteur avec
+
+@example
+\include "musique-Basson.ly"
+\include "musique-Cor.ly"
+
+<<
+ \new Staff \notesCor
+ \new Staff \notesBasson
+>>
+@end example
+
+@noindent
+ce qui équivaut à
+
+@lilypond[quote,ragged-right]
+\relative c <<
+ \new Staff {
+ \time 2/4 R2*3
+ r4 f8 a cis4 f e d
+ }
+ \new Staff {
+ \clef bass
+ r4 d,8 f | gis4 c | b bes |
+ a8 e f4 | g d | gis f
+ }
+>>
+@end lilypond
+
+Des informations plus détaillées sur la mise en place de conducteurs
+et de parties séparées se trouvent dans le manuel : voir
+@ruser{Writing parts}.
+
+Les variables (@q{propriétés}) réglables sont abordées en détail dans
+@ruser{The set command}.