@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
@ignore
- Translation of GIT committish: b446ebc24f8d43acb323818988fe8b1d8072afc8
+ Translation of GIT committish: 95b372c451ea1586db8db66d3d00334382e8e103
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.13.39"
+@c \version "2.17.6"
@c Translators: Frédéric Chiasson, Jean-Charles Malahieude
states:
"@code{layout-set-staff-size} does not change the distance between
-the
-staff lines."
+the staff lines."
Could we add a sentence:
-"Use instead the pair fontSize = #@var{N}
- \override StaffSymbol #'staff-space = #(magstep
-@var{N})
+"Use instead the pair fontSize = #@var{N}
+ \override StaffSymbol.staff-space = #(magstep @var{N})
inside the Staff context to change the size of the font and the
-distance between
-staff lines accordingly."
+distance between staff lines accordingly."
Actually I found, that the @internalsref{StaffSymbol} at line 481
-sends to an incomplete
-documentation. The property staff-space is not explained here. I
-thought Y-extent might be of
-help, but it is in turn explained by x-space which again is
-missing from the list. Who has the
+sends to an incomplete documentation. The property staff-space is not
+explained here. I thought Y-extent might be of help, but it is in turn
+explained by x-space which again is missing from the list. Who has the
knowledge to fix this?
@translationof Spacing issues
L'agencement général d'une partition dépend de trois facteurs
-interdépendants@tie{}: la mise en page, les sauts de ligne et
-l'espacement. Les choix faits en matière d'espacement détermineront la
-densité de chacun des systèmes, ce qui influera sur le positionnement
-des sauts de lignes et, par voie de conséquence, sur le nombre de pages
-de la partition.
+interdépendants : la mise en page, les sauts de ligne et l'espacement.
+Les choix faits en matière d'espacement détermineront la densité de
+chacun des systèmes, ce qui influera sur le positionnement des sauts de
+ligne et, par voie de conséquence, sur le nombre de pages de la
+partition.
En pratique, cette procédure comporte quatre étapes. Dans un premier
temps, des distances élastiques @emph{(springs)} sont déterminées sur la
occupation de l'espace, tant horizontalement que verticalement.
Les réglages qui influencent la mise en forme se placent dans deux blocs
-différents. Le bloc @w{@code{\paper @{@dots{}@}}} étudié à la rubrique
+différents. Le bloc @w{@code{\paper @{@dots{}@}}} étudié à la rubrique
@ref{Mise en forme de la page} contient les réglages applicables à
l'intégralité du document -- à toutes les partitions d'un ouvrage --
-tels que format du papier, impression ou non des numéros de page, etc.
-Quant au bloc @w{@code{\layout @{@dots{}@}}}, qui fait l'objet de la
-rubrique @ref{Mise en forme de la musique}, il détermine la mise en
-forme d'une partition@tie{}: le nombre de systèmes utilisés,
-l'espacement des regroupements de portées, etc.
+tels que format du papier, impression ou non des numéros de page, etc.
+Quant au bloc @w{@code{\layout @{@dots{}@}}}, qui fait l'objet de la
+rubrique @ref{Mise en forme de la partition}, il détermine la mise en
+forme de la musique : le nombre de systèmes utilisés, l'espacement des
+regroupements de portées, etc.
@menu
* Mise en forme de la page::
@warning{Vous verrez au fil de ce chapitre apparaître certains termes
dont la traduction vous semblera assurément erronée. Il n'en est
-cependant rien@tie{}: certains termes techniques ont une histoire
-particulière selon leur langue d'origine. Ainsi, le vocable anglais
-@emph{Ragged} signifie en lambeau, en loques@tie{}; dans l'univers
+cependant rien : certains termes techniques ont une histoire
+particulière selon leur langue d'origine. Ainsi le vocable anglais
+@emph{Ragged} signifie en lambeau, en loques ; dans l'univers
typographique, un maître français voit un alignement à gauche -- il dira
@qq{au fer à gauche} -- alors que son homologue anglophone constate un
@emph{ragged-right} -- donc du vide à droite.}
@subsection Le bloc @code{\paper}
@translationof The @code{\paper} block
-Un bloc @code{\paper} peut apparaître au sein d'un bloc
-@code{\book}. Les réglages effectués à l'aide du bloc @code{\paper}
-s'appliqueront à l'intégralité d'un ouvrage, qui peut comporter
-plusieurs partitions (des blocs @emph{score})@tie{}; il ne doit donc en
-aucun cas se trouver dans un bloc @code{\score}. Peuvent apparaître
-dans un bloc @code{\paper}@tie{}:
+Un bloc @code{\paper} peut apparaître au sein d'un bloc @code{\book}.
+Les réglages effectués à l'aide du bloc @code{\paper} s'appliqueront à
+l'intégralité d'un ouvrage, qui peut comporter plusieurs partitions (des
+blocs @emph{score}) ; il ne doit donc en aucun cas se trouver dans un
+bloc @code{\score}. Peuvent apparaître dans un bloc @code{\paper} :
@itemize
@item
-la fonction scheme @code{set-paper-size},
+la fonction Scheme @code{set-paper-size},
@item
des variables propres au bloc @code{\paper} qui viendront adapter la
-mise en page, et
+mise en page,
@item
la définition des différents @emph{markups} qui personnaliseront la mise
-en forme des entêtes, pied de page et titrages.
+en forme des entêtes et pieds de page ainsi que des titrages.
@end itemize
La fonction @code{set-paper-size} fait l'objet de la rubrique qui suit
-- @ref{Format du papier et adaptation automatique}. Les variables du
-bloc @code{\paper} traitant de la mise en page sont abordées plus loin
+bloc @code{\paper} chargées de la mise en page sont abordées plus loin
dans ce chapitre. Quant aux définitions relatives aux @emph{markups}
-des entêtes, pied de page et titrages, elles sont étudiées à la rubrique
+des entête, pied de page et titrage, elles sont étudiées à la rubrique
@ref{Titrages personnalisés}.
La plupart des variables gérant le papier ne sont fonctionnelles que
correspondent à des dimensions sont exprimées en millimètre -- vous
pouvez bien entendu spécifier un autre système de mesure. Voici
comment, par exemple, définir la marge haute (@code{top-margin}) à dix
-millimètres@tie{}:
+millimètres :
@example
\paper @{
@}
@end example
-Si vous préférez lui affecter une valeur de 0,5@tie{}pouce, vous devrez
-mentionner le suffixe d'unité @code{\in}@tie{}:
+Si vous préférez lui affecter une valeur de 0,5 pouce, vous devrez
+mentionner le suffixe d'unité @code{\in} :
@example
\paper @{
@end example
LilyPond accepte les suffixes d'unité @code{\mm}, @code{\cm},
-@code{\in} et @code{\pt}. Pour plus de lisibilité, et bien que ce ne
-soit pas techniquement requis, nous vous conseillons d'ajouter
+@code{\in} et @code{\pt}. Ces unités sont des conversions de
+millimètres, répertoriées dans le fichier
+@file{ly/paper-defaults-init.ly}. Pour plus de lisibilité, et bien que
+ce ne soit pas techniquement requis, nous vous conseillons d'ajouter
@code{\mm} à votre code lorsque vous travaillez en millimètres.
Vous pouvez aussi définir les valeurs du bloc @code{\paper} à l'aide de
-fonctions Scheme. Voici l'équivalent de l'exemple précédent@tie{}:
+fonctions Scheme. Voici l'équivalent de l'exemple précédent :
@example
\paper @{
@seealso
Manuel de notation :
+@ref{Format du papier et adaptation automatique},
@ref{Titrages personnalisés}.
+@ref{Le bloc \layout}.
+
+Fichiers d'initialisation :
+@file{ly/paper-defaults-init.ly}.
@node Format du papier et adaptation automatique
@node Format du papier
@unnumberedsubsubsec Format du papier
-@translationof Setting paper size
+@translationof Setting the paper size
-Le format du papier est déterminé par deux fonctions différentes@tie{}:
-@code{set-default-paper-size} et @code{set-paper-size}.
-@code{set-default-paper-size} se place en tête de fichier, alors que
-@code{set-paper-size} se place à l'intérieur d'un bloc
-@code{\paper}@tie{}:
+LilyPond génère par défaut, et en l'absence de mention explicite d'un
+format de papier, un fichier imprimable au format A4. Vous pouvez
+cependant utiliser un autre format à l'aide des deux fonctions
+@code{set-default-paper-size} et @code{set-paper-size} qui, elle, se
+place à l'intérieur d'un bloc @code{\paper} :
@example
-#(set-default-paper-size "a4")
+#(set-default-paper-size "quarto")
@end example
+qui se place en début de fichier, ou @code{set-paper-size},
+
@example
\paper @{
- #(set-paper-size "a4")
+ #(set-paper-size "tabloid")
@}
@end example
+qui s'inscrit au sein d'un bloc @code{\paper}.
+
@noindent
La seule restriction à l'utilisation isolée de la fonction
@code{set-default-paper-size} est qu'elle doit intervenir avant le
-premier bloc @code{\paper}. À l'intérieur d'un bloc @code{\paper}, il
-vaut mieux utiliser la fonction @code{set-paper-size}, avant toute autre
-variables. Les raisons à ceci sont abordées dans la rubrique
-@ref{Adaptation automatique au format}.
-
-@code{set-default-paper-size} fixe le format pour toutes les pages,
-alors que @code{set-paper-size} détermine le format des feuilles
-rattachées à un bloc @code{\paper} particulier. Ainsi, lorsque le bloc
-@code{\paper} se trouve en tête de fichier, le format du papier
-s'appliquera à toutes les pages@tie{}; si @code{\paper} apparaît dans un
-bloc @code{\book}, la taille ne s'appliquera qu'au @emph{book} en
-question.
-
-Les formats @code{a4}, @code{letter}, @code{legal} et @code{11x17} (ou
-tabloïd) sont couramment utilisés pour les éditions musicales. Bien
-d'autres formats sont disponibles et sont répertoriés à la rubrique
-@code{paper-alist} du fichier d'initialisation @file{scm/paper.scm}.
+premier bloc @code{\paper}. @code{set-default-paper-size} fixe le
+format pour toutes les pages, alors que @code{set-paper-size} détermine
+le format des feuilles rattachées à un bloc @code{\paper} particulier.
+Ainsi, lorsque le bloc @code{\paper} se trouve en tête de fichier, le
+format du papier s'appliquera à toutes les pages ; si @code{\paper}
+apparaît dans un bloc @code{\book}, la taille ne s'appliquera qu'au
+@emph{book} en question.
+
+À l'intérieur d'un bloc @code{\paper}, la fonction @code{set-paper-size}
+doit intervenir avant toute autre variable. Les raisons à ceci sont
+abordées à la rubrique @ref{Adaptation automatique au format}.
+
+Différents formats de papier sont définis dans le fichier
+@file{scm/paper.scm}. Bien que vous puissiez y ajouter votre propre
+format, sachez cependant que celui-ci est écrasé à chaque mise à jour de
+LilyPond.
+
+@c An appendix entry exists for paper sizes but is not auto-generated
+
+La commande suivante, inscrite dans votre fichier, vous permettra
+d'ajouter votre format personnalisé à ceux déjà connus, puis d'y faire
+appel à l'aide des fonctions @code{set-default-paper-size} et
+@code{set-paper-size} :
-@c TODO add a new appendix for paper sizes (auto-generated) -pm
-
-@warning{Par défaut, le papier est au format A4 (codé @code{a4}).}
+@example
+#(set! paper-alist (cons '("mon format" . (cons (* 15 in) (* 3 in))) paper-alist))
-Rien ne vous empêche d'ajouter un format de papier inhabituel à la
-rubrique @code{paper-alist} du fichier @file{scm/paper.scm}. Sachez
-cependant que celui-ci est écrasé à chaque mise à jour de LilyPond.
+\paper @{
+ #(set-paper-size "mon format")
+@}
+@end example
+
+Les unités peuvent s'exprimer aussi bien en @code{in} (pouces), qu'en
+@code{cm} (centimètres) ou @code{mm} (millimètres).
-@cindex orientation
-@cindex landscape
+@cindex papier, orientation
+@cindex landscape, papier
@cindex paysage, papier
@cindex à l'italienne, papier
Le fait d'ajouter l'argument @code{'landscape} à l'instruction
-@code{set-default-paper-size} permet d'obtenir une présentation à
+stipulant le format du papier permet d'obtenir une présentation à
l'italienne -- ou paysage si vous préférez -- et donc des lignes plus
longues.
#(set-default-paper-size "a6" 'landscape)
@end example
+L'inversion des dimensions du papier sans pour autant basculer la
+présentation -- comme pour imprimer sur une carte postale ou créer un
+graphique destiné à inclusion -- s'obtient en ajoutant @samp{landscape}
+au nom du format de papier :
+
+@example
+#(set-default-paper-size "a6landscape")
+@end example
+
+Lorsque la taille du papier comporte explicitement @samp{landscape} ou
+@samp{portrait}, la présence d'un argument @code{'landscape} aura pour
+seul effet de modifier l'orientation de l'image et non les dimensions de
+la feuille.
@seealso
+Manuel de notation :
+@ref{Adaptation automatique au format},
+@ref{Formats de papier prédéfinis}.
+
Fichiers d'initialisation :
@file{scm/paper.scm}.
@unnumberedsubsubsec Adaptation automatique au format
@translationof Automatic scaling to paper size
-If the paper size is changed with one of the scheme functions
-(@code{set-default-paper-size} or @code{set-paper-size}), the
-values of several @code{\paper} variables are automatically scaled
-to the new size. To bypass the automatic scaling for a particular
-variable, set the variable after setting the paper size. Note
-that the automatic scaling is not triggered by setting
-@code{paper-height} or @code{paper-width}, even though
-@code{paper-width} can influence other values (this is separate
-from scaling and is discussed below). The
-@code{set-default-paper-size} and @code{set-paper-size} functions
-are described in @ref{Setting paper size}.
-
-The vertical dimensions affected by automatic scaling are
-@code{top-margin} and @code{bottom-margin}. The horizontal
-dimensions affected by automatic scaling are @code{left-margin},
-@code{right-margin}, @code{inner-margin}, @code{outer-margin},
-@code{binding-offset}, @code{indent}, and @code{short-indent}.
-
-The default values for these dimensions are set in
-@file{ly/paper-defaults-init.ly}, using internal variables named
-@code{top-margin-default}, @code{bottom-margin-default}, etc.
-These are the values that result at the default paper size
-@code{a4}. For reference, with @code{a4} paper the
-@code{paper-height} is @code{297\mm} and the @code{paper-width} is
+Toute modification du format de papier à l'aide des fonctions Scheme
+@code{set-default-paper-size} ou @code{set-paper-size}, que nous avons
+vues à la rubrique @ref{Format du papier}, se traduira automatiquement
+par l'ajustement d'un certain nombre de variables attachées au bloc
+@code{\paper} afin qu'elles soient en concordance avec le format
+spécifié. Vous pouvez annuler l'ajustement automatique d'une variable
+particulière en redéfinissant sa valeur après avoir spécifié le format
+de papier utilisé. Notez bien que le simple fait d'affecter une valeur
+à @code{paper-height} ou @code{paper-width} ne déclenchera pas
+l'étalonnage automatique, bien que spécifier une largeur de papier
+@emph{(@code{paper-width})} peut influencer d'autres valeurs -- mais
+c'est une autre histoire dont nous parlerons plus tard et qui n'a rien à
+voir avec la mise à l'échelle.
+
+L'adaptation automatique affecte les dimensionnements verticaux
+@code{top-margin} et @code{bottom-margin} -- voir
+@ref{Variables d'espacement vertical fixe} --, ainsi que les
+dimensionnements horizontaux @code{left-margin}, @code{right-margin},
+@code{inner-margin}, @code{outer-margin}, @code{binding-offset},
+@code{indent} et @code{short-indent} -- voir
+@ref{Variables d'espacement horizontal}.
+
+Les valeurs par défaut de ces dimensionnements sont contenues dans le
+fichier @file{ly/paper-defaults-init.ly} et utilisent les variables
+internes @code{top-margin-default}, @code{bottom-margin-default}, etc.
+correspondant au format par défaut -- papier A4 -- pour lequel
+@code{paper-height} est à @code{297\mm} et @code{paper-width} à
@code{210\mm}.
@seealso
-Installed Files:
+Manuel de notation :
+@ref{Variables d'espacement vertical fixe},
+@ref{Variables d'espacement horizontal}.
+
+Fichiers d'initialisation :
@file{ly/paper-defaults-init.ly},
@file{scm/paper.scm}.
-@funindex \paper
-
-Les marges, entête et pied de page, ainsi que les autres variables de
-mise en page sont automatiquement définis par rapport au format du
-papier.
-
-Les valeurs par défaut des marges, inscrites dans le fichier
-d'initialisation @file{ly/paper-defaults-init.ly}, s'appliquent
-au format par défaut (A4 sauf mention spécifique) et sont étalonnées
-pour les autres formats.
-
-Nous allons examiner, dans les paragraphes qui suivent, les différentes
-variables sur lesquelles vous pouvez intervenir.
-
-
@node Variables d'espacement vertical fixe
@subsection Variables d'espacement vertical fixe
@translationof Fixed vertical spacing @code{\paper} variables
+@warning{Certains dimensionnements attachés au bloc @code{@bs{}paper}
+sont automatiquement ajustés selon le format du papier, ce qui peut
+conduire à un résultat inattendu --
+voir @ref{Adaptation automatique au format}.}
+
+Les valeurs par défaut (avant étalonnage) sont définies dans le fichier
+@file{ly/paper-defaults-init.ly}.
+
@table @code
@item paper-height
@funindex paper-height
La hauteur de la feuille. Il s'agit par défaut de la dimension du
-papier utilisé -- voir @ref{Format du papier} pour plus de détails.
+papier utilisé. Notez bien que cette variable n'affectera pas
+l'ajustement automatique d'un certain nombre de dimensionnements
+verticaux.
@item top-margin
@funindex top-margin
La marge entre le bord supérieur de la feuille et la surface imprimable.
-Elle est fixée par défaut à@tie{}@code{5\mm}.
+Elle est fixée par défaut à @code{5\mm} et s'ajustera selon le
+format de papier.
@item bottom-margin
@funindex bottom-margin
La marge entre la surface imprimable et le bord inférieur de la feuille.
-Elle est fixée par défaut à@tie{}@code{6\mm}.
+Elle est fixée par défaut à @code{6\mm} et s'ajustera selon le
+format de papier.
@item ragged-bottom
@funindex ragged-bottom
L'activation de cette variable permet de ne pas répartir verticalement
les systèmes sur les pages hormis la dernière. La valeur par défaut
-est@tie{}@code{##f}.
-
-Lorsque la partition ne comporte que deux ou trois systèmes par page,
-comme pour un conducteur d'orchestre, nous vous conseillons d'activer
-cette variable.
+est @code{#f}. Lorsque la partition ne comporte que deux ou trois
+systèmes par page, comme pour un conducteur d'orchestre, nous vous
+conseillons d'activer cette variable.
@item ragged-last-bottom
@funindex ragged-last-bottom
La désactivation de cette variable permet de répartir verticalement les
systèmes de la dernière page d'une partition. La valeur par défaut
-est@tie{}@code{##t}.
-
-Nous vous conseillons, lorsque des pièces couvrent deux pages ou plus,
-d'activer cette variable.
-
+est @code{#t}. Nous vous conseillons, lorsque des pièces couvrent
+deux pages ou plus, de désactiver cette variable.@*
Notez bien que la variable @code{ragged-last-bottom} affecte aussi la
dernière page de chacune des parties -- créées à l'aide d'un bloc
@code{\bookpart} -- d'un même ouvrage.
@end table
-
@seealso
+Manuel de notation :
+@ref{Adaptation automatique au format}.
+
Fichiers d'initialisation :
@file{ly/paper-defaults-init.ly}.
@rlsrnamed{Spacing, Espacements}.
@knownissues
+Les titrages (contenus dans le bloc @code{\header@{@}}) sont considérés
+comme des systèmes à part entière ; ils seront donc affectés par
+@code{ragged-bottom} et @code{ragged-last-bottom}, qui éventuellement
+ajouteront de l'espace avant le premier système de la partition.
-The titles (from the @code{\header} block) are treated as a
-system, so @code{ragged-bottom} and @code{ragged-last-bottom} will
-add space between the titles and the first system of the score.
+La définition explicite d'un format de papier annulera tout réglage des
+marges haute et basse.
@node Variables d'espacement vertical fluctuant
définissent au niveau du bloc @code{\score} -- voir à ce sujet
@ref{Espacement vertical au sein d'un système}.
-
@menu
* Structure des variables d'espacement vertical fluctuant::
* Liste des variables d'espacement vertical fluctuant::
@end menu
+
@node Structure des variables d'espacement vertical fluctuant
@unnumberedsubsubsec Structure des variables d'espacement vertical fluctuant
@translationof Structure of flexible vertical spacing alists
-Chacune de ces variables est constituée d'une liste associative à quatre
-@i{clés}@tie{}:
+Chacune de ces variables attachées au bloc @code{\paper} est constituée
+d'une liste associative @emph{(alist)} à quatre @i{clés} :
@itemize
-@item
-@code{padding} (@emph{décalage}) -- la grandeur minimale de
-@qq{blanc} qui sépare deux éléments, exprimée en hauteur de portée. On
-peut le voir comme la hauteur minimale d'un rectangle vide qui devrait
-s'étendre sur toute la largeur des deux éléments.
@item
-@code{space} (@emph{espace}) -- la grandeur d'espace par défaut,
-exprimée en hauteur de portée, séparant les @i{points de référence} de
-deux éléments, qui évite tout risque de collision en l'absence de
-dilatation ou compression. Le point de référence d'un titre ou d'un
-@emph{markup} est son sommet, celui d'un système est la ligne médiane du
-@code{StaffSymbol} le plus proche -- même lorsqu'une ligne de
-@qq{non-portée} se trouverait au milieu. Un @code{space} inférieur à
-@code{padding} ou @code{minimum-distance} sera sans effet, dans la
-mesure où l'espacement résultant ne saurait être inférieur à
-@code{padding} ou @code{minimum-distance}.
+@code{basic-distance} @emph{(distance de base)} -- la grandeur d'espace
+par défaut, exprimée en hauteur de portée, séparant les @i{points de
+référence} de deux éléments, qui évite tout risque de collision en
+l'absence de dilatation ou compression. Le point de référence d'un
+titre ou d'un @emph{markup} est son sommet, celui d'un système est le
+centre vertical du @code{StaffSymbol} le plus proche -- même lorsqu'une
+ligne de @qq{non-portée} viendrait à s'intercaler. Une
+@code{basic-distance} inférieure à @code{padding} ou
+@code{minimum-distance} sera sans effet, dans la mesure où l'espacement
+résultant ne saurait être inférieur à @code{padding} ou
+@code{minimum-distance}.
@item
-@code{minimum-distance} (@emph{distance-minimale}) -- l'espacement
+@code{minimum-distance} @emph{(distance-minimale)} -- l'espacement
minimal, exprimé en hauteur de portée, entre les points de référence des
deux éléments alors qu'il y a déjà un effet de compression. Une
@code{minimum-distance} inférieure à la valeur du @code{padding} sera
sans effet, dans la mesure où l'espacement résultant ne saurait être
inférieur au @code{padding}.
+@c TODO: explain skylines somewhere and xref to it from here.
+
+@item
+@code{padding} @emph{(décalage)} -- la grandeur minimale de @qq{blanc}
+qui sépare deux éléments, exprimée en hauteur de portée. On peut le
+voir comme la hauteur minimale d'un rectangle vide qui devrait s'étendre
+sur toute la largeur des deux éléments.
+
@item
-@code{stretchability} (@emph{dilatation}) -- le coefficient
+@code{stretchability} @emph{(dilatation)} -- le coefficient
d'étirement de cet espace. Un coefficient nul permet de figer
l'espacement, à moins qu'il n'en résulte des collisions. Un coefficient
positif déterminera la propension d'un espacement à s'étirer, tout
double de celui d'une autre, elle pourra s'étirer deux fois plus que
cette dernière. Il ne saurait être négatif. La valeur @code{+inf.0}
provoque une @code{programming_error} (erreur de programmation) et est
-ignorée@tie{}; vous pouvez toutefois utiliser @code{1.0e7} pour obtenir
+ignorée ; vous pouvez toutefois utiliser @code{1.0e7} pour obtenir
une valeur proche de l'infini. Lorsque cette @i{clé} n'est pas définie,
sa valeur est par défaut égale à @code{space}. Notez bien que
-l'utilisateur ne peut définir une propension à la compression@tie{};
+l'utilisateur ne peut définir une propension à la compression ;
elle est en fait égale à
-(@code{space}@tie{}@minus{}@tie{}@code{minimum-distance}).
+(@code{basic-distance} @minus{} @code{minimum-distance}).
@end itemize
maximum de
@itemize
-@item @code{space}, plus
-@item @code{minimum-distance} et
-@item @code{padding}, augmenté de ce qu'il faut pour éviter les
+
+@item
+@code{basic-distance}, plus
+@item
+@code{minimum-distance} et
+@item
+@code{padding}, augmenté de ce qu'il faut pour éviter les
chevauchements.
+
@end itemize
-Les manières de modifier des listes associatives font l'objet d'un
-@rusernamed{Modification de listes associatives,chapitre spécifique}.
-Les variables d'espacement associées au papier ne peuvent se gérer que
-dans un bloc @code{\paper}.
+Cependant, lorsque la partition fait plusieurs pages, la dernière page
+reprendra dans la mesure du possible l'espacement de la page précédente.
+Les manières de modifier des listes associatives font l'objet d'un
+@rusernamed{Modification de listes associatives, chapitre spécifique}.
L'exemple suivant indique deux façons de modifier une liste associative.
La première déclaration intervient sur une seule clé, alors que la
deuxième redéfinit complètement la variable.
@example
\paper @{
- system-system-spacing #'space = #8
+ system-system-spacing #'basic-distance = #8
score-system-spacing =
#'((padding . 1)
- (space . 12)
+ (basic-distance . 12)
(minimum-distance . 6)
(stretchability . 12))
@}
@end example
-Les valeurs par défaut de ces variables sont répertoriés dans le
-fichier @file{ly/paper-defaults-init.ly}.
-
@node Liste des variables d'espacement vertical fluctuant
@unnumberedsubsubsec Liste des variables d'espacement fluctuant
@translationof List of flexible vertical spacing @code{\paper} variables
Le nom des dimensionnements à hauteur variable sont de la forme
-@code{@var{upper}-@var{lower}-spacing}, où @code{@var{upper}} et
-@code{@var{lower}} représentent les éléments qui doivent être espacés.
+@code{@var{avant}-@var{après}-spacing}, où @code{@var{avant}} et
+@code{@var{après}} représentent les éléments qui doivent être espacés.
La distance s'établit entre les points de référence des deux éléments
-concernés@tie{}: le sommet pour un titre ou un @emph{markup}, la ligne
-médiane de la portée la plus proche pour un système. Notez bien que,
-dans les règles de nommage des variables qui suivent, le terme
+concernés (voir la rubrique précédente pour plus de précision). Notez
+bien que, dans les règles de nommage des variables qui suivent, le terme
@code{markup} fait référence aussi bien à un @i{markup de titrage}
(@code{bookTitleMarkup} ou @code{scoreTitleMarkup}) qu'à un
@i{markup de haut niveau} (voir @ref{Structure de fichier}). Toutes les
-distances sont exprimées en espace de portée. Leurs valeurs par défaut
-sont inscrites dans le fichier @file{ly/paper-defaults-init.ly}.
+distances sont exprimées en espace de portée.
-@c TODO: Where do headers/footers fit in? -mp
+Leurs valeurs par défaut sont inscrites dans le fichier
+@file{ly/paper-defaults-init.ly}.
-Voici à présent les différentes variables disponibles@tie{}:
+@c TODO: Where do headers/footers fit in? -mp
@table @code
@item markup-system-spacing
@end table
-
@seealso
Manuel de notation :
@ref{Espacement vertical au sein d'un système}.
Morceaux choisis :
@rlsrnamed{Spacing,Espacements}.
+Morceaux choisis :
+@rlsrnamed{Spacing,Espacements}.
+
@node Variables d'espacement horizontal
@subsection Variables d'espacement horizontal
@translationof Horizontal spacing \paper variables
-@warning{Some @code{@bs{}paper} dimensions are automatically
-scaled to the paper size, which may lead to unexpected behavior.
-See @ref{Automatic scaling to paper size}.}
+@warning{Certains dimensionnements attachés au bloc @code{@bs{}paper}
+sont automatiquement ajustés selon le format du papier, ce qui peut
+conduire à un résultat inattendu --
+voir @ref{Adaptation automatique au format}.}
@menu
* Variables de marge et de largeur::
* Variables d'indentation et de décalage::
@end menu
-Certaines variables permettent de gérer les dimensionnements
-horizontaux de la page@tie{}:
-
@node Variables de marge et de largeur
@unnumberedsubsubsec Variables de marge et de largeur
@translationof @code{\paper} variables for widths and margins
-Default values (before scaling) that are not listed here are
-defined in @file{ly/paper-defaults-init.ly}.
+Les valeurs par défaut (avant étalonnage) sont définies dans le fichier
+@file{ly/paper-defaults-init.ly}.
@table @code
@funindex paper-width
La largeur de la page. Elle correspond par défaut à la largeur du
-format de papier utilisé -- voir à ce sujet la rubrique
-@ref{Format du papier}.
+format de papier utilisé. Si @code{paper-width} n'a aucun effet en
+matière d'ajustement automatique, cette variable influe sur la variable
+@code{line-width}. Lorsque vous définissez à la fois les valeurs de
+@code{paper-width} et @code{line-width}, les valeurs de
+@code{left-margin} et @code{right-margin} seront recalculées. Voir
+aussi @code{check-consistency}.
@item line-width
@funindex line-width
-la longueur d'un système musical. La valeur par défaut est égale à
+la longueur d'un système musical sans indentation et justifié sur toute
+la largeur de la page. La valeur par défaut est égale à
@code{paper-width}, auquel sont retranchés @code{left-margin} et
-@code{right-margin}.
+@code{right-margin}. Lorsque vous définissez @code{line-width} sans
+modifier les valeurs de @code{left-margin} et @code{right-margin}, les
+marges seront alors recalculées de telle sorte que les systèmes soient
+centrés. Voir aussi @code{check-consistency}. La variable
+@code{line-width} peut se définir aussi dans un bloc @code{\layout}.
@item left-margin
@funindex left-margin
la marge entre le bord gauche de la feuille et le début de chaque
-système. La valeur par défaut est de@tie{}@code{10\mm}.
+système. La valeur par défaut est de @code{10\mm} ; elle sera
+ajustée selon le format du papier. Lorsque vous définissez
+@code{line-width} et @code{right-margin} sans modifier la valeur de
+@code{left-margin}, cette dernière sera alors égale à
+@code{(paper-width @minus{} line-width @minus{} right-margin)}.
+Lorsque seule @code{line-width} est définie, les deux marges
+correspondent à
+@code{((paper-width @minus{} line-width) / 2)}, ce
+qui a pour effet de centrer les systèmes sur la page. Voir aussi
+@code{check-consistency}.
@item right-margin
@funindex right-margin
-La marge entre le bord droit de la page et la fin des systèmes. La
-valeur par défaut est de@tie{}@code{10\mm}.
+La marge entre le bord droit de la page et la fin des systèmes en pleine
+largeur (non @emph{ragged}). La valeur par défaut est de @code{10\mm}
+et s'ajustera selon le format du papier. Lorsque vous définissez
+@code{line-width} et @code{left-margin}, sans modifier la valeur de
+@code{right-margin}, cette dernière sera alors égale à
+@code{(paper-width @minus{} line-width @minus{} left-margin)}.
+Lorsque seule @code{line-width} est définie, les deux marges
+correspondent à
+@code{((paper-width @minus{} line-width) / 2)}, ce
+qui a pour effet de centrer les systèmes sur la page. Voir aussi
+@code{check-consistency}.
@item check-consistency
@funindex check-consistency
Lorsqu'elle est activée, cette variable vérifie que @code{left-margin},
-@code{right-margin} et @code{line-width} sont en cohérence, et que
+@code{line-width} et @code{right-margin} sont en cohérence, et que
l'addition de ces trois éléments ne dépassera pas la largeur du papier
-(@code{paper-width}). La valeur par défaut est@tie{}@code{##t}.
+(@code{paper-width}). La valeur par défaut est @code{#t}. Dans
+le cas d'une incohérence, un message d'avertissement est émis et les
+trois variables -- marges et longueur de ligne -- rétablies à leur
+valeur par défaut (ajustées selon le format du papier).
@item ragged-right
@funindex ragged-right
Lorsque cette variable est activée, les systèmes ne s'étendront pas sur
la longueur de la ligne, mais s'arrêteront à leur longueur normale.
-La valeur par défaut est @code{##f}.
-
-Si la partition ne comporte qu'un seul système, la valeur par défaut
-devient @code{##t}.
+La valeur par défaut est @code{#f} mais, si la partition ne comporte
+qu'un seul système, elle passe à @code{#t}. Cette variable peut aussi
+se gérer au sein d'un bloc @code{\layout}.
@item ragged-last
@funindex ragged-last
Lorsqu'elle est activée, cette variable permet de ne pas étendre le
dernier système de façon à occuper toute la longueur de la ligne. La
-valeur par défaut est@tie{}@code{##f}.
+valeur par défaut est @code{#f}. Cette variable peut aussi
+se gérer au sein d'un bloc @code{\layout}.
@end table
@seealso
+Manuel de notation :
+@ref{Adaptation automatique au format}.
+
Fichiers d'initialisation :
@file{ly/paper-defaults-init.ly}.
+@knownissues
+La définition explicite d'un format de papier annulera tout réglage des
+marges gauche et droite.
+
@node Variables spécifiques pour l'impression recto-verso
@unnumberedsubsubsec Variables spécifiques pour l'impression recto-verso
-@translationof@code{\paper} variables for two-sided mode
+@translationof @code{\paper} variables for two-sided mode
-Default values (before scaling) are defined in
+Les valeurs par défaut (avant étalonnage) sont définies dans le fichier
@file{ly/paper-defaults-init.ly}.
-
@table @code
@item two-sided
@code{outer-margin} ainsi que @code{binding-offset} détermineront les
différentes marges selon qu'il s'agit d'une page paire ou impaire.
Cette variable s'applique en lieu et place de @code{left-margin} et
-@code{right-margin}. La valeur par défaut est@tie{}@code{##f}.
+@code{right-margin}. La valeur par défaut est @code{#f}.
@item inner-margin
@funindex inner-margin
avoir du côté intérieur. Bien entendu, cette variable n'est
effective que lorsque vous comptez générer un fichier imprimable en
recto-verso -- propriété @code{two-sided} définie à vrai. La valeur par
-défaut est de@tie{}@code{10\mm}.
+défaut est de @code{10\mm} et s'ajustera selon le format du papier.
@item outer-margin
@funindex outer-margin
avoir du côté extérieur -- opposé à la reliure. Bien entendu, cette
variable n'est effective que lorsque vous comptez générer un fichier
imprimable en recto-verso -- propriété @code{two-sided} définie à vrai.
-La valeur par défaut est de@tie{}@code{20\mm}.
+La valeur par défaut est de @code{20\mm} et s'ajustera selon le
+format du papier.
@item binding-offset
@funindex binding-offset
rien ne soit masqué par la reliure. Bien entendu, cette variable n'est
effective que lorsque vous comptez générer un fichier imprimable en
recto-verso -- propriété @code{two-sided} définie à vrai. La valeur par
-défaut est de@tie{}@code{0}.
+défaut est de @code{0} et s'ajustera selon le format du papier.
@end table
@seealso
+Manuel de notation :
+@ref{Adaptation automatique au format}.
+
Fichiers d'initialisation :
@file{ly/paper-defaults-init.ly}.
@unnumberedsubsubsec Variables d'indentation et de décalage
@translationof @code{\paper} variables for shifts and indents
-Default values (before scaling) that are not listed here are
-defined in @file{ly/paper-defaults-init.ly}.
+Les valeurs par défaut (avant étalonnage) sont définies dans le fichier
+@file{ly/paper-defaults-init.ly}.
@table @code
@c This default value is buried in the middle of page.scm. -mp
Tous les systèmes, ainsi que les titres et séparateurs de systèmes,
-seront poussés d'autant vers la droite. la valeur par défaut est
-de@tie{}@code{0.0}.
+seront poussés d'autant vers la droite. La valeur par défaut est
+de @code{0.0}.
@item indent
@funindex indent
Le niveau d'indentation du premier système d'une partition. La valeur
-par défaut est de@tie{}@code{15\mm}.
+par défaut est de @code{15\mm} et s'ajustera selon le format du
+papier. Cette variable peut aussi se gérer au sein d'un bloc
+@code{\layout}.
@item short-indent
@funindex short-indent
Le niveau d'indentation de tous les systèmes hormis le premier. La
-valeur par défaut est de@tie{}@code{0}.
+valeur par défaut est de @code{0}, et s'ajustera selon le format du
+papier dès lors que vous lui affecterez une valeur. Cette variable peut
+aussi se gérer au sein d'un bloc @code{\layout}.
@end table
+@seealso
+Manuel de notation :
+@ref{Adaptation automatique au format}.
+
+Fichiers d'initialisation :
+@file{ly/paper-defaults-init.ly}.
+
+Morceaux choisis :
+@rlsrnamed{Spacing, Espacements}.
+
+
@node Autres variables du bloc \paper
@subsection Autres variables du bloc @code{\paper}
@translationof Other @code{\paper} variables
* Variables de gestion des sauts de ligne::
* Variables de gestion des sauts de page::
* Variables de gestion des numéros de page::
-* Autres variables::
+* Variables supplémentaires::
@end menu
@funindex system-count
Le nombre de systèmes requis par la partition. Cette variable n'est pas
-définie par défaut.
+définie par défaut. Cette variable peut se gérer au sein d'un bloc
+@code{\layout}.
@end table
@unnumberedsubsubsec Variables de gestion des sauts de page
@translationof @code{\paper} variables for page breaking
-Default values not listed here are defined in
-@file{ly/paper-defaults-init.ly}
+Les valeurs par défaut sont définies dans le fichier
+@file{ly/paper-defaults-init.ly}.
@table @code
-@item blank-after-score-page-force
-@funindex blank-after-score-page-force
-
-The penalty for having a blank page after the end of one score and
-before the next. By default, this is smaller than
-@code{blank-page-force}, so that we prefer blank pages after
-scores to blank pages within a score.
+@item blank-after-score-page-penalty
+@funindex blank-after-score-page-penalty
-Default: @code{2}.
+Pénalité pour apparition d'une page blanche entre deux partitions. Sa
+valeur est par défaut inférieure à celle de
+@code{blank-page-penalty} ; nous préférons qu'une page blanche
+s'insère après la fin de la partition plutôt qu'au milieu.
-@item blank-last-page-force
-@funindex blank-last-page-force
+@item blank-last-page-penalty
+@funindex blank-last-page-penalty
Pénalité pour fin de partition intervenant sur une page impaire. La
-valeur par défaut est de@tie{}@code{0}.
+valeur par défaut est de @code{0}.
-@item blank-page-force
-@funindex blank-page-force
+@item blank-page-penalty
+@funindex blank-page-penalty
Pénalité pour apparition d'une page blanche en cours de partition.
-L'option @code{ly:optimal-breaking} n'en tiendra pas compte puisqu'elle
-ne conçoit pas la présence d'une page blanche au milieu d'une partition.
-La valeur par défaut est de@tie{}@code{5}.
+L'algorithme @code{ly:optimal-breaking} n'en tiendra pas compte
+puisqu'il ne conçoit pas la présence d'une page blanche au milieu d'une
+partition. La valeur par défaut est de @code{5}.
+@item page-breaking
@funindex page-breaking
-The page-breaking algorithm to use. Choices are
-@code{ly:minimal-breaking}, @code{ly:page-turn-breaking}, and
+L'algorithme de calcul des sauts de page à utiliser. Vous avez le choix
+entre @code{ly:minimal-breaking}, @code{ly:page-turn-breaking} et
@code{ly:optimal-breaking}.
@item page-breaking-system-system-spacing
@ref{Sauts de page},
@ref{Optimisation des sauts de page},
@ref{Optimisation des tournes},
-@ref{Minimisation des sauts de page}.
+@ref{Minimisation des sauts de page},
+@ref{Présentation en rouleau}.
-Installed files:
+Fichiers d'initialisation :
@file{ly/paper-defaults-init.ly}.
@unnumberedsubsubsec Variables de gestion des numéros de page
@translationof @code{\paper} variables for page numbering
-Default values not listed here are defined in
-@file{ly/paper-defaults-init.ly}
+Les valeurs par défaut sont définies dans le fichier
+@file{ly/paper-defaults-init.ly}.
@table @code
fonctionnalité est activée, l'algorithme des sauts de page décidera de
lui-même si le premier numéro sera pair ou impair, ce qui se traduira
par un éventuel incrément de un. La valeur par défaut
-est@tie{}@code{##f}.
+est @code{#f}.
@item first-page-number
@funindex first-page-number
Le numéro de la première page. La valeur par défaut est
-de@tie{}@code{#1}.
+de @code{#1}.
@item print-first-page-number
@funindex print-first-page-number
Cette variable permet d'imprimer le numéro de page y compris sur la
-première. La valeur par défaut est@tie{}@code{##f}.
+première. La valeur par défaut est @code{#f}.
@item print-page-number
@funindex print-page-number
La désactivation de cette variable permet d'obtenir des pages non
-numérotées. La valeur par défaut est@tie{}@code{##t}.
+numérotées. La valeur par défaut est @code{#t}.
@end table
Fichiers d'initialisation :
@file{ly/paper-defaults-init.ly}.
+@knownissues
+Les pages au numéro impair sont toujours à droite. Pour que la musique
+commence en page 1, le dos de la page de garde doit être vide de telle
+sorte que la page une se retrouve à droite.
+
-@node Autres variables
-@unnumberedsubsubsec Autres variables
+@node Variables supplémentaires
+@unnumberedsubsubsec Variables supplémentaires
@translationof Miscellaneous @code{\paper} variables
@table @code
Cette variable définit l'importance relative des espacements entre la
page (verticalité) et la ligne (horizontalité). Une valeur élevée
privilégiera l'espacement au niveau de la page. La valeur par défaut
-est de@tie{}@code{#10}.
+est de @code{10}.
@item print-all-headers
@funindex print-all-headers
Lorsque cette variable est activée, l'intégralité des champs d'entête
sera imprimée pour chaque bloc @code{\score}, plutôt que les seuls
champs @code{piece} et @code{opus}. La valeur par défaut
-est@tie{}@code{##f}.
+est @code{#f}.
@item system-separator-markup
@funindex system-separator-markup
Il s'agit en l'occurrence d'insérer un objet de type @emph{markup} entre
chaque système, comme on le voit dans nombre de partitions orchestrales.
-Cette variable n'est pas définie par défaut.
+Cette variable n'est pas définie par défaut. La commande
+@code{\slashSeparator} -- définie dans le fichier
+@file{ly/titling-init.ly} -- fournit un @emph{markup} relativement
+courant :
-La commande @code{\slashSeparator} fournit un @emph{markup} relativement
-courant@tie{}:
+@lilypond[quote,verbatim,noragged-right,line-width=30\mm]
+#(set-default-paper-size "a8")
-@lilypond[quote,ragged-right]
-#(set-default-paper-size "a6" 'landscape)
\book {
- \score {
- \relative c' { c1 \break c1 }
- }
\paper {
system-separator-markup = \slashSeparator
}
+ \header {
+ tagline = ##f
+ }
+ \score {
+ \relative c'' { c1 \break c1 \break c1 }
+ }
}
@end lilypond
@end table
-
@seealso
Fichiers d'initialisation :
@file{ly/titling-init.ly}.
Morceaux choisis :
@rlsrnamed{Spacing,Espacements}.
-
@knownissues
-
L'entête par défaut, formé d'une seule ligne, est constitué du numéro de
page et du champ @code{instrument} contenu dans le bloc @code{\header}.
Alors que le bloc @code{\paper} définit le formatage des pages pour
l'intégralité du document, le bloc @code{\layout} s'occupe de la mise en
-forme spécifique à la partition.
+forme spécifique à la partition. La mise en forme de la musique peut
+concerner toutes les partitions d'un même ouvrage, auquel cas un bloc
+@code{\layout} indépendant se placera en tête de fichier. Dans le cas
+où la mise en forme concerne une partition en particulier, un bloc
+@code{\layout} se placera au sein du bloc @code{\score} en question.
+Sont susceptibles d'apparaître dans un bloc @code{\layout} :
+
+@itemize
+@item
+la fonction Scheme @code{layout-set-staff-size},
+
+@item
+dans des blocs @code{\context}, les modifications apportées aux
+différents contextes, et
+
+@item
+les variables normalement attachées au bloc @code{\paper} qui
+affecteront la mise en forme de la partition.
+
+@end itemize
+
+La fonction @code{layout-set-staff-size} fait l'objet de la rubrique
+suivante, @ref{Définition de la taille de portée}. La modification des
+contextes est abordée dans d'autres chapitres -- voir
+@ref{Modification des greffons de contexte} et
+@ref{Modification des réglages par défaut d'un contexte}. Les variables
+du bloc @code{\paper} que l'on peut retrouver dans un bloc
+@code{\layout} sont :
+
+@itemize
+
+@item
+@code{line-width}, @code{ragged-right} et @code{ragged-last}
+(voir @ref{Variables de marge et de largeur})
+
+@item
+@code{indent} et @code{short-indent}
+(voir @ref{Variables d'indentation et de décalage})
+
+@item
+@code{system-count}
+(voir @ref{Variables de gestion des sauts de ligne})
+
+@end itemize
+
+Voici un exemple de bloc @code{\layout} :
+
+@example
+\layout @{
+ indent = 2\cm
+ \context @{
+ \StaffGroup
+ \override StaffGrouper.staff-staff-spacing.basic-distance = #8
+ @}
+ \context @{
+ \Voice
+ \override TextScript.padding = #1
+ \override Glissando.thickness = #3
+ @}
+@}
+@end example
+
+Il est tout à fait possible que plusieurs blocs @code{\layout}
+cohabitent en tant qu'expressions de niveau supérieur. Ceci se révèle
+particulièrement utile lorsque différents réglages sont stockés dans des
+fichiers séparés qui sont inclus au besoin. Lorsqu'un bloc
+@code{\layout} est évalué, une copie de la configuration du
+@code{\layout} actuel est réalisée en interne, augmentée des
+aménagements apportés. Bien qu'on puisse considérer que le contenu des
+différents blocs @code{\layout} se cumule, c'est la dernière adaptation
+qui aura préséance en cas de situation conflictuelle -- cas typique
+d'une même propriété modifiée dans différents blocs.
+
+Par exemple, placer le bloc suivant
@example
\layout @{
- indent = 2.0\cm
- \context @{ \Staff
- \override VerticalAxisGroup #'minimum-Y-extent = #'(-6 . 6)
+ \context @{
+ \Voice
+ \override TextScript.color = #magenta
+ \override Glissando.thickness = #1.5
@}
- \context @{ \Voice
- \override TextScript #'padding = #1.0
- \override Glissando #'thickness = #3
+@}
+@end example
+
+après celui de l'exemple précédent aura pour effet de cumuler les
+adaptations de @code{'padding} et @code{'color} pour l'objet
+@code{TextScript}, mais la dernière adaptation apportée à la propriété
+@code{'thickness} de @code{Glissando} remplace, ou masque, celle
+précédemment établie.
+
+Les blocs @code{\layout} peuvent faire l'objet de variables, aux fins de
+les utiliser ultérieurement. Ceci requiert toutefois une attention
+particulière dans la mesure où cette manière de procéder n'est pas
+équivalente à une définition complète et globale.
+
+Lorsque nous définissons la variable suivante,
+
+@example
+layoutVariable = \layout @{
+ \context @{
+ \Voice
+ \override NoteHead.font-size = #4
@}
@}
@end example
+qui contient une configuration de @code{\layout} avec
+l'adaptation @code{NoteHead #'font-size}, cette combinaison n'est pas
+enregistrée en tant que configuration courante. Notez bien que la
+« configuration courante » est lue lorsque la variable est définie, non
+lorsqu'elle est utilisée ; par voie de conséquence, le contenu de la
+variable dépend de l'endroit où elle se trouve dans le code source.
+
+Notre variable peut alors être utilisée au sein d'un autre bloc
+@code{\layout}, comme par exemple :
+
+@example
+\layout @{
+ \layoutVariable
+ \context @{
+ \Voice
+ \override NoteHead.color = #red
+ @}
+@}
+@end example
+
+Un bloc @code{\layout} qui contient une variable comme ci-dessus, ne
+recopie pas la configuration actuelle ; il utilise en fait le contenu de
+@code{layoutVariable} en tant que configuration de base pour les
+adaptations ultérieures, en conséquence de quoi toute modification
+intervenant entre la définition et l'utilisation de la variable sera
+perdue.
+
+Si @code{layoutVariable} est définie, ou rapatriée par un
+@code{\indude}, juste avant d'être utilisée, son contenu devient la
+configuration actuelle augmentée des adaptations que la variable
+contient. Considérant l'exemple d'utilisation de @code{layoutVariable}
+ci-dessus, le bloc @code{\layout} final contiendra donc :
+
+@example
+ TextScript #'padding = #1
+ TextScript #'color = #magenta
+ Glissando #'thickness = #1.5
+ NoteHead #'font-size = #4
+ NoteHead #'color = #red
+@end example
+
+ainsi que les adaptations de @code{indent} et @code{StaffGrouper}.
+
+Cependant, si la variable avait été définie bien avant le premier bloc
+@code{\layout}, la configuration actuelle ne contiendrait que
+
+@example
+ NoteHead #' font-size= #4 % (écrit dans la définition de la variable)
+ NoteHead #' color = #red % (ajouté après l'utilisation de la variable)
+@end example
+
+Une gestion attentive des variables de @code{\layout} se révèle être un
+outil précieux dans la mise en forme des sources et le retour à une
+configuration donnée.
@seealso
Manuel de notation :
@cindex portée, définition de la taille
@funindex layout file
-La @strong{taille de portée} (@emph{staff size}) est fixée par défaut à
-20@tie{}points. Il existe deux manières de la modifier@tie{}:
+La @strong{taille de portée} @emph{(staff size)} est fixée par défaut à
+20 points. Il existe deux manières de la modifier :
La taille des portées peut se définir globalement pour toutes les
partitions d'un même fichier, ou plus précisément d'un bloc
@end example
@noindent
-Ceci définit donc la hauteur des portées à 14@tie{}points par
-défaut@tie{}; toutes les fontes seront ajustées en conséquence.
-
+Ceci définit donc la hauteur des portées à 14 points par
+défaut ; toutes les fontes seront ajustées en conséquence.
Vous pouvez aussi spécifier une taille à une partition en particulier en
-procédant comme ci-dessous@tie{}:
+procédant comme ci-dessous :
@example
\score@{
- ...
+ @dots{}
\layout@{
- #(layout-set-staff-size 15)
+ #(layout-set-staff-size 15)
@}
@}
@end example
La fonte Feta fournit les symboles musicaux dans huit tailles
différentes. Chaque fonte correspond à une hauteur particulière de
-portée@tie{}; les petites tailles comportent des symboles plus épais
-pour correspondre à l'épaisseur relativement plus importante des lignes
-de la portée. Le tableau suivant répertorie les différentes tailles de
-police.
+portée ; les petites tailles comportent des symboles plus épais
+pour être cohérent avec l'épaisseur relativement plus importante des
+lignes de la portée. Le tableau suivant répertorie les différentes
+tailles de police.
@quotation
@multitable @columnfractions .15 .2 .22 .2
@tab 25,2
@tab 8,9
@tab
-@c modern rental material?
+@c matériel de location moderne ?
@end multitable
@end quotation
-Ces fontes sont disponibles à toutes les tailles. La propriété de
+Ces fontes sont disponibles dans toutes les tailles. La propriété de
contexte @code{fontSize} ainsi que la propriété de mise en forme
@code{staff-space} (voir @rinternals{StaffSymbol}) permettent d'ajuster
individuellement la taille de chaque portée. La taille de chacune des
portées est relative à la taille globale.
-
@seealso
Manuel de notation :
@ref{Indication de la taille de fonte musicale}.
Morceaux choisis :
@rlsrnamed{Spacing,Espacements}.
-
@knownissues
-
@code{layout-set-staff-size} ne modifie en rien l'espacement entre les
lignes d'une portée.
* Optimisation des sauts de page::
* Optimisation des tournes::
* Minimisation des sauts de page::
+* Présentation en rouleau::
* Sauts explicites::
* Recours à une voix supplémentaire pour gérer les sauts::
@end menu
+
@node Sauts de ligne
@subsection Sauts de ligne
@translationof Line breaking
Les sauts de ligne sont normalement gérés de façon automatique. Ils
interviennent de telle sorte qu'une ligne ne soit ni trop resserrée, ni
trop aérée, et que des lignes consécutives aient à peu près la même
-densité. Il arrive parfois que LilyPond n'ait pas judicieusement placé
-un saut de ligne@tie{}; il suffit alors d'insérer l'instruction
-@code{\break} à l'endroit où vous le jugez utile pour @qq{forcer} le
-passage à la ligne suivante, en gardant à l'esprit qu'il ne saurait
-intervenir au beau milieu d'une mesure. Autrement dit, un saut de ligne
-ne peut se placer que sur une barre, à la fin d'une mesure complète. Si
-d'aventure vous voulez forcer un saut de ligne en l'absence de barre de
-mesure, vous devrez auparavant insérer une barre invisible -- à l'aide
-de @code{\bar@tie{}""} -- et vous assurer qu'aucune portée n'a de note
-en cours à ce moment précis, auquel cas le saut en question sera tout
-simplement ignoré.
+densité.
+
+Vous pouvez cependant insérer l'instruction @code{\break} à l'endroit où
+vous le jugez utile pour @qq{forcer} le passage à la ligne suivante :
+
+@lilypond[quote,ragged-right,relative=2,verbatim]
+c4 c c c | \break
+c4 c c c |
+@end lilypond
+
+Par défaut, un saut de ligne ne saurait intervenir au beau milieu d'une
+mesure ; LilyPond vous le signalera par un message si tel était le
+cas. Si d'aventure vous voulez forcer un saut de ligne en l'absence de
+barre de mesure, vous devrez auparavant insérer une barre invisible -- à
+l'aide de @code{\bar ""}.
+
+@lilypond[quote,ragged-right,relative=2,verbatim]
+c4 c c
+\bar "" \break
+c |
+c4 c c c |
+@end lilypond
+
+LilyPond ignorera un @code{\break} placé sur une barre à la fin d'une
+mesure dès lors que la précédente avait une note en suspend -- c'est
+typiquement le cas lorsqu'un nolet est à cheval sur deux mesures.
+L'instruction @code{\break} sera alors opérationnelle si vous avez
+auparavant désactivé le @code{Forbid_line_break_engraver} du contexte
+@code{Voice} concerné. Notez bien qu'en pareil cas, les sauts de ligne
+forcés doivent être saisis au sein d'une expression polyphonique :
+
+@lilypond[quote,ragged-right,verbatim]
+\new Voice \with {
+ \remove "Forbid_line_break_engraver"
+} \relative c'' {
+ <<
+ { c2. \times 2/3 { c4 c c } c2. | }
+ { s1 | \break s1 | }
+ >>
+}
+@end lilypond
+
+Selon le même principe, un saut de ligne ne peut intervenir alors qu'une
+ligature s'étend sur deux mesures consécutives. Il faut en ce cas là
+introduire la dérogation @w{@code{\override Beam.breakable = ##t}}.
+
+@lilypond[quote,ragged-right,relative=2,verbatim]
+\override Beam.breakable = ##t
+c2. c8[ c | \break
+c8 c] c2. |
+@end lilypond
L'instruction opposée, @code{\noBreak}, interdira toute tentative de
saut de ligne à la fin de la mesure où elle est explicitée.
ligne, et @code{line-width} la longueur des lignes.
L'activation du commutateur @code{ragged-right} au sein du bloc
-@code{\layout} aura pour effet de terminer les système là où il le
-feraient normalement plutôt que de les étirer sur toute la longueur de
-la ligne. Ceci est particulièrement utile pour de petits fragments ou
-pour vérifier la densité induite par l'espacement naturel.
+@code{\layout} aura pour effet de terminer les systèmes là où ils
+prendraient fin normalement plutôt que de les étirer sur toute la
+longueur de la ligne. Ceci est particulièrement utile pour de petits
+fragments ou pour vérifier la densité induite par l'espacement naturel.
@c TODO Check and add para on default for ragged-right
@example
\layout @{
-indent = #0
-line-width = #150
-ragged-last = ##t
+ indent = 0\mm
+ line-width = 150\mm
+ ragged-last = ##t
@}
@end example
-
-
@cindex sauts de ligne réguliers
@cindex portée à quatre mesures
L'utilisation conjointe de @code{\break} et de blancs dans une section
@code{\repeat} vous permettra de positionner des sauts de ligne à
-intervalle régulier. Par exemple, les 28 mesures de ce qui suit seront
-coupées toutes les quatre mesures, pas ailleurs@tie{}:
+intervalle régulier. Par exemple, les 28 mesures de ce qui suit, si
+l'on est à 4/4, seront coupées toutes les quatre mesures, pas
+ailleurs :
@example
-<< \repeat unfold 7 @{
- s1 \noBreak s1 \noBreak
- s1 \noBreak s1 \break @}
- @emph{en avant la musique !}
+<<
+ \repeat unfold 7 @{
+ s1 \noBreak s1 \noBreak
+ s1 \noBreak s1 \break
+ @}
+ @{ @var{et ici la musique@dots{}} @}
>>
@end example
-@ignore
-Apparemment, je ne vois pas de "snippet" qui corresponde,
-à moins que ce ne soit pour allécher vers la section
-"4.6 Fitting music onto fewer pages" -JCM
-@c TODO Check this
-A linebreaking configuration can be saved as a @code{.ly} file
-automatically. This allows vertical alignments to be stretched to
-fit pages in a second formatting run. This is fairly new and
-complicated. More details are available in
-@rlsr{Spacing}.
-@end ignore
-
@predefined
@funindex \break
@code{\break},
@code{\noBreak}.
@endpredefined
-
@seealso
+Manuel de notation :
+@ref{Variables de gestion des sauts de ligne}.
+
Référence des propriétés internes :
@rinternals{LineBreakEvent}.
@rlsrnamed{Spacing,Espacements}.
-@knownissues
-
-Un saut de ligne ne peut intervenir qu'au moment d'une barre de mesure.
-Une note qui resterait en suspend faussera la mesure comme vous pouvez
-le constater ci-dessous.
-
-@lilypond[quote,ragged-right,relative=2,verbatim]
-c4 c2 << c2 {s4 \break } >> % this does nothing
-c2 c4 | % a break here would work
-c4 c2 c4 ~ \break % as does this break
-c4 c2 c4
-@end lilypond
-
-Le seul moyen d'obtenir ce que vous voulez en pareil cas consiste à
-désactiver le @code{Forbid_line_break_engraver}. Notez bien que les
-sauts de ligne forcés doivent être saisis au sein d'une expression
-polyphonique@tie{}:
-
-@lilypond[quote,ragged-right,relative=2,verbatim]
-\new Voice \with {
- \remove Forbid_line_break_engraver
-} {
- c4 c2 << c2 {s4 \break } >> % now the break is allowed
- c2 c4
-}
-@end lilypond
-
-Selon le même principe, un saut de ligne ne peut intervenir alors qu'une
-ligature s'étend sur deux mesures consécutives. Il faut en ce cas là
-introduire la dérogation @code{\override Beam #'breakable = ##t}.
-
-
@node Sauts de page
@subsection Sauts de page
@translationof Page breaking
Tout comme @code{ragged-right} et @code{ragged-last} qui permettent de
gérer la répartition horizontale, LilyPond dispose de commutateurs
-équivalents au niveau de la verticalité@tie{}: @code{ragged-bottom} et
+équivalents au niveau de la verticalité : @code{ragged-bottom} et
@code{ragged-last-bottom}. Lorsqu'ils sont tous deux activés --
-affectés de @code{##t} -- les systèmes ne seront pas répartis sur les
-pages y compris la dernière.
-
-Pour de plus amples détails, reportez-vous à @ref{Espacement vertical}.
+affectés de @code{#t} -- les systèmes ne seront pas répartis sur les
+pages y compris la dernière. Pour de plus amples détails, reportez-vous
+à @ref{Variables d'espacement vertical fixe}.
Les sauts de page sont générés par la fonction @code{page-breaking}.
-LilyPond dispose de trois différents algorithmes en la matière@tie{}:
+LilyPond dispose de trois différents algorithmes en la matière :
@code{ly:optimal-breaking}, @code{ly:page-turn-breaking} et
@code{ly:minimal-breaking}. C'est @code{ly:optimal-breaking} qui est
activé par défaut, mais rien ne vous empêche d'en changer, par
-l'intermédiaire du bloc @code{\paper}@tie{}:
+l'intermédiaire du bloc @code{\paper} :
@example
-\paper@{
- #(define page-breaking ly:page-turn-breaking)
+\paper @{
+ page-breaking = #ly:page-turn-breaking
@}
@end example
pages, la gestion des sauts de page finit par devenir très gourmande,
tant au niveau du processeur que de la mémoire. Vous pouvez cependant
alléger la charge en recourant à des blocs @code{\bookpart} afin de
-sectionner l'ouvrage que vous traitez@tie{}; les sauts de pages seront
+sectionner l'ouvrage que vous traitez ; les sauts de page seront
alors gérés individuellement au niveau de chacune des parties. Par
ailleurs, cela vous autorisera une gestion différente selon les
sections.
\paper @{
%% Pour une partie constituée principalement de texte
%% ly:minimal-breaking est plus judicieux.
- #(define page-breaking ly:minimal-breaking)
+ page-breaking = #ly:minimal-breaking
@}
\markup @{ @dots{} @}
@dots{}
@}
@end example
-
@predefined
@funindex \pageBreak
@code{\pageBreak},
@code{\noPageBreak}.
@endpredefined
-
@seealso
+Manuel de notation :
+@ref{Variables de gestion des sauts de page}.
+
Morceaux choisis :
@rlsrnamed{Spacing,Espacements}.
aérée. Contrairement à la fonction @code{ly:page-turn-breaking}, elle
n'a aucune notion de ce qu'est une @qq{tourne}.
-
@seealso
Morceaux choisis :
@rlsrnamed{Spacing,Espacements}.
vous mentionnerez dans un contexte de voix ou de portée. Ce graveur de
tournes recherchera dans le contexte en question les passages sans note.
Notez bien qu'il ne recherche pas des silences, mais l'absence de
-notes@tie{}; autrement dit, il ne restera pas inactif dans la cadre
+notes ; autrement dit, il ne restera pas inactif dans le cadre
d'une portée polyphonique dont l'une des parties contiendrait des
silences. Lorsqu'il rencontre un fragment suffisamment long ne
contenant aucune note, il insère un @code{\allowPageTurn} à la barre
@code{minimumPageTurnLength} pour déterminer quelle doit être la
longueur d'un fragment sans note avant une tourne. La valeur par
défaut de @code{minimumPageTurnLength} est
-@code{#(ly:make-moment@tie{}1@tie{}1)}, soit une ronde, et s'ajuste de
-la manière suivante@tie{}:
+@code{(ly:make-moment 1 1)}, soit une ronde, et s'ajuste de
+la manière suivante :
@example
\new Staff \with @{ \consists "Page_turn_engraver" @}
@code{\allowPageTurn} -- peuvent s'utiliser à des niveaux supérieurs,
entre des blocs @code{\score} ou des @emph{markups} de haut niveau.
-
@predefined
@funindex \pageTurn
@code{\pageTurn},
@code{\allowPageTurn}.
@endpredefined
-
@seealso
Morceaux choisis :
@rlsrnamed{Spacing,Espacements}.
-
@knownissues
-
Une partition ne devrait contenir qu'une seule instance du
-@code{Page_turn_engraver}, au risque de se contredire les uns les autres.
+@code{Page_turn_engraver}, au risque de les voir se contredire.
@node Minimisation des sauts de page
lorsque les autres fonctions de gestion des sauts de page ralentissent
nettement le traitement, sont trop gourmandes en mémoire ou qu'il y a
beaucoup de texte. Il suffit de la mentionner au sein du bloc
-@code{\paper}@tie{}:
+@code{\paper} :
@example
\paper @{
- #(define page-breaking ly:minimal-breaking)
+ page-breaking = #ly:minimal-breaking
@}
@end example
-
@seealso
Morceaux choisis :
@rlsrnamed{Spacing,Espacements}.
+@node Présentation en rouleau
+@subsection Présentation en rouleau
+@translationof One-line page breaking
+
+@funindex ly:one-line-breaking
+
+La fonction @code{ly:one-line-breaking} constitue un algorithme de
+calcul des sauts de pages particulier en ceci que chaque partition fait
+l'objet d'une page unique, d'une seule ligne. Cette fonctionnalité
+s'affranchit de l'impression des titres et marges ; seule la partition
+est affichée.
+
+La largeur de page est ajustée de telle sorte que la pièce la plus
+longue tienne sur une seule ligne. En particulier, les variables
+@code{paper-width}, @code{line-width} et @code{indent} du bloc
+@code{\paper} seront ignorées ; les @code{left-margin} et
+@code{right-margin} seront honorées. La hauteur de page ne sera pas
+modifiée.
+
+
@node Sauts explicites
@subsection Sauts explicites
@translationof Explicit breaks
Il arrive parfois que LilyPond rejette des @code{\break} ou des
@code{\pageBreak} explicites. Vous pouvez alors prendre le contrôle
-avec ces deux instructions dérogatoires@tie{}:
+avec ces deux instructions dérogatoires :
@example
-\override NonMusicalPaperColumn #'line-break-permission = ##f
-\override NonMusicalPaperColumn #'page-break-permission = ##f
+\override NonMusicalPaperColumn.line-break-permission = ##f
+\override NonMusicalPaperColumn.page-break-permission = ##f
@end example
Lorsque vous désactivez @code{line-break-permission}, LilyPond
ragged-bottom = ##t
}
+musique = \relative c'' { c8 c c c }
+
\score {
\new Staff {
- \repeat unfold 2 { c'8 c'8 c'8 c'8 } \break
- \repeat unfold 4 { c'8 c'8 c'8 c'8 } \break
- \repeat unfold 6 { c'8 c'8 c'8 c'8 } \break
- \repeat unfold 8 { c'8 c'8 c'8 c'8 } \pageBreak
- \repeat unfold 8 { c'8 c'8 c'8 c'8 } \break
- \repeat unfold 6 { c'8 c'8 c'8 c'8 } \break
- \repeat unfold 4 { c'8 c'8 c'8 c'8 } \break
- \repeat unfold 2 { c'8 c'8 c'8 c'8 }
- }
+ \repeat unfold 2 { \musique } \break
+ \repeat unfold 4 { \musique } \break
+ \repeat unfold 6 { \musique } \break
+ \repeat unfold 8 { \musique } \pageBreak
+ \repeat unfold 8 { \musique } \break
+ \repeat unfold 6 { \musique } \break
+ \repeat unfold 4 { \musique } \break
+ \repeat unfold 2 { \musique }
+ }
\layout {
\context {
\Score
- \override NonMusicalPaperColumn #'line-break-permission = ##f
- \override NonMusicalPaperColumn #'page-break-permission = ##f
+ \override NonMusicalPaperColumn.line-break-permission = ##f
+ \override NonMusicalPaperColumn.page-break-permission = ##f
}
}
}
@end lilypond
-
@seealso
Morceaux choisis :
@rlsrnamed{Spacing,Espacements}.
de page se retrouvent directement au milieu des notes.
@example
+musique = \relative c'' @{ c4 c c c @}
+
\score @{
\new Staff @{
- \repeat unfold 2 @{ c'4 c'4 c'4 c'4 @}
- \break
- \repeat unfold 3 @{ c'4 c'4 c'4 c'4 @}
+ \repeat unfold 2 @{ \musique @} \break
+ \repeat unfold 3 @{ \musique @}
@}
@}
@end example
concernant les ruptures.
@lilypond[quote,verbatim]
+music = \relative c'' { c4 c c c }
+
\score {
\new Staff <<
\new Voice {
s1 * 5 \break
}
\new Voice {
- \repeat unfold 2 { c'4 c'4 c'4 c'4 }
- \repeat unfold 3 { c'4 c'4 c'4 c'4 }
- \repeat unfold 6 { c'4 c'4 c'4 c'4 }
- \repeat unfold 5 { c'4 c'4 c'4 c'4 }
+ \repeat unfold 2 { \music }
+ \repeat unfold 3 { \music }
+ \repeat unfold 6 { \music }
+ \repeat unfold 5 { \music }
}
>>
}
le voir au chapitre @ref{Espacement vertical}.
@lilypond[quote,verbatim]
+music = \relative c'' { c4 c c c }
+
\score {
\new Staff <<
\new Voice {
- \overrideProperty "Score.NonMusicalPaperColumn"
- #'line-break-system-details #'((Y-offset . 0))
+ \overrideProperty Score.NonMusicalPaperColumn.line-break-system-details #'((Y-offset . 0))
s1 * 2 \break
- \overrideProperty "Score.NonMusicalPaperColumn"
- #'line-break-system-details #'((Y-offset . 35))
+ \overrideProperty Score.NonMusicalPaperColumn.line-break-system-details #'((Y-offset . 35))
s1 * 3 \break
- \overrideProperty "Score.NonMusicalPaperColumn"
- #'line-break-system-details #'((Y-offset . 70))
+ \overrideProperty Score.NonMusicalPaperColumn.line-break-system-details #'((Y-offset . 70))
s1 * 6 \break
- \overrideProperty "Score.NonMusicalPaperColumn"
- #'line-break-system-details #'((Y-offset . 105))
+ \overrideProperty Score.NonMusicalPaperColumn.line-break-system-details #'((Y-offset . 105))
s1 * 5 \break
}
\new Voice {
- \repeat unfold 2 { c'4 c'4 c'4 c'4 }
- \repeat unfold 3 { c'4 c'4 c'4 c'4 }
- \repeat unfold 6 { c'4 c'4 c'4 c'4 }
- \repeat unfold 5 { c'4 c'4 c'4 c'4 }
+ \repeat unfold 2 { \music }
+ \repeat unfold 3 { \music }
+ \repeat unfold 6 { \music }
+ \repeat unfold 5 { \music }
}
>>
}
@end lilypond
-
@seealso
Manuel de notation :
@ref{Espacement vertical}.
@cindex vertical, espacement
@cindex espacement vertical
-L'espacement vertical dépend de trois éléments@tie{}: la surface
+L'espacement vertical dépend de trois éléments : la surface
disponible -- par exemple format de papier et marges --, l'espace qui
doit séparer les systèmes, et l'espace qui sépare les portées d'un même
système.
* Résolution des collisions verticales::
@end menu
+
@node Espacement vertical au sein d'un système
@subsection Espacement vertical au sein d'un système
@translationof Flexible vertical spacing within systems
@cindex espacement au sein d'un système
LilyPond dispose de trois différents mécanismes permettant de contrôler
-l'espacement au sein d'un système selon trois catégories@tie{}:
+l'espacement au sein d'un système selon trois catégories :
@itemize
+
@item
@emph{portées isolées},
@item
@emph{portées regroupées} (portées d'un même groupe, telles celles
-d'un @code{ChoirStaff}, etc.), et
+d'un @code{ChoirStaff}, etc.), et
@item
-@emph{lignes de non-portée} (@code{Lyrics}, @code{ChordNames}, etc.).
+@emph{lignes de non-portée} (@code{Lyrics}, @code{ChordNames}, etc.).
@end itemize
non. Pour ce qui a trait aux espacements entre les systèmes,
mouvements, annotations et marge, ils sont contrôlés par des variables
attachées au bloc @code{\paper} et font l'objet du chapitre
-@ref{Dimensionnement vertical fluctuant}.
+@ref{Variables d'espacement vertical fluctuant}.
@menu
* Propriétés d'espacement au sein d'un système::
Le nom de ces propriétés, sauf @code{staff-affinity}, suit le schéma
@code{@var{item1}-@var{item2}-spacing} -- @code{@var{item1}} et
@code{@var{item2}} étant les éléments à espacer. Notez bien que
-@code{@var{item2}} n'est pas forcément placé au-dessous@tie{}: c'est le
+@code{@var{item2}} n'est pas forcément placé au-dessous : c'est le
cas pour la propriété @code{nonstaff-relatedstaff-spacing} qui spécifie
-la distance entre une ligne de non-portée alors que sa
-@code{staff-affinity} a été déterminée à @code{#UP}.
+l'espacement d'une ligne de non-portée alors que sa
+@code{staff-affinity} a été déterminée à @code{UP}.
Toutes ces distances sont mesurées entre les points de référence
-respectifs de éléments considérés.
+respectifs des éléments considérés.
Le @i{point de référence} d'une portée est le centre vertical du
@code{StaffSymbol} -- la ligne médiane si @code{line-count} est impair,
l'interligne médian si @code{line-count} est pair.
Quant aux lignes rattachées à des portées -- lignes de non-portée -- le
-tableau suivant présente le @i{point de référence} pour chacun d'entre
-eux@tie{}:
+tableau suivant présente le @i{point de référence} pour chacune
+d'elles :
-@multitable {Non-staff line} {Reference point}
+@multitable {Ligne de non-portée} {Point de référence}
@headitem Ligne de non-portée @tab Point de référence
@item @code{ChordNames} @tab ligne de base
@item @code{NoteNames} @tab ligne de base
@item @code{FretBoards} @tab ligne supérieure
@end multitable
-En voici une représentation graphique@tie{}:
+En voici une représentation graphique :
@c KEEP LY
@lilypond[quote,noragged-right,line-width=110\mm]
-#(define zero-space '((padding . -inf.0) (space . 0)))
+#(define zero-space '((padding . -inf.0) (basic-distance . 0)))
alignToZero = \with {
- \override VerticalAxisGroup #'nonstaff-relatedstaff-spacing = #zero-space
- \override VerticalAxisGroup #'nonstaff-nonstaff-spacing = #zero-space
+ \override VerticalAxisGroup.nonstaff-relatedstaff-spacing = #zero-space
+ \override VerticalAxisGroup.nonstaff-nonstaff-spacing = #zero-space
}
lowerCaseChords = \with {
chordNameLowercaseMinor = ##t
}
staffAffinityDown = \with {
- \override VerticalAxisGroup #'staff-affinity = #DOWN
+ \override VerticalAxisGroup.staff-affinity = #DOWN
}
labelContext =
#(define-music-function
(parser location context)
(string?)
- #{ s1*0^\markup { \typewriter $context } #})
+ #{ s1*0^\markup { \typewriter #context } #})
\layout {
\context { \Dynamics \alignToZero }
\context { \FiguredBass \alignToZero }
\context { \Lyrics \alignToZero }
- \context { \NoteNames \alignToZero }
- \context { \ChordNames \alignToZero \lowerCaseChords }
+ \context { \NoteNames \alignToZero \staffAffinityDown }
+ \context { \ChordNames \alignToZero
+ \staffAffinityDown
+ \lowerCaseChords }
\context { \FretBoards \alignToZero \staffAffinityDown }
\context { \Score
- \override BarLine #'stencil = ##f
- \override DynamicText #'self-alignment-X = #-1
- \override FretBoard #'X-offset = #1.75
- \override InstrumentName #'minimum-Y-extent = #'(-2 . 2)
- \override InstrumentName #'extra-offset = #'(0 . -0.5)
- \override TextScript #'minimum-Y-extent = #'(-2 . 3)
- \override TimeSignature #'stencil = ##f
+ \override BarLine.stencil = ##f
+ \override DynamicText.self-alignment-X = #-1
+ \override FretBoard.X-offset = #1.75
+ \override InstrumentName.minimum-Y-extent = #'(-2 . 2)
+ \override InstrumentName.extra-offset = #'(0 . -0.5)
+ \override TextScript.minimum-Y-extent = #'(-2 . 3)
+ \override TimeSignature.stencil = ##f
}
}
\set RhythmicStaff.instrumentName = #"centre vertical "
\labelContext "Dynamics" s1*3
}
- \new Dynamics { s2\mp s\fp }
+ \new Dynamics { s1\mp s\fp }
>>
%% Le point de référence de FiguredBass est son point le plus haut
Hormis @code{staff-affinity} -- propriété attachée au @emph{grob}
@code{VerticalAxisGroup} --, chacune de ces propriétés est enregistrée
-sous la forme d'une liste associative dont les composantes sont
-identiques à celle des variables du bloc @code{\paper} que nous avons
-examinées au chapitre @ref{Dimensionnement vertical fluctuant}.
-
-Les particularités en matière de modification d'une liste associative
-font l'objet d'un
+sous la forme d'une liste associative dont la structure est
+identique à celle des variables du bloc @code{\paper} que nous avons
+examinées au chapitre
+@ref{Variables d'espacement vertical fluctuant}. Les particularités en
+matière de modification d'une liste associative font l'objet d'un
@rusernamed{Modification de listes associatives,chapitre particulier}.
Les propriétés des objets graphiques se règlent avec un @code{\override}
mentionné dans un bloc @code{\score} ou @code{\layout}, pas dans le bloc
@example
\new Staff \with @{
- \override VerticalAxisGroup #'staff-staff-spacing #'space = #10
+ \override VerticalAxisGroup.staff-staff-spacing.basic-distance = #10
@} @{ @dots{} @}
\new Staff \with @{
- \override VerticalAxisGroup #'staff-staff-spacing =
- #'((padding . 1)
- (space . 10)
+ \override VerticalAxisGroup.staff-staff-spacing =
+ #'(('basic-distance . 10)
(minimum-distance . 9)
+ (padding . 1)
(stretchability . 10))
@} @{ @dots{} @}
@end example
La modification d'un espacement au niveau global se mentionne au sein du
-bloc @code{\layout}@tie{}:
+bloc @code{\layout} :
@example
\layout @{
\context @{
\Staff
- \override VerticalAxisGroup #'staff-staff-spacing #'space = #10
+ \override VerticalAxisGroup.staff-staff-spacing.basic-distance = #10
@}
@}
@end example
@subsubheading Propriétés de l'objet @code{VerticalAxisGroup}
-@translationof Properties of the @code{VerticalAxisGroup} grob
+@c VO Properties of the @code{VerticalAxisGroup} grob
Les propriétés de l'objet @code{VerticalAxisGroup} s'ajustent à l'aide
d'un @code{\override} au niveau d'un contexte @code{Staff} (ou son
Il s'agit de la distance entre la portée en cours et la portée qui suit
au sein du même regroupement, qu'il y ait ou non une ligne de non-portée
(@code{Lyrics} ou autre) entre les deux. Cette propriété ne s'applique
-pas à la dernière portée d'un système.
-Cette propriété écrase les réglages hérités du @emph{grob}
-@code{StaffGrouper} d'un éventuel regroupement.
-Lorsque @code{staff-staff-spacing} n'est pas défini et qu'il n'y a pas
-de @code{StaffGrouper} dont on pourrait hériter des propriétés, c'est la
-propriété @code{default-staff-staff-spacing} qui s'applique.
+pas à la dernière portée d'un système.
+
+En tout état de cause, la fonction Scheme @code{staff-staff-spacing}
+d'un @code{VerticalAxisGroup} affectera les propriétés du
+@code{StaffGrouper} si la portée est incluse dans un regroupement ;
+elle s'appliquera au @code{default-staff-staff-spacing} en l'absence de
+regroupement. Les portées peuvent donc s'aligner différemment selon
+qu'elles sont ou non regroupées. Pour obtenir le même espacement sans
+tenir compte des éventuels regroupements, cette fonction peut faire
+place à une complète redéfinition des espacements fluctuants à l'aide de
+règles dérogatoires comme vu précédemment.
@item default-staff-staff-spacing
-Il s'agit de la distance qui s'appliquera, dans le cas où
-@code{staff-staff-spacing} n'aura pas été défini, aussi bien pour les
-portées isolées que dans le cas où les portées d'un regroupement
-n'hériteraient pas des ajustements du @code{StaffGrouper} concerné.
+Il s'agit de la distance qui s'appliquera par défaut aux portées
+isolées, à moins que @code{staff-staff-spacing} n'ait été redéfini
+explicitement par un @code{\override}.
@item staff-affinity
Il s'agit de la direction -- @code{UP}, @code{DOWN} ou @code{CENTER} --
@code{staff-affinity} définie à @code{UP}. De la même manière, lorsque
cette ligne surplombe un système, sa @code{staff-affinity} devrait être
définie à @code{DOWN}. Prenez garde à la valeur que vous affectez à
-@code{staff-affinity}@tie{}: si vous lui affectez la valeur @code{#f} à
+@code{staff-affinity} : si vous affectez la valeur @code{#f} à
une ligne de non-portée, cette ligne sera considérée comme étant une
-portée@tie{}; à l'inverse, utiliser la propriété @code{staff-affinity}
+portée ; à l'inverse, utiliser la propriété @code{staff-affinity}
pour une portée lui fera perdre cette qualité.
@c TODO: verify last clause below ("even if other...")
@item nonstaff-relatedstaff-spacing
Il s'agit de la distance entre la ligne de non-portée en cours et la
portée la plus proche selon la @code{staff-affinity}, à la double
-condition qu'il n'y a pas déjà une autre ligne de non-portée et que la
+condition qu'il n'y ait pas déjà une autre ligne de non-portée et que la
valeur de @code{staff-affinity} soit @code{UP} ou @code{DOWN}. Lorsque
la valeur de @code{staff-affinity} est égale à @code{CENTER}, la valeur
de @code{nonstaff-relatedstaff-spacing} servira à centrer la ligne de
@item nonstaff-nonstaff-spacing
Il s'agit de la distance entre deux lignes de non-portée selon
-l'orientation définie par @code{staff-affinity} et qu'elles ont la même
-orientation. Bien entendu, ceci ne peut concerner que les valeurs
-@code{UP} et @code{DOWN} de @code{staff-affinity}.
+l'orientation définie par @code{staff-affinity} et dès lors qu'elles ont
+la même orientation. Bien entendu, ceci ne peut concerner que les
+valeurs @code{UP} et @code{DOWN} de @code{staff-affinity}.
@item nonstaff-unrelatedstaff-spacing
Il s'agit de la distance entre une ligne de non-portée et la portée à
-l'opposé de l'orientation adoptée, à la double condition qu'il n'y a pas
-déjà une autre ligne de non-portée et que la valeur de
+l'opposé de l'orientation adoptée, à la double condition qu'il n'y ait
+pas déjà une autre ligne de non-portée et que la valeur de
@code{staff-affinity} soit @code{UP} ou @code{DOWN}. Cette propriété
trouve toute sa légitimité pour décaler une ligne de @code{Lyrics} de la
portée à laquelle elle ne correspond pas.
@subsubheading Propriétés de l'objet @code{StaffGrouper}
-@translationof Properties of the @code{StaffGrouper} grob
+@c VO Properties of the @code{StaffGrouper} grob
Les propriétés de l'objet @code{StaffGrouper} s'ajustent à l'aide
d'un @code{\override} au niveau d'un contexte @code{StaffGroup} (ou son
@table @code
@item staff-staff-spacing
Il s'agit de la distance entre deux portées consécutives d'un même
-système. Cependant, lorsque l'une des portées d'un regroupement s'est
-vue définir la propriété @code{staff-staff-spacing} de son
-@code{VerticalAxisGroup}, le @code{VerticalAxisGroup} aura préséance.
-Voir aussi la propriété @code{default-staff-staff-spacing}.
+système. La propriété @code{staff-staff-spacing} de l'objet
+@code{VerticalAxisGroup} d'une portée en particulier peut se redéfinir à
+l'aide de règles dérogatoires.
@item staffgroup-staff-spacing
Il s'agit de la distance entre la dernière portée d'un regroupement et
plusieurs lignes de non-portée (tel @code{Lyrics}) s'insèrent entre les
deux. Cette propriété ne concerne pas la dernière portée d'un système.
Dans le cas où la propriété @code{staff-staff-spacing} d'une portée du
-regroupement a été ajustée au niveau de son @code{VerticalAxisGroup},
-cette dernière aura préséance. Voir aussi la propriété
-@code{default-staff-staff-spacing}.
+regroupement a été ajustée au niveau de son propre
+@code{VerticalAxisGroup}, cette dernière aura préséance.
@end table
-
@seealso
Fichiers d'initialisation :
@file{ly/engraver-init.ly},
une portée.
L'espacement de ces @i{portées isolées} est géré par les propriétés
-suivantes@tie{}:
+suivantes :
@itemize
@item Propriétés du @code{VerticalAxisGroup} :
@itemize
+@item @code{default-staff-staff-spacing}
@item @code{staff-staff-spacing}
@end itemize
@end itemize
@ref{Espacement de portées regroupées}.
L'exemple suivant illustre la manière de gérer l'espacement de portées
-isolées à l'aide de la propriété @code{staff-staff-spacing}@tie{}:
+isolées à l'aide de la propriété @code{default-staff-staff-spacing}.
+Les mêmes règles appliquées de manière dérogatoire au
+@code{staff-staff-spacing} produiront les mêmes effets, y compris au
+sein de regroupements.
@lilypond[verbatim,quote,staffsize=16]
\layout {
\context {
\Staff
- \override VerticalAxisGroup #'staff-staff-spacing =
- #'((padding . 1)
- (space . 8)
- (minimum-distance . 7))
+ \override VerticalAxisGroup.default-staff-staff-spacing =
+ #'((basic-distance . 8)
+ (minimum-distance . 7)
+ (padding . 1))
}
}
-\new StaffGroup <<
- % The very low note here needs more room than 'space can
- % provide, so the distance between this staff and the next is
- % determined by 'padding.
+<<
+ % The very low note here needs more room than 'basic-distance
+ % can provide, so the distance between this staff and the next
+ % is determined by 'padding.
\new Staff { b,2 r | }
- % Here, 'space provides enough room, and there is no need to
- % compress the space (towards 'minimum-distance) to make room
- % for anything else on the page, so the distance between this
- % staff and the next is determined by 'space.
+ % Here, 'basic-distance provides enough room, and there is no
+ % need to compress the space (towards 'minimum-distance) to make
+ % room for anything else on the page, so the distance between
+ % this staff and the next is determined by 'basic-distance.
\new Staff { \clef bass g2 r | }
% By setting 'padding to a negative value, staves can be made to
- % collide. The lowest acceptable value for 'space is 0.
+ % collide. The lowest acceptable value for 'basic-distance is 0.
\new Staff \with {
- \override VerticalAxisGroup #'staff-staff-spacing =
- #'((padding . -10)
- (space . 3.5))
+ \override VerticalAxisGroup.default-staff-staff-spacing =
+ #'((basic-distance . 3.5)
+ (padding . -10))
} { \clef bass g2 r | }
\new Staff { \clef bass g2 r | }
>>
@end lilypond
-
@seealso
Fichiers d'initialisation :
@file{scm/define-grobs.scm}.
important entre deux regroupements qu'entre les portées d'un même
groupe.
-Les @i{regroupement de portées} tels le @code{StaffGroup} ou le
+Les @i{regroupements de portées} tels le @code{StaffGroup} ou le
@code{ChoirStaff} sont des contextes qui peuvent contenir simultanément
une ou plusieurs portées.
L'espacement entre les portées d'un même regroupement est géré par les
-propriétés suivantes@tie{}:
+propriétés suivantes :
@itemize
@item Propriétés du @code{VerticalAxisGroup} :
@itemize
@item @code{staff-staff-spacing}
-@item @code{default-staff-staff-spacing}
@end itemize
@item Propriétés du @code{StaffGrouper} :
@itemize
@ref{Propriétés d'espacement au sein d'un système}.
L'exemple suivant illustre la manière de gérer l'espacement de portées
-regroupes, à l'aide des propriétés de l'objet graphique
-@code{StaffGrouper}@tie{}:
+regroupées, à l'aide des propriétés de l'objet graphique
+@code{StaffGrouper} :
@lilypond[verbatim,quote,staffsize=16]
\layout {
\context {
\Score
- \override StaffGrouper #'staff-staff-spacing #'padding = #0
- \override StaffGrouper #'staff-staff-spacing #'space = #1
+ \override StaffGrouper.staff-staff-spacing.padding = #0
+ \override StaffGrouper.staff-staff-spacing.basic-distance = #1
}
}
<<
\new PianoStaff \with {
- \override StaffGrouper #'staffgroup-staff-spacing #'space = #20
+ \override StaffGrouper.staffgroup-staff-spacing.basic-distance = #20
} <<
\new Staff { c'1 }
\new Staff { c'1 }
@rinternals{VerticalAxisGroup},
@rinternals{StaffGrouper}.
+
@node Espacement des lignes rattachées à des portées
@unnumberedsubsubsec Espacement des lignes rattachées à des portées
@translationof Spacing of non-staff lines
objet de rendu @code{VerticalAxisGroup}.
L'espacement des lignes de non-portée est géré par les propriétés
-suivantes@tie{}:
+suivantes :
@itemize
@item Propriétés du @code{VerticalAxisGroup} :
\layout {
\context {
\Lyrics
- \override VerticalAxisGroup
- #'nonstaff-nonstaff-spacing #'stretchability = #1000
+ \override VerticalAxisGroup.nonstaff-nonstaff-spacing.stretchability = #1000
}
}
\new StaffGroup
<<
\new Staff \with {
- \override VerticalAxisGroup #'staff-staff-spacing = #'((space . 30))
+ \override VerticalAxisGroup.staff-staff-spacing = #'((basic-distance . 30))
} { c'1 }
\new Lyrics \with {
- \override VerticalAxisGroup #'staff-affinity = #UP
+ \override VerticalAxisGroup.staff-affinity = #UP
} \lyricmode { up }
\new Lyrics \with {
- \override VerticalAxisGroup #'staff-affinity = #CENTER
+ \override VerticalAxisGroup.staff-affinity = #CENTER
} \lyricmode { center }
\new Lyrics \with {
- \override VerticalAxisGroup #'staff-affinity = #DOWN
+ \override VerticalAxisGroup.staff-affinity = #DOWN
} \lyricmode { down }
\new Staff { c'1 }
>>
@end lilypond
-
@seealso
Fichiers d'initialisation :
@file{ly/engraver-init.ly},
positionnement vertical absolu sur la page.
@code{NonMusicalPaperColumn #'line-break-system-details} prend en charge
-une liste associative de trois mises au point@tie{}:
+une liste associative de trois mises au point :
@itemize
@item @code{X-offset}
Les dérogations en matière d'objet graphique, y compris celles
concernant les @code{NonMusicalPaperColumn} ci-dessus, peuvent se placer
-à trois différents endroits de votre fichier source@tie{}:
+à trois différents endroits de votre fichier source :
@itemize
@item directement au beau milieu des notes
@code{\with}. Dans le cas ou il est stipulé au fil des notes, c'est la
commande spécifique @code{\overrideProperty} qui doit intervenir. Voici
quelques exemples de réglages de @code{NonMusicalPaperColumn} à l'aide
-de la commande @code{\overrideProperty}@tie{}:
+de la commande @code{\overrideProperty} :
@example
-\overrideProperty NonMusicalPaperColumn
- #'line-break-system-details #'((X-offset . 20))
+\overrideProperty NonMusicalPaperColumn.line-break-system-details #'((X-offset . 20))
-\overrideProperty NonMusicalPaperColumn
- #'line-break-system-details #'((Y-offset . 40))
+\overrideProperty NonMusicalPaperColumn.line-break-system-details #'((Y-offset . 40))
-\overrideProperty NonMusicalPaperColumn
- #'line-break-system-details #'((X-offset . 20) (Y-offset . 40))
+\overrideProperty NonMusicalPaperColumn.line-break-system-details #'((X-offset . 20)
+ (Y-offset . 40))
-\overrideProperty NonMusicalPaperColumn
- #'line-break-system-details #'((alignment-distances . (15)))
+\overrideProperty NonMusicalPaperColumn.line-break-system-details #'((alignment-distances . (15)))
-\overrideProperty NonMusicalPaperColumn
- #'line-break-system-details #'((X-offset . 20) (Y-offset . 40)
+\overrideProperty NonMusicalPaperColumn.line-break-system-details #'((X-offset . 20)
+ (Y-offset . 40)
(alignment-distances . (15)))
@end example
@c \book { } is required in these examples to ensure the spacing
@c overrides can be seen between systems. -np
-@lilypond[quote]
+@lilypond[verbatim,quote,staffsize=16]
\header { tagline = ##f }
\paper { left-margin = 0\mm }
\book {
Cette partition isole les informations de saut de ligne ou de page dans
une voix spécifique. La mise en forme est ainsi séparée des événements
-musicaux@tie{}; ceci nous permettra d'y voir plus clair au fur et à
+musicaux ; ceci nous permettra d'y voir plus clair au fur et à
mesure que nous avancerons. Pour plus de précisions, relisez
@ref{Recours à une voix supplémentaire pour gérer les sauts}.
-Les @code{\breaks} explicites répartissent la musique en lignes de cinq
+Les @code{\break} explicites répartissent la musique en lignes de cinq
mesures chacune. L'espacement vertical est celui que LilyPond attribue
par défaut. Nous pouvons, afin de fixer explicitement le point
d'attache vertical de chacun des systèmes, définir un doublet
@code{Y-offset} en tant qu'attribut du @code{line-break-system-details}
-de l'objet @code{NonMusicalPaperColumn}@tie{}:
+de l'objet @code{NonMusicalPaperColumn} :
-@lilypond[quote]
+@lilypond[verbatim,quote,staffsize=16]
\header { tagline = ##f }
\paper { left-margin = 0\mm }
\book {
<<
\new Staff <<
\new Voice {
- \overrideProperty #"Score.NonMusicalPaperColumn"
- #'line-break-system-details #'((Y-offset . 0))
+ \overrideProperty Score.NonMusicalPaperColumn.line-break-system-details #'((Y-offset . 0))
s1*5 \break
- \overrideProperty #"Score.NonMusicalPaperColumn"
- #'line-break-system-details #'((Y-offset . 40))
+ \overrideProperty Score.NonMusicalPaperColumn.line-break-system-details #'((Y-offset . 40))
s1*5 \break
- \overrideProperty #"Score.NonMusicalPaperColumn"
- #'line-break-system-details #'((Y-offset . 80))
+ \overrideProperty Score.NonMusicalPaperColumn.line-break-system-details #'((Y-offset . 80))
s1*5 \break
}
\new Voice { \repeat unfold 15 { c'4 c' c' c' } }
à la sous-propriété @code{alignment-distances} de
@code{line-break-system-details}.
-@lilypond[quote]
+@lilypond[verbatim,quote,staffsize=16]
\header { tagline = ##f }
\paper { left-margin = 0\mm }
\book {
<<
\new Staff <<
\new Voice {
- \overrideProperty #"Score.NonMusicalPaperColumn"
- #'line-break-system-details #'((Y-offset . 20)
+ \overrideProperty Score.NonMusicalPaperColumn.line-break-system-details #'((Y-offset . 20)
(alignment-distances . (15)))
s1*5 \break
- \overrideProperty #"Score.NonMusicalPaperColumn"
- #'line-break-system-details #'((Y-offset . 60)
+ \overrideProperty Score.NonMusicalPaperColumn.line-break-system-details #'((Y-offset . 60)
(alignment-distances . (15)))
s1*5 \break
- \overrideProperty #"Score.NonMusicalPaperColumn"
- #'line-break-system-details #'((Y-offset . 100)
+ \overrideProperty Score.NonMusicalPaperColumn.line-break-system-details #'((Y-offset . 100)
(alignment-distances . (15)))
s1*5 \break
}
@code{alignment-distances} traite le positionnement des portées, non
d'un regroupement de portées.
-@lilypond[quote]
+@lilypond[verbatim,quote,staffsize=16]
\header { tagline = ##f }
\paper { left-margin = 0\mm }
\book {
<<
\new Staff <<
\new Voice {
- \overrideProperty #"Score.NonMusicalPaperColumn"
- #'line-break-system-details #'((Y-offset . 0)
+ \overrideProperty Score.NonMusicalPaperColumn.line-break-system-details #'((Y-offset . 0)
(alignment-distances . (30 10)))
s1*5 \break
- \overrideProperty #"Score.NonMusicalPaperColumn"
- #'line-break-system-details #'((Y-offset . 60)
+ \overrideProperty Score.NonMusicalPaperColumn.line-break-system-details #'((Y-offset . 60)
(alignment-distances . (10 10)))
s1*5 \break
- \overrideProperty #"Score.NonMusicalPaperColumn"
- #'line-break-system-details #'((Y-offset . 100)
+ \overrideProperty Score.NonMusicalPaperColumn.line-break-system-details #'((Y-offset . 100)
(alignment-distances . (10 30)))
s1*5 \break
}
}
@end lilypond
-Quelques points à prendre en considération@tie{}:
+Quelques points à prendre en considération :
@itemize
@item
les portées et paroles, des valeurs négatives les descendent.
@item
-Dans la mesure où @code{NonMusicalPaperColumn
-#'line-break-system-details} permet de positionner systèmes et portées
-n'importe où sur une page, vous pourriez être en contradiction avec les
-dimensionnements de la feuille ou bien aboutir à des surimpressions.
-Soyez donc raisonnables quant aux différentes valeurs que vous affectez
-à ces réglages.
+Dans la mesure où @code{NonMusicalPaperColumn #'line-break-system-details}
+permet de positionner systèmes et portées n'importe où sur une page,
+vous pourriez être en contradiction avec les dimensionnements de la
+feuille ou bien aboutir à des surimpressions. Soyez donc raisonnable
+quant aux différentes valeurs que vous affectez à ces réglages.
@end itemize
-
@seealso
Morceaux choisis :
@rlsrnamed{Spacing,Espacements}.
matière de notation musicale appartiennent à la portée, et que
d'autres se placent en dehors de la portée. Entre autres objets
externes, nous avons les marques repères, les textes et les
-nuances@tie{}; nous les appellerons @qq{objets extérieurs à la portée}.
-La règle qu'applique LilyPond pour positionner verticalement ces
+nuances ; nous les appellerons @qq{objets extérieurs à la portée}.
+La règle adoptée par LilyPond pour positionner verticalement ces
objets extérieurs consiste à les placer au plus près de la portée
tout en prenant garde d'éviter qu'il y ait chevauchement.
LilyPond utilise la propriété @code{outside-staff-priority} afin de
-déterminer si un objet est ou non un objet extérieur à la portée@tie{}:
+déterminer si un objet est ou non un objet extérieur à la portée :
lorsque la valeur de @code{outside-staff-priority} est numérique, il
s'agit d'un objet extérieur à la portée. De plus, la propriété
@code{outside-staff-priority} indique à LilyPond l'ordre dans lequel ces
@lilypond[quote,ragged-right,relative=2,verbatim]
c4_"Text"\pp
r2.
-\once \override TextScript #'outside-staff-priority = #1
+\once \override TextScript.outside-staff-priority = #1
c4_"Text"\pp % this time the text will be closer to the staff
r2.
% by setting outside-staff-priority to a non-number,
% we disable the automatic collision avoidance
-\once \override TextScript #'outside-staff-priority = ##f
-\once \override DynamicLineSpanner #'outside-staff-priority = ##f
+\once \override TextScript.outside-staff-priority = ##f
+\once \override DynamicLineSpanner.outside-staff-priority = ##f
c4_"Text"\pp % now they will collide
@end lilypond
le précède se contrôle par la propriété @code{outside-staff-padding}.
@c KEEP LY
-@lilypond[quote,ragged-right,relative=2,verbatim]
-\once \override TextScript #'outside-staff-padding = #0
+@lilypond[quote,ragged-right,relative=2,verbatim,staffsize=18]
+\once \override TextScript.outside-staff-padding = #0
a'^"Ce texte est placé au plus près de la note"
-\once \override TextScript #'outside-staff-padding = #3
+\once \override TextScript.outside-staff-padding = #3
c^"Ce texte est décalé par rapport au texte précédent"
c^"Ce texte est accolé au texte précédent"
@end lilypond
c''2
% setting outside-staff-horizontal-padding fixes this
R1
-\once \override TextScript #'outside-staff-horizontal-padding = #1
+\once \override TextScript.outside-staff-horizontal-padding = #1
c,,4^"Text"
c4
c''2
@end lilypond
-
@seealso
Morceaux choisis :
@rlsrnamed{Spacing,Espacements}.
* Notation proportionnelle::
@end menu
+
@node Généralités sur l'espacement horizontal
@subsection Généralités sur l'espacement horizontal
@translationof Horizontal spacing overview
Le moteur d'espacement traduit les différences de durée en distances
-étirables (@emph{springs} pour ressorts) de différente longueur. Des
+étirables (@emph{springs} pour ressorts) de différentes longueurs. Des
durées importantes prennent ainsi plus de place que des durées moins
longues. Les durées les plus courtes se verront attribuer un espace
fixe, contrôlé par la propriété @code{shortest-duration-space} de
l'objet @rinternals{SpacingSpanner}. Au plus la durée s'allonge, au
-plus elle prendra d'espace@tie{}: le doublement d'une durée attribuera à
+plus elle prendra d'espace : le doublement d'une durée attribuera à
la note un espace fixé d'après la propriété @code{spacing-increment}.
L'exemple suivant comporte des blanches, des noires et un certain nombre
de croches. La croche est suivie d'un espace de la largeur d'une tête
-de note@tie{}; pour la noire , cette espace est de deux têtes@tie{}; il
+de note ; pour la noire , cet espace est de deux têtes ; il
est de trois pour la blanche.
@lilypond[quote,verbatim,relative=1]
c8 c4 c4 c4
@end lilypond
-@code{spacing-increment} est normalement défini à 1,2@tie{}espace de
+@code{spacing-increment} est normalement défini à 1,2 espace de
portée -- ce qui correspond à peu près à la largeur d'une tête de note
--- et @code{shortest-duration-space} à 2,0. La note la plus courte
-s'étendra donc sur l'équivalent de 2,4@tie{}espaces de portée (2 fois le
+-- et @code{shortest-duration-space} à 2,0. La note la plus courte
+s'étendra donc sur l'équivalent de 2,4 espaces de portée (2 fois le
@code{spacing-increment}). Le point de départ de cet espace se situe à
-l'extrémité gauche du symbole@tie{}; la note la plus courte est donc
+l'extrémité gauche du symbole ; la note la plus courte est donc
suivie en général d'un espace égal à la largeur d'une tête de note.
Si l'on suit à la lettre ce qui précède, ajouter une simple triple
croche à une partition qui comporte déjà des croches et des doubles
-augmentera considérablement son volume@tie{}: la durée la plus
+augmentera considérablement son volume : la durée la plus
courte n'est plus la double mais la triple croche, ce qui aura
pour conséquence d'ajouter une largeur de tête à chacune des notes.
Pour s'affranchir de cet effet quelque peu pervers, la durée la plus
l'espacement, à cette nuance près que la plus courte durée ne saurait
être strictement supérieure à la croche. Cette @qq{durée de référence}
est d'ailleurs affichée lorsque vous lancez @code{lilypond} avec l'option
-@code{--verbose}.
+@option{--verbose}.
Ces durées peuvent être adaptées. Vous pouvez définir la durée de base
pour les espacements grâce à la propriété
Les notes plus courtes que la note témoin sont suivies d'un espace
proportionnel à la durée témoin. Si donc nous ajoutions quelques
doubles croches à l'exemple précédent, elles seraient suivies d'une
-demie largeur de tête@tie{}:
+demie largeur de tête :
@lilypond[quote,verbatim,relative=2]
c2 c4. c8 c4. c16[ c] c4. c8 c8 c8 c4 c4 c4
@end lilypond
-
Dans notre @emph{Essai sur la gravure musicale automatisée}, nous avons
vu comment la direction des hampes peut influencer l'espacement -- voir
@ressay{Espacement}. Ceci est contrôlé par la propriété
{
c'4 e''4 e'4 b'4 |
b'4 e''4 b'4 e''4 |
- \override Staff.NoteSpacing #'stem-spacing-correction = #1.5
- \override Staff.StaffSpacing #'stem-spacing-correction = #1.5
+ \override Staff.NoteSpacing.stem-spacing-correction = #1.5
+ \override Staff.StaffSpacing.stem-spacing-correction = #1.5
c'4 e''4 e'4 b'4 |
b'4 e''4 b'4 e''4 |
}
L'espacement spécifique à la notation proportionnelle fait l'objet d'une
@rusernamed{Notation proportionnelle,rubrique dédiée}.
-
@seealso
Morceaux choisis :
@rlsrnamed{Spacing,Espacements}.
+Essai sur la gravure musicale automatisée :
+@ressay{Espacement}.
+
Référence des propriétés internes :
@rinternals{SpacingSpanner},
@rinternals{NoteSpacing},
@rinternals{StaffSpacing},
@rinternals{NonMusicalPaperColumn}.
-
@knownissues
-
-Il n'existe pas de mécanisme simple simple et efficace qui permette de
+Il n'existe pas de mécanisme simple et efficace qui permette de
forcer manuellement l'espacement. La solution ci-dessous permet
-cependant @qq{d'aérer} artificiellement une partition@tie{}; il vous
+cependant @qq{d'aérer} artificiellement une partition ; il vous
suffit d'ajuster la valeur du décalage @emph{(padding)} autant que de
besoin.
@example
- \override Score.NonMusicalPaperColumn #'padding = #10
+ \override Score.NonMusicalPaperColumn.padding = #10
@end example
Il n'y a aucun moyen de diminuer l'espacement.
paramètres d'espacement.
Dans l'exemple qui suit, le changement de métrique marque le début
-d'une nouvelle partie@tie{}; remarquez comme les doubles-croches sont
-alors plus espacées@tie{}:
+d'une nouvelle partie ; remarquez comme les doubles-croches sont
+alors plus espacées :
@lilypond[relative,verbatim,quote]
\time 2/4
@code{SpacingSpanner}, ce qui permet d'appliquer de nouveaux
@code{\override}s à partir de ce point.
-
@seealso
Morceaux choisis :
@rlsrnamed{Spacing,Espacements}.
Vous pouvez influencer l'espacement horizontal à l'aide de la propriété
@code{base-shortest-duration}. Comparons les deux partitions qui
suivent, toutes deux montrant la même musique. La première partition
-applique les réglages par défaut, alors que la seconde bénéficie
-d'ajustement de la propriété @code{base-shortest-duration}. Au plus la
+applique les réglages par défaut, alors que la seconde bénéficie d'un
+ajustement de la propriété @code{base-shortest-duration}. Au plus la
valeur de @code{ly:make-moment} est grande, au plus la musique sera
-resserrée. En effet, @code{ly:make-moment} construit une durée@tie{}:
-@w{@code{1 4}} est plus long que @w{@code{1 16}}.
+resserrée. En effet, @code{ly:make-moment} construit une durée :
+@code{1 4} est plus long que @code{1 16}.
@lilypond[verbatim,line-width=12\cm]
\score {
\layout {
\context {
\Score
- \override SpacingSpanner
- #'base-shortest-duration = #(ly:make-moment 1 16)
+ \override SpacingSpanner.base-shortest-duration = #(ly:make-moment 1 16)
}
}
}
@end lilypond
-
@snippets
-
L'espacement au sein d'un nolet dépend par défaut d'un certain nombre de
facteurs qui ne sont pas liés à la durée (altération, changement de
-clef, etc.). @w{@code{Score.SpacingSpanner #'uniform-stretching}}
+clef, etc.). @w{@code{Score.SpacingSpanner #'uniform-stretching}}
permet d'ignorer ces symboles et, par voie de conséquence, forcer
l'espacement sur la simple durée. Notez bien que cette propriété
s'appliquera à toute la partition, puisque mentionnée au sein d'un bloc
\layout {
\context {
\Score
- \override SpacingSpanner #'uniform-stretching = ##t
+ \override SpacingSpanner.uniform-stretching = ##t
}
}
}
L'activation du commutateur @code{strict-note-spacing} permet d'espacer
les notes sans tenir compte des clefs, barres de mesure ou notes
-d'ornement qui pourraient apparaître@tie{}:
+d'ornement qui pourraient apparaître :
@lilypond[quote,ragged-right,relative=2,verbatim]
-\override Score.SpacingSpanner #'strict-note-spacing = ##t
+\override Score.SpacingSpanner.strict-note-spacing = ##t
\new Staff { c8[ c \clef alto c \grace { c16[ c] } c8 c c] c32[ c32] }
@end lilypond
-
@seealso
Morceaux choisis :
@rlsrnamed{Spacing,Espacements}.
@cindex saut de page
@cindex pages, saut
+@cindex ligne, longueur
@funindex indent
@funindex line-width
@c Bit verbose and vague, use examples?
Deux réglages de bases ont une influence considérable sur
-l'espacement@tie{}: @code{line-width} et @code{indent}. Tous deux se
+l'espacement : @code{line-width} et @code{indent}. Tous deux se
placent dans le bloc @code{\layout}. Ils contrôleront la longueur des
lignes et l'indentation de la première.
L'activation du commutateur @code{ragged-right} au sein du bloc
@code{\layout} permet de terminer les systèmes naturellement plutôt que
de les voir s'étirer sur toute la largeur de la page. Cette option est
-particulièrement utile lorsque vous traitez de courts fragment, ou bien
+particulièrement utile lorsque vous traitez de courts fragments, ou bien
pour vérifier ce que donnerait l'espacement naturel. Bien qu'il soit
désactivé par défaut, il sera activé si la partition ne comporte qu'un
seul système.
-@cindex page layout
-@cindex vertical spacing
+@cindex page, mise en forme
+@cindex vertical, espacement
Le fonctionnement de l'option @code{ragged-last} est en tout point
identique à celui de @code{ragged-right}, à ceci près qu'il ne concerne
@}
@end example
-
@seealso
Morceaux choisis :
@rlsrnamed{Spacing,Espacements}.
@item @code{strict-note-spacing}
-@item @code{\remove Separating_line_group_engraver}
+@item @code{\remove "Separating_line_group_engraver"}
-@item @code{\override PaperColumn #'used = ##t}
+@item @code{\override PaperColumn.used = ##t}
@end itemize
En matière de gravure traditionnelle, cet espacement correspond tout à
fait à nos attentes, puisque nous pouvons rogner l'espace sur la
-blanche et ainsi en gagner en largeur sur toute la mesure qui fait une
+blanche et ainsi gagner en largeur sur toute la mesure qui fait une
ronde.
Par contre, si nous avons besoin d'insérer une indication temporelle ou
un autre graphisme en surplomb ou en dessous de notre partition, nous
-aurons besoin de la notation proportionnelle. Celle-ci s'active an
+aurons besoin de la notation proportionnelle. Celle-ci s'active en
définissant la propriété @code{proportionalNotationDuration}.
@lilypond[quote,verbatim,ragged-right]
Nous pourrions donc y insérer, au-dessus ou au-dessous, une indication
temporelle ou autre graphisme.
-
@code{proportionalNotationDuration} est une propriété attachée au
contexte @code{Score}. Rappelez-vous que vous pouvez régler les
propriétés d'un contexte à trois différents endroits de votre
-fichier@tie{}: dans un bloc @code{\with}, dans un bloc @code{\context}
+fichier : dans un bloc @code{\with}, dans un bloc @code{\context}
ou au beau milieu de la musique à l'aide de la commande @code{\set}.
Vous pouvez donc définir @code{proportionalNotationDuration} selon l'une
-de ces trois façons, à l'instar de n'importe quel définition de
+de ces trois façons, à l'instar de n'importe quelle définition de
contexte.
La propriété @code{proportionalNotationDuration} prend en unique
argument la durée de référence qui servira de base pour espacer toute la
-musique. La fonction scheme @code{make-moment} intégrée à LilyPond
-prend deux arguments@tie{}: un numérateur et un dénominateur qui
+musique. La fonction Scheme @code{make-moment} intégrée à LilyPond
+prend deux arguments : un numérateur et un dénominateur qui
représentent une fraction de ronde. L'appel de
-@w{@code{#(ly:make-moment 1 20)}} produit donc une durée de référence
+@w{@code{(ly:make-moment 1 20)}} produit donc une durée de référence
égale à un vingtième de ronde. Vous pourriez tout aussi bien utiliser
-@code{#(ly:make-moment 1 16)}, @code{#(ly:make-moment 1 8)} ou
-@code{#(ly:make-moment 3 97)}.
+@code{(ly:make-moment 1 16)}, @code{(ly:make-moment 1 8)} ou
+@code{(ly:make-moment 3 97)}.
Se pose alors le problème de fournir la juste durée de référence à
@code{proportionalNotationDuration}. Il faut en l'occurrence procéder par
tâtonnement, en commençant par une valeur proche de la note la plus
rapide (la durée la plus courte) du morceau. Au plus la durée de
-référence est petite, au plus la musique sera étalée@tie{}; à l'inverse,
+référence est petite, au plus la musique sera étalée ; à l'inverse,
une durée de référence élevée produira une musique resserrée.
@lilypond[quote,verbatim,ragged-right]
Vous ne manquerez pas de noter qu'une durée de référence trop grande,
comme la croche pour la première ligne, a pour conséquence de resserrer
la musique, ce qui peut aboutir à des chevauchements de têtes. Vous
-remarquez aussi que , par principe, la notation proportionnelle occupe
+remarquez aussi que, par principe, la notation proportionnelle occupe
beaucoup plus d'espace horizontal que l'espacement traditionnel. La
notation proportionnelle met en évidence le rythme au détriment de
l'espacement horizontal.
\context {
\Score
proportionalNotationDuration = #(ly:make-moment 1 20)
- \override SpacingSpanner #'uniform-stretching = ##t
+ \override SpacingSpanner.uniform-stretching = ##t
}
}
}
au contexte @code{Score}. Tout comme pour la propriété
@code{proportionalNotationDuration}, les réglages du
@code{SpacingSpanner} peuvent se faire à trois différents endroits de
-votre fichier@tie{}: dans un bloc @code{\with}, dans un bloc
+votre fichier : dans un bloc @code{\with}, dans un bloc
@code{\context} ou au beau milieu de la musique à l'aide de la
commande @code{\set}.
@code{\newSpacingSection} -- pour de plus amples détails, voir la
rubrique @ref{Changement d'espacement en cours de partition}.
-
Intéressons-nous maintenant au @code{Separating_line_group_engraver},
qui est désactivé pour la plupart des partitions en notation
proportionnelle. Voici ce qui apparaît dans une partition
-traditionnelle@tie{}: il y a toujours un @qq{espace préservé} juste
+traditionnelle : il y a toujours un @qq{espace préservé} juste
avant la première note de chaque portée.
@lilypond[quote,verbatim,ragged-right]
}
\new Staff \with {
- \remove Separating_line_group_engraver
+ \remove "Separating_line_group_engraver"
} {
c'1
\break
@qq{consomment} de l'espace. Différentes approches permettent
cependant de gérer ce problème.
-Éviter les problèmes d'espacement avec l'armure est chose aisée@tie{}:
-il suffit qu'il n'y en ait pas@tie{}! C'est bien souvent le cas en
+Éviter les problèmes d'espacement avec l'armure est chose aisée :
+il suffit qu'il n'y en ait pas ! C'est bien souvent le cas en
musique contemporaine, où l'on trouve le plus d'ouvrages en notation
proportionnelle. Il en va de même pour la métrique, et tout
particulièrement lorsque la partition comporte un quadrillage temporel
L'une des options permettant de s'affranchir de l'espacement dû aux
éléments non musicaux consiste en l'activation de la propriété
@code{strict-note-spacing} attachée au @code{SpacingSpanner}. Observons
-les deux portées suivantes@tie{}:
+les deux portées suivantes :
@lilypond[quote,verbatim,ragged-right]
\new Staff {
\new Staff {
\set Score.proportionalNotationDuration = #(ly:make-moment 1 16)
- \override Score.SpacingSpanner #'strict-note-spacing = ##t
+ \override Score.SpacingSpanner.strict-note-spacing = ##t
c''8
c''8
c''8
conséquence que l'algorithme d'espacement ignore tout bonnement la
largeur des métriques, armures, clefs et altérations.
-En plus ceux que nous venons de voir, vous trouverez d'autres réglages
-en usage dans la notation proportionnelle comme, entre autres,
+En plus de ceux que nous venons de voir, vous trouverez d'autres
+réglages en usage dans la notation proportionnelle comme, entre autres,
@itemize
-@item @code{\override SpacingSpanner #'strict-grace-spacing = ##t}
+@item @code{\override SpacingSpanner.strict-grace-spacing = ##t}
@item @code{tupletFullLength = ##t}
-@item @code{\override Beam #'breakable = ##t}
-@item @code{\override Glissando #'breakable = ##t}
-@item @code{\override TextSpanner #'breakable = ##t}
-@item @code{\remove Forbid_line_break_engraver (dans un contexte de voix}
+@item @code{\override Beam.breakable = ##t}
+@item @code{\override Glissando.breakable = ##t}
+@item @code{\override TextSpanner.breakable = ##t}
+@item @code{\remove "Forbid_line_break_engraver"} (dans un contexte de voix)
@end itemize
Ces différents réglages permettent un espacement strict des notes
l'occasion d'un saut de ligne ou de page. Nous vous renvoyons aux
différentes rubriques associées du manuel pour chacun de ces réglages.
-
@seealso
Manuel de notation :
@ref{Changement d'espacement en cours de partition}.
@section Réduction du nombre de pages de la partition
@translationof Fitting music onto fewer pages
-Vous pourriez un jour être confronté au problème suiven@tie{}: l'une
+Vous pourriez un jour être confronté au problème suivant : l'une
des pages de votre partition ne comporte que deux portées alors que --
ce qui est d'autant plus frustrant -- l'espace libre sur les autres
pages aurait permis une distribution différente.
L'instruction @code{annotate-spacing} se révèle être un outil
-indispensable pour pour l'analyse des problèmes de mise en forme. Cette
+indispensable pour l'analyse des problèmes de mise en forme. Cette
commande met en surimpression la valeur des différentes variables
d'espacement et de mise en forme, comme nous allons le voir dans la
rubrique @ref{Mise en évidence de l'espacement}.
* Modification de l'espacement::
@end menu
+
@node Mise en évidence de l'espacement
@subsection Mise en évidence de l'espacement
@translationof Displaying spacing
Le meilleur moyen d'appréhender les différentes variables de
dimensionnement vertical sur lesquelles vous pouvez jouer au niveau de
-la mise en page, consiste à activer, au sein du bloc @code{\paper}, la
-fonction @code{annotate-spacing}@tie{}:
+la mise en page consiste à activer, au sein du bloc @code{\paper}, la
+fonction @code{annotate-spacing} :
@c need to have \book{} otherwise we get the separate systems. -hwn
@lilypond[verbatim,quote]
Toutes les dimensions sont exprimées en espace de portée
@emph{(staff-space)} quelle que soit l'unité mentionnée dans les blocs
@code{\paper} ou @code{\layout}. Dans cet exemple, la hauteur de la
-feuille (@code{paper-height}) est de 59,75@tie{}espaces de portée
+feuille (@code{paper-height}) est de 59,75 espaces de portée
(@code{staff-spaces}) et la taille de portée (@code{staff-size}) de
-20@tie{}points -- sa valeur par défaut. Notez que@tie{}:
+20 points -- sa valeur par défaut. Notez que :
@multitable {1 staff-space} {staff-size)/4 * (25,4/72,27) mm}
@noindent
Dans le cas qui nous occupe, un @code{staff-space} égale environ
-1,757@tie{}millimètres. Les 59,75@tie{}@code{staff-spaces} de
-@code{paper-height} correspondent donc à 105@tie{}millimètres, soit la
+1,757 millimètres. Les 59,75 @code{staff-spaces} de
+@code{paper-height} correspondent donc à 105 millimètres, soit la
hauteur d'une feuille au format A6 à l'italienne. Les paires
@code{(@var{a},@var{b})} sont des intervalles, @var{a} en étant
l'extrémité inférieure et @var{b} l'extrémité supérieure.
-
@seealso
Manuel de notation :
@ref{Définition de la taille de portée}.
la rubrique @ref{Mise en forme de la page}.
En dehors des marges, vous disposez de quelques moyens supplémentaires
-pour gagner de l'espace@tie{}:
+pour gagner de l'espace :
@itemize
@item
@example
\paper @{
- system-system-spacing = #'((padding . 0) (space . 0.1))
+ system-system-spacing = #'((basic-distance . 0.1) (padding . 0))
ragged-last-bottom = ##f
ragged-bottom = ##f
@}
systèmes par page dans la mesure où l'une des étapes d'estimation des
hauteurs est tout simplement sautée. D'autre part, réduire le nombre de
systèmes par page permet d'en disposer plus sur les suivantes. Par
-exemple, avec un nombre par défaut de 11@tie{}systèmes par pages,
-l'instruction suivante le force à 10.
+exemple, avec un nombre par défaut de 11 systèmes par pages,
+l'instruction suivante le force à 10.
@example
\paper @{
@}
@end example
+@item
+Forcer le nombre de pages. L'instruction suivante forcera la musique à
+se répartir sur deux pages.
+
+@example
+\paper @{
+ page-count = #2
+@}
+@end example
+
@item
Éviter ou réduire les objets qui augmentent la hauteur des systèmes.
Par exemple, un crochet de reprise ou d'alternative consomme de
l'espace. Le fait de les reporter sur plusieurs systèmes regroupés
diminue d'autant l'espace disponible que si seul le premier ne
comportait l'indication. Autre exemple, les indications de nuance qui
-se @qq{détachent} d'un système peuvent être rapprochés de la portée@tie{}:
+se @qq{détachent} d'un système peuvent être rapprochés de la portée :
@lilypond[verbatim,quote,relative=1]
e4 c g\f c
-e4 c g-\tweak #'X-offset #-2.7 -\tweak #'Y-offset #2.5 \f c
+e4 c g-\tweak X-offset #-2.7 -\tweak Y-offset #2.5 \f c
@end lilypond
@item
Modifier l'espacement horizontal à l'aide du @code{SpacingSpanner},
comme indiqué à la rubrique
@ref{Modification de l'espacement horizontal}. Voici ce que donne
-l'espacement par défaut@tie{}:
+l'espacement par défaut :
@lilypond[verbatim,quote]
\score {
Par contre, le fait de modifier la valeur de la propriété
@code{common-shortest-duration} en passant de @code{1/4} à @code{1/2}
-- bien que la noire soit la durée la plus courante, nous prenons une
-valeur plus longue -- donnera un effet @qq{resserré} à la musique@tie{}:
+valeur plus longue -- donnera un effet @qq{resserré} à la musique :
@lilypond[verbatim,quote]
\score {
\layout {
\context {
\Score
- \override SpacingSpanner
- #'common-shortest-duration = #(ly:make-moment 1 2)
+ \override SpacingSpanner.common-shortest-duration = #(ly:make-moment 1 2)
}
}
}
@end itemize
-
@seealso
Manuel de notation :
@ref{Mise en forme de la page},
Morceaux choisis :
@rlsrnamed{Spacing,Espacements}.
-
-
projects / lilypond.git / blobdiff