From 403ae3c68aae09218703a7d8cc7df3d30e6d7b92 Mon Sep 17 00:00:00 2001 From: Francisco Vila Date: Tue, 26 Apr 2016 13:35:33 +0200 Subject: [PATCH] Doc-es: update Notation/Changing. --- .../es/notation/changing-defaults.itely | 200 ++++++++++-------- 1 file changed, 113 insertions(+), 87 deletions(-) diff --git a/Documentation/es/notation/changing-defaults.itely b/Documentation/es/notation/changing-defaults.itely index 8e102bf655..d878e9c414 100644 --- a/Documentation/es/notation/changing-defaults.itely +++ b/Documentation/es/notation/changing-defaults.itely @@ -1,7 +1,7 @@ @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' @@ -1541,7 +1541,6 @@ Archivos instalados: @end menu - @node Navegar por la referencia del programa @subsection Navegar por la referencia del programa @translationof Navigating the program reference @@ -1772,31 +1771,28 @@ unos junto a otros. 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 @@ -1808,13 +1804,20 @@ Se hace necesario presentar una panorámica de las diversas 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 @@ -1822,6 +1825,7 @@ convenciones de nomenclatura: 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 @@ -2498,66 +2502,67 @@ de entrada. @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 @@ -2702,7 +2707,6 @@ como listas-A.} * Rotación de objetos:: @end menu - @node Modos de entrada @subsection Modos de entrada @translationof Input modes @@ -2760,10 +2764,12 @@ Para crear diagramas de trastes, escriba las notas o acordes en el 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 @@ -2780,14 +2786,15 @@ letra que viene a continuación con la música precedente. @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 @@ -2815,6 +2822,7 @@ una dirección o colocación concreta. * 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 @@ -2856,6 +2864,7 @@ Estas indicaciones afectan sólo a la nota siguiente. } @end lilypond + @node La propiedad de dirección @unnumberedsubsubsec La propiedad de dirección @translationof The direction property @@ -3632,15 +3641,25 @@ algunas combinaciones pueden incluso dar errores. Son de 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 @@ -4402,16 +4421,19 @@ Cualquiera de los glifos de la fuente tipográfica Feta se puede 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 @@ -4856,6 +4878,10 @@ valor necesario, que se usa entonces por la primera función para 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)) -- 2.39.2