]> git.donarmstrong.com Git - lilypond.git/commitdiff
Doc-fr: several updates
authorJean-Charles Malahieude <lilyfan@orange.fr>
Sun, 23 Dec 2012 19:20:44 +0000 (20:20 +0100)
committerJean-Charles Malahieude <lilyfan@orange.fr>
Sun, 23 Dec 2012 19:20:44 +0000 (20:20 +0100)
 - programming-interfaces
 - tweaks
 - input
 - rhythms
 - some texidocs markers

Documentation/fr/extending/programming-interface.itely
Documentation/fr/learning/tweaks.itely
Documentation/fr/notation/input.itely
Documentation/fr/notation/rhythms.itely
Documentation/fr/texidocs/applying-note-head-styles-depending-on-the-step-of-the-scale.texidoc
Documentation/fr/texidocs/using-alternative-flag-styles.texidoc

index 1928fa1a803b968041cab9ec33a84e19e4ebdb99..9ce3b7d544c85574a50874b2be1d6e943cf67359 100644 (file)
@@ -1,7 +1,7 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 
 @ignore
-    Translation of GIT committish: 00e1520dc9f0b4dabe38da8895d147b07af843b8
+    Translation of GIT committish: d0adf505f3902db683c1ba3c8c5f7caf2534b80e
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  For details, see the Contributors'
@@ -1417,9 +1417,10 @@ modifiés par @code{\override}.  Parmi ceux-là, les objets
 
 @example
 \overrideProperty
-Score.NonMusicalPaperColumn  % Nom de l'objet
-#'line-break-system-details  % Nom de la propriété
-#'((next-padding . 20))      % Valeur
+Score.NonMusicalPaperColumn      % Nom de l'objet
+  . line-break-system-details    % Nom de la propriété
+  . next-padding                 % Nom de la sous-propriété (optionnel)
+  . #20                          % Valeur
 @end example
 
 Notez toutefois que la commande @code{\override} peut tout de même être
index 919ee63f60b14e6bdf9baec0fe878f46b805aa48..b01f9b59519dc85d2d89692a0e4b78a61975eaa3 100644 (file)
@@ -1,7 +1,7 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 
 @ignore
-    Translation of GIT committish: b93dbb4dd2fe708d0360f190cb4d06fa29bcae53
+    Translation of GIT committish: d0adf505f3902db683c1ba3c8c5f7caf2534b80e
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  For details, see the Contributors'
@@ -193,8 +193,18 @@ propriété en fonction de son nom.
 @cindex retouches, méthodologie
 @cindex méthodes de retouche
 
+@menu
+* La commande \override::
+* La commande \revert::
+* Le préfixe \once::
+* La commande \overrideProperty::
+* La commande \tweak::
+@end menu
+
 
-@strong{La commande \override}
+@node La commande \override
+@unnumberedsubsubsec La commande @code{\override}
+@translationof The \override command
 
 @cindex override, commande
 @cindex override, syntaxe
@@ -270,7 +280,9 @@ g4 a b c |
 @end lilypond
 
 
-@strong{La commande \revert}
+@node La commande \revert
+@unnumberedsubsubsec La commande @code{\revert}
+@translationof The \revert command
 
 @cindex revert, commande
 
@@ -308,7 +320,9 @@ b4 c |
 @end lilypond
 
 
-@strong{Le préfixe \once}
+@node Le préfixe \once
+@unnumberedsubsubsec Le préfixe @code{\once}
+@translationof The \once prefix
 
 @funindex \once
 @funindex once
@@ -335,7 +349,10 @@ g4 a
 b c |
 @end lilypond
 
-@strong{La commande \overrideProperty}
+
+@node La commande \overrideProperty
+@unnumberedsubsubsec La commande @code{\overrideProperty}
+@translationof The \overrideProperty command
 
 @cindex overrideProperty, commande
 
@@ -350,7 +367,9 @@ ici par souci d'exhaustivité ; pour le détail, voir
 @c Maybe explain in a later iteration  -td
 
 
-@strong{La commande \tweak}
+@node La commande \tweak
+@unnumberedsubsubsec La commande @code{\tweak}
+@translationof The \tweak command
 
 @cindex tweak, commande
 
@@ -680,7 +699,7 @@ commandes -- mais il faut encore s'exercer.  Les exemples
 suivants sont là dans cette intention.
 
 
-@subheading Détermination du contexte adéquat
+@subsubsubheading Détermination du contexte adéquat
 @c VO Finding the context
 
 @cindex contexte, détermination du
@@ -702,7 +721,7 @@ niveau, qu'il est activé sans ambiguïté par le fait que l'on est
 en train de saisir des notes, on peut ici ne pas le mentionner.
 
 
-@subheading Redéfinition pour une seule occurrence
+@subsubsubheading Redéfinition pour une seule occurrence
 @c VO Overriding once only
 
 @cindex dérogation pour une seule fois
@@ -751,7 +770,7 @@ La commande @code{\once} peut aussi être utilisée devant la commande
 @code{\set}.
 
 
-@subheading Rétablissement
+@subsubsubheading Rétablissement
 @c VO Reverting
 
 @cindex revert
@@ -958,8 +977,12 @@ règles liées à ce type.  Le type de propriété est toujours donné entre
 parenthèses après le nom de propriété dans la RPI.  Voici une liste des
 différents types de propriétés, avec les règles qui les régissent et
 quelques exemples d'utilisation.  Il faut, bien sûr, toujours ajouter un
-symbole @emph{hash}, @code{#}, devant ces valeurs lors de la saisie de
-la commande @code{\override}.
+symbole @emph{hash} (@code{#}) devant ces valeurs lors de la saisie de
+la commande @code{\override}, ce même si cette valeur comporte
+déjà un @code{#} en premier caractère.  Les exemples ici présentés
+ne sont que de simples illustrations ; l'utilisation de Scheme
+pour obtenir des valeurs fait l'objet de la rubrique
+@rextend{Scheme et les calculs}.
 
 @multitable @columnfractions .2 .45 .35
 @headitem Type de propriété
@@ -970,29 +993,29 @@ la commande @code{\override}.
        sous la forme @code{#t} ou @code{#f}
   @tab @code{#t}, @code{#f}
 @item Dimension (en espaces de portée)
-  @tab Un nombre positif décimal (en unités de lignes de portée)
+  @tab Un nombre décimal (en unités de lignes de portée)
   @tab @code{2.5}, @code{0.34}
 @item Direction
-  @tab Une direction valide ou son équivalent numérique (valeur décimale
-  comprise entre -1 et 1 seulement)
-  @tab @code{LEFT}, @code{CENTER}, @code{UP}, @code{1}, @code{-1}
+  @tab Une direction valide ou son équivalent numérique (@code{0}
+  ou @code{CENTER} indiquent une position neutre)
+  @tab @code{LEFT}, @code{CENTER}, @code{UP}, @code{1}, @w{@code{-1}}
 @item Entier (@emph{Integer} en anglais)
-  @tab Un nombre entier positif
-  @tab @code{3}, @code{1}
+  @tab Un nombre entier
+  @tab @code{3}, @code{-1}
 @item Liste
-  @tab Plusieurs valeurs séparées par une espace, encadrées par des
-  parenthèses et précédées par une apostrophe
-  @tab @code{'(left-edge staff-bar)}, @code{'(1)},
+  @tab Une séquence de constantes ou symboles séparés par une
+  espace, encadrées par des parenthèses et précédées par une apostrophe
+  @tab @code{'(left-edge staff-bar)}, @code{'(1)}, @code{'()},
        @code{'(1.0 0.25 0.5)}
 @item Markup (ou étiquette)
   @tab Toute commande @code{\markup} valide
-  @tab @code{\markup @{ \italic "cresc." @}}
+  @tab @code{\markup @{ \italic "cresc." @}}, @code{"bagpipe"}
 @item Durée (@emph{Moment} en anglais)
   @tab Une durée de note construite avec la fonction make-moment
-  @tab @code{(ly:make-moment 1 4)}, @code{(ly:make-moment 3 8)}
+  @tab @code{(ly:make-moment 1/4)}, @code{(ly:make-moment 3/8)}
 @item Nombre
-  @tab Une valeur décimale positive ou négative
-  @tab @code{3.5}, @code{-2.45}
+  @tab Une valeur positive ou négative, qui peut être décimale
+  @tab @code{3}, @w{@code{-2.45}}
 @item Paire (de nombres)
   @tab Deux nombres séparées par @qq{espace point espace}, encadrés
 par des parenthèses et précédés par une apostrophe
@@ -1005,8 +1028,7 @@ par des parenthèses et précédés par une apostrophe
   @tab Un processus, ou @code{#f} pour empêcher toute action
   @tab @code{bend::print}, @code{ly:text-interface::print}, @code{#f}
 @item Vecteur
-  @tab Une liste de trois éléments encadrés par des parenthèses et
-  précédés par apostrophe-hash, @code{'#}
+  @tab Des constantes encadrés par @code{#(}@dots{}@code{)}
   @tab @code{'#(#t #t #f)}
 @end multitable
 
@@ -1066,9 +1088,17 @@ L'objet @code{BarLine} est également lié à plusieurs interfaces, dont la
 mesure -- et de beaucoup d'autres objets, bien sûr.  Examinons chacune
 d'elles tour à tour.
 
+@menu
+* La propriété stencil::
+* La propriété break-visibility::
+* La propriété transparent::
+* La propriété color::
+@end menu
+
 
-@subheading stencil
-@c VO stencil
+@node La propriété stencil
+@unnumberedsubsubsec La propriété @code{stencil}
+@translationof The stencil property
 
 @cindex stencil, propriété
 
@@ -1151,8 +1181,9 @@ zéro :
 @end lilypond
 
 
-@subheading visibilité des barres (break-visibility)
-@c VO break-visibility
+@node La propriété break-visibility
+@unnumberedsubsubsec La propriété @code{break-visibility}
+@translationof The break-visibility property
 
 @cindex break-visibility, propriété
 
@@ -1187,8 +1218,9 @@ Comme on peut le constater, cette solution-là aussi supprime les barres
 de mesure.
 
 
-@subheading transparence
-@c VO transparent
+@node La propriété transparent
+@unnumberedsubsubsec La propriété @code{transparent}
+@translationof The transparent property
 
 @cindex transparent, propriété
 @cindex transparence
@@ -1265,8 +1297,9 @@ qui s'obtient aussi par la commande @code{\hide} -- le laisse en
 place, mais de façon invisible.
 
 
-@subheading couleur
-@c VO color
+@node La propriété color
+@unnumberedsubsubsec La propriété @code{color}
+@translationof The color property
 
 @cindex color, propriété
 
@@ -1835,6 +1868,17 @@ les crochets, peuvent se décaler vers la gauche ou vers la droite selon
 qu'ils pointent vers le haut ou vers le bas.  Ce comportement est géré
 automatiquement dès lors que @code{direction} est activé.
 
+
+@menu
+* La propriété direction::
+* Doigtés::
+@end menu
+
+
+@node La propriété direction
+@unnumberedsubsubsec La propriété @code{direction}
+@translationof The direction property
+
 @cindex down
 @cindex up
 @cindex center
@@ -1925,8 +1969,9 @@ limiter les effets des autres commandes prédéfinies (fonctionnant
 précéder d'un @code{\once}, comme pour toute dérogation.
 
 
+@node Doigtés
 @unnumberedsubsubsec Doigtés
-@c VO Fingering
+@translationof Fingering
 
 @cindex doigtés, positionnement
 @cindex doigtés, accords
@@ -2049,7 +2094,7 @@ Voici quelques exemples :
 Si les indications de doigtés paraissent un peu serrées, on peut
 toujours réduire la taille de police (@code{font-size}).  La valeur
 par défaut donnée dans la RPI à la page de l'objet
-@code{Fingering} étant @code{-5}, essayons @code{-7} :
+@code{Fingering} étant @code{-5}, essayons @w{@code{-7}} :
 
 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
 \override Fingering.font-size = #-7
@@ -2076,16 +2121,33 @@ par défaut donnée dans la RPI à la page de l'objet
 @translationof Outside-staff objects
 
 Les objets extérieurs à la portée sont placés automatiquement de façon à
-éviter les collisions.  Les objets avec la plus petite valeur de la
-propriété @code{outside-staff-priority} sont placés au plus près de la
-portée, tandis que les autres sont écartés autant qu'il faut pour éviter
-les collisions.  La @code{outside-staff-priority} est définie dans la
-@code{grob-interface} ; elle est donc une propriété commune à tous
-les objets de rendu.  Par défaut, elle est réglée sur @code{#f} pour
-tous les objets de la portée, et porte une valeur numérique appropriée à
-chacun des objets extérieurs à la portée, à mesure qu'ils sont créés.
-Le tableau suivant montre la valeur numérique par défaut pour
-quelques-uns des objets extérieurs à la portée les plus courant.
+éviter les collisions.  Il est toutefois possible, grâce à
+différentes méthodes, de rectifier un positionnement automatique
+qui se révèlerait ne pas être optimal.
+
+@menu
+* La propriété outside-staff-priority::
+* La commande \textLengthOn::
+* Positionnement des nuances::
+* Dimensionnement des objets graphiques::
+@end menu
+
+
+@node La propriété outside-staff-priority
+@unnumberedsubsubsec La propriété @code{outside-staff-priority}
+@translationof The outside-staff-priority property
+
+Les objets avec la plus petite valeur de la propriété
+@code{outside-staff-priority} sont placés au plus près de la
+portée, tandis que les autres sont écartés autant qu'il faut pour
+éviter les collisions.  La @code{outside-staff-priority} est
+définie dans la @code{grob-interface} ; elle est donc une
+propriété commune à tous les objets de rendu.  Par défaut, elle
+est réglée sur @code{#f} pour tous les objets de la portée, et
+porte une valeur numérique appropriée à chacun des objets
+extérieurs à la portée, à mesure qu'ils sont créés.  Le tableau
+suivant montre la valeur numérique par défaut pour quelques-uns
+des objets extérieurs à la portée les plus courant.
 
 @cindex spanners
 @cindex bandeaux
@@ -2294,7 +2356,9 @@ notes pour laisser plus de place au texte.  C'est possible grâce à la
 commande @code{textLengthOn}.
 
 
-@subheading \textLengthOn
+@node La commande \textLengthOn
+@unnumberedsubsubsec La commande @code{\textLengthOn}
+@translationof The \textLengthOn command
 
 @cindex notes, répartition selon le texte
 
@@ -2357,8 +2421,9 @@ c''2 |
 @end lilypond
 
 
-@subheading Nuances
-@c VO Dynamics
+@node Positionnement des nuances
+@unnumberedsubsubsec Positionnement des nuances
+@translationof Dynamics placement
 
 @cindex modification du positionnement des nuances
 @cindex nuances, modification du positionnement
@@ -2399,8 +2464,9 @@ pas d'équivalent pour les indications de nuance.  Il nous faut donc
 chercher à faire cela avec la commande @code{\override}.
 
 
-@subheading Dimensionnement des objets graphiques
-@c VO Grob sizing
+@node Dimensionnement des objets graphiques
+@unnumberedsubsubsec Dimensionnement des objets graphiques
+@translationof Grob sizing
 
 @cindex grob, dimensionnement
 @cindex dimensionnement des grobs
@@ -2744,9 +2810,21 @@ trouver les propriétés à retoucher pour obtenir un déplacement.
 Voyons maintenant comment les propriétés décrites dans la section
 précédente peuvent nous aider à résoudre les collisions.
 
+@menu
+* La propriété padding::
+* La propriété right-padding::
+* La propriété staff-padding::
+* La propriété self-alignment-X::
+* La propriété staff-position::
+* La propriété extra-offset::
+* La propriété positions::
+* La propriété force-hshift::
+@end menu
+
 
-@subheading la propriété padding
-@c VO padding property
+@node La propriété padding
+@unnumberedsubsubsec La propriété @code{padding}
+@translationof The padding property
 
 @cindex décalage (padding)
 @cindex résolution des chevauchements de notation
@@ -2791,8 +2869,9 @@ fait partie d'un ensemble d'objets positionnés en fonction de leur
 les autres objets du groupe.
 
 
-@subheading la propriété right-padding
-@c VO right-padding
+@node La propriété right-padding
+@unnumberedsubsubsec La propriété @code{right-padding}
+@translationof The right-padding property
 
 @cindex right-padding, propriété
 
@@ -2834,11 +2913,10 @@ la propriété @code{text} de @code{Accidental}, déclaré comme étant un
 signe sesqui-dièse.  Celui-ci est ensuite repoussé devant la tête de
 note par la retouche de @code{right-padding}.
 
-@noindent
-
 
-@subheading la propriété staff-padding
-@c VO staff-padding property
+@node La propriété staff-padding
+@unnumberedsubsubsec La propriété @code{staff-padding}
+@translationof The staff-padding property
 
 @cindex alignement d'objets sur une ligne de base
 @cindex objets, alignement sur une ligne de base
@@ -2869,8 +2947,9 @@ a4\f b\mf c\mp b\p
 @end lilypond
 
 
-@subheading la propriété self-alignment-X
-@c VO self-alignment-X property
+@node La propriété self-alignment-X
+@unnumberedsubsubsec La propriété @code{self-alignment-X}
+@translationof The self-alignment-X property
 
 L'exemple suivant montre comment résoudre une collision entre une
 indication de corde et une hampe, en alignant le coin droit sur le point
@@ -2887,8 +2966,9 @@ de référence de la note parente :
 @end lilypond
 
 
-@subheading la propriété staff-position
-@c VO staff-position property
+@node La propriété staff-position
+@unnumberedsubsubsec La propriété @code{staff-position}
+@translationof The staff-position property
 
 @cindex collision d'objets à l'intérieur d'une portée
 
@@ -2929,8 +3009,9 @@ car la ligne supplémentaire au-dessus du silence est insérée
 automatiquement.
 
 
-@subheading la propriété extra-offset
-@c VO extra-offset property
+@node La propriété extra-offset
+@unnumberedsubsubsec La propriété @code{extra-offset}
+@translationof The extra-offset property
 
 @cindex positionnement des objets
 @cindex positionnement des grobs
@@ -2955,8 +3036,9 @@ f4-5
 @end lilypond
 
 
-@subheading la propriété positions
-@c VO positions property
+@node La propriété positions
+@unnumberedsubsubsec La propriété @code{positions}
+@translationof The positions property
 
 @cindex contrôle des nolets, liaisons, phrasés et ligatures
 @cindex gestion manuelle des nolets, liaisons, phrasés et ligatures
@@ -2967,40 +3049,39 @@ f4-5
 
 La propriété @code{positions} permet de contrôler manuellement la
 position et l'inclinaison des nolets, coulés, liaisons de phrasé et
-barres de ligature.  Voici un exemple avec une horrible liaison de
-phrasé -- horrible pour avoir tenté de contourner la liaison de
-l'acciaccature.
+barres de ligature.
 
-@lilypond[quote,verbatim,fragment,ragged-right,relative=1]
-r4 \acciaccatura e8\( d8 c~ c d c d\)
-@end lilypond
+Voici un exemple où la liaison de phrasé recouvre la liaison
+d'articulation :
 
-@noindent
-Nous pourrions tout simplement déplacer la liaison de phrasé au-dessus
-des notes, et ce serait la meilleure solution :
-
-@lilypond[quote,verbatim,fragment,ragged-right,relative=1]
-r4
-\phrasingSlurUp
-\acciaccatura e8\( d8 c~ c d c d\)
+@lilypond[quote,verbatim,fragment,ragged-right,relative=2]
+a8 \( ( a'16 ) a \)
 @end lilypond
 
-@noindent
-Mais si, pour une quelconque raison, cette solution n'était pas
-envisageable, l'autre solution consiste à déplacer légèrement vers le
-bas l'extrémité gauche de la liaison de phrasé, grâce à la propriété
-@code{positions}.  Cela corrige en même temps la forme plutôt
-disgracieuse de la liaison.
-
 @cindex PhrasingSlur, exemple de dérogation
 @cindex positions, exemple d'utilisation de la propriété
 
-@lilypond[quote,verbatim,fragment,ragged-right,relative=1]
-r4
-\once \override PhrasingSlur.positions = #'(-4 . -3)
-\acciaccatura e8\( d8 c~ c d c d\)
+@noindent
+Nous pourrions envisager de remonter quelque peu les extrémités
+de la liaison de phrasé.  Commençons par repositionner l'extrémité
+gauche à 2,5 espaces de portée au-dessus de la ligne médiane, et
+la droite à 4,5 ; LilyPond choisira la courbe dont les extrémités
+seront les plus approchantes de celle déterminées :
+
+@lilypond[quote,verbatim,fragment,ragged-right,relative=2]
+\once \override PhrasingSlur.positions = #'(2.5 . 4.5)
+a8 \( ( a'16 ) a \)
 @end lilypond
 
+C'est déjà mieux, mais ne pourrait-on pas maintenant abaisser un
+peu l'extrémité droite de la liaison d'articulation ?  Vous
+constaterez qu'il n'est pas possible d'y arriver, tout simplement
+parce qu'il n'y a pas de meilleur candidat ; la propriété
+@code{positions} n'est alors d'aucune utilité.  Les liaisons,
+aussi bien de tenue que d'articulation ou de phrasé, peuvent se
+positionner et se dessiner tout en finesse lorsque nécessaire --
+voir à ce sujet @ruser{Modification des liaisons}.
+
 Voici un autre exemple. Comme nous pouvons le constater, les barres de
 ligature chevauchent les liaisons de tenue :
 
@@ -3053,8 +3134,9 @@ second bloc de croches de la première voix mais qu'il ne s'applique
 à aucune mesure de la deuxième voix.
 
 
-@subheading la propriété force-hshift
-@c VO force-hshift property
+@node La propriété force-hshift
+@unnumberedsubsubsec La propriété @code{force-hshift}
+@translationof The force-hshift property
 
 Maintenant, nous sommes prêts à appliquer les dernières corrections à
 l'exemple de Chopin présenté à la fin de @ref{J'entends des Voix}, que
@@ -3666,6 +3748,11 @@ lhMusic = \relative c' {
 @subsection Autres utilisations des retouches
 @translationof Other uses for tweaks
 
+@menu
+* Liaison entre plusieurs voix::
+* Rendu MIDI d'un point d'orgue::
+@end menu
+
 @cindex transparent, utilisation de la propriété
 @cindex création d'objet invisible
 @cindex suppression d'objets
@@ -3677,8 +3764,9 @@ lhMusic = \relative c' {
 @cindex liaison de tenue avec changement de voix
 
 
-@subheading Liaison entre plusieurs voix
-@c VO Tying notes across voices
+@node Liaison entre plusieurs voix
+@unnumberedsubsubsec Liaison entre plusieurs voix
+@translationof Tying notes across voices
 
 Voici un exemple qui montre comment créer une liaison de
 prolongation entre des notes appartenant à des voix différentes.  En
@@ -3760,8 +3848,9 @@ comme les têtes des notes d'un accord.  En effet, la présence d'un
 par l'expression musicale qui le suit directement.
 
 
-@subheading Rendu MIDI d'un point d'orgue
-@c VO Simulating a fermata in MIDI
+@node Rendu MIDI d'un point d'orgue
+@unnumberedsubsubsec Rendu MIDI d'un point d'orgue
+@translationof Simulating a fermata in MIDI
 
 @cindex stencil, utilisation de la propriété
 @cindex point d'orgue, rendu en MIDI
@@ -4273,7 +4362,7 @@ encore vous l'avez compilé directement à partir des sources ; et
 (b) du système d'exploitation sur lequel il tourne.
 
 
-@strong{Téléchargé depuis lilypond.org}
+@subsubsubheading Téléchargé depuis lilypond.org
 
 @itemize @bullet
 @item GNU/Linux
@@ -4303,8 +4392,7 @@ Dans l'Explorateur Windows, voir
 @end itemize
 
 
-@strong{Installé par un gestionnaire de paquetages ou compilé d'après
-les sources}
+@subsubsubheading Installé par un gestionnaire de paquetages ou compilé d'après les sources
 
 @code{@var{PREFIX}/share/lilypond/@var{X.Y.Z}/}, où
 @var{PREFIX} est déterminé par votre gestionnaire de paquetages ou par
index c15f9fcfae8b4deb1f658c4fa90f52fb25b79f59..1955b160de0ee7fe6c034e4f9a6d46142a2d9c58 100644 (file)
@@ -1,7 +1,7 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 
 @ignore
-    Translation of GIT committish: f8e7ac6dcdc5255d0c409ca68407f04dc8b98b99
+    Translation of GIT committish: d0adf505f3902db683c1ba3c8c5f7caf2534b80e
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  For details, see the Contributors'
@@ -1277,9 +1277,14 @@ musicale :
 
 @table @emph
 @item Les annotations événementielles
-se rattachent à des événements particuliers, comme une note individuelle
-ou au sein d'un accord, un élément d'interprétation (ligature, liaison,
-doigté, accent ou nuance) et des paroles.
+se rattachent à des événements particuliers, comme une note individuelle,
+un élément d'interprétation (doigté, accent ou nuance) ou des événements
+postérieurs (liaison, ligature manuelle).  Une note de bas de page
+événementielle se libelle généralement sous la forme :
+
+@example
+[@var{position}] \footnote [@var{marque}] @var{décalage} @var{annotation} @var{musique}
+@end example
 
 @item Les annotations temporelles
 se rapportent à un point particulier du déroulement d'un contexte
@@ -1287,19 +1292,24 @@ musical.  Certaines commandes, telles @code{\time} et @code{\clef}, ne
 reposent pas sur un événement pour la création de l'objet métrique ou
 clef.  Il en va de même pour un accord : sa hampe ou ses crochets ne
 sont créés qu'à la fin d'un moment (plus exactement au travers de l'un
-des événements note qui le composent).  Une annotation temporelle permet
-d'annoter ces objets de rendus sans se référer à un événement.
-
-@end table
+des événements note qui le composent).  Il n'est pas possible de
+connaître assurément lequel des événements note d'un accord est
+plus particulièrement à l'origine de la hampe ou du crochet.  Il
+est donc plus aisé, pour de tels éléments, d'utiliser des
+annotations temporelles.
 
-Examinons la forme développée d'une commande de note de bas de page,
-qu'elle soit événementielle ou temporelle :
+Une annotation temporelle permet d'annoter des objets de rendus
+sans se référer à un événement.  Elle se libelle généralement sous
+la forme :
 
 @example
-[@var{position}] \footnote [@var{marque}] @var{décalage} [@var{nom-grob}] @var{annotation} @var{musique}
+\footnote [@var{marque}] @var{décalage} @var{annotation} [@var{Contexte}.]@var{nom-grob}
 @end example
 
-Ses arguments peuvent se définir ainsi :
+@end table
+
+Les arguments, quelle que soit la catégorie d'annotation, peuvent se
+définir ainsi :
 
 @table @var
 @item position
@@ -1324,13 +1334,17 @@ haut, des valeurs négatives vers la gauche ou le bas ; des valeurs à
 zéro centrent la marque sur le point de référence.  Le décalage
 s'exprime en espace de portée.
 
+@item Contexte
+Le contexte auquel appartient l'objet à annoter.  Cet argument
+peut être omis dès lors qu'il s'agit d'un contexte de bas niveau
+tel que @code{Voice}.
 @item nom-grob
-Le type d'objet à annoter -- @samp{#'Flag} par exemple.  Lorsque cet
+Le type d'objet à annoter -- @samp{Flag} par exemple.  Lorsque cet
 élément est spécifié, c'est l'objet en question qui servira de point de
 référence, même s'il trouve son origine non pas directement dans
-l'élément @var{musique} mais dans un objet en résultant.  Son absence ou
-une valeur de @code{\default} ne permet d'annoter que des objets
-directement créés.
+une expression musicale mais dans tout objet du type spécifié
+intervenant à cet instant précis de la partition.
 
 @item annotation
 un @emph{markup} ou une chaîne de caractères qui sera reporté au bas de
@@ -1339,29 +1353,24 @@ la page.
 @item musique
 l'élément qui fait l'objet du commentaire, qu'il s'agisse d'un
 événement musical, de l'un des constituants d'un accord ou d'un
-événement rattaché.  Bien qu'il ne puisse être omis, il peut être
-remplacé par @code{\default}, auquel cas l'annotation ne sera pas
-rattachée à une expression musicale particulière, mais plutôt à un
-instant précis.  L'argument @var{nom-grob} est alors obligatoire pour
-sélectionner le type d'objet affecté -- @samp{#'TimeSignature} par
-exemple.
+événement rattaché.
 
 @end table
 
+
 @subsubsubheading Notes de bas de page événementielles
 @c VO Event-based footnotes
 
 @cindex événementielle, note de bas de page
 
-Le moyen le plus simple d'annoter un événement est :
+Ce type de note de bas de page s'attache à un objet de rendu
+généré directement par l'événement correspondant à @var{musique}.
+Il répond à la syntaxe :
 
 @example
-\footnote @var{décalage} @var{annotation} @var{musique}
+\footnote [@var{décalage}] @var{décalage} @var{annotation} @var{musique}
 @end example
 
-Ce type de note de bas de page s'attache à un objet de rendu
-généré directement par l'événement correspondant à @var{musique}.
-
 @c KEEP LY
 @lilypond[quote,verbatim,papersize=a8landscape]
 \book {
@@ -1376,12 +1385,16 @@ généré directement par l'événement correspondant à @var{musique}.
 @end lilypond
 
 Lorsque l'annotation concerne un événement postérieur ou une
-articulation, la commande @code{\footnote} doit être précédée d'un
-indicateur de position (@code{-, _} ou @code{^}) et suivie de
-l'événement postérieur ou l'articulation comme argument
+articulation, la commande @code{\footnote} @strong{doit} être
+précédée d'un indicateur de position (@code{-, _} ou @code{^}) et
+suivie de l'événement postérieur ou l'articulation comme argument
 @var{musique}.  Dans ce cas, la commande @code{\footnote} peut se
 considérer comme une copie de son dernier argument auquel oon
-attache une annotation.
+attache une annotation.  La syntaxe consacrée est :
+
+@example
+@var{position} \footnote [@var{marque}] @var{décalage} @var{annotation} @var{musique}
+@end example
 
 @c KEEP LY
 @lilypond[quote,verbatim,papersize=a8landscape]
@@ -1400,61 +1413,77 @@ attache une annotation.
 Les appels de note peuvent être personnalisés, et le trait reliant
 l'objet à l'appel supprimé :
 
+
+@subsubsubheading Notes de bas de page temporelles
+@c VO Time-based footnotes
+
+@cindex temporelle, note de bas de page
+
+Lorsque la note de bas de page se réfère à un objet de rendu résultant
+d'un événement -- @code{Accidental} ou @code{Stem} découlent d'un
+@code{NoteHead} --, l'argument @var{nom-grob} de l'objet en question est
+requis après le texte de l'annotation, en lieu et place de
+@var{musique} :
+
 @c KEEP LY
 @lilypond[quote,verbatim,papersize=a8landscape]
 \book {
   \header { tagline = ##f }
-  \relative c' {
-    \footnote "*" #'(0.5 . -2) \markup { \italic "* La première note" }
-    a'4 b8
-    \footnote \markup { \super "$" } #'(0.5 . 1)
-      \markup { \super "$" \italic " La deuxième note" }
-    e c4
-    \once \override Score.FootnoteItem #'annotation-line = ##f
-    b-\footnote \markup \tiny "+" #'(0.1 . 0.1)
-      \markup { \super "+" \italic " Éditorial" } \p
+  \relative c'' {
+    \footnote #'(-1 . -3) "Un bémol" Accidental
+    aes4 c
+    \footnote #'(-1 . 0.5) "Un autre bémol" Accidental
+    ees
+    \footnote #'(1 . -2) "Une hampe" Stem
+    aes
   }
 }
 @end lilypond
 
-D'autres exemples de personnalisation des appels de note sont donnés à
-la rubrique @ref{Notes de bas de page dans du texte indépendant}.
+Notez bien que, lorsque @var{nom-grob} est spécifié, tous les objets de
+ce type qui se trouvent à ce même instant se verront attacher une
+annotation :
 
-L'annotation d'un accord dans sa globalité n'est pas réalisable de cette
-manière dans la mesure où un accord ne génère pas d'événement en dehors
-de ses constituants.  Les notes qui le composent peuvent cependant faire
-l'objet d'une annotation.
+@c KEEP LY
+@lilypond[quote,verbatim,papersize=a8landscape]
+\book {
+  \header { tagline = ##f }
+  \relative c' {
+    \footnote #'(-1 . 3) "Un bémol" Accidental
+    <ees ges bes>4
+    \footnote #'(2 . 0.5) "Une articulation" Script
+    c'->-.
+  }
+}
+@end lilypond
 
-Lorsque la note de bas de page se réfère à un objet de rendu résultant
-d'un événement -- @code{Accidental} ou @code{Stem} découlent d'un
-@code{NoteHead} --, l'argument additionnel @var{nom-grob} est requis
-avant le texte de l'annotation :
+L'un des constituants d'un accord peut individuellement se voir attribuer
+une annotation.  Une tête de note (@code{NoteHead}) est le (seul) objet
+directement généré par un constituant d'accord ; elle peut donc être
+affectée d'une annotation événementielle.  Tous les autres objets
+constituant un accord sont générés indirectment ; ils ne pourront faire
+l'objet que d'une annotation temporelle, préfixée d'un @code{\single} :
 
 @c KEEP LY
 @lilypond[quote,verbatim,papersize=a8landscape]
 \book {
   \header { tagline = ##f }
   \relative c'' {
-    % footnotes may be added to chord constituents
-    < \single\footnote #'(-1 . -3) "Un autre bémol" Accidental aes
-      c
-      \single\footnote #'(-1 . 0.5) "Un bémol" Accidental ees
+    < \footnote #'(1 . -2) "Un la" a
+      \single \footnote #'(-1 . -1) "Un dièse" Accidental
+      cis
+      \single \footnote #'(0.5 . 0.5) "Un bémol" Accidental
+      ees fis
     >2
-    \single\footnote #'(-1 . 2) "Une hampe" Stem ees2
   }
 }
 @end lilypond
 
 @warning{Lorsque plusieurs notes de bas de page se rapportent à un même
-empilement vertical, elles sont numérotées et apparaîtront selon
-l'ordre vertical des éléments présentés, autrement dit celui positionné
-le plus haut en premier, non dans leur ordre d'apparition dans le
-fichier source.}
-
-@subsubsubheading Notes de bas de page temporelles
-@c VO Time-based footnotes
-
-@cindex temporelle, note de bas de page
+empilement vertical comme ci-dessus, elles sont numérotées et
+apparaîtront selon l'ordre vertical des éléments présentés, autrement dit
+celui positionné le plus haut en premier, non dans leur ordre
+d'apparition dans le fichier source.}
 
 Les objets de rendu tels que changement de clef ou d'armure tirent leur
 origine dans la modification d'une propriété plutôt que d'un véritable
@@ -1462,17 +1491,14 @@ origine dans la modification d'une propriété plutôt que d'un véritable
 directement de la temporisation.  C'est la raison pour laquelle de tels
 objets doivent s'annoter en fonction de leur survenance au fil de la
 musique.  Les notes de bas de page temporelles sont la solution à
-privilégier lorsqu'il s'agit d'annoter les hampes ou ligature affectant
+privilégier lorsqu'il s'agit d'annoter les hampes ou ligatures affectant
 des accords : bien qu'une telle fonctionnalité puisse s'appliquer à l'un
 des événements constituant l'accord, rien ne laisse présager lequel
-serait le plus adéquat.
+serait le plus approprié.
 
-Une note de bas de page temporelle s'introduit de la même manière qu'une
-note événementielle, à ceci près que la mention @code{\default}
-remplacera l'argument @var{musique} qui indique l'événement à annoter.
 En matière de note de bas de page temporelle, l'objet de rendu considéré
-devrait toujours être mentionné explicitement, de telle sorte qu'il n'y
-ait pas d'erreur quant au positionnement de l'appel de note.
+doit toujours être mentionné explicitement, ainsi que le contexte si
+l'objet est créé dans un autre contexte que celui du plus bas niveau.
 
 @c KEEP LY
 @lilypond[quote,verbatim,papersize=a8landscape]
@@ -1493,6 +1519,29 @@ ait pas d'erreur quant au positionnement de l'appel de note.
 }
 @end lilypond
 
+Les appels de note peuvent être personnalisés, et le trait reliant
+l'objet à l'appel supprimé :
+
+@c KEEP LY
+@lilypond[quote,verbatim,papersize=a8landscape]
+\book {
+  \header { tagline = ##f }
+  \relative c' {
+    \footnote "*" #'(0.5 . -2) \markup { \italic "* La première note" }
+    a'4 b8
+    \footnote \markup { \super "$" } #'(0.5 . 1)
+      \markup { \super "$" \italic " La deuxième note" }
+    e c4
+    \once \override Score.FootnoteItem #'annotation-line = ##f
+    b-\footnote \markup \tiny "+" #'(0.1 . 0.1)
+      \markup { \super "+" \italic " Éditorial" } \p
+  }
+}
+@end lilypond
+
+D'autres exemples de personnalisation des appels de note sont donnés à
+la rubrique @ref{Notes de bas de page dans du texte indépendant}.
+
 
 @node Notes de bas de page dans du texte indépendant
 @unnumberedsubsubsec Notes de bas de page dans du texte indépendant
@@ -1651,8 +1700,8 @@ Référence des propriétés internes :
 Les notes de bas de page ne peuvent que s'empiler l'une au-dessus de
 l'autre ; elles ne seront jamais présentées à la queue leu leu.
 
-Silence multimesures et ligatures automatiques ne peuvent se voir
-affecter de note de bas de page.
+Silences multimesures, ligatures automatiques et paroles ne peuvent se
+voir affecter de note de bas de page.
 
 Les notes de bas de page peuvent générer des chevauchements quand elles
 sont trop nombreuses sur une même page.
index 67324ba8991106ad72e764f6eb511abd779fe2ac..1be472041fc8b10ecbfcdca6018fedf506d26d72 100644 (file)
@@ -1,7 +1,7 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 
 @ignore
-    Translation of GIT committish: d4c6b132223ef4312a637160503a132c2373f525
+    Translation of GIT committish: d0adf505f3902db683c1ba3c8c5f7caf2534b80e
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  For details, see the Contributors'
@@ -3043,7 +3043,7 @@ visible ou non.  Les valeurs sont rangées dans l'ordre suivant :
 numéros de mesure :
 
 @lilypond[verbatim,quote,relative=1]
-\override Score.BarNumber.break-visibility = #'#(#t #t #t)
+\override Score.BarNumber.break-visibility = ##(#t #t #t)
 \set Score.currentBarNumber = #11
 % Permit first bar number to be printed
 \bar ""
index c67a1e3b443d91b3a36ff3f1377a319313bf2472..7838e3a8d44b0f7a54a3294aab0b61a3b5755798 100644 (file)
@@ -1,4 +1,4 @@
-%% Translation of GIT committish: e99967817ff985eb5bd5b0220b2fbf552963f9de
+%% Translation of GIT committish: d0adf505f3902db683c1ba3c8c5f7caf2534b80e
   texidocfr = "
 La propriété @code{shapeNoteStyles} permet d'affecter un profil
 particulier à chaque degré de la gamme -- à partir de l'armure ou
index 083e54e0c97256f4a884db199bdbbdd46033cc67..2ca584ccc1227a28e8cb2be06611f00a0b96036e 100644 (file)
@@ -1,6 +1,6 @@
-%% Translation of GIT committish: e99967817ff985eb5bd5b0220b2fbf552963f9de
+%% Translation of GIT committish: d0adf505f3902db683c1ba3c8c5f7caf2534b80e
   texidocfr = "
-Une dérogation à la propriété  @code{stencil} de l'objet @code{Flag}
+Une dérogation à la propriété @code{stencil} de l'objet @code{Flag}
 permet aux croches et notes de durée inférieure d'adopter une autre
 forme de crochet.  Sont disponibles les variantes
 @code{modern-straight-flag} et @code{old-straight-flag}.