1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
4 Translation of GIT committish: 45d0e015edc53abebada17a0fdb1d665f7edf900
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. For details, see the Contributors'
8 Guide, node Updating translation committishes..
14 @node Ejecutar LilyPond
15 @chapter Ejecutar LilyPond
16 @translationof Running LilyPond
18 Este capítulo detalla los aspectos técnicos de la ejecución de
22 * Utilización normal::
23 * Utilización desde la línea de órdenes::
29 @node Utilización normal
30 @section Utilización normal
31 @translationof Normal usage
33 Casi todos los usuarios ejecutan LilyPond por medio de un interfaz
34 gráfico; consulte @rlearning{Primeros pasos} si no lo ha leído aún.
37 @node Utilización desde la línea de órdenes
38 @section Utilización desde la línea de órdenes
39 @translationof Command-line usage
41 Esta sección contiene información adicional sobre el uso de LilyPond
42 en la línea de órdenes. Esta forma puede ser preferible para pasarle
43 al programa algunas opciones adicionales. Además, existen algunos
44 programas complementarios @q{de apoyo} (como @code{midi2ly}) que sólo
45 están disponibles en la línea de órdenes.
47 Al hablar de la @q{línea de órdenes}, nos referimos a la consola del
48 sistema operativo. Los usuarios de Windows posiblemente estén más
49 familiarizados con los términos @q{ventana de MS-DOS} o @q{línea de
50 comandos}; Los usuarios de MacOS@tie{}X puede que estén más
51 familiarizados con los términos @q{terminal} o @q{consola}. Éstos
52 podrían requerir algunas configuraciones adicionales y deberían
53 consultar también el apartado @rweb{MacOS X}.
55 La descripción del uso de esta parte de los sistemas operativos se
56 sale del ámbito de este manual; le rogamos que consulte otros
57 documentos sobre este tema si no le resulta familiar la línea de
61 * Invocar a LilyPond::
62 * Opciones básicas de la línea de órdenes para LilyPond::
63 * Opciones avanzadas de línea de órdenes para LilyPond::
64 * Variables de entorno::
65 * LilyPond en una jaula de chroot::
68 @node Invocar a LilyPond
69 @unnumberedsubsec Invocar @command{lilypond}
70 @translationof Invoking lilypond
72 El ejecutable @command{lilypond} se puede llamar desde la línea de
73 órdenes de la siguiente manera:
76 lilypond [@var{opción}]@dots{} @var{archivo}@dots{}
79 Cuando se invoca con un nombre de archivo sin extensión, se prueba en
80 primer lugar con la extensión @file{.ly}. Para leer la entrada desde
81 stdin, utilice un guión (@code{-}) en sustitución de @var{archivo}.
83 Cuando se procesa @file{archivo.ly}, la salida resultante son los
84 archivos @file{archivo.ps} y @file{archivo.pdf}. Se pueden
85 especificar varios archivos; cada uno de ellos se procesará de forma
86 independiente@footnote{El estado de GUILE no se restablece después de
87 procesar un archivo @code{.ly}, por lo que debe tener cuidado de no
88 modificar ningún valor predeterminado desde dentro de Scheme.}.
90 Si @file{archivo.ly} contiene más de un bloque @code{\score}, el resto
91 de las partituras se obtendrán como salida en archivos numerados,
92 empezando por @file{archivo-1.pdf}. además, el valor de
93 @code{output-suffix} (sufijo de salida) se insertará entre el nombre
94 base y el número. Un archivo de entrada que contenga
97 #(define output-suffix "violin")
99 #(define output-suffix "cello")
104 producirá como salida @var{base}@file{-violin.pdf} y
105 @var{base}@file{-cello-1.pdf}.
108 @unnumberedsubsubsec Instrucciones estándar de la línea de órdenes
110 Si su terminal (o ventana de órdenes) contempla las redirecciones
111 normales, quizá le sean de utilidad las siguientes instrucciones para
112 redirigir la salida de la consola a un archivo:
117 @code{lilypond archivo.ly 1>salidaestandar.log} para redirigir la salida normal
120 @code{lilypond archivo.ly 2>salidadeerror.log} para redirigir los mensajes de error
123 @code{lilypond archivo.ly &>todo.log} para redirigir toda la salida
127 Consulte la documentación de su shell para ver si contempla estas
128 opciones, o si la sintaxis es distinta. Observe que son instrucciones
129 del shell y que no tienen nada que ver con lilypond.
132 @node Opciones básicas de la línea de órdenes para LilyPond
133 @unnumberedsubsec Opciones básicas de la línea de órdenes para LilyPond
134 @translationof Basic command line options for LilyPond
136 @cindex invocación de @command{lilypond}
137 @cindex opciones de la línea de órdenes para @command{lilypond}
138 @cindex línea de órdenes, opciones de
139 @cindex modificadores
141 Están contempladas las siguientes opciones:
145 @item -d, --define-default=@var{variable}=@var{valor}
146 Véase @ref{Opciones avanzadas de línea de órdenes para LilyPond}.
148 @cindex Scheme, evaluación de expresiones
149 @cindex expresiones de Scheme, evaluación
151 @item -e, --evaluate=@var{expresión}
152 Evaluar la @var{expresión} de Scheme antes de analizar los archivos
153 @file{.ly}. Se pueden pasar varias opciones @option{-e}, que se
154 evaluarán en secuencia.
156 La expresión se evaluará en el módulo @code{guile-user}, de manera que
157 si quiere usar definiciones dentro de @var{expresión}, debe utilizar
160 lilypond -e '(define-public a 42)'
164 en la línea de órdenes, e incluir
167 #(use-modules (guile-user))
171 al principio del archivo @file{.ly}.
173 @warning{Los usuarios de Windows deben utilizar comillas dobles en lugar de apóstrofos simples.}
175 @cindex output, format
176 @cindex format, output
178 @item -f, --format=@var{format}
179 which formats should be written. Choices for @code{format} are
180 @code{ps}, @code{pdf}, and @code{png}.
182 Example: @code{lilypond -fpng @var{filename}.ly}
185 Mostrar un resumen de las formas de utilización.
187 @item -H, --header=@var{CAMPO}
188 Volcar un campo de cabecera al archivo @file{NOMBREBASE.@var{CAMPO}}
190 @item -i, --init=@var{archivo}
191 Establecer el archivo de inicio a @var{archivo} (predeterminado:
194 @cindex archivos, búsqueda de
195 @cindex búsqueda, ruta de
197 @item -I, --include=@var{directorio}
198 Añadir el @var{directorio} a la ruta de búsqueda de archivos de
201 Se pueden escribir varias opciones -I. La búsqueda se inicia en el
202 primer directorio definido, y si el archivo que se debe incluir no se
203 encuentra, la búsqueda continúa en los directorios siguientes.
205 @cindex chroot, ejecutar dentro de una jaula
207 @item -j, --jail=@var{usuario},@var{grupo},@var{jaula},@var{directorio}
208 Ejecutar @command{lilypond} en una jaula de chroot.
210 La opción @option{--jail} (jaula) proporciona una alternativa más
211 flexible a la opción @option{-dsafe} cuando el proceso de tipografía de
212 LilyPond está disponible a través de un servidor web o cuando LilyPond
213 ejecuta instrucciones enviadas por fuentes externas
214 (véase @ref{Opciones avanzadas de línea de órdenes para LilyPond}).
216 La opción @option{--jail} funciona cambiando la raíz de
217 @command{lilypond} a @var{jaula} justo antes de comenzar el proceso de
218 compilación en sí. Entonces se cambian el usuario y el grupo a los
219 que se han dado en la opción, y el directorio actual se cambia a
220 @var{directorio}. Esta instalación garantiza que no es posible, al
221 menos en teoría, escapar de la jaula. Observe que para que funcione
222 @option{--jail}, se debe ejecutar @command{lilypond} como root, lo que
223 normalmente se puede hacer de una forma segura utilizando
226 La instalación de una jaula puede ser un asunto relativamente
227 complejo, pues debemos asegurarnos de que LilyPond puede encontrar
228 @emph{dentro} de la propia jaula todo lo que necesita para poder
229 compilar la fuente. Una típica configuración de jaula de chroot
230 consta de los siguientes elementos:
234 @item Preparar un sistema de archivos separado
235 Se debe crear un sistema de archivos separado para LilyPond, de forma
236 que se pueda montar con opciones seguras como @code{noexec},
237 @code{nodev} y @code{nosuid}. De esta forma, es imposible ejecutar
238 programas o escribir directamente a un dispositivo desde LilyPond. Si
239 no quiere crear una partición separada, tan sólo tiene que crear un
240 archivo de un tamaño razonable y usarlo para montar un dispositivo
241 loop. El sistema de archivos separado garantiza también que LilyPond
242 nunca pueda escribir en un espacio mayor del que se le permita.
244 @item Preparar un usuario separado
245 Se debe usar un usuario y grupo separados (digamos
246 @code{lily}/@code{lily}) con bajos privilegios para ejecutar LilyPond
247 dentro de la jaula. Debería existir un solo directorio con permisos
248 de escritura para este usuario, y debe pasarse en el valor
251 @item Preparar la jaula
252 LilyPond necesita leer algunos archivos mientras se ejecuta. Todos
253 estos archivos se deben copiar dentro de la jaula, bajo la misma ruta
254 en que aparecen en el sistema de archivos real de root. Todo el
255 contenido de la instalación de LilyPond (por ejemplo
256 @file{/usr/share/lilypond}) se debe copiar.
258 Si surgen problemas, la forma más sencilla de rastrearlos es ejecutar
259 LilyPond usando @command{strace}, lo que le permitirá determinar qué
262 @item Ejecutar LilyPond
263 Dentro de una jaula montada con @code{noexec} es imposible ejecutar
264 ningún programa externo. Por tanto, LilyPond se debe ejecutar con un
265 backend que no necesite tal programa. Como ya hemos mencionado, se
266 debe ejecutar con privilegios del superusuario (que por supuesto
267 perderá inmediatamente), posiblemente usando @command{sudo}. También
268 es una práctica recomendable limitar el número de segundos de tiempo
269 de CPU que LilyPond puede usar (p.ej., usando
270 @command{ulimit@tie{}-t}), y, si su sistema operativo lo contempla, el
271 tamaño de la memoria que se puede reservar. Véase también
272 @ref{LilyPond en una jaula de chroot}.
277 @cindex registro, nivel de
278 @cindex salida prolija, fijar el nivel
280 @item -l, --loglevel=@var{LEVEL}
281 Fijar el grado en que la salida de consola es prolija al nivel
282 @var{LEVEL}. Los valores posibles son:
287 Ninguna salida en absoluto, ni siquiera mensajes de error.
290 Solamente mensajes de error, no advertencias o indicaciones de progreso.
293 Advertencias y mensajes de error, no de progreso.
296 Mensajes de progreso básicos (éxito), advertencias y errores.
299 Todos los mensajes de progreso, advertencias y errores.
301 @item INFO (predeterminado)
302 Mensajes de progreso, advertencias, errores e información de ejecución
306 Todos los mensajes posibles, incuida la información de depuración
310 @cindex carpeta, dirigir la salida hacia
311 @cindex salida, establecer el nombre del archivo de
313 @item -o, --output=@var{ARCHIVO} o @var{CARPETA}
314 Establecer el nombre del archivo de salida predeterminado a
315 @var{ARCHIVO} o, si existe una carpeta con ese nombre, dirigir la
316 salida hacia @var{CARPETA}, tomando el nombre de archivo del documento
317 de entrada. Se añade el sufijo correspondiente (por ejemplo,
318 @code{.pdf} para PDF) en los dos casos.
320 @cindex PS (Postscript), salida
321 @cindex Postscript (PS), salida
322 @cindex salida, PS (Postscript)
327 @cindex PNG (Portable Network Graphics), salida
328 @cindex salida, PNG (Portable Network Graphics)
331 Generar imágenes de las páginas en formato PNG. Esto implica
332 @option{--ps}. La resolución en PPP de la imagen se puede establecer
338 @cindex PDF (formato de documento portátil), salida de
339 @cindex salida, PDF (formato de documento portátil)
342 Generar PDF. Implica @option{--ps}.
345 Mostrar la información de la versión.
348 Ser prolijo: mostrar las rutas completas de todos los archivos que se
349 leen, y dar información cronométrica.
352 Mostrar la garantía con que viene GNU LilyPond (¡no viene con
353 @strong{NINGUNA GARANTÍA}!).
358 @node Opciones avanzadas de línea de órdenes para LilyPond
359 @unnumberedsubsec Opciones avanzadas de línea de órdenes para LilyPond
360 @translationof Advanced command line options for LilyPond
364 @item -d@var{[option-name]}=@var{[value]},--define-default=@var{[option-name]}=@var{[value]}
365 Establece la función de Scheme interna equivalente a @var{valor}.
371 Si no se proporciona ningún @var{valor}, se usa el valor predeterminado.
372 Para desactivar una opción se puede anteponer @code{no-} a la
373 @var{variable}, p.ej.:
375 @cindex point and click, command line
388 @noindent Están contempladas las siguientes opciones junto a sus respectivos
389 valores predeterminados:
391 @multitable @columnfractions .33 .16 .51
392 @item @strong{Símbolo}
394 @tab @strong{Explicación/Opciones}
396 @item @code{anti-alias-factor} (factor de antialias)
398 @tab Renderizar a mayor resolución (utilizando el factor dado) y reducir la
399 escala del resultado para así evitar @q{escaleras} en las imágenes
402 @item @code{aux-files} (archivos auxiliares)
404 @tab Crear archivos @code{.tex}, @code{.texi}, @code{.count} en el
405 @q{back-end} @code{EPS}.
409 @tab Seleccionar un @q{back-end}. Los archivos (la opción predeterminada)
410 incluyen las fuentes tipográficas @code{TTF}, @code{Type1} y
411 @code{OTF}. No se hace ningún subconjunto de estas fuentes. El uso
412 de conjuntos de caracteres @q{orientales} puede dar lugar a archivos
417 @tab PostScript encapsulado. Vuelca cada página o sistema como un archivo
418 @file{EPS} distinto, sin fuentes tipográficas, y como un archivo
419 @file{EPS} encuadernado con todas las páginas o sistemas que incluye
420 las fuentes. Utilizado como opción predeterminada por parte de
421 @command{lilypond-book}.
425 @tab No producir ninguna partitura impresa a la salida; tiene el mismo
426 efecto que @code{-dno-print-pages}.
430 @tab Grácifos vectoriales escalables. Crea un solo archivo @code{SVG}, sin
431 fuentes tipográficas incrustadas, por cada página de salida. Se
432 recomienda instalar las fuentes Century Schoolbook, incluidas con la
433 instalación de LilyPond, para un renderizado óptimo. Bajo UNIX,
434 bastará con que copie estaos archivos de fuente del directorio de
435 LilyPond (normalmente @file{/usr/share/lilypond/VERSION/fonts/otf/})
436 al directorio @file{~/.fonts/}. La salida @code{SVG} debería ser
437 compatible con cualquier editor o cliente de SVG. También hay una
438 opción @code{svg-woff} (véase más abajo) para usar los archivos de
439 fuente woff en el @q{back-end} SVG.
443 @tab Volcado de las instrucciones de dibujo internas basadas en Scheme, en
446 @item @code{check-internal-types}
448 @tab Comprobar el tipo de cada asignación de propiedades.
450 @item @code{clip-systems} (recortar los sistemas)
452 @tab Generar fragmentos de imagen recortados de una partitura.
454 @item @code{datadir} (directorio de datos)
456 @tab Prefijo de los archivos de datos (sólo lectura).
458 @item @code{debug-gc}
460 @tab Volcar estadísticas de depuración de memoria.
462 @item @code{debug-gc-assert-parsed-dead}
464 @tab Para la depuración de memoria: asegurarse de que todas las referencias
465 a objetos analizados están muertas. Es una opción interna, y se
466 activa automáticamente para @code{`-ddebug-gc'}.
468 @item @code{debug-lexer}
470 @tab Depuración del analizador léxico flex.
472 @item @code{debug-page-breaking-scoring}
474 @tab Volcar las partituras para muchas configuraciones de saltos de página
477 @item @code{debug-parser}
479 @tab Depuración del analizador sintáctico bison.
481 @item @code{debug-property-callbacks}
483 @tab Depuración de las cadenas cíclicas de funciones de callback.
485 @item @code{debug-skylines}
487 @tab Depuración de las líneas de horizonte.
489 @item @code{delete-intermediate-files}
491 @tab Eliminar los archivos intermedios @code{.ps} inútiles ques e crean
492 durante la compilación.
494 @item @code{dump-cpu-profile}
496 @tab Volcar información de cuenta de tiempo (dependiente del sistema).
498 @item @code{dump-profile}
500 @tab Volcar de la información de memoria y de tiempo para cada archivo.
502 @item @code{dump-signatures}
504 @tab Volcar las firmas de salida de cada sistema. Usado para las pruebas
507 @item @code{eps-box-padding}
509 @tab Rellenar el borde izquierdo de la caja contenedora del EPS de salida
510 en la cantidad dada (en mm).
512 @item @code{gs-load-fonts}
514 @tab Cargar las fuentes tipográficas a través de Ghostscript.
516 @item @code{gs-load-lily-fonts}
518 @tab Cargar sólo las fuentes de LilyPond por medio de Ghostscript.
522 @tab Se ejecuta silenciosamente y se redirige toda la salida a un archivo
527 @strong{Nota para los usuarios de Windows:} De manera predeterminada,
528 @code{lilypond.exe} dirige toda la salida de la información de avance
529 hacia la ventana de consola, @code{lilypond-windows.exe} no lo hace y
530 devuelve un indicador del sistema, sin ninguna indicación del avance,
531 inmediatamente en la línea de órdenes. La opción @option{-dgui} se
532 puede usar en este caso para redirigir la salida a un archivo de
535 @multitable @columnfractions .33 .16 .51
538 @tab Mostrar esta ayuda.
540 @item @code{include-book-title-preview}
542 @tab Incluir los títulos de libro en las imágenes de vista previa.
544 @item @code{include-eps-fonts}
546 @tab Incluir las fuentes tipográficas en los archivos EPS de cada uno de
549 @item @code{include-settings}
551 @tab Incluir el archivo de los ajustes globales, se incluye antes de que la
552 partitura se procese.
554 @item @code{job-count}
556 @tab Procesar en paralelo, usando el número de tareas dado.
558 @item @code{log-file}
559 @tab @code{#f [file]}
560 @tab Si se da una cadena @code{NOMBRE} como segundo argumento,
561 redirigir la salida al archivo de registro @code{NOMBRE.log}.
563 @item @code{max-markup-depth}
565 @tab Profundidad máxima del árbol de marcado. Si un marcado tiene más niveles,
566 suponer que no terminará por sí mismo, imprimiento una advertencia y
567 devolviendo en su lugar un elemento de marcado nulo.
569 @item @code{midi-extension}
571 @tab Fijar la extensión de archivo predeterminada para el archivo de salida
572 MIDI a la cadena dada.
574 @item @code{music-strings-to-paths}
576 @tab Convertir las cadenas de texto a rutas cuando los glifos pertenecen a
577 una fuente de tipografía musical.
579 @item @code{paper-size}
581 @tab Establecer el tamaño predeterminado del papel. Observe que la cadena
582 debe ir encerrada entre comillas dobles.
584 @item @code{pixmap-format}
586 @tab Fijar el formato de salida de Ghostscript para las imágenes de píxeles.
588 @item @code{point-and-click}
590 @tab Añadir enlaces de @q{apuntar y pulsar} a la salida @code{PDF}. Véase
591 @ref{Apuntar y pulsar}.
595 @tab Crear imágenes de vista previa además de la salida normal.
599 Esta opción está contemplada por todos los @q{back-ends}: @code{pdf},
600 @code{png}, @code{ps}, @code{eps} y @code{svg}, pero no por
601 @code{scm}. Genera un archivo de salida, en la forma
602 @code{miArchivo.preview.extensión}, que contiene los títulos y el
603 primer sistema de la música. Si se están utilizando bloques
604 @code{\book} o @code{\bookpart}, aparecen en la salida los títulos de
605 @code{\book}, @code{\bookpart} o @code{\score}, incluido el primer
606 sistema de cada bloque @code{\score} si la variable de @code{\paper}
607 @code{print-all-headers} está fijada al valor @code{#t}.
609 Para suprimir la salida usual, utilice las opciones
610 @option{-dprint-pages} o @option{-dno-print-pages} según sus
613 @multitable @columnfractions .33 .16 .51
614 @item @code{print-pages}
616 @tab Generar páginas completas (es la opción predeterminada). Es útil
617 @option{-dno-print-pages} en combinación con @option{-dpreview}.
619 @item @code{profile-property-accesses}
621 @tab Conservar las estadísticas de las llamadas de función
622 @code{get_property()}.
624 @item @code{protected-scheme-parsing}
626 @tab Continuar cuando se captan en el analizador sintáctico errores del
627 Scheme empotrado. Si se fija a @code{#f}, detenerse cuando haya
628 errores e imprimir un registro de traza de pila.
630 @item @code{read-file-list}
631 @tab @code{#f [archivo]}
632 @tab Especificar el nobmre de un archivo que contiene una lista de archivos
633 de entrada para procesar.
635 @item @code{relative-includes}
637 @tab Cuando se procesa una instrucción @code{\include} command, buscar el
638 archivo incluido de forma relativa al archivo actual (en lugar del
641 @item @code{resolution}
643 @tab Fijar la resolución para generar imágenes de píxeles @code{PNG} al
648 @tab No confiar en la entrada @code{.ly}.
652 Cuando el servicio de tipografía está disponible a través de un
653 servidor web, @b{SE DEBEN} pasar las opciones @option{--safe} o
654 @option{--jail}. La opción @option{--safe} evita que el código de
655 Scheme monte un desastre, p.ej.:
661 c4^$(ly:gulp-file "/etc/passwd")
666 La opción @option{-dsafe} funciona evaluando las expresiones de Scheme
667 en línea dentro de un módulo seguro especial. Deriva del módulo
668 @file{safe-r5rs} de GUILE, pero además añade unas cuantas funciones de
669 la API de LIlyPond que están relacionadas en @file{scm/safe-lily.scm}.
671 Además, el modo seguro prohíbe las directivas @code{\include} y
672 desactiva la utilización de barras invertidas en las cadenas de
673 @TeX{}. Asimismo, no es posible importar variables de LilyPond dentro
674 de Scheme cuando se está en modo seguro.
676 @option{-dsafe} @emph{no} detecta la sobreutilización de recursos, por
677 lo que aún es posible hacer que el programa se cuelgue
678 indefinidamente, por ejemplo suministrando estructuras de datos
679 cíclicas en el backend. Por ello, si está usando LilyPond en un
680 servidor web accesible públicamente, el proceso se debe limitar tanto
681 en el uso de memoria como de CPU.
683 El modo seguro evita que se puedan compilar muchos fragmentos de
686 La opción @option{--jail} es una aliternativa más segura aún, pero
687 requiere más trabajo para su configuración. Véase
688 @ref{Opciones básicas de la línea de órdenes para LilyPond}.
690 @multitable @columnfractions .33 .16 .51
691 @item @code{separate-log-files}
693 @tab Para los archivos de entrada @code{ARCHIVO1.ly}, @code{ARCHIVO2.ly},
694 etc. sacar los datos de registro hacia los archivos @code{ARCHIVO1.log},
695 @code{ARCHIVO2.log}@dots{}
697 @item @code{show-available-fonts}
699 @tab Listar todos los nombres de las fuentes tipográficas disponibles.
701 @item @code{strict-infinity-checking}
703 @tab Forzar una terminación abrupta si se encuentran las excepciones de
704 punto flotante @code{Inf} y @code{NaN}.
706 @item @code{strip-output-dir}
708 @tab No usar los directorios de los archivos de entrada al construir los
709 nombres de los archivos de salida.
711 @item @code{svg-woff}
713 @tab Usar archivos de fuente tipográfica de woff en el backend SVG.
715 @item @code{trace-memory-frequency}
717 @tab Registrar el uso de células de Scheme esta cantidad de veces por
718 segundo. Volcar los resultados en @code{ARCHIVO.stacks} y en
719 @code{ARCHIVO.graph}.
721 @item @code{trace-scheme-coverage}
723 @tab Registrar la cobertura de los archivos de Scheme en @code{ARCHIVO.cov}.
727 @tab Salida prolija, es decir el nivel de registro en DEBUG (sólo lectura).
729 @item @code{warning-as-error}
731 @tab Cambiar todos los mensajes de advertencia y de @q{error de
732 programación} a errores.
736 @node Variables de entorno
737 @unnumberedsubsec Variables de entorno
738 @translationof Environment variables
741 @cindex LILYPOND_DATADIR
743 @command{lilypond} reconoce las siguientes variables de entorno:
745 @item LILYPOND_DATADIR
746 Especifica un directorio en el que los mensajes de localización y de
747 datos se buscarán de forma predeterminada. El directorio debe
748 contener subdirectorios llamados @file{ly/}, @file{ps/}, @file{tex/},
752 Selecciona el idioma de los mensajes de advertencia.
754 @item LILYPOND_LOGLEVEL
755 Nivel de registro predeterminado. Si LilyPond se llama sin ningún
756 nivel de registro explícito (es decir, sin opción de línea de órdenes
757 @option{--loglevel}), se usa este valor.
759 @item LILYPOND_GC_YIELD
760 Una variable, como porcentaje, que ajusta el comportamiento de la
761 administración de memoria. Con valores más altos, el programa usa más
762 memoria; con valores más bajos, usa más tiempo de CPU. El valor
763 predeterminado es @code{70}.
768 @node LilyPond en una jaula de chroot
769 @unnumberedsubsec LilyPond en una jaula de chroot
770 @translationof LilyPond in chroot jail
772 La preparación del servidor para que ejecute LilyPond en una jaula de
773 chroot es una tarea muy complicada. Los pasos están relacionados más
774 abajo. Los ejemplos que aparecen en cada uno de los pasos son válidos
775 para Ubuntu GNU/Linux, y pueden requerir el uso de @code{sudo} según
780 @item Instale los paquetes necesarios: LilyPond, Ghostscript e ImageMagick.
782 @item Cree un usuario nuevo con el nombre de @code{lily}:
789 Esto también creará un nuevo grupo para el usuario @code{lily}, y una
790 carpeta personal, @code{/home/lily}
792 @item En la carpeta personal del usuario @code{lily}, cree un archivo para usarlo como un sistema de archivos separado:
795 dd if=/dev/zero of=/home/lily/loopfile bs=1k count= 200000
799 Este ejemplo crea un archivo de 200MB para su uso como el sistema de
800 archivos de la jaula.
802 @item Cree un dispositivo loop, haga un sistema de archivos y móntelo,
803 después cree una carpeta que sea escribible por el usuario
808 losetup /dev/loop0 /home/lily/loopfile
809 mkfs -t ext3 /dev/loop0 200000
810 mount -t ext3 /dev/loop0 /mnt/lilyloop
811 mkdir /mnt/lilyloop/lilyhome
812 chown lily /mnt/lilyloop/lilyhome
815 @item En la configuración de los servidores, JAIL será @code{/mnt/lilyloop}
816 y DIR será @code{/lilyhome}.
818 @item Cree un gran árbol de directorios dentro de la jaula copiando los
819 archivos necesarios, como se muestra en el guión de ejemplo que aparece
822 Puede usar @code{sed} para crear los archivos de copia necesarios para
826 for i in "/usr/local/lilypond/usr/bin/lilypond" "/bin/sh" "/usr/bin/; \
827 do ldd $i | sed 's/.*=> \/\(.*\/\)\([^(]*\).*/mkdir -p \1 \&\& \
828 cp -L \/\1\2 \1\2/' | sed 's/\t\/\(.*\/\)\(.*\) (.*)$/mkdir -p \
829 \1 \&\& cp -L \/\1\2 \1\2/' | sed '/.*=>.*/d'; done
834 @subheading Guión de ejemplo para Ubuntu 8.04 de 32 bits
838 ## aquí se fijan los valores predeterminados
842 loopdevice=/dev/loop0
843 jaildir=/mnt/lilyloop
844 # prefijo (¡sin la barra inicial!)
846 # el directorio en que lilypond se encuentra instalado en el sistema
847 lilydir=/$lilyprefix/lilypond/
849 userhome=$home/$username
850 loopfile=$userhome/loopfile
852 dd if=/dev/zero of=$loopfile bs=1k count=200000
854 losetup $loopdevice $loopfile
855 mkfs -t ext3 $loopdevice 200000
856 mount -t ext3 $loopdevice $jaildir
857 mkdir $jaildir/lilyhome
858 chown $username $jaildir/lilyhome
861 mkdir -p bin usr/bin usr/share usr/lib usr/share/fonts $lilyprefix tmp
864 cp -r -L $lilydir $lilyprefix
865 cp -L /bin/sh /bin/rm bin
866 cp -L /usr/bin/convert /usr/bin/gs usr/bin
867 cp -L /usr/share/fonts/truetype usr/share/fonts
869 # Ahora la magia de copiar las bibliotecas
870 for i in "$lilydir/usr/bin/lilypond" "$lilydir/usr/bin/guile" "/bin/sh" \
871 "/bin/rm" "/usr/bin/gs" "/usr/bin/convert"; do ldd $i | sed 's/.*=> \
872 \/\(.*\/\)\([^(]*\).*/mkdir -p \1 \&\& cp -L \/\1\2 \1\2/' | sed \
873 's/\t\/\(.*\/\)\(.*\) (.*)$/mkdir -p \1 \&\& cp -L \/\1\2 \1\2/' \
874 | sed '/.*=>.*/d'; done | sh -s
876 # Los archivos compartidos para ghostscript...
877 cp -L -r /usr/share/ghostscript usr/share
878 # Los archivos compartidos para ImageMagick
879 cp -L -r /usr/lib/ImageMagick* usr/lib
881 ### Ahora, suponiendo que tenemos test.ly en /mnt/lilyloop/lilyhome,
882 ### deberíamos poder ejecutar:
883 ### Observe que /$lilyprefix/bin/lilypond es un guión, que establece
884 ### un valor para LD_LIBRARY_PATH : esto es crucial
885 /$lilyprefix/bin/lilypond -jlily,lily,/mnt/lilyloop,/lilyhome test.ly
888 @c " keep quote signs balanced for context-sensitive editors
890 @node Mensajes de error
891 @section Mensajes de error
892 @translationof Error messages
894 @cindex error, mensajes de
895 @cindex mensajes de error
897 Pueden aparecer distintos mensajes de error al compilar un archivo:
903 Algo tiene un aspecto sospechoso. Si estamos pidiendo algo fuera de
904 lo común, entenderemos el mensaje y podremos ignorarlo. Sin embargo,
905 las advertencias suelen indicar que algo va mal con el archivo de
910 Algo va claramente mal. El paso actual de procesamiento (análisis,
911 interpretación o formateo visual) se dará por terminado, pero el
912 siguiente paso se saltará.
917 Algo va claramente mal, y LilyPond no puede seguir. Rara vez sucede
918 esto. La causa más frecuente son las tipografías mal instaladas.
920 @item Error de Scheme
921 @cindex traza de Scheme
922 @cindex llamadas, traza de
923 @cindex Scheme, error de
924 @cindex error de Scheme
925 Los errores que ocurren al ejecutar código de Scheme se interceptan
926 por parte del intérprete de Scheme. Si se está ejecutando con las
927 opciones @option{-V} o @option{--verbose} (prolijo) entonces se imprime
928 una traza de llamadas de la función ofensiva.
930 @item Error de programación
931 @cindex error de programación
932 @cindex programación, error de
933 Ha habido algún tipo de inconsistencia interna. Estos mensajes de
934 error están orientados a ayudar a los programadores y a los
935 depuradores. Normalmente se pueden ignorar. En ocasiones aparecen en
936 cantidades tan grandes que pueden entorpecer la visión de otros
939 @item Abortado (volcado de core)
940 Esto señala un error de programación serio que ha causado la
941 interrupción abrupta del programa. Estos errores se consideran
942 críticos. Si se topa con uno, envíe un informe de fallo.
945 @cindex error, formato de los mensajes de
947 Si los errores y advertencias se pueden ligar a un punto del archivo
948 de entrada, los mensajes tienen la forma siguiente:
951 @var{archivo}:@var{línea}:@var{columna}: @var{mensaje}
952 @var{línea de entrada problemática}
955 Se inserta un salto de línea en la línea problemática para indicar la
956 columna en que se encontró el error. Por ejemplo,
959 prueba.ly:2:19: error: no es una duración: 5
964 Estas posiciones son la mejor suposición de LilyPond sobre dónde se ha
965 producido el mensaje de error, pero (por su propia naturaleza) las
966 advertencias y errores se producen cuando ocurre algo inesperado. Si
967 no ve un error en la línea que se indica del archivo de entrada, trate
968 de comprobar una o dos líneas por encima de la posición indicada.
970 Se ofrece más información sobre los errores en la sección @ref{Errores
974 @node Errores comunes
975 @section Errores comunes
976 @translationof Common errors
978 Las condiciones de error que se describen más abajo se producen con
979 frecuencia, aunque su causa no es obvia o fácil de encontrar. Una vez
980 se han visto y comprendido, se manejan sin problema.
984 * La música se sale de la página::
985 * Aparece un pentagrama de más::
986 * Mensaje de error Unbound variable %::
987 * Mensaje de error FT_Get_Glyph_Name::
988 * Advertencia sobre que las afinidades del pentagrama sólo deben decrecer::
989 * Mensaje de error Unexpected new::
992 @node La música se sale de la página
993 @unnumberedsubsec La música se sale de la página
994 @translationof Music runs off the page
996 La música que se sale de la página por el margen derecho o que aparece
997 exageradamente comprimida está causada casi siempre por haber
998 introducido una duración incorrecta para una nota, produciendo que la
999 nota final de un compás se extienda más allá de la línea divisoria.
1000 Esto no es inválido si la nota final de un compás no termina sobre la
1001 línea divisoria introducida automáticamente, pues simplemente se
1002 supone que la nota se solapa encima del siguiente compás. Pero si se
1003 produce una larga secuencia tales notas solapadas, la música puede
1004 aparecer comprimida o salirse de la página porque los saltos de línea
1005 automáticos solamente se pueden insertar al final de compases
1006 completos, es decir, aquellos en que todas las notas terminan antes de
1007 o justo al final del compás.
1009 @warning{Una duración incorrecta puede hacer que se inhiban los saltos
1010 de línea, lo que llevaría a una sola línea de música muy comprimida o
1011 que se salga de la página.}
1013 La duración incorrecta se puede encontrar fácilmente si se utilizan
1014 comprobaciones de compás, véase @ruser{Comprobación de compás y de
1017 Si realmente queremos tener una serie de estos compases con notas
1018 solapadas, debemos insertar una línea divisoria invisible donde
1019 queramos el salto de línea. Para ver más detalles, consulte
1020 @ruser{Barras de compás}.
1023 @node Aparece un pentagrama de más
1024 @unnumberedsubsec Aparece un pentagrama de más
1025 @translationof An extra staff appears
1027 Si no se crean los contextos explícitamente con @code{\new} o con
1028 @code{\context}, se crearán discretamente tan pronto como se encuentra
1029 una instrucción que no se puede aplicar a un contexto existente. En
1030 partituras sencillas, la creación automática de los contextos es útil,
1031 y casi todos los ejemplos de los manuales de LilyPond se aprovechan de
1032 esta simplificación. Pero ocasionalmente la creación discreta de
1033 contextos puede hacer aflorar pentagramas o partituras nuevos e
1034 inesperados. Por ejemplo, podría esperarse que el código siguiente
1035 hiciera que todas las notas dentro del pentagrama siguiente estuvieran
1036 coloreadas de rojo, pero de hecho el resultado son dos pentagramas,
1037 permaneciendo el de abajo con las notas en el color negro
1040 @lilypond[quote,verbatim,relative=2]
1041 \override Staff.NoteHead.color = #red
1045 Esto es así porque no existe ningún contexto @code{Staff} cuando se
1046 procesa la instrucción override de sobreescritura, se crea uno
1047 implícitamente y la sobreescritura se aplica a éste, pero entonces la
1048 instrucción @code{\new Staff} crea un pentagrama nuevo y distinto, en
1049 el que se colocan las notas. El código correcto para colorear todas
1050 las notas de rojo es
1052 @lilypond[quote,verbatim,relative=2]
1054 \override Staff.NoteHead.color = #red
1059 Como segundo ejemplo, si una instrucción @code{\relative} se escribe
1060 dentro de una instrucción @code{\repeat}, el resultado son dos
1061 pentagramas, el segundo desplazado respecto al primero, porque la
1062 instrucción @code{\repeat} genera dos bloques @code{\relative},
1063 cada uno de los cuales crea implícitamente bloques @code{Staff} y
1066 @lilypond[quote,verbatim]
1068 \relative c' { c4 d e f }
1072 El problema se resuelve instanciando el contexto @code{Voice}
1075 @lilypond[quote,verbatim]
1078 \relative c' { c4 d e f }
1084 @node Mensaje de error Unbound variable %
1085 @unnumberedsubsec Mensaje de error Unbound variable %
1086 @translationof Error message Unbound variable %
1088 Este mensaje de error aparece al final de los mensajes de la consola o
1089 del archivo de registro junto a un mensaje @qq{GUILE señaló un error
1090 @dots{}} cada vez que se llame a una rutina de Scheme que
1091 (incorrectamente) contenga un comentario @emph{de LilyPond} en lugar
1092 de un comentario @emph{de Scheme}.
1094 Los comentarios de LilyPond comienzan con un símbolo de porcentaje,
1095 (@code{%}), y no se deben utilizar dentro de las rutinas de Scheme.
1096 Los comentarios de Scheme comienzan con punto y coma, (@code{;}).
1098 @node Mensaje de error FT_Get_Glyph_Name
1099 @unnumberedsubsec Mensaje de error FT_Get_Glyph_Name
1100 @translationof Error message FT_Get_Glyph_Name
1102 Este mensaje de error aparece en la salida de la consola o en el
1103 archivo log de registro si un archivo de entrada contiene un carácter
1104 que no es ASCII y no se ha guardado en la codificación de caracteres
1105 UTF-8. Para ver más detalles, consulte @ruser{Codificación del
1109 @node Advertencia sobre que las afinidades del pentagrama sólo deben decrecer
1110 @unnumberedsubsec Advertencia sobre que las afinidades del pentagrama sólo deben decrecer
1111 @translationof Warning staff affinities should only decrease
1113 Esta advertencia puede aparecer si no hay ningún pentagrama en la
1114 salida impresa, por ejemplo si sólo hay un contexto @code{ChordName} y
1115 un contexto @code{Lyrics} como en una hoja guía de acordes. Los
1116 mensajes de advertencia se pueden evitar haciendo que uno de los
1117 contextos se comporte como un pentagrama, insertando
1120 \override VerticalAxisGroup.staff-affinity = ##f
1124 al comienzo. Para ver más detalles, consulte @qq{Espaciado de las
1125 líneas que no son pautas} en @ruser{Espaciado vertical flexible dentro
1129 @node Mensaje de error Unexpected new
1130 @unnumberedsubsec Mensaje de error Unexpected @code{@bs{}new}
1131 @translationof Error message unexpected new
1133 Un bloque @code{\score} debe contener una @emph{única} expresión
1134 musical. Si en vez de ello contiene varias instrucciones
1135 @code{\new Staff}, @code{\new StaffGroup} o contextos similares
1136 introducidos con @code{\new} sin que se hayan encerrado entre
1137 llaves curvas, @code{@{ @dots{} @}}, o dobles paréntesis en
1138 ángulo, @code{<< @dots{} >>}, así:
1142 % Invalid! Generates error: syntax error, unexpected \new
1143 \new Staff @{ @dots{} @}
1144 \new Staff @{ @dots{} @}
1149 entonces se producirá el mensaje de error.
1151 Para evitar el error, encierre todas las instrucciones @code{\new}
1152 dentro de llaves curvas o dobles paréntesis en ángulo.
1154 El uso de llaves curvas introduce las instrucciones @code{\new} de
1157 @lilypond[quote,verbatim]
1160 \new Staff { a' a' a' a' }
1161 \new Staff { g' g' g' g' }
1167 pero es más probable que se encuentre utilizando dobles ángulos de
1168 manera que los pentagramas nuevos se inserten en paralelo, es
1169 decir, simultáneamente:
1171 @lilypond[quote,verbatim]
1174 \new Staff { a' a' a' a' }
1175 \new Staff { g' g' g' g' }