1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
4 Translation of GIT committish: 8a23eef94ec7ab83e10646ab3502f2d82b888a03
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. For details, see the Contributors'
8 Guide, node Updating translation committishes..
14 @node Actualizar ficheros con convert-ly
15 @chapter Actualizar ficheros con @command{convert-ly}
16 @translationof Updating files with convert-ly
18 @cindex actualización de un archivo de LilyPond
21 La sintaxis del lenguaje de entrada de LilyPond se modifica de forma
22 habitual para simplificarla o mejorarla de distintas maneras. Como
23 efecto secundario, el intérprete de LilyPond a menudo ya no es
24 compatible con los archivos de entrada antiguos. Para poner remedio a
25 esto se puede utilizar el programa @command{convert-ly} para manejar
26 casi todos los cambios de sintaxis entre versiones de LilyPond.
29 * ¿Por qué cambia la sintaxis?::
30 * Invocar convert-ly::
31 * Opciones de la línea de órdenes para convert-ly::
32 * Problemas con convert-ly::
33 * Conversiones manuales::
37 @node ¿Por qué cambia la sintaxis?
38 @section ¿Por qué cambia la sintaxis?
39 @translationof Why does the syntax change?
42 @cindex actualizar archivos de entrada antiguos
44 La sintaxis de la entrada de LilyPond cambia de manera ocasional. A
45 medida que el propio LilyPond mejora, la sintaxis (el lenguaje de la
46 entrada) se modifica en consonancia. A veces estos cambios se hacen
47 para conseguir que la entrada sea más fácil de leer y escribir, y
48 otras veces estos cambios son para dar cabida a nuevas funcionalidades
51 Por ejemplo, se supone que todos los nombres de las propiedades de
52 @code{\paper} y de @code{\layout} están escritos en la dorma
53 @code{primero-segundo-tercero}. Sin embargo, en la versión 2.11.60,
54 observamos que la propiedad @code{printallheaders} no seguía esta
55 convención. ¿Deberíamos dejarla como está (confundiendo a los nuevos
56 usuarios que tienen que tratar con un formato de entrada
57 inconsistente), o cambiarla (fastidiando a los usuarios con
58 experiencia que tienen partituras antiguas)? En este caso, decidimos
59 cambiar el nombre a @code{print-all-headers}. Afortunadamente, este
60 cambio se puede automatizar con nuestra herramienta
63 Sin embargo, lamentablemente @code{convert-ly} no puede tratar todos
64 los cambios en la entrada. Por ejemplo, en la versión 2.4 y
65 anteriores de LilyPond, los acentos y las letras no inglesas se
66 introducían utilizando LaTeX: por ejemplo, @code{No\"el} (que
67 significa @q{Navidad} en francés). En LilyPond 2.6 y siguientes, el
68 carácter especial @code{ë} debe introducirse directamente en el
69 archivo de LilyPond como un carácter UTF-8. @code{convert-ly} no
70 puede cambiar todos los caracteres especiales de LaTeX a caracteres de
71 UTF-8; tendrá que actualizar manualmente sus archivos de LilyPond
75 @node Invocar convert-ly
76 @section Invocar @command{convert-ly}
77 @translationof Invoking convert-ly
79 @command{convert-ly} utiliza los enunciados @code{\version} de los
80 archivos de entrada para detectar el número de versión antiguo. En
81 casi todos los casos, para actualizar el archivo de entrada basta con
85 convert-ly -e miarchivo.ly
89 dentro del directorio que contiene el archivo. Con esto se actualiza
90 @file{miarchivo.ly} @emph{in situ} y se preserva el archivo original
93 @warning{@command{convert-ly} siempre convierte hasta el último cambio
94 de sintaxis que es capaz de manejar. Esto significa que el número de
95 @code{\version} que aparece en el archivo convertido suele ser
96 inferior al número de versión del propio programa
97 @command{convert-ly}.}
99 Para convertir de una vez todos los archivos de entrada que hay en un
106 De forma alternativa, si queremos especificar un nombre distinto para
107 el archivo actualizado, preservando el archivo original con el mismo
111 convert-ly miarchivo.ly > minuevoarchivo.ly
114 El programa imprime una relación de los números de versión para los
115 que se han hecho conversiones. Si no se imprime ningún número de
116 versión, el archivo ya está actualizado.
119 Los usuarios de MacOS@tie{}X pueden ejecutar esta instrucción bajo el
120 menú @code{Compilar > Actualizar sintaxis}.
122 Los usuarios de Windows deben introducir esta instrucción en una
123 ventana del terminal del sistema, que se encuentra por lo general bajo
124 @code{Inicio > Accesorios > Símbolo del sistema}.
127 @node Opciones de la línea de órdenes para convert-ly
128 @section Opciones de la línea de órdenes para @command{convert-ly}
129 @translationof Command line options for convert-ly
131 En general, el programa se invoca de la manera siguiente:
134 convert-ly [@var{opción}]@dots{} @var{archivo}@dots{}
137 Se pueden dar las siguientes opciones:
140 @item -d,--diff-version-update
141 actualizar la @code{\version} a la última o, si ésta es mayor, no
145 Aplicar las conversiones directamente al archivo de entrada,
146 modificándolo in situ.
148 @item -f,--from=@var{versión_de_origen}
149 Establece la versión desde la que convertir. Si no aparece esta
150 opción, @command{convert-ly} tratará de adivinarla, basándose en el
151 enunciado @code{\version} del archivo. Ejemplo: @option{--from=2.10.25}
154 Imprimir la ayuda de utilización.
156 @item -l @var{loglevel}, --loglevel=@var{loglevel}
157 Fijar el grado en que la salida es prolija a @var{loglevel}. Los
158 valores posibles son @code{NONE} (ninguno), @code{ERROR} (errores),
159 @code{WARNING} (advertencias), @code{PROGRESS} (avance;
160 predeterminado) y @code{DEBUG} (depuración).
162 @item -n,--no-version
163 Normalmente @command{convert-ly} añade un indicador @code{\version} a
164 la salida. La especificación de esta opción lo suprime.
166 @item -s, --show-rules
167 Mostrar todas las conversiones conocidas y salir.
169 @item -t, --to=@var{versión_final}
170 Fijar explícitamente a qué @code{\version} convertir, en caso
171 contrario el valor predeterminado es la versión más actual.
174 convert-ly --to=2.14.1 miarchivo.ly
179 Para actualizar fragmentos de LilyPond en archivos de texinfo, use
182 convert-ly --from=... --to=... --no-version *.itely
185 Para ver los cambios en la sintaxis de LilyPond entre dos versiones
189 convert-ly --from=... --to=... -s
193 @node Problemas con convert-ly
194 @section Problemas con @code{convert-ly}
195 @translationof Problems running convert-ly
197 Al ejecutar convert-ly en una ventana del Símbolo del Sistema bajo
198 Windows sobre un archivo que tiene espacios en el nombre o en la ruta,
199 es necesario encerrar todo el nombre del archivo de entrada con tres
200 (!) pares de comillas:
203 convert-ly """D:/Mis partituras/Oda.ly""" > "D:/Mis partituras/nueva Oda.ly"
206 Si la orden simple @command{convert-ly -e *.ly} no funciona porque la
207 instrucción expandida se hace muy larga, en vez de ello la orden
208 @command{convert-ly} se puede poner dentro de un bucle. Este ejemplo
209 para UNIX actualiza todos los documentos @file{.ly} del directorio
213 for f in *.ly; do convert-ly -e $f; done;
216 En la ventana del terminal de órdenes de Windows, la instrucción
220 for %x in (*.ly) do convert-ly -e """%x"""
223 No se manejan todos los cambios en el lenguaje. Sólo se puede
224 especificar una opción de salida. La actualización automática de
225 Scheme y los interfaces Scheme de LilyPond es bastante improbable;
226 prepárese para trucar el código de Scheme a mano.
228 @node Conversiones manuales
229 @section Conversiones manuales
230 @translationof Manual conversions
232 En teoría, un programa como @command{convert-ly} debería poder tratar
233 cualquier cambio en la sintaxis. Después de todo, un programa de
234 ordenador interpreta las versiones antigua y nueva, por lo que otro
235 programa de ordenador podría traducir un archivo al otro@footnote{Al
236 menos, esto es posible en cualquier archivo de LilyPond que no
237 contenga Scheme. Si hay Scheme dentro del archivo, contiene un
238 lenguaje Turing-completo, y nos encontramos con el famoso @qq{Problema
239 de la parada} en informática.}.
241 Sin embargo, el proyecto LilyPond cuenta con unos recursos limitados:
242 no todas las conversiones se efectúan automáticamente. A continuación
243 aparece una lista de los problemas conocidos.
248 No siempre convierte el bajo cifrado correctamente, específicamente cosas como {<
249 >}. El comentario de Mats sobre cómo solventar el problema:
250 Para poder ejecutar convert-ly
251 sobre él, primero sustituí todas las apariciones de '{<' a algo mudo como '{#'
252 y de forma similar sustituí '>}' con '&}'. Después de la conversión, pude
253 volver a cambiarlos de '{ #' a '{ <' y de '& }' a '> }'.
254 No convierte todos los marcados de texto correctamente. En sintaxis antigua,
255 se podían agrupar varios marcados entre paréntesis, p.ej.
256 -#'((bold italic) "cadena")
257 Esto se convierte incorrectamente en
258 -\markup{{\bold italic} "cadena"}
260 -\markup{\bold \italic "cadena"}
262 No maneja \partcombine
263 No hace \addlyrics => \lyricsto, esto rompe algunas partituras con varias estrofas.
265 \magnify no se cambia por \fontsize.
266 - \magnify #m => \fontsize #f, donde f = 6ln(m)/ln(2)
267 remove-tag no se cambia.
268 - \applyMusic #(remove-tag '. . .) => \keepWithTag #'. . .
269 first-page-number no se cambia.
270 - first-page-number no => print-first-page-number = ##f
271 Los saltos de línea en las cadenas de cabecera no se convierten.
272 - \\\\ como salto de línea en las cadenas de \header => \markup \center-align <
273 "Primera línea" "Segunda línea" >
274 Los terminadores de crescendo y decrescendo no se convierten.
278 \turnOff (usado en \set Staff.VoltaBracket = \turnOff) no se convierte
281 \markup{ \center-align <{ ... }> } se tendría que convertir en:
282 \markup{ \center-align {\line { ... }} }
283 pero ahora, falta el \line.
285 Los caracteres especiales de LaTeX como $~$ en el texto no se convierten a UTF8.
287 \score{} ahora debe empezar con una expresión musical. Cualquier otra cosa
288 (en particular, \header{}) debe ir después de la música.