@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
@c This file is part of lilypond-program.tely
@ignore
- Translation of GIT committish: e2fedc46142bc323d48e696848327c6c0e4c9ede
+ 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.
@end ignore
-@c \version "2.11.61"
+@c \version "2.12.0"
@node Running LilyPond
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.
@example
#(define output-suffix "violin")
-\book @{ @dots{} @}
+\score @{ @dots{} @}
#(define output-suffix "cello")
-\book @{ @dots{} @}
+\score @{ @dots{} @}
@end example
@noindent
@code{-dsafe} @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
+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.
@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
@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.
@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 ú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}.
+@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;
@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}
projects / lilypond.git / blobdiff