X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Ffr%2Fuser%2Ftweaks.itely;h=4bd2d67920904d133664f43ed2a5ef1c017ccbc9;hb=8cebf6140c89a3141fa4a4864955f28e825e021c;hp=f81d30ff6946e1248dd62adbe96ce4f189eadc1c;hpb=250bd08a77b5cf1ea426e638a8795aab840bfcfc;p=lilypond.git diff --git a/Documentation/fr/user/tweaks.itely b/Documentation/fr/user/tweaks.itely index f81d30ff69..4bd2d67920 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.51" + +@c Translators: Valentin Villenave, Nicolas Klutchnikoff +@c Translation checkers: Jean-Charles Malahieude, John Mandereau + @node Tweaking output @chapter Tweaking output @@ -35,9 +40,10 @@ regrettable mais, le plus souvent, facile à corriger. @c FIXME: find a better example for 5.1 Moving Objects. -gp @c yes, I want this TODO to be visible to end-users. It's better @c than having nothing at all. -TODO: with the new spacing features in 2.12, these specific examples are no -longer relevant. However, they still demonstrate powerful features -of lilypond, so they remain until somebody creates some better examples. +À 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. @lilypond[quote,fragment,ragged-right,verbatim,relative=2] % temporary code to break this example: @@ -65,8 +71,8 @@ e4^\markup{ \italic ritenuto } g b e C'est déjà mieux ! Mais on peut certainement encore améliorer le résultat. Il nous semble, après plusieurs essais, que la meilleure valeur dans ce cas soit 2.3. Toutefois, ce constat est le fruit -d'expérimentation et de goût personnel en matière de notation. -Essayez le même exemple avec 2.3... mais également avec +d'expérimentations et de goût personnel en matière de notation. +Essayez le même exemple avec 2.3... mais également avec des valeurs plus grandes (ou plus petites). À votre avis, quelle est la meilleure version ? @@ -96,12 +102,13 @@ c4^"piu mosso" fis a g @cindex extra-offset -Une autre façon de faire permet de contrôler totalement la position d'un objet -- on -peut le déplacer horizontalement ou verticalement. Ceci peut être effectué à l'aide -de 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. -Ceci signifie en particulier que l'objet déplacé de cette manière 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. @@ -114,8 +121,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] @@ -128,7 +135,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. @@ -138,12 +145,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: @@ -165,27 +173,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 -Avec la section @ref{Moving objects}, nous avons vu comment +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 @@ -196,7 +204,7 @@ Ce qui implique que, pour modifier la hauteur d'une nuance, nous utiliserons \override DynamicLineSpanner #'padding = #2.0 @end example -On ne listera pas ici tous les types d'objets, mais seulement +Nous ne listerons pas ici tous les types d'objets, mais seulement les plus communs : @multitable @columnfractions .33 .66 @@ -216,13 +224,13 @@ les plus communs : @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}. -Toutes ces commandes sont décrites dans les différentes sectionts +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. @@ -233,7 +241,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] @@ -253,21 +261,21 @@ c1 d1 @end lilypond -Notez, dans le second exemple, l'importane de savoir à quel contexte +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 : @@ -283,18 +291,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] << { @@ -305,8 +314,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] @@ -334,14 +343,15 @@ 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 -tandis que la plupart des propriétés relatives aux épaisseurs -sont mesurées à l'aide de l'unité line-thickness. 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, +(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. @@ -349,16 +359,17 @@ consultez les sections correspondantes de la Référence du programme. @section Default files La Référence du programme contient -beaucoup d'informations sur LilyPond. Cependant vous pouvez en trouver -encore plus en regardant les fichiers internes de LilyPond. +beaucoup d'informations sur LilyPond. Cependant vous pouvez en découvrir +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 -configurations 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 @@ -366,8 +377,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}. @@ -375,9 +387,10 @@ 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} -définissent toutes les défintions avancées communes. +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 @@ -387,12 +400,14 @@ 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. +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 @ruser{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 @@ -400,13 +415,10 @@ qui permettent de gagner de la place. @itemize @item - -Vous pouvez demander à LilyPond de placer les systèmes aussi +Demander à LilyPond de placer les systèmes aussi près que possible les uns des autres (pour en disposer autant -que possible dans une page). - -But then to space those systems out so that there is no blank -space at the bottom of the page. +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 @{ @@ -418,8 +430,8 @@ space at the bottom of the page. @end example @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, +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. @example @@ -429,14 +441,13 @@ vous pouvez l'obliger à n'en mettre que dix. @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 +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. +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 dépassent @q{à l'extérieur} d'un système. +Un autre exemple : déplacer les nuances qui @qq{débordent} d'un système. @lilypond[verbatim,quote,fragment] \relative c' { @@ -448,10 +459,8 @@ Un autre exemple : déplacer les nuances qui dépassent @q{à l'extérieur} d'un @end lilypond @item - - -Modifier l'espacement vertical via @code{SpacingSpanner}. Regardez -@ref{Changing horizontal spacing} pour plus de détails. +Modifier l'espacement vertical avec @code{SpacingSpanner}. Reportez-vous à +@ruser{Changing horizontal spacing} pour plus de détails. @lilypond[verbatim,quote] \score { @@ -479,10 +488,10 @@ Modifier l'espacement vertical via @code{SpacingSpanner}. Regardez 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, +@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}. @@ -537,12 +546,11 @@ pattern = #(define-music-function (parser location x y) (ly:music? ly:music?) @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. +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 -