-@c -*- coding: utf-8; mode: texinfo; -*-
+@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
@ignore
- Translation of GIT committish: c1eb9d63bb22ba4a9243942599f68768f5631e34
+ Translation of GIT committish: da632500cfc55fcd3660f72b39c7dbcd7542f9bc
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.12.0"
+@c \version "2.16.0"
@node Programas externos
@chapter Programas externos
@translationof External programs
-@c FIXME: blah blah
+LilyPond es capaz de interactuar con otros programas de diversas
+maneras.
@menu
* Apuntar y pulsar::
@node Apuntar y pulsar
@section Apuntar y pulsar
@translationof Point and click
-@cindex apuntar y pulsar
+Point and click adds links to pdf documents for certain music
+elements.
+
+@menu
+* Habilitar la opción de apuntar y pulsar::
+* Apuntar y pulsar selectivo::
+@end menu
+
+@node Habilitar la opción de apuntar y pulsar
+@unnumberedsubsec Habilitar la opción de apuntar y pulsar
+@translationof Enabling 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
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
+Para conseguir que esta cadena funcione, tiene que configurar el visor
+de PDF de forma que siga los 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.}
+@file{xpdfrc}. En Unix, este archivo se encuentra o bien en
+@file{/etc/xpdfrc} o como @file{$HOME/.xpdfrc}.
@example
urlCommand "lilypond-invoke-editor %s"
@end example
@noindent
-para @code{LYEDITOR} equivale a la invocación estándar de
-emacsclient.
+para @code{LYEDITOR} equivale a la invocación estándar de emacsclient.
@cindex archivo de salida, tamaño del
dentro del archivo .pdf, lo que puede plantear un problema de
seguridad.}
+@node Apuntar y pulsar selectivo
+@unnumberedsubsec Apuntar y pulsar selectivo
+@translationof Selective point-and-click
+
+Para ciertas aplicaciones interactivas podría ser deseable incluir
+solamente ciertos elementos dentro de la función de apuntar y pulsar.
+Por ejemplo, si alguien quisiera crear una aplicación que reprodujese
+audio o vídeo empezando por una nota concreta, sería incómodo que la
+pulsación sobre la nota produjese las coordenadas de apuntar y pulsar
+de una alteración accidental o de una ligadura de expresión que
+estuviese sobre dicha nota.
+
+Esto se puede controlar indicando qué eventos incluir:
+
+@itemize
+@item
+Codificado de forma fija dentro del archivo @file{.ly}:
+
+@example
+\pointAndClickTypes #'note-event
+\relative c' @{
+ c2\f( f)
+@}
+@end example
+
+o bien
+
+@example
+#(ly:set-option 'point-and-click 'note-event)
+\relative c' @{
+ c2\f( f)
+@}
+@end example
+
+@item
+Línea de órdenes:
+
+@example
+lilypond -dpoint-and-click=note-event example.ly
+@end example
+
+@end itemize
+
+Se pueden incluir varios eventos:
+
+@itemize
+@item
+Codificado de forma fija dentro del archivo @file{.ly}:
+
+@example
+\pointAndClickTypes #'(note-event dynamic-event)
+\relative c' @{
+ c2\f( f)
+@}
+@end example
+
+o bien
+
+@example
+#(ly:set-option 'point-and-click '(note-event dynamic-event))
+\relative c' @{
+ c2\f( f)
+@}
+@end example
+
+@item
+Línea de órdenes:
+@smallexample
+lilypond \
+ -e"(ly:set-option 'point-and-click '(note-event dynamic-event))" \
+ example.ly
+@end smallexample
+
+@end itemize
@node Apoyo respecto de los editores de texto
@section Apoyo respecto de los editores de texto
@unnumberedsubsec Modo de Vim
@translationof Vim mode
-Para @uref{http://@/www@/.vim@/.org,VIM} se proporciona un
-@file{vimrc}, junto con herramientas de resaltado de sintaxis con
-colores. Se encuentra incluido un modo de Vim para escribir música y
-ejecutar LilyPond, dentro del archivo de código fuente, en el
-directorio @code{$VIM}.
-
-El tipo de archivo de LilyPond se detecta si el archivo
-@file{~/.vim/filetype.vim} tiene el siguiente contenido
+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
-if exists("did_load_filetypes")
- finish
-endif
-augroup filetypedetect
- au! BufNewFile,BufRead *.ly,*.ily setf lilypond
-augroup END
+filetype off
+set runtimepath+=/usr/local/share/lilypond/current/vim/
+filetype on
@end example
-Incluya esta ruta añadiendo la siguiente línea a su @file{~/.vimrc}
+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}.
-@example
-set runtimepath+=/usr/local/share/lilypond/$@{LILYPOND_VERSION@}/vim/
-@end example
-
-@noindent
-donde $@{LILYPOND_VERSION@} es su versión de lilypond. Si LilyPond no
-se instaló en su momento en @file{/usr/local/}, cambie esta ruta de la
-forma correspondiente.
-
-En Fedora, la ruta apunta a la versión actual de Vim en lugar de
-LilyPond:
-
-@example
-set runtimepath+=/usr/share/vim/vim72/
-@end example
@node Otros editores
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 @ref{Configuración para MacOS X}.
+p.ej. @code{convert-ly}, consulte @rweb{MacOS X}.
@knownissues
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.
+* 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
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}),
+Si se invoca con las opciones de cuantización (@option{-s} y @option{-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.
@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 .ly. Se invoca a través de la línea de
+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:
mostrar un resumen de la utilización y las opciones.
@item -l, --language=IDIOMA
-utilizar un archivo de idioma distinto 'IDIOMA.ly' y los
-correspondientes nombres de nota, p.ej. 'deutsch' para deutsch.ly y
-los nombres de nota en alemán.
+utilizar IDIOMA para los nombres de las notas, p.ej.
+'espanol' para los nombres de las notas en español.
+
+@item --loglevel=@var{loglevel}
+fijar el grado en que la salida es prolija al valor dado en
+@var{loglevel}. Los valores posibles son @code{NONE} (ninguno),
+@code{ERROR} (errores), @code{WARNING} (advertencias), @code{PROGRESS}
+(avance; predeterminado) y @code{DEBUG} (depuración).
@item --lxml
usar el paquete de Python lxml.etree para el análisis de XML; usa
menos memoria y tiempo de CPU.
+@item -m, --midi
+activar el bloque midi.
+
@item --nd --no-articulation-directions
no convertir las direcciones (@code{^}, @code{_} o @code{-}) para las
articulaciones, dinámica, etc.
@{ c1 @}
@end example
-Para obtener un archivo @file{EPS} que sea útil, utilice
+Para obtener archivos de imagen que sean útiles:
@example
-lilypond -dbackend=eps -dno-gs-load-fonts -dinclude-eps-fonts miarchivo.ly
+EPS
+
+lilypond -dbackend=eps -dno-gs-load-fonts -dinclude-eps-fonts myfile.ly
-@file{PNG}:
-lilypond -dbackend=eps -dno-gs-load-fonts -dinclude-eps-fonts --png miarchivo.ly
+PNG
+
+lilypond -dbackend=eps -dno-gs-load-fonts -dinclude-eps-fonts --png myfile.ly
+
+PNG transparentes
+
+lilypond -dbackend=eps -dno-gs-load-fonts -dinclude-eps-fonts \
+ -dpixmap-format=pngalpha --png myfile.ly
@end example
@section Archivos @code{include} independientes
@translationof Independent includes
-@c FIXME: blah blah
+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::
@subsection Articulación MIDI
@translationof MIDI articulation
-@untranslated
+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.
-@c stub for info about Dr. Peter Chubb's @file{articulate.ly}
projects / lilypond.git / blobdiff