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