@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
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
@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:
@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.
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]
@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.
\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:
@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
@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.
@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]
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 :
@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]
<< {
@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]
@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
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
@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}.
@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}.
}
@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