@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
@ignore
- Translation of GIT committish: 4f7427e7a314a71bde16559247885544256b8213
+ 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
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.
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
@code{italic}. À ne pas confondre avec les chaînes de caractères
libres, qui se présentent comme @code{"un texte libre"}@tie{}; pour plus
de détails sur les symboles et les chaînes de caractères, voir le
-@rextend{Scheme tutorial}.
+@rextendnamed{Scheme tutorial,Tutoriel Scheme}.
Ainsi, la commande @code{\override} pour mettre les paroles en italique
est@tie{}:
@seealso
Manuel d'extension :
-@rextend{Scheme tutorial}.
+@rextendnamed{Scheme tutorial,Tutoriel Scheme}.
@node Types de propriétés
@seealso
Manuel d'extension :
-@rextend{Scheme tutorial}.
+@rextendnamed{Scheme tutorial,Tutoriel Scheme}.
@node Apparence des objets
@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
horizontal s'en trouverait affecté. Il en sera question plus bas dans
cette section.
-Voilà qui complète la création d'une ossia. Les tailles et longueurs de tous
-les objets peuvent être modifiées de manière analogue.
+Voilà qui complète la création d'une ossia. Les taille et longueur de
+tous les objets peuvent être modifiées de manière analogue.
Pour de petits changements d'échelle, comme dans l'exemple ci-dessus, il
n'est généralement pas utile d'ajuster l'épaisseur des différentes
@item @code{\phrasingSlurDown}
@tab @code{\phrasingSlurUp}
@tab @code{\phrasingSlurNeutral}
- @tab Attention : à distinguer des commandes de liaison ci-dessous
+ @tab Attention@tie{}: à distinguer des commandes de liaison ci-dessous
@item @code{\slurDown}
@tab @code{\slurUp}
@tab @code{\slurNeutral}
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{Extensions de texte}.
+Pour de plus amples détails, voir
+@ruser{Indication textuelle avec ligne d’extension}.
Il montre aussi comment créer des marques d'octaviation.
@end example
@noindent
-Voyons si ça marche sur notre exemple précédent :
+Voyons si ça marche sur notre exemple précédent@tie{}:
@cindex DynamicText, exemple de dérogation
@cindex extra-spacing-width, exemple d'utilisation de la propriété
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
@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.
@noindent
On peut y remédier en déplaçant manuellement vers le haut les deux
-extrémités des ligatures de croche, non plus à 2 intervalles au-dessus
+extrémités des ligatures de croches, non plus à 2 intervalles au-dessus
de la ligne médiane mais, disons, à 3@tie{}:
@cindex Beam, exemple de dérogation
@code{\once \override Tie #'staff-position = #3.5}
-Cela s'adjoint à la deuxième mesure, pour donner :
+Cela s'adjoint à la deuxième mesure, pour donner@tie{}:
@c line-width ensures no break
@lilypond[quote,verbatim,ragged-right,line-width=6\in]
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
début de notre fichier de musique. Lui attribuer l'extension
@code{.ily} nous permet de distinguer aisément qu'il s'agit d'un fichier
voué à être inclus dans un fichier maître@tie{}; il n'est pas destiné à
-être compilé isolément.
+ê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.
chiffrages de mesure en @qq{C}, nous allons donc le transformer en
@qq{4/4}.
-Cependant, ne changez pas le fichier @file{musique.ly}. Remplacez le
-fichier @file{definitions.ily} par ceci@tie{}:
+Cependant, ne changez pas le fichier @file{musique@/.ly}. Remplacez le
+fichier @file{definitions@/.ily} par ceci@tie{}:
@example
%%% definitions.ily
C'est encore mieux@tie{}! Mais supposons maintenant que je veuille
publier cette pièce. Mon professeur de composition n'aime pas les
chiffrages de mesure en @qq{C}, mais moi je les aime bien. Copions
-l'actuel @file{definitions.ily} dans le fichier
-@file{publication-web.ily}, et modifions ce dernier. Puisque la musique
+l'actuel @file{definitions@/.ily} dans le fichier
+@file{publication@/-web@/.ily}, et modifions ce dernier. Puisque la musique
est destinée à produire un fichier PDF affiché sur écran, nous allons
aussi augmenter la taille globale de police.
musique.
Il est possible, bien sûr, de rendre cela encore plus pratique. Nous
-pourrions créer un fichier @file{definitions.ily} qui ne contiendrait
+pourrions créer un fichier @file{definitions@/.ily} qui ne contiendrait
que les définitions de @code{mpdolce} et de @code{inst}, un
-fichier @file{publication-web.ily} qui ne contiendrait que la section
-@code{layout} décrite ci-dessus et un fichier @file{universite.ily} qui
+fichier @file{publication@/-web@/.ily} qui ne contiendrait que la section
+@code{layout} décrite ci-dessus et un fichier @file{universite@/.ily} qui
ne contiendrait que les retouches pour produire le résultat que mon
-professeur préfère. Le début du fichier @file{musique.ly} ressemblerait
+professeur préfère. Le début du fichier @file{musique@/.ly} ressemblerait
alors à
@example
LilyPond, vous avez téléchargé un paquet précompilé sur lilypond.org, ou
vous l'avez installé grâce à votre gestionnaire de paquetages
(c'est-à-dire distribué avec Linux ou installé avec fink ou cygwin), ou
-encore vous l'avez compilé directement à partir des sources@tie{}; et (b) du
-système d'exploitation sur lequel il tourne.
+encore vous l'avez compilé directement à partir des sources@tie{}; et
+(b) du système d'exploitation sur lequel il tourne.
@strong{Téléchargé depuis lilypond.org}
@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}.
@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
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
souhaiteraient comprendre le fonctionnement de ces fichiers de
configuration doivent être avertis que des connaissances techniques
substantielles et beaucoup de temps sont nécessaires (voir le
-@rextend{Scheme tutorial}).
+@rextendnamed{Scheme tutorial,Tutoriel Scheme}).
Si c'est votre cas, les fichiers Scheme les plus utiles à connaître
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
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
intégré directement dans le processus interne de LilyPond. Bien sûr,
il faut pour cela connaître un minimum de programmation en langage
Scheme. Pour des explications complètes là-dessus, consultez le
-@rextend{Scheme tutorial}.
+@rextendnamed{Scheme tutorial,Tutoriel Scheme}.
En guise d'illustration -- et ce n'est qu'une possibilité parmi tant
d'autres -- nous allons attribuer à une propriété non pas une valeur
}
@end lilypond
-Vous trouverez dans @rextend{Callback functions} d'autres exemples
-d'utilisation de ces interfaces programmables.
+Vous trouverez dans @rextendnamed{Callback functions,les fonctions
+callback} d'autres exemples d'utilisation de ces interfaces
+programmables.
projects / lilypond.git / blobdiff