GNU LilyPond – Utilisation des programmes: 3.1 Exemple de document musicologique

## 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 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.22.2
>     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.1

### Résultat

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

Les options sont indiquées entre crochets.

>     c'4 f16

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

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
      }
    }

### Notes de bas de page

[1] Ce manuel étant réalisé avec Texinfo, il se peut que la mise en forme diverge quelque peu.

#### LilyPond — Utilisation des programmes v2.22.2 (branche stable).