@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
@c This file is part of ../user/lilypond.tely
@ignore
- Translation of GIT committish: da55a1ec3c4b8195efc910b0c986c27f244def85
+ Translation of GIT committish: 76de7e168dbc9ffc7671d99663c5ce50dae42abb
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 Translators: Valentin Villenave
+@c Translation checkers: Gilles Thibault
+
@node Changing defaults
@chapter Changing defaults
-
LilyPond est conçu pour engendrer, par défaut, des partitions de la
plus haute qualité. Cependant, on peut parfois avoir à modifier cette
mise en page par défaut. Celle-ci est réglée par tout un ensemble de
@cindex Référence du programme
Les moyens de contrôle des différents réglages sont décrits dans un document
-à part entière, la
+séparé, la
@iftex
référence du programme
@end iftex
@ifnottex
@ref{Top,Référence du programme,,lilypond-internals}.
@end ifnottex
-Ce guide répertorie toutes les variables, fonctions et autre options que
-LilyPond met à votre disposition. Il est consultable en ligne, au format HTML,
+Ce guide répertorie toutes les variables, fonctions et autres options que
+LilyPond met à votre disposition. Il est consultable
@c leave the @uref as one long line.
-@uref{http://@/lilypond@/.org/@/doc/@/stable/@/Documentation/@/user/@/lilypond@/-internals/,on@/-line},
-mais est également inclus dans la documentation fournie avec le logiciel.
+@uref{http://@/lilypond@/.org/@/doc/@/stable/@/Documentation/@/user/@/lilypond@/-internals/,en@tie{}ligne},
+au format HTML, mais est également inclus dans la documentation
+fournie avec le logiciel.
Il est quatre domaines dans lesquels on peut modifier les réglages par défaut :
les entrailles du programme, et de ce fait requiert l'emploi du Scheme.
Les fragments de Scheme, dans un fichier @code{.ly}, sont introduits par le
caractère @q{hash}, (@code{#}, improprement surnommé @q{dièse}).@footnote{Le
-@ref{Scheme tutorial} fournit quelques notions de base pour saisir des nombres,
+@rlearning{Scheme tutorial} fournit quelques notions de base pour saisir des nombres,
des listes, des chaînes de caractères ou des symboles, en Scheme.}
@node Automatic notation
@section Automatic notation
-Cette section s'intéresse à la manière dont les altérations accidentelles
-et les ligatures sont automatiquement ajoutées.
+Cette section s'intéresse au réglage de l'impression automatique des
+altérations accidentelles et ligatures.
@menu
* Automatic accidentals::
@end lilypond
La règle @code{voice} n'est à envisager que dans le cas de voix devant être lues par
-des musiciens différents. S'il s'agit d'un @q{conducteur}, ou d'une portée destinée
+des musiciens différents. S'il s'agit d'un @q{conducteur}, ou d'une portée destinée
à un seul musicien, il vaut mieux utiliser @code{modern} ou @code{modern-cautionary}.
@item modern
@funindex modern style accidentals
Cette règle est la plus courante au XXème siècle. Les altérations accidentelles
-sont imprimées comme avec le style @code{default}, mais lorsque une note non-altérée
+sont imprimées comme avec le style @code{default}, mais lorsqu'une note non-altérée
apparaît à une octave différente, ou bien dans la mesure suivante, des bécarres de précaution
sont ajoutés. Dans l'exemple suivant, notez ainsi les deux bécarres dans la
deuxième mesure de la main droite.
Cette règle est équivalente à @code{modern}, mais les bécarres de précaution sont
imprimés de façon particulière : soit plus petits, soit (par défaut) entre parenthèses.
Il est possible de le définir au moyen de la propriété @code{cautionary-style}
-pour l'objet @internalsref{AccidentalSuggestion}.
+pour l'objet @rinternals{AccidentalSuggestion}.
@lilypond[quote,ragged-right]
musicA = { << \relative { cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
Cette règle sert aux altérations dans de la musique polyphonique destinée
autant à des musiciens différents qu'à quelqu'un qui lirait l'ensemble des voix.
Les altérations sont imprimées voix par voix, mais les autres voix, dans le même
-contexte @internalsref{Staff}, en @emph{tiennent compte} cette fois.
+contexte @rinternals{Staff}, en @emph{tiennent compte} cette fois.
@lilypond[quote,ragged-right]
musicA = { << \relative { cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
Cette règle est communément employée pour les partitions de piano au XXème siècle.
Très similaire à @code{modern} de par son comportement, elle s'en distingue en ce que
-les altérations tiennent compte des autre portées du contexte @internalsref{GrandStaff} ou
-@internalsref{PianoStaff}.
+les altérations tiennent compte des autre portées du contexte @rinternals{GrandStaff} ou
+@rinternals{PianoStaff}.
@lilypond[quote,ragged-right]
musicA = { << \relative { cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
@item forget
Tout le contraire de @code{no-reset}: l'effet des altérations cesse aussitôt,
et de ce fait, toutes les altérations, quelque soit leur place dans la mesure, sont
-imprimées, en fonction de l'armure éventuelle.
+imprimées, en fonction de l'éventuelle armure.
@lilypond[quote,ragged-right]
musicA = { << \relative { cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
@seealso
-Référence du programme : @internalsref{Accidental_engraver},
-@internalsref{Accidental}, @internalsref{AccidentalSuggestion} et @internalsref{AccidentalPlacement}.
+Référence du programme : @rinternals{Accidental_engraver},
+@rinternals{Accidental}, @rinternals{AccidentalSuggestion} et @rinternals{AccidentalPlacement}.
-@refbugs
+@knownissues
Les notes simultanées sont considérées comme des évènements séquentiels.
-Ce qui implique que, dans un accord, les altérations accidentelles sont
+Ce qui implique que, dans un accord, les altérations accidentelles seront
imprimées comme si les notes de l'accords apparaissaient une par une, en fonction
de l'ordre dans lequels elles ont été saisies -- ce qui peut poser problème lorsqu'au
-sein d'un accord certaines altérations dépendent les unes des autres. Ce problème
-est à résoudre manuellement, en insérant des @code{!} et des @code{?} après les notes
+sein d'un accord certaines altérations dépendent les unes des autres.
+Ce problème est à résoudre manuellement, en insérant des @code{!} et des @code{?} après les notes
concernées.
remplacez @code{p} et @code{q} par des étoiles @qq{@code{*}}.
-@item @code{n/m} est le chiffre de mesure dans lequel la règle doit s'appliquer. Si
-celle-ci doit s'appliquer dans toutes les métriques, remplacez @code{n} et @code{m}
-par des étoiles @qq{@code{*}}.
+@item @code{n/m} est le chiffre de mesure dans lequel la règle doit
+s'appliquer. Si celle-ci doit s'appliquer dans toutes les métriques,
+remplacez @code{n} et @code{m} par des étoiles @qq{@code{*}}.
@item @code{a/b} est l'emplacement, dans la mesure, auquel les ligatures doivent
débuter ou s'achever (suivant la valeur @q{extrémité} que nous venons de voir).
la mesure ou les règles par défaut s'ajoutent à vos propres règles. Il est alors nécessaire
de désactiver toute règle par défaut conduisant à des ligatures indésirables.
-Ainsi, pour obtenir des ligatures en groupes de @code{(3 4 3 2)} notes, dans une mesure à 12/8,
+Ainsi, pour obtenir des ligatures en groupes de @code{(3 4 3 2)} croches, dans une mesure à 12/8,
il faudra préalablement utiliser :
@example
les ligatures automatiques doivent être désactivées, avec @code{\autoBeamOff}.
-@refcommands
+@predefined
@funindex \autoBeamOff
@code{\autoBeamOff},
@end lilypond
-@refbugs
+@knownissues
Si une partition se termine alors qu'une ligature automatique est restée inachevée,
cette dernière ligature ne sera pas imprimée du tout. C'est également valable dans
@node Interpretation contexts
@section Interpretation contexts
-Cette section traite des contextes : que sont-ils ? Comment les modifier ?
+Cette section traite des contextes.
@menu
-* Contexts explained::
-* Creating contexts::
* Changing context properties on the fly::
* Modifying context plug-ins::
* Layout tunings within contexts::
@end menu
-@node Contexts explained
-@subsection Contexts explained
-
-Imprimer de la musique impose d'ajouter un certain nombre d'éléments de notation.
-Par exemple, voici un fragment de partition, précédé du code qui l'engendre :
-
-@lilypond[quote,verbatim,relative=2,fragment]
-cis4 cis2. g4
-@end lilypond
-
-Si le code est assez austère, dans la parition ont été ajoutés un chiffre de mesure,
-des barres de mesure, des altérations et une clé. Pour une bonne raison : LilyPond
-@emph{interprète} le code. Il le compulse dans l'ordre chronologique, de même qu'on
-lit une partition de gauche à droite ; et pendant ce traitement, le logiciel garde en
-mémoire les limites des mesures, ou encore quelles hauteurs de notes demandent des
-altérations accidentelles. Ces informations se présentent à plusieurs niveaux : ainsi,
-une altération n'a d'effet que sur une seule portée, tandis qu'une barre de mesure doit
-être synchronisée sur toute l'étendue verticale de la partition.
-
-LilyPond regroupe ces règles et ces fragments d'information dans des
-@emph{Contextes}. Certains contextes sont les voix (contexte @context{Voice}),
-les portées (contexte @context{Staff}), ou la partition dans son ensemble
-(contexte @context{Score}). Ils sont ordonnés hiérarchiquement : ainsi un
-contexte @context{Staff} peut contenir plusieurs contextes @context{Voice}, et un
-contexte @context{Score} peut contenir plusieurs contextes @context{Staff}.
-
-@quotation
-@image{context-example,5cm,,}
-@end quotation
-
-Chaque contexte est chargé de faire appliquer certaines règles de gravure,
-de créer certains objets, et de prendre en compte les propriétés qui leur
-sont associées. Ainsi, le contexte @context{Voice} peut faire intervenir une
-altération accidentelle, puis le contexte @context{Staff} devra déterminer si
-cette dernière devra être imprimée ou non dans la suite de la mesure. Les barres
-de mesure, enfin, sont alignées verticalement grâce au contexte @context{Score}.
-
-En revanche, dans une musique polymétrique, par exemple mélant une portée à 3/4
-et une autre à 4/4, les barres de mesures n'ont plus à être alignées : il faut alors
-modifier les comportement par défaut des contextes @context{Score} et @context{Staff}.
-
-Dans une partition très simple, les contextes sont créés implicitement, et peuvent
-être ignorés. Mais lorsqu'il s'agit de morceaux plus amples -- entendons par là tout
-ce qui s'écrit sur plus d'une portée -- il faut les créer explicitement pour être sûr
-d'obtenir toutes les portées nécessaires, et dans le bon ordre. Enfin pour des
-morceaux impliquant une notation spéciale, modifier les contextes ou en créer de nouveaux
-devient extrêment utile.
-
-Une description exhaustive de tous les contextes disponibles peut être trouvée dans la
-Référence du programme : voir
-@ifhtml
-@internalsref{Contexts}.
-@end ifhtml
-@ifnothtml
-Translation @arrow{} Context.
-@end ifnothtml
-
-@c [TODO: describe propagation]
-
-
-@node Creating contexts
-@subsection Creating contexts
-
-Dans une partition contenant une seule voix sur une seule portée,
-les contextes sont automatiquement créés. Dans une partition plus complexe,
-il faut les crééer à la main. Trois commandes le permettent :
-
-@itemize @bullet
-
-@item
-La plus facile, et la plus rapide à saisir, est @code{\new} -- @qq{nouveau} en français.
-Elle introduit une expression musicale, comme suit :
-
-@funindex \new
-@cindex nouveaux contextes
-@cindex Contextes, création de
-
-@example
-\new @var{Contexte} @var{expression musicale}
-@end example
-
-@noindent
-le choix du @var{Contexte} pouvant être, par exemple, @code{Staff} ou
-@code{Voice}. Cette commande crée un contexte, puis interprète
-l'@var{expression musicale} dans ledit contexte.
-
-En pratique, la commande @code{\new} peut servir dans une partition
-comprenant plusieurs portées. Comme chaque partie doit se trouver sur sa propre
-portée, il faut la faire précéder de @code{\new Staff}.
-
-@lilypond[quote,verbatim,relative=2,ragged-right,fragment]
-<<
- \new Staff { c4 c }
- \new Staff { d4 d }
->>
-@end lilypond
-
-La commande @code{\new} peut aussi permettre de nommer le contexte créé :
-
-@example
-\new @var{Contexte} = @var{"inventezUnNom"} @var{musique}
-@end example
-Le nom que vous choisirez ne pourra être attribué que si aucun autre contexte
-n'a été créé précédemment avec le même nom.
-
-
-@funindex \context
-
-@item
-Tout comme @code{\new}, la commande @code{\context} envoie une expression musicale
-vers un contexte donné, mais attribue nécessairement un nom à ce contexte. La
-syntaxe est la suivante :
-
-@example
-\context @var{Contexte} = @var{unNom} @var{musique}
-@end example
-
-Cette commande va partir à la recherche d'un contexte déjà existant, de type
-@var{Contexte}, et portant le nom @var{unNom}. Ce qui peut être fort utile
-pour se référer à un contexte existant. S'il s'avère que le contexte en question
-n'existe pas encore, il est créé. Dans le cas de musique vocale avec des paroles,
-cela donne :
-
-@example
-\context Voice = "@b{tenor}" @var{musique}
-@end example
-
-@noindent
-et (pour que le texte soit aligné correctement avec les notes) :
-
-@example
-\new Lyrics \lyricsto "@b{tenor}" @var{paroles}
-@end example
-
-@noindent
-
-Une autre utilité de dénommer les contextes est de superposer en un même
-contexte différentes expressions musicales. Dans l'exemple suivant, les
-notes et les ponctuations ont été saisies séparément :
-
-@example
-musique = @{ c4 c4 @}
-ponctuation = @{ s4-. s4-> @}
-@end example
-
-En les envoyant toutes deux dans le même contexte @context{Voice}, on les combine :
-
-@example
-<<
- \new Staff \context Voice = "A" \musique
- \context Voice = "A" \ponctuation
->>
-@end example
-@lilypond[quote,ragged-right]
-music = { c4 c4 }
-arts = { s4-. s4-> }
-\relative c'' <<
- \new Staff \context Voice = "A" \music
- \context Voice = "A" \arts
->>
-@end lilypond
-
-De cette façon, il est possible d'élaborer une édition Urtext (c'est-à-dire originale,
-la plupart du temps sans ponctuations), en laissant la possibilité d'ajouter différentes
-ponctuations sur les mêmes notes.
-
-@cindex crééer des contextes
-
-@item
-La dernière commande pour créer des contextes est
-@example
-\context @var{Contexte} @var{musique}
-@end example
-
-
-@noindent
-Elle ressemble à l'emploi de @code{\context} avec @code{= @var{unNom}}, mais
-cette fois elle se considèrera chez elle partout où elle trouvera un contexte
-de type @var{Contexte}, quel que puisse être son nom.
-
-@c Au secours ! --vv
-
-Cette variante sert à des expressions musicales qui peuvent être interprétées à
-plusieurs niveaux. Par exemple, une commande telle que @code{\applyOutput} (voir
-@ref{Running a function on all layout objects}) : si elle n'est pas associée avec
-@code{\context}, elle s'applique par défaut dans le contexte @context{Voice}.
-
-@example
-\applyOutput #'@var{Contexte} #@var{fonction} % s'applique dans le contexte Voice
-@end example
-
-Pour l'appliquer au contexte @context{Score} ou @context{Staff}, il faut utiliser :
-
-@example
-\applyOutput #'Score #@var{fonction}
-\applyOutput #'Staff #@var{fonction}
-@end example
-
-@end itemize
-
-
@node Changing context properties on the fly
@subsection Changing context properties on the fly
Ce changement étant appliqué @q{à la volée}, il n'affecte que le second groupe de notes.
Si l'argument @var{contexte} n'est pas spécifié, alors la propriété cherchera à s'appliquer
-dans contexte le contexte le plus restreint où elle est employée :le plus souvent
- @context{ChordNames}, @context{Voice}, ou @context{Lyrics}. Dans l'exemple suivant...
+dans le contexte le plus restreint où elle est employée : le plus souvent
+ @context{ChordNames}, @context{Voice}, ou @context{Lyrics}. Dans l'exemple suivant,
@lilypond[quote,verbatim,relative=2,fragment]
c8 c c c
@end lilypond
@noindent
-aucun argument @var{contexte} n'a été donné à la commande @code{\set}. De ce fait,
-les ligatures automatiques sont désactivées dans le contexte actuel, c'est-à-dire
-@internalsref{Voice}. Notez que le contexte le plus restreint n'est pas toujours le bon,
+aucun argument @var{contexte} n'a été donné à la commande @code{\set}.
+De ce fait, les ligatures automatiques sont désactivées dans le
+contexte actuel, c'est-à-dire @rinternals{Voice}. Notez que le
+contexte le plus restreint n'est pas toujours le bon,
et peut ne pas contenir la propriété qui vous intéresse : ainsi, la propriété
@code{skipBars}, évoquée plus haut, ne relève pas du contexte @code{Voice},
et le code suivant ne fonctionnera pas.
R1*2
@end lilypond
-Les contextes s'organisent de façon hiérarchique : aussi, si un contexte de niveau
+Les contextes s'organisent de façon hiérarchique : aussi, lorsqu'un contexte de niveau
supérieur est spécifié (par exemple @context{Staff}), la propriété sera modifée dans
tous les contextes inférieurs (tous les contextes @context{Voice}, par exemple)
qu'il contient.
@noindent
même s'il s'applique à tous les contextes @code{Voice} contenus dans le
-contexte @code{Staff}, ne peut être annulé au niveau @code{Voice}. Le code
+contexte @code{Staff}, ne peut être annulé au niveau @code{Voice}. Le code
suivant sera sans effet.
@example
@end example
Si l'on se trouve dans le contexte le plus restreint, il n'est pas obligatoire,
-là encore, de spécifier le @var{contexte}. Ainsi, les deux lignes suivantes sont équivalentes.
+là encore, de spécifier le @var{contexte}. Ainsi, les deux lignes suivantes sont équivalentes.
@example
Ici le changement de taille est annulé aussitôt après la note concernée.
-La Référence du programme contient une description exhaustive de toutes les
+La référence du programme contient une description exhaustive de toutes les
propriétés contexte par contexte : voir
@ifhtml
-@internalsref{Tunable context properties}.
+@rinternals{Tunable context properties}.
@end ifhtml
@ifnothtml
-Translation @arrow{} Tunable context properties.
+Translation @expansion{} Tunable context properties.
@end ifnothtml
@subsection Modifying context plug-ins
Les contextes, tels que @code{Score} ou @code{Staff}, ne contiennent
-pas que des propriétés, mais mettent également en oeuvre certains
+pas que des propriétés ; ils mettent également en œuvre certains
sous-programmes (@q{plug-ins}, pour employer le terme consacré) nommés
@q{graveurs} (@q{engravers}, pour reprendre le terme anglais).
Ces sous-programmes sont chargés de créer les différents éléments de notation :
-Ainsi, on trouve, dans le contexte @code{Voice}, un graveur @code{Note_head_engraver},
+On trouve ainsi dans le contexte @code{Voice}, un graveur @code{Note_head_engraver},
chargé des têtes de notes, et dans le contexte @code{Staff}, un graveur
@code{Key_signature_engraver}, chargé de l'armure.
Vous trouverez une description exhaustive de chaque graveur dans
@ifhtml
-@internalsref{Engravers}.
+@rinternals{Engravers}.
@end ifhtml
@ifnothtml
-Program reference @arrow Translation @arrow{} Engravers.
+Program reference @expansion Translation @expansion{} Engravers.
@end ifnothtml
Chaque contexte mentionné dans
@ifhtml
-@internalsref{Contexts}
+@rinternals{Contexts}
@end ifhtml
@ifnothtml
-Program reference @arrow Translation @arrow{} Context.
+Program reference @expansion Translation @expansion{} Context.
@end ifnothtml
-répertorie les graveurs mis en oeuvre.
+répertorie les graveurs mis en œuvre.
On peut faire, au moyen de ces graveurs, sa propre @qq{cuisine}, en
@noindent
Ici les points de suspension @dots{} devront être remplacés par les noms
-des graveurs désirés. Dans l'exemple suivant, on enlève, dans le contexte
-@code{Staff} le chiffre de mesure (graveur @code{Time_signature_engraver})
+des graveurs désirés. Dans l'exemple suivant, on enlève du contexte
+@code{Staff}, le chiffre de mesure (graveur @code{Time_signature_engraver})
et la clé (graveur @code{Clef_engraver}).
@lilypond[quote,relative=1,verbatim,fragment]
>>
@end lilypond
-La clé et le chiffre de mesure ont disparu de la deuxième portée. C'est une méthode
+La clé et le chiffre de mesure ont disparu de la deuxième portée. C'est une méthode
quelque peu radicale, puisqu'elle affectera toute la portée jusqu'à la fin de la
partition. L'espacement s'en trouve également affecté, ce qui peut être ou non
l'effet recherché. Une méthode plus sophistiquée aurait été de rendre ces objets
-transparents (voir @ref{Common tweaks}).
+transparents (voir @rlearning{Common tweaks}).
Dans l'exemple suivant, voici une mise en pratique plus utile. En temps
normal, les barres de mesure et la métrique sont synchronisées verticalement
Ici @var{objet} est un objet graphique, tel que @code{Stem} (les hampes)
ou @code{NoteHead} (les têtes de note) ; @var{propriété} est une variable
(désignée par un symbole, ce qui explique l'apostrophe) employée par le système
-de mise en page. La sous-section @ref{Constructing a
-tweak} vous aidera à savoir quoi mettre à la place de @var{objet}, @var{propriété} et
+de mise en page. La sous-section @ref{Constructing a tweak} vous
+aidera à savoir quoi mettre à la place de @var{objet}, @var{propriété} et
@var{valeur} ; notre propos n'est ici que d'examiner l'emploi de cette commande.
La commande suivante :
@end lilypond
@noindent
-Dans cet exemple, la liaison (@q{Slur}) est épaissie, mais non la ligature
-@code{Beam}. En effet, le code qui lui est relatif n'a pas été inséré avant le début de
+Dans cet exemple, la liaison (@emph{Slur}) est épaissie, mais non la ligature
+(@emph{Beam}). En effet, le code qui lui est relatif n'a pas été inséré avant le début de
la ligature, et demeure donc sans effet.
De même que la commande @code{\unset}, la commande @code{\revert} défait
-ce qui a été fait par une commande @code{\override}. Tout comme avec @code{\unset},
-elle ne peut annuler que les réglages effectués dans le même contexte. Ainsi dans
-l'exemple suivant, la commande @code{\revert} est sans effet.
+ce qui a été fait par une commande @code{\override}. Tout comme avec @code{\unset},
+elle ne peut annuler que les réglages effectués dans le même contexte.
+Ainsi dans l'exemple suivant, la commande @code{\revert} est sans effet.
@example
\override Voice.Stem #'thickness = #4.0
@end example
Il existe, à l'intérieur même de certaines propriétés, des options que l'on
-nomme @q{sous-propriétés}. La syntaxe est alors
+nomme @q{sous-propriétés}. La syntaxe est alors
@c leave this as a long long
@example
@seealso
-Référence du programme : @internalsref{OverrideProperty}, @internalsref{RevertProperty},
-@internalsref{PropertySet}, @internalsref{Backend}, et
-@internalsref{All layout objects}.
+Référence du programme : @rinternals{OverrideProperty}, @rinternals{RevertProperty},
+@rinternals{PropertySet}, @rinternals{Backend}, et
+@rinternals{All layout objects}.
-@refbugs
+@knownissues
La sous-couche Scheme ne vérifie pas la saisie des propriétés de façon
très stricte. Des références cycliques dans des valeurs Scheme peuvent
Les réglages montrés dans les sous-sections @ref{Changing context
properties on the fly}, @ref{Modifying context plug-ins} et
-@ref{Layout tunings within contexts} peuvent également être saisis séparément
+@ref{Layout tunings within contexts} peuvent également être saisis indépendamment
de la musique dans le bloc @code{\layout}, au moyen de la commande @code{\context} :
@example
@end example
-@refbugs
+@knownissues
-Il est impossible de stocker des modifications de contexte dans un identifieur.
+Il est impossible de stocker des modifications de contexte dans un identificateur.
Le raccourci @code{\RemoveEmptyStaffContext} détruit tous les réglages
-du contexte @code{\Staff}. Pour modifier des propriétés de portées gouvernées
+du contexte @code{\Staff}. Pour modifier des propriétés de portées gouvernées
par @code{\RemoveEmptyStaffContext}, il faut le faire impérativement @emph{après}
-avoir invoqué @code{\RemoveemptyStaffContext} :
+avoir invoqué @code{\RemoveEmptyStaffContext} :
@example
\layout @{
de briques de constructions empilées. En combinant divers graveurs,
il est possible de créer de nouveaux types de contextes.
-Dans l'exemple suivant, on construit, de zéro, un nouveau contexte, très
+Dans l'exemple suivant, on construit, de zéro, un nouveau contexte très
semblable à @context{Voice}, mais qui n'imprime que des têtes de notes en forme
-de barres obliques, au centre de la portée. Un tel contexte, par exemple, peut
+de barres obliques au centre de la portée. Un tel contexte, par exemple, peut
servir à indiquer un passage improvisé dans un morceau de jazz.
+@c KEEP LY
@lilypond[quote,ragged-right]
\layout { \context {
\name ImproVoice
\relative c'' {
a4 d8 bes8 \new ImproVoice { c4^"ad lib" c
- c4 c^"undress" c_"while playing :)" c }
+ c4 c^"dévêtez-vous" c_"tout en jouant :)" c }
a1
}
@end lilypond
@end example
@noindent
-Le graveur @internalsref{Pitch_squash_engraver} intercepte les notes, créées par
-@internalsref{Note_heads_engraver}, et les @q{écrase} pour qu'elles aient toutes la
+Le graveur @rinternals{Pitch_squash_engraver} intercepte les notes créées par
+@rinternals{Note_heads_engraver}, et les @q{écrase} pour qu'elles aient toutes la
même position verticale, définie par @code{squashedPosition} : ici il s'agit de la
valeur@tie{}@code{0}, c'est-à-dire la ligne du milieu.
@end example
@item Afin que tous ces graveurs puissent travailler de concert, on leur adjoint un
-sous-programme special, introduit par la commande @code{\type} : il s'agit de
-@internalsref{Engraver_group},
+sous-programme spécial, introduit par la commande @code{\type} : il s'agit de
+@rinternals{Engraver_group},
@example
\type "Engraver_group"
@end example
@funindex \accepts
-Ce n'est pas tout. En effet, on veut intégrer le nouveau contexte @context{ImproVoice}
-dans la hiérarchie des contextes. Tout comme le contexte @code{Voice}, sa place est
-au sein du contexte @code{Staff}. Nous allons donc modifier le contexte @context{Staff},
+Ce n'est pas tout. En effet, on veut intégrer le nouveau contexte
+@context{ImproVoice} dans la hiérarchie des contextes. Tout comme le
+contexte @code{Voice}, sa place est au sein du contexte @code{Staff}.
+Nous allons donc modifier le contexte @context{Staff},
au moyen de la commande @code{\accepts} :
@example
Il est possible d'aligner verticalement chaque nouveau contexte,
en-dessous ou au-dessus, par exemple dans le cas de musique vocale
-(@ref{Vocal ensembles}) ou d'@qq{ossias}.
+(@rlearning{Vocal ensembles}) ou d'@qq{ossias}.
@cindex ossia
@findex alignAboveContext
Les objets @code{VerticalAlignment} et @code{VerticalAxisGroup}
travaillent de concert. Comme leurs noms anglais l'indiquent,
@code{VerticalAxisGroup} regroupe différents objets tels que les portées
-(@code{Staff}, les paroles (@code{Lyrics}) et ainsi de suite ; puis
+(@code{Staff}), les paroles (@code{Lyrics}) et ainsi de suite ; puis
@code{VerticalAlignment} synchronise verticalement ces différents groupes.
En général, il n'y a qu'un seul @code{VerticalAlignment} pour l'ensemble
de la partition, mais chaque contexte @context{Staff}, @context{Lyrics}, etc.
@node The \override command
@section The @code{\override} command
-La commande @code{\override} command permet de modifier la mise en page
-en détail. Examinons en détail comment l'utiliser concrètement.
+La commande @code{\override} permet de modifier la mise en page
+en détail. Examinons son utilisation concrètementet dans les détails.
La syntaxe de cette commande ressemble généralement à :
@example
Pour élaborer un réglage de ce type, on a besoin de connaître précisément :
@itemize
-@item le contexte : ici, @context{Voice} (la voix).
-@item l'objet à affecter : ici, @code{Stem} (les hampes).
-@item la propriété é modifier : ici, @code{thickness} (l'épaisseur du trait).
-@item la valeur désirée : ici, @code{3.0} (par défaut, elle est de 1.3).
+@item le contexte : ici @context{Voice} (la voix).
+@item l'objet à affecter : ici @code{Stem} (les hampes).
+@item la propriété à modifier : ici @code{thickness} (l'épaisseur du trait).
+@item la valeur désirée : ici @code{3.0} (par défaut, elle est de 1.3).
@end itemize
Certaines @q{sous-propriétés} sont parfois contenues dans une propriété.
@cindex régler
@funindex \override
-Pour bien des propriétés, quel que soit le type de valeur requise, attribuer la
-valeur @q{Faux} (lettre @code{##f} ) reviendra à désactiver complètement
-l'action de la propriétéqui se trouve ainsi purement ignorée par LilyPond.
-Cela peut s'avérer fort utile lorsque des propriétés causeraient, autrement, des
-désagréments.
+Pour bien des propriétés, quel que soit le type de valeur requise,
+attribuer la valeur @q{faux} (@code{##f} en Scheme) reviendra à désactiver
+complètement l'action de la propriété qui se trouve ainsi purement
+ignorée par LilyPond. Cela peut s'avérer fort utile pour des propriétés
+causant des désagréments.
@c such announcements are to be avoided -vv
@ignore
@quotation
@seealso
-Référence du programme : @internalsref{Fingering}.
+Référence du programme : @rinternals{Fingering}.
@end quotation
forward. For example, it says
@quotation
-Accepted by: @internalsref{Fingering_engraver},
+Accepted by: @rinternals{Fingering_engraver},
@end quotation
@noindent
plug-in, which says
@quotation
-This engraver creates the following layout objects: @internalsref{Fingering}.
+This engraver creates the following layout objects: @rinternals{Fingering}.
@end quotation
In other words, once the @code{FingerEvent}s are interpreted, the
@c I can't figure out what this is supposed to mean. -gp
The @code{Fingering_engraver} is also listed to create
-@internalsref{Fingering} objects,
+@rinternals{Fingering} objects,
@c old info? it doesn't make any sense to me with our current docs.
This is also the
@end ignore
@ifnothtml
-Ladite Référence est disponible au format HTML, ce qui rend la navigation bien
+Ladite référence est disponible au format HTML, ce qui rend la navigation bien
plus aisée. Il est possible soit de la lire en ligne, soit de la télécharger
dans ce format. La démarche présentée ici sera plus difficle à comprendre
dans un document au format PDF.
@end ifnothtml
-Suivons le lien @internalsref{Fingering}. En haut de la nouvelle page,
+Suivons le lien @rinternals{Fingering}. En haut de la nouvelle page,
on peut lire
@quotation
-Fingering objects are created by: @internalsref{Fingering_engraver} and
-@internalsref{New_fingering_engraver}.
+Fingering objects are created by: @rinternals{Fingering_engraver} and
+@rinternals{New_fingering_engraver}.
@end quotation
En d'autres termes, @emph{Les indications de doigtés}
(@code{Fingering} en anglais) @emph{sont créées par les graveurs
-@internalsref{Fingering_engraver} et @internalsref{New_fingering_engraver}.}
+@rinternals{Fingering_engraver} et @rinternals{New_fingering_engraver}.}
-En suivant derechef les liens propres à la Référence du programme, on suit en fait
+En suivant derechef les liens propres à la référence du programme, on suit en fait
le cheminement qui aboutit à la création de la partition :
@itemize @bullet
-@item @internalsref{Fingering}:
-@internalsref{Fingering} objects are created by:
-@internalsref{Fingering_engraver}
+@item @rinternals{Fingering}:
+@rinternals{Fingering} objects are created by:
+@rinternals{Fingering_engraver}
-@item @internalsref{Fingering_engraver}:
-Music types accepted: @internalsref{fingering-event}
+@item @rinternals{Fingering_engraver}:
+Music types accepted: @rinternals{fingering-event}
-@item @internalsref{fingering-event}:
+@item @rinternals{fingering-event}:
Music event type @code{fingering-event} is in Music expressions named
-@internalsref{FingerEvent}
+@rinternals{FingerEvent}
@end itemize
Ce cheminement se produit, bien sûr, en sens inverse : nous sommes ici partis
-du résultat, et avons abouti aux évènements (en anglais, @q{Events}) engendrés
-par le fichier d'entrée. L'inverse est également possible : on peut partir d'un
-évènement, et suivre le cheminement de LilyPond, qui aboutit à la création d'un
+du résultat, et avons abouti aux évènements (en anglais @q{Events}) engendrés
+par le fichier d'entrée. L'inverse est également possible : on peut partir d'un
+évènement, et suivre le cheminement de LilyPond qui aboutit à la création d'un
ou plusieurs objets graphiques.
-La Référence du programme peut également se parcourir comme un document normal.
+La référence du programme peut également se parcourir comme un document normal.
On y trouve des chapitres tels que
@ifhtml
-@internalsref{Music definitions},
+@rinternals{Music definitions},
@end ifhtml
@ifnothtml
@code{Music definitions}
@end ifnothtml
-@internalsref{Translation}, ou encore @internalsref{Backend}. Chaque chapitre
+@rinternals{Translation}, ou encore @rinternals{Backend}. Chaque chapitre
recense toutes les définitions employées, et les propriétés sujettes à
ajustements.
@c -- what about adding a link to the glossary here ? -vv
@ignore
La Référence du programme n'est pas traduite en français -- notamment du fait
-qu'elle est évolution constante, tout comme LilyPond. En revanche, les termes
+qu'elle est en évolution constante, tout comme LilyPond. En revanche, les termes
musicaux font l'objet d'un @commentfairelelien{glossaire} fort utile pour les utilisateurs
francophones.
@end ignore
(en anglais @q{Graphical Object}, d'où le diminutif @emph{Grob}).
Chaque objet est doté d'un certain nombre de propriétés (l'épaisseur du trait,
l'orientation, etc.), et lié à d'autres objets.
-Le fonctionnement de ces objets est décrit en détail dans @internalsref{grob-interface}.
+Le fonctionnement de ces objets est décrit en détail dans @rinternals{grob-interface}.
Prenons l'exemple des doigtés (en anglais @q{Fingering}).
La page @code{Fingering} de la Référence du programme établit une liste de définitions
-propre à ce type d'objets :
+propres à ce type d'objets :
@quotation
@code{padding} (dimension, in staff space):
@end quotation
@noindent
-Ce qui signifie que les doigtés doivent être maintenus à une certaine distance (@q{padding})
-des notes : 0,5 unités @q{staff-space} (espace de portée).
+Ce qui signifie que les doigtés doivent être maintenus à une certaine distance (@emph{padding})
+des notes : 0,5 unités @emph{staff-space} (espace de portée).
Chaque objet peut avoir plusieurs attributs, en tant qu'élément typographique
@end itemize
Faire appliquer ces différents attributs est le rôle des @emph{interfaces},
-que l'on trouve en bas de la page @internalsref{Fingering}.
+que l'on trouve en bas de la page @rinternals{Fingering}.
@quotation
This object supports the following interfaces:
-@internalsref{item-interface},
-@internalsref{self-alignment-interface},
-@internalsref{side-position-interface}, @internalsref{text-interface},
-@internalsref{text-script-interface}, @internalsref{font-interface},
-@internalsref{finger-interface}, and @internalsref{grob-interface}.
+@rinternals{item-interface},
+@rinternals{self-alignment-interface},
+@rinternals{side-position-interface}, @rinternals{text-interface},
+@rinternals{text-script-interface}, @rinternals{font-interface},
+@rinternals{finger-interface}, and @rinternals{grob-interface}.
@end quotation
@noindent
Pour aller encore plus loin, plutôt que de simplement parler de l'objet
@code{Fingering}, ce qui ne nous avance pas à grand chose, on peut aller explorer
-son âme même, dans les fichiers source de LilyPond (voir @ref{Default files}), en
-l'occurence le fichier @file{scm/@/define@/-grobs@/.scm} :
+son âme même, dans les fichiers source de LilyPond (voir
+@rlearning{Default files}), en l'occurence le fichier
+@file{scm/@/define@/-grobs@/.scm} :
@example
(Fingering
@end example
@noindent
-...où l'on découvre que l'objet @code{Fingering} n'est rien de plus qu'un
+@dots{}où l'on découvre que l'objet @code{Fingering} n'est rien de plus qu'un
amas de variables et de réglages. La page de la Référence du programme est
en fait directement engendrée par cette définition.
@quotation
@code{side-position-interface}
-Placer l'objet affecté à proximité d'autres objets. La propriété
+Placer l'objet affecté à proximité d'autres objets. La propriété
@code{direction} indique où placer l'objet (à droite ou à gauche,
en haut ou en bas).
@end quotation
@noindent
Ce qui signifie
-@quotation Ajouter tel espace supplémentaire entre des objets proches les uns des autres.
+@quotation
+Ajouter tel espace supplémentaire entre des objets proches les uns des
+autres.
@end quotation
@noindent
Dans le cas présent, le réglage intervient dans le contexte @context{Voice},
ce qui pouvait également se déduire de la Référence du programme, où la page
-du graveur @internalsref{Fingering_engraver} indique :
+du graveur @rinternals{Fingering_engraver} indique :
@quotation
-Fingering_engraver is part of contexts: @dots{} @internalsref{Voice}
+Fingering_engraver is part of contexts: @dots{} @rinternals{Voice}
@end quotation
@noindent
Ce qui signifie
@quotation
-Le graveur Fingering_engraver fait partie des contextes : @dots{} @internalsref{Voice}
+Le graveur Fingering_engraver fait partie des contextes : @dots{} @rinternals{Voice}
@end quotation
@funindex \tweak
Dans certains cas, on peut passer par un raccourci pour arranger les
-objets graphiques. Lorsque un objet est directement engendré par un élément distinct
+objets graphiques. Lorsqu'un objet est directement engendré par un élément distinct
du fichier source, on peut utiliser la commande @code{\tweak}.
Dans l'accord suivant, les notes sont modifiées une par une :
@end lilypond
Comme on peut le voir, les propriétés sont ici modifiées directement
-en même temps que les objets sont saisis. Il n'est plus besoin de spécifier ni
-le nom de l'objet (@q{grob}), ni le contexte dans lequel cela doit s'appliquer.
+en même temps que les objets sont saisis. Il n'est plus besoin de spécifier ni
+le nom de l'objet (@emph{grob}), ni le contexte dans lequel cela doit s'appliquer.
Ce procédé ne marche que pour des objets directement liés aux évènements
-(@internalsref{event}) du fichier source. Par exemple :
+(@rinternals{Event}) du fichier source. Par exemple :
@itemize @bullet
@item Les têtes de notes au sein d'un accord, qui sont directement engendrées par
@end itemize
En revanche, les hampes ou les altérations sont engendrées par les têtes de notes,
-et non par des évènements dans le fichier source. De même pour les clés, qui ne
+et non par des évènements dans le fichier source. De même pour les clés, qui ne
sont pas directement engendrées par le fichier source, mais plutôt par le
changement d'une propriété interne.
C'est en se servant du langage Scheme que l'on peut résoudre ce problème.
Dans cet exemple, on a recours aux méthodes décrites dans @ref{Adding
-articulation to notes (example), en particulier quant à l'emploi de
+articulation to notes (example)}, en particulier quant à l'emploi de
@code{\displayMusic}.
@example
@end example
@noindent
-Ici les propriétés @code{tweaks} de l'objet flageolet nommé
+Ici les propriétés @code{tweak} de l'objet flageolet nommé
@samp{m} (créé au moyen de @code{make-music}) sont extraites par
@code{ly:music-property}, une nouvelle valeur de la taille de fonte
-est ajoutée à la liste de ses propriétés (grpace à la fonction Scheme
-@code{acons}, et le résultat de cette opération est renvoyé par @code{set!}.
+est ajoutée à la liste de ses propriétés (grâce à la fonction Scheme
+@code{acons}), et le résultat de cette opération est renvoyé par @code{set!}.
Le dernier élément, dans ce bloc @code{let}, est la valeur finale de
@samp{m} lui-même.
@code{\set} et @code{\override}, c'est qu'il y a deux types de propriétés.
Les contextes peuvent avoir des propriétés, dont les noms commencent par une
-minuscule puis comprennent une ou plusieurs majuscules (de style @code{totoTutu}). Elles ont surtout trait
+minuscule puis comprennent une ou plusieurs majuscules (de style
+@code{totoTutu}). Elles ont surtout trait
à la notation des éléments musicaux : par exemple, @code{localKeySignature} permet
de choisir s'il faut ou non imprimer une altération, ou @code{measurePosition} permet
de choisir quand il faut imprimer une barre de mesure. Ces propriétés de contextes
Il existe un type particulier de propriétés : les descriptions
d'éléments. Ces propriétés, dont les noms commencent par une majuscule, puis comprennent
une ou plusieurs majuscules (de style @code{TotoTata}), contiennent les réglages
-@q{par défaut} pour les objets graphiques. Ces réglages sont sous forme de liste Scheme ; on
+@q{par défaut} pour les objets graphiques. Ces réglages sont sous forme de liste Scheme ; on
peut les consulter dans le fichier @file{scm/@/define@/-grobs@/.scm}.
Les descriptions d'éléments doivent être modifiées avec la commande @code{\override}.
ces propriétés, au moyen de fonctions de rappel.
La propriété @code{fontSize} est une exception : c'est un raccourci, qui équivaudrait
-à saisir @code{\override ... #'font-size} pour tous les objets textuels. Dans la mesure
-où il s'agit d'une manipulation très courante, une propriété spéciale a été créée. Elle doit
+à saisir @code{\override @dots{} #'font-size} pour tous les objets
+textuels. Dans la mesure où il s'agit d'une manipulation très
+courante, une propriété spéciale a été créée. Elle doit
être modifiée avec la commande @code{\set}.
@item
L'un d'entre eux est l'apparence des objets dits @q{spanner}, qui s'étendent
-horizontalement, tels que les liaisons. Si en principe, un seul de ces objets
-est créé à la fois, et peut donc être modifié de façon habituelle, lorsque ces
+horizontalement, tels que les liaisons. Si, en principe, un seul de ces objets
+est créé à la fois et peut donc être modifié de façon habituelle, lorsque ces
objets doivent enjamber un changement de ligne, ils sont dupliqués au début
-du ou des systèmes suivants. Comme ces objets sont des clones de l'objet d'origine,
+du ou des systèmes suivants. Comme ces objets sont des clones de l'objet d'origine,
ils en héritent toutes les propriétés, y compris les éventuelles commandes @code{\override}.
si oui, applique un espacement supplémentaire (@code{extra-offset}).
@end itemize
-On ajoute cette procédure à l'objet @internalsref{Tie} (liaison de tenue),
+On ajoute cette procédure à l'objet @rinternals{Tie} (liaison de tenue),
de façon à ce que le deuxième morceau d'une liaison divisée soit rehaussé.
@c KEEP LY
Lorsque cette astuce va être appliquée, notre nouvelle fonction de rappel
@code{after-line-breaking} devra également appeler celle d'origine
(@code{after-line-breaking}), si elle existe.
-Ainsi, si l'on veut l'utiliser pour un crescendo (objet @code{Hairpin}),
+Ainsi, pour l'utiliser dans le cas d'un crescendo (objet @code{Hairpin}),
il faudra appeler également @code{ly:hairpin::after-line-breaking}.
@item Pour des raisons d'ordre technique, certains objets ne peuvent être modifiés par
-@code{\override}. Parmi ceux-là, les objets @code{NonMusicalPaperColumn}
+@code{\override}. Parmi ceux-là, les objets @code{NonMusicalPaperColumn}
et @code{PaperColumn}. La commande @code{\overrideProperty} sert à les modifier, de
façon similaire à @code{\once \override}, mais avec une syntaxe différente :
projects / lilypond.git / blobdiff