LilyPond — Utilizzo

1.1 Uso normale

La maggior parte degli utenti esegue LilyPond attraverso un’interfaccia grafica (GUI); se non lo hai già fatto, leggi il Tutorial. Se usi un editor diverso per scrivere i file LilyPond, leggi la documentazione di quel programma.

1.2 Uso da linea di comando

Questa sezione contiene informazioni aggiuntive sull’uso di LilyPond da linea di comando. Questo può essere utile per assegnare opzioni aggiuntive al programma. Inoltre, ci sono alcuni programmi complementari di ‘aiuto’ (come midi2ly) che funzionano solo da linea di comando.

Con ‘linea di comando’ si intende la linea di comando del sistema operativo. Gli utenti Windows avranno più familiarità con i termini ‘shell DOS’ o ‘shell dei comandi’. Gli utenti MacOS X avranno più familiarità con i termini ‘terminale’ o ‘console’.

Descrivere come usare questa parte di un sistema operativo non rientra negli obiettivi di questo manuale; si prega di consultare altra documentazione su questo argomento se non si conosce la linea di comando.

lilypond [opzione]… file…

#(define output-suffix "violino")
\score { … }
#(define output-suffix "violoncello")
\score { … }

lilypond *.ly

lilypond file.ly 1> stdout.txt

lilypond file.ly 2> stderr.txt

lilypond file.ly &> all.txt

find . -name '*.ly' -exec lilypond '{}' \;

forfiles /s /M *.ly /c "cmd /c lilypond @file"

forfiles /s /p C:\Documents\MyScores /M *.ly /c "cmd /c lilypond @file"

forfiles /s /p "C:\Documents\My Scores" /M *.ly /c "cmd /c lilypond @file"

comando chiave=valore

set? FONTCONFIG_FILE=$INSTALLER_PREFIX/etc/fonts/fonts.conf
prependdir GUILE_LOAD_PATH=$INSTALLER_PREFIX/share/guile/1.8

#!/bin/sh
## Impostazioni predefinite

username=lily
home=/home
loopdevice=/dev/loop0
jaildir=/mnt/lilyloop
# Il prefisso (senza la barra iniziale!)
lilyprefix=usr/local
# La directory di sistema in cui è installato lilypond
lilydir=/$lilyprefix/lilypond/

userhome=$home/$username
loopfile=$userhome/loopfile
adduser $username
dd if=/dev/zero of=$loopfile bs=1k count=200000
mkdir $jaildir
losetup $loopdevice $loopfile
mkfs -t ext3 $loopdevice 200000
mount -t ext3 $loopdevice $jaildir
mkdir $jaildir/lilyhome
chown $username $jaildir/lilyhome
cd $jaildir

mkdir -p bin usr/bin usr/share usr/lib usr/share/fonts $lilyprefix tmp
chmod a+w tmp

cp -r -L $lilydir $lilyprefix
cp -L /bin/sh /bin/rm bin
cp -L /usr/bin/convert /usr/bin/gs usr/bin
cp -L /usr/share/fonts/truetype usr/share/fonts

# Ora la magica ricopiatura della libreria
for i in "$lilydir/usr/bin/lilypond" "$lilydir/usr/bin/guile" "/bin/sh"  \
  "/bin/rm" "/usr/bin/gs" "/usr/bin/convert"; do ldd $i | sed 's/.*=>  \
    \/\(.*\/\)\([^(]*\).*/mkdir -p \1 \&\& cp -L \/\1\2 \1\2/' | sed  \
      's/\t\/\(.*\/\)\(.*\) (.*)$/mkdir -p \1 \&\& cp -L \/\1\2 \1\2/'  \
        | sed '/.*=>.*/d'; done | sh -s

# I file condivisi per Ghostscript...
      cp -L -r /usr/share/ghostscript usr/share
# I file condivisi per ImageMagick
      cp -L -r /usr/lib/ImageMagick* usr/lib

### Ora, assumendo di avere test.ly in /mnt/lilyloop/lilyhome,
### si dovrebbe poter eseguire:
### Nota che /$lilyprefix/bin/lilypond è uno script, che imposta la variabile
### LD_LIBRARY_PATH - questo è cruciale
      /$lilyprefix/bin/lilypond -jlily,lily,/mnt/lilyloop,/lilyhome test.ly

1.3 Messaggi di errore

Quando si compila un file possono apparire vari messaggi di errore:

Avvertimento ¶

Qualcosa appare sospetto. Se stai cercando di fare qualcosa di insolito allora comprenderai il messaggio e potrai ignorarlo. Tuttavia di solito i messaggi di avvertimento indicano che il file di input ha qualcosa che non va.

Errore ¶

C’è qualcosa di assolutamente sbagliato. Il passo attualmente in elaborazione (analisi, interpretazione o formattazione) verrà completato, ma il passo successivo verrà saltato.

Errore fatale ¶

C’è qualcosa di assolutamente sbagliato e LilyPond non può continuare. Questo accade raramente. La causa più comune è un’errata installazione dei tipi di carattere.

Errore Scheme ¶

Gli errori che capitano mentre si esegue del codice Scheme sono individuati dall’interprete Scheme. Se si esegue con l’opzione di prolissità (-V o --verbose), viene stampata una traccia della chiamata di funzione responsabile dell’errore.

Errore di programmazione ¶

Si è verificata una qualche incongruenza interna. Questi messaggi di errore servono ad aiutare programmatori e debugger. Di solito si possono ignorare. Talvolta sono talmente numerosi da nascondere il resto dell’output.

Sospeso (core dumped) ¶

Segnala un serio errore di programmazione che ha mandato in crash il programma. Questi errori sono considerati critici. Se ti imbatti in un errore simile, invia una segnalazione di errore.

Se gli avvertimenti e gli errori possono essere collegati a una parte specifica del file di input, i messaggi di errore hanno la seguente forma

file:riga:colonna: messaggio
riga di input responsabile dell'errore

Nella riga responsabile si inserisce un a capo per indicare la colonna in cui è stato trovato l’errore. Ad esempio,

test.ly:2:19: error: not a duration: 5
  { c'4 e'
           5 g' }

Queste posizioni indicano il punto in cui LilyPond ritiene più probabile che siano apparsi l’avvertimento o l’errore, ma (per loro stessa natura) avvertimenti ed errori capitano quando succede qualcosa di imprevisto. Se non riesci a vedere un errore nella riga suggerita, prova a controllare una o due righe sopra la posizione indicata.

Attenzione: l’analisi degli errori è sempre attivata nel corso dei vari passaggi di elaborazione. Per esempio, se ci sono parti di input che sono elaborati varie volte (es: per produrre l’output midi e quello grafico) oppure se viene usata la stessa variabile musicale in vari contesti, potrebbe apparire lo stesso messaggio molteplici volte. Anche la diagnosi eseguita in uno degli ‘ultimi’ passaggi (es: controlli di battuta) può apparire varie volte.

Maggiori informazioni sugli errori si trovano in Errori comuni.

1.4 Errori comuni

Le condizioni di errore descritte di seguito capitano spesso, ma la causa non è ovvia né facile da trovare. Una volta che sono state individuate e comprese, è facile gestirle.

\override VerticalAxisGroup.staff-affinity = ##f

\score {
  % Invalido! Genera l'errore: errore di sintassi, \new inaspettato
  \new Staff { … }
  \new Staff { … }
}

2.1 Perché la sintassi cambia?

Le modifiche della sintassi di solito servono a rendere l’input più facile sia da leggere che da scrivere e talvolta ad aggiungere a LilyPond nuove funzionalità o miglioramenti di funzioni esistenti.

Ecco un esempio reale:

Tutti i nomi delle proprietà di \paper e \layout dovrebbero essere scritte nella forma primo-secondo-terzo. Tuttavia, nella versione 2.11.60 è emerso che la proprietà printallheaders non seguiva questa convenzione. Questa proprietà doveva essere lasciata così come era (confondendo i nuovi utenti con un formato di input incoerente), o doveva essere cambiata (disturbando i vecchi utenti con file di input già scritti)?

Fu deciso di cambiare il nome della proprietà in print-all-headers, e tramite il comando convert-ly i vecchi utenti avevano a disposizione uno strumento per aggiornare automaticamente i propri file di input.

Tuttavia il comando convert-ly non è sempre in grado di gestire tutti i cambiamenti di sintassi. Nelle versioni di LilyPond precedenti la versione 2.4.2, gli accenti e i caratteri non inglesi venivano inseriti con la notazione standard di LaTeX. Per esempio, per inserire la parola francese che significa ‘Natale’ si usava No\"el. Ma nelle versioni successive di LilyPond, il carattere speciale ë deve essere inserito direttamente come carattere UTF-8. Il comando convert-ly non può sostituire i caratteri speciali di LaTeX con i rispettivi caratteri UTF-8, dunque è necessario aggiornare a mano i vecchi file di input di LilyPond.

Le regole di conversione del comando convert-ly si basano sulla ricerca e sostituzione di parole chiave (piuttosto che su una completa ‘comprensione’ del contesto di ciò che sta cambiando in un certo file di input). Ciò comporta varie conseguenze:

• L’affidabilità della conversione dipende dalla qualità di ciascun insieme di regole applicate e dalla complessità del rispettivo cambiamento. Talvolta le conversioni richiedono correzioni manuali ulteriori, quindi il file originale deve essere conservato per poterlo confrontare in caso di necessità.
• Sono possibili solo conversioni ai cambi di sintassi più recenti: non ci sono regole per tornare a una versione precedente di LilyPond. Dunque il file di input deve essere aggiornato soltanto quando le versioni precedenti di LilyPond non sono più mantenute. Di nuovo, il file di input originale deve essere conservato per ogni evenienza, magari usando sistemi di controllo di versione (es.: Git) per semplificare la gestione di versioni multiple dei file di input.
• LilyPond ha delle robuste difese quando elabora spazi omessi o posizionati in modo ‘originale’, ma le regole usate da convert-ly tendono spesso a dare per scontato certe forme stilistiche. Seguire lo stile di input usato nei manuali di LilyPond è dunque la via più sicura per aggiornamenti indolori, soprattutto perché gli esempi dei manuali stessi sono tutti aggiornati col comando convert-ly.

2.2 Utilizzo di convert-ly

Il comando convert-ly usa il numero specificato da \version nel file di input per determinare versioni precedenti. Nella maggior parte dei casi per aggiornare il file di input è sufficiente eseguire:

convert-ly -e miofile.ly

nella directory che contiene il file di input. Questo comando aggiornerà miofile.ly e preserverà il file originale rinominandolo miofile.ly~. Verrà modificato anche il numero di \version nel file di input aggiornato, insieme agli aggiornamenti di sintassi richiesti.

Dopo averlo lanciato, il comando convert-ly elencherà i numeri di versione per i quali sono state eseguite le conversioni. Se non vengono elencati dei numeri di versione il file è già aggiornato e utilizza la sintassi LilyPond più recente.

Per convertire tutti i file di input in una directory si usa:

convert-ly -e *.ly

Sia gli utenti Linux che MacOS X possono usare le rispettive applicazioni del terminale, ma gli utenti MacOS X possono anche eseguire questo comando direttamente dalla voce di menu Compila > Aggiorna la sintassi.

Un utente Windows deve eseguire il comando:

convert-ly.py -e *.ly

inserendolo in un prompt dei comandi, che di solito si trova in Start > Accessori > Prompt dei comandi o, per gli utenti della versione 8, scrivendo ‘prompt dei comandi’ nella finestra di ricerca.

Per convertire tutti i file di input che si trovano in diverse sottodirectory:

find . -name '*.ly' -exec convert-ly -e '{}' \;

Questo esempio cerca e converte tutti i file di input nella directory corrente e in tutte le sue sottodirectory ricorsivamente. I file convertiti saranno salvati nella stessa directory insieme all’originale rinominato. Dovrebbe funzionare anche per gli utenti MacOS X, anche se solo tramite l’applicazione del terminale.

Gli utenti Windows devono usare:

forfiles /s /M *.ly /c "cmd /c convert-ly.py -e @file"

Altrimenti, si può indicare un percorso esplicito alla cartella che contiene tutte le sottocartelle con i file di input tramite l’opzione /p:

forfiles /s /p C:\Documents\MyScores /M *.ly /c "cmd /c convert-ly.py -e @file"

Tale percorso, se contiene spazi, deve essere racchiuso tra virgolette doppie:

forfiles /s /p "C:\Documents\My Scores" /M *.ly /c "cmd /c convert-ly.py -e @file"

2.3 Opzioni da linea di comando per convert-ly

Il programma viene lanciato in questo modo:

convert-ly [opzione]… nomefile…

Esistono le seguenti opzioni:

-d, --diff-version-update

aumenta il numero di versione in \version solo se il file è stato modificato da convert-ly. In questo caso, la dichiarazione di versione corrisponderà alla versione successiva all’ultimo reale cambiamento. Il numero di una versione instabile sarà arrotondato al numero della versione stabile successiva, a meno che ciò non vada oltre il numero di versione obiettivo. Senza questa opzione, la versione rifletterà l’ultima conversione tentata.

-e, --edit

Applica le conversioni direttamente nel file di input, modificando l’originale. Il file originale viene rinominato nomefile.ly~. Questo file di backup può essere un file nascosto in alcuni sistemi operativi. Altrimenti, se si desidera specificare un nome diverso per il file aggiornato senza usare il predefinito ~ dell’opzione -e appeso al vecchio file di input, si può usare la redirezione dell’output:

convert-ly miofile.ly > mionuovofile.ly

Gli utenti Windows devono usare:

convert-ly.py miofile.ly > mionuovofile.ly

-b, --backup-numbered

Se usato insieme all’opzione ‘-e’, aggiunge un numero al nome dei file di backup, in modo da non sovrascrivere i backup precedenti. I file di backup possono essere nascosti in alcuni sistemi operativi.

-f, --from=from-patchlevel

Imposta la versione da cui convertire. Se non viene impostata, convert-ly la ricaverà dalla stringa \version presente nel file. Esempio: --from=2.10.25

-h, --help

Mostra la schermata di aiuto.

-l loglevel, --loglevel=loglevel

Imposta la verbosità dell’output su loglevel. I valori possibili, in caratteri maiuscoli, sono PROGRESS (predefinito), NONE, WARN, ERROR e DEBUG.

-n, --no-version

Normalmente convert-ly aggiunge un indicatore \version nell’output. Questa opzione lo impedisce.

-s, --show-rules

Mostra tutte le conversioni conosciute ed esce.

-t, --to=to-patchlevel

Imposta esplicitamente la versione obiettivo della conversione, altrimenti viene usato il valore più recente. Deve essere maggiore della versione iniziale.

convert-ly --to=2.14.1 miofile.ly

Per aggiornare i frammenti LilyPond presenti nei file texinfo, si usa

convert-ly --from=… --to=… --no-version *.itely

Per vedere i cambiamenti della sintassi di LilyPond tra due versioni, si usa

convert-ly --from=… --to=… -s

2.4 Problemi nell’eseguire convert-ly

Quando si esegue convert-ly in una finestra del Prompt dei comandi in Windows su un file il cui nome o percorso contengano degli spazi, è necessario includere tutto il nome del file di input con tre (!) virgolette doppie:

convert-ly """D:/Mie Partiture/Ode.ly""" > "D:/Mie Partiture/new Ode.ly"

Se il semplice comando convert-ly -e *.ly non funziona perché la linea di comando espansa diventa troppo lunga, si può inserire il comando convert-ly in un loop. Questo esempio per UNIX aggiornerà tutti i file .ly nella directory corrente

for f in *.ly; do convert-ly -e $f; done;

Nella finestra del Prompt dei comandi di Windows il comando corrispondente è

for %x in (*.ly) do convert-ly -e """%x"""

Non vengono gestiti tutti i cambiamenti del linguaggio. Si può specificare solo un’opzione di output. È piuttosto improbabile che si aggiornino automaticamente il codice scheme e le interfacce di Scheme di LilyPond; tieniti pronto a correggere a mano il codice Scheme.

2.5 Conversioni manuali

In teoria, un programma come convert-ly potrebbe gestire qualsiasi cambiamento di sintassi. Dopo tutto, un programma per computer interpreta la vecchia versione e la nuova versione, quindi un altro programma può tradurre un file in un altro².

Tuttavia il progetto LilyPond ha risorse limitate: non tutte le conversioni sono compiute automaticamente. Di seguito è riportato l’elenco dei problemi noti.

1.6->2.0:
 Doesn't always convert figured bass correctly, specifically things like {<
>}.  Mats' comment on working around this:
   To be able to run convert-ly
   on it, I first replaced all occurrences of '{<' to some dummy like '{#'
   and similarly I replaced '>}' with '&}'.  After the conversion, I could
   then change back from '{ #' to '{ <' and from '& }' to '> }'.
 Doesn't convert all text markup correctly.  In the old markup syntax,
 it was possible to group a number of markup commands together within
parentheses, e.g.
   -#'((bold italic) "string")
   This will incorrectly be converted into
   -\markup{{\bold italic} "string"}
   instead of the correct
   -\markup{\bold \italic "string"}
2.0->2.2:
 Doesn't handle \partCombine
 Doesn't do \addlyrics => \lyricsto, this breaks some scores with multiple
stanzas.
2.0->2.4:
 \magnify isn't changed to \fontsize.
    - \magnify #m => \fontsize #f, where f = 6ln(m)/ln(2)
 remove-tag isn't changed.
    - \applyMusic #(remove-tag '. . .) => \keepWithTag #'. . .
 first-page-number isn't changed.
    - first-page-number no => print-first-page-number = ##f
 Line breaks in header strings aren't converted.
    - \\\\  as line break in \header strings => \markup \center-align <
      "First Line" "Second Line" >
 Crescendo and decrescendo terminators aren't converted.
    - \rced => \!
    - \rc => \!
2.2->2.4:
 \turnOff (used in \set Staff.VoltaBracket = \turnOff) is not properly
converted.
2.4.2->2.5.9
 \markup{ \center-align <{ ... }> } should be converted to:
 \markup{ \center-align {\line { ... }} }
 but now, \line is missing.
2.4->2.6
 Special LaTeX characters such as $~$ in text are not converted to UTF8.
2.8
 \score{} must now begin with a music expression.  Anything else
 (particularly \header{}) must come after the music.

2.6 Scrivere codice che funzioni su molteplici versioni

In alcuni casi, in particolare quando si scrive codice destinato a funzionare come libreria, è opportuno far sì che supporti molteplici versioni di LilyPond nonostante le modifiche della sintassi. Per farlo si possono avvolgere porzioni alternative di codice in espressioni condizionali che dipendono dalla versione di LilyPond attualmente eseguita. La funzione Scheme ly:version? prevede un operatore di confronto op e una versione di riferimento ver passata come elenco di interi di massimo tre elementi. Gli elementi mancanti vengono ignorati, quindi '(2 20) equivale a qualsiasi versione della serie di versioni 2.20. Sono possibili costrutti come il seguente:

#(cond
  ((ly:version? > '(2 20))
   (ly:message "Questo è il codice da eseguire per LilyPond 2.20 o successivi"))
  ((ly:version? = '(2 19 57))
   (ly:message "Questo verrà eseguito soltanto con LilyPond 2.19.57"))
  (else (ly:message "Questo verrà eseguito con qualsiasi altra versione")))

Solitamente questa funzione viene integrata nelle funzioni di una libreria, per consentire l’uso di sintassi alternativa, ma è anche possibile usare il confronto direttamente nell’input musicale, come nell’esempio seguente:

{
  c' d' e' f'
  #(if (ly:version? = '(2 21))
       #{ \override NoteHead.color = #red #}
       #{ \override NoteHead.color = #blue #})
  g' a' b' c''
}

Nota: Questa funzione è stata introdotta in LilyPond 2.21.80, dunque non è possibile fare confronti usando versioni precedenti.

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

3.2 Integrare musica e testo

Questa sezione spiega in dettaglio come integrare LilyPond in vari formati di output.

\begin{lilypond}[le,opzioni,vanno,qui]
  CODICE LILYPOND
\end{lilypond}

\lilypondfile[le,opzioni,vanno,qui]{nomefile}

\musicxmlfile[le,opzioni,vanno,qui]{nomefile}

\begin{lilypond}[quote,fragment,staffsize=26]
  c' d' e' f' g'2 g'2
\end{lilypond}

\lilypond[quote,fragment,staffsize=11]{<c' e' g'>}

\def\betweenLilyPondSystem#1{\endinput}

\begin{lilypond}[fragment]
  c'1\( e'( c'~ \break c' d) e f\)
\end{lilypond}

\def\betweenLilyPondSystem#1{
    \ifnum#1<2\else\expandafter\endinput\fi
}

\let\betweenLilyPondSystem\undefined

\def\onlyFirstNSystems#1{
    \def\betweenLilyPondSystem##1{%
      \ifnum##1<#1\else\expandafter\endinput\fi}
}

\onlyFirstNSystems{3}
\begin{lilypond}…\end{lilypond}
\onlyFirstNSystems{1}
\begin{lilypond}…\end{lilypond}

@lilypond[le,opzioni,vanno,qui]
  IL TUO CODICE LILYPOND
@end lilypond

@lilypond[le,opzioni,vanno,qui]{ IL TUO CODICE LILYPOND }

@lilypondfile[le,opzioni,vanno,qui]{nomefile}

@musicxmlfile[le,opzioni,vanno,qui]{nomefile}

@lilypond[quote,fragment]
c'4 d' e' f' g'2 g'
@end lilypond

@lilypond[quote,fragment,staffsize=11]{<c' e' g'>}

<lilypond le opzioni vanno qui>
  CODICE LILYPOND
</lilypond>

<lilypond le opzioni vanno qui: CODICE LILYPOND />

<lilypondfile le opzioni vanno qui>nomefile</lilypondfile>

<musicxmlfile le opzioni vanno qui>nomefile</musicxmlfile>

<lilypond quote fragment staffsize=26>
  c'4 d' e' f' g'2 g'
</lilypond>

<lilypond quote fragment staffsize=11: <c' e' g'> />

<mediaobject>
  <imageobject>
    <imagedata fileref="music1.ly" role="printfilename" />
  </imageobject>
</mediaobject>

<inlinemediaobject>
  <textobject>
    <programlisting language="lilypond" role="fragment verbatim staffsize=16 ragged-right relative=2">
\context Staff \with {
  \remove Time_signature_engraver
  \remove Clef_engraver}
  { c4( fis) }
    </programlisting>
  </textobject>
</inlinemediaobject>

3.3 Opzioni dei frammenti musicali

Nelle pagine che seguono, per ‘comando LilyPond’ si intende un qualsiasi comando descritto nelle sezioni precedenti che sia gestito da lilypond-book per produrre un frammento musicale. Per semplicità, i comandi LilyPond vengono mostrati soltanto nella sintassi LaTeX.

Nota che la stringa delle opzioni è analizzata da sinistra a destra; se un’opzione ricorre più di una volta, viene applicata nella sua ultima occorrenza.

Sono disponibili le seguenti opzioni per i comandi LilyPond:

staffsize=altezza

Imposta la dimensione del pentagramma a altezza, misurata in punti.

ragged-right

Produce linee con margine destro irregolare e spaziatura naturale, ovvero viene aggiunto ragged-right = ##t al frammento LilyPond. Frammenti con un solo rigo avranno sempre il margine destro irregolare, a meno che non venga specificato esplicitamente noragged-right.

noragged-right

Per i frammenti di una sola linea, fa sì che la lunghezza del rigo venga estesa fino a coincidere con la larghezza della linea, ovvero viene aggiunto ragged-right = ##f al frammento LilyPond.

line-width

line-width=dimensione\unità

Imposta la lunghezza della linea a dimensione (espressa in unità). unità può essere una delle seguenti: cm, mm, in o pt. Questa opzione riguarda l’output LilyPond (ovvero, la lunghezza del rigo del frammento musicale), non la formattazione del testo.

Se usato senza un argomento, imposta la lunghezza della linea a un valore predefinito (calcolato da un algoritmo euristico).

Se non viene assegnata un’opzione line-width, lilypond-book cerca di indovinare un valore predefinito per gli ambienti lilypond che non usano l’opzione ragged-right.

papersize=stringa

Imposta la dimensione del foglio su stringa (ad esempio, a5 o letter) per i frammenti musicali che usano \book. Vedi Formati carta predefiniti per un elenco delle dimensioni del foglio disponibili.

Questa opzione riguarda l’output LilyPond (ovvero, la dimensione del foglio del frammento musicale), non la formattazione del testo. Valori sconosciuti di stringa vengono ignorati: viene emesso un avviso e il frammento viene elaborato usando la dimensione predefinita a4.

paper-width=dimensione\unità

Imposta la larghezza del foglio su dimensione (espressa in unità) per i frammenti musicali che usano \book. unità è uno dei seguenti: cm, mm, in o pt.

Questa opzione riguarda l’output LilyPond (ovvero, la larghezza del foglio del frammento musicale), non la formattazione del testo. Se impostata, sovrascrive l’opzione papersize se presente. Se l’opzione paper-height non è specificata, l’altezza del foglio è impostata sull’altezza del foglio A4 predefinito (296mm).

paper-height=dimensione\unità

Imposta l’altezza del foglio su dimensione (espressa in unit) per i frammenti musicali che usano \book. unità è uno dei seguenti: cm, mm, in o pt.

Questa opzione riguarda l’output LilyPond (ovvero, l’altezza del foglio del frammento musicale), non la formattazione del testo. Se impostata, sovrascrive l’opzione papersize se presente. Se l’opzione paper-width non è specificata, la larghezza del foglio è impostata sulla larghezza del foglio A4 predefinito (210mm).

Example:

\lilypond[paper-width=10\cm, paper-height=57\mm]{
  \book {
    ...
  }
}

notime

Non viene visualizzata l’indicazione di tempo e disabilita i segni relativi alla scansione ritmica (segno di tempo, barre di divisione) nella partitura.

fragment

Fa sì che lilypond-book aggiunga del codice boilerplate in modo che sia possibile inserire semplicemente, ad esempio,

c'4

senza \layout, \score, etc.

nofragment

Non aggiunge del codice ulteriore per completare il codice LilyPond nei frammenti musicali. Essendo l’impostazione predefinita, nofragment di norma è ridondante.

inline

Imposta il frammento per l’uso “in linea”, ovvero all’interno di un paragrafo. Il frammento viene formattato con un padding sinistro molto piccolo (circa lo stesso del padding destro), ignorando il valore dato dall’opzione a linea di comando --left-padding.

Per l’output Texinfo, sopprime l’inserimento di una riga vuota prima e dopo il frammento. Per l’output HTML, sopprime l’inserimento di <p> prima e di </p> dopo il frammento.

Per far sì che un frammento appaia davvero in linea nella modalità LaTeX e Texinfo, è necessario posizionarlo all’interno di un paragrafo, evitando una riga vuota prima e dopo il frammento. Per esempio

Il motivo
\lilypond[inline,staffsize=11]{
  { \time 2/4 r8 g'[ g' g'] | es'2 }
}
è ben noto.

diventa

Il motivo è ben noto.

indent=dimensione\unità

Imposta l’indentazione del primo sistema musicale a dimensione (espressa in unità). unità è una delle seguenti: cm, mm, in o pt. Questa opzione riguarda LilyPond, non la formattazione del testo.

noindent

Imposta l’indentazione del primo sistema musicale su zero. Questa opzione interessa LilyPond, non la formattazione del testo. L’assenza di indentazione è l’impostazione predefinita, dunque normalmente noindent è ridondante.

quote

Riduce la lunghezza della linea di un frammento musicale di 2*0.4in e inserisce l’output in un blocco per le citazioni. Il valore ‘0.4in’ può essere controllato con l’opzione exampleindent.

exampleindent

Imposta la quantità di spazio con cui l’opzione quote indenta un frammento musicale.

relative

relative=n

Usa la modalità di ottava relativa. Per impostazione predefinita, le altezze delle note sono riferite al Do centrale. L’argomento opzionale del numero intero specifica l’ottava della nota iniziale: il valore predefinito 1 è il Do centrale. L’opzione relative funziona solo quando è impostata l’opzione fragment, quindi fragment è implicitamente sottinteso da relative, a prescindere dalla presenza dell’opzione (no)fragment nel sorgente.

LilyPond usa lilypond-book anche per produrre la propria documentazione. A questo scopo, esistono altre opzioni più complesse per i frammenti musicali.

verbatim

L’argomento di un comando LilyPond viene copiato nel file di output e racchiuso in un blocco di testo, seguito da qualsiasi testo assegnato con l’opzione intertext (non ancora implementato); quindi viene mostrata la musica vera e propria. Questa opzione non funziona bene con \lilypond{} se fa parte di un paragrafo.

Se verbatim viene usato in un comando lilypondfile, è possibile includere il testo di una parte soltanto del file sorgente. Se il file sorgente ha un commento contenente ‘begin verbatim’ (senza virgolette), la citazione del sorgente nel blocco testuale inizierà dopo l’ultima occorrenza di tale commento; in modo analogo, la citazione del testo sorgente si fermerà proprio prima della prima occorrenza di un commento contenente ‘end verbatim’, se presente. Nel seguente file sorgente di esempio, la musica viene interpretata in modalità relativa ma il blocco testuale non mostrerà il blocco relative, ovvero

\relative { % begin verbatim
  c'4 e2 g4
  f2 e % end verbatim
}

mostrerà il seguente blocco testuale

  c4 e2 g4
  f2 e

Se si desidera tradurre i commenti e i nomi delle variabili nell’output verbatim ma non nei sorgenti, si può impostare la variabile d’ambiente LYDOC_LOCALEDIR sul percorso di una directory; la directory deve contenere un albero dei cataloghi di messaggio .mo che hanno lilypond-doc come dominio.

texidoc

(Solo per l’output Texinfo.) Se lilypond viene lanciato con l’opzione --header=texidoc e il file da elaborare si chiama foo.ly, verrà creato un file foo.texidoc a patto che ci sia un campo texidoc nel blocco \header. L’opzione texidoc fa sì che lilypond-book includa tali file, aggiungendo il loro contenuto in forma di blocco di documentazione proprio prima del frammento di musica (ma fuori dall’ambiente example generato da un’opzione quote).

Se il file foo.ly contiene

\header {
  texidoc = "Questo file mostra il funzionamento di una singola nota."
}
{ c'4 }

e il documento Texinfo test.texinfo contiene

@lilypondfile[texidoc]{foo.ly}

il seguente comando produce il risultato atteso

lilypond-book --pdf --process="lilypond \
  --header=texidoc" test.texinfo

Per la maggior parte, i documenti di test di LilyPond (nella directory input della distribuzione) sono piccoli file .ly che hanno esattamente questo aspetto.

Ai fini della localizzazione, se il documento Texinfo document contiene @documentlanguage LANG e l’header di foo.ly contiene un campo texidocLANG, quando si lancia lilypond con l’opzione --header=texidocLANG verrà incluso foo.texidocLANG invece di foo.texidoc.

doctitle

(Solo per l’output Texinfo.) Questa opzione funziona in modo simile all’opzione texidoc: se lilypond viene lanciato con l’opzione --header=doctitle e il file da elaborare si chiama foo.ly e contiene un campo doctitle nel blocco \header, viene creato un file foo.doctitle. Se si usa l’opzione doctitle, i contenuti di foo.doctitle, che dovrebbero trovarsi su una singola linea di text, vengono inseriti nel documento Texinfo come @lydoctitle text. @lydoctitle è una macro definita nel documento Texinfo. Lo stesso discorso relativo all’elaborazione texidoc delle lingue localizzate si applica anche a doctitle.

nogettext

(Solo per l’output Texinfo.) Non tradurre i commenti e i nomi delle variabili nel blocco testuale del frammento citato.

printfilename

Se un file di input di LilyPond viene incluso con \lilypondfile, il nome del file viene mostrato immediatamente prima del frammento musicale. Per l’output HTML, questo nome è un collegamento. Viene mostrata solo la base del nome del file, ovvero viene tolta la parte che costituisce il percorso del file.

3.4 Utilizzo di lilypond-book

lilypond-book crea un file con una delle seguenti estensioni: .tex, .texi, .html o .xml, a seconda del formato dell’output. Tutti i file .tex, .texi e .xml necessitano di un’ulteriore elaborazione.

Istruzioni specifiche di ogni formato

LaTeX

Esistono due modi di elaborare il documento LaTeX per la stampa o la pubblicazione: generare direttamente un file PDF tramite PDFLaTeX oppure generare un file PostScript tramite LaTeX, attraverso un traduttore da DVI a PostScript come dvips. Il primo modo è più semplice e raccomandato⁴, e indipendentemente da quello che userai, puoi convertire facilmente PostScript e PDF con strumenti come ps2pdf e pdf2ps inclusi nel pacchetto Ghostscript.

Per creare un file PDF con PDFLaTeX, si usa:

lilypond-book --pdf tuofile.lytex
pdflatex tuofile.tex

Per produrre l’output PDF attraverso LaTeX/dvips/ps2pdf:

lilypond-book tuofile.lytex
latex tuofile.tex
dvips -Ppdf tuofile.dvi
ps2pdf tuofile.ps

Il file .dvi creato da questa sequenza non conterrà le teste delle note. È normale; se si seguono le istruzioni, le teste verranno incluse nei file .ps e .pdf.

L’esecuzione di dvips potrebbe generare dei messaggi di avviso relativi ai caratteri; questi messaggi sono innocui e possono essere ignorati. Se esegui latex in modalità due colonne, ricorda di aggiungere -t landscape alle opzioni di dvips.

Gli ambienti come:

\begin{lilypond} … \end{lilypond}

non sono interpretati da LaTeX. lilypond-book estrae questi ‘ambienti’ e li copia in file in un suo formato per poter eseguire LilyPond su di essi. Prende quindi gli elementi grafici risultanti e crea un file .tex dove le macro \begin{lilypond}…\end{lilypond} sono poi sostituite da comandi di ‘inclusione di immagini’. È a questo punto che LaTeX viene eseguito (anche se LaTeX è stato eseguito in precedenza, in realtà ha agito su un documento ‘vuoto’ solo per fare alcuni calcoli, come per esempio di \linewidth).

Problemi noti e avvertimenti

Il comando \pageBreak non funziona all’interno dell’ambiente \begin{lilypond} … \end{lilypond}.

Molte variabili del blocco \paper non funzionano all’interno dell’ambiente \begin{lilypond} … \end{lilypond}. Usa \newcommand con \betweenLilyPondSystem nel preambolo;

\newcommand{\betweenLilyPondSystem}[1]{\vspace{36mm}\linebreak}

Texinfo

Per generare un documento Texinfo (in qualsiasi formato di output), si seguono le normali procedure usate con Texinfo; ovvero, si lancia texi2pdf o texi2dvi o texi2any, a seconda del formato di output che si vuole creare. Per impostazione predefinita, texi2pdf usa pdftex per l’elaborazione, come si può verificare nella console di output. In questo caso, eseguire lilypond-book con l’opzione --pdf per creare frammenti .pdf invece di file .eps. Altrimenti pdftex, non essendo capace di includere i file in formato EPS, emetterà un messaggio di errore.

Si veda la documentazione di Texinfo per ulteriori dettagli.

Opzioni da linea di comando

lilypond-book accetta le seguenti opzioni da linea di comando.

-f formato

--format=formato

Specifica il tipo di documento da elaborare: html, latex, texi (il formato predefinito), texi-html o docbook. Se manca questa opzione, lilypond-book cerca di rilevare il formato automaticamente, si veda Estensioni dei nomi di file. Attualmente, texi-html è equivalente a texi.

-F filtro

--filter=filtro

Convoglia i frammenti attraverso il filtro. lilypond-book non esegue contemporaneamente il filtro e l’elaborazione. Ad esempio,

lilypond-book --filter='convert-ly --from=2.0.0 -' mio-libro.tely

lilypond-book non accetta le opzioni --filter e --process in contemporanea.

-h

--help

Mostra un breve messaggio di aiuto.

-I dir

--include=dir

Aggiunge dir al percorso di inclusione. Dato che lilypond-book cerca anche dei frammenti già compilati nel percorso di inclusione e non li riscrive nella directory di output, in alcuni casi è necessario eseguire ulteriori comandi come texi2any o latex con le stesse opzioni -I dir.

-l loglevel

--loglevel=loglevel

Imposta la verbosità dell’output su loglevel. I valori possibili sono NONE, ERROR, WARN, PROGRESS (predefinito) e DEBUG. Se questa opzione non viene usata e la variabile d’ambiente LILYPOND_BOOK_LOGLEVEL è impostata, il suo valore viene usato come livello di log.

-o dir

--output=dir

Salva i file generati nella directory dir. L’esecuzione di lilypond-book genera tanti piccoli file che LilyPond elaborerà. Per evitare tutto questo disordine nella directory dei sorgenti, si usa l’opzione da linea di comando --output e si entra in questa directory prima di eseguire latex o texi2any.

lilypond-book --output=out tuofile.lytex
cd out
…

--skip-lily-check

Non si arresta se non viene trovato l’output di LilyPond. Viene usata per generare la documentazione Info di LilyPond, che è priva di immagini.

--skip-png-check

Non si arresta se non vengono trovate immagini PNG per i file EPS. Viene usata per generare la documentazione Info di LilyPond, che è priva di immagini.

--lily-output-dir=dir

Scrive i file lily-XXX nella directory dir e crea un link nella directory --output. Si usa questa opzione per risparmiare tempo nella compilazione di documenti situati in directory diverse che condividono molti identici frammenti.

--lily-loglevel=loglevel

Imposta la verbosità dell’output del comando lilypond su loglevel. I valori possibili sono NONE, ERROR, WARN, BASIC, PROGRESS, INFO (predefinito) e DEBUG. Se questa opzione non viene usata e la variabile d’ambiente LILYPOND_LOGLEVEL è impostata, il suo valore viene usato come livello di log.

--info-images-dir=dir

Formatta l’output di Texinfo in modo che Info cerchi le immagini della musica nella directory dir.

--latex-program=prog

Lancia l’eseguibile prog invece di latex. Questa opzione è utile, ad esempio, se il documento è elaborato con xelatex.

--left-padding=quantità

Crea una spaziatura a sinistra tra i frammenti LilyPond utilizzando gli spazi bianchi.

quantità è arrotondata per eccesso in modo da essere un numero intero multiplo di un big point (bp). Un bp è 1/72 di un pollice (circa 0.353mm). quantità è assegnato in millimetri rispetto all’inizio del rigo. Il valore predefinito è 3.175mm (che equivale a 9bp).

La larghezza di sistemi molto densi può variare in base agli elementi della notazione come i numeri di battuta e i nomi degli strumenti che sono posti a sinistra dell’inizio del rigo. La spaziatura imposta la distanza minima tra il margine sinistro delle immagini dei frammenti e l’inizio dei righi (non indentati); ciò consente l’allineamento verticale desiderato dei frammenti nel documento principale.

Oltre a aggiungere la spaziatura a sinistra, questa opzione accorcia ciascun rigo di quantità. Di conseguenza, ciascuna linea viene spostata visivamente a destra.

-P comando

--process=comando

Elabora i frammenti di LilyPond con comando. Il comando predefinito è lilypond. lilypond-book non accetta le opzioni --filter e --process contemporaneamente.

--pdf

Crea i file PDF dei frammenti. Se non è impostato, vengono generati solo i file PNG e EPS. Utilizzare questa opzione se si vuole incorporare direttamente i file PDF nei file LaTeX o Texinfo.

--redirect-lilypond-output

Per impostazione predefinita, l’output dei log viene mostrato sul terminale. Questa opzione redirige tutto l’output in dei file di log nella stessa directory dei file sorgente.

--use-source-file-names

Salva i file di output dei frammenti con lo stesso nome, esclusa l’estensione, dei sorgenti. Questa opzione funziona solo con i frammenti inclusi col comando lilypondfile e solo se le directory indicate da --output-dir e --lily-output-dir sono diverse.

-V

--verbose

Mostra un output dettagliato. Questo è equivalente a --loglevel=DEBUG.

-v

--version

Mostra informazioni sulla versione.

Problemi noti e avvertimenti

Il comando Texinfo @pagesizes non viene interpretato. Allo stesso modo, i comandi LaTeX che modificano i margini e la larghezza della linea dopo il preambolo vengono ignorati.

Solo il primo \score di un blocco LilyPond viene elaborato.

3.5 Estensioni dei nomi di file

Si può usare qualsiasi estensione per il file di input, ma se non si usa l’estensione raccomandata per uno specifico formato potrebbe essere necessario specificare a mano il formato di output; per i dettagli si veda Utilizzo di lilypond-book. Altrimenti, lilypond-book sceglie automaticamente il formato di output in base all’estensione del file di input.

estensione	formato di output
.html	HTML
.htmly	HTML
.itely	Texinfo
.latex	LaTeX
.lytex	LaTeX
.lyxml	DocBook
.tely	Texinfo
.tex	LaTeX
.texi	Texinfo
.texinfo	Texinfo
.xml	HTML

Se si usa per il file di input la stessa estensione che lilypond-book usa per il file di output e se il file di input è nella stessa directory in cui lavora lilypond-book, bisogna usare l’opzione --output per far sì che lilypond-book sia eseguito; altrimenti si ferma e mostra un messaggio di errore simile a “L’output sovrascriverebbe il file di input”.

3.6 Modelli per lilypond-book

Ecco alcuni modelli da usare con lilypond-book. Se non hai familiarità con questo programma, consulta Eseguire lilypond-book.

LaTeX

Si possono includere frammenti LilyPond in un documento LaTeX.

\documentclass[]{article}

\begin{document}

Normale testo LaTeX.

\begin{lilypond}
\relative {
  a'4 b c d
}
\end{lilypond}

Altro testo LaTeX, seguito da alcune opzioni tra parentesi quadre.

\begin{lilypond}[fragment,relative=2,quote,staffsize=26,verbatim]
d4 c b a
\end{lilypond}
\end{document}

Texinfo

Si possono includere frammenti LilyPond in Texinfo; infatti questo intero manuale è scritto in Texinfo.

\input texinfo 
@ifnottex
@node Top
@top
@end ifnottex

Testo Texinfo

@lilypond
\relative {
  a4 b c d
}
@end lilypond

Altro testo Texinfo, seguito dalle opzioni tra parentesi.

@lilypond[verbatim,fragment,ragged-right]
d4 c b a
@end lilypond

@bye

html

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML>
<body>

<p>
I documenti per lilypond-book possono combinare liberamente musica e testo.  Ad
esempio,
<lilypond>
\relative {
  a'4 b c d
}
</lilypond>
</p>

<p>
Ancora un po' di LilyPond, questa volta con delle opzioni:

<lilypond fragment quote staffsize=26 verbatim>
a4 b c d
</lilypond>
</p>

</body>
</html>

xelatex

\documentclass{article}
\usepackage{ifxetex}
\ifxetex
%elementi specifici di xetex
\usepackage{xunicode,fontspec,xltxtra}
\setmainfont[Numbers=OldStyle]{Times New Roman}
\setsansfont{Arial}
\else
%Questo può essere lasciato vuoto se non si usa pdftex
\usepackage[T1]{fontenc}
\usepackage[utf8]{inputenc}
\usepackage{mathptmx}%Times
\usepackage{helvet}%Helvetica
\fi
%Qui è possibile inserire tutti i pacchetti inclusi anche in pdftex
\usepackage[ngerman,finnish,english]{babel}
\usepackage{graphicx}

\begin{document}
\title{Un breve documento con LilyPond e xelatex}
\maketitle

I comandi abituali di \textbf{font} interni al \emph{testo} funzionano,
perché \textsf{sono supportati da \LaTeX{} e XeteX.}
Se vuoi usare comandi specifici come \verb+\XeTeX+, devi
includerli nuovamente in un ambiente \verb+\ifxetex+.
You can use this to print the \ifxetex \XeTeX{} command \else
XeTeX command \fi which is not known to normal \LaTeX .

Nel testo normale si possono usare semplicemente i comandi LilyPond, come in
questo esempio:

\begin{lilypond}
{a2 b c'8 c' c' c'}
\end{lilypond}

\noindent
e così via.

I tipi di carattere dei frammenti inseriti con LilyPond devono essere impostati
all'interno dei frammenti stessi.  Si legga il manuale di Uso dell'applicazione per
sapere come usare lilypond-book.

\selectlanguage{ngerman}
Auch Umlaute funktionieren ohne die \LaTeX -Befehle, wie auch alle
anderen
seltsamen Zeichen: __ ______, wenn sie von der Schriftart
unterst__tzt werden.
\end{document}

3.7 Condividere l’indice

Queste funzioni sono già incluse nel pacchetto OrchestralLily:

https://repo.or.cz/w/orchestrallily.git

Alcuni utenti preferiscono esportare l’indice da lilypond e leggerlo da dentro LaTeX per la sua maggiore flessibilità nella gestione del testo.

Esportare l’indice da LilyPond

Per questo esempio si presume che lo spartito abbia vari movimenti nello stesso file di output di lilypond.

#(define (oly:create-toc-file layout pages)
  (let* ((label-table (ly:output-def-lookup layout 'label-page-table)))
    (if (not (null? label-table))
      (let* ((format-line (lambda (toc-item)
             (let* ((label (car toc-item))
                    (text  (caddr toc-item))
                    (label-page (and (list? label-table)
                                     (assoc label label-table)))
                    (page (and label-page (cdr label-page))))
               (format #f "~a, section, 1, {~a}, ~a" page text label))))
             (formatted-toc-items (map format-line (toc-items)))
             (whole-string (string-join formatted-toc-items ",\n"))
             (output-name (ly:parser-output-name))
             (outfilename (format #f "~a.toc" output-name))
             (outfile (open-output-file outfilename)))
        (if (output-port? outfile)
            (display whole-string outfile)
            (ly:warning (G_ "Unable to open output file ~a for the TOC information") outfilename))
        (close-output-port outfile)))))

\paper {
  #(define (page-post-process layout pages) (oly:create-toc-file layout pages))
}

Importare l’indice in LaTeX

In LaTeX l’intestazione deve includere:

\usepackage{pdfpages}
\includescore{nameofthescore}

dove \includescore viene definito in questo modo:

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% \includescore{PossibleExtension}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

% Read in the TOC entries for a PDF file from the corresponding .toc file.
% This requires some heave latex tweaking, since reading in things from a file
% and inserting it into the arguments of a macro is not (easily) possible

% Solution by Patrick Fimml on #latex on April 18, 2009:
% \readfile{filename}{\variable}
% reads in the contents of the file into \variable (undefined if file
% doesn't exist)
\newread\readfile@f
\def\readfile@line#1{%
{\catcode`\^^M=10\global\read\readfile@f to \readfile@tmp}%
\edef\do{\noexpand\g@addto@macro{\noexpand#1}{\readfile@tmp}}\do%
\ifeof\readfile@f\else%
\readfile@line{#1}%
\fi%
}
\def\readfile#1#2{%
\openin\readfile@f=#1 %
\ifeof\readfile@f%
\typeout{No TOC file #1 available!}%
\else%
\gdef#2{}%
\readfile@line{#2}%
\fi
\closein\readfile@f%
}%


\newcommand{\includescore}[1]{
\def\oly@fname{\oly@basename\@ifmtarg{#1}{}{_#1}}
\let\oly@addtotoc\undefined
\readfile{\oly@xxxxxxxxx}{\oly@addtotoc}
\ifx\oly@addtotoc\undefined
\includepdf[pages=-]{\oly@fname}
\else
\edef\includeit{\noexpand\includepdf[pages=-,addtotoc={\oly@addtotoc}]
{\oly@fname}}\includeit
\fi
}

3.8 Metodi alternativi per combinare testo e musica

Altri modi per combinare testo e musica (senza usare lilypond-book) sono trattati in Inclusione di partiture LilyPond in altri programmi.

4.1 Punta e clicca

Il "punta e clicca" aggiunge dei collegamenti ai documenti pdf per certi elementi musicali.

export LYEDITOR=atom

atom %(file)s:%(line)s:%(column)s

export LYEDITOR="code --goto %(file)s:%(line)s:%(column)s"

urlCommand     "lilypond-invoke-editor %s"

sudo apt-mark hold xpdf

gconftool-2 -t string -s /desktop/gnome/url-handlers/textedit/command "lilypond-invoke-editor %s"
gconftool-2 -s /desktop/gnome/url-handlers/textedit/needs_terminal false -t bool
gconftool-2 -t bool -s /desktop/gnome/url-handlers/textedit/enabled true

gnome-open textedit:///etc/issue:1:0:0

[Desktop Entry]
Version=1.0
Name=lilypond-invoke-editor
GenericName=Textedit URI handler
Comment=URI handler for textedit:
Exec=lilypond-invoke-editor %u
Terminal=false
Type=Application
MimeType=x-scheme-handler/textedit;
Categories=Editor
NoDisplay=true

xdg-desktop-menu install ./lilypond-invoke-editor.desktop
xdg-mime default lilypond-invoke-editor.desktop x-scheme-handler/textedit

gnome-open textedit:///etc/issue:1:0:0

# Per i collegamenti Textedit
/usr/local/bin/lilypond-invoke-editor Cx -> sanitized_helper,

sudo apparmor_parser -r -T -W /etc/apparmor.d/usr.bin.evince

\pointAndClickOff

\pointAndClickOn

lilypond -dno-point-and-click file.ly

4.2 LilyPond e gli editor di testo

Vari editor di testo hanno funzionalità specifiche per LilyPond.

(setq load-path (append (list (expand-file-name "~/site-lisp")) load-path))

filetype off
set runtimepath+=/usr/local/share/lilypond/current/vim/
filetype on
syntax on

4.3 Conversione da altri formati

È possibile inserire la musica anche importandola da altri formati. Questo capitolo documenta gli strumenti inclusi nella distribuzione che svolgono questo compito. Esistono altri strumenti che producono l’input di LilyPond, ad esempio i sequencer ad interfaccia grafica e i convertitori XML. Per maggiori dettagli consulta il sito web.

Si tratta di programmi separati da lilypond e sono eseguiti dalla linea di comando; si veda Uso da linea di comando per maggiori informazioni.

Problemi noti e avvertimenti

Purtroppo non abbiamo le risorse per mantenere questi programmi; prendeteli “così come sono”! Accettiamo con piacere le patch, ma ci sono poche possibilità che i bug vengano risolti.

midi2ly [opzione]… file-midi

musicxml2ly [opzione]… file.xml

abc2ly [opzione]… file-abc

%%LY voices \set autoBeaming = ##f

%%LY slyrics more words

etf2ly [opzione]… file-etf

4.4 Inclusione di partiture LilyPond in altri programmi

Questa sezione presenta dei metodi per integrare testo e musica diversi dal metodo automatizzato di lilypond-book.

\paper{
  indent=0\mm
  line-width=120\mm
  oddFooterMarkup=##f
  oddHeaderMarkup=##f
  bookTitleMarkup = ##f
  scoreTitleMarkup = ##f
}

… music …

lilypond -dbackend=eps -dno-gs-load-fonts -dinclude-eps-fonts myfile.ly

lilypond -dbackend=eps -dno-gs-load-fonts -dinclude-eps-fonts --png miofile.ly

lilypond -dbackend=eps -dno-gs-load-fonts -dinclude-eps-fonts \
  -dpixmap-format=pngalpha --png miofile.ly

4.5 include indipendenti

Alcuni utenti hanno creato file che possono essere inclusi in LilyPond tramite \include per produrre certi effetti. Quelli elencati in questo capitolo fanno parte di LilyPond. Maggiori informazioni in Lavorare coi file di input.

5.1 Consigli generali

Ecco alcuni consigli che possono aiutare a evitare (e risolvere) i problemi più comuni in fase di scrittura:

• Includere sempre il numero di \version in ogni file di input, non importa quanto piccolo possa essere il file. Ciò impedisce di dover ricordare con quale versione di LilyPond è stato creato il file ed è importante soprattutto per Aggiornare i file con convert-ly (che ha bisogno della dichiarazione \version); o quando si inviano i file di input a altri utenti (per esempio, quando si chiede aiuto nelle mailing list). Nota che tutti i modelli contengono l’informazione su \version.
• Scrivere ciascuna battuta su una singola riga del file di input. Ciò semplifica molto l’analisi dei problemi del file di input.
• Inserire i Controlli di battuta e del numero di battuta e i Controlli di ottava. Inserendo ‘controlli’ di questo tipo nei file di input, si può individuare un errore più rapidamente. Quanto spesso aggiungere i controlli dipende dalla complessità della musica da scrivere. Per composizioni semplici, aggiungere controlli in pochi punti strategici può essere sufficiente, ma per musica più complessa, con molte voci e/o righi, è consigliabile inserire i controlli dopo ogni battuta.
• Inserire commenti nei file di input. Riferimenti a temi musicali (‘secondo tema nei violini,’ ‘quarta variazione,’ etc.) o numeri di battuta inseriti come commenti rendono molto più semplice la lettura del file di input, specialmente se occorre modificare qualcosa successivamente o passare i file di input di LilyPond a un’altra persona.
• Aggiungere durate esplicite all’inizio delle ‘sezioni’. Per esempio, c4 d e invece di c d e f può semplificare il riarrangiamento della musica in un momento successivo.
• Imparare a allineare e indentare le parentesi e la musica parallela. Molti problemi sono spesso causati da parentesi ‘mancanti’. Indentare chiaramente le parentesi di ‘apertura’ e di ‘chiusura’ (o gli indicatori << e >>) aiuta a evitare tali problemi. Per esempio,

  \new Staff {
    \relative {
      r4 g'8 g c8 c4 d |
      e4 r8 |
      % Sezione Ossia
      <<
        { f8 c c | }
        \new Staff {
          f8 f c |
        }
      >>
      r4 |
    }
  }
  

  è molto più semplice da leggere di

  \new Staff { \relative { r4 g'8 g c4 c8 d | e4 r8
  % Sezione Ossia
  << { f8 c c } \new Staff { f8 f c } >> r4 | } }
  

• Tenere separato il contenuto musicale dallo stile mettendo gli \override nel blocco \layout:

  \score {
    …music…
    \layout {
     \override TabStaff.Stemstencil = ##f
   }
  }
  

  Ciò non creerà un nuovo contesto ma sarà applicato quando ne viene creato uno. Vedi anche Ridurre l’input grazie a variabili e funzioni e Fogli di stile.

5.2 Scrivere musica esistente

Se stai riportando della musica da una partitura esistente (ovvero il brano contenuto in uno spartito già scritto),

• Inserisci in LilyPond le note del manoscritto (la copia fisica della musica) un sistema alla volta (ma sempre una battuta per linea di testo), e controlla ogni sistema completato. Puoi usare le proprietà showLastLength o showFirstLength per velocizzare l’elaborazione – vedi Saltare la musica già corretta.
• Definisci mBreak = { \break } e inserisci \mBreak nel file di input ogni volta che nel manoscritto c’è un a capo. In questo modo è più semplice confrontare la musica generata da LilyPond con quella originale. Quando hai finito la revisione della partitura, puoi definire mBreak = { } per eliminare tutte queste interruzioni di riga. Così LilyPond potrà inserire le interruzioni dove ritiene stiano meglio.
• Quando si inserisce una parte per strumento traspositore all’interno di una variabile, è consigliabile racchiudere le note tra parentesi graffe

  \transpose c altezza-naturale {…}
  

  (dove altezza-naturale corrisponde all’intonazione di base dello strumento) così che la musica contenuta nella variabile sia effettivamente scritta in Do. La puoi presentare trasposta quando la variabile viene usata, se necessario, ma potresti non desiderarlo (ad esempio quando si stampa una partitura in intonazione reale, quando si traspone una parte per trombone dalla chiave di Sol alla chiave di basso, etc.). Errori nelle trasposizioni sono meno probabili se tutta la musica contenuta nelle variabili è ad un’altezza costante.

  Inoltre, trasponi sempre in relazione al Do. Questo significa che le uniche altre tonalità che userai saranno le altezze naturali degli strumenti - bes per una tromba in Si bemolle, aes per un clarinetto in La bemolle, etc.

5.3 Grandi progetti

Quando si lavora a un grande progetto, definire una struttura chiara nel file di input diventa vitale.

• Usa una variabile per ogni voce, con un minimo di struttura nella definizione. La struttura della sezione \score è la parte più probabilmente soggetta a cambiamenti; è invece molto improbabile che la definizione di violin cambi in una nuova versione di LilyPond.

  violin = \relative {
  g'4 c'8. e16
  }
  …
  \score {
    \new GrandStaff {
      \new Staff {
        \violin
      }
    }
  }
  

• Separa le modifiche manuali (tweak) dalle definizioni musicali. Questo punto è stato menzionato prima; nei grandi progetti diventa di vitale importanza. Potrebbe essere necessario modificare la definizione di fthenp, ma si dovrebbe farlo una volta sola e senza toccare niente in violin.

  fthenp = _\markup{
    \dynamic f \italic \small { 2nd } \hspace #0.1 \dynamic p }
  violin = \relative {
  g'4\fthenp c'8. e16
  }
  

5.4 Risoluzione dei problemi

Prima o poi ti capiterà di scrivere un file che LilyPond non riesce a compilare. I messaggi inviati da LilyPond potrebbero aiutarti a trovare l’errore, ma in molti casi sarà necessario fare qualche ricerca per individuare l’origine del problema.

Gli strumenti più potenti a questo riguardo sono il commento della linea singola (indicato da %) e il commento di blocco (indicato da %{ … %}). Se non sai dove sia il problema, inizia col commentare ampie parti del file di input. Dopo aver commentato una sezione, prova a compilare di nuovo il file. Se funziona, allora il problema deve trovarsi nella parte che hai appena commentato. Se non funziona, continua a commentare il materiale finché non ottieni un codice funzionante.

Nel caso estremo, potresti finire con soltanto

\score {
  <<
    % \melody
    % \harmony
    % \bass
  >>
  \layout{}
}

(in altre parole, un file senza musica)

Se dovesse succedere, non rinunciare. Decommenta un pezzetto – ad esempio, la parte di basso – e vedi se funziona. Se non funziona, allora commenta tutta la musica del basso (ma lascia \bass in \score non commentato).

bass = \relative {
%{
  c'4 c c c
  d d d d
%}
}

Ora inizia a decommentare mano a mano la parte di bass finché non trovi la linea che causa il problema.

Un’altra tecnica di debug molto utile consiste nel creare Esempi minimi.

5.5 Make e Makefile

Tutte le piattaforme su cui LilyPond può essere installato supportano un software chiamato make. Questo software legge un file speciale chiamato Makefile che definisce quali file dipendono da quali altri e quali comandi occorra dare al sistema operativo per produrre un file da un altro. Ad esempio Makefile può spiegare come generare ballad.pdf e ballad.midi da ballad.ly eseguendo LilyPond.

In alcune situazioni, è una buona idea creare un Makefile per il proprio progetto, per proprio comodo o come cortesia per quanti altri possano avere accesso ai file sorgente. Questo vale per i progetti molto ampi con tanti file inclusi e diverse opzioni di output (ad esempio, partitura completa, parti, partitura del direttore, riduzione per pianoforte, etc.) o per progetti che richiedono comandi difficili per la compilazione (come i progetti che usano lilypond-book). I Makefile variano molto in complessità e flessibilità, in base alle necessità e alle abilità degli autori. Il programma GNU Make è installato nelle distribuzioni GNU/Linux e su MacOS X ed è disponibile anche per Windows.

Si veda il Manuale di GNU Make per conoscere in dettaglio l’uso di make, dato che quel che segue dà solo un’idea delle sue potenzialità.

I comandi per definire delle regole in un Makefile cambiano in base alla piattaforma; ad esempio le varie distribuzioni di GNU/Linux e MacOS usano bash, mentre Windows usa cmd. Nota che su MacOS X è necessario configurare il sistema per usare l’interprete da linea di comando. Di seguito alcuni Makefile di esempio, con versioni sia per GNU/Linux/MacOS sia per Windows.

Il primo esempio è per una composizione per orchestra in quattro movimenti e presenta una directory strutturata come segue:

Symphony/
|-- MIDI/
|-- Makefile
|-- Notes/
|   |-- cello.ily
|   |-- figures.ily
|   |-- horn.ily
|   |-- oboe.ily
|   |-- trioString.ily
|   |-- viola.ily
|   |-- violinOne.ily
|   `-- violinTwo.ily
|-- PDF/
|-- Parts/
|   |-- symphony-cello.ly
|   |-- symphony-horn.ly
|   |-- symphony-oboe.ly
|   |-- symphony-viola.ly
|   |-- symphony-violinOne.ly
|   `-- symphony-violinTwo.ly
|-- Scores/
|   |-- symphony.ly
|   |-- symphonyI.ly
|   |-- symphonyII.ly
|   |-- symphonyIII.ly
|   `-- symphonyIV.ly
`-- symphonyDefs.ily

I file .ly nelle directory Scores e Parts prendono le note dai file .ily nella directory Notes:

%%% inizio del file "symphony-cello.ly"
\include "../symphonyDefs.ily"
\include "../Notes/cello.ily"

Il Makefile avrà i target di score (l’intero brano in partitura completa), movements (singoli movimenti in partitura completa), e parts (singole parti per i musicisti). C’è anche un target archive che creerà un archivio compresso dei file sorgenti, utile per la condivisione via web o email. Ecco un esempio di Makefile per GNU/Linux e MacOS X. Dovrebbe essere salvato col nome Makefile nella directory principale del progetto:

# Il prefisso al nome dei file di output
piece := symphony
# Il comando per eseguire lilypond
LILY_CMD := lilypond -ddelete-intermediate-files \
                    -dno-point-and-click

# I suffissi usati in questo Makefile.
.SUFFIXES: .ly .ily .pdf .midi

.DEFAULT_GOAL := score

PDFDIR := PDF
MIDIDIR := MIDI

# I file di input e di output vengono cercati nelle directory elencate
# nella variabile VPATH.  Tutte queste sono sottodirectory della directory
# corrente (assegnata dalla variabile `CURDIR' di GNU make).
VPATH := \
  $(CURDIR)/Scores \
  $(CURDIR)/Parts \
  $(CURDIR)/Notes \
  $(CURDIR)/$(PDFDIR) \
  $(CURDIR)/$(MIDIDIR)

# La regola di pattern per creare i file PDF e MIDI da un file di input LY.
# I file di output .pdf vengono messi nella sottodirectory `PDF', mentre i file
# .midi vanno nella sottodirectory `MIDI'.
%.pdf %.midi: %.ly | $(PDFDIR) $(MIDIDIR)
        $(LILY_CMD) $<            # questa linea inizia con una tabulazione
        mv "$*.pdf" $(PDFDIR)/    # questa linea inizia con una tabulazione
        mv "$*.midi" $(MIDIDIR)/  # questa linea inizia con una tabulazione

$(PDFDIR):
        mkdir $(PDFDIR)

$(MIDIDIR):
        mkdir $(MIDIDIR)

common := symphonyDefs.ily

notes := \
  cello.ily \
  horn.ily \
  oboe.ily \
  viola.ily \
  violinOne.ily \
  violinTwo.ily

# Le dipendenze dei movimenti.
$(piece)I.pdf: $(piece)I.ly $(notes) $(common)
$(piece)II.pdf: $(piece)II.ly $(notes) $(common)
$(piece)III.pdf: $(piece)III.ly $(notes) $(common)
$(piece)IV.pdf: $(piece)IV.ly $(notes) $(common)

# Le dipendenze della partitura completa.
$(piece).pdf: $(piece).ly $(notes) $(common)

# Le dipendenze delle parti.
$(piece)-cello.pdf: $(piece)-cello.ly cello.ily $(common)
$(piece)-horn.pdf: $(piece)-horn.ly horn.ily $(common)
$(piece)-oboe.pdf: $(piece)-oboe.ly oboe.ily $(common)
$(piece)-viola.pdf: $(piece)-viola.ly viola.ily $(common)
$(piece)-violinOne.pdf: $(piece)-violinOne.ly violinOne.ily $(common)
$(piece)-violinTwo.pdf: $(piece)-violinTwo.ly violinTwo.ily $(common)

# Lanciare `make score' per generare la partitura completa di tutti i quattro
# movimenti in un unico file.
.PHONY: score
score: $(piece).pdf

# Lanciare `make parts' per generare tutte le parti.
# Lanciare `make symphony-foo.pdf' per generare la parte per lo strumento `foo'.
# Esempio: `make symphony-cello.pdf'.
.PHONY: parts
parts: $(piece)-cello.pdf \
       $(piece)-violinOne.pdf \
       $(piece)-violinTwo.pdf \
       $(piece)-viola.pdf \
       $(piece)-oboe.pdf \
       $(piece)-horn.pdf

# Lanciare `make movements' per generare i file per i
# quattro movimenti separatamente.
.PHONY: movements
movements: $(piece)I.pdf \
           $(piece)II.pdf \
           $(piece)III.pdf \
           $(piece)IV.pdf

all: score parts movements

Ci sono alcune complicazioni specifiche della piattaforma Windows. Dopo aver scaricato e installato GNU Make per Windows, bisogna impostare il percorso corretto nelle variabili d’ambiente di sistema perché la shell DOS possa trovare il programma Make. Per farlo, clicca col tasto destro del mouse su "My Computer," poi scegli Proprietà e Avanzate. Clicca su Variabili di ambiente, e poi nel pannello Variabili di Sistema, nella sezione Percorso, clicca su modifica e aggiungi il percorso al file eseguibile GNU Make, che avrà un aspetto simile:

C:\Program Files\GnuWin32\bin

Lo stesso Makefile deve essere modificato per gestire diversi comandi shell e gli spazi che sono presenti in alcune directory predefinite di sistema. Windows ha una diversa estensione predefinita per i file midi.

## VERSIONE DI WINDOWS
##
piece := symphony
LILY_CMD := lilypond -ddelete-intermediate-files \
                    -dno-point-and-click

#get the 8.3 name of CURDIR (workaround for spaces in PATH)
workdir := $(shell for /f "tokens=*" %%b in ("$(CURDIR)") \
          do @echo %%~sb)

.SUFFIXES: .ly .ily .pdf .mid

.DEFAULT_GOAL := score

PDFDIR := PDF
MIDIDIR := MIDI

VPATH := \
  $(workdir)/Scores \
  $(workdir)/Parts \
  $(workdir)/Notes \
  $(workdir)/$(PDFDIR) \
  $(workdir)/$(MIDIDIR)

%.pdf %.mid: %.ly | $(PDFDIR) $(MIDIDIR)
        $(LILY_CMD) $<                # questa linea inizia con una tabulazione
        move /Y "$*.pdf" $(PDFDIR)/   # questa linea inizia con una tabulazione
        move /Y "$*.mid" $(MIDIDIR)/  # questa linea inizia con una tabulazione

$(PDFDIR):
    mkdir $(PDFDIR)/

$(MIDIDIR):
    mkdir $(MIDIDIR)/

notes := \
  cello.ily \
  figures.ily \
  horn.ily \
  oboe.ily \
  trioString.ily \
  viola.ily \
  violinOne.ily \
  violinTwo.ily

common := symphonyDefs.ily

$(piece)I.pdf: $(piece)I.ly $(notes) $(common)
$(piece)II.pdf: $(piece)II.ly $(notes) $(common)
$(piece)III.pdf: $(piece)III.ly $(notes) $(common)
$(piece)IV.pdf: $(piece)IV.ly $(notes) $(common)

$(piece).pdf: $(piece).ly $(notes) $(common)

$(piece)-cello.pdf: $(piece)-cello.ly cello.ily $(common)
$(piece)-horn.pdf: $(piece)-horn.ly horn.ily $(common)
$(piece)-oboe.pdf: $(piece)-oboe.ly oboe.ily $(common)
$(piece)-viola.pdf: $(piece)-viola.ly viola.ily $(common)
$(piece)-violinOne.pdf: $(piece)-violinOne.ly violinOne.ily $(common)
$(piece)-violinTwo.pdf: $(piece)-violinTwo.ly violinTwo.ily $(common)

.PHONY: score
score: $(piece).pdf

.PHONY: parts
parts: $(piece)-cello.pdf \
       $(piece)-violinOne.pdf \
       $(piece)-violinTwo.pdf \
       $(piece)-viola.pdf \
       $(piece)-oboe.pdf \
       $(piece)-horn.pdf

.PHONY: movements
movements: $(piece)I.pdf \
           $(piece)II.pdf \
           $(piece)III.pdf \
           $(piece)IV.pdf

all: score parts movements

Il Makefile seguente è per un documento lilypond-book fatto con LaTeX. Questo progetto ha un indice, dunque il comando latex deve essere eseguito due volte per aggiornare i collegamenti. I file di output sono tutti salvati nella directory out per i file .pdf e nella directory htmlout per i file html.

SHELL=/bin/sh
FILE=myproject
OUTDIR=out
WEBDIR=htmlout
VIEWER=acroread
BROWSER=firefox
LILYBOOK_PDF=lilypond-book --output=$(OUTDIR) --pdf $(FILE).lytex
LILYBOOK_HTML=lilypond-book --output=$(WEBDIR) $(FILE).lytex
PDF=cd $(OUTDIR) && pdflatex $(FILE)
HTML=cd $(WEBDIR) && latex2html $(FILE)
INDEX=cd $(OUTDIR) && makeindex $(FILE)
PREVIEW=$(VIEWER) $(OUTDIR)/$(FILE).pdf &

all: pdf web keep

pdf:
        $(LILYBOOK_PDF)  # inizia con una tabulazione
        $(PDF)           # inizia con una tabulazione
        $(INDEX)         # inizia con una tabulazione
        $(PDF)           # inizia con una tabulazione
        $(PREVIEW)       # inizia con una tabulazione

web:
        $(LILYBOOK_HTML) # inizia con una tabulazione
        $(HTML)          # inizia con una tabulazione
        cp -R $(WEBDIR)/$(FILE)/ ./  # inizia con una tabulazione
        $(BROWSER) $(FILE)/$(FILE).html &  # inizia con una tabulazione

keep: pdf
        cp $(OUTDIR)/$(FILE).pdf $(FILE).pdf  # inizia con una tabulazione

clean:
        rm -rf $(OUTDIR) # inizia con una tabulazione

web-clean:
        rm -rf $(WEBDIR) # inizia con una tabulazione

archive:
        tar -cvvf myproject.tar \ # inizia questa linea con una tabulazione
        --exclude=out/* \
        --exclude=htmlout/* \
        --exclude=myproject/* \
        --exclude=*midi \
        --exclude=*pdf \
        --exclude=*~ \
        ../MyProject/*

Il Makefile precedente non funziona su Windows. Un’alternativa per gli utenti Windows consiste nel creare un semplice file batch contenente i comandi per la compilazione. Questo file non terrà traccia delle dipendenze come fa invece un Makefile, ma almeno riduce il processo di compilazione a un solo comando. Salva il codice seguente come build.bat o build.cmd. Il file batch può essere eseguito nel prompt DOS o semplicemente con un doppio clic sulla sua icona.

lilypond-book --output=out --pdf myproject.lytex
cd out
pdflatex myproject
makeindex myproject
pdflatex myproject
cd ..
copy out\myproject.pdf MyProject.pdf

Vedi anche

Questo manuale: Uso da linea di comando, Eseguire lilypond-book.