3.1 Un esempio di documento musicologico

Alcuni testi contengono degli esempi musicali: si tratta di trattati musicologici, canzonieri o manuali come questo. È possibile crearli a mano, semplicemente importando un’immagine PostScript nell’elaboratore di testo. Tuttavia esiste una procedura automatizzata che permette di ridurre il carico di lavoro richiesto dai documenti in formato HTML, LaTeX, Texinfo e DocBook.

Uno script chiamato lilypond-book estrarrà i frammenti musicali, li formatterà e restituirà la notazione risultante. Ecco un piccolo esempio da usare con LaTeX. L’esempio contiene anche del testo esplicativo, dunque non è necessario entrare nei dettagli.

Input

\documentclass[a4paper]{article}

\begin{document}

I documenti per \verb+lilypond-book+ possono combinare liberamente musica e testo.
Ad esempio,

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

Le opzioni vengono specificate tra parentesi quadre.

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

Se l'esempio è più grande, è possibile metterlo in un file separato e inserirlo
con \verb+\lilypondfile+.

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

(Se vuoi provare, sostituisci @file{screech-and-boink.ly} con qualsiasi file @file{.ly}
che si trovi nella stessa directory di questo file.)

\end{document}

Elaborazione

Salva il codice precedente in un file chiamato lilybook.lytex, quindi esegui in un terminale

lilypond-book --output=out --pdf lilybook.lytex
lilypond-book (GNU LilyPond) 2.25.21 
Lettura di lilybook.lytex...
…tagliato molto output…
Compilazione di lilybook.tex...
cd out
pdflatex lilybook.tex
…tagliato molto output…
xpdf lilybook.pdf
(sostituisci xpdf col tuo lettore PDF preferito)

L’esecuzione di lilypond-book e pdflatex crea molti file temporanei e questo potrebbe rendere disordinata la directory di lavoro. Per ovviare a questo inconveniente, è consigliabile usare l’opzione --output=dir. In questo modo i file verranno salvati in una sottodirectory dir separata.

Infine ecco il risultato dell’esempio in LaTeX.³ Si conclude qui la parte di tutorial.

Output

I documenti per lilypond-book possono combinare liberamente musica e testo. Usando la sintassi di Texinfo, questo esempio

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

produce

Si possono aggiungere delle opzioni per modificare l’aspetto dei frammenti. Usando la sintassi di LaTeX, questo esempio

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

produce

Frammenti musicali più grandi possono essere messi in file indipendenti. Usando la sintassi HTML, questo esempio

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

produce

Perché sia visibile la tagline, predefinita o personalizzata, l’intero frammento deve essere compreso in un costrutto \book { }.

\book{
  \header{ title = "Una scala in LilyPond" }

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