@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
@ignore
- Translation of GIT committish: f40abd6c55ade9dba9be72ddb415f23a58bb003e
+ Translation of GIT committish: 0fa6f042cccacb643d46781dde23617c71a9753e
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.14.0"
+@c \version "2.19.21"
@node Ejecutar LilyPond
@menu
* Invocar a LilyPond::
-* Opciones de la línea de órdenes para lilypond::
+* Opciones de LilyPond básicas de la línea de órdenes::
+* Opciones avanzadas de línea de órdenes para LilyPond::
* Variables de entorno::
* LilyPond en una jaula de chroot::
@end menu
@end example
@noindent
-producirá como salida @var{base}@file{-violin.pdf} y
+produce como salida @var{base}@file{-violin.pdf} y
@var{base}@file{-cello-1.pdf}.
-@unnumberedsubsubsec Instrucciones estándar de la línea de órdenes
+@unnumberedsubsubsec Uso de LilyPond con las posibilidades básicas del shell
-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:
+Dado que LilyPond es una aplicación de consola, las posibilidades
+del @q{shell} usado para la llamada a LilyPond también pueden
+aprovecharse.
-@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
+Por ejemplo:
-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
-
-@cindex invocación de @command{lilypond}
-@cindex opciones de la línea de órdenes para @command{lilypond}
-@cindex línea de órdenes, opciones de
-@cindex modificadores
+@example
+lilypond *.ly
+@end example
-Están contempladas las siguientes opciones:
+@noindent
+procesa todos los archivos de LilyPond dentro del directorio
+actual.
-@table @code
+También puede ser útil redireccionar la salida de consola
+(p.ej. hacia un archivo):
-@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 @option{-e}, que se
-evaluarán en secuencia.
+@example
+lilypond file.ly 1> salida_estandar.txt
-La expresión se evaluará en el módulo @code{guile-user}, de manera que
-si quiere usar definiciones dentro de @var{expresión}, debe utilizar
+lilypond file.ly 2> error_estandar.txt
-@example
-lilypond -e '(define-public a 42)'
+lilypond file.ly &> todo.txt
@end example
@noindent
-en la línea de órdenes, e incluir
+Redirecciona la salida @q{normal}, solo los @q{errores} o
+@q{todo}, respectivamente, hacia un archivo de texto. Consulte la
+documentación de su shell concreto, Command (Windows), las
+aplicaciones Terminal o Console (MacOS X) para ver si el
+redireccionamiento de la salida está contemplado o si la sintaxis
+es distinta.
+
+El ejemplo siguiente busca y procesa todos los archivos de
+entradas que estén en el directorio actual y en todos los que
+están por debajo de él, recursivamente. Los archivos de salida se
+pondrán en el mismo directorio desde el que se ejecutó la
+instrucción, en lugar de aquellos en los que estaban los archivos
+de entrada originales.
@example
-#(use-modules (guile-user))
+find . -name '*.ly' -exec lilypond '@{@}' \;
@end example
@noindent
-al principio del archivo @file{.ly}.
-
-@item -f,--format=@var{formato}
-Formato de la salida. Como @code{formato} se puede elegir entre
-@code{ps}, @code{pdf} y @code{png}.
-
-Ejemplo: @code{lilypond -fpng @var{archivo}.ly}
-
-@item -d,--define-default=@var{variable}=@var{valor}
-Establece la opción interna del programa @var{variable} al valor de
-Scheme @var{valor}. Si no se proporciona ningún @var{valor}, se usa
-@var{#t}. Para desactivar una opción se puede anteponer @code{no-} a
-la @var{variable}, p.ej.:
+También debe funcionar para los usarios de MacOS@tie{}X.
-@cindex apuntar y pulsar, línea de órdenes
+Un usuario de Windows haría los siguiente:
@example
--dno-point-and-click
+forfiles /s /M *.ly /c "cmd /c lilypond @@file"
@end example
@noindent
-es lo mismo que
-@example
--dpoint-and-click='#f'
-@end example
-
-A continuación veremos algunas opciones interesantes.
+introduciendo esstas instrucciones desde un @code{indicador de
+órdenes} que normalmente está en @code{Inicio > Accessorios >
+Símbolo del sistema} o para los usuarios de la versión 8,
+escribiendo en la ventana de búsqueda @q{indicador de órdenes}.
-@cindex help (ayuda), línea de órdenes
+De forma alternativa, una ruta explícita al nivel superior de su
+carpeta que contenga todas las subcarpetas con archivos de entrada
+en su interior se puede especificat mediante la opción @code{/p};
-@table @samp
-@item help
-La ejecución de @code{lilypond -dhelp} imprimirá todas las opciones
-@option{-d} que están disponibles.
-
-@cindex paper-size, línea de órdenes
-
-@item paper-size
-Esta opción establece el tamaño predeterminado del papel,
@example
--dpaper-size=\"letter\"
+forfiles /s /p C:\Documentos\MisPartituras /M *.ly /c "cmd /c lilypond @@file"
@end example
-@noindent
-Observe que la cadena se debe incluir dentro de comillas escapadas
-( @code{\"} ).
+Si el nombre de la ruta del directorio de nivel superior contiene
+espacios, entonces es necesario incluir toda la ruta entre
+comillas:
-@c Match " in previous line to help context-sensitive editors
+@example
+forfiles /s /p "C:\Documentos\Mis Partituras" /M *.ly /c "cmd /c lilypond @@file"
+@end example
-@cindex safe, línea de órdenes
-@item safe
-No confiar en la entrada @file{.ly}.
+@node Opciones de LilyPond básicas de la línea de órdenes
+@unnumberedsubsec Opciones de LilyPond básicas de la línea de órdenes
+@translationof Basic command line options for LilyPond
-Cuando el proceso de tipografía de LilyPond se encuentra disponible a
-través de un servidor web, @b{SE DEBEN} pasar las opciones
-@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
+@cindex Invoca a @command{lilypond}
+@cindex opciones de la línea de órdenes para @command{lilypond}
+@cindex opciones, línea de órdenes
+@cindex opciones
-@quotation
-@verbatim
-#(system "rm -rf /")
-{
- c4^#(ly:export (ly:gulp-file "/etc/passwd"))
-}
-@end verbatim
-@end quotation
+Están contempladas las siguientes opciones:
-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}.
-
-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.
-
-@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
-públicamente, el proceso debe limitarse tanto en el uso de CPU como de
-memoria.
-
-El modo seguro impide que muchos fragmentos útiles de código de
-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
-@item backend
-el formato de salida que usar para el back-end o extremo final.
-Para el @code{formato} se puede elegir entre
@table @code
-@item ps
-@cindex PostScript, salida
-para PostScript.
-Los archivos PostScript incluyen las tipografías TTF, Type1 y OTF. No
-se seleccionan subconjuntos de estas tipografías. Cuando se usan
-conjuntos de caracteres orientales, esto puede dar lugar a archivos
-enormes.
+@item -b, --bigpdfs
+@cindex bigpdfs
-@item eps
- para obtener PostScript encapsulado. Esto vuelca cada una de las
-páginas/sistemas como un archivo @file{EPS} distinto, sin tipografías,
-y como un solo archivo @file{EPS} encuadernado con todas las
-páginas/sistemas con las tipografías incluidas.
+Los archivos PDF generados serán mucho más grandes de lo normal (a
+causa de la poca o ninguna optimización de las fuentes
+tipográficas). Sin embargo, si dos o más archivos PDF se incluyen
+dentro de @w{@code{pdftex}}, @w{@code{xetex}} o @w{@code{luatex}}
+los documentos producidos pueden procesarse después a través de
+ghostscript (mezclando los datos de tipografías duplicados) dando
+como resultado archivos PDF @emph{significativamente} más
+pequeños.
-Este modo se usa de forma predeterminada por parte de
-@command{lilypond-book}.
+@example
+lilypond -b archivo
+@end example
-@item svg
+Después, ejecute @code{ghostscript};
-@cindex SVG (Gráficos vectoriales escalables)
+@example
+gs -q -sDEVICE=pdfwrite -o gsout.pdf archivo.pdf
+@end example
- para obtener SVG (gráficos vectoriales escalables).
+Se puede entonces usar @code{pdfsizeopt.py} para optimizar aún más
+el tamaño del archivo:
-Crea un único archivo SVG que contiene toda la salida de música, con
-las tipografías incrustadas. Se necesita un visor de SVG que
-contemple las tipografías incrustadas, o un visor de SVG que pueda
-sustituir las tipografías incrustadas por tipografías OTF. Bajo UNIX,
-puede usar @uref{http://www.inkscape.org,Inkscape} (versión 0.42 o
-posterior), después de copiar las tipografías OTF del directorio de
-LilyPond (que normalmente es
-@file{/usr/share/lilypond/VERSIÓN/fonts/otf/}) al directorio
-@file{~/.fonts/}.
+@example
+pdfsizeopt.py --use-multivalent=no gsout.pdf final.pdf
+@end example
-@item scm
+@item -d, --define-default=@var{variable}=@var{valor}
+Véase @ref{Opciones avanzadas de línea de órdenes para LilyPond}.
-@cindex Scheme, volcado de
+@cindex Scheme, evaluación de expresiones
+@cindex expresiones de Scheme, evaluación
- para obtener un volcado de las instrucciones internas de dibujo
-basadas en Scheme, en bruto.
+@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 @option{-e}, que se
+evaluarán en secuencia.
-@item null
- no producir una salida impresa; tiene el mismo efecto que @option{-dno-print-pages}.
-@end table
+La expresión se evaluará en el módulo @code{guile-user}, de manera que
+si quiere usar definiciones dentro de @var{expresión}, debe utilizar
-Ejemplo: @code{lilypond -dbackend=svg @var{archivo}.ly}
+@example
+lilypond -e '(define-public a 42)'
+@end example
-@item preview
-@cindex vista previa, línea de órdenes
-Generar un archivo de salida que contenga solamente los títulos de
-cabecera y el primer sistema de música. Si se usan bloques
-@code{\bookpart}, los títulos y el primer sistema de todos los bloques
-@code{\bookpart} aparecerán en la salida. Los motores @code{ps},
-@code{eps} y @code{svg} contemplan esta opción.
+@noindent
+en la línea de órdenes, e incluir
-@item gui
-Ejecutar en modo silencioso y redirigir toda la salida a un archivo de
-registro.
+@example
+#(use-modules (guile-user))
+@end example
-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.
+@noindent
+al principio del archivo @file{.ly}.
-@item print-pages
-Generar las páginas completas, el ajuste predeterminado.
-@option{-dno-print-pages} es útil en combinación con @option{-dpreview}.
+@warning{Los usuarios de Windows deben utilizar comillas dobles en lugar de apóstrofos simples.}
-@end table
+@cindex output, format
+@cindex format, output
+@item -f, --format=@var{format}
+which formats should be written. Choices for @code{format} are
+@code{ps}, @code{pdf}, and @code{png}.
+Example: @code{lilypond -fpng @var{filename}.ly}
+
+@noindent
+Para los formatos @code{svg} y @code{eps} utilice
+la opción @code{-dbackend}.
+Véase @ref{Opciones avanzadas de línea de órdenes para LilyPond}.
-@item -h,--help
+@item -h, --help
Mostrar un resumen de las formas de utilización.
-@item -H,--header=@var{CAMPO}
+@item -H, --header=@var{CAMPO}
Volcar un campo de cabecera al archivo @file{NOMBREBASE.@var{CAMPO}}
+@item -i, --init=@var{archivo}
+Establecer el archivo de inicio a @var{archivo} (predeterminado:
+@file{init.ly}).
+
@cindex archivos, búsqueda de
@cindex búsqueda, ruta de
-@item --include, -I=@var{directorio}
+
+@item -I, --include=@var{directorio}
Añadir el @var{directorio} a la ruta de búsqueda de archivos de
entrada.
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}).
+@cindex chroot, ejecutar dentro de una jaula
+
+@item -j, --jail=@var{usuario},@var{grupo},@var{jaula},@var{directorio}
+Ejecutar @command{lilypond} en una jaula de chroot.
+
+La opción @option{--jail} (jaula) proporciona una alternativa más
+flexible a la opción @option{-dsafe} cuando el proceso de tipografía de
+LilyPond está disponible a través de un servidor web o cuando LilyPond
+ejecuta instrucciones enviadas por fuentes externas
+(véase @ref{Opciones avanzadas de línea de órdenes para LilyPond}).
+
+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
+@option{--jail}, se debe ejecutar @command{lilypond} como root, lo que
+normalmente se puede hacer de una forma segura utilizando
+@command{sudo}.
+
+La instalación de una jaula puede ser un asunto relativamente
+complejo, pues debemos asegurarnos de que LilyPond puede encontrar
+@emph{dentro} de la propia jaula todo lo que necesita para poder
+compilar la fuente. Una típica configuración de jaula de chroot
+consta de los siguientes elementos:
+
+@table @asis
+
+@item Preparar un sistema de archivos separado
+Se debe crear un sistema de archivos separado para LilyPond, de forma
+que se pueda montar con opciones seguras como @code{noexec},
+@code{nodev} y @code{nosuid}. De esta forma, es imposible ejecutar
+programas o escribir directamente a un dispositivo desde LilyPond. Si
+no quiere crear una partición separada, tan sólo tiene que crear un
+archivo de un tamaño razonable y usarlo para montar un dispositivo
+loop. El sistema de archivos separado garantiza también que LilyPond
+nunca pueda escribir en un espacio mayor del que se le permita.
+
+@item Preparar un usuario separado
+Se debe usar un usuario y grupo separados (digamos
+@code{lily}/@code{lily}) con bajos privilegios para ejecutar LilyPond
+dentro de la jaula. Debería existir un solo directorio con permisos
+de escritura para este usuario, y debe pasarse en el valor
+@var{directorio}.
+
+@item Preparar la jaula
+LilyPond necesita leer algunos archivos mientras se ejecuta. Todos
+estos archivos se deben copiar dentro de la jaula, bajo la misma ruta
+en que aparecen en el sistema de archivos real de root. Todo el
+contenido de la instalación de LilyPond (por ejemplo
+@file{/usr/share/lilypond}) se debe copiar.
+
+Si surgen problemas, la forma más sencilla de rastrearlos es ejecutar
+LilyPond usando @command{strace}, lo que le permitirá determinar qué
+archivos faltan.
+
+@item Ejecutar LilyPond
+Dentro de una jaula montada con @code{noexec} es imposible ejecutar
+ningún programa externo. Por tanto, LilyPond se debe ejecutar con un
+backend que no necesite tal programa. Como ya hemos mencionado, se
+debe ejecutar con privilegios del superusuario (que por supuesto
+perderá inmediatamente), posiblemente usando @command{sudo}. También
+es una práctica recomendable limitar el número de segundos de tiempo
+de CPU que LilyPond puede usar (p.ej., usando
+@command{ulimit@tie{}-t}), y, si su sistema operativo lo contempla, el
+tamaño de la memoria que se puede reservar. Véase también
+@ref{LilyPond en una jaula de chroot}.
+
+@end table
@cindex loglevel
@cindex registro, nivel de
@cindex salida prolija, fijar el nivel
-@item -l,--loglevel=@var{LEVEL}
+@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.
@cindex carpeta, dirigir la salida hacia
@cindex salida, establecer el nombre del archivo de
-@item -o,--output=@var{ARCHIVO} o @var{CARPETA}
+@item -o, --output=@var{ARCHIVO} o @var{CARPETA}
Establecer el nombre del archivo de salida predeterminado a
@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.
+@cindex PS (Postscript), salida
+@cindex Postscript (PS), salida
+@cindex salida, PS (Postscript)
+
@item --ps
Generar PostScript.
+@cindex PNG (Portable Network Graphics), salida
+@cindex salida, PNG (Portable Network Graphics)
+
@item --png
Generar imágenes de las páginas en formato PNG. Esto implica
@option{--ps}. La resolución en PPP de la imagen se puede establecer
@end example
@cindex PDF (formato de documento portátil), salida de
+@cindex salida, PDF (formato de documento portátil)
@item --pdf
Generar PDF. Implica @option{--ps}.
+@item -v, --version
+Mostrar la información de la versión.
+
+@item -V, --verbose
+Ser prolijo: mostrar las rutas completas de todos los archivos que se
+leen, y dar información cronométrica.
+@item -w, --warranty
+Mostrar la garantía con que viene GNU LilyPond (¡no viene con
+@strong{NINGUNA GARANTÍA}!).
-@item -j,--jail=@var{usuario},@var{grupo},@var{jaula},@var{directorio}
-Ejecutar @command{lilypond} en una jaula de chroot.
+@end table
-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 @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
-@option{--jail} se debe ejecutar @command{lilypond} como root, lo que
-normalmente se puede hacer de una forma segura utilizando
-@command{sudo}.
+@node Opciones avanzadas de línea de órdenes para LilyPond
+@unnumberedsubsec Opciones avanzadas de línea de órdenes para LilyPond
+@translationof Advanced command line options for LilyPond
-La instalación de una jaula es un asunto algo delicado, pues debemos
-asegurarnos de que LilyPond puede encontrar @emph{dentro de la jaula}
-todo lo que necesita para poder compilar la fuente. Una configuración
-típica consta de los siguientes elementos:
+@table @code
-@table @asis
-@item Preparar un sistema de archivos separado
-Se debe crear un sistema de archivos separado para LilyPond, de forma
-que se pueda montar con opciones seguras como @code{noexec},
-@code{nodev} y @code{nosuid}. De esta forma, es imposible ejecutar
-programas o escribir directamente a un dispositivo desde LilyPond. Si
-no quiere crear una partición separada, tan sólo tiene que crear un
-archivo de un tamaño razonable y usarlo para montar un dispositivo
-loop. El sistema de archivos separado garantiza también que LilyPond
-nunca pueda escribir en un espacio mayor del que se le permita.
+@item -d@var{[option-name]}=@var{[value]},
+--define-default=@var{[option-name]}=@var{[value]}
+Establece la función de Scheme interna equivalente a @var{valor}.
+Por ejemplo:
-@item Preparar un usuario separado
-Se debe usar un usuario y grupo separados (digamos
-@code{lily}/@code{lily}) con bajos privilegios para ejecutar LilyPond
-dentro de la jaula. Debería existir un solo directorio con permisos
-de escritura para este usuario, y debe pasarse en el valor
-@var{directorio}.
+@example
+-dbackend=svg
+@end example
-@item Preparar la jaula
-LilyPond necesita leer algunos archivos mientras se ejecuta. Todos
-estos archivos se deben copiar dentro de la jaula, bajo la misma ruta
-en que aparecen en el sistema de archivos real de root. Todo el
-contenido de la instalación de LilyPond (por ejemplo
-@file{/usr/share/lilypond}) se debe copiar.
+Si no se proporciona ningún @var{valor}, se usa el valor predeterminado.
+Para desactivar una opción se puede anteponer @code{no-} a la
+@var{variable}. Por ejemplo:
-Si surgen problemas, la forma más sencilla de rastrearlos es ejecutar
-LilyPond usando @command{strace}, lo que le permitirá determinar qué
-archivos faltan.
+@cindex point and click, command line
-@item Ejecutar LilyPond
-Dentro de una jaula montada con @code{noexec} es imposible ejecutar
-ningún programa externo. Por tanto, LilyPond se debe ejecutar con un
-backend que no necesite tal programa. Como ya mencionamos, también se
-debe ejecutar con privilegios del superusuario (que por supuesto
-perderá inmediatamente), posiblemente usando @command{sudo}. Es buena
-idea limitar el número de segundos de tiempo de CPU que LilyPond puede
-usar (p.ej., usando @command{ulimit -t}), y, si su sistema operativo
-lo contempla, el tamaño de la memoria que se puede reservar.
+@example
+-dpoint-and-click=#f
+@end example
+
+@noindent
+is the same as
+@example
+-dno-point-and-click
+@end example
@end table
+@noindent Están contempladas las siguientes opciones junto a sus respectivos
+valores predeterminados:
+
+@multitable @columnfractions .33 .16 .51
+@item @strong{Símbolo}
+@tab @strong{Valor}
+@tab @strong{Explicación/Opciones}
+
+@item @code{anti-alias-factor} (factor de antialias)
+@tab @code{1}
+@tab Renderizar a mayor resolución (utilizando el factor dado)
+y reducir la escala del resultado para así evitar @q{escaleras} en
+las imágenes @code{PNG}.
+
+@item @code{aux-files} (archivos auxiliares)
+@tab @code{#t}
+@tab Crear archivos @code{.tex}, @code{.texi} y @code{.count}
+cuando se usa con la opción de @q{back-end} @code{EPS}.
+
+@item @code{backend}
+@tab @code{ps}
+@tab Es el ajuste predeterminado.
+Los archivos Postscript (la opción predeterminada) incluyen las
+fuentes tipográficas @code{TTF}, @code{Type1} y @code{OTF}. No se
+hace ningún subconjunto de estas fuentes. Tenga en cuenta que el
+uso de conjuntos de caracteres @q{orientales} puede dar lugar a
+archivos muy grandes.
-@item -v,--version
-Mostrar la información de la versión.
+@item
+@tab @code{eps}
+@tab Usado como opción predeterminada por la instrucción @command{lilypond-book}.
+Vuelca cada página al mismo tiempo como un solo archivo con todas
+las ṕaginas y fuentes tipográficas incluidas y como archivos
+postscript separados para cada página pero sin las fuentes
+tipográficas incluidas.
-@item -V,--verbose
-Ser prolijo: mostrar las rutas completas de todos los archivos que se
-leen, y dar información cronométrica.
+@item
+@tab @code{null}
+@tab No producir ninguna partitura impresa a la salida; tiene el mismo
+efecto que @code{-dno-print-pages}.
+
+@item
+@tab @code{scm}
+@tab Volcado de las instrucciones de dibujo internas basadas en Scheme, en
+bruto.
+
+@item
+@tab @code{svg}
+@tab Gráficos vectoriales escalables.
+Por cada página de la salida, se crea un solo archivo @code{SVG}.
+Los glifos musicales se codifican como gráficos vectoriales,
+pero las fuentes tipográficas del texto
+@emph{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 @q{alias} ni @q{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
+@emph{Web Open Font Format} (WOFF), es necesario indicar la opción
+@code{--svg-woff}.
+@end multitable
+
+@noindent
+@strong{Nota para el backend de salida svg:}
+En la salida SVG, LilyPond usa por defecto los valores
+de @code{font-family} genéricos @code{serif}, @code{sans-serif}, o
+@code{monospace}. Por tanto, al usar el
+backend @code{svg} debemos definir explícitamente
+las fuentes predeterminadas deseadas en el archivo de entrada:
+
+@quotation
+@verbatim
+\paper {
+ #(define fonts
+ (make-pango-font-tree "TeX Gyre Schola"
+ "TeX Gyre Heros"
+ "TeX Gyre Cursor"
+ (/ staff-height pt 20)))
+}
+@end verbatim
+@end quotation
+
+Véase también @ruser{Fuentes tipográficas del documento completo}.
+
+@multitable @columnfractions .33 .16 .51
+@item @code{check-internal-types}
+@tab @code{#f}
+@tab Comprobar el tipo de cada asignación de propiedades.
+
+@item @code{clip-systems} (recortar los sistemas)
+@tab @code{#f}
+@tab Extraer fragmentos de música de la partitura. Requiere que la función
+@code{clip-regions} esté definida dentro del bloque
+@code{\layout}. Véase @ruser{Extracción de fragmentos de música}.
+No se extrae ningún fragmento si se usa con la copción
+@option{-dno-print-pages}.
+
+@item @code{datadir} (directorio de datos)
+@tab
+@tab Prefijo de los archivos de datos (sólo lectura).
+
+@item @code{debug-gc}
+@tab @code{#f}
+@tab Volcar estadísticas de depuración de memoria.
+
+@item @code{debug-gc-assert-parsed-dead}
+@tab @code{#f}
+@tab Para la depuración de memoria: asegurarse de que todas las referencias
+a objetos analizados están muertas. Es una opción interna, y se
+activa automáticamente para @code{`-ddebug-gc'}.
+
+@item @code{debug-lexer}
+@tab @code{#f}
+@tab Depuración del analizador léxico flex.
+
+@item @code{debug-page-breaking-scoring}
+@tab @code{#f}
+@tab Volcar las partituras para muchas configuraciones de saltos de página
+diferentes.
+
+@item @code{debug-parser}
+@tab @code{#f}
+@tab Depuración del analizador sintáctico bison.
+
+@item @code{debug-property-callbacks}
+@tab @code{#f}
+@tab Depuración de las cadenas cíclicas de funciones de callback.
+
+@item @code{debug-skylines}
+@tab @code{#f}
+@tab Depuración de las líneas de horizonte.
+
+@item @code{delete-intermediate-files}
+@tab @code{#t}
+@tab Eliminar los archivos intermedios @code{.ps} inútiles ques e crean
+durante la compilación.
+
+@item @code{dump-cpu-profile}
+@tab @code{#f}
+@tab Volcar información de cuenta de tiempo (dependiente del sistema).
+
+@item @code{dump-profile}
+@tab @code{#f}
+@tab Volcar de la información de memoria y de tiempo para cada archivo.
+
+@item @code{dump-signatures}
+@tab @code{#f}
+@tab Volcar las firmas de salida de cada sistema. Usado para las pruebas
+de regresión.
+
+@item @code{embed-source-code}
+@tab @code{#f}
+@tab Empotrar los archivos de entrada en código de LilyPond
+dentro del documento PDF generado.
+
+@item @code{eps-box-padding}
+@tab @code{#f}
+@tab Rellenar el borde izquierdo de la caja contenedora del EPS de salida
+en la cantidad dada (en mm).
+
+@item @code{gs-load-fonts}
+@tab @code{#f}
+@tab Cargar las fuentes tipográficas a través de Ghostscript.
+
+@item @code{gs-load-lily-fonts}
+@tab @code{#f}
+@tab Cargar sólo las fuentes de LilyPond por medio de Ghostscript.
+
+@item @code{gui}
+@tab @code{#f}
+@tab Se ejecuta silenciosamente y se redirige toda la salida a un archivo
+de registro.
+@end multitable
+
+@noindent
+@strong{Nota para los usuarios de Windows:} De manera predeterminada,
+@code{lilypond.exe} dirige toda la salida de la información de avance
+hacia la ventana de consola, @code{lilypond-windows.exe} no lo hace y
+devuelve un indicador del sistema, sin ninguna indicación del avance,
+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.
+
+@multitable @columnfractions .33 .16 .51
+@item @code{help}
+@tab @code{#f}
+@tab Mostrar esta ayuda.
+
+@item @code{include-book-title-preview}
+@tab @code{#t}
+@tab Incluir los títulos de libro en las imágenes de vista previa.
+
+@item @code{include-eps-fonts}
+@tab @code{#t}
+@tab Incluir las fuentes tipográficas en los archivos EPS de cada uno de
+los sistemas.
+
+@item @code{include-settings}
+@tab @code{#f}
+@tab Incluir el archivo de los ajustes globales, se incluye antes de que la
+partitura se procese.
+
+@item @code{job-count}
+@tab @code{#f}
+@tab Procesar en paralelo, usando el número de tareas dado.
+
+@item @code{log-file}
+@tab @code{#f [file]}
+@tab Si se da una cadena @code{NOMBRE} como segundo argumento,
+redirigir la salida al archivo de registro @code{NOMBRE.log}.
+
+@item @code{max-markup-depth}
+@tab @code{1024}
+@tab Profundidad máxima del árbol de marcado. Si un marcado tiene más niveles,
+suponer que no terminará por sí mismo, imprimiento una advertencia y
+devolviendo en su lugar un elemento de marcado nulo.
+
+@item @code{midi-extension}
+@tab @code{"midi"}
+@tab Fijar la extensión de archivo predeterminada para el archivo de salida
+MIDI a la cadena dada.
+
+@item @code{music-strings-to-paths}
+@tab @code{#f}
+@tab Convertir las cadenas de texto a rutas cuando los glifos pertenecen a
+una fuente de tipografía musical.
+
+@item @code{paper-size}
+@tab @code{\"a4\"}
+@tab Establecer el tamaño predeterminado del papel. Observe que la cadena
+debe ir encerrada entre comillas dobles.
+
+@item @code{pixmap-format}
+@tab @code{png16m}
+@tab Fijar el formato de salida de Ghostscript para las imágenes de píxeles.
+
+@item @code{point-and-click}
+@tab @code{#t}
+@tab Añadir enlaces de @q{apuntar y pulsar} a la salida PDF y SVG. Véase
+@ref{Apuntar y pulsar}.
+
+@item @code{preview}
+@tab @code{#f}
+@tab Crear imágenes de vista previa además de la salida normal.
+@end multitable
+
+@noindent
+Esta opción está contemplada por todos los @q{back-ends}: @code{pdf},
+@code{png}, @code{ps}, @code{eps} y @code{svg}, pero no por
+@code{scm}. Genera un archivo de salida, en la forma
+@code{miArchivo.preview.extensión}, que contiene los títulos y el
+primer sistema de la música. Si se están utilizando bloques
+@code{\book} o @code{\bookpart}, aparecen en la salida los títulos de
+@code{\book}, @code{\bookpart} o @code{\score}, incluido el primer
+sistema de cada bloque @code{\score} si la variable de @code{\paper}
+@code{print-all-headers} está fijada al valor @code{#t}.
+
+Para suprimir la salida usual, utilice las opciones
+@option{-dprint-pages} o @option{-dno-print-pages} según sus
+necesidades.
+
+@multitable @columnfractions .33 .16 .51
+@item @code{print-pages}
+@tab @code{#t}
+@tab Generar páginas completas (es la opción predeterminada). Es útil
+@option{-dno-print-pages} en combinación con @option{-dpreview}.
+
+@item @code{profile-property-accesses}
+@tab @code{#f}
+@tab Conservar las estadísticas de las llamadas de función
+@code{get_property()}.
+
+@item @code{protected-scheme-parsing}
+@tab @code{#t}
+@tab Continuar cuando se captan en el analizador sintáctico errores del
+Scheme empotrado. Si se fija a @code{#f}, detenerse cuando haya
+errores e imprimir un registro de traza de pila.
+
+@item @code{read-file-list}
+@tab @code{#f [archivo]}
+@tab Especificar el nobmre de un archivo que contiene una lista de archivos
+de entrada para procesar.
+
+@item @code{relative-includes}
+@tab @code{#f}
+@tab Cuando se procesa una instrucción @code{\include} command, buscar el
+archivo incluido de forma relativa al archivo actual (en lugar del
+archivo principal).
+
+@item @code{resolution}
+@tab @code{101}
+@tab Fijar la resolución para generar imágenes de píxeles @code{PNG} al
+valor dado (en ppp).
+
+@item @code{safe}
+@tab @code{#f}
+@tab No confiar en la entrada @code{.ly}.
+@end multitable
+
+@noindent
+Cuando el servicio de tipografía está disponible a través de un
+servidor web, @b{SE DEBEN} pasar las opciones @option{--safe} o
+@option{--jail}. La opción @option{--safe} evita que el código de
+Scheme monte un desastre, p.ej.:
+
+@quotation
+@verbatim
+#(s ystem "rm -rf /") % demasiado peligroso para escribirlo correctamente
+{
+ c4^$(ly:gulp-file "/etc/passwd") % malicioso aunque no tan destructivo
+}
+@end verbatim
+@end quotation
+
+La opción @option{-dsafe} funciona evaluando las expresiones de Scheme
+en línea dentro de un módulo seguro especial. Deriva del módulo
+@file{safe-r5rs} de GUILE, pero además añade unas cuantas funciones de
+la API de LIlyPond que están relacionadas en @file{scm/safe-lily.scm}.
+
+Además, el modo seguro prohíbe las directivas @code{\include} y
+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.
+
+@option{-dsafe} @emph{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 @option{--jail} es una alternativa más segura aún, pero
+requiere más trabajo para su configuración. Véase
+@ref{Opciones de LilyPond básicas de la línea de órdenes}.
+
+@multitable @columnfractions .33 .16 .51
+@item @code{separate-log-files}
+@tab @code{#f}
+@tab Para los archivos de entrada @code{ARCHIVO1.ly}, @code{ARCHIVO2.ly},
+etc. sacar los datos de registro hacia los archivos @code{ARCHIVO1.log},
+@code{ARCHIVO2.log}@dots{}
+
+@item @code{show-available-fonts}
+@tab @code{#f}
+@tab Listar todos los nombres de las fuentes tipográficas disponibles.
+
+@item @code{strict-infinity-checking}
+@tab @code{#f}
+@tab Forzar una terminación abrupta si se encuentran las excepciones de
+punto flotante @code{Inf} y @code{NaN}.
+
+@item @code{strip-output-dir}
+@tab @code{#t}
+@tab No usar los directorios de los archivos de entrada al construir los
+nombres de los archivos de salida.
+
+@item @code{strokeadjust}
+@tab @code{#f}
+@tab 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 a las
+resoluciones típicas de las pantallas de ordenador. 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.
+
+@item @code{svg-woff}
+@tab @code{#f}
+@tab Esta opción es necesaria al usar archivos de fuente abierta para la Web,
+Web Open Font Format (WOFF) con la instrucción de backend
+@code{svg}. 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.
+
+@item @code{trace-memory-frequency}
+@tab @code{#f}
+@tab Registrar el uso de células de Scheme esta cantidad de veces por
+segundo. Volcar los resultados en @code{ARCHIVO.stacks} y en
+@code{ARCHIVO.graph}.
+
+@item @code{trace-scheme-coverage}
+@tab @code{#f}
+@tab Registrar la cobertura de los archivos de Scheme en @code{ARCHIVO.cov}.
+
+@item @code{verbose}
+@tab @code{#f}
+@tab Salida prolija, es decir el nivel de registro en DEBUG (sólo lectura).
+
+@item @code{warning-as-error}
+@tab @code{#f}
+@tab Cambiar todos los mensajes de advertencia y de @q{error de
+programación} a errores.
+@end multitable
-@item -w,--warranty
-Mostrar la garantía con que viene GNU LilyPond (¡no viene con
-@strong{NINGUNA GARANTÍA}!).
-@end table
@node Variables de entorno
@unnumberedsubsec Variables de entorno
@translationof Environment variables
-
@cindex LANG
@cindex LILYPOND_DATADIR
La preparación del servidor para que ejecute LilyPond en una jaula de
chroot es una tarea muy complicada. Los pasos están relacionados más
abajo. Los ejemplos que aparecen en cada uno de los pasos son válidos
-para Ubuntu Linux, y pueden requerir el uso de @code{sudo} según
+para Ubuntu GNU/Linux, y pueden requerir el uso de @code{sudo} según
corresponda.
@itemize
-@item Instale los paquetes necesarios: LilyPond, GhostScript e ImageMagick.
+@item Instale los paquetes necesarios: LilyPond, Ghostscript e ImageMagick.
@item Cree un usuario nuevo con el nombre de @code{lily}:
un ejecutable dado:
@example
-for i in "/usr/local/lilypond/usr/bin/lilypond" "/bin/sh" "/usr/bin/; 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
+for i in "/usr/local/lilypond/usr/bin/lilypond" "/bin/sh" "/usr/bin/; \
+ 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
@end example
@end itemize
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
+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
@cindex error, formato de los mensajes de
-Se los errores y advertencias se pueden ligar a un punto del archivo
+Si los errores y advertencias se pueden ligar a un punto del archivo
de entrada, los mensajes tienen la forma siguiente:
@example
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
+@q{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 @ref{Errores
comunes}.
+
@node Errores comunes
@section Errores comunes
@translationof Common errors
@menu
* La música se sale de la página::
* Aparece un pentagrama de más::
-* 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::
+* Mensaje de error Unexpected new::
+* Advertencia de que una voz requiere ajustes voiceXx o shiftXx::
@end menu
@node La música se sale de la página
permaneciendo el de abajo con las notas en el color negro
predeterminado.
-@lilypond[quote,verbatim,relative=2]
-\override Staff.NoteHead #'color = #red
-\new Staff { a }
+@lilypond[quote,verbatim,fragment]
+\override Staff.NoteHead.color = #red
+\new Staff { a' }
@end lilypond
Esto es así porque no existe ningún contexto @code{Staff} cuando se
el que se colocan las notas. El código correcto para colorear todas
las notas de rojo es
-@lilypond[quote,verbatim,relative=2]
-\new Staff {
- \override Staff.NoteHead #'color = #red
- a
-}
-@end lilypond
-
-Como segundo ejemplo, si una instrucción @code{\relative} se escribe
-dentro de una instrucción @code{\repeat}, el resultado son dos
-pentagramas, el segundo desplazado respecto al primero, porque la
-instrucción @code{\repeat} genera dos bloques @code{\relative},
-cada uno de los cuales crea implícitamente bloques @code{Staff} y
-@code{Voice}.
-
-@lilypond[quote,verbatim]
-\repeat unfold 2 {
- \relative c' { c4 d e f }
-}
-@end lilypond
-
-El problema se resuelve instanciando el contexto @code{Voice}
-explícitamente:
-
@lilypond[quote,verbatim]
-\new Voice {
- \repeat unfold 2 {
- \relative c' { c4 d e f }
- }
+\new Staff {
+ \override Staff.NoteHead.color = #red
+ a'
}
@end lilypond
-
-@node Error aparente en ../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 @file{../ly/init.ly} si el archivo de entrada no está
-correctamente formado, por ejemplo si no contiene llaves o comillas
-correctamente emparejados.
-
-El error más común es la falta de una llave de cierre, (@code{@}}), al
-final de un bloque @code{score}. Aquí la solución es obvia: compruebe
-que el bloque @code{score} está correctamente cerrado. La estructura
-correcta de un archivo de entrada está descrita en @rlearning{Cómo
-funcionan los archivos de entrada de LilyPond}. Usando un editor que
-resalte automáticamente las llaves correspondientes es de mucha ayuda
-para evitar estos errores.
-
-Una segunda causa frecuente es la falta de un espacio entre la última
-sílaba de un bloque lyrics (de letra) y la llave de cierre,
-(@code{@}}). Sin esta separación, se considera que la llave forma
-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{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
-adicional debería indicar un número de línea cercano al de aquella
-donde está el error. Las comillas desbalanceadas estarán por lo
-general una o dos líneas por encima.
-
-
@node 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}.
contextos se comporte como un pentagrama, insertando
@example
-\override VerticalAxisGroup #'staff-affinity = ##f
+\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}.
+
+
+@node Mensaje de error Unexpected new
+@unnumberedsubsec Mensaje de error Unexpected @code{@bs{}new}
+@translationof Error message unexpected new
+
+Un bloque @code{\score} debe contener una @emph{única} expresión
+musical. Si en vez de ello contiene varias instrucciones
+@code{\new Staff}, @code{\new StaffGroup} o contextos similares
+introducidos con @code{\new} sin que se hayan encerrado entre
+llaves curvas, @code{@{ @dots{} @}}, o dobles paréntesis en
+ángulo, @code{<< @dots{} >>}, así:
+
+@example
+\score @{
+ % Invalid! Generates error: syntax error, unexpected \new
+ \new Staff @{ @dots{} @}
+ \new Staff @{ @dots{} @}
+@}
+@end example
+
+@noindent
+entonces se producirá el mensaje de error.
+
+Para evitar el error, encierre todas las instrucciones @code{\new}
+dentro de llaves curvas o dobles paréntesis en ángulo.
+
+El uso de llaves curvas introduce las instrucciones @code{\new} de
+forma secuencial:
+
+@lilypond[quote,verbatim]
+\score {
+ {
+ \new Staff { a' a' a' a' }
+ \new Staff { g' g' g' g' }
+ }
+}
+@end lilypond
+
+@noindent
+pero es más probable que se encuentre utilizando dobles ángulos de
+manera que los pentagramas nuevos se inserten en paralelo, es
+decir, simultáneamente:
+
+@lilypond[quote,verbatim]
+\score {
+ <<
+ \new Staff { a' a' a' a' }
+ \new Staff { g' g' g' g' }
+ >>
+}
+@end lilypond
+
+@node Advertencia de que una voz requiere ajustes voiceXx o shiftXx
+@unnumberedsubsec Advertencia de que una voz requiere ajustes @code{@bs{}voiceXx} o @code{@bs{}shiftXx}
+@translationof Warning this voice needs a voiceXx or shiftXx setting
+
+Si acontecen dos notas de distintas voces son plicas en la misma
+dirección y en el mismo momento musical, pero las voces no tienen
+especificado ningún desplazamiento de voz específico, aparece el
+mensaje @samp{advertencia: esta voz requiere ajustes \voiceXx o
+\shiftXx} cuando se compila el archivo de LilyPond. La
+advertencia aparece incluso si las notas no tienen plicas
+visibres, por ejemplo redondas, si las plicas de figuras más
+breves que tuviesen las misma altura, estuvieran en la misma
+dirección.
+
+Recuerde que la dirección de la plica depende de la posición de la
+nota sobre el pentagrama a no ser que la dirección de la plica
+venga especificada, por ejemplo mediante @code{\voiceOne}. En
+este caso, la advertencia aparece solamente cuando las plicas
+están en la misma dirección, es decir, cuando se encuentran en la
+misma mitad del pentagrama.
+
+Situando las notas en voces que tengan direcciones de plica y
+desplazamientos especificados, por ejemplo usando @code{\voiceOne}
+y otras instrucciones, se pueden evitar estos mensajes.
+
+Las notas que están en voces con numeración más alta,
+@code{\voiceThree} y siguientes, se desplazan automáticamente para
+evitar las colisiones entre columnas. Esto produce un
+desplazamient que es visible en las notas con plica, pero las
+redondas no se desplazan de forma visible a no ser que se produzca
+una verdadera colisión, o si las voces se cruzan respecto a su
+orden natural (cuando una voz con @code{\voiceThree} es más aguda
+que otra con @code{\voiceOne}, y casos semejantes).
+
+@seealso
+@rlearning{Voces explícitas},
+@rlearning{Ejemplos reales de música},
+@ruser{Polifonía en un solo pentagrama},
+@ruser{Resolución de las colisiones}.
projects / lilypond.git / blobdiff