Merge master into nested-bookparts

[lilypond.git] / Documentation / fr / user / tweaks.itely

diff --git a/Documentation/fr/user/tweaks.itely b/Documentation/fr/user/tweaks.itely
index fb9361152b207690191af2ef94071aea460287c7..172ccfdbc848dcd921f3167a449f74a9ab45f5a1 100644 (file)
--- a/Documentation/fr/user/tweaks.itely
+++ b/Documentation/fr/user/tweaks.itely
@@ -7,6 +7,11 @@
     version that you are working on.  See TRANSLATION for details.
 @end ignore
 
     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
 
 @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
 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::               
 * 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
 
 @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
 
 @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 
 
 Aussi surprenant que cela puisse paraître, LilyPond n'est pas parfait.
 Certains éléments sur la partition peuvent se chevaucher, ce qui est 


@@ -146,7 +271,7 @@ 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 
 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}.
+@ruser{The \override command}.

 
 @lilypond[quote,fragment,ragged-right,verbatim,relative=3]
   % temporary code to break this example:
 
 @lilypond[quote,fragment,ragged-right,verbatim,relative=3]
   % temporary code to break this example:


@@ -168,11 +293,11 @@ c4^"piu mosso" d e f
 
 @seealso
 
 
 @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
 
 
 @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
 
 Dans la section @ref{Moving objects}, nous avons vu comment
 déplacer un objet @code{TextScript}.  Ce même procédé peut être


@@ -181,14 +306,14 @@ appliqué à d'autres types d'objet : il vous suffira de remplacer
 
 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
 
 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 
+@ruser{Dynamics}, nous trouvons 

 
 @quotation
 @seealso
 
 
 @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
 Le placement vertical de ces symboles est contrôlé par

-@internalsref{DynamicLineSpanner}.
+@rinternals{DynamicLineSpanner}.

 @end quotation
 
 @noindent
 @end quotation
 
 @noindent


@@ -215,6 +340,13 @@ les plus communs :
 @end multitable
 
 
 @end multitable
 
 

+@node Real music example
+@subsection Real music example
+
+@untranslated
+
+
+@c DEPRECATED SECTION

 @node Common tweaks
 @section Common tweaks
 
 @node Common tweaks
 @section Common tweaks
 


@@ -260,7 +392,7 @@ 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}, ses modifications affectées au
 contexte @code{Voice} ne l'affecteront pas.  Pour plus de détails, voir 
 correspond l'objet.  Dans la mesure où l'objet @code{MetronomeMark}
 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
 
 
 @cindex extra-offset
 


@@ -350,8 +482,29 @@ l'unité staff-space.  Pour de plus amples informations,
 consultez les sections correspondantes de la Référence du programme.
 
 
 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 
 
 La Référence du programme contient
 beaucoup d'informations sur LilyPond. Cependant vous pouvez en découvrir 


@@ -387,106 +540,29 @@ 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.
 
 @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
-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
-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
 @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
 
 @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
 
 @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 le 
 
 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 le 

-@ref{Scheme tutorial}  et les @ref{Interfaces for programmers}.
+@ref{Scheme tutorial}  et les @ruser{Interfaces for programmers}.

 
 On peut utiliser Scheme simplement à l'aide des commandes @code{\override}.
 
 
 On peut utiliser Scheme simplement à l'aide des commandes @code{\override}.
 


@@ -536,16 +612,3 @@ pattern = #(define-music-function (parser location x y) (ly:music? ly:music?)
 }
 @end lilypond
 
 }
 @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