@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
@c This file is part of lilypond-program.tely
@ignore
- Translation of GIT committish: 428e134611498913292fb4903602fec97a8a9b65
+ Translation of GIT committish: 50b88336f4c69d7d3241cc01af98c362cd9d2b4b
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
@end ignore
-@c \version "2.11.57"
+@c \version "2.12.0"
@node Running LilyPond
familiarizados con los términos @q{ventana de MS-DOS} o @q{línea de
comandos}; Los usuarios de MacOS@tie{}X puede que estén más
familiarizados con los términos @q{terminal} o @q{consola}. Éstos
-deberían consultar también el apartado @ref{MacOS X on the
-command-line}.
+deberían consultar también el apartado @ref{Setup for MacOS X}.
La descripción del uso de esta parte de los sistemas operativos se
-sale del ámbito de este manuual; le rogamos que consulte otros
+sale del ámbito de este manual; le rogamos que consulte otros
documentos sobre este tema si no le resulta familiar la línea de
órdenes.
@menu
* Invoking lilypond::
-* Command line options::
+* Command line options for lilypond::
* Environment variables::
@end menu
@node Invoking lilypond
-@subsection Invoking lilypond
+@subsection Invoking @command{lilypond}
-@cindex invocar a LilyPond
-@cindex opciones de la línea de órdenes
+@cindex invocar @command{lilypond}
+@cindex opciones de la línea de órdenes para @command{lilypond}
@cindex órdenes, opciones de la línea de
El ejecutable @command{lilypond} se puede llamar desde la línea de
@example
#(define output-suffix "violin")
-\book @{ @dots{} @}
+\score @{ @dots{} @}
#(define output-suffix "cello")
-\book @{ @dots{} @}
+\score @{ @dots{} @}
@end example
@noindent
@var{base}@file{-cello-1.pdf}.
-@node Command line options
-@subsection Command line options
+@node Command line options for lilypond
+@subsection Command line options for @command{lilypond}
Están contempladas las siguientes opciones:
al principio del archivo @code{.ly}.
@item -f,--format=@var{formato}
-Qué formatos se tienen que escribir. Como @code{formato} se puede
-elegir entre @code{svg}, @code{ps}, @code{pdf}, @code{png}, @code{tex}
-y @code{dvi}.
+Formato de la salida. Como @code{formato} se puede elegir entre
+@code{svg}, @code{ps}, @code{pdf} y @code{png}.
-Ejemplo: @code{lilypond -fpng archivo.ly}
+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
Observe que la cadena se debe incluir dentro de comillas escapadas
( @code{\"} ).
+@c Match " in previous line to help context-sensitive editors
@item safe
No confiar en la entrada @code{.ly}.
En el modo seguro, no es posible la importación de variables de
LilyPond dentro de Scheme.
-safe @emph{no} detecta la sobreutilización de recursos. Aún es
-posible hacer que el programa se cuelgue indefinidamente, por ejemplo
-alimentándo el backend con estructuras de datos cíclicas. Por tanto,
-si se está utilizando LilyPond sobre un servidor web accesible
+@code{-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.
LilyPond se puedan compilar. La opción @code{--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 tex
-para una salida en @TeX{} con destino a su proceso por parte de
-La@TeX{}. Si el archivo @file{file.textmetrics} está presente, se lee
-para determinar las dimensiones del texto.
-@item texstr
-volcar cadenas de texto en un archivo @file{.texstr}, que se puede
-procesar con (La)@TeX{}, dando como resultado un archivo
-@code{.textmetrics} que contiene las dimensiones de las cadenas de
-texto. @strong{Arvertencia:} esta funcionalidad no está disponible
-actualmente debido a la profunda reestructuración del código fuente.
@item ps
-para PostScript.
-
@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
y como un solo archivo @file{EPS} encuadernado con todas las
páginas/sistemas con las tipografías incluidas.
-Este modo se usa de forma predeterminada por parte de lilypond-book.
+Este modo se usa de forma predeterminada por parte de
+@command{lilypond-book}.
@item svg
+@cindex SVG (Scalable Vector Graphics)
para obtener SVG (gráficos vectoriales escalables). Vuelca cada
página como un archivo @file{SVG} distinto, con las tipografías
incrustadas.
-@cindex SVG (gráficos vectoriales escalables)
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 que están en el directorio
-@file{RUTA/HACIA/share/lilypond/VERSIÓN/fonts/otf/} al directorio
-@file{~/.fonts/}.
+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/}.
@item scm
+@cindex Scheme, volcado de
para obtener un volcado de las instrucciones internas de dibujo
basadas en Scheme, en bruto.
-@cindex Scheme, volcado de
+@item null
+ no producir una salida impresa; tiene el mismo efecto que @code{-dno-print-pages}.
@end table
-Ejemplo: @code{lilypond -dbackend=svg archivo.ly}
-
-@cindex salida, establecer el formato de
+Ejemplo: @code{lilypond -dbackend=svg @var{archivo}.ly}
@item preview
Generar un archivo de salida que contenga solamente los títulos de
@item -h,--help
Mostrar un resumen de las formas de utilización.
-@item -H,--header=CAMPO
-Volcar un campo de cabecera al archivo NOMBREBASE.CAMPO
+@item -H,--header=@var{CAMPO}
+Volcar un campo de cabecera al archivo @file{NOMBREBASE.@var{CAMPO}}
@item --include, -I=@var{directorio}
Añadir el @var{directorio} a la ruta de búsqueda de archivos de
@item -o,--output=@var{ARCHIVO}
Establecer el nombre del archivo de salida predeterminado a
-@var{ARCHIVO}. Se añade el sufijo correspondiente (es decir,
-@code{.pdf} para PDF, @code{.tex} para TeX, etc.).
+@var{ARCHIVO}. Se añade el sufijo correspondiente (por ejemplo,
+@code{.pdf} para PDF).
@item --ps
Generar PostScript.
-@item --dvi
-Generar archivos DVI files. En este caso se debe especificar el
-backend @TeX{}, es decir: @code{-dbackend=tex}.
-
@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
@item --pdf
Generar PDF. Implica @code{--ps}.
-
-
@item -j,--jail=@var{usuario},@var{grupo},@var{jaula},@var{directorio}
Ejecutar @command{lilypond} en una jaula de chroot.
@cindex llamadas, traza de
@cindex Scheme, error de
@cindex error de Scheme
-Los errores que ocurren al ejecutar código de Schheme se interceptan
+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
una traza de llamadas de la función ofensiva.
@node Updating files with convert-ly
-@section Updating with @command{convert-ly}
+@section Updating files with @command{convert-ly}
@cindex actualización de un archivo de LilyPond
-@cindex version
-@cindex versión de los archivos
@cindex convert-ly
La sintaxis del lenguaje de entrada de LilyPond se modifica de forma
esto se puede utilizar el programa @command{convert-ly} para manejar
casi todos los cambios de sintaxis entre versiones de LilyPond.
-Utiliza los enunciados @code{\version} de los archivos de entrada para
-detectar el número de versión antiguo. En casi todos los casos, para
-actualizar el archivo de entrada basta con ejecutar
+@menu
+* Invoking convert-ly::
+* Command line options for convert-ly::
+* Problems with convert-ly::
+@end menu
+
+@node Invoking convert-ly
+@subsection Invoking @command{convert-ly}
+
+@command{convert-ly} utiliza los enunciados @code{\version} de los
+archivos de entrada para detectar el número de versión antiguo. En
+casi todos los casos, para actualizar el archivo de entrada basta con
+ejecutar
@example
convert-ly -e miarchivo.ly
@end example
@noindent
-Los usuarios de MacOS@tie{}X pueden ejecutar esta instrucción bajo el
-menú @code{Compilar > Actualizar sintaxis}.
+dentro del directorio que contiene el archivo. Con esto se actualiza
+@code{miarchivo.ly} @emph{in situ} y se preserva el archivo original
+@code{miarchivo.ly~}.
-Si no hay cambios en miarchivo.ly y se crea el archivo llamado
-miarchivo.ly.NEW, entonces miarchivo.ly ya está actualizado.
+Para convertir de una vez todos los archivos de entrada que hay en un
+directorio, use
-@subsection Command line options
+@example
+convert-ly -e *.ly
+@end example
-@command{convert-ly} convierte siempre al últimmo cambio de sintaxis
-que puede manejar. Eesto supone que el número de @code{\version} que
-aparece en el archivo convertido suele ser más bajo que la versión del
-propio programa @command{convert-ly}.
-Para actualizar fragmentos de LilyPond en archivos de texinfo, use
+De forma alternativa, si queremos especificar un nombre distinto para
+el archivo actualizado, preservando el archivo original con el mismo
+nombre, haga
@example
-convert-ly --from=... --to=... --no-version *.itely
+convert-ly miarchivo.ly > minuevoarchivo.ly
@end example
-Para ver los cambios en la sintaxis de LilyPond entre dos versiones,
-use
+@command{convert-ly} siempre convierte al último cambio de sintaxis
+que es capaz de manejar. Esto supone que el número de @code{\version}
+que aparece en el archivo convertidoo suele ser más bajo que la
+versión del propio programa @command{convert-ly}.
-@example
-convert-ly --from=... --to=... -s
-@end example
+El programa imprimirá una relación de los números de versión para los
+que se han hecho conversiones. Si no se imprime ningún número de
+versión, el archivo ya está actualizado.
-Para actualizar muchos archivos de una vez, combine @code{convert-ly}
-con las instrucciones estándar de UNIX. Este ejemplo actualiza todos
-los archivos @code{.ly} del directorio actual:
+@noindent
+Los usuarios de MacOS@tie{}X pueden ejecutar esta instrucción bajo el
+menú @code{Compilar > Actualizar sintaxis}.
+
+Los usuarios de Windows deben introducir esta instrucción en una
+ventana del terminal del sistema, que se encuentra por lo general bajo
+@code{Inicio > Accesorios > Símbolo del sistema}.
+
+
+@node Command line options for convert-ly
+@subsection Command line options for @command{convert-ly}
-@example
-for f in *.ly; do convert-ly -e $f; done;
-@end example
En general, el programa se invoca de la manera siguiente:
@table @code
@item -e,--edit
-Hace una edición en línea del archivo de entrada. Sobreescribe a
-@code{--output}.
+Aplicar las conversiones directamente al archivo de entrada,
+modificándolo in situ.
@item -f,--from=@var{versión_de_origen}
Establece la versión desde la que convertir. Si no aparece esta
opción, @command{convert-ly} tratará de adivinarla, basándose en el
-enunciado @code{\version} del archivo.
+enunciado @code{\version} del archivo. Ejemplo: @code{--from=2.10.25}
@item -n,--no-version
Normalmente @command{convert-ly} añade un indicador @code{\version} a
Imprimir la ayuda de la utilización.
@end table
+Para actualizar fragmentos de LilyPond en archivos de texinfo, use
-@menu
-* Problems with convert-ly::
-@end menu
+@example
+convert-ly --from=... --to=... --no-version *.itely
+@end example
+
+Para ver los cambios en la sintaxis de LilyPond entre dos versiones
+dadas, use
+
+@example
+convert-ly --from=... --to=... -s
+@end example
@node Problems with convert-ly
@subsection Problems with @code{convert-ly}
-No se manejan todos los cambios en el lenguaje. S´olo se puede
+Al ejecutar convert-ly en una ventana del Símbolo del Sistema bajo
+Windows sobre un archivo que tiene espacios en el nombre o en la ruta,
+es necesario encerrar todo el nombre del archivo de entrada con tres
+(!) pares de comillas:
+
+@example
+convert-ly """D:/Mis partituras/Oda.ly""" > "D:/Mis partituras/nueva Oda.ly"
+@end example
+
+Si la orden simple @command{convert-ly -e *.ly} no funciona porque la
+instrucción expandida se hace muy larga, en vez de ello la orden
+@command{convert-ly} se puede poner dentro de un bucle. Este ejemplo
+para UNIX actualiza todos los documentos @code{.ly} del directorio
+actual
+
+@example
+for f in *.ly; do convert-ly -e $f; done;
+@end example
+
+En la ventana del terminal de órdenes de Windows, la instrucción
+correspondiente es
+
+@example
+for %x in (*.ly) do convert-ly -e """%x"""
+@end example
+
+No se manejan todos los cambios en el lenguaje. Sólo se puede
especificar una opción de salida. La actualización automática de
Scheme y los interfaces Scheme de LilyPond es bastante improbable;
prepárese para trucar el código de Scheme a mano.
@uref{http://code.google.com/p/lilypond/issues/list}
-Si descubre un error que no está en la lista, le rogramos que envíe un
+Si descubre un error que no está en la lista, le rogamos que envíe un
informe del fallo siguiendo las instrucciones que aparecen en
@uref{http://lilypond.org/web/devel/participating/bugs}