]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/fr/learning/tweaks.itely
Doc: cleanup @file{}, take 2: remove all @/ escaping sequences.
[lilypond.git] / Documentation / fr / learning / tweaks.itely
index fc388267e42c51d23061c80902167bf57d1e1c19..8ee8912d7f384c9b20273569ae18b208ef410669 100644 (file)
@@ -1,13 +1,13 @@
-r@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
+@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 @ignore
-       Translation of GIT committish: 11b44eeed204540f7a4e638f12afe5a9f5466ca8
+       Translation of GIT committish: 6d618ddf527c69dc7c5309f071b115df50566121
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  For details, see the Contributors'
     Guide, node Updating translation committishes..
 @end ignore
 
-@c \version "2.12.0"
+@c \version "2.13.36"
 
 @c Translators: Valentin Villenave, Nicolas Klutchnikoff, Damien Heurtebise
 @c Translation checkers: Jean-Charles Malahieude, John Mandereau
@@ -101,34 +101,35 @@ nuances, etc. Chaque objet dispose de son propre échantillon de valeurs
 pour le réglage des propriétés.
 
 Certains types d'objet portent des noms spécifiques.  Les objets qui se
-rapportent à des éléments de notation sur le fichier de sortie, comme les
-notes, les hampes, les liaisons de phrasé ou de prolongation, les doigtés,
-les clefs, etc. sont appelés @qq{Objets de rendu}@tie{}; ils sont aussi
-connus sous le nom d'@qq{Objets graphiques} (en anglais@tie{}:
-@emph{Graphical objects} ou @emph{Grobs} pour faire court).  Ce sont
-bien des objets au sens générique ci-dessus, et, en tant que tels, ils
-reçoivent des propriétés qui leur sont associées, comme leur position,
-leur taille, leur couleur, etc.
+rapportent à des éléments de notation sur le fichier de sortie, comme
+les notes, les hampes, les liaisons de phrasé ou de prolongation, les
+doigtés, les clefs, etc. sont appelés @qq{Objets de rendu}@tie{}; ils
+sont aussi connus sous le nom d'@qq{Objets graphiques} (en
+anglais@tie{}: @emph{Graphical objects} ou @emph{Grobs} pour faire
+court).  Ce sont bien des objets au sens générique ci-dessus, et, en
+tant que tels, ils reçoivent des propriétés qui leur sont associées,
+comme leur position, leur taille, leur couleur, etc.
 
 Certains objets de rendu, comme les liaisons de phrasé, les soufflets
-de crescendo, les marques d'octaviation et beaucoup d'autres @emph{grobs},
-ont pour particularité de ne pas se situer à un seul et unique endroit
--- ils ont un point de départ, un point d'arrivée, et éventuellement
-d'autres propriétés relatives à leur forme.  Ces objets avec une forme
-étendue sont appelés des bandeaux (@emph{Spanners} en anglais).
-
-Il reste à expliquer ce que sont les @qq{interfaces}.  De nombreux objets,
-qui peuvent être très différents les uns des autres, ont pour point commun
-de devoir être compilés simultanément.  Par exemple, tous les
-@emph{grobs} ont une couleur, une taille, une position, etc., et toutes
-ces propriétés sont compilées simultanément durant l'interprétation du
-fichier d'entrée par LilyPond.  Pour alléger ces opérations internes,
-ces actions et propriétés communes sont regroupées en un objet appelé
-@code{grob-interface}.  Il existe beaucoup d'autres regroupements de
-propriétés communes dans le genre de celui-ci, chacun portant un nom qui
-se termine par @code{interface}.  En tout, on en compte plus d'une
-centaine.  Nous verrons plus loin en quoi c'est intéressant et utile
-pour l'utilisateur.
+de crescendo, les marques d'octaviation et beaucoup d'autres
+@emph{grobs}, ont pour particularité de ne pas se situer à un seul et
+unique endroit -- ils ont un point de départ, un point d'arrivée, et
+éventuellement d'autres propriétés relatives à leur forme.  Ces objets
+avec une forme étendue sont appelés des bandeaux (@emph{Spanners} en
+anglais).
+
+Il reste à expliquer ce que sont les @qq{interfaces}.  De nombreux
+objets, qui peuvent être très différents les uns des autres, ont pour
+point commun de devoir être compilés simultanément.  Par exemple, tous
+les @emph{grobs} ont une couleur, une taille, une position, etc., et
+toutes ces propriétés sont compilées simultanément durant
+l'interprétation du fichier d'entrée par LilyPond.  Pour alléger ces
+opérations internes, ces actions et propriétés communes sont regroupées
+en un objet appelé @code{grob-interface}.  Il existe beaucoup d'autres
+regroupements de propriétés communes dans le genre de celui-ci, chacun
+portant un nom qui se termine par @code{interface}.  En tout, on en
+compte plus d'une centaine.  Nous verrons plus loin en quoi c'est
+intéressant et utile pour l'utilisateur.
 
 Ainsi s'achève le tour des principaux termes relatifs aux objets et
 que nous serons amenés à utiliser dans ce chapitre.
@@ -323,7 +324,7 @@ g4 a b c |
 Il existe une autre forme de commande @code{\override},
 @code{\overrideProperty}, qui est parfois utile.  Nous la mentionnons
 ici par souci d'exhaustivité@tie{}; pour le détail, voir
-@ruser{Retouches complexes}.
+@rextendnamed{Difficult tweaks,Retouches complexes}.
 
 @c Maybe explain in a later iteration  -td
 
@@ -1057,7 +1058,7 @@ L'objet @code{BarLine} est également lié à plusieurs interfaces, dont la
 @code{grob-interface} où figurent les propriétés @code{transparent} et
 @code{color}.  Toutes peuvent modifier l'aspect visuel des barres de
 mesure -- et de beaucoup d'autres objets, bien sûr.  Examinons chacune
-d'elles tour à tour. 
+d'elles tour à tour.
 
 @subheading stencil
 
@@ -2090,7 +2091,7 @@ passage musical.  L'extension s'étend depuis la commande
 @code{\startTextSpan} jusqu'à la commande @code{\stopTextSpan} et le
 format de texte est défini par la commande @code{\override TextSpanner}.
 Pour de plus amples détails, voir
-@ruser{Indications textuelles et lignes d’extension}.
+@ruser{Indication textuelle avec ligne d’extension}.
 
 Il montre aussi comment créer des marques d'octaviation.
 
@@ -2432,9 +2433,9 @@ changée grâce aux commandes prédéfinies dont la liste a été donnée
 plus haut à propos des objets de portée (voir
 @ref{Objets inclus dans la portée}).
 Les queues de note, les liaisons de phrasé et de prolongation, les
-crochets, les nuances et les nolets peuvent facilement être repositionnés
-de cette manière.  En contrepartie, vous n'avez le choix qu'entre deux
-positions, sans personnalisation possible.
+crochets, les nuances et les nolets peuvent facilement être
+repositionnés de cette manière.  En contrepartie, vous n'avez le choix
+qu'entre deux positions, sans personnalisation possible.
 
 @item
 Les @strong{propriétés d'objet}, auxquelles LilyPond a recours pour
@@ -2487,7 +2488,7 @@ proche (généralement une note ou une ligne de portée)@tie{};
 @code{staff-padding} ne s'applique qu'aux objets qui sont toujours
 placés en-dehors de la portée -- il contrôle l'espace minimum à insérer
 entre l'objet et la portée.  Attention@tie{}: par défaut,
-@code{staff-padding} concerne les objets positionnés par rapport 
+@code{staff-padding} concerne les objets positionnés par rapport
 à la portée et n'a aucun effet sur les objets qui sont positionnés par
 rapport à une note@tie{}; il est toutefois possible de le régler pour
 fonctionner avec ces derniers.
@@ -3679,6 +3680,11 @@ contrairement à la seconde (avec le stencil désactivé) qui la laisse à
 sa place.
 
 
+@seealso
+Glossaire musicologique :
+@rglosnamed{system,système}.
+
+
 @node Utilisation de variables dans les retouches
 @subsection Utilisation de variables dans les retouches
 @translationof Using variables for tweaks
@@ -3851,7 +3857,7 @@ début de notre fichier de musique.  Lui attribuer l'extension
 voué à être inclus dans un fichier maître@tie{}; il n'est pas destiné à
 être compilé isolément.@*
 Maintenant, modifions notre musique (enregistrez ce fichier
-sous @code{musique.ly}).
+sous @file{musique.ly}).
 
 @c  We have to do this awkward example/lilypond-non-verbatim
 @c  because we can't do the \include stuff in the manual.
@@ -4138,8 +4144,8 @@ encore vous l'avez compilé directement à partir des sources@tie{}; et
 @item MacOS X
 
 @code{@var{INSTALLDIR}/LilyPond.app/Contents/Resources/share/lilypond/current/}
-Pour accéder à ce dossier, deux possibilités@tie{}: soit, dans un Terminal,
-taper @code{cd} suivi du chemin complet ci-dessus@tie{}; soit
+Pour accéder à ce dossier, deux possibilités@tie{}: soit, dans un
+Terminal, taper @code{cd} suivi du chemin complet ci-dessus@tie{}; soit
 Control-cliquer (ou clic droit) sur l'application LilyPond
 et sélectionner @qq{Afficher le contenu du paquet}.
 
@@ -4168,9 +4174,9 @@ intéressants@tie{}:
 @item @code{scm/} -- contient les fichiers en format Scheme
 @end itemize
 
-Commençons par examiner quelques fichiers contenus dans @code{ly/}.
-Nous ouvrons @code{ly/property-init.ly} dans un éditeur de texte --
-celui que vous avez l'habitude d'utiliser pour les fichiers @code{.ly}
+Commençons par examiner quelques fichiers contenus dans @file{ly/}.
+Nous ouvrons @file{ly/property-init.ly} dans un éditeur de texte --
+celui que vous avez l'habitude d'utiliser pour les fichiers @file{.ly}
 fera très bien l'affaire.  Ce fichier contient les définitions de toutes
 les commandes standard prédéfinies de LilyPond, comme @code{\stemUp} et
 @code{\slurDotted}.  Vous pouvez constater que ce n'est rien d'autre
@@ -4189,25 +4195,25 @@ Si vous n'aimez pas les valeurs par défaut, les commandes prédéfinies
 peuvent être facilement redéfinies, comme n'importe quelle autre
 variable, en tête de votre fichier d'entrée.
 
-Voici les fichiers les plus utiles dans le répertoire @code{ly/}@tie{}:
+Voici les fichiers les plus utiles dans le répertoire @file{ly/}@tie{}:
 
 @multitable @columnfractions .4 .6
 @headitem Nom de fichier
   @tab Contenu
-@item @code{ly/engraver-init.ly}
+@item @file{ly/engraver-init.ly}
   @tab Définitions des Contextes de graveurs
-@item @code{ly/paper-defaults-init.ly}
+@item @file{ly/paper-defaults-init.ly}
   @tab Réglages papier par défaut
-@item @code{ly/performer-init.ly}
+@item @file{ly/performer-init.ly}
   @tab Définitions des Contextes d'interprétation
-@item @code{ly/property-init.ly}
+@item @file{ly/property-init.ly}
   @tab Définitions de toutes les commandes prédéfinies courantes
-@item @code{ly/spanner-init.ly}
+@item @file{ly/spanner-init.ly}
   @tab Définitions des commandes prédéfinies pour les bandeaux
 @end multitable
 
 Les autres réglages (comme les définitions de commandes @emph{markup})
-sont conservés comme fichiers @code{.scm} (Scheme).  Le langage de
+sont conservés comme fichiers @file{.scm} (Scheme).  Le langage de
 programmation Scheme offre une interface programmable dans le
 processus interne de LilyPond.  De plus amples explications sur ces
 fichiers dépasseraient le cadre de ce manuel dans la mesure où elles
@@ -4223,20 +4229,20 @@ sont@tie{}:
 @multitable @columnfractions .4 .6
 @headitem Nom de fichier
   @tab Contenu
-@item @code{scm/auto-beam.scm}
+@item @file{scm/auto-beam.scm}
   @tab Régles par défaut des ligatures subalternes
-@item @code{scm/define-grobs.scm}
+@item @file{scm/define-grobs.scm}
   @tab Réglages par défaut des propriétés de @emph{grobs}
-@item @code{scm/define-markup-commands.scm}
+@item @file{scm/define-markup-commands.scm}
   @tab Spécification de toutes les commandes de @emph{markup}
-@item @code{scm/midi.scm}
+@item @file{scm/midi.scm}
   @tab Réglages par défaut pour les sorties MIDI
-@item @code{scm/output-lib.scm}
+@item @file{scm/output-lib.scm}
   @tab Réglages affectant l'apparence des frets, couleurs, altérations,
        barres de mesure, etc.
-@item @code{scm/parser-clef.scm}
+@item @file{scm/parser-clef.scm}
        @tab Définition des clefs prises en charge
-@item @code{scm/script.scm}
+@item @file{scm/script.scm}
        @tab Réglages par défaut des articulations
 @end multitable
 
@@ -4255,17 +4261,21 @@ suffisamment pour faire tenir le texte entre les marges.
 
 Pour pouvoir fonctionner en toutes circonstances, ces vérifications
 doivent être activées@tie{}; il faut pour cela placer les retouches dans
-un bloc @code{Score@tie{}\with}, plutôt qu'à l'intérieur du fragment
-musical, comme ceci@tie{}:
+un @code{\context} à l'intérieur d'un bloc @code{\layout}, plutôt que
+directement dans le fragment musical, comme ceci@tie{}:
 
 @example
-\new Score \with @{
-  % Pour s'assurer que les indications textuelles et paroles
-  % seront à l'intérieur des marges de la page.
-  \override PaperColumn #'keep-inside-line = ##t
-  \override NonMusicalPaperColumn #'keep-inside-line = ##t
-@} @{
-   ..
+\score @{
+  @{ @dots{}notes@dots{} @}
+  \layout @{
+    \context @{
+      \Score
+      % Pour s'assurer que les indications textuelles et paroles
+      % seront à l'intérieur des marges de la page.
+      \override PaperColumn #'keep-inside-line = ##t
+      \override NonMusicalPaperColumn #'keep-inside-line = ##t
+    @}
+  @}
 @}
 @end example