X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Ffr%2Fuser%2Ftweaks.itely;h=172ccfdbc848dcd921f3167a449f74a9ab45f5a1;hb=5c14a087ca6cbd665fd631452b7b1283ba0387c3;hp=fb9361152b207690191af2ef94071aea460287c7;hpb=fd980d5922018b7abeffa26d4f5f10eee62af91d;p=lilypond.git diff --git a/Documentation/fr/user/tweaks.itely b/Documentation/fr/user/tweaks.itely index fb9361152b..172ccfdbc8 100644 --- 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 +@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 @@ -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 -@ref{The \override command}. +@ruser{The \override command}. @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 -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 @@ -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 -@ref{Dynamics}, nous trouvons +@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 @@ -215,6 +340,13 @@ les plus communs : @end multitable +@node Real music example +@subsection Real music example + +@untranslated + + +@c DEPRECATED SECTION @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 -@ref{Constructing a tweak}. +@ruser{Constructing a tweak}. @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. -@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 @@ -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. -@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 -\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 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}. @@ -536,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