GNU LilyPond – Manuel de notation: 4.1.1 Le bloc \paper

### 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`, `\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`’.

#### LilyPond — Manuel de notation v2.22.2 (branche stable).