Opciones avanzadas de línea de órdenes para LilyPond
La opción ‘-d’ es la interfaz de la línea de órdenes a la
función de Scheme de LilyPond ly:set-option. Esto
significa que todas las opciones que se relacionan aquí pueden
establecerse también dentro de los propios archivos ‘.ly’.
-
-d,--define-default=opción[=valor] -
-d,--define-default=no-opción Fijar el símbolo interno de Scheme equivalente opción a valor. Por ejemplo, la opción de línea de órdenes
-dbackend=svg
equivale a
#(ly:set-option 'backend 'svg)
dentro de un archivo de entrada de LilyPond.
Si no se proporciona el valor, usar
#tcomo valor (lo que puede producir resultados extraños cuando el tipo esperado para el valor no es booleano). Se puede añadir el prefijono-a la opción para ‘desactivar’ una opción, aportando#fcomo valor. Por ejemplo,-dpoint-and-click='#f'
es lo mismo que
-dno-point-and-click
[Observe que el carácter ‘#’ introduce un comentario en muchos shells. Por este motivo se recomienda siempre entrecomillar las expresiones que lo contengan.]
La siguiente tabla relaciona todos los nombres de opción junto con
sus valores. Dentro del código de Scheme, los valores de opción se
pueden leer usando la función ly:get-option.
-
anti-alias-factornúmero Generar el gráfico a mayor resolución (usando el factor número) y reducir la escala para evitar el pixelado en las imágenes PNG. Predeterminado:
1.0.-
aux-filesbool Si bool es
#t, crear archivos ‘.tex’, ‘.texi’ y ‘.count’ cuando se usa con la opción de backendeps. Predeterminado:#t.-
backendsímbolo Usar símbolo como backend para la salida de LilyPond. Los valores posiboles son:
-
ps Es el ajuste predeterminado. Los archivos de PostScript incluyen las fuentes TTF, Type1 y OTF. No se genera ningún ‘subconjunto’ de dichas fuentes tipográficas. Advierta que el uso de conjuntos de caracteres ‘orientales’ como el japonés puede dar lugar a archivos de tamaño muy grande.
Para la salida PDF se utiliza también el backend
ps; los datos PS resultantes se post-procesan mediante el guiónps2pdfde Ghostscript, que también efectúa subconjuntos de fuentes de manera predeterminada.-
svg Gráficos vectoriales escalables. Por cada página de la salida, se crea un solo archivo
SVG. Los glifos musicales se codifican como gráficos vectoriales, pero las fuentes tipográficas del texto no se incrustan en los archivos SVG. Cualquier visor de SVG necesita que las fuentes de texto correspondientes estén disponibles para la correcta representación tanto del texto como de la letra. Se recomienda no utilizar ‘alias’ ni ‘listas’ de fuentes tipográficas por si el visor de SVG no es capaz de manejarlas. Al usar archivos de fuente abierta para la web Web Open Font Format (WOFF), es necesario indicar la opción-dsvg-woff
-
-
clip-systemsbool Si bool es
#t, extraer fragmentos de música de la partitura. Requiere que la funciónclip-regionsesté definida dentro del bloque\layout. Véase Extracción de fragmentos de música. No se extrae ningún fragmento si se usa con la opción ‘-dno-print-pages’. Predetermiadno:#f.-
cropbool Si bool es
#t, incorporar toda la música con sus títulos y encabezamientos, sin márgenes, en un archivo de salida de ‘una sola página’. Predeterminado:#f.-
datadir Prefijo de los archivos de datos. Esta opción es de solo lectura; su establecimiento no tiene ningún efecto.
-
debug-skylinesbool Si bool es
#t, efectuar una depuración de las líneas de horizonte. Predeterminado:#f.-
delete-intermediate-filesbool Si bool es
#t, eliminar los archivos intermedios.psinútiles que se crean durante la compilación. Predeterminado:#t.-
embed-source-codebool Si bool es
#t, empotrar los archivos de entrada en código de LilyPond dentro del documento PDF generado. Predeterminado:#f.-
eps-box-paddingnúmero Rellenar el borde izquierdo de la caja contenedora (bounding box) del EPS de salida en número milímetros. Predeterminado:
#f(que significa que no se rellena la caja contenedora).-
font-export-dircadena Fijar el directorio para la exportación de fuentes tipográficas como archivos de PostScript a cadena. Esto es de utilidad cuando queremos crear primero un PDF sin las fuentes incrustadas, e incrustar más tarde las fuentes con Ghostscript como se ve más abajo.
$ lilypond -dfont-export-dir=fontdir -dgs-never-embed-fonts foo.ly $ gs -q -dBATCH -dNOPAUSE -sDEVICE=pdfwrite \ -sOutputFile=foo.embedded.pdf foo.pdf fontdir/*.font.psNota: a diferencia de
font-ps-resdir, este método no puede empotrar las fuentes CID con Ghostscript 9.26 y posteriores.Nota: de la misma manera que
font-ps-resdir, esta opción se salta las fuentes TrueType porque el empotrado de fuentes TrueType produce un desbaratamiento de los caracteres. Para evitar este dessbaratabiento, usegs-never-embed-fonts, pues a pesar de su nombre esta opción empotra las fuentes TrueType.Predeterminado:
#f(que significa no exportar).-
font-ps-resdircadena Fijar el directorio (como cadena) para construir un subconjunto del directorio de recursos PostScript y usarlo para empotrar las fuentes más tarde. Esto es útil si queremos crear primero un PDF sin las fuentes empotradas y empotrar las fuentes más tarde con Ghostscript como se ve más abajo.
$ lilypond -dfont-ps-resdir=resdir -dgs-never-embed-fonts foo.ly $ gs -q -dBATCH -dNOPAUSE -sDEVICE=pdfwrite \ -I resdir -I resdir/Font \ -sOutputFile=foo.embedded.pdf foo.pdfNota: es mejor no especificar el directorio que contiene el nombre ‘Resource’ porque este tiene un significado especial al especificarlo con la opción
-Ipara Ghostscript.Nota: a diferencia de
font-export-dir, este método puede empotrar fuentes CID con Ghostscript 9.26 y posteriores.Nota: de igual manera que
font-export-dir, esta opción se salta las fuentes TrueType porque el empotrado tardío de fuentes TrueType causa un desbaratamiento de los caracteres. Para evitar el desbaratamiento, usegs-never-embed-fonts, ya que este empotra las fuentes TrueType a pesar de su nombre.Predeterminado:
#f(que significa no construir).-
gs-load-fontsbool Si bool es
#t, cargar fuentes a través de Ghostscript. Esta opción hace que los archivos de salida de LilyPond solo contenga referencias a todas las fuentes, lo que debe después resolverse a las fuentes reales en un paso de post-procesado por medio de Ghostscript. Predeterminado:#f.-
gs-load-lily-fontsbool Si bool es
#t, cargar las fuentes de LilyPond por medio de Ghostscript. Esta opción hace que los archivos de salida de LilyPond contengan solamente referencias a sus fuentes de música, lo que debe después resolverse a las fuentes reales en un paso de post-procesado por medio de Ghostscript. Todas las demás fuentes se dirigen a la salida como es habitual. Predeterminado:#f.-
gs-never-embed-fontsbool Si bool es
#t, hacer que Ghostscript incruste solamente tipos de letra TrueType y ningún otro formato de fuente. Predeterminado:#f.-
helpbool Si bool es
#t, mostrar esta ayuda. Predeterminado:#f.-
include-book-title-previewbool Si bool es
#t, incluir los títulos de libro en las imágenes de vista previa. Predeterminado:#t.-
include-eps-fontsbool Si bool es
#t, incluir las fuentes tipográficas en los archivos EPS de cada uno de los sistemas. Predeterminado:#t.-
include-settingscadena Incluir el archivo cadena de ajustes globales, que se incluye antes de que la partitura se procese Predeterminado:
#f(que significa que no se incluye ningún archivo de ajustes globales).-
job-countnúmero Procesar en paralelo, utilizando número tareas. Predeterminado:
#f(que significa que no se hace ningún procesado paralelo).-
log-filecadena Redirigir la salida hacia el archivo de registro ‘cadena.log’. Predeterminado:
#f(que significa ningún archivo de registro).-
max-markup-depthnúmero Fijar la profundidad máxima del árbol de marcado al valor número. Si un elemento de marcado tiene más niveles, suponer que no va a finalizar por sí mismo, imprimir un mensaje de advertencia y devolver un elemento de marcado nulo en su lugar. Predeterminado:
1024.-
midi-extensioncadena Fijar la extensión de archivo predeterminada para los archivos MIDI de salida a ‘.cadena’. Predeterminado:
"midi".-
music-strings-to-pathsbool Si bool es
#t, converir las cadenas de texto a trayectos cuando los glifos pertenecen a una fuente musical. Predeterminado:#f.-
paper-sizeextra-quoted-string Establecer el tamaño predeterminado de papel a extra-quoted-string. Observe que la cadena se debe encerrar dentro de comillas con prefijo de escape. Predeterminado:
"\"a4\"".-
pixmap-formatsymbol Establecer el formato de salida de Ghostscript para las imágenes de matriz de puntos a symbol. Predeterminado:
png16m.-
point-and-clickbool Si bool es
#t, añadir enlaces de ‘apuntar y pulsar’ links a las salidas de PDF y SVG. Véase Apuntar y pulsar. Predeterminado:#t.-
previewbool Si bool es
#t, crear imágenes de vista previa además de la salida normal. Predeterminado:#f.Esta opción está contemplada por todos los ‘back-ends’ (
pdf,png,ps,epsysvg), exceptoscm. Para un nombre de archivo de entrada archivo y un backend formato, genera un archivo de salida, con el nombre ‘archivo.preview.formato’, que contiene los títulos y el primer sistema de la música. Si se están utilizando bloques\booko\bookpart, aparecen en la salida los títulos de\book,\bookparto\score, incluido el primer sistema de cada bloque\scoresi la variable de\paperprint-all-headersestá fijada al valor#t.Para suprimir la salida usual, utilice las opciones ‘-dprint-pages’ o ‘-dno-print-pages’ según sus necesidades.
-
print-pagesbool Si bool es
#t, generar páginas completas. Predeterminado:#t.La opción ‘-dno-print-pages’ es útil en combinación con las opciones ‘-dpreview’ o ‘-dcrop’.
-
protected-scheme-parsingbool Si bool es
#t, continuar cuando se interceptan errores en el código empotrado de Scheme dentro del analizador sintáctico. Si se establece al valor#f, detenerse cuando se produzca algún error e imprimir una traza de la pila. Predeterminado:#t.-
relative-includesbool Cuando se procesa una instrucción
\include, buscar el archivo de inclusión en una ruta relativa al archivo actual si bool es#t. Si se establece a#f, buscar el archivo según una ruta relativa al archivo raíz. Predeterminado:#t.-
resolutionnúmero Fijar la resolución para generar imágenes de matriz de puntos
PNGa número ppp. Predeterminado:101.-
safe#f No confiar en la entrada
.ly.Cuando el servicio de tipografía está disponible a través de un servidor web, SE DEBEN pasar las opciones
-dsafeo ‘--jail’. La opción-dsafeevita que el código de Scheme empotrado pueda producir un desastre, p.ej.:% demasiado peligroso para escribirlo correctamente #(s ystem "rm -rf /") % malicioso pero no destructivo { c4^$(ly:gulp-file "/etc/passwd") }La opción ‘-dsafe’ funciona evaluando las expresiones de Scheme en línea dentro de un módulo seguro especial. Deriva del módulo ‘safe-r5rs’ de GUILE, pero además añade unas cuantas funciones de la API de LilyPond que están relacionadas en ‘scm/safe-lily.scm’.
Además, el modo seguro prohíbe las directivas
\includey desactiva la utilización de barras invertidas en las cadenas de TeX. Asimismo, no es posible importar variables de LilyPond dentro de Scheme cuando se está en modo seguro.La opción ‘-dsafe’ no detecta la sobreutilización de recursos, por lo que aún es posible hacer que el programa se cuelgue indefinidamente, por ejemplo suministrando estructuras de datos cíclicas en el backend. Por ello, si está usando LilyPond en un servidor web accesible públicamente, el proceso se debe limitar tanto en el uso de memoria como de CPU.
El modo seguro evita que se puedan compilar muchos fragmentos de código útiles.
La opción ‘--jail’ es una alternativa más segura aún, pero requiere más trabajo para su configuración. Véase Opciones básicas de la línea de órdenes para LilyPond.
-
separate-log-filesbool Para los archivos de entrada ‘archivo1.ly’, ‘archivo2.ly’, …, dar salida a datos de registro hacia los archivos ‘archivo1.log’, ‘archivo2.log’, …, si bool es
#t. Predeterminado:#f.-
show-available-fontsbool Si bool es
#t, imprimir un listado de los nombres de fuente tipográfica disponibles tal y como los proporciona la biblioteca fontconfig. Al final de esta lista, LilyPond presenta los ajustes de configuración del propio fontconfig. Predeterminado:#f.-
strip-output-dirbool Si bool es
#t, no utilizar la parte del directorio tomada de las rutas de los archivos cuando se construyen nombres de archivos de salida. Predeterminado:#t.-
strokeadjustbool Si bool es
#t, forzar el ajuste de los trazos de PostScript. Esta opción es relevante principalmente cuando se genera un PDF a partir de la salida de PostScript (el ajuste del trazo está por lo general activado automáticamente para dispositivos de mapa de puntos de baja resolución). Sin esta opción, los visores de PDF tienden a producir anchuras de plica muy poco consistentes con las resoluciones típicas de las pantallas de ordenador. Sin embargo, la opción no afecta de forma muy significativa a la calidad de la impresión y causa grandes incrementos en el tamaño del archivo PDF. Predeterminado:#f.-
svg-woffbool Esta opción es necesaria al usar archivos de fuente abierta para la Web, Web Open Font Format (WOFF) con el backend
svg. Si bool es#t, se crea un solo archivo SVG para cada página de salida. Aparte de los glifos musicales propios de LilyPond, no se incluye ninguna otra información de fuente tipográfica. Todo visor de SVG necesita, por ello, tener las fuentes disponibles para la representación correcta tanto del texto como de la letra. Asimismo se recomienda no usar alias de fuentes ni listas, por si el visor de SVG no es capaz de manejarlos. Predeterminado:#f.-
verbose Nivel de verbosidad. Esta es una opción de solo lectura; su establecimiento no tiene ningún efecto.
-
warning-as-errorbool Si bool es
#t, cambiar todos los mensajes de advertencia y de ‘error de programación’ a errores. Predeterminado:#f.