3.2.2 Texinfo

Texinfo è il formato standard per la documentazione del progetto GNU. Un esempio di documento Texinfo è questo stesso manuale. Le versioni del manuale in formato HTML, PDF e Info vengono generate da un documento Texinfo.

lilypond-book fornisce i seguenti comandi e ambienti per includere musica nei file Texinfo:

• il comando \lilypond{…}, per inserire direttamente del codice LilyPond breve,
• l’ambiente \begin{lilypond}…\end{lilypond}, per inserire direttamente del codice LilyPond più lungo,
• il comando \lilypondfile{…} per inserire un file LilyPond,
• il comando \musicxmlfile{…} per inserire un file MusicXML, che viene elaborato da musicxml2ly e da lilypond.

Nel file di input, la musica viene specificata con uno dei seguenti comandi

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

Inoltre, @lilypondversion mostra la versione di LilyPond impiegata.

Quando si esegue lilypond-book su di esso, il risultato è un file Texinfo (con estensione .texi) contenente degli elementi @image per l’HTML, Info e l’output per la stampa. lilypond-book genera le immagini della musica in formati EPS e PDF per l’utilizzo nell’output per la stampa e in formato PNG per l’utilizzo nell’output HTML e Info.

Vediamo alcuni esempi. L’ambiente lilypond

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

genera

La versione breve

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

genera

Vedi anche

Esistono opzioni da linea di comando specifiche di lilypond-book e altri dettagli da conoscere quando si elaborano documenti Texinfo, vedi Utilizzo di lilypond-book.