@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
@ignore
-Translation of GIT committish: 28add695953862ef4a87f9fbeadd1d02dc299244
+Translation of GIT committish: 4299c96f609f79426a181ffed107d17fa6e1fdbd
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
@end menu
-
@node Navegar por la referencia del programa
@subsection Navegar por la referencia del programa
@translationof Navigating the program reference
Aumentando el valor de @code{padding}, podemos alejar la cifra de
digitación de la cabeza de la nota. La siguiente orden inserta un
-espacio en blanco de 3 espacios de pentagrama entre la nota y la
-digitación:
+espacio en blanco de tres @qq{espacios de pentagrama} entre la
+nota y la digitación:
+
@example
\once \override Voice.Fingering.padding = #3
@end example
-Al insertar esta instrucción antes de que se haya creado el objeto
-Fingering, es decir, antes del @code{c2}, llegamos al siguiente
-resultado:
+Al insertar este relleno antes de que se haya creado el objeto de
+digitación, llegamos al siguiente resultado:
-@lilypond[quote,relative=2,verbatim]
+@lilypond[quote,fragment,verbatim]
\once \override Voice.Fingering.padding = #3
-c-2
-\stemUp
-f
+c''-2
@end lilypond
-En este caso, el contexto de este truco es @code{Voice}. Este
-hecho se puede deducir también a partir de la referencia del
-programa, ya que la página dedicada al añadido
-@rinternals{Fingering_engraver} dice
+En este caso, el contexto de este truco es @code{Voice}. Véase el
+apartado dedicado al añadido @rinternals{Fingering_engraver}, que
+dice:
@quotation
-El grabador Fingering_engraver es parte de los contextos: @dots{}
-@rinternals{Voice}
+El grabador Fingering_engraver forma parte de los contextos:
+@dots{} @rinternals{Voice}
@end quotation
convenciones de nomenclatura:
@itemize
-@item funciones de Scheme: minúsculas-con-guiones (incluso nombres de una sola palabra)
-@item funciones de Scheme: ly:más-estilo-de-scheme
+@item funciones de Scheme: minúsculas-con-guiones (lo que incluye a los nombres de una sola palabra)
+
+@item funciones de Scheme específicas de LilyPond: ly:más-estilo-de-scheme
+
@item eventos, clases y propiedades musicales: como-las-funciones-de-scheme
+
@item interfaces de Grobs: estilo-scheme
+
@item propiedades de backend: estilo-scheme (¡pero X e Y en mayúsculas!)
+
@item contextos (y ExpresionesMusicales y grobs): Mayúsculas o MayúsculasDeCamello
+
@item propiedades de contexto: minúsculasSeguidoDeMayúsculasDeCamello
+
@item grabadores: Mayúsculas_seguido_de_minúsculas_y_con_barras_bajas
@end itemize
Preguntas aún sin respuesta
@itemize
@item ¿Cuáles de aquéllas son convenciones y cuáles son reglas?
+
@item ¿Cuáles son reglas del lenguaje subyacente, y cuáles son específicas de LilyPond?
@end itemize
@end ignore
@funindex \set
@funindex \override
-Tanto @code{\set} como @code{\override} manipulan propiedades
-asociadas a contextos. En ambos casos las propiedades tienen en
-cuenta la jerarquía de contextos: las propiedades no establecidas en
-el propio contexto presentan los valores del contexto padre
-respectivo.
-El valor y la duración en el tiempo de las propiedades de contexto
+Tanto la instrucción @code{\set} como @code{\override} manipulan
+propiedades asociadas a contextos. En ambos casos las propiedades
+siguen una@emph{jerarquía de contextos}: las propiedades que no se
+establecen dentro del contexto aún presentan los valores del
+contexto de su padre respectivo.
+
+El valor y la duración en el tiempo de una propiedad de contexto
son dinámicos y están disponibles solamente cuando la música se
está interpretando o @q{iterando}. En el momento de la creación
-del contexto, se inicializan las propiedades a partir de la
-definición de contexto correspondiente y las posibles
-modificaciones de contexto. Después de esto, cualquier cambio se
+del contexto, se inicializan las propiedades a partir de las
+definiciones correspondientes (así como otras posibles
+modificaciones) de dicho contexto. Cualquier cambio posterior se
obtiene a través de instrucciones de establecimiento de
propiedades dentro de la propia música.
-Ahora bien, las definiciones de grob (objetos gráficos) son una
-clase especial de propiedades de contexto. Dado que su
-estructura, mantenimiento y utilización es distinta de las
-propiedades de contexto ordinarias, se accede a ellas con un
-conjunto de instrucciones diferente, y se estudian por separado
-dentro de la documentación.
-
-A diferencia de las propiedades de contexto normales, las
-definiciones de grob están subdivididas en propiedades de grob.
-Un @qq{grob} (objeto gráfico) se crea normalmente por parte de un
+Las definiciones de grob (objetos gráficos) son una clase
+@emph{especial} de propiedades de contexto, pues su estructura y
+uso son distintos de las propiedades de contexto ordinarias. A
+diferencia de las propiedades de los contextos normales, las
+definiciones de grob se subdividen en @emph{propiedades de grob}.
+
+Además, en contraste con las propiedades de contexto normales, las
+definiciones de grob tienen su propio conjunto de @q{utilidades de
+mantenimiento} de las propiedades individuales y, en su caso,
+sub-propiedades. Esto supone que es posible definir las distintas
+partes dentro de diferentes contextos y aún tener la definición
+completa del grob en el momento de su creación, montada a partir
+de todas las piezas proporcionadas por el contexto actual y su
+ancestro o ancestros, conjuntamente.
+
+Un grob u objeto gráfico se crea normalmente por parte de un
grabador en el momento de la interpretación de una expresión
musical y recibe sus propiedades iniciales de la definición de
grob en curso del contexto del grabador. El grabador (u otras
-partes del @q{backend} de LilyPond) pueden después añadir o
-modificar propiedades del grob, pero ello no afecta a la
-definición de grob del contexto.
-
-Lo que conocemos como @q{propiedades de grob} en el contexto del
-trucaje a nivel de usuario son en realidad las propiedades de la
-definición de grob de un contexto. A diferencia de las
-propiedades de contexto normales, las definiciones de grob
-mantienen la contabilidad necesaria para seguir la pista de sus
-partes, las propiedades de grob individuales (e incluso
-subpropiedades de éstos), de forma separada, de forma que es
-posible definir dichas partes dentro de contextos diferentes y
-hacer que la definición de grob en su conjunto, en el momento de
-la creación del grob, se monte a partir de las piezas
-proporcionadas en diferentes contextos entre el contexto actual y
-sus contextos padre.
-
-Las definiciones de grob se manipulan usando @code{\override} y
-@code{\revert} y tienen un nombre que empieza con una letra mayúscula
-(como @samp{NoteHead}) mientras que las propiedades de contexto
-ordinarias se manipulan utilizando @code{\set} y @code{\unset} y se
-nombran empezando en letra minúscula.
+partes del @q{backend} de LilyPond) pueden después modificar (o
+añadirse a) las propiedades iniciales del grob; sin embargo, ello
+no afecta a la definición de grob del contexto.
+
+Lo que LilyPond conoce como @q{propiedades de grob} en el contexto
+del trucaje a nivel de usuario son en realidad las propiedades de
+la definición de grob de un contexto.
+
+Se accede a las definiciones de grob con un conjunto de
+instrucciones diferente. Se manipulan usando @code{\override} y
+@code{\revert} y tienen un nombre que empieza con una letra
+mayúscula (como @samp{NoteHead}) mientras que las propiedades de
+contexto ordinarias se manipulan utilizando @code{\set} y
+@code{\unset} y se nombran empezando en letra minúscula.
@cindex tweak, relación con @code{\override}
@funindex \tweak
@funindex \overrideProperty
-Las instrucciones especiales @code{\tweak} y @code{\overrideProperty}
-cambian las propiedades de grob pasando por encima de las propiedades
-de contexto completamente. En su lugar, atrapan a los grobs tan
-pronto se crean, y después establecen propiedades sobre ellos
-directamente cuando se originan a partir de un evento musical trucado
-o son de un tipo en particular, respectivamente.
+
+Las instrucciones @code{\tweak} y @code{\overrideProperty} cambian
+las propiedades de grob pasando por encima de las propiedades de
+contexto completamente. En su lugar, atrapan a los grobs tan
+pronto se crean, y establecen propiedades sobre ellos directamente
+con @code{\tweak} cuando se originan a partir de un evento musical
+o, en el caso de @code{\overrideProperty}, para una sobreescritura
+específica.
@node Modificación de las listas-A
@subsection Modificación de las listas-A
* Rotación de objetos::
@end menu
-
@node Modos de entrada
@subsection Modos de entrada
@translationof Input modes
modo de notas e imprímalos dentro de un contexto @code{TabStaff},
véase @ref{Tablaturas predeterminadas}.
-Para crear diagramas de trastes encima de un pentagrama,
-escríbalos como elementos de marcado encima de las notas
-utilizando la instrucción @code{\fret-diagram}, véase @ref{Marcas
-de diagramas de trastes}.
+Para crear diagramas de trastes encima de un pentagrama, podemos
+elegir entre dos posibilidades. Se puede usar el contexto
+@code{FretBoards} (véase @ref{Diagramas de traste automáticos}) o
+se pueden introducir como elementos de marcado encima de las notas
+utilizando la instrucción @code{\fret-diagram}, véase
+@ref{Marcas de diagramas de trastes}.
@subsubsubheading Modo de letra
@subsubsubheading Modo de marcado
Se activa con la instrucción @code{\markup}, y hace que la entrada
-se interprete con la sintaxis del marcado, véase @ref{Text markup
-commands}.
+se interprete con la sintaxis del marcado, véase
+@ref{Text markup commands}.
@subsubsubheading Modo de notas
Es el modo predeterminado o se puede activar con la instrucción
-@code{\notemode}. La entrada se interpreta como alturas, duraciones,
-marcado, etc. y se imprime como notación musical sobre un pentagrama.
+@code{\notemode}. La entrada se interpreta como alturas,
+duraciones, marcado, etc. y se imprime como notación musical sobre
+un pentagrama.
Normalmente no es necesario especificar el modo de notas de forma
explícita, pero puede ser útil hacerlo en ciertas situaciones, por
* La propiedad de dirección::
@end menu
+
@node Indicadores de dirección de las articulaciones
@unnumberedsubsubsec Indicadores de dirección de las articulaciones
@translationof Articulation direction indicators
}
@end lilypond
+
@node La propiedad de dirección
@unnumberedsubsubsec La propiedad de dirección
@translationof The direction property
aplicación las siguientes limitaciones:
@itemize @bullet
-@item Las líneas divisorias no se pueden imprimir al principio de la línea.
-@item No se puede imprimir el número de compás al principio de la primera
-línea a no ser que su valor establecido sea distinto de 1.
-@item Clave: véase más abajo
-@item Las repeticiones dobles de tipo porcentaje se imprimen completamente o
-se suprimen por completo. Utilice begin-of line-invisible para
-imprimirlas y all-invisible para suprimirlas.
-@item Armadura: véase más abajo
-@item ClefModifier: véase más abajo
+@item
+Las líneas divisorias no se pueden imprimir al principio de la línea.
+
+@item
+No se puede imprimir el número de compás al principio de la
+@emph{primera} línea a no ser que su valor establecido sea
+distinto de @code{1}.
+
+@item Clave: véase la sección siguiente.
+
+@item
+Las repeticiones dobles de tipo porcentaje se imprimen todas
+siempre o bien no se imprimen nunca. Utilice @code{begin-of
+line-invisible} para imprimirlas y @code{all-invisible} para
+suprimirlas.
+
+@item Armadura: véase la sección siguiente.
+
+@item ClefModifier: véase la sección siguiente.
@end itemize
pasar a la instrucción de marcado @code{\musicglyph}: véase
@ref{La tipografía Feta}.
-@c TODO Add inserting eps files or ref to later
+Se pueden insertar en línea tanto imágenes en formato @file{EPS}
+como instrucciones de Postscript usando las instrucciones de
+marcado @code{\epsfile} y @code{\postscript} respectivamente;
+véase @ref{Graphic}.
-@c TODO Add inserting Postscript or ref to later
@seealso
Referencia de la notación:
@ref{Notación gráfica dentro de elementos de marcado},
@ref{Formatear el texto},
@ref{Text markup commands},
-@ref{La tipografía Feta}.
+@ref{La tipografía Feta},
+@ref{Graphic}.
@node Modificación de las formas
obtener el valor real que se usa a continuación para el ajuste de
precisión mucho más tardío durante el proceso de espaciado.
+@c TODO: The following example supposedly showing a collision no longer
+@c 'works' since 2.18.x. Another example of a collision is needed.
+@c Issue #3512
+
@lilypond[verbatim,quote,ragged-right]
#(define (square-line-circle-space grob)
(let* ((pitch (ly:event-property (ly:grob-property grob 'cause) 'pitch))