4.1.1 Le bloc \paper
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,\bookpartou\score. -
Au sein d’un bloc
\booket indépendamment de tout bloc\bookpartou\scorequ’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
\paperqui 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 et \bp. 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’.