LilyPond — Utilización

1.1 Utilización normal

Casi todos los usuarios ejecutan LilyPond por medio de un interfaz gráfico; consulte Primeros pasos si no lo ha leído aún. Si utiliza algún otro editor para la edición de los archivos de LilyPond, consulte la documentación de dicho programa.

1.2 Utilización desde la línea de órdenes

Esta sección contiene información adicional sobre el uso de LilyPond en la línea de órdenes. Esta forma puede ser preferible para pasarle al programa algunas opciones adicionales. Además, existen algunos programas complementarios ‘de apoyo’ (como midi2ly) que sólo están disponibles en la línea de órdenes.

Al hablar de la ‘línea de órdenes’, nos referimos a la consola del sistema operativo. Los usuarios de Windows posiblemente estén más familiarizados con los términos ‘ventana de MS-DOS’ o ‘línea de comandos’; Los usuarios de MacOS X puede que estén más familiarizados con los términos ‘terminal’ o ‘consola’.

La descripción del uso de esta parte de los sistemas operativos se sale del ámbito de este manual; le rogamos que consulte otros documentos sobre este tema si no le resulta familiar la línea de órdenes.

lilypond [opción]… archivo…

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

lilypond *.ly

lilypond file.ly 1> salida_estandar.txt

lilypond file.ly 2> error_estandar.txt

lilypond file.ly &> todo.txt

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

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

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

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

instrucción clave=valor

set? FONTCONFIG_FILE=$INSTALLER_PREFIX/etc/fonts/fonts.conf
prependdir GUILE_LOAD_PATH=$INSTALLER_PREFIX/share/guile/1.8

#!/bin/sh
## aquí se fijan los valores predeterminados

username=lily
home=/home
loopdevice=/dev/loop0
jaildir=/mnt/lilyloop
# prefijo (¡sin la barra inicial!)
lilyprefix=usr/local
# el directorio en que lilypond se encuentra instalado en el sistema
lilydir=/$lilyprefix/lilypond/

userhome=$home/$username
loopfile=$userhome/loopfile
adduser $username
dd if=/dev/zero of=$loopfile bs=1k count=200000
mkdir $jaildir
losetup $loopdevice $loopfile
mkfs -t ext3 $loopdevice 200000
mount -t ext3 $loopdevice $jaildir
mkdir $jaildir/lilyhome
chown $username $jaildir/lilyhome
cd $jaildir

mkdir -p bin usr/bin usr/share usr/lib usr/share/fonts $lilyprefix tmp
chmod a+w tmp

cp -r -L $lilydir $lilyprefix
cp -L /bin/sh /bin/rm bin
cp -L /usr/bin/convert /usr/bin/gs usr/bin
cp -L /usr/share/fonts/truetype usr/share/fonts

# Ahora la magia de copiar las bibliotecas
for i in "$lilydir/usr/bin/lilypond" "$lilydir/usr/bin/guile" "/bin/sh"  \
  "/bin/rm" "/usr/bin/gs" "/usr/bin/convert"; do ldd $i | sed 's/.*=>  \
    \/\(.*\/\)\([^(]*\).*/mkdir -p \1 \&\& cp -L \/\1\2 \1\2/' | sed  \
      's/\t\/\(.*\/\)\(.*\) (.*)$/mkdir -p \1 \&\& cp -L \/\1\2 \1\2/'  \
        | sed '/.*=>.*/d'; done | sh -s

# Los archivos compartidos para Ghostscript...
      cp -L -r /usr/share/ghostscript usr/share
# Los archivos compartidos para ImageMagick
      cp -L -r /usr/lib/ImageMagick* usr/lib

### Ahora, suponiendo que tenemos test.ly en /mnt/lilyloop/lilyhome,
### deberíamos poder ejecutar:
### Observe que /$lilyprefix/bin/lilypond es un guión, que establece
### un valor para LD_LIBRARY_PATH : esto es crucial
      /$lilyprefix/bin/lilypond -jlily,lily,/mnt/lilyloop,/lilyhome test.ly

1.3 Mensajes de error

Pueden aparecer distintos mensajes de error al compilar un archivo:

Advertencia ¶

Algo tiene un aspecto sospechoso. Si estamos pidiendo algo fuera de lo común, entenderemos el mensaje y podremos ignorarlo. Sin embargo, las advertencias suelen indicar que algo va mal con el archivo de entrada.

Error ¶

Algo va claramente mal. El paso actual de procesamiento (análisis, interpretación o formateo visual) se dará por terminado, pero el siguiente paso se saltará.

Error fatal ¶

Algo va claramente mal, y LilyPond no puede seguir. Rara vez sucede esto. La causa más frecuente son las tipografías mal instaladas.

Error de Scheme ¶

Los errores que ocurren al ejecutar código de Scheme se interceptan por parte del intérprete de Scheme. Si se está ejecutando con las opciones -V o --verbose (prolijo) entonces se imprime una traza de llamadas de la función ofensiva.

Error de programación ¶

Ha habido algún tipo de inconsistencia interna. Estos mensajes de error están orientados a ayudar a los programadores y a los depuradores. Normalmente se pueden ignorar. En ocasiones aparecen en cantidades tan grandes que pueden entorpecer la visión de otros mensajes de salida.

Abortado (volcado de core)

Esto señala un error de programación serio que ha causado la interrupción abrupta del programa. Estos errores se consideran críticos. Si se topa con uno, envíe un informe de fallo.

Si los errores y advertencias se pueden ligar a un punto del archivo de entrada, los mensajes tienen la forma siguiente:

archivo:línea:columna: mensaje
línea de entrada problemática

Se inserta un salto de línea en la línea problemática para indicar la columna en que se encontró el error. Por ejemplo,

prueba.ly:2:19: error: no es una duración: 5
  { c'4 e'
           5 g' }

Estas posiciones son la mejor suposición de LilyPond sobre dónde se ha producido el mensaje de error, pero (por su propia naturaleza) las advertencias y errores se producen cuando ocurre algo inesperado. Si no ve un error en la línea que se indica del archivo de entrada, trate de comprobar una o dos líneas por encima de la posición indicada.

Observe que los diagnósticos se pueden activar en cualquier punto durante las numerosas fases del procesado. Por ejemplo, si hay partes de la entrada que se procesan varias veces (como en la salida midi y de disposición de la página), o si la misma variable musical se utiliza en más de un contexto, puede aparecer el mismo mensaje varias veces. Los diagnósticos producidos en un estado ‘tardío’ (como las comprobaciones de compás) también podrían emitirse más de una vez.

Se ofrece más información sobre los errores en la sección Errores comunes.

1.4 Errores comunes

Las condiciones de error que se describen más abajo se producen con frecuencia, aunque su causa no es obvia o fácil de encontrar. Una vez se han visto y comprendido, se manejan sin problema.

\override VerticalAxisGroup.staff-affinity = ##f

\score {
  % Invalid! Generates error: syntax error, unexpected \new
  \new Staff { … }
  \new Staff { … }
}

2.1 ¿Por qué cambia la sintaxis?

Con frecuencia, los cambios en la sintaxis se llevan a cabo para hacer que la entrada sea más sencilla tanto de leer como de escribir, pero en ocasiones se hacen los cambios para acomodar nuevas funcionalidades o mejoras para las funciones existentes.

Lo ilustramos a continuación con un ejemplo real:

Se supone que todos los nombres de las propiedades de \paper y de \layout están escritos en la forma primero-segundo-tercero. Sin embargo, en la versión 2.11.60, observamos que la propiedad printallheaders no seguía esta convención. ¿Deberíamos dejarla como está (confundiendo a los nuevos usuarios que tienen que tratar con un formato de entrada inconsistente), o cambiarla (fastidiando a los usuarios con experiencia que tienen partituras antiguas)?

Se tomó la decisión de cambiar el nombre de la propiedad por print-all-headers, y mediante el uso de la herramienta convert-ly se dio a los usuarios existentes la posibiilidad de actualizar automáticamente los archivos de entrada que tenían previamente.

Sin embargo, el uso de la herramienta convert-ly no permite tratar todos los cambios de sintaxis. En versiones de LilyPond anteriores a la 2.4.2, los acentos y las letras no inglesas se introducían utilizando LaTeX: por ejemplo, No\"el (que significa ‘Navidad’ en francés). Pero a partir de LilyPond 2.6, el carácter especial ë debe introducirse directamente en el archivo de LilyPond como un carácter UTF-8. La herramienta convert-ly no sabe cómo cambiar los caracteres especiales de LaTeX a caracteres de UTF-8; tendrá que actualizar manualmente sus archivos de LilyPond antiguos.

Las reglas de conversión de convert-ly funcionan usando correspondencia y sustitución de patrones de texto en lugar de una ‘comprensión’ profunda de los cambios producidos en un archivo dado. Esto tiene varias consecuencias:

• El buen funcionamiento de la conversión depende de la calidad de cada conjunto de reglas que se aplican y de la complejidad del cambio correspondiente. A veces las conversiones pueden necesitar correcciones manuales adicionales, por lo que los archivos originales deberían conservarse a efectos de comparación, si es necesario.
• Solamente son posibles las conversiones a las sintaxis más recientes: no existe ningún conjunto de reglas para volver a versiones más antiguas de LilyPond. Así pues, el archivo de entrada solamente se debe actualizar cuando ya no se mantienen las versiones antiguas de LilyPond. De nuevo, es conveniente conservar, por si acaso, los archivos de entrada, quizá mediante el uso de un sistema de control de versiones como el Git, que puede ser de gran ayuda para realizar el mantenimiento de varias versiones de los mismos archivos.
• LilyPond es bastante robusto al procesar espacios añadidos y suprimidos de manera “creativa”, pero las reglas utilizadas por convert-ly con frecuencia hacen ciertas suposiciones de estilo. Por tanto, se recomienda seguir el estilo de la entrada tal y como se usa en los manuales de LilyPond para que las actualizaciones sean indoloras, especialmente porque todos los ejemplos de los propios manuales se actualizan usando la herramienta convert-ly.

2.2 Invocar convert-ly

La herramienta convert-ly utiliza los enunciados \version del archivo de entrada para detectar el número de versión antiguo. En casi todos los casos, para actualizar el archivo de entrada basta con ejecutar lo siguiente:

convert-ly -e miarchivo.ly

dentro del directorio que contiene el archivo de entrada. Con esto se actualiza miarchivo.ly in situ y se preserva el archivo original renombrándolo como miarchivo.ly~. Se modifica también el número de \version en el archivo actualizado además de la necesaria puesta al día de la sintaxis.

Al ejecutarse, la herramienta convert-ly imprime los números de versión de las conversiones que se han hecho. Si no aparece en el listado ningún número de versión para este archivo, significa que ya está actualizado y que es compatible con la sintaxis de la última versión de LilyPond.

Para convertir todos los archivos de entrada que hay en un solo directorio, utilice lo siguiente:

convert-ly -e *.ly

Tanto los usuarios de Linux como los de MacOS X pueden usar la aplicación de terminal correspondiente, pero los usuarios de MacOS X pueden también ejecutar esta orden directamente desde el menú Compilar > Actualizar la sintaxis.

Un usuario de Windows ejecutaría la instrucción:

convert-ly.py -e *.ly

escribiéndola en un terminal de línea de órdenes o indicador del sistema que normalmente se encuentra bajo Inicio > Accessorios > Consola de órdenes o, para los usuarios de la versión 8, escribiendo en la ventana de búsqueda ‘consola de órdenes’.

Para converitr todos los archivos de entrada que residen en distintos conjuntos de subdirectorios:

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

Este ejemplo busca y convierte todos los archivos de entrada que están en el directorio actual y en todos los directorios que están dentro de él, de forma recursiva. Los archivos convertidos se colocan en el mismo directorio que sus originales renombrados. También debería funcionar para los usuarios de MacOS X, si bien solamente a través de la aplicación de terminal.

Los usuarios de Windows deben hacer lo siguiente:

forfiles /s /M *.ly /c "cmd /c convert-ly.py -e @file"

Como alternativa, se puede indicar una ruta explícita al nivel superior del directorio que contiene todos los sub-directorios que contienen archivos de entrada, mediante la opción /p:

forfiles /s /p C:\Documentos\MisPartituras /M *.ly /c "cmd /c convert-ly.py -e @file"

Si el nombre o la ruta del directorio de nivel superior contienen espacios, entonces hay que poner entre comillas la ruta completa:

forfiles /s /p "C:\Documentos\Mis Partituras" /M *.ly /c "cmd /c convert-ly.py -e @file"

2.3 Opciones de la línea de órdenes para convert-ly

En general, el programa se invoca de la manera siguiente:

convert-ly [opción]… archivo…

Se pueden dar las siguientes opciones:

-d, --diff-version-update

incrementar la cadena \version solamente si el archivo efectivamente ha cambiado. En tal caso, la cabecera de versión corresponderá a la versión siguiente al último cambio efectivo. Los números de las versiones de desarrollo se redondean hacia arriba al número de la siguiente versión estable, a no ser que fuera superior al número de la versión objetivo. Sin esa opción, la versión refleja la última conversión que se intentó hacer.

-e, --edit

Aplicar las conversiones directamente al archivo de entrada, modificándolo in situ. El archivo original se cambia de nombre a miarchivo.ly~. Este archivo de copia de seguridad podría ser un archivo oculto en algunos sistemas operativos. Como alternativa, si queremos especificar un nombre distinto para el archivo actualizado sin que la tilde curva ~, predeterminada de la opción -e, se añada al final del nombre del archivo antiguo, se puede en su lugar redirigir la entrada:

convert-ly miarchivo.ly > miarchivonuevo.ly

Los usuarios de Windows harán lo siguiente:

convert-ly.py miarchivo.ly > miarchivonuevo.ly

-b, --backup-numbered

Cuando se usa con la opción ‘-e’, numerar los archivos de copia de seguridad de forma que no se sobreescriba ninguna versión anterior. Los archivos de copia de seguridad podrían ser archivos ocultos en algunos sistemas operativos.

-f, --from=versión_de_origen

Establece la versión desde la que convertir. Si no aparece esta opción, convert-ly tratará de adivinarla, basándose en el enunciado \version del archivo. Ejemplo: --from=2.10.25

-h, --help

Imprimir la ayuda de utilización.

-l loglevel, --loglevel=loglevel

Fijar el grado en que la salida es prolija a loglevel. Los valores posibles son NONE (ninguno), ERROR (errores), WARN (advertencias), PROGRESS (avance; predeterminado) y DEBUG (depuración).

-n, --no-version

Normalmente convert-ly añade un indicador \version a la salida. La especificación de esta opción lo suprime.

-s, --show-rules

Mostrar todas las conversiones conocidas y salir.

-t, --to=versión_final

Fijar explícitamente a qué \version convertir, en caso contrario el valor predeterminado es la versión más actual. Debe ser más alta que la versión de partida.

convert-ly --to=2.14.1 miarchivo.ly

Para actualizar fragmentos de LilyPond en archivos de texinfo, use

convert-ly --from=… --to=… --no-version *.itely

Para ver los cambios en la sintaxis de LilyPond entre dos versiones dadas, use

convert-ly --from=… --to=… -s

2.4 Problemas con convert-ly

Al ejecutar convert-ly en una ventana del Símbolo del Sistema bajo Windows sobre un archivo que tiene espacios en el nombre o en la ruta, es necesario encerrar todo el nombre del archivo de entrada con tres (!) pares de comillas:

convert-ly """D:/Mis partituras/Oda.ly""" > "D:/Mis partituras/nueva Oda.ly"

Si la orden simple convert-ly -e *.ly no funciona porque la instrucción expandida se hace muy larga, en vez de ello la orden convert-ly se puede poner dentro de un bucle. Este ejemplo para UNIX actualiza todos los documentos .ly del directorio actual

for f in *.ly; do convert-ly -e $f; done;

En la ventana del terminal de órdenes de Windows, la instrucción correspondiente es

for %x in (*.ly) do convert-ly -e """%x"""

No se manejan todos los cambios en el lenguaje. Sólo se puede especificar una opción de salida. La actualización automática de Scheme y los interfaces Scheme de LilyPond es bastante improbable; prepárese para trucar el código de Scheme a mano.

2.5 Conversiones manuales

En teoría, un programa como convert-ly debería poder tratar cualquier cambio en la sintaxis. Después de todo, un programa de ordenador interpreta las versiones antigua y nueva, por lo que otro programa de ordenador podría traducir un archivo al otro².

Sin embargo, el proyecto LilyPond cuenta con unos recursos limitados: no todas las conversiones se efectúan automáticamente. A continuación aparece una lista de los problemas conocidos.

1.6->2.0:
 No siempre convierte el bajo cifrado correctamente, específicamente cosas como {<
>}.  El comentario de Mats sobre cómo solventar el problema:
   Para poder ejecutar convert-ly
   sobre él, primero sustituí todas las apariciones de '{<' a algo mudo como '{#'
   y de forma similar sustituí '>}' con '&}'.  Después de la conversión, pude
   volver a cambiarlos de '{ #' a '{ <' y de '& }' a '> }'.
 No convierte todos los marcados de texto correctamente.  En sintaxis antigua,
 se podían agrupar varios marcados entre paréntesis, p.ej.
   -#'((bold italic) "cadena")
   Esto se convierte incorrectamente en
   -\markup{{\bold italic} "cadena"}
   en vez del correcto
   -\markup{\bold \italic "cadena"}
2.0->2.2:
 No maneja \partCombine
 No hace \addlyrics => \lyricsto, esto rompe algunas partituras con varias estrofas.
2.0->2.4:
 \magnify no se cambia por \fontsize.
    - \magnify #m => \fontsize #f, donde f = 6ln(m)/ln(2)
 remove-tag no se cambia.
    - \applyMusic #(remove-tag '. . .) => \keepWithTag #'. . .
 first-page-number no se cambia.
    - first-page-number no => print-first-page-number = ##f
 Los saltos de línea en las cadenas de cabecera no se convierten.
    - \\\\  como salto de línea en las cadenas de \header  => \markup \center-align <
      "Primera línea" "Segunda línea" >
 Los terminadores de crescendo y decrescendo no se convierten.
    - \rced => \!
    - \rc => \!
2.2->2.4:
 \turnOff (usado en \set Staff.VoltaBracket = \turnOff) no se convierte
adecuadamente.
2.4.2->2.5.9
 \markup{ \center-align <{ ... }> } se tendría que convertir en:
 \markup{ \center-align {\line { ... }} }
 pero ahora, falta el \line.
2.4->2.6
 Los caracteres especiales de LaTeX como $~$ en el texto no se convierten a UTF8.
2.8
 \score{} ahora debe empezar con una expresión musical.  Cualquier otra cosa
 (en particular, \header{}) debe ir después de la música.

2.6 Escritura de código que contemple varias versiones

En ciertos casos, especialmente al escribir código de bibliotecas, es deseable dar apoyo a más de una versión de LilyPond, por encima de los cambios de sintaxis que rompen con la práctica anterior. Para hacerlo, se pueden envolver porciones de código alternativas dentro de expresiones condicionales que dependen de la versión de LilyPond que se está ejecutando actualmente. La función de Scheme ly:version? admite un operador de comparación op y una versión de referencia ver que se pasa como una lista de enteros con un máximo de tres elementos. Se ignoran los elementos que faltan, de forma que '(2 20) equivale a cualquier versión de la línea de 2.20. Son posibles construcciones como las siguientes:

#(cond
  ((ly:version? > '(2 20))
   (ly:message "Esto es código para LilyPond posterior a 2.20"))
  ((ly:version? = '(2 19 57))
   (ly:message "Esto solamente se ejecuta con LilyPond 2.19.57"))
  (else (ly:message "Esto se ejecuta en cualquier otra versión")))

Por lo general, esto se encontrará integrado dentro de funciones de biblioteca que permitan usar más de un tipo de sintaxis alternativas, pero también es posible usar la comparación directamente dentro de la música como en el ejemplo siguiente:

{
  c' d' e' f'
  #(if (ly:version? = '(2 21))
       #{ \override NoteHead.color = #red #}
       #{ \override NoteHead.color = #blue #})
  g' a' b' c''
}

Nota: Esta función fue introducida en LilyPond 2.19.57, por lo que no es posible hacer la comparación con versiones anteriores a esa.

3.1 Un ejemplo de documento musicológico

Ciertos textos contienen ejemplos musicales. Son tratados musicales, cancioneros o manuales como este mismo. Estos textos se pueden hacer a mano, importando simplemente una imagen en formato PostScript en el editor de textos. Sin embargo, hay un procedimiento automático para reducir la carga de trabajo que esto implica los documentos de HTML, LaTeX, Texinfo y DocBook.

Un guión ejecutable llamado lilypond-book extrae los fragmentos de música, les da formato y vuelve a poner en su lugar la partitura resultante. A continuación presentamos un pequeño ejemplo de su utilización con LaTeX. El ejemplo contiene también texto explicativo, por lo que no vamos a comentarlo posteriormente.

Entrada

\documentclass[a4paper]{article}

\begin{document}

Los documentos para \verb+lilypond-book+ pueden mezclar libremente
música y texto. Por ejemplo:

\begin{lilypond}
\relative {
  c'2 e2 \tuplet 3/2 { f8 a b } a2 e4
}
\end{lilypond}

Las opciones se escriben entre corchetes.

\begin{lilypond}[fragment,quote,staffsize=26,verbatim]
  c'4 f16
\end{lilypond}

Los ejemplos grandes se pueden grabar en archivos separados e
introducirse con \verb+\lilypondfile+.

\lilypondfile[quote,noindent]{screech-and-boink.ly}

(Si es necesario, sustituya @file{screech-and-boink.ly}
por cualquier archivo @file{.ly}
situado en el mismo directorio que este archivo.)

\end{document}

Procesado

Guarde el código anterior como un archivo llamado lilybook.lytex, y luego ejecute en un terminal:

lilypond-book --output=out --pdf lilybook.lytex
lilypond-book (GNU LilyPond) 2.25.22 
Leyendo lilybook.lytex...
…montañas de mensajes suprimidos…
Compilando lilybook.tex…
cd out
pdflatex lilybook
…montañas de mensajes suprimidos…
xpdf lilybook
(sustituya xpdf por su visor de PDF favorito)

La ejecución de lilypond-book y latex crea un gran número de archivos temporales, que podrían abarrotar el directorio de trabajo. Para poner remedio a esto utilice la opción --output=directorio. Creará los archivos en un subdirectorio aparte directorio.

Finalmente el resultado del ejemplo de LaTeX que acabamos de mostrar³. Así acaba la sección del tutorial.

Salida

Los documentos para lilypond-book pueden mezclar libremente música y texto. Por ejemplo:

Las opciones se escriben entre corchetes.

c'4 f16

Los ejemplos grandes se pueden grabar en archivos separados e introducirse con \lilypondfile.

Si se requiere un campo tagline, ya sea predeterminado o personalizado, entonces el fragmento completo se debe incluir dentro de una construcción \book { }.

\book{
  \header{
    title = "Una escala en LilyPond"
  }

  \relative {
    c' d e f g a b c
  }
}

3.2 Integrar música y texto

Aquí vamos a explicar cómo integrar LilyPond con algunos otros formatos de salida.

\begin{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}

\begin{lilypond}[quote,fragment,staffsize=26]
  c' d' e' f' g'2 g'2
\end{lilypond}

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

\def\betweenLilyPondSystem#1{\endinput}

\begin{lilypond}[fragment]
  c'1\( e'( c'~ \break c' d) e f\)
\end{lilypond}

\def\betweenLilyPondSystem#1{
    \ifnum#1<2\else\expandafter\endinput\fi
}

\let\betweenLilyPondSystem\undefined

\def\onlyFirstNSystems#1{
    \def\betweenLilyPondSystem##1{\ifnum##1<#1\else\endinput\fi}
}

\onlyFirstNSystems{3}
\begin{lilypond}…\end{lilypond}
\onlyFirstNSystems{1}
\begin{lilypond}…\end{lilypond}

@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}

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

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

<lilypond las opciones van aquí>
  EL CÓDIGO DE LILYPOND
</lilypond>

<lilypond las opciones van aquí: EL CÓDIGO DE LILYPOND />

<lilypondfile las opciones van aquí>archivo</lilypondfile>

<musicxmlfile las opciones van aquí>archivo</musicxmlfile>

<lilypond fragment relative=2>
\key c \minor c4 es g2
</lilypond>

Algo de música dentro de <lilypond relative=2: a b c/> una línea
de texto.

<lilypondfile opción1 opción2 …>archivo</lilypondfile>

<mediaobject>
  <imageobject>
    <imagedata fileref="music1.ly" role="printfilename" />
  </imageobject>
</mediaobject>

<inlinemediaobject>
  <textobject>
    <programlisting language="lilypond" role="fragment verbatim staffsize=16 ragged-right relative=2">
\context Staff \with {
  \remove Time_signature_engraver
  \remove Clef_engraver}
  { c4( fis) }
    </programlisting>
  </textobject>
</inlinemediaobject>

3.3 Opciones de fragmentos de música

Durante los próximos párrafos, una ‘instrucción de LilyPond’ se refiere a cualquier instrucción descrita en las secciones anteriores que se maneja por parte de lilypond-book para que produzca un fragmento de música. Por simplicidad, las instrucciones de LilyPond solamente se muestran en la sintaxis de LaTeX.

Observe que la cadena de opciones se analiza de izquierda a derecha; si una opción aparece varias veces, se toma la última solamente.

Están disponibles las siguientes opciones para las instrucciones de LilyPond:

staffsize=altura

Establecer la altura del pentagrama como altura, medida en puntos.

ragged-right

Producir líneas no justificadas por la derecha y con espaciado natural, es decir, se añade ragged-right = ##t al fragmento de LilyPond. Los fragmentos de una sola línea siempre se tipografían de forma predeterminada sin justificación por la derecha, a no ser que se use explícitamente la opción noragged-right.

noragged-right

Para fragmentos de una sola línea, permitir que la longitud del pentagrama se amplíe hasta igualar la anchura de la línea, es decir, se añade ragged-right = ##f al fragmento de LilyPond.

line-width

line-width=tamaño\unidades

Establecer el ancho de línea como tamaño, utilizando unidades como unidad. unidades es una de las siguientes cadenas: cm, mm, in o pt. Esta opción afecta a la salida de LilyPond (esto es, a la longitud del pentagrama del fragmento musical), no al formato del texto.

Si se usa sin ningún argumento, se establece el ancho de la línea a un valor predeterminado (calculado con un algoritmo heurístico).

Si no se da ninguna opción line-width, lilypond-book trata de adivinar un valor predeterminado para los entornos lilypond que no usan la opción ragged-right.

papersize=cadena

Donde cadena es un tamaño del papel definido en el archivo scm/paper.scm, es decir, a5, quarto, 11x17, etc.

Los valores no definidos en el archivo scm/paper.scm se ignoran, se emite una advertencia y el fragmento se imprime utilizando el tamaño predeterminado a4.

notime

No imprimir la indicación de compás, y desactivar las indicaciones temporales de la música (indicación del compás y líneas divisorias).

fragment

Hacer que lilypond-book añada algunos códigos necesarios para que podamos escribir simplemente, por ejemplo,

c'4

sin \layout, \score, etc.

nofragment

No incluir el código adicional que completa la sintaxis de LilyPond en los fragmentos de música. Al ser la opción predeterminada, nofragment normalmente es redundante.

indent=tamaño\unidades

Establecer el sangrado del primer sistema de pentagramas como tamaño, utilizando unidades como unidad. unidades es una de las siguientes cadenas: cm, mm, in o pt. Esta opción afecta a LilyPond, no al formato del texto.

noindent

Establecer el sangrado del primer sistema de la música como cero. Esta opción afecta a LilyPond, no al formato del texto. Puesto que el valor predeterminado es que no haya ningún sangrado, noindent normalmente es redundante.

quote

Reducir la longitud de la línea de un fragmento musical en 2*0.4in (pulgadas) y colocar la salida dentro de un bloque de cita (quotation). El valor de ‘0.4in’ se puede controlar con la opción exampleindent.

exampleindent

Establecer la longitud del sangrado que la opción quote aplica al fragmento musical.

relative

relative=n

Usar el modo de octava relativa. De forma predeterminada, las notas se especifican con relación al Do central. El argumento entero opcional especifica la octava de la nota inicial, donde el valor predeterminado 1 es el Do central. La opción relative sólo funciona cuando está establecida la opción fragment, de manera que fragment viene implicada automáticamente por relative, independientemente de la presencia de fragment o de nofragment en la fuente.

LilyPond utiliza también lilypond-book para producir su propia documentación. Para hacerlo, están a nuestra disposición ciertas opciones algo esotéricas para los fragmentos musicales.

verbatim

El argumento de una instrucción de LilyPond se copia al archivo de salida y se incluye dentro de un bloque «verbatim» o preformateado, seguido del texto que se escriba con la opción intertext (que no funciona aún); después se imprime la música en sí. Esta opción no funciona bien con \lilypond{} si forma parte de un párrafo.

Si se usa la opción verbatim dentro de una instrucción lilypondfile, es posible incluir con estilo preformateado sólo una parte del archivo fuente. Si el archivo de código fuente contiene un comentario que contiene ‘begin verbatim’ (sin las comillas), la cita del bloque de estilo preformateado empezará después de la última vez que aparezca este comentario; de forma similar, la cita del bloque preformateado se detendrá justo antes de la primera vez que aparezca un comentario que contenga ‘end verbatim’, si lo hay. En el siguiente ejemplo de código fuente, la música se interpreta en el modo relativo, pero la cita preformateada no presentará el bloque relative, es decir

\relative { % begin verbatim
  c'4 e2 g4
  f2 e % end verbatim
}

se imprime como un bloque preformateado como

  c4 e2 g4
  f2 e

Si queremos traducir los comentarios y los nombres de variable en la salida literal pero no en el código fuente, podemos establecer el valor de la variable de entorno LYDOC_LOCALEDIR a la ruta de un directorio; este directorio debe contener un árbol de catálogos de mensajes .mo con lilypond-doc como dominio.

texidoc

(Sólo para la salida de Texinfo.) Si se llama a lilypond con la opción --header=texidoc, y el archivo que se procesa se llama fulanito.ly, crea un archivo fulanito.texidoc si existe un campo texidoc dentro del bloque \header de cabecera. La opción texidoc hace que lilypond-book incluya estos archivos, añadiendo su contenido como un bloque de documentación inmediatamente antes del fragmento musical (pero fuera del entorno example generado por la opción quote).

Suponiendo que el archivo fulanito.ly contiene

\header {
  texidoc = "Este archivo es un ejemplo de una sola nota."
}
{ c'4 }

y que tenemos lo siguiente en nuestro documento de Texinfo prueba.texinfo

@lilypondfile[texidoc]{fulanito.ly}

la siguiente orden da como salida el resultado esperado:

lilypond-book --pdf --process="lilypond \
  --header=texidoc" test.texinfo

La mayoría de los documentos de prueba de LilyPond (en el directorio input de la distribución) son pequeños archivos .ly que tienen exactamente este aspecto.

Por motivos de localización de idioma, si el documento de Texinfo contiene @documentlanguage LANG y la cabecera de loquesea.ly contiene un campo texidocLANG, y lilypond se ejecuta con --header=texidocLANG, entonces se incluirá loquesea.texidocLANG en lugar de loquesea.texidoc.

doctitle

(Sólo para la salida de Texinfo.) Esta opción funciona de forma parecida a la opción texidoc: si lilypond se llama con la opción --header=doctitle, y el archivo que procesar se llama loquesea.ly y contiene un campo doctitle en el bloque \header, crea un archivo loquesea.doctitle. Cuando se usa la opción doctitle, el contenido de loquesea.doctitle, que debería ser una línea única de texto, se inserta en el documento de Texinfo como @lydoctitle texto. @lydoctitle debe ser un macro definido en el documento de Texinfo. La misma indicación referida al procesado de texidoc con idiomas localizados se aplica a doctitle.

nogettext

(Sólo para la salida de Texinfo.) No traducir los comentarios y nombres de variable en el fragmento de código literal citado.

printfilename

Si un archivo de entrada de LilyPond se incluye con \lilypondfile, imprimir el nombre del archivo inmediatamente antes del fragmento musical. Para la salida HTML, esto es un enlace. Sólo se imprime el nombre base del archivo, es decir, se elimina la parte del directorio de la ruta del archivo.

3.4 Invocar lilypond-book

lilypond-book produce un archivo con una de las siguientes extensiones: .tex, .texi, .html o .xml, dependiendo del formato de salida. Todos los archivos .tex, .texi y .xml necesitan un procesado posterior.

Instrucciones específicas de formato

LaTeX

Hay dos formas de procesar el documento en LaTeX para su impresión o publicación: hacer un archivo PDF directamente con PDFLaTeX, o generar un archivo PostScript con LaTeX a través de un traductor de DVI a PostScript como dvips. la primera forma es más sencilla y es la que se recomienda⁴, y cualquiera que sea el método que utilice, podrá convertir fácilmente entre PostScript y PDF con herramientas como ps2pdf y pdf2ps que vienen incluidas con Ghostscript.

Para producir un archivo PDF por medio de PDFLaTeX, utilice:

lilypond-book --pdf miarchivo.pdftex
pdflatex miarchivo.tex

Para producir una salida PDF por medio de LaTeX/dvips/ps2pdf:

lilypond-book miarchivo.lytex
latex miarchivo.tex
dvips -Ppdf miarchivo.dvi
ps2pdf miarchivo.ps

El archivo .dvi creado por este proceso no contiene las cabezas de las notas. Esto es normal; si sigue las instrucciones, las cabezas aparecerán en los archivos .ps y .pdf.

La ejecución de dvips puede dar como resultado algunas advertencias sobre las fuentes tipográficas; son inocuas y se pueden ignorar. Si está ejecutando latex en modo de dos columnas, recuerde añadir -t landscape a las opciones de dvips.

Entornos tales como:

\begin{lilypond} … \end{lilypond}

no se interpretan por parte de LaTeX. En su lugar, el programa lilypond-book extrae estos ‘entornos’ como archivos independientes y ejecuta LilyPond sobre ellos. Después, toma las imágenes resultantes y crea un archivo .tex en el que los macros \begin{lilypond}…\end{lilypond} se sustituyen por instrucciones de ‘inserción de gráficos’. A continuación, se ejecuta LaTeX (aunque LaTeX se ha ejecutado anteriormente, lo habrá sido sobre un archivo ‘vacío’ para calcular cosas como el \linewidth).

Advertencias y problemas conocidos

La instrucción \pageBreak no funciona dentro de un entorno \begin{lilypond} … \end{lilypond}.

Muchas variables del bloque \paper tampoco funcionan dentro de un entorno \begin{lilypond} … \end{lilypond}. Use \newcommand con \betweenLilyPondSystem en el preámbulo:

\newcommand{\betweenLilyPondSystem}[1]{\vspace{36mm}\linebreak}

Texinfo

Para producir un documento de Texinfo (en cualquier formato de salida), siga el procedimiento normal para Texinfo, esto es: o bien llame a texi2pdf o a texi2dvi o a texi2any, según el formato de la salida que quiera crear. Consulte la documentación de Texinfo para ver más detalles.

Opciones de la línea de órdenes

lilypond-book acepta las siguientes opciones de la línea de órdenes:

-f formato

--format=formato

Especificar el tipo del documento que se va a procesar: html, latex, texi (predeterminado) o docbook. Si falta esta opción, lilypond-book tratará de detectar el formato automáticamente, véase Extensiones de nombres de archivo. Por el momento, texi es lo mismo que texi-html.

-F filtro

--filter=filtro

Conducir los fragmentos a través de filter por medio de una tubería. lilypond-book no obedecerá –filter y –process al mismo tiempo. Por ejemplo,

lilypond-book --filter='convert-ly --from=2.0.0 -' mi-libro.tely

-h

--help

Imprimir un breve mensaje de ayuda.

-I directorio

--include=directorio

Añadir directorio a la ruta de inclusión. lilypond-book busca también los fragmentos ya compilados en la ruta de inclusión, y no los vuelve a escribir en el directorio de salida, así que en ciertos casos es necesario invocar instrucciones de procesado posteriores como texi2any o latex con las mismas opciones -I directorio.

-l nivel_de_registro

--loglevel=nivel_de_registro

Fijar el nivel en que la salida es prolija, al valor nivel_de_registro. Los valores posibles son NONE (nada), ERROR (errores), WARN (advertencias), PROGRESS (avance; predeterminado) y DEBUG (depuración). Si esta opción no se utiliza, y la variable de entorno LILYPOND_BOOK_LOGLEVEL está establecida, se usa su valor como el nivel de registro.

-o directorio

--output=directorio

Colocar los archivos generados en el directorio. La ejecución de lilypond-book genera montañas de pequeños archivos que luego procesará LilyPond. Para evitar toda esta parafernalia en el mismo directorio que la fuente, utilice la opción --output, y cambie a este directorio antes de ejecutar latex o texi2any.

lilypond-book --output=out miarchivo.lytex
cd out
…

--skip-lily-check

Evitar el fracaso si no se encuentra ninguna salida de lilypond. Se usa para la documentación de LilyPond en formato Info sin imágenes.

--skip-png-check

Evitar el fracaso si no se encuentran las imágenes PNG de los archivos EPS. Se usa para la documentación de LilyPond en formato Info sin imágenes.

--lily-output-dir=directorio

Escribir archivos lily-XXX en el directorio directorio, enlazar en el directorio de --output. Use esta opción para ahorrar tiempo de construcción para documentos de distintos directorios que comparten muchos fragmentos idénticos de código.

--lily-loglevel=nivel_de_registro

Fijar el nivel en que la salida es prolija para las llamadas de la instrucción invocada lilypond, al valor nivel_de_registro. Los valores posibles son NONE (nada), ERROR (errores), WARN (advertencias), BASIC (avance básico), PROGRESS (avance), INFO (información; predeterminado) y DEBUG (depuración). Si no se utiliza esta opción y la variable de entorno LILYPOND_LOGLEVEL está establecida, su valor se usa como nivel de registro.

--info-images-dir=directorio

Dar formato a la salida de Texinfo de manera que Info busque las imágenes de música en directorio.

--latex-program=prog

Ejecutar el programa prog en vez de latex. Esto es útil si nuestro documento se procesa con xelatex, por ejemplo.

--left-padding=cantidad

Rellenar las cajas EPS en esta medida, alrededor. cantidad se mide en milímetros, y es 3.0 como valor predeterminado. Esta opción se debe usar si las líneas de música están muy pegadas al margen derecho.

El ancho de un sistema que está muy ajustado dentro de su rectángulo puede variar, debido a los elementos de notación que están pegados al margen izquierdo, como los números de compás y el nombre del instrumento. Esta opción acorta todas las líneas y las mueve a la derecha en la misma medida.

-P instrucción

--process=instrucción

Procesar los fragmentos de LilyPond utilizando instrucción. La instrucción predeterminada es lilypond. lilypond-book no obedecerá a --filter y a --process al mismo tiempo.

--pdf

Crear archivos PDF para su uso con PDFLaTeX.

--redirect-lilypond-output

De forma predeterminada, la salida se imprime por la consola. Esta opción redirecciona toda la salida hacia archivos de registro situados en el mismo directorio que los archivos fuente.

--use-source-file-names

Escribir los archivos de salida de los fragmentos de música con el mismo nombre de base que su archivo fuente. Esta opción sólo funciona para fragmentos incluidos con lilypondfile y sólo si los directorios determinados por las opciones --output-dir y --lily-output-dir son distintos.

-V

--verbose

Ser prolijo. Equivale a --loglevel=DEBUG.

-v

--version

Imprimir la información de la versión.

Advertencias y problemas conocidos

La instrucción de Texinfo @pagesizes no se interpreta. De forma similar, las instrucciones de LaTeX que cambian los márgenes y anchos de línea después del preámbulo se ignoran.

Sólo se procesa el primer \score de un bloque LilyPond.

3.5 Extensiones de nombres de archivo

Puede usar cualquier extensión para el nombre del archivo de entrada, pero si no usa la extensión recomendada para un formato en particular tendrá que especificar manualmente el formato de salida; para ver más detalles, consulte Invocar lilypond-book. En caso contrario, lilypond-book selecciona automáticamente el formato de salida basándose en la extensión del nombre del archivo de entrada.

extensión	formato de salida
.html	HTML
.htmly	HTML
.itely	Texinfo
.latex	LaTeX
.lytex	LaTeX
.lyxml	DocBook
.tely	Texinfo
.tex	LaTeX
.texi	Texinfo
.texinfo	Texinfo
.xml	HTML

Si usa la misma extensión para el archivo de entrada que la que usa lilypond-book para el archivo de salida, y si el archivo de entrada está en el mismo directorio que el directorio de trabajo de lilypond-book, debe usar la opción --output para que funcione lilypond-book, pues en caso contrario saldrá con un mensaje de error como “La salida sobreescribirá al archivo de entrada”.

3.6 Plantillas de lilypond-book

Estas plantillas se usan para lilypond-book. Si no está familiarizado con este programa, consulte Ejecución de lilypond-book.

LaTeX

Podemos insertar fragmentos de LilyPond dentro de un documento de LaTeX.

\documentclass[]{article}

\begin{document}

Texto normal en LaTeX.

\begin{lilypond}
\relative {
  a'4 b c d
}
\end{lilypond}

Más texto en LaTeX, y las opciones dentro de los corchetes.

\begin{lilypond}[fragment,relative=2,quote,staffsize=26,verbatim]
d4 c b a
\end{lilypond}
\end{document}

Texinfo

Podemos insertar fragmentos de LilyPond dentro de Texinfo; de hecho, todo el presente manual está escrito en Texinfo.

\input texinfo @node Top
@top

Texto en Texinfo

@lilypond
\relative {
  a4 b c d
}
@end lilypond

Más texto en Texinfo, y las opciones dentro de los corchetes.

@lilypond[verbatim,fragment,ragged-right]
d4 c b a
@end lilypond

@bye

html

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML>
<body>

<p>
Los documentos para lilypond-book pueden mezclar música y texto libremente.  Por
ejemplo,
<lilypond>
\relative {
  a'4 b c d
}
</lilypond>
</p>

<p>
Otro poco de lilypond, esta vez con opciones:

<lilypond fragment quote staffsize=26 verbatim>
a4 b c d
</lilypond>
</p>

</body>
</html>

xelatex

\documentclass{article}
\usepackage{ifxetex}
\ifxetex
%xetex specific stuff
\usepackage{xunicode,fontspec,xltxtra}
\setmainfont[Numbers=OldStyle]{Times New Roman}
\setsansfont{Arial}
\else
%Esto se puede dejar vacío si no vamos a utilizar pdftex
\usepackage[T1]{fontenc}
\usepackage[utf8]{inputenc}
\usepackage{mathptmx}%Times
\usepackage{helvet}%Helvetica
\fi
%Aquí insertamos todos los paquetes que pdftex también entiende
\usepackage[ngerman,finnish,english]{babel}
\usepackage{graphicx}

\begin{document}
\title{Un documento breve con LilyPond y xelatex}
\maketitle

Las instrucciones \textbf{font} normales dentro del \emph{texto}
funcionan, porque \textsf{están contempladas por \LaTeX{} y
XeteX.}  Si queremos usar instrucciones específicas como
\verb+\XeTeX+, debemos incluirlas de nuevo dentro de un entorno
\verb+\ifxetex+.  Podemos utilizar esto para imprimir la
instrucción \ifxetex \XeTeX{} \else XeTeX \fi que no es conocida
para el \LaTeX\ normal.

Dentro del texto normal podemos utilizar instrucciones de LilyPond
fácilmente, de esta forma:

\begin{lilypond}
{a2 b c'8 c' c' c'}
\end{lilypond}

\noindent
y así sucesivamente.

La fuente tipográfica de los fragmentos, establecida con LilyPond,
tendrá que establecerse desde dentro del fragmento. Para esto
puede leer la parte de lilypond-book en el manual de utilización.

\selectlanguage{ngerman}
Auch Umlaute funktionieren ohne die \LaTeX -Befehle, wie auch alle
anderen
seltsamen Zeichen: __ ______, wenn sie von der Schriftart
unterst__tzt werden.
\end{document}

3.7 Compartir el índice general

Estas funciones ya existen en el paquete OrchestralLily:

https://repo.or.cz/w/orchestrallily.git

Para conseguir más flexibilidad en el manejo del texto, algunos usuarios prefieren exportar la el índice general o tabla de contenidos desde lilypond y leerla dentro de LaTeX.

Exportación del índice general desde LilyPond

Esto supone que nuestra partitura tiene varios movimientos dentro del mismo archivo de salida de lilypond.

#(define (oly:create-toc-file layout pages)
  (let* ((label-table (ly:output-def-lookup layout 'label-page-table)))
    (if (not (null? label-table))
      (let* ((format-line (lambda (toc-item)
             (let* ((label (car toc-item))
                    (text  (caddr toc-item))
                    (label-page (and (list? label-table)
                                     (assoc label label-table)))
                    (page (and label-page (cdr label-page))))
               (format #f "~a, section, 1, {~a}, ~a" page text label))))
             (formatted-toc-items (map format-line (toc-items)))
             (whole-string (string-join formatted-toc-items ",\n"))
             (output-name (ly:parser-output-name))
             (outfilename (format #f "~a.toc" output-name))
             (outfile (open-output-file outfilename)))
        (if (output-port? outfile)
            (display whole-string outfile)
            (ly:warning (G_ "Unable to open output file ~a for the TOC information") outfilename))
        (close-output-port outfile)))))

\paper {
  #(define (page-post-process layout pages) (oly:create-toc-file layout pages))
}

Importación del índice general dentro de LaTeX

En LaTeX, la cabecera debe incluir lo siguiente:

\usepackage{pdfpages}
\includescore{nombredelapartitura}

donde \includescore está definido como:

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% \includescore{PossibleExtension}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

% Leer las entradas del índice general para un archivo PDF
% a partir del archivo .toc correspondeiente.
% Esto requiere bastantes trucos de latex, porque leer cosas de un archivo
% e insertarlo dentro de los argumentos de un macro no es posible
% fácilmente.

% Solución de Patrick Fimml en el canal #latex el 18 de abril de 2009:
% \readfile{filename}{\variable}
% lee el contenido del archivo en \variable (no definida si el
% archivo no existe)
\newread\readfile@f
\def\readfile@line#1{%
{\catcode`\^^M=10\global\read\readfile@f to \readfile@tmp}%
\edef\do{\noexpand\g@addto@macro{\noexpand#1}{\readfile@tmp}}\do%
\ifeof\readfile@f\else%
\readfile@line{#1}%
\fi%
}
\def\readfile#1#2{%
\openin\readfile@f=#1 %
\ifeof\readfile@f%
\typeout{No TOC file #1 available!}%
\else%
\gdef#2{}%
\readfile@line{#2}%
\fi
\closein\readfile@f%
}%


\newcommand{\includescore}[1]{
\def\oly@fname{\oly@basename\@ifmtarg{#1}{}{_#1}}
\let\oly@addtotoc\undefined
\readfile{\oly@xxxxxxxxx}{\oly@addtotoc}
\ifx\oly@addtotoc\undefined
\includepdf[pages=-]{\oly@fname}
\else
\edef\includeit{\noexpand\includepdf[pages=-,addtotoc={\oly@addtotoc}]
{\oly@fname}}\includeit
\fi
}

3.8 Métodos alternativos para mezclar texto y música

Otras formas de mezclar texto y música (sin lilypond-book) se estudian en Otros programas.

4.1 Apuntar y pulsar

«Point and click» (apuntar y pulsar con el ratón) le da la posibilidad de localizar notas del código de entrada pulsando sobre ellas dentro del visor de PDF. Ello facilita encontrar los fragmentos de la entrada que producen algún tipo de error en la partitura.

export LYEDITOR=atom

atom %(file)s:%(line)s:%(column)s

export LYEDITOR="code --goto %(file)s:%(line)s:%(column)s"

urlCommand     "lilypond-invoke-editor %s"

sudo apt-mark hold xpdf

gconftool-2 -t string -s /desktop/gnome/url-handlers/textedit/command "lilypond-invoke-editor %s"
gconftool-2 -s /desktop/gnome/url-handlers/textedit/needs_terminal false -t bool
gconftool-2 -t bool -s /desktop/gnome/url-handlers/textedit/enabled true

gnome-open textedit:///etc/issue:1:0:0

[Desktop Entry]
Version=1.0
Name=lilypond-invoke-editor
GenericName=Textedit URI handler
Comment=URI handler for textedit:
Exec=lilypond-invoke-editor %u
Terminal=false
Type=Application
MimeType=x-scheme-handler/textedit;
Categories=Editor
NoDisplay=true

xdg-desktop-menu install ./lilypond-invoke-editor.desktop
xdg-mime default lilypond-invoke-editor.desktop x-scheme-handler/textedit

gnome-open textedit:///etc/issue:1:0:0

# Para enlaces de Textedit
/usr/local/bin/lilypond-invoke-editor Cx -> sanitized_helper,

sudo apparmor_parser -r -T -W /etc/apparmor.d/usr.bin.evince

\pointAndClickOff

\pointAndClickOn

lilypond -dno-point-and-click archivo.ly

4.2 Apoyo respecto de los editores de texto

Existe apoyo por parte de varios editores de texto para LilyPond.

(setq load-path (append (list (expand-file-name "~/site-lisp")) load-path))

filetype off
set runtimepath+=/usr/local/share/lilypond/current/vim/
filetype on
syntax on

4.3 Conversión desde otros formatos

También se puede escribir la música a través de su importación desde otros formatos. Este capítulo trata de documentar las herramientas incluidas en la distribución que permiten hacerlo. Existen otras herramientas que producen código de entrada de LilyPond, como por ejemplo secuenciadores con interfaz gráfico y convertidores de XML. Consulte el website para ver más detalles.

Son programas distintos a lilypond propiamente dicho, y se ejecutan desde la línea de órdenes; consulte Utilización desde la línea de órdenes para ver más información.

Advertencias y problemas conocidos

Por desgracia no disponemos de los recursos necesarios para poder mantener estos programas; le rogamos que los tome “tal cual están”. Se agradecerá el envío de parches correctores, pero los informes de fallo casi con certeza no se resolverán a medio plazo.

midi2ly [opción]… archivo_midi

musicxml2ly [opción]… archivo.xml

abc2ly [opción]… archivo_abc

%%LY voices \set autoBeaming = ##f

%%LY slyrics más palabras

etf2ly [opción]… archivo_etf

4.4 Salida de LilyPond dentro de otros programas

Esta sección presenta métodos para integrar texto y música distintos del método automatizado con lilypond-book.

\paper{
  indent=0\mm
  line-width=120\mm
  oddFooterMarkup=##f
  oddHeaderMarkup=##f
  bookTitleMarkup = ##f
  scoreTitleMarkup = ##f
}

… music …

lilypond -dbackend=eps -dno-gs-load-fonts -dinclude-eps-fonts miarchivo.ly

lilypond -dbackend=eps -dno-gs-load-fonts -dinclude-eps-fonts --png miarchivo.ly

lilypond -dbackend=eps -dno-gs-load-fonts -dinclude-eps-fonts -dpixmap-format=pngalpha --png miarchivo.ly

4.5 Archivos de inclusión independientes

Algunos usuarios han producido archivos que se pueden incluir con la instrucción \include en LilyPond para producir ciertos efectos, y aquellos que se relacionan más abajo forman parte de la distribución de LilyPond. Véase también Trabajar sobre los archivos de entrada.

5.1 Sugerencias de tipo general

Presentamos algunas sugerencias que le pueden servir de ayuda para evitar o corregir los problemas más comunes al realizar trabajos de tipografía musical:

• Incluya siempre el número de \version en los archivos de entrada, aun en los más pequeños. Ello evita tener que recordar para qué versión de LilyPond se creó el archivo y es especialmente relevante al Actualizar ficheros con convert-ly (una instrucción que requiere que el enunciado \version esté presente); o si está enviando código de entrada a otros usuarios (p.ej. si está pidiendo ayuda en una de las listas de distribución de correo). Observe que todas las plantillas de LilyPond contienen números de \version.
• Escriba un compás de música en cada línea del código de entrada. Esto hará que la búsqueda de problemas dentro de los archivos de entrada sea mucho más sencilla.
• Inserte barras de Comprobación de compás y de número de compás así como códigos de Comprobación de octava. La inclusión de códigos de comprobación de estos tipos será de ayuda para localizar los errores mucho más rápidamente. La frecuencia con que añadir las comprobaciones dependerá de la complejidad de la música que se está componiendo tipográficamente. Para composiciones sencillas, las comprobaciones añadidas en ciertos puntos estratégicos dentro de la música pueden ser suficientes, pero para música más compleja, con muchas voces y/o pentagramas, sería mejor poner comprobaciones a cada compás.
• Inserte comentarios en el código de entrada. Las referencias a los temas musicales (p.ej. ‘segundo tema en los violines’, ‘cuarta variación’, etc.), o simplemente la inclusión de los números de compás como compentarios, hará mucho más sencilla la navegación por el archivo de entrada, especialmente si más tarde se hace necesario alterar algo, o si estamos pasando los archivos de entrada a otra persona.
• Escriba las duraciones explícitamente al comienzo de las ‘secciones’. Por ejemplo, si especifica c4 d e f al principio de una frase (en lugar de sólo c d e f) se puede ahorrar problemas si reelabora la música más tarde.
• Aprenda a aplicar márgenes y sangrados a las llaves y a la música paralela. Muchos problemas suelen estar producidos por llaves de apertura o de cierre que faltan. La aplicación clara de sangrados a las llaves curvas de apertura y de cierre (o a los indicadores << y >>) será de ayuda para evitar tales problemas.

  Por ejemplo:

  \new Staff {
    \relative {
      r4 g'8 g c8 c4 d |
      e4 r8 |
      % sección de Ossia
      <<
        { f8 c c | }
        \new Staff {
          f8 f c |
        }
      >>
      r4 |
    }
  }
  

  es mucho más fácil de seguir que:

  \new Staff { \relative { r4 g'8 g c4 c8 d | e4 r8
  % sección de Ossia
  << { f8 c c } \new Staff { f8 f c } >> r4 | } }
  

• Mantenga separados la música y el estilo poniendo las sobreescrituras dentro del bloque \layout:

  \score {
    …música…
    \layout {
     \override TabStaff.Stemstencil = ##f
   }
  }
  

  Esto no crea un contexto nuevo, sino que se aplicará en el momento de crear uno. Véase también Ahorrar tecleo mediante variables y funciones y Hojas de estilo.

5.2 Tipografiar música existente

Si está introduciendo música a partir de una partitura existente (es decir, tipografiando una hoja de música ya impresa),

• Introduzca en LilyPond un sistema del manuscrito, o copia física, de cada vez (pero mantenga la práctica de escribir un compás por línea de texto), y compruebe cada sistema cuando lo haya terminado. Puede usar las propiedades showLastLength o showFirstLength para acelerar el proceso (véase Saltar la música corregida).
• Defina mBreak = { \break } e inserte \mBreak dentro del archivo de entrada donde el manuscrito tenga un saldo de línea. De esta forma le resultará mucho más fácil comparar la música de LilyPond con la original. Cuando haya terminado de revisar su partitura podrá definir mBreak = { } para quitar todos esos saltos de línea. Así permitirá a LilyPond colocar los saltos donde éste lo estime más oportuno.
• Al escribir una parte para un instrumento transpositor dentro de una variable, se recomienda que las notas estén envueltas dentro de

  \transpose c altura-natural {…}
  

  (donde altura-natural es la afinación natural del instrumento) de forma que la música dentro de la variable esté realmente en Do mayor. Después podemos volver a transportarlas en sentido inverso cuando se utiliza la variable, si es necesario, pero quizá no queramos hacerlo (p.ej., al imprimir una partitura en afinación de concierto, al convertir una parte de trombón de clave de Sol a clave de Fa, etc.). Es menos probable cometer errores en los transportes si toda la música que está dentro de las variables se encuentra en un tono coherente.

  Asimismo, haga los transportes exclusivamente hacia o desde Do mayor. Esto significa que aparte de ésta, las únicas tonalidades que usaremos serán los tonos de afinación de los instrumentos transpositores: bes para una trompeta en Si bemol, aes para un clarinete en La bemol, etc.

5.3 Proyectos grandes

Al trabajar en proyectos grandes se hace esencial tener una estructura clara en los archivos de LilyPond:

• Utilice un identificador para cada voz, con un mínimo de estructura dentro de la definición. La estructura de la sección \score es la que cambiará con mayor probabilidad; por contra, es extremadamente improbable que cambie la definición de violin en versiones nuevas de LilyPond.

  violin = \relative {
  g'4 c'8. e16
  }
  …
  \score {
    \new GrandStaff {
      \new Staff {
        \violin
      }
    }
  }
  

• Separe los trucos de las definiciones musicales. Ya se mencionó con anterioridad, pero para proyectos grandes es vital. Quizá tengamos que cambiar la definición de fluegop, pero en ese caso sólo lo tendremos que hacer una vez, y aún podremos evitar tocar nada dentro de violin.

  fluegop = _\markup{
    \dynamic f \italic \small { 2nd } \hspace #0.1 \dynamic p }
  violin = \relative {
  g'4\fluegop c'8. e16
  }
  

5.4 Solución de problemas

Antes o después escribirá un archivo que LilyPond no podrá compilar. Los mensajes que LilyPond proporciona pueden ayudarle a encontrar el error, pero en muchos casos tendrá que llevar a cabo algún tipo de investigación para determinar el origen del problema.

Las herramientas más poderosas para este cometido son el comentario de una sola línea (indicado por %) y el comentario de bloque (indicado por %{…%}). Si no sabe dónde está el problema, comience convirtiendo grandes secciones del archivo de entrada en un comentario. Después de eliminar una sección convirtiéndola en un comentario, pruebe a compilar el archivo otra vez. Si funciona, entonces el problema debía estar en la porción que había eliminado. Si no funciona, continúe eliminando material (transformándolo en comentarios) hasta que tenga algo que funcione.

En un caso extremo podría terminar con sólo

\score {
  <<
    % \melodia
    % \armonia
    % \bajo
  >>
  \layout{}
}

(en otras palabras: un archivo sin música)

Si ocurre esto, no abandone. Descomente un trozo pequeño – digamos la parte del bajo – y observe si funciona. Si no es así, transforme en comentarios toda la música del bajo (pero deje el \bajo de la sección \score no comentado.

bajo = \relative {
%{
  c'4 c c c
  d d d d
%}
}

Ahora empiece poco a poco descomentando cada vez más fracciones de la parte del bajo hasta que encuentre la línea del problema.

Otra técnica de depuración muy útil es la construcción de Ejemplos mínimos.

5.5 Make y los Makefiles

Posiblemente todas las plataformas en que puede correr LilyPond, contemplan una posibilidad de software llamada make. Este programa lee un archivo especial llamado Makefile que define las relaciones de dependencia entre los archivos y qué instrucciones necesitamos dar al sistema operativo para producir un archivo a partir de otro. Por ejemplo, el archivo de make detallaría cómo obtener balada.pdf y balada.midi a partir de balada.ly mediante la ejecución de LilyPond.

Existen ocasiones en las que es buena idea crear un Makefile para nuestro proyecto, bien sea por nuestra propia comodidad o como cortesía para otros que posiblemente tengan acceso a nuestros archivos fuente. Esto es cierto para proyectos muy grandes con muchos archivos de inclusión y distintas opciones de salida (p.ej. partitura completa, particellas, partitura del director, reducción para piano, etc.), o para proyectos que requieren instrucciones difíciles para montarlas (como los proyectos de lilypond-book). La complejidad y flexibilidad de los Makefiles varía enormemente según las necesidades y la habilidad de los autores. El programa GNU Make viene instalado en las distribuciones de GNU/Linux y en MacOS X, y también existe para Windows.

Consulte el Manual de GNU Make para ver todos los detalles sobre el uso de make, pues lo que sigue a continuación ofrece solamente una pincelada de todo lo que es capaz de hacer.

Las instrucciones que definen las reglas en un archivo de make difieren en función de la plataforma; por ejemplo, las distintas formas de GNU/Linux y MacOS usan bash, mientras que Windows usa cmd. Observeque en MacOS X, tenemos que configurar el sistema para que utilice el intérprete de órdenes. A continuación presentamos algunos makefiles de ejemplo, con versiones tanto para GNU/Linux/MacOS como para Windows.

El primer ejemplo es para una obra orquestal en cuatro movimientos con la estructura de directorios siguiente:

Sinfonia/
|-- MIDI/
|-- Makefile
|-- Notas/
|   |-- cello.ily
|   |-- cifras.ily
|   |-- trompa.ily
|   |-- oboe.ily
|   |-- trioCuerdas.ily
|   |-- viola.ily
|   |-- violinUno.ily
|   `-- violinDos.ily
|-- PDF/
|-- Particellas/
|   |-- sinfonia-cello.ly
|   |-- sinfonia-trompa.ly
|   |-- sinfonia-oboes.ly
|   |-- sinfonia-viola.ly
|   |-- sinfonia-violinUno.ly
|   `-- sinfonia-violinDos.ly
|-- Partituras/
|   |-- sinfonia.ly
|   |-- sinfoniaI.ly
|   |-- sinfoniaII.ly
|   |-- sinfoniaIII.ly
|   `-- sinfoniaIV.ly
`-- sinfoniaDefs.ily

Los archivos .ly de los directorios Partituras y Particellas obtienen las notas de archivos .ily que están en el directorio Notas:

%%% principio del archivo "sinfonia-cello.ly"
\include ../definicionesSinf.ily
\include ../Notas/cello.ily

El makefile tendrá los objetivos de partitura (la pieza completa en todo su esplendor), movimientos (partitura completa de los movimientos individuales) y particellas (partes individuales para los atriles). También existe un objetivo archivo que produce un tarball de los archivos fuente, adecuado para compartirlo a través de la web o por correo electrónico. A continuación presentamos el makefile para GNU/Linux o MacOS X. Se debe guardar con el nombre exacto Makefile el el directorio superior del proyecto:

# nombre principal de los archivos de salida
nombre = sinfonia
# determinar cuántos procesadores existen
CPU_CORES=`cat /proc/cpuinfo | grep -m1 "cpu cores" | sed s/".*: "//`
# La instrucción para ejecutar lilypond
LILY_CMD = lilypond -ddelete-intermediate-files \
                    -dno-point-and-click -djob-count=$(CPU_CORES)

# Los sufijos utilizados en este Makefile.
.SUFFIXES: .ly .ily .pdf .midi

# Los archivos de entrada y salida se buscan dentro de los directorios relacionados en
# la variable VPATH.  Todos esllos son subdirectorios del directorio
# en curso (dado por la variable de GNU make `CURDIR').
VPATH = \
  $(CURDIR)/Partituras \
  $(CURDIR)/PDF \
  $(CURDIR)/Particellas \
  $(CURDIR)/Notas

# La regla de patrón para crear archivos PDF y MIDI a partir de un archivo de entrada LY.
# Los archivos de salida .pdf se colocan en el subdirectorio `PDF', y los archivos
# .midi van al subdirectorio `MIDI'.
%.pdf %.midi: %.ly
        $(LILY_CMD) $<; \           # esta línea comienza con un salto de tabulación
        if test -f "$*.pdf"; then \
            mv "$*.pdf" PDF/; \
        fi; \
        if test -f "$*.midi"; then \
            mv "$*.midi" MIDI/; \
        fi

notas = \
  cello.ily \
  trompa.ily \
  oboe.ily \
  viola.ily \
  violinUno.ily \
  violinDos.ily

# Dependencias de los movimientos.
$(nombre)I.pdf: $(nombre)I.ly $(notas)
$(nombre)II.pdf: $(nombre)II.ly $(notas)
$(nombre)III.pdf: $(nombre)III.ly $(notas)
$(nombre)IV.pdf: $(nombre)IV.ly $(notas)

# Dependencias de la partitura completa.
$(nombre).pdf: $(nombre).ly $(notas)

# Dependencias de las particellas.
$(nombre)-cello.pdf: $(nombre)-cello.ly cello.ily
$(nombre)-trompa.pdf: $(nombre)-trompa.ly trompa.ily
$(nombre)-oboes.pdf: $(nombre)-oboes.ly oboe.ily
$(nombre)-viola.pdf: $(nombre)-viola.ly viola.ily
$(nombre)-violinUno.pdf: $(nombre)-violinUno.ly violinUno.ily
$(nombre)-violinDos.pdf: $(nombre)-violinDos.ly violinDos.ily

# Teclee `make partitura' para generer la partitura completa de los cuatro
# movimientos como un archivo único.
.PHONY: partitura
partitura: $(nombre).pdf

# Teclee `make particellas' para generar todas las particellas.
# Teclee `make fulanito.pdf' para generar la particella del instrumento `fulanito'.
# Ejemplo: `make sinfonia-cello.pdf'.
.PHONY: particellas
particellas: $(nombre)-cello.pdf \
       $(nombre)-violinUno.pdf \
       $(nombre)-violinDos.pdf \
       $(nombre)-viola.pdf \
       $(nombre)-oboes.pdf \
       $(nombre)-trompa.pdf

# Teclee `make movimientos' para generar los archivos de los
# cuatro movimientos de forma separada.
.PHONY: movimientos
movimientos: $(nombre)I.pdf \
           $(nombre)II.pdf \
           $(nombre)III.pdf \
           $(nombre)IV.pdf

all: partitura particellas movimientos

archivo:
        tar -cvvf stamitz.tar \       # esta línea comienza con un salto de tabulación
        --exclude=*pdf --exclude=*~ \
        --exclude=*midi --exclude=*.tar \
        ../Stamitz/*

Existen ciertas complicaciones en la plataforma Windows. Después de descargar e instalar el programa GNU Make para Windows, debemos configurar la ruta adecuada en las variables de entorno del sistema de forma que el shell del DOS pueda encontrar el programa Make. Para hacerlo, pulse con el botón derecho sobre "Mi PC", elija Propiedades y Avanzadas. Pulse sobre Variables de entorno, y luego en la pestaña Variables del sistema, seleccione Ruta, pulse sobre editar y añada la ruta al archivo ejecutable de GNU Make, con lo que quedará algo parecido a lo siguiente:

C:\Archivos de programa\GnuWin32\bin

El makefile en sí debe modificarse para que maneje distintas instrucciones del shell y para que pueda tratar con los espacios que aparecen en el nombre de algunos directorios del sistema predeterminados. El objetivo archivo se elimina porque Windows no tiene la instrucción tar, y Windows tiene también una extensión predeterminada distinta para los archivos MIDI.

## VERSIÓN PARA WINDOWS
##
nombre = sinfonia
LILY_CMD = lilypond -ddelete-intermediate-files \
                    -dno-point-and-click \
                    -djob-count=$(NUMBER_OF_PROCESSORS)

#obtener el nombre 8.3 de CURDIR (rodeo para los espacios en PATH)
workdir = $(shell for /f "tokens=*" %%b in ("$(CURDIR)") \
          do @echo %%~sb)

.SUFFIXES: .ly .ily .pdf .mid

VPATH = \
  $(workdir)/Partituras \
  $(workdir)/PDF \
  $(workdir)/Particellas \
  $(workdir)/Notas

%.pdf %.mid: %.ly
        $(LILY_CMD) $<      # esta línea comienza con un salto de tabulación
        if exist "$*.pdf"  move /Y "$*.pdf"  PDF/ # comienzo con tab
        if exist "$*.mid" move /Y "$*.mid" MIDI/  # comienzo con tab

notas = \
  cello.ily \
  cifras.ily \
  trompa.ily \
  oboe.ily \
  trioCuerdas.ily \
  viola.ily \
  violinUno.ily \
  violinDos.ily

$(nombre)I.pdf: $(nombre)I.ly $(notas)
$(nombre)II.pdf: $(nombre)II.ly $(notas)
$(nombre)III.pdf: $(nombre)III.ly $(notas)
$(nombre)IV.pdf: $(nombre)IV.ly $(notas)

$(nombre).pdf: $(nombre).ly $(notas)

$(nombre)-cello.pdf: $(nombre)-cello.ly cello.ily
$(nombre)-trompa.pdf: $(nombre)-trompa.ly trompa.ily
$(nombre)-oboes.pdf: $(nombre)-oboes.ly oboe.ily
$(nombre)-viola.pdf: $(nombre)-viola.ly viola.ily
$(nombre)-violinUno.pdf: $(nombre)-violinUno.ly violinUno.ily
$(nombre)-violinDos.pdf: $(nombre)-violinDos.ly violinDos.ily

.PHONY: partitura
partitura: $(nombre).pdf

.PHONY: particellas
particellas: $(nombre)-cello.pdf \
       $(nombre)-violinUno.pdf \
       $(nombre)-violinDos.pdf \
       $(nombre)-viola.pdf \
       $(nombre)-oboes.pdf \
       $(nombre)-trompa.pdf

.PHONY: movimientos
movimientos: $(nombre)I.pdf \
           $(nombre)II.pdf \
           $(nombre)III.pdf \
           $(nombre)IV.pdf

all: partitura particellas movimientos

El Makefile siguiente es para un documento de lilypond-book hecho en LaTeX. Este proyecto tiene un índice, que requiere ejecutar la instrucción latex dos veces para actualizar los enlaces. Todos los archivos de salida se almacenan en el directorio salida para los documentos .pdf y en el directorio salidahtml para la salida en formato html.

SHELL=/bin/sh
NOMBRE=miproyecto
DIR_SALIDA=salida
DIR_WEB=salidahtml
VISOR=acroread
NAVEGADOR=firefox
LILYBOOK_PDF=lilypond-book --output=$(DIR_SALIDA) --pdf $(NOMBRE).lytex
LILYBOOK_HTML=lilypond-book --output=$(DIR_WEB) $(NOMBRE).lytex
PDF=cd $(DIR_SALIDA) && pdflatex $(NOMBRE)
HTML=cd $(DIR_WEB) && latex2html $(NOMBRE)
INDICE=cd $(DIR_SALIDA) && makeindex $(NOMBRE)
VISTA_PREVIA=$(VISOR) $(DIR_SALIDA)/$(NOMBRE).pdf &

all: pdf web guardar

pdf:
        $(LILYBOOK_PDF)  # comienza con un tab
        $(PDF)           # comienza con un tab
        $(INDICE)        # comienza con un tab
        $(PDF)           # comienza con un tab
        $(VISTA_PREVIA)  # comienza con un tab

web:
        $(LILYBOOK_HTML) # comienza con un tab
        $(HTML)          # comienza con un tab
        cp -R $(DIR_WEB)/$(NOMBRE)/ ./  # comienza con un tab
        $(NAVEGADOR) $(NOMBRE)/$(NOMBRE).html &  # comienza con un tab

guardar: pdf
        cp $(DIR_SALIDA)/$(NOMBRE).pdf $(NOMBRE).pdf  # comienza con un tab

clean:
        rm -rf $(DIR_SALIDA) # comienza con un tab

web-clean:
        rm -rf $(DIR_WEB) # comienza con un tab

archivo:
        tar -cvvf miproyecto.tar \ # comienza con un tab
        --exclude=salida/* \
        --exclude=salidahtml/* \
        --exclude=miproyecto/* \
        --exclude=*midi \
        --exclude=*pdf \
        --exclude=*~ \
        ../MiProyecto/*

HACER: conseguir que funcione en Windows

El makefile anterior no funciona en Windows. Una alternativa para los usuarios de Windows sería crear un archivo de lotes sencillo que contenga las instrucciones de montaje. Esto no rastrea las dependencias en la manera en que lo hace un makefile, pero al menos reduce el proceso de construcción a una sola instrucción. Guarde el código siguiente como montaje.bat o montaje.cmd. El archivo de lotes se puede ejecutar en la línea de órdenes del DOS o simplemente haciendo doble click sobre su icono.

lilypond-book --output=salida --pdf miproyecto.lytex
cd salida
pdflatex miproyecto
makeindex miproyecto
pdflatex miproyecto
cd ..
copy salida\miproyecto.pdf MiProyecto.pdf

Véase también

Manual de utilización del programa: Utilización desde la línea de órdenes, Ejecución de lilypond-book