@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
@ignore
- Translation of GIT committish: fe39074b3c7b100142ca01a88b470a11c214462f
+ Translation of GIT committish: 7ae1e99ff67432c96faf743bc28ac7b90a47a852
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
Guide, node Updating translation committishes..
@end ignore
-@c \version "2.12.0"
+@c \version "2.14.0"
@node Ejecutar LilyPond
@var{base}@file{-cello-1.pdf}.
+@unnumberedsubsubsec Instrucciones estándar de la línea de órdenes
+
+Si su terminal (o ventana de órdenes) contempla las redirecciones
+normales, quizá le sean de utilidad las siguientes instrucciones para
+redirigir la salida de la consola a un archivo:
+
+@itemize
+
+@item
+@code{lilypond archivo.ly 1>salidaestandar.log} para redirigir la salida normal
+
+@item
+@code{lilypond archivo.ly 2>salidadeerror.log} para redirigir los mensajes de error
+
+@item
+@code{lilypond archivo.ly &>todo.log} para redirigir toda la salida
+
+@end itemize
+
+Consulte la documentación de su shell para ver si contempla estas
+opciones, o si la sintaxis es distinta. Observe que son instrucciones
+del shell y que no tienen nada que ver con lilypond.
+
@node Opciones de la línea de órdenes para lilypond
@unnumberedsubsec Opciones de la línea de órdenes para @command{lilypond}
@translationof Command line options for lilypond
@item -e,--evaluate=@var{expresión}
Evaluar la @var{expresión} de Scheme antes de analizar los archivos
-@file{.ly}. Se pueden pasar varias opciones @code{-e}, que se
+@file{.ly}. Se pueden pasar varias opciones @option{-e}, que se
evaluarán en secuencia.
La expresión se evaluará en el módulo @code{guile-user}, de manera que
@end example
@noindent
-al principio del archivo @code{.ly}.
+al principio del archivo @file{.ly}.
@item -f,--format=@var{formato}
Formato de la salida. Como @code{formato} se puede elegir entre
@table @samp
@item help
La ejecución de @code{lilypond -dhelp} imprimirá todas las opciones
-@code{-d} que están disponibles.
+@option{-d} que están disponibles.
@cindex paper-size, línea de órdenes
@cindex safe, línea de órdenes
@item safe
-No confiar en la entrada @code{.ly}.
+No confiar en la entrada @file{.ly}.
Cuando el proceso de tipografía de LilyPond se encuentra disponible a
través de un servidor web, @b{SE DEBEN} pasar las opciones
-@code{--safe} (seguro) o @code{--jail} (jaula). La opción
-@code{--safe} evita que el código de Scheme en línea arme un desastre,
+@option{--safe} (seguro) o @option{--jail} (jaula). La opción
+@option{--safe} evita que el código de Scheme en línea arme un desastre,
por ejemplo
@quotation
@end verbatim
@end quotation
-La opción @code{-dsafe} funciona evaluando las expresiones en línea de
+La opción @option{-dsafe} funciona evaluando las expresiones en línea de
Scheme dentro de un módulo especial seguro. Este módulo seguro deriva
del módulo GUILE @file{safe-r5rs}, pero añade ciertas funciones del
API de LilyPond. Estas funciones se relacionan en
-@file{scm/@/safe@/-lily@/.scm}.
+@file{scm/safe-lily.scm}.
Además, el modo seguro prohíbe las directivas @code{\include} e
inhabilita el uso de barras invertidas en las cadenas de @TeX{}.
En el modo seguro, no es posible la importación de variables de
LilyPond dentro de Scheme.
-@code{-dsafe} @emph{no} detecta la sobreutilización de recursos. Aún
+@option{-dsafe} @emph{no} detecta la sobreutilización de recursos. Aún
es posible hacer que el programa se cuelgue indefinidamente, por
ejemplo alimentando el backend con estructuras de datos cíclicas. Por
tanto, si se está utilizando LilyPond sobre un servidor web accesible
memoria.
El modo seguro impide que muchos fragmentos útiles de código de
-LilyPond se puedan compilar. La opción @code{--jail} es una
+LilyPond se puedan compilar. La opción @option{--jail} es una
alternativa más segura, pero su preparación requiere más trabajo.
@cindex salida, establecer el formato de
basadas en Scheme, en bruto.
@item null
- no producir una salida impresa; tiene el mismo efecto que @code{-dno-print-pages}.
+ no producir una salida impresa; tiene el mismo efecto que @option{-dno-print-pages}.
@end table
Ejemplo: @code{lilypond -dbackend=svg @var{archivo}.ly}
@code{\bookpart} aparecerán en la salida. Los motores @code{ps},
@code{eps} y @code{svg} contemplan esta opción.
+@item gui
+Ejecutar en modo silencioso y redirigir toda la salida a un archivo de
+registro.
+
+Nota para usuarios de Windows: de forma predeterminada
+@code{lilypond.exe} imprime toda la información del progreso de
+ejecución hacia la ventana de la consola, @code{lilypond-windows.exe}
+no lo hace y devuelve una indicación del sistema o prompt sin ninguna
+información del progreso de la ejecución inmediatamente en la línea de
+órdenes. La opción @option{-dgui} se puede usar en este caso para
+redirigir la salida a un archivo de registro.
+
@item print-pages
Generar las páginas completas, el ajuste predeterminado.
-@code{-dno-print-pages} es útil en combinación con @code{-dpreview}.
+@option{-dno-print-pages} es útil en combinación con @option{-dpreview}.
@end table
@item -H,--header=@var{CAMPO}
Volcar un campo de cabecera al archivo @file{NOMBREBASE.@var{CAMPO}}
+@cindex archivos, búsqueda de
+@cindex búsqueda, ruta de
@item --include, -I=@var{directorio}
Añadir el @var{directorio} a la ruta de búsqueda de archivos de
entrada.
-@cindex archivos, búsqueda de
-@cindex búsqueda, ruta de
+
+Se pueden escribir varias opciones -I. La búsqueda se inicia en el
+primer directorio definido, y si el archivo que se debe incluir no se
+encuentra, la búsqueda continúa en los directorios siguientes.
@item -i,--init=@var{archivo}
Establecer el archivo de inicio a @var{archivo} (predeterminado:
@file{init.ly}).
-@item -o,--output=@var{ARCHIVO}
+@cindex loglevel
+@cindex registro, nivel de
+@cindex salida prolija, fijar el nivel
+
+@item -l,--loglevel=@var{LEVEL}
+Fijar el grado en que la salida de consola es prolija al nivel
+@var{LEVEL}. Los valores posibles son:
+@table @code
+@item NONE
+Ninguna salida en absoluto, ni siquiera mensajes de error.
+
+@item ERROR
+Solamente mensajes de error, no advertencias o indicaciones de progreso.
+
+@item WARN
+Advertencias y mensajes de error, no de progreso.
+
+@item BASIC_PROGRESS
+Mensajes de progreso básicos (éxito), advertencias y errores.
+
+@item PROGRESS
+Todos los mensajes de progreso, advertencias y errores.
+
+@item INFO (predeterminado)
+Mensajes de progreso, advertencias, errores e información de ejecución
+adicional.
+
+@item DEBUG
+Todos los mensajes posibles, incuida la información de depuración
+prolija.
+@end table
+
+@cindex carpeta, dirigir la salida hacia
+@cindex salida, establecer el nombre del archivo de
+
+@item -o,--output=@var{ARCHIVO} o @var{CARPETA}
Establecer el nombre del archivo de salida predeterminado a
-@var{ARCHIVO}. Se añade el sufijo correspondiente (por ejemplo,
-@code{.pdf} para PDF).
+@var{ARCHIVO} o, si existe una carpeta con ese nombre, dirigir la
+salida hacia @var{CARPETA}, tomando el nombre de archivo del documento
+de entrada. Se añade el sufijo correspondiente (por ejemplo,
+@code{.pdf} para PDF) en los dos casos.
@item --ps
Generar PostScript.
@item --png
Generar imágenes de las páginas en formato PNG. Esto implica
-@code{--ps}. La resolución en PPP de la imagen se puede establecer
+@option{--ps}. La resolución en PPP de la imagen se puede establecer
con
@example
-dresolution=110
@cindex PDF (formato de documento portátil), salida de
@item --pdf
-Generar PDF. Implica @code{--ps}.
+Generar PDF. Implica @option{--ps}.
@item -j,--jail=@var{usuario},@var{grupo},@var{jaula},@var{directorio}
Ejecutar @command{lilypond} en una jaula de chroot.
-La opción @code{--jail} (jaula) proporciona una alternativa más
-flexible a la opción @code{--safe} cuando el proceso de tipografía de
+La opción @option{--jail} (jaula) proporciona una alternativa más
+flexible a la opción @option{--safe} cuando el proceso de tipografía de
LilyPond está disponible a través de un servidor web o cuando LilyPond
ejecuta archivos fuente procedentes del exterior.
-La opción @code{--jail} funciona cambiando la raíz de
+La opción @option{--jail} funciona cambiando la raíz de
@command{lilypond} a @var{jaula} justo antes de comenzar el proceso de
compilación en sí. Entonces se cambian el usuario y el grupo a los
que se han dado en la opción, y el directorio actual se cambia a
@var{directorio}. Esta instalación garantiza que no es posible, al
menos en teoría, escapar de la jaula. Observe que para que funcione
-@code{--jail} se debe ejecutar @command{lilypond} como root, lo que
+@option{--jail} se debe ejecutar @command{lilypond} como root, lo que
normalmente se puede hacer de una forma segura utilizando
@command{sudo}.
@item LANG
Selecciona el idioma de los mensajes de advertencia.
+@item LILYPOND_LOGLEVEL
+Nivel de registro predeterminado. Si LilyPond se llama sin ningún
+nivel de registro explícito (es decir, sin opción de línea de órdenes
+@option{--loglevel}), se usa este valor.
+
@item LILYPOND_GC_YIELD
-Con esta variable se puede ajustar la huella y el desempeño de
-memoria. Es un porcentaje que ajusta el comportamiento de la
+Una variable, como porcentaje, que ajusta el comportamiento de la
administración de memoria. Con valores más altos, el programa usa más
memoria; con valores más bajos, usa más tiempo de CPU. El valor
predeterminado es @code{70}.
# 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
+### 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
@end example
+@c " keep quote signs balanced for context-sensitive editors
@node Mensajes de error
@section Mensajes de error
@cindex 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 @code{-V} o @code{--verbose} (prolijo) entonces se imprime
+opciones @option{-V} o @option{--verbose} (prolijo) entonces se imprime
una traza de llamadas de la función ofensiva.
@item Error de programación
* Error aparente en ../ly/init.ly::
* Mensaje de error Unbound variable %::
* Mensaje de error FT_Get_Glyph_Name::
+* Advertencia sobre que las afinidades del pentagrama sólo deben decrecer::
@end menu
@node La música se sale de la página
@unnumberedsubsec Aparece un pentagrama de más
@translationof An extra staff appears
-Si no se crean los contextos explícitamente con @code{\new}, se
-crearán discretamente tan pronto como se encuentra una instrucción que
-no se puede aplicar a un contexto existente. En partituras sencillas,
-la creación automática de los contextos es útil, y casi todos los
-ejemplos de los manuales de LilyPond se aprovechan de esta
-simplificación. Pero ocasionalmente la creación discreta de contextos
-puede hacer aflorar pentagramas o partituras nuevos e inesperados.
-Por ejemplo, podría esperarse que el código siguiente hiciera que
-todas las notas dentro del pentagrama siguiente estuvieran coloreadas
-de rojo, pero de hecho el resultado son dos pentagramas, permaneciendo
-el de abajo con las notas en el color negro predeterminado.
+Si no se crean los contextos explícitamente con @code{\new} o con
+@code{\context}, se crearán discretamente tan pronto como se encuentra
+una instrucción que no se puede aplicar a un contexto existente. En
+partituras sencillas, la creación automática de los contextos es útil,
+y casi todos los ejemplos de los manuales de LilyPond se aprovechan de
+esta simplificación. Pero ocasionalmente la creación discreta de
+contextos puede hacer aflorar pentagramas o partituras nuevos e
+inesperados. Por ejemplo, podría esperarse que el código siguiente
+hiciera que todas las notas dentro del pentagrama siguiente estuvieran
+coloreadas de rojo, pero de hecho el resultado son dos pentagramas,
+permaneciendo el de abajo con las notas en el color negro
+predeterminado.
@lilypond[quote,verbatim,relative=2]
\override Staff.NoteHead #'color = #red
@lilypond[quote,verbatim]
\repeat unfold 2 {
- \relative c' { c d e f }
+ \relative c' { c4 d e f }
}
@end lilypond
-La forma correcta es invertir el orden de las instrucciones
-@code{\repeat} y @code{\relative}, así:
+El problema se resuelve instanciando el contexto @code{Voice}
+explícitamente:
@lilypond[quote,verbatim]
-\relative c' {
- \repeat unfold 2 { c d e f }
+\new Voice {
+ \repeat unfold 2 {
+ \relative c' { c4 d e f }
+ }
}
@end lilypond
@node Error aparente en ../ly/init.ly
-@unnumberedsubsubsec Error aparente en @code{../ly/init.ly}
+@unnumberedsubsec Error aparente en @code{../ly/init.ly}
@translationof Apparent error in ../ly/init.ly
Pueden aparecer varios mensajes de error extraños acerca de errores de
-sintaxis en @code{../ly/init.ly} si el archivo de entrada no está
+sintaxis en @file{../ly/init.ly} si el archivo de entrada no está
correctamente formado, por ejemplo si no contiene llaves o comillas
correctamente emparejados.
parte de la sílaba. Siempre se aconseja asegurarse de que hay
espacios antes y después de @emph{todas} las llaves. Para conocer la
importancia de este asunto al utilizar letras de canciones, consulte
-@ruser{Explicación de la letra}.
+@ruser{Introducir la letra}.
Este mensaje de error también puede aparecer si se omiten las comillas
de terminación (@code{"}). En este caso, un mensaje de error
@node Mensaje de error Unbound variable %
-@unnumberedsubsubsec Mensaje de error Unbound variable %
+@unnumberedsubsec Mensaje de error Unbound variable %
@translationof Error message Unbound variable %
Este mensaje de error aparece al final de los mensajes de la consola o
del archivo de registro junto a un mensaje @qq{GUILE señaló un error
-...} cada vez que se llame a una rutina de Scheme que
+@dots{}} cada vez que se llame a una rutina de Scheme que
(incorrectamente) contenga un comentario @emph{de LilyPond} en lugar
de un comentario @emph{de Scheme}.
(@code{%}), y no se deben utilizar dentro de las rutinas de Scheme.
Los comentarios de Scheme comienzan con punto y coma, (@code{;}).
-
@node Mensaje de error FT_Get_Glyph_Name
@unnumberedsubsec Mensaje de error FT_Get_Glyph_Name
@translationof Error message FT_Get_Glyph_Name
texto}.
+@node Advertencia sobre que las afinidades del pentagrama sólo deben decrecer
+@unnumberedsubsec Advertencia sobre que las afinidades del pentagrama sólo deben decrecer
+@translationof Warning staff affinities should only decrease
+
+Esta advertencia puede aparecer si no hay ningún pentagrama en la
+salida impresa, por ejemplo si sólo hay un contexto @code{ChordName} y
+un contexto @code{Lyrics} como en una hoja guía de acordes. Los
+mensajes de advertencia se pueden evitar haciendo que uno de los
+contextos se comporte como un pentagrama, insertando
+@example
+\override VerticalAxisGroup #'staff-affinity = ##f
+@end example
+
+@noindent
+al comienzo. Para ver más detalles, consulte @qq{Espaciado de las
+líneas que no son pautas} en @ruser{Espaciado vertical flexible dentro
+de los sistemas}.
projects / lilypond.git / blobdiff