--- /dev/null
+@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
+
+@ignore
+ Translation of GIT committish: 7ba0a22641cb0c7f5949d66a06d1e2e1fd0b3033
+
+ When revising a translation, copy the HEAD committish of the
+ version that you are working on. For details, see the Contributors'
+ Guide, node Updating translation committishes..
+@end ignore
+
+@c \version "2.14.0"
+
+@node Programas externos
+@chapter Programas externos
+@translationof External programs
+
+LilyPond es capaz de interactuar con otros programas de diversas
+maneras.
+
+@menu
+* Apuntar y pulsar::
+* Apoyo respecto de los editores de texto::
+* Conversión desde otros formatos::
+* Salida de LilyPond dentro de otros programas::
+* Archivos include independientes::
+@end menu
+
+
+@node Apuntar y pulsar
+@section Apuntar y pulsar
+@translationof Point and click
+@cindex apuntar y pulsar
+
+
+«Point and click» (apuntar y pulsar con el ratón) le da la posibilidad
+de localizar notas del código de entrada pulsando sobre ellas dentro
+del visor de PDF. Ello facilita encontrar los fragmentos de la
+entrada que producen algún tipo de error en la partitura.
+
+Cuando esta funcionalidad está activada, LilyPond añade hiper-enlaces
+al archivo PDF. Estos hiper-enlaces se envían al navegador de web, que
+a su vez abre un editor de texto con el cursor situado en el lugar
+correcto.
+
+Para conseguir que esta cadena funcione, tendrá que configurar el
+visor de PDF de forma que siga los hiper-enlaces usando el guión
+@file{lilypond-invoke-editor} proporcionado con LilyPond.
+
+Para Xpdf sobre Unix, lo siguiente debe estar presente en
+@file{xpdfrc}@footnote{En Unix, este archivo se encuentra o bien en
+@file{/etc/xpdfrc} o como @file{.xpdfrc} en su directorio personal.}
+
+@example
+urlCommand "lilypond-invoke-editor %s"
+@end example
+
+El programa @file{lilypond-invoke-editor} es un pequeño programa de
+apoyo. Invoca un editor para las URIs especiales de @code{textedit}, y
+lanza un navegador de web para el resto. Comprueba la variable de
+entorno @code{EDITOR} en busca de los siguientes patrones,
+
+@table @code
+@item emacs
+ esto invoca a
+@example
+emacsclient --no-wait +@var{línea}:@var{columna} @var{archivo}
+@end example
+@item vim
+ esto invoca a
+@example
+gvim --remote +:@var{línea}:norm@var{carácter} @var{archivo}
+@end example
+
+@item nedit
+esto invoca a
+@example
+ nc -noask +@var{línea} @var{archivo}'
+@end example
+@end table
+
+La variable de entorno @code{LYEDITOR} se utiliza para sobreescribir
+esto. Contiene la instrucción de línea de órdenes para abrir el
+editor, donde @code{%(archivo)s}, @code{%(columna)s} y
+@code{%(línea)s} se sustituyen por el archivo, columna y línea
+respectivamente. El ajuste
+
+@example
+emacsclient --no-wait +%(línea)s:%(columna)s %(archivo)s
+@end example
+
+@noindent
+para @code{LYEDITOR} equivale a la invocación estándar de
+emacsclient.
+
+
+@cindex archivo de salida, tamaño del
+
+Los enlaces de apuntar y pulsar aumentan significativamente el tamaño
+de los archivos de salida. Para reducir el tamaño de los archivos PDF
+y PS, la posibilidad de apuntar y pulsar se puede desactivar
+escribiendo
+
+@example
+\pointAndClickOff
+@end example
+
+@noindent
+dentro de un archivo @file{.ly}. Se puede activar explícitamente la
+posibilidad de apuntar y pulsar con
+
+@example
+\pointAndClickOn
+@end example
+
+De forma alternativa, puede desactivar la posibilidad de apuntar y
+pulsar con una opción de la línea de órdenes:
+
+@example
+lilypond -dno-point-and-click archivo.ly
+@end example
+
+@warning{Recuerde desactivar siempre la posibilidad Apuntar y pulsar
+en cualquier archivo de LilyPond que vaya a ser distribuido, para
+evitar incluir información de rutas de archivo relativas a su equipo
+dentro del archivo .pdf, lo que puede plantear un problema de
+seguridad.}
+
+
+
+@node Apoyo respecto de los editores de texto
+@section Apoyo respecto de los editores de texto
+@translationof Text editor support
+
+@cindex editores
+@cindex vim
+@cindex emacs
+@cindex modos del editor
+@cindex sintaxis, resaltado de
+@cindex colores, sintaxis
+
+Existe apoyo por parte de varios editores de texto para LilyPond.
+
+@menu
+* Modo de Emacs::
+* Modo de Vim::
+* Otros editores::
+@end menu
+
+@node Modo de Emacs
+@unnumberedsubsec Modo de Emacs
+@translationof Emacs mode
+
+Emacs tiene un @file{lilypond-mode}, que proporciona autocompleción de
+teclado, sangrado, compensación de paréntesis específica de LilyPond y
+resaltado de sintaxis con colores, útiles combinaciones de teclas para
+compilar y leer los manuales de LilyPond utilizando Info. Si el
+@file{lilypond-mode} no está instalado en su sistema, siga leyendo.
+
+Está incluido un modo de Emacs para escribir música y ejecutar
+LilyPond, en el archivo del código fuente dentro del directorio
+@file{elisp}. Haga @command{make install} para instalarlo dentro de
+@var{elispdir}. El archivo @file{lilypond-init.el} se debe situar en
+@var{load-path}@file{/site-start.d/} o añadirse a su @file{~/.emacs} o
+@file{~/.emacs.el}.
+
+Como usuario, puede querer añadir su ruta a las fuentes
+(p.ej. @file{~/site-lisp/}) a su @var{load-path} añadiendo la
+siguiente línea (modificada) a su @file{~/.emacs}
+
+@c any reason we do not advise: (push "~/site-lisp" load-path)
+@example
+(setq load-path (append (list (expand-file-name "~/site-lisp")) load-path))
+@end example
+
+
+@node Modo de Vim
+@unnumberedsubsec Modo de Vim
+@translationof Vim mode
+
+Para @uref{http://@/www@/.vim@/.org,Vim}, se proporcionan para
+su uso con LilyPond un plug-in o complemento para el tipo de archivo,
+un modo de sangrado y un modo de resaltado de sintaxis.
+Para habilitar todas estas posibilidades, cree (o modifique)
+su archivo @file{$HOME/.vimrc} de manera que contenga estas tres líneas
+en el mismo orden:
+
+@example
+filetype off
+set runtimepath+=/usr/local/share/lilypond/current/vim/
+filetype on
+@end example
+
+Si LilyPond no está instalado en el directorio
+@file{/usr/local/}, cambie esta ruta de una forma adecuada.
+Este asunto se trata en
+@rlearning{Otras fuentes de información}.
+
+
+
+@node Otros editores
+@unnumberedsubsec Otros editores
+@translationof Other editors
+
+Otros editores (de texto así como gráficos) tienen apoyo para
+LilyPond, pero sus archivos de configuración especiales no se
+distribuyen con LilyPond. Debe consultar la documentación de estos
+programas para obtener más información. Estos editores se encuentran
+relacionaddos en @rweb{Entornos mejorados}.
+
+
+@node Conversión desde otros formatos
+@section Conversión desde otros formatos
+@translationof Converting from other formats
+
+También se puede escribir la música a través de su importación desde
+otros formatos. Este capítulo trata de documentar las herramientas
+incluidas en la distribución que permiten hacerlo. Existen otras
+herramientas que producen código de entrada de LilyPond, como por
+ejemplo secuenciadores con interfaz gráfico y convertidores de XML.
+Consulte el @uref{http://@/lilypond@/.org,website} para ver más
+detalles.
+
+Son programas distintos a @command{lilypond} propiamente dicho, y se
+ejecutan desde la línea de órdenes; consulte @ref{Utilización desde la
+línea de órdenes} para ver más información. Si tiene MacOS 10.3 o
+10.4 y tiene problemas para ejecutar alguno de estos guiones,
+p.ej. @code{convert-ly}, consulte @rweb{MacOS X}.
+
+
+@knownissues
+Por desgracia no disponemos de los recursos necesarios para poder
+mantener estos programas; le rogamos que los tome @qq{tal cual
+están}. Se agradecerá el envío de parches correctores, pero los
+informes de fallo casi con certeza no se resolverán a medio plazo.
+
+@menu
+* Invocar midi2ly:: Importar archivos MIDI.
+* Invocar musicxml2ly:: Importar archivos MusicXML.
+* Invocar abc2ly:: Importar archivos ABC.
+* Invocar etf2ly:: Importar archivos de Finale.
+* Otros formatos::
+@end menu
+
+
+
+
+@node Invocar midi2ly
+@subsection Invocar @command{midi2ly}
+@translationof Invoking midi2ly
+
+@cindex MIDI
+
+@command{midi2ly} traduce un archivo MIDI de tipo@tie{}1 a un archivo
+de código fuente de LilyPond.
+
+El MIDI (Music Instrument Digital Interface, Interfase Digital para
+Instrumentos Musicales) es un estándar para instrumentos digitales:
+especifica la interconexión física, un protocolo en serie y un formato
+de archivo. El formato de archivo MIDI es un formato estándar de
+facto para exportar música de otros programas, por lo que esta
+posibilidad puede ser de utilidad al importar archivos de un programa
+que tiene un convertidor para un formato directo.
+
+@command{midi2ly} convierte las pistas en contextos de
+@rinternals{Staff}) y los canales en contextos de
+@rinternals{Voice}. Se utiliza el modo relativo para las alturas, y
+las duraciones se escriben solamente cuando es necesario.
+
+Es posible grabar un archivo MIDI usando un teclado digital y
+convertirlo después a @file{.ly}. Sin embargo, los intérpretes
+humanos no son lo suficientemente exactos desde el punto de vista
+rítmico como para hacer que sea trivial la conversión de MIDI a LY.
+Si se invoca con las opciones de cuantización (@code{-s} y @code{-d}),
+@command{midi2ly} intenta compensar los errores de medida, pero no lo
+hace muy bien. Por ello, no se recomienda usar @command{midi2ly} para
+archivos midi generados por seres humanos.
+
+
+Se invoca a partir de la línea de órdenes como sigue:
+@example
+midi2ly [@var{opción}]@dots{} @var{archivo_midi}
+@end example
+
+Observe que al decir @q{línea de órdenes}, queremos decir la línea de
+órdenes del sistema operativo. Consulte @ref{Conversión desde otros
+formatos} para ver más información sobre esto.
+
+@command{midi2ly} contempla las siguientes opciones:
+
+@table @code
+@item -a, --absolute-pitches
+Imprimir alturas absolutas.
+
+@item -d, --duration-quant=@var{DURACIÓN}
+Cuantizar las duraciones a @var{DURACIÓN}.
+
+@item -e, --explicit-durations
+Imprimir valores de figura explícitos.
+
+@item -h,--help
+Mostrar un resumen de las instrucciones de utilización.
+
+@item -k, --key=@var{alteración}[:@var{minor}]
+Establecer la tonalidad predeterminada. @math{@var{alteración} > 0}
+establece el número de sostenidos; @math{@var{alteración} < 0}
+establece el número de bemoles. Se indica una tonalidad menor
+mediante @code{:1}.
+
+@item -o, --output=@var{archivo}
+Escribir la salida en @var{archivo}.
+
+@item -s, --start-quant=@var{DURACIÓN}
+Cuantizar el inicio de las notas a @var{DURACIÓN}.
+
+@item -t, --allow-tuplet=@var{DURACIÓN}*@var{NUMERADOR}/@var{DENOMINADOR}
+Permitir duraciones de grupos especiales @var{DURACIÓN}*@var{NUMERADOR}/@var{DENOMINADOR}.
+
+@item -v, --verbose
+Ser prolijo en comentarios.
+
+@item -V, --version
+Imprimir el número de la versión.
+
+@item -w, --warranty
+Presentar la garantía y el copyright.
+
+@item -x, --text-lyrics
+Tratar todos los textos como letra de la canción.
+@end table
+
+
+@knownissues
+
+Las notas superpuestas en un arpegio no se procesarán correctamente.
+La primera nota se lee y el resto se ignoran. Aplique la misma
+duración a todas las notas y añada marcas de fraseo o indicaciones de
+pedal.
+
+
+@node Invocar musicxml2ly
+@subsection Invocar @command{musicxml2ly}
+@translationof Invoking musicxml2ly
+
+@cindex MusicXML
+
+@uref{http://@/www.@/musicxml@/.org/,MusicXML} es un
+dialecto del XML para representar notación musical.
+
+@command{musicxml2ly} extrae las notas, articulaciones, estructura de
+la partitura, letra, etc., de archivos de MusicXML parte a parte, y
+los escribe en un archivo @file{.ly}. Se invoca a través de la línea de
+órdenes.
+
+La invocación desde la línea de órdenes se hace como sigue:
+
+@example
+musicxml2ly [@var{opción}]@dots{} @var{archivo_xml}
+@end example
+
+Observe que por @q{línea de órdenes}, nos referimos a la línea de
+órdenes del sistema operativo. Consulte @ref{Conversión desde otros
+formatos}, para obtener más información acerca de esto.
+
+Si el nombre de archivo proporcionado es @file{-},
+@command{musicxml2ly} lee la entrada desde la entrada estándar.
+
+@command{musicxml2ly} contempla las siguientes opciones:
+
+@table @code
+@item -a, --absolute
+convertir las alturas en modo absoluto.
+
+@item -h,--help
+mostrar un resumen de la utilización y las opciones.
+
+@item -l, --language=IDIOMA
+utilizar IDIOMA para los nombres de las notas, p.ej.
+'espanol' para los nombres de las notas en español.
+
+@item --lxml
+usar el paquete de Python lxml.etree para el análisis de XML; usa
+menos memoria y tiempo de CPU.
+
+@item --nd --no-articulation-directions
+no convertir las direcciones (@code{^}, @code{_} o @code{-}) para las
+articulaciones, dinámica, etc.
+
+@item --no-beaming
+no convertir la información de las barras, en vez de ello usar el
+barrado automático de LilyPond.
+
+@item -o,--output=@var{archivo}
+fijar el nombre del archivo de salida como @var{archivo}. Si
+@var{archivo} es @file{-}, la salida se imprime sobre stdout, la
+salida estándar. Si no se da, se usa @var{archivo_xml}@file{.ly}.
+
+@item -r,--relative
+convertir las alturas en modo relativo (predeterminado).
+
+@item -v,--verbose
+ser prolijo.
+
+@item -v,--version
+imprimir la información de la versión.
+
+@item -z,--compressed
+el archivo de entrada es un archivo MusicXML comprimido en zip.
+@end table
+
+
+
+@node Invocar abc2ly
+@subsection Invocar @code{abc2ly}
+@translationof Invoking abc2ly
+
+@warning{Este programa ya no está soportado, y podría desaparecer
+de versiones posteriores de LilyPond.}
+
+@cindex ABC
+
+ABC es un formato bastante simple basado en ASCII. Se encuentra
+descrito en el sitio web de ABC:
+
+@quotation
+@uref{http://@/www@/.walshaw@/.plus@/.com/@/abc/@/learn@/.html}.
+@end quotation
+
+@command{abc2ly} convierte ABC en LilyPond. Se invoca de la siguiente
+manera:
+
+@example
+abc2ly [@var{opción}]@dots{} @var{archivo_abc}
+@end example
+
+@command{abc2ly} contempla las siguientes opciones:
+
+@table @code
+@item -b,--beams=None
+preservar la noción de ABC de las barras
+@item -h,--help
+esta ayuda
+@item -o,--output=@var{archivo}
+fijar el nombre del archivo de salida como @var{archivo}.
+@item -s,--strict
+ser estricto respecto al éxito
+@item --version
+imprimir la información de la versión.
+@end table
+
+Existe una posibilidad rudimentaria para añadir código de LilyPond el
+archivo fuente de ABC. Si decimos:
+
+@example
+%%LY voices \set autoBeaming = ##f
+@end example
+
+Producirá que el texto que sigue a la palabra clave @q{voices} se
+inserte en la voz en curso del archivo de salida de LilyPond.
+
+De forma similar,
+
+@example
+%%LY slyrics más palabras
+@end example
+
+producirá que el texto que sigue a la palabra clave @q{slyrics} se
+inserte en la línea de letra en curso.
+
+
+@knownissues
+
+El estándar ABC no es muy @q{estándar}. Existen diferentes
+convenciones para las posibilidades avanzadas (por ejemplo,
+polifonía).
+
+
+No se pueden convertir varias melodías de un solo archivo.
+
+ABC sincroniza las letras y las notas al principio de una línea;
+@command{abc2ly} no lo hace.
+
+@command{abc2ly} ignora el barrado de ABC.
+
+
+@node Invocar etf2ly
+@subsection Invocar @command{etf2ly}
+@translationof Invoking etf2ly
+
+@cindex ETF
+@cindex enigma
+@cindex Finale
+@cindex Coda Technology
+
+ETF (Enigma Transport Format) es un formato utilizado por Finale, un
+producto de Coda Music Technology. @command{etf2ly} convierte parte
+de un archivo ETF en un archivo de LilyPond listo para usar.
+
+Se invoca a través de la línea de órdenes como sigue:
+
+@example
+etf2ly [@var{opción}]@dots{} @var{archivo_etf}
+@end example
+
+Observe que por @q{línea de órdenes}, nos referimos a la línea de
+órdenes del sistema operativo. Consulte @ref{Conversión desde otros
+formatos}, para obtener más información acerca de esto.
+
+@command{etf2ly} contempla las siguientes opciones:
+
+@table @code
+@item -h,--help
+esta ayuda
+@item -o,--output=@var{ARCHIVO}
+fijar el nombre del archivo de salida como @var{ARCHIVO}
+@item --version
+información de la versión
+@end table
+
+
+@knownissues
+
+La lista de inscripciones de articulación posibles es incompleta. Los
+compases vacíos confunden a @command{etf2ly}. Las secuencias de notas
+de adorno no se dan por finalizadas satisfactoriamente.
+
+
+
+@node Otros formatos
+@subsection Otros formatos
+@translationof Other formats
+
+@cindex programas externos, generación de archivos de LilyPond
+
+El propio LilyPond no contempla la utilización de ningún otro formato,
+pero existen algunas herramientas externas que también generan
+archivos de LilyPond.
+
+Se encuentran relacionados en la sección @rweb{Entornos mejorados}.
+
+
+
+@node Salida de LilyPond dentro de otros programas
+@section Salida de LilyPond dentro de otros programas
+@translationof LilyPond output in other programs
+
+Esta sección presenta métodos para integrar texto y música distintos
+del método automatizado con @command{lilypond-book}.
+
+@menu
+* Muchas citas de una partitura extensa::
+* Insertar la salida de LilyPond dentro de OpenOffice.org::
+* Insertar la salida de LilyPond dentro de otros programas::
+@end menu
+
+@node Muchas citas de una partitura extensa
+@unnumberedsubsec Muchas citas de una partitura extensa
+@translationof Many quotes from a large score
+
+Si tiene que citar muchos fragmentos extraídos de una partitura grade,
+puede también usar la capacidad de recorte de sistemas, véase
+@ruser{Extracción de fragmentos de música}.
+
+
+@node Insertar la salida de LilyPond dentro de OpenOffice.org
+@unnumberedsubsec Insertar la salida de LilyPond dentro de OpenOffice.org
+@translationof Inserting LilyPond output into OpenOffice.org
+
+@cindex OpenOffice.org
+
+Se puede añadir notación de LilyPond a los documentos de
+OpenOffice.org con
+@uref{http://@/ooolilypond@/.sourceforge@/.net@/,OOoLilyPond}.
+
+
+@node Insertar la salida de LilyPond dentro de otros programas
+@unnumberedsubsec Insertar la salida de LilyPond dentro de otros programas
+@translationof Inserting LilyPond output into other programs
+
+Para insertar la salida de LilyPond dentro de otros programas, use
+@code{lilypond} en vez de @code{lilypond-book}. Cada ejemplo debe
+crearse individualmente y añadirse al documento; consulte la
+documentación del programa correspondiente. La mayoría de los
+programas podrán insertar la salida de LilyPond en los formatos
+@file{PNG}, @file{EPS} o @file{PDF}.
+
+Para reducir el espacio vacío alrededor de la partitura de LilyPond,
+utilice las siguientes opciones:
+
+@example
+\paper@{
+ indent=0\mm
+ line-width=120\mm
+ oddFooterMarkup=##f
+ oddHeaderMarkup=##f
+ bookTitleMarkup = ##f
+ scoreTitleMarkup = ##f
+@}
+
+@{ c1 @}
+@end example
+
+Para obtener un archivo @file{EPS} que sea útil, utilice
+
+@example
+lilypond -dbackend=eps -dno-gs-load-fonts -dinclude-eps-fonts miarchivo.ly
+
+@file{PNG}:
+lilypond -dbackend=eps -dno-gs-load-fonts -dinclude-eps-fonts --png miarchivo.ly
+@end example
+
+
+@node Archivos include independientes
+@section Archivos @code{include} independientes
+@translationof Independent includes
+
+Hay personas que han escrito extensas (¡y útiles!) piezas de código
+que se pueden compartir entre distintos proyectos. Este código
+podría, llegado el caso, incorporarse al propio LilyPond, pero hasta
+que esto ocurra, tendrá que descargarlos e incluirlos mediante
+@code{\include}, manualmente.
+
+@menu
+* Articulación MIDI::
+@end menu
+
+
+@node Articulación MIDI
+@subsection Articulación MIDI
+@translationof MIDI articulation
+
+LilyPond se puede usar para producir una salida MIDI, para efectuar
+una revisión @qq{de oído} de lo que se ha escrito. Sin embargo, sólo
+los matices dinámicos, las marcas de tempo explícitas y las propias
+notas y duraciones se producen en la salida.
+
+El proyecto @emph{articulate} es un intento de llevar más información
+de la partitura al MIDI. Funciona acortando las notas que no están
+ligadas, para @q{articularlas}. El grado de acortamiento depende de
+las marcas de articulación que se han puesto en las notas: los picados
+dan la mitad de duración, el tenuto da la duración completa, y así
+sucesivamente. El script también realiza los trinos y los grupetos, y
+se puede extender para que desarrolle otros ornamentos como los
+mordentes.
+
+
+@example
+@uref{http://@/www@/.nicta@/.com@/.au/@/people/@/chubbp/@/articulate}
+@end example
+
+@knownissues
+
+Su principal limitación es que sólo afecta a las cosas de las que
+tiene algún conocimiento: todo aquello que son meramente marcas
+textuales (y no una propiedad de una nota) se ignora, por el momento.
+
+
projects / lilypond.git / blobdiff