LilyPond: manuale d'uso del programma: 3.1 Un esempio di documento musicologico

## 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.24.4
>     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.1 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 }
    }

### Note a piè di pagina

[1] Questo tutorial è elaborato da Texinfo, dunque l’esempio produce dei risultati leggermente diversi nella formattazione.

#### LilyPond — Utilizzo v2.24.4 (ramo stabile).