26.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, \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 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))
}

Enfin, il est tou à fait possible de prédéfinir des variables concernant les sorties imprimables.

bigMargin = \paper { top-margin = 10\cm }

\paper {
  \bigMargin
  indent = 0\mm
}

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.