3.1 Exemple de document musicologique

Un certain nombre d’ouvrages peuvent être illustrés par des extraits musicaux, qu’il s’agisse d’un traité de musicologie, d’un carnet de chant ou d’un manuel à l’exemple de celui que vous consultez actuellement. Cet agencement peut se faire « à la main » par importation d’un graphique PostScript ou PDF dans le traitement de texte. Les développeurs de LilyPond ont cependant créé un outil permettant d’automatiser ces opérations pour ce qui concerne les documents HTML, LaTeX, Texinfo et DocBook.

Un script – lilypond-book – se charge d’extraire les fragments de musique, puis de les mettre en forme avant de renvoyer la « partition » correspondante. Voici un court exemple utilisable avec LaTeX. Dans la mesure où il est suffisamment parlant, nous nous abstiendrons de le commenter.

Fichier d’entrée

\documentclass[a4paper]{article}

\begin{document}

Un document destiné à être traité par \verb+lilypond-book+ peut tout à
fait mélanger de la musique et du texte.
Par exemple,

\begin{lilypond}
\relative {
  c'2 e2 \tuplet 3/2 { f8 a b } a2 e4
}
\end{lilypond}

Les options sont indiquées entre crochets.

\begin{lilypond}[fragment,quote,staffsize=26,verbatim]
  c'4 f16
\end{lilypond}

Des extraits plus conséquents peuvent faire l'objet d'un fichier
indépendant, alors inclus avec \verb+\lilypondfile+.

\lilypondfile[quote,noindent]{screech-and-boink.ly}

(Si besoin, remplacez @file{screech-and-boink.ly} par
n'importe quel fichier @file{.ly} qui se trouve dans
le même répertoire que le présent fichier.)

\end{document}

Traitement

Enregistrez ces lignes dans un fichier nommé lilybook.lytex puis, dans un terminal, lancez

lilypond-book --output=out --pdf lilybook.lytex
lilypond-book (GNU LilyPond) 2.25.21 
Lecture de lilybook.lytex...
…nous vous épargnons le verbiage de la console…
Compilation de lilybook.tex...
cd out
pdflatex lilybook
…nous vous épargnons le verbiage de la console…
xpdf lilybook
(remplacez xpdf par votre lecteur de PDF habituel)

Le traitement par lilypond-book puis latex va générer un certain nombre de fichiers temporaires susceptibles d’encombrer inutilement votre répertoire de travail, aussi nous vous recommandons d’utiliser l’option --output=répertoire afin que les fichiers créés soient isolés dans le sous-répertoire répertoire.

Pour terminer, voici le résultat de cet exemple pour LaTeX.⁴

Résultat

Un document destiné à être traité par lilypond-book peut tout à fait mélanger de la musique et du texte. Par exemple, en utilisant la syntaxe Texinfo,

@lilypond
\relative {
  c'2 e2 \tuplet 3/2 { f8 a b } a2 e4
}
@end lilypond

produit

Les options permettant de contrôler l’apparence des extraits peuvent s’ajouter. Par exemple, en utilisant la syntaxe LaTeX,

\begin{lilypond}[fragment, quote, staffsize=26]
c'4 f16
\end{lilypond}

produit

Des extraits plus conséquents peuvent faire l’objet de fichiers indépendants, alors inclus avec \lilypondfile. Par exemple, en utilisant la syntaxe HTML,

<lilypondfile quote noindent>
  snippets/screech-and-boink.ly
</lilypondfile>

produit

Lorsque vous désirez y inclure un tagline, personnalisé ou non, l’intégralité de l’extrait devra apparaître dans une construction de type \book { }.

\book{
  \header{ title = "LilyPond fait ses gammes" }

  \relative { c' d e f g a b c }
}