Invocar lilypond

El ejecutable lilypond se puede llamar desde la línea de órdenes de la siguiente manera:

lilypond [opción]… archivo…

Cuando se invoca con un nombre de archivo sin extensión, se prueba en primer lugar con la extensión .ly. Para leer la entrada desde stdin, utilice un guión (-) en sustitución de archivo.

Cuando se procesa archivo.ly, la salida resultante por defecto es el archivo archivo.pdf. Se pueden especificar varios archivos; cada uno de ellos se procesará de forma independiente¹.

Si archivo.ly contiene más de un bloque \score, el resto de las partituras se obtiene como salida en archivos numerados, empezando por archivo-1.pdf. además, el valor de output-suffix (sufijo de salida) se inserta entre el nombre base y el número. Por ejemplo, si archivo.ly contiene

#(define output-suffix "violin")
\score { … }
#(define output-suffix "cello")
\score { … }

La salida consiste en los archivos filename-violin.pdf y filename-cello-1.pdf.

Uso de LilyPond con las posibilidades básicas del shell

Dado que LilyPond es una aplicación de consola, las posibilidades del ‘shell’ usado para la llamada a LilyPond también pueden aprovecharse.

Por ejemplo,

lilypond *.ly

procesa todos los archivos de LilyPond dentro del directorio actual.

También puede ser útil redireccionar la salida de consola (p.ej. hacia un archivo):

lilypond file.ly 1> salida_estandar.txt

lilypond file.ly 2> error_estandar.txt

lilypond file.ly &> todo.txt

Estas instrucciones redireccionan la salida ‘normal’, solo los ‘errores’ o ‘todo’, respectivamente, hacia un archivo de texto. Consulte la documentación de su shell concreto, Command (Windows), las aplicaciones Terminal o Console (MacOS X) para comprobar si el redireccionamiento de la salida está contemplado o si la sintaxis es distinta.

El ejemplo siguiente busca y procesa todos los archivos de entradas que estén en el directorio actual y en todos los que están por debajo de él, recursivamente. Los archivos de salida se pondrán en el mismo directorio desde el que se ejecutó la instrucción, en lugar de aquellos en los que estaban los archivos de entrada originales.

find . -name '*.ly' -exec lilypond '{}' \;

También debe funcionar para los usarios de MacOS X.

Un usuario de Windows haría lo siguiente:

forfiles /s /M *.ly /c "cmd /c lilypond @file"

introduciendo estas instrucciones desde un indicador de órdenes que normalmente está en Inicio > Accessorios > Símbolo del sistema, o escribiendo en la ventana de búsqueda ‘indicador de órdenes’.

De forma alternativa, una ruta explícita al nivel superior de su carpeta que contenga todas las subcarpetas con archivos de entrada en su interior se puede especificar mediante la opción /p;

forfiles /s /p C:\Documentos\MisPartituras /M *.ly /c "cmd /c lilypond @file"

Si el nombre de la ruta del directorio de nivel superior contiene espacios, entonces es necesario incluir toda la ruta entre comillas:

forfiles /s /p "C:\Documentos\Mis Partituras" /M *.ly /c "cmd /c lilypond @file"