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.