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' {
  c2 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.17.97 
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,

[image of music]

Les options sont indiquées entre crochets.

c'4 f16

[image of music]

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

[image of music]

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' {
    c d e f g a b c
  }
}

[image of music]


Notes de bas de page

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


Autres langues : English, deutsch, español, magyar, italiano, 日本語.
About automatic language selection.

LilyPond — Utilisation des programmes v2.17.97 (branche de développement).