]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/fr/notation/editorial.itely
Merge branch 'master' of /home/jcharles/GIT/Lily/. into translation
[lilypond.git] / Documentation / fr / notation / editorial.itely
index 677da1255f063f80afb1c7ffe342e1da52ca7a21..1e53df13d9c77d795092e95572c472c4f4882400 100644 (file)
@@ -1,14 +1,14 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 
 @ignore
-    Translation of GIT committish: f8e7ac6dcdc5255d0c409ca68407f04dc8b98b99
+    Translation of GIT committish: 53cff5245f682708a6c77d580f418ece2923c2e4
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  For details, see the Contributors'
     Guide, node Updating translation committishes..
 @end ignore
 
-@c \version "2.17.11"
+@c \version "2.19.21"
 
 @c Translators: Jean-Charles Malahieude
 
@@ -55,27 +55,115 @@ l'intérieur même de la portée.
 
 @funindex fontSize
 @funindex font-size
+@funindex magnification->font-size
 @funindex magstep
-@funindex \huge
-@funindex \large
-@funindex \normalsize
-@funindex \small
-@funindex \tiny
+@funindex magnifyMusic
 @funindex \teeny
-@funindex huge
-@funindex large
-@funindex normalsize
-@funindex small
-@funindex tiny
+@funindex \tiny
+@funindex \small
+@funindex \normalsize
+@funindex \large
+@funindex \huge
 @funindex teeny
+@funindex tiny
+@funindex small
+@funindex normalsize
+@funindex large
+@funindex huge
+
+@warning{@*
+Pour les tailles de police textuelle, voir
+@ref{Sélection de la fonte et de la taille}.@*
+Pour la taille des portées, voir
+@ref{Définition de la taille de portée}.@*
+Pour les petites notes, voir
+@ref{Mise en forme d'une citation}.@*
+Pour les variantes, voir @ref{Portées d'ossia}.}
+
+Le plus sûr moyen de régler la taille des éléments de notation sans
+modifier la taille de la portée consiste à utiliser la commande
+@code{\magnifyMusic} :
+
+@c Grieg Piano Concerto (mvt.1 cadenza)
+@lilypond[verbatim,quote]
+\new Staff <<
+  \new Voice \relative {
+    \voiceOne
+    <e' e'>4 <f f'>8. <g g'>16 <f f'>8 <e e'>4 r8
+  }
+  \new Voice \relative {
+    \voiceTwo
+    \magnifyMusic 0.63 {
+      \override Score.SpacingSpanner.spacing-increment = #(* 1.2 0.63)
+      r32 c'' a c a c a c r c a c a c a c
+      r c a c a c a c a c a c a c a c
+    }
+  }
+>>
+@end lilypond
 
-Le plus sûr moyen de régler la taille de la police, quel que soit le
-contexte, consiste à définir la propriété @code{fontSize}.
-Ceci ne modifiera en rien la taille des différents symboles tels que
-ligatures ou liaisons.
+La présence d'un @code{\override} dans cet exemple permet de
+contourner une bogue -- voir « Problèmes connus et avertissements » en
+fin de section.
+
+Dans le cas de fusion d'une tête de note normale avec une autre de
+taille inférieure, la taille de la petite note peut nécessiter une
+réinitialisation -- à l'aide d'un @w{@samp{\once@tie{}\normalsize}} --
+de telle sorte que les hampes et altérations s'alignent correctement :
+
+@c Chopin Prelude op.28 no.8
+@lilypond[verbatim,quote]
+\new Staff <<
+  \key fis \minor
+  \mergeDifferentlyDottedOn
+  \new Voice \relative {
+    \voiceOne
+    \magnifyMusic 0.63 {
+      \override Score.SpacingSpanner.spacing-increment = #(* 1.2 0.63)
+      \once \normalsize cis'32( cis' gis b a fis \once \normalsize d d'
+      \once \normalsize cis, cis' gis b a gis \once \normalsize fis fis'
+      \once \normalsize fis, fis' ais, cis b gis \once \normalsize eis eis'
+      \once \normalsize a, a' bis, d cis b \once \normalsize gis gis')
+    }
+  }
+  \new Voice \relative {
+    \voiceTwo
+    cis'8. d16 cis8. fis16 fis8. eis16 a8. gis16
+  }
+>>
+@end lilypond
 
-@warning{En matière de taille des éléments textuels, référez-vous au
-chapitre @ref{Sélection de la fonte et de la taille}.}
+La commande @code{\magnifyMusic} n'est pas conçue pour gérer les
+citations, notes d'ornement ou portées d'ossia -- des moyens
+spécifiques sont déjà disponibles en la matière.  Elle est par contre
+tout à fait adaptée dans le cas d'un instrument particulier disposant de
+sa propre portée là où des notes d'ornement seraient inappropriées,
+comme pour une pseudo-cadence ou les exemples ci-dessus.  L'attribution
+d'une valeur de 0,63 à @code{\magnifyMusic} duplique les dimensions d'un
+contexte @code{CueVoice}.
+
+@warning{La commande @code{@bs{}magnifyMusic} n'est pas censée
+intervenir en complément d'une modification de la taille de portée --
+voir @ref{Définition de la taille de portée}.}
+
+
+@subsubsubheading Redimmensionnement individuel d'objets de rendu
+@c VO Resizing individual layout objects
+
+L'ajustement de la propriété @code{font-size} à l'aide des commandes
+@code{\tweak} ou @code{\override} permet de retailler un objet de rendu
+particulier :
+
+@lilypond[quote,verbatim,relative=1]
+% resize a note head
+<f \tweak font-size -4 b e>-5
+% resize a fingering
+bes-\tweak font-size 0 -3
+% resize an accidental
+\once \override Accidental.font-size = -4 bes!-^
+% resize an articulation
+\once \override Script.font-size = 4 bes!-^
+@end lilypond
 
 @lilypond[verbatim,quote,relative=2]
 \huge
@@ -92,25 +180,110 @@ c4.-> d8---3
 c4.-> d8---3
 @end lilypond
 
-En interne, la propriété @code{fontSize} d'un contexte aura pour effet
-de définir la propriété @code{font-size} pour tous les objets de
-rendu.  La valeur de @code{font-size} est un entier représentant la
-taille proportionnellement à la hauteur standard de la portée en
-cours.  Chaque incrément correspond à une augmentation d'environ
-12 % de la taille de la police. Un pas de six aboutit exactement
-au doublement de la taille.  La fonction Scheme @code{magstep}
-convertit le nombre affecté à @code{font-size} en facteur d'échelle.
-Vous pouvez aussi définir directement la propriété @code{font-size} de
-manière à n'affecter seulement que certains objets de rendu.
+La valeur par défaut de @code{font-size} est mentionnée, pour chaque
+objet de rendu, dans la référence des propriétés internes.  La propriété
+@code{font-size} ne peut intervenir que pour les objets qui utilisent
+des polices, autrement dit ceux qui disposent de l'interface de rendu
+@code{font-interface}.  L'abence de @code{font-size} dans la liste des
+« réglages par défaut » d'un objet signifie qu'elle est de 0 -- voir
+@rinternals{All layout objects} @emph{(Tous les objets de rendu)}.
+
+
+@subsubsubheading La propriété @code{fontSize}
+@c VO Understanding the @code{fontSize} property
+
+La propriété @code{fontSize} d'un contexte a pour effet de définir la
+taille proportionnelle de tout élément de notation basé sur un
+glyphe dans ce contexte :
+
+@lilypond[verbatim,quote,relative=2]
+\time 3/4
+d4---5 c8( b a g) |
+\set fontSize = -6
+e'4-- c!8-4( b a g) |
+\set fontSize = 0
+fis4---3 e8( d) fis4 |
+g2.
+@end lilypond
+
+La valeur de @code{fontSize} est un nombre indiquant la taille
+relative par rapport à la hauteur standard de la portée en cours.
+La valeur par défaut de @code{fontSize} est de 0.  Un pas de six
+aboutit exactement au doublement de la taille ; un pas de moins
+six la réduit de moitié.  Chaque incrément correspond à une
+augmentation d'environ 12 % de la taille de la police.
+
+La fonction Scheme @code{magnification->font-size} permet de
+s'affranchir de l'échelle logarithmique peu intuitive des unités
+de la propriété @code{font-size}.  Ainsi, l'ajustement à 75 % de
+la notation musicale par rapport à la taille de la portée peut se
+libeller :
+
+@example
+\set fontSize = #(magnification->font-size 0.75)
+@end example
+
+La fonction Scheme @code{magstep} quant à elle effectue
+l'inverse : elle convertit le nombre affecté à @code{font-size} en
+facteur d'échelle.
+
+La propriété @code{fontSize} affecte uniquement les éléments de
+notation reposant sur des glyphes, tels les têtes de note,
+altérations, scripts, etc.  Elle n'aura aucun effet sur la taille
+de la portée, la hauteur des hampes ou la longueur des ligatures
+ni sur l'espacement horizontal.  L'échelonnement des hampes,
+ligature et espacement horizontal, couplé à la taille de la
+notation (sans modification de la taille de la portée), s'obtient
+à l'aide de la commande @code{\magnifyMusic} comme nous venons de
+le voir.  La modification de l'ensemble, y compris la taille de
+portée, est abordé dans @ref{Définition de la taille de portée}.
+
+Dès lors que la @strong{propriété de contexte} @code{fontSize} est
+définie, sa valeur est ajoutée individuellement à la valeur de la
+@strong{propriété de @emph{grob}} @code{font-size} des objets de
+rendu.  Ceci peut être source de confusion lorsque des propriétés
+@code{font-size} individuelles sont réglées alors que
+@code{fontSize} est déjà fixé :
+
+@lilypond[verbatim,quote,relative=2]
+% the default font-size for NoteHead is 0
+% the default font-size for Fingering is -5
+c4-3
+
+\set fontSize = -3
+% the effective font size for NoteHead is now -3
+% the effective font size for Fingering is now -8
+c4-3
+
+\override Fingering.font-size = 0
+% the effective font size for Fingering is now -3
+c4-3
+@end lilypond
+
+LilyPond dispose d'un certain nombre de raccourcis :
+
+@multitable @columnfractions .2 .4 .4
+@item @b{Commande} @tab @b{Équivalent} @tab @b{Taille relative}
+@item @code{\teeny}      @tab @code{\set fontSize = -3} @tab 71 %
+@item @code{\tiny}       @tab @code{\set fontSize = -2} @tab 79 %
+@item @code{\small}      @tab @code{\set fontSize = -1} @tab 89 %
+@item @code{\normalsize} @tab @code{\set fontSize = 0} @tab 100 %
+@item @code{\large}      @tab @code{\set fontSize = 1} @tab 112 %
+@item @code{\huge}       @tab @code{\set fontSize = 2} @tab 126 %
+@end multitable
 
 @lilypond[verbatim,quote,relative=2]
-\set fontSize = #3
+\teeny
+c4.-> d8---3
+\tiny
+c4.-> d8---3
+\small
 c4.-> d8---3
-\override NoteHead.font-size = #-4
+\normalsize
 c4.-> d8---3
-\override Script.font-size = #2
+\large
 c4.-> d8---3
-\override Stem.font-size = #-5
+\huge
 c4.-> d8---3
 @end lilypond
 
@@ -122,15 +295,13 @@ c4.-> d8---3
 
 Pour changer la taille des caractères, LilyPond met à l'échelle la fonte
 dont la taille est la plus proche de la taille voulue.  La taille
-standard (pour laquelle @code{font-size = #0}) dépend de la hauteur
+standard (pour laquelle @code{font-size = 0}) dépend de la hauteur
 de la portée.  À une portée de 20 points correspond une police de
-10 points.
+11 points.
 
-La propriété @code{font-size} ne peut intervenir que pour les objets
-qui utilisent des polices, autrement dit ceux qui disposent de
-l'interface de rendu @code{font-interface}.
 
 @predefined
+@code{\magnifyMusic},
 @code{\teeny},
 @code{\tiny},
 @code{\small},
@@ -140,12 +311,44 @@ l'interface de rendu @code{font-interface}.
 @endpredefined
 
 @seealso
+Manuel de notation :
+@ref{Sélection de la fonte et de la taille},
+@ref{Définition de la taille de portée},
+@ref{Mise en forme d'une citation},
+@ref{Portées d'ossia}.
+
+Fichiers d'initialisation :
+@file{ly/music-functions-init.ly},
+@file{ly/property-init.ly}.
+
 Morceaux choisis :
 @rlsrnamed{Editorial annotations,Annotations éditoriales}.
 
 Référence des propriétés internes :
 @rinternals{font-interface}.
 
+@c The two issues mentioned below:
+@c http://code.google.com/p/lilypond/issues/detail?id=3987
+@c http://code.google.com/p/lilypond/issues/detail?id=3990
+@knownissues
+Deux bogues actuellement répertoriés font obstacle à un espacement
+horizontal correct avec @code{\magnifyMusic}.  La seule façon de les
+contourner n'est cependant pas garantie dans toutes les situations.
+Dans l'exemple suivant, il vous faudra adapter la valeur de la variable
+@var{mag}.  Vous pourriez aussi tenter de supprimer une ou les deux
+commandes @code{\newSpacingSection}, ou les commandes @code{\override}
+et @code{\revert} :
+
+@example
+\magnifyMusic @var{mag} @{
+  \newSpacingSection
+  \override Score.SpacingSpanner.spacing-increment = #(* 1.2 @var{mag})
+  @var{[musique]}
+  \newSpacingSection
+  \revert Score.SpacingSpanner.spacing-increment
+@}
+@end example
+
 
 @node Doigtés
 @unnumberedsubsubsec Doigtés
@@ -169,7 +372,7 @@ textuelle (commande @code{\markup}) de doigté
 (commande @code{\finger}).
 
 @lilypond[verbatim,quote,relative=2]
-c4-1 d-2 f-4 c^\markup { \finger "2 - 3" }
+c4-1 d-2 f\finger \markup \tied-lyric #"4~3" c\finger "2 - 3"
 @end lilypond
 
 @cindex pouce, doigté
@@ -223,10 +426,6 @@ Référence des propriétés internes :
 @rinternals{New_fingering_engraver},
 @rinternals{Fingering}.
 
-@knownissues
-La syntaxe @samp{@var{note}-@var{digit}} ne prend pas en charge, par
-défaut, les chiffres supérieurs à 9.
-
 
 @node Dictée à trous
 @unnumberedsubsubsec Dictée à trous
@@ -404,9 +603,10 @@ internet.  Aussi nous vous recommandons, dans le cadre d'une
 présentation multimédia, d'utiliser des couleurs de base @code{blue},
 @code{green}, @code{red} -- bleu, vert, rouge.
 
-Vous ne pouvez pas coloriser des notes à l'intérieur d'un accord avec
-@code{\override}.  Si besoin est, utilisez @code{\tweak}.  Pour plus de
-détails, consultez @ref{La commande d'affinage (tweak)}.
+Vous ne pouvez pas coloriser individuellement des notes à l'intérieur
+d'un accord avec @code{\override}.  Si besoin est, utilisez
+@code{\tweak} ou @code{\single\override} devant la note en question.
+Pour plus de détails, consultez @ref{La commande d'affinage (tweak)}.
 
 
 @node Parenthèses
@@ -495,6 +695,8 @@ L'orientation des hampes peut être définie manuellement -- voir
 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
 {default-direction-of-stems-on-the-center-line-of-the-staff.ly}
 
+@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
+{automatically-changing-the-stem-direction-of-the-middle-note-based-on-the-melody.ly}
 
 @seealso
 Manuel de notation :
@@ -566,14 +768,13 @@ comme une simple articulation et fonctionne comme @code{\tweak} pour
 attacher du texte à l'une des notes d'un accord.  Les autres arguments
 sont le décalage et le texte de la bulle.
 
-Les info-bulles ont une influence sur les espacements, que l'on peut
-gérer ainsi :
+Les info-bulles n'ont aucune influence sur l'espacement des notes ; on
+peut toutefois le gérer ainsi :
 
 @c KEEP LY
 @lilypond[verbatim,quote,relative=2]
 \new Voice \with { \consists "Balloon_engraver" }
 {
-  \balloonLengthOff
   \balloonGrobText #'Stem #'(3 . 4) \markup { "Je suis une hampe" }
   a8
   \balloonGrobText #'Rest #'(-4 . -4) \markup { "Je suis un silence" }
@@ -637,11 +838,11 @@ spécifie quant à elle l'espace de temps entre chaque ligne.
 
 \score {
   \new ChoirStaff <<
-    \new Staff \relative c'' {
+    \new Staff \relative {
       \stemUp
-      c'4. d8 e8 f g4
+      c'''4. d8 e8 f g4
     }
-    \new Staff \relative {
+    \new Staff \relative {
     %% centre les lignes guides verticalement
       \clef bass
       \stemDown
@@ -694,8 +895,8 @@ structure d'une pièce.
     \consists "Horizontal_bracket_engraver"
   }
 }
-\relative c'' {
-  c2\startGroup
+\relative {
+  c''2\startGroup
   d\stopGroup
 }
 @end lilypond
@@ -709,8 +910,8 @@ Les crochets d'analyses sont susceptibles d'être imbriqués :
     \consists "Horizontal_bracket_engraver"
   }
 }
-\relative c'' {
-  c4\startGroup\startGroup
+\relative {
+  c''4\startGroup\startGroup
   d4\stopGroup
   e4\startGroup
   d4\stopGroup\stopGroup