X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fes%2Fuser%2Frunning.itely;h=9582a13ba600d93603f232e8256d2967f81e8063;hb=1423508c355989fa26a8cfe5985b0d6e1ab0a538;hp=1b32e6904c39f89a9bb69a51ead8c82ee262638a;hpb=63f252b1f07ed6d76abbefe0f77bbeef1dd831ed;p=lilypond.git diff --git a/Documentation/es/user/running.itely b/Documentation/es/user/running.itely index 1b32e6904c..9582a13ba6 100644 --- a/Documentation/es/user/running.itely +++ b/Documentation/es/user/running.itely @@ -1,7 +1,7 @@ @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*- @c This file is part of lilypond-program.tely @ignore - Translation of GIT committish: 3a8b7fa74c14101cb93d75e541f5afdb18f09239 + 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. @@ -240,16 +240,18 @@ Este modo se usa de forma predeterminada por parte de @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 @@ -495,8 +497,6 @@ de comprobar una o dos líneas por encima de la posición indicada. @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 @@ -506,55 +506,67 @@ compatible con los archivos de entrada antiguos. Para poner remedio a 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 @@ -566,13 +578,13 @@ Se pueden dar las siguientes opciones: @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 @@ -589,10 +601,49 @@ se convierte a la última versión disponible. 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;