Documentation/es/user/converters.itely

   1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
   2 @c This file is part of lilypond-program.tely
   3 @ignore
   4     Translation of GIT committish: 8395394885b0ca29aab681a275f7ba395ea436d5
   5
   6     When revising a translation, copy the HEAD committish of the
   7     version that you are working on.  See TRANSLATION for details.
   8 @end ignore
   9
  10 @c \version "2.11.51"
  11
  12 @node Converting from other formats
  13 @chapter Converting from other formats
  14
  15 También se puede escribir la música a través de su importación desde
  16 otros formatos.  Este capítulo trata de documentar las herramientas
  17 incluidas en la dirstribución que permiten hacerlo.  Existen otras
  18 herramientas que producen código de entrada de LilyPond, como por
  19 ejemplo secuenciadores con interfaz gráfico y comvertidores de XML.
  20 Consulte el @uref{http://@/lilypond@/.org,website} para ver más
  21 detalles.
  22
  23 Son programas distintos a @command{lilypond} propiamente dicho, y se
  24 ejecutan desde la línea de órdenes; consulte @ref{Command-line usage}
  25 para ver más información.
  26
  27
  28 @knownissues
  29 Por desgracia no disponemos de los recursos necesarios para poder
  30 mantener estos programas; le rogramos que los tome @qq{tal cual
  31 están}.  Se agradecerá el envío de parches correctores, pero los
  32 informes de fallo casi con certeza no se resolverán a medio plazo.
  33
  34 @menu
  35 * Invoking midi2ly::            Importar archivos MIDI.
  36 * Invoking musicxml2ly::        Importar archivos MusicXML.
  37 * Invoking abc2ly::             Importar archivos ABC.
  38 * Invoking etf2ly::             Importar archivos de Finale.
  39 * Generating LilyPond files::   Interfaces gráficos, transcriptores y programas de composición algorítmica.
  40 @end menu
  41
  42
  43
  44 @node Invoking midi2ly
  45 @section Invoking @command{midi2ly}
  46
  47 @cindex MIDI
  48
  49 @command{midi2ly} traduce un archivo MIDI de tipo@tie{}1 a un acrhivo
  50 de código fuente de LilyPond.
  51
  52 El MIDI (Music Instrument Digital Interface, Interfase Digital para
  53 Instrumentos Musicales) es un estándar para instrumentos digitales:
  54 especifica la interconexión física, un protocolo en serie y un formato
  55 de archivo.  El formato de archivo MIDI es un formato estándar de
  56 facto para exportar música de otros programas, por lo que esta
  57 posibilidad puede ser de utilidad al importar archivos de un programa
  58 que tiene un convertidor para un formato directo.
  59
  60 @command{midi2ly} convierte las pistas en contextos de
  61 @rinternals{Staff}) y los canales en contextos de
  62 @rinternals{Voice}.  Se utiliza el modo relativo para las alturas, y
  63 las duraciones se escriben solamente cuando es necesario.
  64
  65 Es posible grabar un archivo MIDI usando un teclado digital y
  66 convertirlo después a @file{.ly}.  Sin embargo, los intérpretes
  67 humanos no son lo suficientemente exactos desde el punto de vista
  68 rítmico como para hacer que sea trivial la conversión de MIDI a LY.
  69 Si se invoca con las opciones de cuantización (@code{-s} y @code{-d}),
  70 @command{midi2ly} intenta compensar los errores de medida, pero no lo
  71 hace muy bien.  Por ello, no se recomienda usar @command{midi2ly} para
  72 archivos midi generados por seres humanos.
  73
  74
  75 Se invoca a partir de la línea de órdenes como sigue:
  76 @example
  77 midi2ly [@var{opción}]@dots{} @var{archivo_midi}
  78 @end example
  79
  80 Observe que al decir @q{línea de órdenes}, queremos decir la línea de
  81 órdenes del sistema operativo.  Consulte @ref{Converting from other
  82 formats} para ver más información sobre esto.
  83
  84 @command{midi2ly} contempla las siguientes opciones:
  85
  86 @table @code
  87 @item -a, --absolute-pitches
  88 Imprimir alturas absoultas.
  89
  90 @item -d, --duration-quant=@var{DURACIÓN}
  91 Cuantizar las duraciones a @var{DURACIÓN}.
  92
  93 @item -e, --explicit-durations
  94 Imprimir valores de figura explícitos.
  95
  96 @item -h,--help
  97 Mostrar un resumen de las instrucciones de utilización.
  98
  99 @item -k, --key=@var{alteración}[:@var{minor}]
 100 Establecer la tonalidad predeterminada. @math{@var{alteración} > 0}
 101 establece el número de sostenidos; @math{@var{alteración} < 0}
 102 establece el número de bemoles.  Se indica una tonalidad menor
 103 mediante @code{:1}.
 104
 105 @item -o, --output=@var{archivo}
 106 Escribir la salida en @var{archivo}.
 107
 108 @item -s, --start-quant=@var{DURACIÓN}
 109 Cuantizar el inicio de las notas a @var{DURACIÓN}.
 110
 111 @item -t, --allow-tuplet=@var{DURACIÓN}*@var{NUMERADOR}/@var{DENOMINADOR}
 112 Permitir duraciones de grupos especiales @var{DURACIÓN}*@var{NUMERADOR}/@var{DENOMINADOR}.
 113
 114 @item -v, --verbose
 115 Ser prolijo en comentarios.
 116
 117 @item -V, --version
 118 Imprimir el número de la versión.
 119
 120 @item -w, --warranty
 121 Presentar la garantía y el  copyright.
 122
 123 @item -x, --text-lyrics
 124 Tratar todos los textos como letra de la canción.
 125 @end table
 126
 127
 128 @knownissues
 129
 130 Las notas superpuestas en un arpegio no se procesarán correctamente.
 131 La primera nota se lee y el resto se ignoran.  Aplique la misma
 132 duración a todas las notas y añada marcas de fraseo o indicaciones de
 133 pedal.
 134
 135
 136 @node Invoking musicxml2ly
 137 @section Invoking @code{musicxml2ly}
 138
 139 @cindex MusicXML
 140
 141 @uref{http://@/www.@/musicxml@/.org/,MusicXML} es un
 142 dialecto del XML para representar notación musical.
 143
 144 @command{musicxml2ly} extrae las notas, articulaciones, estructura de
 145 la partitura, letra, etc., de archivos de MusicXML parte a parte, y
 146 los escribe en un archivo .ly.  Se invoca a través de la línea de
 147 órdenes.
 148
 149 La invocación desde la línea de órdenes se hace como sigue:
 150
 151 @example
 152 musicxml2ly [@var{opción}]@dots{} @var{archivo_xml}
 153 @end example
 154
 155 Observe que por @q{línea de órdenes}, nos referimos a la línea de
 156 órdenes del sistema operativo.  Consulte @ref{Converting from other
 157 formats}, para obtener más información acerca de esto.
 158
 159 Si el nombre de archivo proporcionado es @file{-},
 160 @command{musicxml2ly} lee la entrada desde la entrada estándar.
 161
 162 @command{musicxml2ly} contempla las siguientes opciones:
 163
 164 @table @code
 165 @item -a, --absolute
 166 convertir las alturas en modo absoluto.
 167
 168 @item -h,--help
 169 mostrar un resumen de la utilización y las opciones.
 170
 171 @item -l, --language=IDIOMA
 172 utilizar un archivo de idioma distinto 'IDIOMA.ly' y los
 173 correspondientes nombres de nota, p.ej. 'deutsch' para deutsch.ly y
 174 los nombres de nota en alemán.
 175
 176 @item --lxml
 177 usar el paquete de Python lxml.etree para el análisis de XML; usa
 178 menos memoria y tiempo de CPU.
 179
 180 @item --nd --no-articulation-directions
 181 no convertir las direcciones (@code{^}, @code{_} o @code{-}) para las
 182 articulaciones, dinámica, etc.
 183
 184 @item --no-beaming
 185 no convertir la información de las barras, en vez de ello usar el
 186 barrado automático de LilyPond.
 187
 188 @item -o,--output=@var{archivo}
 189 fijar el nombre del archivo de salida como @var{archivo}. Si
 190 @var{archivo} es @file{-}, la salida se imprime sobre stdout, la
 191 salida estándar.  Si no se da, se usa @var{archivo_xml}@file{.ly}.
 192
 193 @item -r,--relative
 194 convertir las alturas en modo relativo (predeterminado).
 195
 196 @item -v,--verbose
 197 ser prolijo.
 198
 199 @item -v,--version
 200 imprimir la información de la versión.
 201
 202 @item -z,--compressed
 203 el archivo de entrada es un archivo MusicXML comprimido en zip.
 204 @end table
 205
 206
 207
 208 @node Invoking abc2ly
 209 @section Invoking @code{abc2ly}
 210
 211 @cindex ABC
 212
 213 ABC es un formato bastante simple basado en ASCII.  Se encuentra
 214 descrito en el sitio web de ABC:
 215
 216 @quotation
 217 @uref{http://@/www@/.walshaw@/.plus@/.com/@/abc/@/learn@/.html}.
 218 @end quotation
 219
 220 @command{abc2ly} convierte ABC en LilyPond.  Se invoca de la siguiente
 221 manera:
 222
 223 @example
 224 abc2ly [@var{opción}]@dots{} @var{archivo_abc}
 225 @end example
 226
 227 @command{abc2ly} contempla las siguientes opciones:
 228
 229 @table @code
 230 @item -b,--beams=None
 231 preservar la noción de ABC de las barras
 232 @item -h,--help
 233 esta ayuda
 234 @item -o,--output=@var{archivo}
 235 fijar el nombre del archivo de salida como @var{archivo}.
 236 @item -s,--strict
 237 ser estricto respecto al éxito
 238 @item --version
 239 imprimir la infomación de la versión.
 240 @end table
 241
 242 Existe una posibilidad rudimentaria para añadir código de LilyPond el
 243 archivo fuente de ABC.  Si decimos:
 244
 245 @example
 246 %%LY voices \set autoBeaming = ##f
 247 @end example
 248
 249 Producirá que el texto que sigue a la palabra clave @q{voices} se
 250 inserte en la voz en curso del archivo de salida de LilyPond.
 251
 252 De forma similar,
 253
 254 @example
 255 %%LY slyrics más palabras
 256 @end example
 257
 258 producirá que el texto que sigue a la palabra clave @q{slyrics} se
 259 inserte en la línea de letra en curso.
 260
 261
 262 @knownissues
 263
 264 El estándar ABC no es muy @q{estándar}.  Existen diferentes
 265 convenciones para las posibilidades avanzadas (por ejemplo,
 266 polifonía).
 267
 268
 269 No se pueden convertir varias melodías de un solo archivo.
 270
 271 ABC sincroniza las letras y las notas al principio de una línea;
 272 @command{abc2ly} no lo hace.
 273
 274 @command{abc2ly} ignora el barrado de ABC.
 275
 276
 277 @node Invoking etf2ly
 278 @section Invoking @command{etf2ly}
 279
 280 @cindex ETF
 281 @cindex enigma
 282 @cindex Finale
 283 @cindex Coda Technology
 284
 285 ETF (Enigma Transport Format) es un formato utilizado por Finale, un
 286 producto de Coda Music Technology.  @command{etf2ly} convierte parte
 287 de un archivo ETF en un archivo de LilyPond listo para usar.
 288
 289 Se invoca a través de la línea de órdenes como sigue:
 290
 291 @example
 292 etf2ly [@var{opción}]@dots{} @var{archivo_etf}
 293 @end example
 294
 295 Observe que por @q{línea de órdenes}, nos referimos a la línea de
 296 órdenes del sistema operativo.  Consulte @ref{Converting from other
 297 formats}, para obtener más información acerca de esto.
 298
 299 @command{etf2ly} contempla las siguientes opciones:
 300
 301 @table @code
 302 @item -h,--help
 303 esta ayuda
 304 @item -o,--output=@var{ARCHIVO}
 305 fijar el nombre del archivo de salida como @var{ARCHIVO}
 306 @item --version
 307 información de la versión
 308 @end table
 309
 310
 311 @knownissues
 312
 313 La lista de inscripciones de articulación posibles es incompleta.  Los
 314 compases vacíos confunden a @command{etf2ly}.  Las secuencias de notas
 315 de adorno no se dan por finalizadas satisfactoriamente.
 316
 317
 318 @node Generating LilyPond files
 319 @section Generating LilyPond files
 320
 321 @cindex programas externos, generación de archivos de LilyPond
 322
 323 El propio LilyPond no contempla la utilización de ningún otro formato,
 324 pero existen algunas herramientas externas que también generan
 325 archivos de LilyPond.
 326
 327 Entre ellas se encuentran las siguientes:
 328
 329 @itemize
 330 @item
 331 @uref{http://@/denemo@/.sourceforge@/.net/,Denemo}, editor de partituras gráfico.
 332 @item
 333 @uref{http://www@/.volny@/.cz/smilauer/rumor/rumor@/.html,Rumor},
 334 convertidor monofónico de MIDI a LilyPond en tiempo real.
 335 @item
 336 @uref{http://nicolas@/.sceaux@/.free@/.fr/lilypond/lyqi@/.html,lyqi},
 337 un modo principal para Emacs.
 338 @item
 339 @uref{http://@/www@/.nongnu@/.org/@/xml2ly/,xml2ly}, que importa
 340 @uref{http://@/www@/.musicxml@/.com/xml@/.html,MusicXML}.
 341 @item
 342 @uref{http://@/noteedit@/.berlios@/.de,NoteEdit} que importa
 343 @uref{http://@/www@/.musicxml@/.com/xml@/.html,MusicXML}.
 344 @item
 345 @uref{http://@/www@/.rosegardenmusic@/.com,Rosegarden}, que importa
 346 MIDI.
 347 @item
 348 @uref{http://@/common-lisp@/.net/project/fomus/,FOMUS},
 349 una biblioteca de LISP para generar notación musical.
 350 @item
 351 @uref{http://vsr.informatik.tu-chemnitz.de/staff/jan/nted/nted.xhtml},
 352 contempla experimentalmente la exportación para LilyPond.
 353 @item
 354 @uref{http://www.tuxguitar.com.ar/}, puede exportar a LilyPond.
 355 @item
 356 @uref{http://musescore.org} también puede exportar a LilyPond.
 357 @end itemize
 358