X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Ffr%2Fuser%2Ftweaks.itely;h=172ccfdbc848dcd921f3167a449f74a9ab45f5a1;hb=9cff077d13605c93a955ac1a22bc2640a4a60316;hp=210f39f9d055214874d7d1a2393a89bef8ea9d51;hpb=e645f132bff597a97943d9ffd06c2255e2fd1809;p=lilypond.git diff --git a/Documentation/fr/user/tweaks.itely b/Documentation/fr/user/tweaks.itely index 210f39f9d0..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: 65dd8bb120476562eb0104c6969d72d8b105ac8f + 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 @@ -116,7 +241,7 @@ 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 +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. @@ -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,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 +@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 @@ -224,7 +356,7 @@ 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 +(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. @@ -258,9 +390,9 @@ 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 @@ -290,10 +422,10 @@ 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 @@ -338,8 +470,8 @@ 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 @@ -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 -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}. @@ -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