X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Ffr%2Fuser%2Ftweaks.itely;h=172ccfdbc848dcd921f3167a449f74a9ab45f5a1;hb=1aea74028c07ffd9d3681ff6b3046d17fb5dddbd;hp=904ce0ca0864b2b3d3a9f5e0a67cca5c96a60949;hpb=be8e0ed9c4d9bf06fb150e1f0d3cfe1518dfc3a7;p=lilypond.git

diff --git a/Documentation/fr/user/tweaks.itely b/Documentation/fr/user/tweaks.itely
index 904ce0ca08..172ccfdbc8 100644
--- a/Documentation/fr/user/tweaks.itely
+++ b/Documentation/fr/user/tweaks.itely
@@ -1,12 +1,17 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 @c This file is part of lilypond.tely
 @ignore
-    Translation of GIT committish: c7d952c4fd5fbb5b9e32e7a2bf50ceec20098160
+    Translation of GIT committish: 964d024dd4f022ba7cd66adc13c0169035d4c4e5
 
     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.61"
+
+@c Translators: Valentin Villenave, Nicolas Klutchnikoff
+@c Translation checkers: Jean-Charles Malahieude, John Mandereau
+
 @node Tweaking output
 @chapter Tweaking output
 
@@ -15,18 +20,138 @@ LilyPond offre de nombreuses possibilités de réglages, permettant de modifier
 quasiment chaque élément de votre partition.
 
 @menu
-* Moving objects::              
-* Fixing overlapping notation::  
+* Tweaking basics::             
+* The Internals Reference manual::  
+* Appearance of objects::       
+* Placement of objects::        
+* Collisions of objects::       
 * Common tweaks::               
-* Default files::               
-* Fitting music onto fewer pages::  
-* Advanced tweaks with Scheme::  
-* Avoiding tweaks with slower processing::  
+* Further tweaking::            
+@end menu
+
+@node Tweaking basics
+@section Tweaking basics
+
+@untranslated
+
+@menu
+* Introduction to tweaks::      
+* Objects and interfaces::      
+* Naming conventions of objects and properties::  
+* Tweaking methods::            
+@end menu
+
+@node Introduction to tweaks
+@subsection Introduction to tweaks
+
+@untranslated
+
+@node Objects and interfaces
+@subsection Objects and interfaces
+
+@untranslated
+
+@node Naming conventions of objects and properties
+@subsection Naming conventions of objects and properties
+
+@untranslated
+
+@node Tweaking methods
+@subsection Tweaking methods
+
+@untranslated
+
+@node The Internals Reference manual
+@section The Internals Reference manual
+
+@untranslated
+
+@menu
+* Properties of layout objects::  
+* Properties found in interfaces::  
+* Types of properties::         
+@end menu
+
+@node Properties of layout objects
+@subsection Properties of layout objects
+
+@untranslated
+
+@node Properties found in interfaces
+@subsection Properties found in interfaces
+
+@untranslated
+
+@node Types of properties
+@subsection Types of properties
+
+@untranslated
+
+@node Appearance of objects
+@section Appearance of objects
+
+@untranslated
+
+@menu
+* Visibility and color of objects::  
+* Size of objects::             
+* Length and thickness of objects::  
 @end menu
 
+@node Visibility and color of objects
+@subsection Visibility and color of objects
+
+@untranslated
+
+@node Size of objects
+@subsection Size of objects
+
+@untranslated
+
+@node Length and thickness of objects
+@subsection Length and thickness of objects
+
+@untranslated
+
+@node Placement of objects
+@section Placement of objects
+
+@untranslated
+
+@menu
+* Automatic behavior::          
+* Within-staff objects::        
+* Outside staff objects::       
+@end menu
+
+@node Automatic behavior
+@subsection Automatic behavior
+
+@untranslated
+
+@node Within-staff objects
+@subsection Within-staff objects
+
+@untranslated
+
+@node Outside staff objects
+@subsection Outside staff objects
+
+@untranslated
+
+
+@node Collisions of objects
+@section Collisions of objects
+
+
+@menu
+* Moving objects::              
+* Fixing overlapping notation::  
+* Real music example::          
+@end menu
 
 @node Moving objects
-@section Moving objects
+@subsection Moving objects
 
 Aussi surprenant que cela puisse paraître, LilyPond n'est pas parfait.
 Certains éléments sur la partition peuvent se chevaucher, ce qui est 
@@ -37,8 +162,8 @@ regrettable mais, le plus souvent, facile à corriger.
 @c  than having nothing at all.
 À FAIRE : les modifications de la gestion des espacements de la version 2.12
 feront perdre leur pertinence aux exemples suivants.  Ils démontrent cependant 
-la puissance de LilyPond, et justifient à ce titre leur présence dans ces lignes,
-tant que d'autres exemples n'auront pas été proposés.
+la puissance de LilyPond, et justifient à ce titre leur présence dans
+ces lignes, tant que d'autres exemples n'auront pas été proposés.
 
 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
   % temporary code to break this example:
@@ -97,10 +222,13 @@ c4^"piu mosso" fis a g
 
 @cindex extra-offset
 
-Une autre démarche permet de contrôler totalement la position d'un objet -- on
-peut le déplacer horizontalement ou verticalement.  Il suffit d'avoir recours à 
-la propriété @code{extra-offset}. En fait c'est une méthode plus complexe, qui peut
-en outre poser des problèmes.  Quand on déplace un objet à l'aide de @code{extra-offset}, le déplacement est effectué après que LilyPond a placé tous les autres objets.  Par conséquent, l'objet ainsi déplacé peut venir
+Une autre démarche permet de contrôler totalement la position d'un
+objet --- on peut le déplacer horizontalement ou verticalement.  Il
+suffit d'avoir recours à la propriété @code{extra-offset}.  En fait
+c'est une méthode plus complexe, qui peut en outre poser des
+problèmes.  Quand on déplace un objet à l'aide de @code{extra-offset},
+le déplacement est effectué après que LilyPond a placé tous les autres
+objets.  Par conséquent, l'objet ainsi déplacé peut venir
 recouvrir d'autres objets déjà placés.
 
 
@@ -113,8 +241,8 @@ e4^\markup{ \italic ritenuto } g b e
 
 Lorsqu'on utilise @code{extra-offset}, le premier nombre décrit le
 déplacement horizontal (négatif pour un déplacement vers la gauche) 
-tandis que le deuxième décrit un déplacement vertical (négatif 
-pour le haut). Après quelques essais, on peut choisir les valeurs suivantes
+tandis que le deuxième décrit un déplacement vertical (positif 
+pour le haut).  Après quelques essais, on peut choisir les valeurs suivantes
 qui semblent donner un résultat satisfaisant.
 
 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
@@ -127,7 +255,7 @@ e4^\markup{ \italic ritenuto } g b e
 @noindent
 
 Une fois encore, c'est après quelques tâtonnements que l'on a abouti à
-ces nombres, au regard du résultat final. Si vous souhaitez que 
+ces nombres, au regard du résultat final.  Si vous souhaitez que 
 le texte soit plus haut, plus à gauche, etc. essayez vous-même et choisissez
 aprés avoir regardé le résultat.
 
@@ -137,12 +265,13 @@ Une dernière mise en garde : dans cette section, nous avons eu recours à
 \once \override TextScript @dots{}
 @end example
 
-ce qui permet de régler le placement du texte pour la note suivante.
+ce qui permet de régler le placement du texte pour la note suivante. 
 Mais si cette note n'a pas de texte, le réglage ne s'appliquera pas
-et n'attendra @strong{pas} le prochain texte. Pour que ce comportement 
+et n'attendra @strong{pas} le prochain texte.  Pour que ce comportement 
 persiste après la commande, ne mettez pas @code{\once}.  Votre réglage
 s'appliquera alors partout, jusqu'à ce que vous l'annuliez au moyen de
-la commande @code{\revert}.  Ceci est expliqué en détail dans @ref{The \override command}.
+la commande @code{\revert}.  Ceci est expliqué en détail dans 
+@ruser{The \override command}.
 
 @lilypond[quote,fragment,ragged-right,verbatim,relative=3]
   % temporary code to break this example:
@@ -164,27 +293,27 @@ c4^"piu mosso" d e f
 
 @seealso
 
-Dans ce même manuel : @ref{The \override command}, @ref{Common tweaks}.
+Dans ce même manuel : @ruser{The \override command}, @ref{Common tweaks}.
 
 
 @node Fixing overlapping notation
-@section Fixing overlapping notation
+@subsection Fixing overlapping notation
 
 Dans la section @ref{Moving objects}, nous avons vu comment
 déplacer un objet @code{TextScript}.  Ce même procédé peut être
-appliqué à d'autres types d'objets : il vous suffira de remplacer
+appliqué à d'autres types d'objet : il vous suffira de remplacer
 @code{TextScript} par le nom de l'objet en question.
 
 Pour trouver cette dénomination, regardez les liens @q{@strong{Voir aussi}}
-en bas des pages de la documentation. Par exemple, en bas de la page @ref{Dynamics},
-nous trouvons 
+en bas des pages de la documentation.  Par exemple, en bas de la page
+@ruser{Dynamics}, nous trouvons 
 
 @quotation
 @seealso
 
-Référence du programme : @internalsref{DynamicText}, @internalsref{Hairpin}.
+Référence du programme : @rinternals{DynamicText}, @rinternals{Hairpin}.
 Le placement vertical de ces symboles est contrôlé par
-@internalsref{DynamicLineSpanner}.
+@rinternals{DynamicLineSpanner}.
 @end quotation
 
 @noindent
@@ -211,17 +340,24 @@ les plus communs :
 @end multitable
 
 
+@node Real music example
+@subsection Real music example
+
+@untranslated
+
+
+@c DEPRECATED SECTION
 @node Common tweaks
 @section Common tweaks
 
 Certains réglages sont si courants que des raccourcis sont fournis
-sous forme de commandes telles que @code{\slurUp} et @code{\stemDown}.  
+sous forme de commandes telles que @code{\slurUp} ou @code{\stemDown}.  
 Toutes ces commandes sont décrites dans les différentes sections
 de la Référence de notation.
 
 La liste complète des modifications possibles pour chaque type d'objet
-(tels que les liaisons ou les ligatures) se trouve dans la Référence du
-programme. Cependant, certaines propriétés sont communes à de nombreux
+(tel que liaison ou ligature) se trouve dans la Référence du
+programme.  Cependant, certaines propriétés sont communes à de nombreux
 objets, et on peut de ce fait définir quelques réglages génériques.
 
 
@@ -232,7 +368,7 @@ objets, et on peut de ce fait définir quelques réglages génériques.
 @item
 La propriété @code{padding} peut être définie de manière à
 accroître (ou décroître) la distance entre les symboles qui se
-placent au-dessus ou au-dessous des notes. Ce qui s'applique à
+placent au-dessus ou au-dessous des notes.  Ce qui s'applique à
 tous les objets régis par @code{side-position-interface}.
 
 @lilypond[quote,fragment,relative=1,verbatim]
@@ -254,19 +390,19 @@ d1
 
 Notez, dans le second exemple, l'importance de savoir à quel contexte
 correspond l'objet.  Dans la mesure où l'objet @code{MetronomeMark}
-appartient au contexte @code{Score}, les modifications affectant le
+appartient au contexte @code{Score}, ses modifications affectées au
 contexte @code{Voice} ne l'affecteront pas.  Pour plus de détails, voir 
-@ref{Constructing a tweak}.
+@ruser{Constructing a tweak}.
 
 @cindex extra-offset
 
 @item
 La propriété @code{extra-offset} permet de déplacer latéralement et
-verticalement ; c'est pourquoi elle requiert deux nombres. Le premier
-affecte le placement horizontal (un nombre positif déplace l'objet vers la droite) ;
-le second le placement vertical (un nombre positif déplace l'objet vers le
-haut).  Cette propriété est de bas niveau : le moteur de formatage ne tient
-aucun compte des placements qu'elle induit.
+verticalement ; c'est pourquoi elle requiert deux nombres.  Le premier
+affecte le placement horizontal (un nombre positif déplace l'objet
+vers la droite) ; le second le placement vertical (un nombre positif
+déplace l'objet vers le haut).  Cette propriété est de bas niveau : le
+moteur de formatage ne tient aucun compte des placements qu'elle induit.
 
 Dans l'exemple suivant, le second doigté est déplacé un peu vers la gauche, et
 plus bas de 1.8 espaces :
@@ -282,18 +418,19 @@ f-5
 @item
 La propriété @code{transparent} imprime les objets avec de 
 l'@q{encre invisible} : l'objet n'est pas visible, mais tous
-les comportement lui afférant s'appliquent quand même.  Il occupe
+les comportement le concernant s'appliquent quand même.  Il occupe
 une certaine place, intervient dans la gestion des collisions, et on
 peut lui attacher des liaisons ou des ligatures.
 
-@cindex transparent objects
-@cindex removing objects
-@cindex hiding objects
-@cindex invisible objects
+@cindex transparents, objets
+@cindex suppression d'objets
+@cindex masquage d'objets
+@cindex invisibles, objets
 
 L'exemple suivant montre comment tenir des notes entre différentes voix,
 au moyen de liaisons.  Ces liaisons de tenue, en principe, ne peuvent relier
-que deux notes d'une même voix.  On introduit donc la liaison dans une autre voix :
+que deux notes d'une même voix.  On introduit donc la liaison dans une
+autre voix :
 
 @lilypond[quote,fragment,relative=2]
 << {
@@ -304,8 +441,8 @@ que deux notes d'une même voix.  On introduit donc la liaison dans une autre vo
 @end lilypond
 
 @noindent
-et on efface la première croche (hampe vers le haut) de ladite voix ; maintenant
-la liaison semble passer d'une voix à l'autre :
+et on efface la première croche (hampe vers le haut) de ladite voix ; 
+maintenant la liaison semble passer d'une voix à l'autre :
 
 
 @lilypond[quote,fragment,relative=2,verbatim]
@@ -333,19 +470,41 @@ en attribuant à la propriété @code{length} la valeur @code{8} :
 
 @end itemize
 
-@cindex Tweaks, distances
-@cindex Distances
+@cindex retouches, distances
+@cindex distances
 
-Les distances dans LilyPond sont mesurées dans l'unité staff-space (espace de portée)
-tandis que la plupart des propriétés relatives aux épaisseurs
-sont mesurées à l'aide de l'unité line-thickness (épaiseur de ligne). Toutefois, certaines d'entre-elles
-échappent à cette règle : par exemple l'épaisseur des liens de croches
-est mesurée à l'aide de l'unité staff-space.  Pour de plus amples informations, 
+Les distances dans LilyPond sont mesurées dans l'unité staff-space
+(espace de portée) tandis que la plupart des propriétés relatives aux
+épaisseurs sont mesurées à l'aide de l'unité line-thickness (épaiseur
+de ligne). Toutefois, certaines d'entre-elles échappent à cette règle
+: par exemple l'épaisseur des liens de croches est mesurée à l'aide de
+l'unité staff-space.  Pour de plus amples informations, 
 consultez les sections correspondantes de la Référence du programme.
 
 
-@node Default files
-@section Default files
+@node Further tweaking
+@section Further tweaking
+
+@menu
+* Other uses for tweaks::       
+* Using variables for tweaks::  
+* Other sources of information::  
+* Avoiding tweaks with slower processing::  
+* Advanced tweaks with Scheme::  
+@end menu
+
+@node Other uses for tweaks
+@subsection Other uses for tweaks
+
+@untranslated
+
+@node Using variables for tweaks
+@subsection Using variables for tweaks
+
+@untranslated
+
+@node Other sources of information
+@subsection Other sources of information
 
 La Référence du programme contient
 beaucoup d'informations sur LilyPond. Cependant vous pouvez en découvrir 
@@ -353,10 +512,12 @@ encore plus en consultant les fichiers internes de LilyPond.
 
 Des réglages par défaut (tels que les définitions des blocs
 @code{\header@{@}}) sont contenus dans des fichiers @code{.ly}. D'autres 
-(comme les définitions des commandes @qq{markup} ) sont contenus dans des fichiers @code{.scm} (Scheme).  Malheureusement, des explications plus complètes dépassent le cadre de ce manuel.
-Les utilisateurs qui souhaiteraient comprendre le fonctionnement de ces fichiers de 
-configuration doivent être avertis que des connaissances techniques substantielles et
-beaucoup de temps sont nécessaires.
+(comme les définitions des commandes @qq{markup} ) sont contenus dans
+des fichiers @code{.scm} (Scheme).  Malheureusement, des explications
+plus complètes dépassent le cadre de ce manuel.
+Les utilisateurs qui souhaiteraient comprendre le fonctionnement de
+ces fichiers de configuration doivent être avertis que des
+connaissances techniques substantielles et beaucoup de temps sont nécessaires.
 
 @itemize @bullet
 
@@ -364,8 +525,9 @@ beaucoup de temps sont nécessaires.
 
 @item Mac OS X :
 @file{@var{dossierduprogramme}/LilyPond.app/Contents/Resources/share/lilypond/current/}.
-Pour accéder à ce dossier, deux possibilités : soit, dans un Terminal, taper @code{cd} suivi du
-chemin complet ci-dessus ; soit Control-cliquer  (ou clic droit) sur l'application LilyPond
+Pour accéder à ce dossier, deux possibilités : soit, dans un Terminal,
+taper @code{cd} suivi du chemin complet ci-dessus ; soit
+Control-cliquer (ou clic droit) sur l'application LilyPond
 et sélectionner @q{Afficher le contenu du paquet}.
 
 
@@ -373,108 +535,34 @@ et sélectionner @q{Afficher le contenu du paquet}.
 
 @end itemize
 
-Les répertoires @file{ly/} et @file{scm/} sont tout particulièrement intéressants.
-En effet les fichiers du type @file{ly/property-init.ly} ou encore @file{ly/declarations-init.ly}
+Les répertoires @file{ly/} et @file{scm/} sont tout particulièrement
+intéressants.  En effet les fichiers du type
+@file{ly/property-init.ly} ou encore @file{ly/declarations-init.ly}
 déterminent toutes les définitions avancées communes.
 
-@node Fitting music onto fewer pages
-@section Fitting music onto fewer pages
-
-Parfois, une partition peut se terminer avec seulement 
-un ou deux systèmes sur la dernière page. Ceci peut être ennuyeux
-surtout si vous constatez, en regardant les pages précédentes, qu'il
-reste encore beaucoup de place sur celles-ci.
-
-Si vous vous intéressez aux problèmes de mise en page, @code{annotate-spacing}, 
-peut alors être un outil d'une valeur inestimable. Cette commande imprime les valeurs 
-de nombreuses commandes d'espacement concernant la mise en page.
-Consultez @ref{Displaying spacing} pour de plus amples informations. À l'aide 
-des informations données par @code{annotate-spacing} on peut 
-voir quelles marges il est souhaitable de modifier afin de résoudre le problème.
-
-
-En plus d'agir sur les marges, il existe d'autres possibilités
-qui permettent de gagner de la place.
-
-@itemize
-@item
-Vous pouvez demander à LilyPond de placer les systèmes aussi 
-près que possible les uns des autres (pour en disposer autant
-que possible sur une page), tout en répartissant les systèmes afin
-de ne pas laisser de blanc en bas de la dernière page.
-
-@example
-\paper @{
-  between-system-padding = #0.1
-  between-system-space = #0.1
-  ragged-last-bottom = ##f
-  ragged-bottom = ##f
-@}
-@end example
+@node Avoiding tweaks with slower processing
+@subsection Avoiding tweaks with slower processing
 
-@item
-Vous pouvez obliger LilyPond à mettre un certain nombre de systèmes
-par page. Par exemple, si LilyPond veut placer onze systèmes dans une page,
-vous pouvez l'obliger à n'en mettre que dix.
+LilyPond peut effectuer des vérifications supplémentaires lors du 
+traitement des fichiers, cependant le rendu nécessitera alors plus de
+temps.  En contrepartie, il y aura moins d'ajustements manuels à réaliser.
 
+  
 @example
-\paper @{
-  system-count = #10
-@}
+%%  Ceci sert à s'assurer que les indications textuelles resteront à l'intérieur des marges de la page.
+\override Score.PaperColumn #'keep-inside-line = ##t 
 @end example
 
-@item
-Supprimer (ou réduire) les objets qui augmentent la hauteur du système.
-C'est le cas en particulier de certaines reprises (avec des 
-alternatives) qui placent des crochets au dessus des portées. Si ces crochets 
-de reprise se poursuivent sur deux systèmes, ils prendront plus de place que s'ils
-sont regroupés sur un même système.
-
-Un autre exemple : déplacer les nuances qui @qq{débordent} d'un système.
-
-@lilypond[verbatim,quote,fragment]
-\relative c' {
-  e4 c g\f c
-  \override DynamicLineSpanner #'padding = #-1.8
-  \override DynamicText #'extra-offset = #'( -2.1 . 0)
-  e4 c g\f c
-}
-@end lilypond
-
-@item
-Modifier l'espacement vertical avec @code{SpacingSpanner}.  Reportez-vous à
-@ref{Changing horizontal spacing} pour plus de détails.
-
-@lilypond[verbatim,quote]
-\score {
-  \relative c'' {
-    g4 e e2 | f4 d d2 | c4 d e f | g4 g g2 |
-    g4 e e2 | f4 d d2 | c4 e g g | c,1 |
-    d4 d d d | d4 e f2 | e4 e e e | e4 f g2 |
-    g4 e e2 | f4 d d2 | c4 e g g | c,1 |
-  }
-  \layout {
-    \context {
-      \Score
-      \override SpacingSpanner
-                #'base-shortest-duration = #(ly:make-moment 1 4)
-    }
-  }
-}
-@end lilypond
-
-@end itemize
-
 
 @node Advanced tweaks with Scheme
-@section Advanced tweaks with Scheme
+@subsection Advanced tweaks with Scheme
 
 Nous avons déjà vu comment le résultat obtenu avec LilyPond peut être
 largement personnalisé à l'aide de commandes comme 
 @code{\override TextScript #'extra-offset = ( 1 . -1)}.  Cependant,
 l'utilisation de Scheme ouvre des possibilités encore plus grandes.
-Pour des explications complètes là-dessus, consultez @ref{Scheme tutorial} et
-@ref{Interfaces for programmers}.
+Pour des explications complètes là-dessus, consultez le 
+@ref{Scheme tutorial}  et les @ruser{Interfaces for programmers}.
 
 On peut utiliser Scheme simplement à l'aide des commandes @code{\override}.
 
@@ -524,16 +612,3 @@ pattern = #(define-music-function (parser location x y) (ly:music? ly:music?)
 }
 @end lilypond
 
-
-@node Avoiding tweaks with slower processing
-@section Avoiding tweaks with slower processing
-
-LilyPond peut effectuer des vérifications supplémentaires lors du 
-traitement des fichiers, cependant le rendu nécessitera alors plus de temps.
-En contrepartie, il y aura moins d'ajustements manuels à réaliser.
-
-  
-@example
-%%  Ceci sert à s'assurer que les indications textuelles resteront à l'intérieur des marges de la page.
-\override Score.PaperColumn #'keep-inside-line = ##t 
-@end example