[ << lilypond-book ][Inizio][Contenuti][Indice][ Programmi esterni >> ]
[ < lilypond-book ][ Su : lilypond-book ][]

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

[image of music]

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

[image of music]

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

[image of music]

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

[image of music]

Note a piè di pagina

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

[ << lilypond-book ][Inizio][Contenuti][Indice][ Programmi esterni >> ]
[ < lilypond-book ][ Su : lilypond-book ][]

<< Torna all'indice della documentazione

LilyPond — Utilizzo v2.24.4 (ramo stabile).