@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
@c This file is part of lilypond-program.tely
@ignore
- Translation of GIT committish: 41ef91786a08102d9b9a839f6a2f40cec263d723
+ Translation of GIT committish: 45945bd973aa9161b10e3f517902afb7ef4b4a56
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
@example
#(define output-suffix "violin")
-\book @{ @dots{} @}
+\score @{ @dots{} @}
#(define output-suffix "cello")
-\book @{ @dots{} @}
+\score @{ @dots{} @}
@end example
@noindent
@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.
- 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/}.
+ para obtener SVG (gráficos vectoriales escalables).
+
+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/}.
+
@item scm
@cindex Scheme, volcado de
para obtener un volcado de las instrucciones internas de dibujo
@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
-
-@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}.
-
-Si no hay cambios en miarchivo.ly y se crea el archivo llamado
-miarchivo.ly.NEW, entonces miarchivo.ly ya está actualizado.
-
@menu
+* Invoking convert-ly::
* Command line options for convert-ly::
* Problems with convert-ly::
@end menu
-@node Command line options for convert-ly
-@subsection Command line options for @command{convert-ly}
-
-@command{convert-ly} convierte siempre al último cambio de sintaxis
-que puede manejar. Esto 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}.
+@node Invoking convert-ly
+@subsection Invoking @command{convert-ly}
-Para actualizar fragmentos de LilyPond en archivos de texinfo, use
+@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 --from=... --to=... --no-version *.itely
+convert-ly -e miarchivo.ly
@end example
-Para ver los cambios en la sintaxis de LilyPond entre dos versiones,
-use
+@noindent
+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~}.
+
+Para convertir de una vez todos los archivos de entrada que hay en un
+directorio, use
@example
-convert-ly --from=... --to=... -s
+convert-ly -e *.ly
@end example
-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:
+
+De forma alternativa, si queremos especificar un nombre distinto para
+el archivo actualizado, preservando el archivo original con el mismo
+nombre, haga
@example
-for f in *.ly; do convert-ly -e $f; done;
+convert-ly miarchivo.ly > minuevoarchivo.ly
@end example
+@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}.
+
+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.
+
+@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}
+
+
En general, el programa se invoca de la manera siguiente:
@example
@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
+
+@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}
+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;