LilyPond: manuale d'uso del programma: 3.2.2 Texinfo

### 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`.

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