Doc-fr: resolve conflicting merge

[lilypond.git] / Documentation / fr / notation / spacing.itely

@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-

@ignore
    Translation of GIT committish: bee18bdf4277224b584f66ca4a0be88881a37c06

    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.36"

@c Translators: Frédéric Chiasson, Jean-Charles Malahieude

@ignore
GDP TODO list

Negative numbers are allowed:
> Are you sure? The following works well
> \paper{
>   first-page-number = -2
> }
> and prints page number -1 on the second page, for example.


In 5.2.1 the @refbugs (line 495 in spacing.itely on master) it
states:

"@code{layout-set-staff-size} does not change the distance between
the
staff lines."

Could we add a sentence:
"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."

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
knowledge to fix this?


Clarify
http://code.google.com/p/lilypond/issues/detail?id=68

@end ignore


@node Gestion de l'espace
@chapter Gestion de l'espace
@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 page
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
base des durées.  Sont alors calculées différentes possibilités de saut
de ligne, chacune se voyant attribuer un @qq{coefficient de laideur},
puis est estimée la hauteur de chaque système.  LilyPond opte enfin pour
la combinaison entre sauts de page et de ligne qui offre la meilleure
occupation de l'espace, tant horizontalement que verticalement.

Les réglages qui influencent la mise en forme peuvent se placer dans
deux blocs différents.  Le bloc @w{@code{\paper @{@dots{}@}}} intervient
en dehors de tout bloc @w{@code{\score @{@dots{}@}}}@tie{}; il contient
les réglages applicables à l'intégralité du document.  Quant au bloc
@w{@code{\layout @{@dots{}@}}}, il se place à l'intérieur d'un bloc
@w{@code{\score @{@dots{}@}}} pour déterminer ce qui le concerne tout
particulièrement.  Dans le cas où il n'y a qu'un seul bloc
@w{@code{\score @{@dots{}@}}}, les deux emplacements donneront le même
effet.  Les commandes indiquées dans ce chapitre sont valables dans tous
les cas.


@menu
* Du papier et des pages::
* Mise en forme de la musique::
* Sauts::
* Espacement vertical::
* Espacement horizontal::
* Réduction du nombre de pages de la partition::
@end menu

@cindex ragged, aligné
@cindex aligné, ragged

@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
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.}


@node Du papier et des pages
@section Du papier et des pages
@translationof Paper and pages

Nous allons examiner ici le bornage -- ce qui détermine l'espace que
pourra occuper la musique sur une feuille.

@menu
* Format du papier::
* Mise en forme de la page::
@end menu

@node Format du papier
@subsection Format du papier
@translationof Paper size

@cindex papier, taille
@cindex page, format

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{}:

@example
#(set-default-paper-size "a4")
@end example

@example
\paper @{
  #(set-paper-size "a4")
@}
@end example

@noindent
@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ïde) 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}.

@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}).}

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.

@cindex orientation
@cindex landscape
@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 à
l'italienne -- ou paysage si vous préférez -- et donc des lignes plus
longues.

@example
#(set-default-paper-size "a6" 'landscape)
@end example

La définition du format de papier influe sur un certain nombre de
variables comme entre autres les marges.  Nous vous invitons à toujours
spécifier, dans le bloc @code{\paper}, le format de page avant toute
autre variable.


@seealso
Fichiers d'initialisation :
@file{scm/@/paper@/.scm}.

Morceaux choisis :
@rlsrnamed{Spacing,Espacements}.


@node Mise en forme de la page
@subsection Mise en forme de la page
@translationof Page formatting

@funindex \paper

Les marges, en-tê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.

@menu
* Dimensionnement vertical::
* Dimensionnement horizontal::
* Autres variables de mise en page::
@end menu


@node Dimensionnement vertical
@unnumberedsubsubsec Dimensionnement vertical
@translationof Vertical dimensions

@subsubheading Hauteurs fixes
@translationof Fixed vertical dimensions

@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.

@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}.

@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}.

@end table


@subsubheading Hauteurs variables
@translationof Flexible vertical dimensions

Il est souvent judicieux d'apporter un peu de flexibilité à l'espacement
entre différents éléments (marges, titres, systèmes ou mouvements), en
dilatation ou compression selon le cas.  Un certain nombre de variables
de type @code{\paper} répertoriées ci-dessous vous permettront d'affiner
ces dimensionnements.

Chacune de ces variables est constituée d'une liste associative à quatre
@i{clés}@tie{}:

@itemize 
@item @code{décalage} (@emph{padding}) -- la grandeur minimale de
@qq{blanc} qui sépare deux éléments.  On peut le voir comme la hauteur
minimale d'un rectangle vide qui devrait s'étendre sur toute la
largueur des deux éléments.

@item @code{espace} (@emph{space}) -- la grandeur d'espace par défaut 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 de la portée la plus proche.  Un
@code{espace} inférieur à @code{décalage} ou @code{distance-minimale}
sera sans effet, dans la mesure où l'espacement résultant ne saurait
être inférieur à @code{décalage} ou @code{distance-minimale}.

@item @code{distance-minimale} (@emph{minimum-distance}) -- l'espacement
minimal entre les points de référence des deux éléments alors qu'il y a
déjà un effet de compression. Une @code{distance-minimale} inférieure à
la valeur du @code{décalage} sera sans effet, dans la mesure où
l'espacement résultant ne saurait être inférieur au @code{décalage}.

@item @code{dilatation} (@emph{stretchability}) -- 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
en tenant compte du coefficient affecté aux autres espacements.
Par exemple, lorsque le coefficient de dilatation d'une dimension est
double de celui d'une autre, elle pourra s'étirer deux fois plus que
cette dernière.  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 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{}; elle est en fait
égale à (@code{space}@tie{}@minus{}@tie{}@code{minimum-distance}).

@end itemize

Lorsque l'impression n'est pas en pleine page -- elle est donc
@emph{ragged bottom} pour les anglophones -- l'élément @code{espace}
n'est pas étiré. Les hauteurs sur une telle page correspondront donc au
maximum de

@itemize 
@item @code{space}, plus
@item @code{minimum-distance} et
@item @code{padding}, augmenté de ce qu'il faut pour éviter les
chevauchements.
@end itemize

Vous pouvez ne jouer que sur une clé d'une variable particulière@tie{}:

@example
\paper @{
  after-title-spacing #'space = #5
@}
@end example

@noindent
ou bien déterminer simultanément plusieurs clés d'une même
variable@tie{}:

@example
\paper @{
  last-bottom-spacing =
    #'((padding . 1)
       (space . 1)
       (minimum-distance . 0)
       (stretchability . 5))
@}
@end example

Le nom des dimmensionnements à 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.
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
@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}).

Voici à présent les différentes variables disponibles@tie{}:

@table @code

@item markup-system-spacing
@funindex markup-system-spacing

détermine l'espacement entre un titre, ou un @emph{markup} de premier
niveau, et le système qui le suit.

@item score-markup-spacing
@funindex score-markup-spacing

détermine l'espacement entre le dernier système et le titre ou
@emph{markup} de haut niveau qui le suit.

@item score-system-spacing
@funindex score-system-spacing

détermine l'espacement entre deux systèmes appartenant à deux partitions
consécutives en l'absence de titrage.

@item system-system-spacing
@funindex system-system-spacing

détermine l'espacement entre deux systèmes d'un même mouvement.

@item markup-markup-spacing
@funindex markup-markup-spacing

détermine l'espacement entre deux titres ou @emph{markups} de premier
niveau.

@item last-bottom-spacing
@funindex last-bottom-spacing

détermine la distance entre le dernier système ou le dernier
@emph{markup} de haut niveau, et le bas de la surface imprimable --
autrement dit le haut de la marge basse.

@item top-system-spacing
@funindex top-system-spacing

détermine l'espace entre le haut de la surface imprimable (le bas de la
marge haute) et le milieu du premier système.  Cette variable n'est
effective qu'en l'absence de titre en haut de page.

@item top-markup-spacing
@funindex top-markup-spacing

détermine l'espace entre le haut de la surface imprimable (le bas de la
marge haute) et le titre.

@end table


@snippets

L'en-tête et le pied de page sont créés respectivement par les fonctions
@code{make-header} et @code{make-footer}, toutes deux définies dans le
bloc @code{\paper}.  Leur implémentation par défaut se trouve dans les
fichiers d'initialisation @file{ly/@/paper@/-defaults@/-init@/.ly} et
@file{ly/@/titling@/-init@/.ly}.

La mise en forme de la page est réalisée par les fonctions
@code{page-music-height} et @code{page-make-stencil}, toutes deux
membres du bloc @code{\paper}.  La première informe l'algoritme des
sauts de ligne de combien d'espace il dispose sur la page@tie{}; la
seconde génère la page selon le nombre de système qu'elle contiendra.

Vous pouvez définir toutes ces valeurs -- en @code{mm}, @code{in},
@code{pt} ou @code{cm} -- en langage Scheme au sein du bloc
@code{\paper}.  Celles contenues dans le fichier
@file{paper-defaults.ly} sont en millimètres, c'est la raison pour
laquelle la valeur de@tie{}@w{@code{2 cm}} de ce qui suit doit être
précédée du signe multiplier.

@example
\paper @{
 #(define bottom-margin (* 2 cm))
@}
@end example


Exemple :

@example
\paper @{
  paper-width = 2\cm
  top-margin = 3\cm
  bottom-margin = 3\cm
  ragged-last-bottom = ##t
@}
@end example

Voici par exemple comment centrer le numéro des pages au bas de chacune
d'elles@tie{}:

@example
\paper @{
  print-page-number = ##t
  print-first-page-number = ##t
  oddHeaderMarkup = \markup \fill-line @{ " " @}
  evenHeaderMarkup = \markup \fill-line @{ " " @}
  oddFooterMarkup = \markup @{ \fill-line @{
     \bold \fontsize #3 \on-the-fly #print-page-number-check-first
     \fromproperty #'page:page-number-string @} @}
  evenFooterMarkup = \markup @{ \fill-line @{
     \bold \fontsize #3 \on-the-fly #print-page-number-check-first
     \fromproperty #'page:page-number-string @} @}
@}
@end example


@seealso
Manuel de notation :
@ref{Espacement vertical entre les systèmes}.

Morceaux choisis :
@rlsrnamed{Spacing,Espacements}.


@node Dimensionnement horizontal
@unnumberedsubsubsec Dimensionnement horizontal
@translationof Horizontal dimensions

Certaines variables permettent de gérer les dimensionnements
horizontaux de la page@tie{}:

@table @code

@item binding-offset
@funindex binding-offset

la gouttière, ou marge de reliure, permet d'augmenter en conséquence la
valeur de la marge intérieure @code{inner-margin} de telle sorte que
rien ne soit masqué par la reliure.  Bien entendu, cette variable n'est
active 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}.

@item horizontal-shift
@funindex horizontal-shift

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}.

@item indent
@funindex indent

définit le niveau d'indentation du premier sysème d'une partition.  La
valeur par défaut est de@tie{}@code{15\mm}.

@item inner-margin
@funindex inner-margin

la marge que toutes les pages d'une partie ou de tout un ouvrage devront
avoir du côté intérieur.  Bien entendu, cette variable n'est
active 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}.

@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}.

@item line-width
@funindex line-width

la longueur d'un système musical.  La valeur par défaut est égale à
@code{paper-width}, auquel sont retranchés @code{left-margin} et
@code{right-margin}.

@item outer-margin
@funindex outer-margin

la marge que toutes les pages d'une partie ou de tout un ouvrage devront
avoir du côté extérieur -- opposé à la reliure.  Bien entendu, cette
variable n'est active 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}.

@item paper-width
@funindex paper-width

la largeur de la page.  Elle correspond par défaut à la largeur du
format de papier utilisé -- voir à ce suje la rubrique
@ref{Format du papier}.

@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}.

@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}.

@end table

LilyPond appliquera les valeurs par défaut pour les variables non
définies, en les ajustant toutefois selon la taille de papier que vous
aurez spécifiée.  Cet adaptation automatique concerne@tie{}:

@itemize
@item @var{left-margin}
@item @var{right-margin}
@item @var{top-margin}
@item @var{bottom-margin}
@item @var{head-separation}
@item @var{foot-separation}
@item @var{indent}
@item @var{short-indent}
@end itemize

Les réglages de @code{line-width}, @code{left-margin},
@code{right-margin} et @code{paper-width} dépendent les uns des autres,
mais ne sont pas tous obligatoires@tie{}:

@example
\paper @{
  left-margin = 30\mm
@}
@end example

Ceci ne définit que la marge gauche (@code{lef-margin}).  Cependant, et
dans la mesure ou @code{right-margin} -- la marge de droite -- garde sa
valeur par défaut, la longueur de ligne -- @code{line-width} -- sera
automatiquement calculée.

@example
\paper @{
  line-width = 150\mm
@}
@end example

Ici, @code{left-margin} et @code{right-margin} prendront la même valeur.
Par conséquent, @code{line-width} est retranché de @code{paper-width} et
divisé par deux.  Autrement dit, le fait de ne spécifier que la valeur
de @code{line-width} permet d'obtenir des systèmes centrés sur la
largeur de la page.

LilyPond effectue toutefois des contrôles de cohérence au niveau de ces
valeurs et émet un avertissement si l'addition n'est pas bonne ou si les
systèmes risquent de déborder.

@example
\paper @{
  paper-width = 210\mm
  left-margin = 20\mm
  right-margin = 30\mm
  line-width = 100\mm
@}
@end example

Ces contrôles peuvent se désactiver en définissant la propriété 
@code{check-consistency} à faux@tie{}:

@example
\paper @{
  paper-width = 210\mm
  left-margin = 20\mm
  line-width = 200\mm
  check-consistency = ##f
@}
@end example

@warning{Lorsque vous définissez manuellement la largeur de page
(@code{paper-width}), ajustez si besoin les valeurs de
@code{line-width}, @code{left-margin}, @code{indent} et
@code{short-indent}.}


@seealso
Morceaux choisis :
@rlsrnamed{Spacing,Espacements}.


@node Autres variables de mise en page
@unnumberedsubsubsec Autres variables de mise en page
@translationof Other layout variables

Les variables regroupées ici par ordre alphabétique vous permettront
d'agencer la page en général.

@table @code

@item auto-first-page-number
@funindex auto-first-page-number

L'algorithme qui gère les sauts de page prend en compte le fait que le
premier numéro de page soit pair ou impair.  Lorsque cette
fonctionnalité est activée, l'algorithme des sauts de page décidera par
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}.

@ignore

TODO: this variable is used, but I don't know what it does. -pm
@item blank-after-score-page-force
@funindex blank-after-score-page-force

Default: @code{2}.

@end ignore

@item blank-last-page-force
@funindex blank-last-page-force

Pénalité pour fin de partition intervenant sur une page impaire.  La
valeur par défaut est de@tie{}@code{0}.

@item blank-page-force
@funindex blank-page-force

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}.

@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
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}.

@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}.

@item max-systems-per-page
Le nombre maximal de systèmes qu'une page pourra comporter.  Cette
variable n'est prise en compte, à ce jour, que par l'option
@code{ly:optimal-breaking}, et n'est pas définie.

@item min-systems-per-page
Le nombre minimal de systèmes qu'une page pourra comporter.  Attention
cependant aux risques de débordements s'il est trop important.  Cette
variable n'est prise en compte, à ce jour, que par l'option
@code{ly:optimal-breaking}, et n'est pas définie.

@item page-breaking-between-system-spacing
@funindex page-breaking-between-system-spacing

Cette variable permet de @qq{tromper} l'algorithme de gestion des sauts
de page quant à la valeur de @code{between-system-spacing}.  Ainsi,
lorsque @code{page-breaking-between-system-spacing #'padding} a une
valeur nettement supérieure à @code{between-system-spacing #'padding},
l'algorithme en question aura tendance à disposer moins de systèmes sur
une même page.  Cette variable est par défaut non définie.

@item page-count
@funindex page-count

Le nombre de pages que devra comporter la partition.  Cette variable est
par défaut non définie.

@item page-limit-inter-system-space
@funindex page-limit-inter-system-space

Lorsqu'elle est activée, cette variable permet de limiter l'espacement
entre les systèmes d'une page comportant beaucoup de blanc.  La valeur
par défaut est@tie{}@code{##f}.  Pour de plus amples détails,
reportez-vous à la rubrique @ref{Espacement vertical entre les systèmes}.

@item page-limit-inter-system-space-factor
@funindex page-limit-inter-system-space-factor

Le coefficient utilisé par @code{page-limit-inter-system-space}.  La
valeur par défaut est de@tie{}@code{1.4}.  Pour de plus amples détails,
reportez-vous à la rubrique @ref{Espacement vertical entre les systèmes}.

@item page-spacing-weight
@funindex page-spacing-weight

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}.

@item print-all-headers
@funindex print-all-headers

Lorsque cette variable est activié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}.

@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}.

@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}.

@item ragged-bottom
@funindex ragged-bottom

L'activation de cette variable permet de ne pas répartir verticalement
les systèmes sur les pages homrmis 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.

@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}.

@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 pages 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.

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.

@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 sarrêteront sur à 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}.

@item system-separator-markup
@funindex system-separator-markup

Il s'agit en l'occurence 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.

La commande @code{\slashSeparator} fournit un @emph{markup} relativement
courant@tie{}:

@lilypond[quote,ragged-right]
#(set-default-paper-size "a6" 'landscape)
\book {
  \score {
    \relative c' { c1 \break c1 }
  }
  \paper {
    system-separator-markup = \slashSeparator
  }
}
@end lilypond

@item system-count
@funindex system-count

Le nombre de systèmes requis par la partition.  Cette variable n'est pas
définie par défaut.

@item systems-per-page
@funindex systems-per-page

Le nombre de systèmes que devrait comporter chaque page.  Cette variable
n'est à ce jour prise en charge que par l'algorithme
@code{ly:optimal-breaking} et n'est pas définie par défaut.

@item two-sided
@funindex two-sided

@cindex gutter
@cindex binding gutter

Cette variable permet de gérer efficacement les impressions recto-verso.
Lorsqu'elle est activée, les réglages affectés à @code{inner-margin},
@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}.

@end table


@seealso
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}.

Les titrages (contenus dans le bloc @code{\header@{@}}) sont considérés
comme des systèmes@tie{}; 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.


@node Mise en forme de la musique
@section Mise en forme de la musique
@translationof Music layout

@menu
* Définition de la taille de portée::
* Mise en forme de la partition::
@end menu


@node Définition de la taille de portée
@subsection Définition de la taille de portée
@translationof Setting the staff size

@cindex fonte, définition de la taille
@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 taille des portées peut se définir de globalement pour toutes les
partitions d'un même fichier, ou plus précisément d'un bloc
@code{\book}, à l'aide de @code{set-global-staff-size}.

@example
#(set-global-staff-size 14)
@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.


Vous pouvez aussi spécifier une taille à une partition en particulier en
procédant comme ci-dessous@tie{}:
@example
\score@{
  ...
  \layout@{
  #(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.

@quotation
@multitable @columnfractions .15 .2 .22 .2

@item @b{nom de la fonte}
@tab @b{hauteur de portée (pt)}
@tab @b{hauteur de portée (mm)}
@tab @b{utilisation}

@item feta11
@tab 11.22
@tab 3.9
@tab format de poche

@item feta13
@tab 12.60
@tab 4.4
@tab

@item feta14
@tab 14.14
@tab 5.0
@tab

@item feta16
@tab 15.87
@tab 5.6
@tab

@item feta18
@tab 17.82
@tab 6.3
@tab cernet de chant

@item feta20
@tab 20
@tab 7.0
@tab partition standard

@item feta23
@tab 22.45
@tab 7.9
@tab

@item feta26
@tab 25.2
@tab 8.9
@tab
@c modern rental material?

@end multitable
@end quotation

Ces fontes sont disponibles à 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.


@node Mise en forme de la partition
@subsection Mise en forme de la partition
@translationof Score layout

@funindex \layout

Alors que @code{\paper} définit le formatage des pages pour
l'intégralité du document, @code{\layout} s'occupe de la mise en forme
spécifique à la partition.

@example
\layout @{
  indent = 2.0\cm
  \context @{ \Staff
    \override VerticalAxisGroup #'minimum-Y-extent = #'(-6 . 6)
  @}
  \context @{ \Voice
    \override TextScript #'padding = #1.0
    \override Glissando #'thickness = #3
  @}
@}
@end example


@seealso
Manuel de notation :
@ref{Modification des réglages par défaut d'un contexte}.

Morceaux choisis :
@rlsrnamed{Spacing,Espacements}.


@node Sauts
@section Sauts
@translationof Breaks

@menu
* Sauts de ligne::
* Sauts de page::
* Optimisation des sauts de page::
* Optimisation des tournes::
* Minimisation des sauts de page::
* 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

@untranslated


@node Sauts de page
@subsection Sauts de page
@translationof Page breaking

@untranslated


@node Optimisation des sauts de page
@subsection Optimisation des sauts de page
@translationof Optimal page breaking

@untranslated


@node Optimisation des tournes
@subsection Optimisation des tournes
@translationof Optimal page turning

@untranslated


@node Minimisation des sauts de page
@subsection Minimisation des sauts de page
@translationof Minimal page breaking

@untranslated


@node Sauts explicites
@subsection Sauts explicites
@translationof Explicit breaks

@untranslated


@node Recours à une voix supplémentaire pour gérer les sauts
@subsection Recours à une voix supplémentaire pour gérer les sauts
@translationof Using an extra voice for breaks

@untranslated


@node Espacement vertical
@section Espacement vertical
@translationof Vertical spacing

@untranslated


@menu
* Espacement vertical au sein d'un système::
* Espacement vertical entre les systèmes::
* Positionnement explicite des portées et systèmes::
* 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 Vertical spacing inside a system

@untranslated


@unnumberedsubsubsec Espacement entre les portées
@translationof Spacing between staves

@untranslated


@unnumberedsubsubsec Espacement des lignes rattachées à des portées
@translationof Spacing of non-staff lines

@untranslated


@node Espacement vertical entre les systèmes
@subsection Espacement vertical entre les systèmes
@translationof Vertical spacing between systems

@untranslated


@node Positionnement explicite des portées et systèmes
@subsection Positionnement explicite des portées et systèmes
@translationof Explicit staff and system positioning

@untranslated


@node Résolution des collisions verticales
@subsection Résolution des collisions verticales
@translationof Vertical collision avoidance

@untranslated


@node Espacement horizontal
@section Espacement horizontal
@translationof Horizontal spacing

@cindex horizontal, espacement
@cindex espacement horizontal

@menu
* Généralités sur l'espacement horizontal::
* Changement d'espacement au cours de la partition::
* Modification de l'espacement horizontal::
* Longueur de ligne::
* 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

@untranslated


@node Changement d'espacement au cours de la partition
@subsection Changement d'espacement au cours de la partition
@translationof New spacing area

@untranslated


@node Modification de l'espacement horizontal
@subsection Modification de l'espacement horizontal
@translationof Changing horizontal spacing

@untranslated


@node Longueur de ligne
@subsection Longueur de ligne
@translationof Line length

@untranslated


@node Notation proportionnelle
@subsection Notation proportionnelle
@translationof Proportional notation

@untranslated


@node Réduction du nombre de pages de la partition
@section Réduction du nombre de pages de la partition
@translationof Fitting music onto fewer pages

@untranslated


@menu
* 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

@untranslated


@node Modification de l'espacement
@subsection Modification de l'espacement
@translationof Changing spacing

@untranslated