LilyPond: manual de utilización del programa: 3.2.2 Texinfo

### 3.2.2 Texinfo

Texinfo es el formato estándar para la documentación del proyecto GNU. Este mismo manual es un ejemplo de documento Texinfo. Las versiones HTML, PDF e Info del manual se hacen a partir del documento Texinfo.

`lilypond-book` aporta las siguientes instrucciones y entornos para incluir música dentro de archivos de Texinfo:

- la instrucción `@lilypond{…}`, donde podemos introducir directamente fragmentos cortos de código de LilyPond
- el entorno `@lilypond…@end lilypond`, donde podemos escribir directamente bloques más extensos de código de LilyPond
- la instrucción `@lilypondfile{…}` para insertar un archivo de LilyPond
- la instrucción `@musicxmlfile{…}` para insertar un archivo de MusicXML, que se procesa después por parte de `musicxml2ly` y de `lilypond`.

En el archivo de entrada, la música se especifica con cualquiera de las instrucciones siguientes:

>     @lilypond[las,opciones,van,aquí]
>       EL CÓDIGO DE LILYPOND
>     @end lilypond

>     @lilypond[las,opciones,van,aquí]{ EL CÓDIGO DE LILYPOND }

>     @lilypondfile[las,opciones,van,aquí]{archivo}

>     @musicxmlfile[las,opciones,van,aquí]{archivo}

De forma adicional, `@lilypondversion` imprime la versión actual de lilypond.

Cuando se ejecuta `lilypond-book` sobre el archivo, se obtiene como resultado un archivo Texinfo (con la extensión ‘`.texi`’) que contiene etiquetas `@image` para el HTML, Info y la salida impresa. `lilypond-book` genera imágenes de la música en formatos EPS y PDF para usarlos en la salida impresa, y en formato PNG para usarlos en las salidas HTML e Info.

Aquí podemos ver dos ejemplos sencillos. Un entorno `lilypond`

>     @lilypond[fragment]
>     c' d' e' f' g'2 g'
>     @end lilypond

produce

La versión corta

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

produce

A diferencia de LaTeX, `@lilypond{…}` no genera una imagen en línea. Siempre consiste en un párrafo para ella sola.

#### LilyPond — Utilización v2.24.4 (rama estable).