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{…}, para introducir directamente fragmentos cortos de código de LilyPond,
• el entorno @lilypond…@end lilypond, para 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.

Todas las instrucciones anteriores deben estar al comienzo de una línea (posiblemente precedida de espacios), incluso si se usa con la opción de fragmento inline. Asimismo, no debe haber texto después de la llave de cierre (para @lilypond{...}) o @end 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 algunos ejemplos sencillos. El entorno lilypond

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

produce

La versión corta

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

produce

Véase también

Hay opciones de línea de órdenes específicas de lilypond-book y otros detalles que saber cuando se procesan documentos de Texinfo, véase Invocar lilypond-book.