3.3.6 Référencement des numéros de page

LilyPond vous permet, à l’aide de la commande \label, d’insérer des points de référence dans un ouvrage, aussi bien en dehors qu’au fil de la musique. Ce point de référence pourra être ensuite repris à l’intérieur d’un markup ; vous pourrez même y ajouter le numéro de page grâce à la commande de markup \page-ref.

\header { tagline = ##f }
\book {
  \label #'firstScore
  \score {
    {
      c'1
      \pageBreak \mark A \label #'markA
      c'1
    }
  }

  \markup { Le premier mouvement débute à la page
            \page-ref #'firstScore "0" "?" }
  \markup { Le repère A est à la page \page-ref #'markA "0" "?" }
}
[image of music]

L’instruction \page-ref prend trois arguments :

  1. le point de référence, sous la forme d’un symbole Scheme, comme par exemple #'firstScore,
  2. un « emporte-pièce » afin d’estimer la longueur totale du markup, et
  3. un texte de remplacement au cas où la référence ne serait pas retrouvée.

La présence de l’emporte-pièce est rendue nécessaire par le fait que les markups sont générés avant que les sauts de page ne soient positionnés. Bien que le numéro de page en question ne soit pas encore déterminé, LilyPond doit connaître les dimensions de ce markup. Vous pouvez, lorsque l’ouvrage contiendra plus de dix pages, stipuler un emporte-pièce sur deux caractères – soit "00".

Lorsque la taille du texte final diffère de l’emporte-pièce, il peut s’avérer utile de configurer son alignement horizontal par rapport à l’espace réservé, à l’aide de la propriété x-align. Le réglage par défaut est un alignement sur la droite.

\markup {
  \box
    \page-ref #'foo "???" "?" " right-aligned (default)"
}
\markup {
  \box
    \override #`(x-align . ,LEFT)
    \page-ref #'foo "???" "?" " left-aligned"
}
\markup {
  \box
    \override #'(x-align . -2.5)
    \page-ref #'foo "???" "?" " left outside"
}
[image of music]

Dans cet exemple, l’emporte-pièce ‘???’ est plus large que le texte de remplacement ‘?’. Le texte de remplacement est utilisé parce que le label #'foo n’existe pas.

La propriété x-align peut prendre n’importe quel nombre. Les symboles prédéfinis LEFT, CENTER et RIGHT permettent d’aligner respectivement sur la gauche, au centre, et sur la droite de l’emporte-pièce.

Commandes prédéfinies

\label, \page-ref.


GNU LilyPond – Manuel de notation v2.25.26 (development-branch).