GNU LilyPond – Manuel de notation: 4.1 Mise en forme de la page

[ >> ]

[ ? ]

4.1.1 Le bloc `\paper`

@translationof The paper block

Des blocs \paper peuvent apparaître à trois différents endroits et former ainsi une hiérarchie :

En début de fichier source, avant même tout bloc \book, \bookpart ou \score.
Au sein d’un bloc \book et indépendamment de tout bloc \bookpart ou \score qu’il pourrait contenir.
Au sein d’un bloc \bookpart, mais en dehors de tout bloc \score.

Un bloc \paper ne doit donc en aucun cas prendre place au sein d’un bloc \score.

Les valeurs des différents champs seront filtrées en respectant cette hiérarchie ; les valeurs définies le plus haut persisteront à moins d’être remplacées à un niveau hiérarchique inférieur.

Plusieurs blocs \paper peuvent cohabiter à un même niveau, notamment en raison de la présence d’inclusion de fichiers. Dans une telle éventualité, les champs sont regroupés par niveau, la dernière valeur rencontrée ayant préséance en cas de doublon.

Peuvent apparaître dans un bloc \paper :

la fonction Scheme set-paper-size,
des variables propres au bloc \paper qui viendront adapter la mise en page,
la définition des différents markups qui personnaliseront la mise en forme des entêtes et pieds de page ainsi que des titrages.

La fonction set-paper-size fait l’objet de la rubrique qui suit – Format du papier et adaptation automatique. Les variables du bloc \paper chargées de la mise en page sont abordées plus loin dans ce chapitre. Quant aux définitions relatives aux markups des entête, pied de page et titrage, elles sont étudiées à la rubrique Titrages personnalisés.

La plupart des variables gérant le papier ne sont fonctionnelles que lorsque mentionnées dans un bloc \paper. Certaines, qui peuvent toutefois apparaître dans un bloc \layout, sont référencées à la rubrique Le bloc \layout.

Sauf mention contraire, toutes les variables du bloc \paper qui 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 (top-margin) à dix millimètres :

\paper {
  top-margin = 10
}

Si vous préférez lui affecter une valeur de 0,5 pouce, vous devrez mentionner le suffixe d’unité \in :

\paper {
  top-margin = 0.5\in
}

LilyPond accepte les suffixes d’unité \mm, \cm, \in et \pt. Ces unités sont des conversions de millimètres, répertoriées dans le fichier ‘ly/paper-defaults-init.ly’. Pour plus de lisibilité, et bien que ce ne soit pas techniquement requis, nous vous conseillons d’ajouter \mm à votre code lorsque vous travaillez en millimètres.

Vous pouvez aussi définir les valeurs du bloc \paper à l’aide de fonctions Scheme. Voici l’équivalent de l’exemple précédent :

\paper {
  #(define top-margin (* 0.5 in))
}

Voir aussi

Manuel de notation : Format du papier et adaptation automatique, Le bloc \layout, Titrages personnalisés.

Fichiers d’initialisation : ‘ly/paper-defaults-init.ly’.

[ < ]

[ > ]

[ << ]

[ >> ]

[ ? ]

4.1.2 Format du papier et adaptation automatique

@translationof Paper size and automatic scaling

[ < ]

[ > ]

[ << ]

[ >> ]

[ ? ]

Format du papier

@translationof Setting the paper size

LilyPond génère par défaut, et en l’absence de mention explicite d’un format de papier particulier, un fichier imprimable au format A4. Vous pouvez cependant utiliser un autre format à l’aide des deux fonctions :

set-default-paper-size

#(set-default-paper-size "quarto")

qui se place en début de fichier, et

set-paper-size

\paper {
  #(set-paper-size "tabloid")
}

qui s’inscrit au sein d’un bloc \paper.

La seule restriction à l’utilisation isolée de la fonction set-default-paper-size est qu’elle doit intervenir avant le premier bloc \paper. set-default-paper-size fixe le format pour toutes les pages, alors que set-paper-size détermine le format des feuilles rattachées à un bloc \paper particulier. Ainsi, lorsque le bloc \paper se trouve en tête de fichier, le format du papier s’appliquera à toutes les pages ; si \paper apparaît dans un bloc \book, la taille ne s’appliquera qu’au book en question.

À l’intérieur d’un bloc \paper, la fonction set-paper-size doit intervenir avant toute autre variable. Les raisons à ceci sont abordées à la rubrique Adaptation automatique au format.

Différents formats de papier sont définis dans le fichier ‘scm/paper.scm’. Bien que vous puissiez y ajouter votre propre format, sachez cependant que celui-ci est écrasé à chaque mise à jour de LilyPond. Les différents formats disponibles sont répertoriés à l’annexe Formats de papier prédéfinis.

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 set-default-paper-size et set-paper-size :

#(set! paper-alist (cons '("mon format" . (cons (* 15 in) (* 3 in))) paper-alist))

\paper {
  #(set-paper-size "mon format")
}

Les unités peuvent s’exprimer aussi bien en in (pouces), qu’en cm (centimètres) ou mm (millimètres).

Le fait d’ajouter l’argument 'landscape à l’instruction 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)

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 ‘landscape’ au nom du format de papier :

#(set-default-paper-size "a6landscape")

Lorsque la taille du papier comporte explicitement ‘landscape’ ou ‘portrait’, la présence d’un argument 'landscape aura pour seul effet de modifier l’orientation de l’image et non les dimensions de la feuille.

Voir aussi

Manuel de notation : Adaptation automatique au format, Formats de papier prédéfinis.

Fichiers d’initialisation : ‘scm/paper.scm’.

[ < ]

[ > ]

[ << ]

[ >> ]

[ ? ]

Adaptation automatique au format

@translationof Automatic scaling to paper size

Toute modification du format de papier à l’aide des fonctions Scheme set-default-paper-size ou set-paper-size, que nous avons vues à la rubrique Format du papier, se traduira automatiquement par l’ajustement d’un certain nombre de variables attachées au bloc \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 à paper-height ou paper-width ne déclenchera pas l’étalonnage automatique, bien que spécifier une largeur de papier (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 top-margin et bottom-margin – voir Variables d’espacement vertical fixe –, ainsi que les dimensionnements horizontaux left-margin, right-margin, inner-margin, outer-margin, binding-offset, indent et short-indent – voir Variables d’espacement horizontal.

Les valeurs par défaut de ces dimensionnements sont contenues dans le fichier ‘ly/paper-defaults-init.ly’ et utilisent les variables internes top-margin-default, bottom-margin-default, etc. correspondant au format par défaut – papier A4 – pour lequel paper-height est à 297\mm et paper-width à 210\mm.

Voir aussi

Manuel de notation : Variables d’espacement horizontal, Variables d’espacement vertical fixe.

Fichiers d’initialisation : ‘ly/paper-defaults-init.ly’, ‘scm/paper.scm’.

[ < ]

[ > ]

[ << ]

[ >> ]

[ ? ]

4.1.3 Variables d’espacement vertical fixe

@translationof Fixed vertical spacing paper variables

Note : Certains dimensionnements attachés au bloc \paper sont automatiquement ajustés selon le format du papier, ce qui peut conduire à un résultat inattendu – voir Adaptation automatique au format.

Les valeurs par défaut (avant étalonnage) sont définies dans le fichier ‘ly/paper-defaults-init.ly’.

paper-height: La hauteur de la feuille. Il s’agit par défaut de la dimension du papier utilisé. Notez bien que cette variable n’affectera pas l’ajustement automatique d’un certain nombre de dimensionnements verticaux.
top-margin: La marge entre le bord supérieur de la feuille et la surface imprimable. Elle est fixée par défaut à 5\mm et s’ajustera selon le format de papier.
bottom-margin: La marge entre la surface imprimable et le bord inférieur de la feuille. Elle est fixée par défaut à 6\mm et s’ajustera selon le format de papier.
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 #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.
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 #t. Nous vous conseillons, lorsque des pièces couvrent deux pages ou plus, de désactiver cette variable.
Notez bien que la variable ragged-last-bottom affecte aussi la dernière page de chacune des parties – créées à l’aide d’un bloc \bookpart – d’un même ouvrage.

Voir aussi

Manuel de notation : Adaptation automatique au format.

Fichiers d’initialisation : ‘ly/paper-defaults-init.ly’.

Morceaux choisis : (snippets)Spacing section ‘Espacements’ dans Morceaux choisis.

Problèmes connus et avertissements

Les titrages (contenus dans le bloc \header{}) sont considérés comme des systèmes à part entière ; ils seront donc affectés par ragged-bottom et ragged-last-bottom, qui éventuellement ajouteront de l’espace avant le premier système de la partition.

La définition explicite d’un format de papier annulera tout réglage des marges haute et basse.

[ < ]

[ > ]

[ << ]

[ >> ]

[ ? ]

4.1.4 Variables d’espacement vertical fluctuant

@translationof Flexible vertical spacing paper variables

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 \paper répertoriées ci-dessous vous permettront d’affiner ces dimensionnements.

Gardez à l’esprit que les variables du bloc \paper dont nous parlons ici n’influencent en rien l’espacement des portées d’un même système. L’espacement au sein des systèmes est géré par des propriétés attachées à des objets graphiques (grobs) qui, elles, se définissent au niveau du bloc \score – voir à ce sujet Espacement vertical au sein d’un système.

[ < ]

[ > ]

[ << ]

[ >> ]

[ ? ]

Structure des variables d’espacement vertical fluctuant

@translationof Structure of flexible vertical spacing alists

Chacune de ces variables attachées au bloc \paper est constituée d’une liste associative (alist) à quatre clés :

basic-distance (distance de base) – la grandeur d’espace par défaut, exprimée en hauteur de portée, séparant les 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 markup est son sommet, celui d’un système est le centre vertical du StaffSymbol le plus proche – même lorsqu’une ligne de « non-portée » viendrait à s’intercaler. Une basic-distance inférieure à padding ou minimum-distance sera sans effet, dans la mesure où l’espacement résultant ne saurait être inférieur à padding ou minimum-distance.
minimum-distance (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 minimum-distance inférieure à la valeur du padding sera sans effet, dans la mesure où l’espacement résultant ne saurait être inférieur au padding.
padding (décalage) – la grandeur minimale de « 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.
stretchability (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 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. Il ne saurait être négatif. La valeur +inf.0 provoque une programming_error (erreur de programmation) et est ignorée ; vous pouvez toutefois utiliser 1.0e7 pour obtenir une valeur proche de l’infini. Lorsque cette clé n’est pas définie, sa valeur est par défaut égale à space. Notez bien que l’utilisateur ne peut définir une propension à la compression ; elle est en fait égale à (basic-distance - minimum-distance).

Lorsque l’impression n’est pas en pleine page – elle est donc ragged bottom pour les anglophones – l’élément space n’est pas étiré. Les hauteurs sur une telle page correspondront donc au maximum de

basic-distance, plus
minimum-distance et
padding, augmenté de ce qu’il faut pour éviter les chevauchements.

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 (notation)Modification de listes associatives section ‘chapitre spécifique’ dans Manuel de notation. 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.

\paper {
  system-system-spacing.basic-distance = #8

  score-system-spacing =
    #'((padding . 1)
       (basic-distance . 12)
       (minimum-distance . 6)
       (stretchability . 12))
}

[ < ]

[ > ]

[ << ]

[ >> ]

[ ? ]

Liste des variables d’espacement fluctuant

@translationof List of flexible vertical spacing paper variables

Le nom des dimensionnements à hauteur variable sont de la forme avant-après-spacing, où avant et 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 (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 markup fait référence aussi bien à un markup de titrage (bookTitleMarkup ou scoreTitleMarkup) qu’à un markup de haut niveau (voir Structure de fichier). Toutes les distances sont exprimées en espace de portée.

Leurs valeurs par défaut sont inscrites dans le fichier ‘ly/paper-defaults-init.ly’.

markup-system-spacing: détermine l’espacement entre un titre ou un markup de premier niveau, et le système qui le suit.
score-markup-spacing: détermine l’espacement entre le dernier système et le titre ou markup de haut niveau qui le suit.
score-system-spacing: détermine l’espacement entre le dernier système d’une partition et le premier système de la partition suivante, en l’absence de titrage ou markup qui les sépare.
system-system-spacing: détermine l’espacement entre deux systèmes d’un même mouvement.
markup-markup-spacing: détermine l’espacement entre deux titres ou markups de premier niveau.
last-bottom-spacing: détermine la distance entre le dernier système ou le dernier markup de haut niveau, et le bas de la surface imprimable – autrement dit le haut de la marge basse.
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 ou markup de premier niveau en haut de page.
top-markup-spacing: détermine l’espace entre le haut de la surface imprimable (le bas de la marge haute) et le premier titre ou markup de premier niveau. Cette variable n’est effective qu’en l’absence de système en haut de page.

Voir aussi

Manuel de notation : Espacement vertical au sein d’un système.

Morceaux choisis : (snippets)Spacing section ‘Espacements’ dans Morceaux choisis.

[ < ]

[ > ]

[ << ]

[ >> ]

[ ? ]

4.1.5 Variables d’espacement horizontal

@translationof Horizontal spacing paper variables

[ < ]

[ > ]

[ << ]

[ >> ]

[ ? ]

Variables de marge et de largeur

@translationof paper variables for widths and margins

Les valeurs par défaut (avant étalonnage) sont définies dans le fichier ‘ly/paper-defaults-init.ly’.

paper-width

La largeur de la page. Elle correspond par défaut à la largeur du format de papier utilisé. Si paper-width n’a aucun effet en matière d’ajustement automatique, cette variable influe sur la variable line-width. Lorsque vous définissez à la fois les valeurs de paper-width et line-width, les valeurs de left-margin et right-margin seront recalculées. Voir aussi check-consistency.

line-width

La longueur d’une ligne. Lorsque spécifié dans un bloc \paper, ceci définit l’étendue horizontale dont disposeront les lignes de portée d’un système non indenté. La valeur par défaut est égale à paper-width, auquel sont retranchés left-margin et right-margin. Lorsque vous définissez line-width sans modifier les valeurs de left-margin et right-margin, les marges seront alors recalculées de telle sorte que les systèmes soient centrés. Voir aussi check-consistency.

La valeur de line-width peut aussi se spécifier individuellement au niveau de la partition, au sein d’un bloc \layout. Ceci permet de contrôler la longueur des lignes partition par partition. Si la longueur de ligne n’est pas spécifiée dans une partition particulière, elle sera valorisée à celle du line-width mentionné dans le bloc \paper. La détermination de line-width pour un \score particulier n’a aucun effet sur les marges. Les lignes d’une portée dont la longueur est déterminée par le line-width d’une partition seront alignées par la gauche sur la surface de papier telle que définie par le line-width du bloc \paper. Dès lors que les valeurs de line-width de la partition et du papier sont égales, les lignes s’étendront de la marge gauche à la marge droite. En cas de line-width de la partition supérieur au line-width du papier, les lignes de portée déborderont dans la marge de droite.

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 10\mm ; elle sera ajustée selon le format du papier. Lorsque vous définissez line-width et right-margin sans modifier la valeur de left-margin, cette dernière sera alors égale à (paper-width - line-width - right-margin). Lorsque seule line-width est définie, les deux marges correspondent à ((paper-width - line-width) / 2), ce qui a pour effet de centrer les systèmes sur la page. Voir aussi check-consistency.

right-margin

La marge entre le bord droit de la page et la fin des systèmes en pleine largeur (non ragged). La valeur par défaut est de 10\mm et s’ajustera selon le format du papier. Lorsque vous définissez line-width et left-margin, sans modifier la valeur de right-margin, cette dernière sera alors égale à (paper-width - line-width - left-margin). Lorsque seule line-width est définie, les deux marges correspondent à ((paper-width - line-width) / 2), ce qui a pour effet de centrer les systèmes sur la page. Voir aussi check-consistency.

check-consistency

Lorsqu’elle est activée, cette variable vérifie que left-margin, line-width et right-margin sont en cohérence, et que l’addition de ces trois éléments ne dépassera pas la largeur du papier (paper-width). La valeur par défaut est #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). En cas de désactivation de cette variable (valorisation à #f, toute incohérence sera ignorée, et les systèmes pourront déborder de la page.

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 #f mais, si la partition ne comporte qu’un seul système, elle passe à #t. Cette variable peut aussi se gérer au sein d’un bloc \layout.

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 #f. Cette variable peut aussi se gérer au sein d’un bloc \layout.

Voir aussi

Manuel de notation : Adaptation automatique au format.

Fichiers d’initialisation : ‘ly/paper-defaults-init.ly’.

Problèmes connus et avertissements

La définition explicite d’un format de papier annulera tout réglage des marges gauche et droite.

[ < ]

[ > ]

[ << ]

[ >> ]

[ ? ]

Variables spécifiques à l’impression recto-verso

@translationof paper variables for two-sided mode

Les valeurs par défaut (avant étalonnage) sont définies dans le fichier ‘ly/paper-defaults-init.ly’.

two-sided: Cette variable permet de gérer efficacement les impressions recto-verso. Lorsqu’elle est activée, les réglages affectés à inner-margin, outer-margin ainsi que 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 left-margin et right-margin. La valeur par défaut est #f.
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 effective que lorsque vous comptez générer un fichier imprimable en recto-verso – propriété two-sided définie à vrai. La valeur par défaut est de 10\mm et s’ajustera selon le format du papier.
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 effective que lorsque vous comptez générer un fichier imprimable en recto-verso – propriété two-sided définie à vrai. La valeur par défaut est de 20\mm et s’ajustera selon le format du papier.
binding-offset: La gouttière, ou marge de reliure, permet d’augmenter en conséquence la valeur de la marge intérieure inner-margin de telle sorte que 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é two-sided définie à vrai. La valeur par défaut est de 0 et s’ajustera selon le format du papier.

Voir aussi

Manuel de notation : Adaptation automatique au format.

Fichiers d’initialisation : ‘ly/paper-defaults-init.ly’.

[ < ]

[ > ]

[ << ]

[ >> ]

[ ? ]

Variables d’indentation et de décalage

@translationof paper variables for shifts and indents

Les valeurs par défaut (avant étalonnage) sont définies dans le fichier ‘ly/paper-defaults-init.ly’.

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 0.0\mm.
indent: Le niveau d’indentation du premier système d’une partition. La valeur par défaut est de 15\mm en A4 et s’ajustera selon le format du papier. L’espace correspondant à line-width est réduit d’autant pour le premier système. Cette variable peut aussi se gérer partition par partition au sein d’un bloc \layout.
short-indent: Le niveau d’indentation de tous les systèmes hormis le premier. La valeur par défaut est de 0 pour du A4, et s’ajustera selon le format du papier dès lors que vous lui aurez affecté une valeur. Bien entendu, l’espace spécifié par line-width sera réduit d’autant. Cette variable peut aussi se gérer partition par partition, au sein d’un bloc \layout.

Voir aussi

Manuel de notation : Adaptation automatique au format.

Fichiers d’initialisation : ‘ly/paper-defaults-init.ly’.

Morceaux choisis : (snippets)Spacing section ‘Espacements’ dans Morceaux choisis.

[ < ]

[ > ]

[ << ]

[ >> ]

[ ? ]

4.1.6 Autres variables du bloc `\paper`

@translationof Other paper variables

[ < ]

[ > ]

[ << ]

[ >> ]

[ ? ]

Variables de gestion des sauts de ligne

@translationof paper variables for line breaking

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 ly:optimal-breaking, et n’est pas définie.
min-systems-per-page: Le nombre minimal de systèmes qu’une page pourra comporter. Attention cependant aux risques de débordement s’il est trop important. Cette variable n’est prise en compte, à ce jour, que par l’option ly:optimal-breaking, et n’est pas définie.
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 ly:optimal-breaking et n’est pas définie par défaut.
system-count: Le nombre de systèmes requis par la partition. Cette variable n’est pas définie par défaut. Cette variable peut se gérer au sein d’un bloc \layout.

Voir aussi

Manuel de notation : Sauts de ligne.

[ < ]

[ > ]

[ << ]

[ >> ]

[ ? ]

Variables de gestion des sauts de page

@translationof paper variables for page breaking

Les valeurs par défaut sont définies dans le fichier ‘ly/paper-defaults-init.ly’.

page-breaking: L’algorithme de calcul des sauts de page à utiliser. Vous avez le choix entre ly:minimal-breaking, ly:page-turn-breaking, ly:one-page-breaking, ly:one-line-breaking, ly:one-line-auto-height-breaking, et ly:optimal-breaking (activé par défaut).
page-breaking-system-system-spacing: Cette variable permet de « tromper » l’algorithme de gestion des sauts de page quant à la valeur de system-system-spacing. Ainsi, lorsque page-breaking-system-system-spacing.padding a une valeur nettement supérieure à system-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.
page-count: Le nombre de pages que devra comporter la partition. Cette variable est par défaut non définie.

Les variables qui suivent ne sont effectives que lorsque l’algorithme page-breaking adopte la fonction ly:page-turn-breaking. Les sauts de page sont alors positionnés de sorte à minimiser le nombre de tournes. Dans la mesure où il faut tourner la feuille pour passer d’une page impaire à une page paire, sera privilégiée une répartition qui présente une dernière page impaire. Les endroits où une tourne serait appropriée peuvent s’indiquer à l’aide d’un \allowPageTurn ou laissés à l’appréciation du Page_turn_engraver – voir Optimisation des tournes.

Lorsqu’aucune option n’est satisfaisante pour placer judicieusement les tournes, LilyPond peut décider d’insérer une page blanche au milieu d’une partition ou entre deux partitions successives, voire même finir par une page paire. La valeur des trois variables qui suivent peut se voir augmentée de façon à diminuer ces risques.

Il s’agit ici de pénalité ; autrement dit, au plus la valeur est élevée, au moins l’action associée sera favorisée en regard des autres choix.

blank-page-penalty: Pénalité pour apparition d’une page blanche en cours de partition. L’attribution d’une valeur élevée à blank-page-penalty alors qu’a été activé ly:page-turn-breaking forcera LilyPond à éviter de placer une page blanche au mileu de la partition, quitte à espacer d’autant plus la musique pour remplir cette page blanche et la suivante. La valeur par défaut est de 5.
blank-last-page-penalty: Pénalité pour fin de partition intervenant sur une page paire. L’attribution d’une valeur élevée à blank-last-page-penalty alors qu’a été activé ly:page-turn-breaking forcera LilyPond à éviter de terminer la partition sur une page paire, quitte à ajuster les espacements jusqu’à obtenir une page de plus ou une de moins. La valeur par défaut est de 0.
blank-after-score-page-penalty: Pénalité pour apparition d’une page blanche entre deux partitions. Sa valeur est par défaut inférieure à celle de 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. La valeur par défaut est de 2.

Voir aussi

Manuel de notation : Minimisation des sauts de page, Optimisation des sauts de page, Optimisation des tournes, Présentation en ligne continue, Présentation en page continue, Présentation en rouleau, Sauts de page.

Fichiers d’initialisation : ‘ly/paper-defaults-init.ly’.

[ < ]

[ > ]

[ << ]

[ >> ]

[ ? ]

Variables de gestion des numéros de page

@translationof paper variables for page numbering

Les valeurs par défaut sont définies dans le fichier ‘ly/paper-defaults-init.ly’.

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 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 #f.
first-page-number: Le numéro de la première page. La valeur par défaut est de #1.
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 #f.
print-page-number: La désactivation de cette variable permet d’obtenir des pages non numérotées. La valeur par défaut est #t.
page-number-type: Le type de chiffres à utiliser pour la numérotation : roman-lower (romains minuscules), roman-upper (romains majuscules) ou arabic (arabes). La valeur par défaut est 'arabic.

Voir aussi

Fichiers d’initialisation : ‘ly/paper-defaults-init.ly’.

Problèmes connus et avertissements

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.

[ < ]

[ > ]

[ << ]

[ >> ]

[ ? ]

Variables supplémentaires

@translationof Miscellaneous paper variables

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

print-all-headers

Lorsque cette variable est activée, l’intégralité des champs d’entête sera imprimée pour chaque bloc \score, plutôt que les seuls champs piece et opus. La valeur par défaut est #f.

system-separator-markup

Il s’agit en l’occurrence d’insérer un objet de type 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 \slashSeparator – définie dans le fichier ‘ly/titling-init.ly’ – fournit un markup relativement courant :

#(set-default-paper-size "a8")

\book {
  \paper {
    system-separator-markup = \slashSeparator
  }
  \header {
    tagline = ##f
  }
  \score {
    \relative { c''1 \break c1 \break c1 }
  }
}

footnote-separator-markup

Il s’agit d’un objet markup qui vient s’insérer au-dessus du texte de la note de bas de page. C’est, par défaut, une ligne horizontale centrée, définie dans ‘ly/paper-defaults-init.ly’.

Voir aussi

Fichiers d’initialisation : ‘ly/paper-defaults-init.ly’, ‘ly/titling-init.ly’.

Morceaux choisis : (snippets)Spacing section ‘Espacements’ dans Morceaux choisis.

Problèmes connus et avertissements

L’entête par défaut, formé d’une seule ligne, est constitué du numéro de page et du champ instrument contenu dans le bloc \header.

[ < ]

[ > ]

[ << ]