From d2119a9e5e951c6ae850322f41444ac98d1ed492 Mon Sep 17 00:00:00 2001 From: Francisco Vila Date: Sun, 2 May 2010 20:15:53 +0200 Subject: [PATCH] Doc: update LSR. --- .../adding-fingerings-to-tablatures.ly | 9 +++ Documentation/snippets/clip-systems.ly | 27 +++++++ ...g-spanner-visibility-after-a-line-break.ly | 22 ++++++ .../snippets/displaying-complex-chords.ly | 9 +++ .../snippets/displaying-grob-ancestry.ly | 76 ++++++++++++++++++- .../dynamics-custom-text-spanner-postfix.ly | 12 +++ .../snippets/dynamics-text-spanner-postfix.ly | 15 ++++ .../snippets/faking-a-hammer-in-tablatures.ly | 10 +++ Documentation/snippets/flamenco-notation.ly | 40 ++++++++++ Documentation/snippets/guitar-slides.ly | 13 ++++ .../snippets/letter-tablature-formatting.ly | 8 ++ .../snippets/modern-tab-text-clef.ly | 8 ++ .../snippets/numbers-as-easy-note-heads.ly | 16 ++++ .../snippets/scheme-engraver-ambitus.ly | 13 ++++ ...grob-object-to-access-grobs-with--tweak.ly | 40 ++++++++++ .../snippets/using-the-whiteout-property.ly | 25 ++++++ 16 files changed, 340 insertions(+), 3 deletions(-) diff --git a/Documentation/snippets/adding-fingerings-to-tablatures.ly b/Documentation/snippets/adding-fingerings-to-tablatures.ly index f400431368..bfa882d637 100644 --- a/Documentation/snippets/adding-fingerings-to-tablatures.ly +++ b/Documentation/snippets/adding-fingerings-to-tablatures.ly @@ -5,6 +5,15 @@ \version "2.13.18" \header { +%% Translation of GIT committish: ee2fdacf2ff3acd7e6fb7c4005dfe698b1cc4eed + texidoces = " +Para añadir digitaciones a las tablaturas, utilice una combinación de +@code{\\markup} y @code{\\finger}. +" + + doctitlees = "Añadir digitaciones a las tablaturas" + + %% Translation of GIT committish: 96ee692447057131395fe4c1f9fe55805b710aa6 texidocfr = "Ajout de doigtés à des tablatures" diff --git a/Documentation/snippets/clip-systems.ly b/Documentation/snippets/clip-systems.ly index 501a977f4d..937c5ef9c1 100644 --- a/Documentation/snippets/clip-systems.ly +++ b/Documentation/snippets/clip-systems.ly @@ -5,6 +5,33 @@ \version "2.13.18" \header { +%% Translation of GIT committish: ee2fdacf2ff3acd7e6fb7c4005dfe698b1cc4eed + texidoces = " +Este código muestra cómo recortar (extraer) fragmentos a partir de una +partitura completa. + +Este archivo tiene que procesarse de forma separada con la opción +@code{-dclip-systems}; la página de fragmentos de código podría no +mostrar el resultado adecuadamente. + +La salida consiste en archivos con los nombres +@samp{base-from-inicio-to-final[-número].eps}. + + +Si se incluyen los comienzos y finales de los sistemas, incluyen las +dimensiones del grob del sistema, por ejemplo los nombres de +instrumento. + + +Las notas de adorno en el punto final de la región no se incluyen. + + +Las regiones pueden abarcar varios sistemas. En este caso, se generan +varios archivos EPS. + +" + doctitlees = "Recorte de sistemas" + lsrtags = "paper-and-layout" texidoc = " diff --git a/Documentation/snippets/controlling-spanner-visibility-after-a-line-break.ly b/Documentation/snippets/controlling-spanner-visibility-after-a-line-break.ly index 108ee59c0e..5634f995e4 100644 --- a/Documentation/snippets/controlling-spanner-visibility-after-a-line-break.ly +++ b/Documentation/snippets/controlling-spanner-visibility-after-a-line-break.ly @@ -5,6 +5,28 @@ \version "2.13.18" \header { +%% Translation of GIT committish: ee2fdacf2ff3acd7e6fb7c4005dfe698b1cc4eed + + texidoces = " +La visibilidad de los objetos de extensión que acaban en la primera +nota después de un salto de línea está controlada por la función de +callback de @code{after-line-breaking} +@code{ly:spanner::kill-zero-spanned-time}. + +Para los objetos como los glissandos y los reguladores, el +comportamiento predeterminado es ocultar el objeto de extensión +después del salto; la inhabilitación de la función de callback hace +que el objeto de extensión roto por la izquierda pueda mostrarse. + +De forma inversa, los objetos de extensión que son visibles +normalmente, como los objetos de extensión de texto, se pueden +ocultar habilitando la función de callback. +" + + doctitlees = "Controlar la visibilidad de los objetos de + extensión después de un salto de línea" + + lsrtags = "expressive-marks, tweaks-and-overrides" texidoc = "The visibility of spanners which end on the first note following a line break is controlled by the @code{after-line-breaking} diff --git a/Documentation/snippets/displaying-complex-chords.ly b/Documentation/snippets/displaying-complex-chords.ly index dee1e0ef3e..0b9708e443 100644 --- a/Documentation/snippets/displaying-complex-chords.ly +++ b/Documentation/snippets/displaying-complex-chords.ly @@ -5,6 +5,15 @@ \version "2.13.18" \header { +%% Translation of GIT committish: ee2fdacf2ff3acd7e6fb7c4005dfe698b1cc4eed + + texidoces = " +He aquí una forma de imprimir un acorde en el que suena la misma nota +dos veces con distintas alteraciones. + +" + doctitlees = "Impresión de acordes complejos" + lsrtags = "simultaneous-notes, chords" texidoc = " Here is a way to display a chord where the same note is played twice diff --git a/Documentation/snippets/displaying-grob-ancestry.ly b/Documentation/snippets/displaying-grob-ancestry.ly index 46df47021b..3484a7f9b2 100644 --- a/Documentation/snippets/displaying-grob-ancestry.ly +++ b/Documentation/snippets/displaying-grob-ancestry.ly @@ -5,6 +5,76 @@ \version "2.13.18" \header { +%% Translation of GIT committish: ee2fdacf2ff3acd7e6fb7c4005dfe698b1cc4eed + + texidoc = " +Al trabajar con los callbacks de un grob, puede ser de mucha ayuda +entender el @qq{árbol genealógico} de un grob. La mayor parte de los +grobs tienen @qq{padres} que influyen en el posicionamiento del grob. +los padres X e Y influyen en las posiciones horizontal y vertical del +grob, respectivamente. Además, cada pade puede tener padres a su vez. + + +Por desgracia, existen varios aspectos de la genealogía de un grob que +pueden llevar a confusión: + + +@itemize + +@item Los tipos de padre que tiene un grob pueden depender del +contexto. + +@item Para ciertos grobs, los padres X e Y son el mismo. + +@item Un @qq{ancestro} concreto puede estar relacionado con un grob de +mas de una manera. + +@item El concepto de @qq{generaciones} es engañoso. + +@end itemize + + +Por ejemplo, el grob @code{System} puede ser tanto un padre (sobre el +lado Y) como un abuelo (dos veces en el lado X) de un grob +@code{VerticalAlignment}. + + +Este macro imprime, en la consola, una representación textual de la +genealogía de un grob. + + +Cuando se llama de esta forma + +@example +@{ + \\once \\override NoteHead #'before-line-breaking = #display-ancestry + c4 +@} +@end example + + +Se genera la siguiente salida: + + +@example +------------------------------------ + +NoteHead X,Y: NoteColumn + X: PaperColumn + X,Y: System + Y: VerticalAxisGroup + X: NonMusicalPaperColumn + X,Y: System + Y: VerticalAlignment + X: NonMusicalPaperColumn + X,Y: System + Y: System +@end example + +" + + doctitle = "Imprimir el árbol genealógico de un grob" + lsrtags = "tweaks-and-overrides" texidoc = " @@ -37,7 +107,8 @@ The concept of @qq{generations} is misleading. For example, the @code{System} grob can be both parent (on the Y-side) -and grandparent (twice on the X-side) to a @code{VerticalAlignment} +and grandparent (twice on the X-side) to a @code{VerticalAlignment} % begin verbatim + grob. @@ -76,8 +147,7 @@ NoteHead X,Y: NoteColumn " doctitle = "Displaying grob ancestry" -} % begin verbatim - +} #(define (grob-name grob) (if (ly:grob? grob) diff --git a/Documentation/snippets/dynamics-custom-text-spanner-postfix.ly b/Documentation/snippets/dynamics-custom-text-spanner-postfix.ly index b1012f4e6e..4e35d5522c 100644 --- a/Documentation/snippets/dynamics-custom-text-spanner-postfix.ly +++ b/Documentation/snippets/dynamics-custom-text-spanner-postfix.ly @@ -5,6 +5,18 @@ \version "2.13.18" \header { +%% Translation of GIT committish: ee2fdacf2ff3acd7e6fb7c4005dfe698b1cc4eed + + texidoc = " +Funciones postfijas para la creación de objetos de extensión de texto +personalizados. Los objetos de extensión deben comenzar en la primera +nota del compás. Hay que utilizar -\mycresc, en caso contrario el +comienzo del eobjeto de extensión se asignará a la nota siguiente. + +" + + doctitle = "Objeto personalizado de extensión de texto de matices dinámicos postfijo" + lsrtags = "expressive-marks, tweaks-and-overrides" texidoc = "Postfix functions for custom crescendo text spanners. The spanners should start on the first note of the measure. One has to use -\mycresc, diff --git a/Documentation/snippets/dynamics-text-spanner-postfix.ly b/Documentation/snippets/dynamics-text-spanner-postfix.ly index da4fd65779..d42c1bcccb 100644 --- a/Documentation/snippets/dynamics-text-spanner-postfix.ly +++ b/Documentation/snippets/dynamics-text-spanner-postfix.ly @@ -5,6 +5,21 @@ \version "2.13.18" \header { +%% Translation of GIT committish: ee2fdacf2ff3acd7e6fb7c4005dfe698b1cc4eed + + texidoc = " +Los objetos de extensión \cresc, \dim y \decresc ahora se pueden +redefinir como operadores postfijos y producir un solo objeto de +extensión de texto. La definición de extensores personalizados +también es fácil. Se pueden mezclar con facilidad los crescendi +textuales y en forma de reguladores. \< y \> producen reguladores +gráficos de forma predeterminada, \cresc etc. producen elementos +extensores de texto de forma predeterminada. + +" + + doctitle = "Objetos extensores de texto postfijos para dinámica" + lsrtags = "expressive-marks, tweaks-and-overrides" texidoc = "The \cresc, \dim and \decresc spanners can now be redefined as postfix operators and produce one text spanner. Defining custom spanners is diff --git a/Documentation/snippets/faking-a-hammer-in-tablatures.ly b/Documentation/snippets/faking-a-hammer-in-tablatures.ly index c0384959d1..e04bfb39d3 100644 --- a/Documentation/snippets/faking-a-hammer-in-tablatures.ly +++ b/Documentation/snippets/faking-a-hammer-in-tablatures.ly @@ -5,6 +5,16 @@ \version "2.13.18" \header { +%% Translation of GIT committish: ee2fdacf2ff3acd7e6fb7c4005dfe698b1cc4eed + + texidoc = " +Se puede simular un @qq{hammer} o ligado ascendente con ligaduras de +expresión. + +" + + doctitle = "Simular un hammer o ligado ascendente en una tablatura" + lsrtags = "fretted-strings" texidoc = " A hammer in tablature can be faked with slurs. diff --git a/Documentation/snippets/flamenco-notation.ly b/Documentation/snippets/flamenco-notation.ly index 3a51dff088..0858447382 100644 --- a/Documentation/snippets/flamenco-notation.ly +++ b/Documentation/snippets/flamenco-notation.ly @@ -5,6 +5,46 @@ \version "2.13.18" \header { +%% Translation of GIT committish: ee2fdacf2ff3acd7e6fb7c4005dfe698b1cc4eed + + texidoc = " + +Para la guitarra flamenca se utilizan ciertos elementos de notación +especiales: + + +@itemize + +@item un símbolo para indicar un golpe sobre la caja de la guitarra +con el nudillo del dedo anular + +@item una flecha para indicar la dirección de los rasgueos + +@item distintas legras para las digitaciones (@qq{p}: pulgar, @qq{i}: +índice, @qq{m}: medio, @qq{a}: anular y @qq{x}: meñique) + +@item Rasgueados de 3 y cautro dedos: hacia arriba con todos los dedos +y terminando con arriba y abajo con el índice + +@item abanicos: rasgueos en serie con el pulgar, hacia abajo y el +meñique y el índice hacia arriba (hay también un abanico 2 en el que +los dedos medio y anular se usan en lugar del meñique) + +@item alza púa: pulsaciones rápidas con el pulgar + +@end itemize + + +Casi todas las figuras utilizan flechas combinadas con digitaciones; +con los abanicos y los rasgueados, las notas se imprimen con cabeza +sólo en el primer acorde. + +Este fragmento de código contiene código de tipo cabecera que se puede +copiar como @samp{flamenco.ly} e incluirse en los documentos fuente. + +" + doctitle = "Notación del flamenco" + lsrtags = "fretted-strings" texidoc = " diff --git a/Documentation/snippets/guitar-slides.ly b/Documentation/snippets/guitar-slides.ly index 7154c56bd1..a430eaed79 100644 --- a/Documentation/snippets/guitar-slides.ly +++ b/Documentation/snippets/guitar-slides.ly @@ -5,6 +5,19 @@ \version "2.13.18" \header { +%% Translation of GIT committish: ee2fdacf2ff3acd7e6fb7c4005dfe698b1cc4eed + + + texidoc = " +A diferencia de los glissandos, los @q{slides} o ligaduras pueden +partir de un punto impreciso del mástil hasta un traste específico. +Una buena forma de hacerlo es añadir una nota de mordente antes de la +nota real, como se muestra en el ejemplo siguiente. + +" + + doctitle = "Ligaduras de guitarra" + lsrtags = "fretted-strings" texidoc = " diff --git a/Documentation/snippets/letter-tablature-formatting.ly b/Documentation/snippets/letter-tablature-formatting.ly index 27eafd3671..23341e7c06 100644 --- a/Documentation/snippets/letter-tablature-formatting.ly +++ b/Documentation/snippets/letter-tablature-formatting.ly @@ -5,6 +5,14 @@ \version "2.13.18" \header { +%% Translation of GIT committish: ee2fdacf2ff3acd7e6fb7c4005dfe698b1cc4eed + texidoc = " +La tablatura se puede formatear utilizando letras en lugar de números. + +" + + doctitle = "Formateado de tablaturas con letras" + lsrtags = "staff-notation, fretted-strings" texidoc = " diff --git a/Documentation/snippets/modern-tab-text-clef.ly b/Documentation/snippets/modern-tab-text-clef.ly index d0f3b2cb8a..145880c9b9 100644 --- a/Documentation/snippets/modern-tab-text-clef.ly +++ b/Documentation/snippets/modern-tab-text-clef.ly @@ -5,6 +5,14 @@ \version "2.13.18" \header { +%% Translation of GIT committish: ee2fdacf2ff3acd7e6fb7c4005dfe698b1cc4eed + texidoc = " +Utilice un texto de marcado para sustituir el glifo de clave (TAB) con +una fuente tipográfica moderna. + +" + doctitle = "Clave de texto TAB moderna para tablatura" + lsrtags = "staff-notation, fretted-strings" texidoc = " diff --git a/Documentation/snippets/numbers-as-easy-note-heads.ly b/Documentation/snippets/numbers-as-easy-note-heads.ly index a4e5884a46..b83455a251 100644 --- a/Documentation/snippets/numbers-as-easy-note-heads.ly +++ b/Documentation/snippets/numbers-as-easy-note-heads.ly @@ -5,6 +5,22 @@ \version "2.13.18" \header { +%% Translation of GIT committish: ee2fdacf2ff3acd7e6fb7c4005dfe698b1cc4eed + texidoc = " + +Las cabezas de nota de notación fácil utilizan la propiedad +@code{note-names} del objeto @code{NoteHead} para determinad lo que +aparece dentro de la cabeza. Mediante la sobreescritura de esta +propiedad, es posible imprimir números que representen el grado de la +escala. + +Se puede crear un grabador simple que haga esto para la cabeza de cada +nota que ve. + +" + + doctitle = "Números como notas de notación fácil" + lsrtags = "pitches" texidoc = " Easy notation note heads use the @code{note-names} property diff --git a/Documentation/snippets/scheme-engraver-ambitus.ly b/Documentation/snippets/scheme-engraver-ambitus.ly index 0458a89fb6..2a9de17fbf 100644 --- a/Documentation/snippets/scheme-engraver-ambitus.ly +++ b/Documentation/snippets/scheme-engraver-ambitus.ly @@ -5,6 +5,19 @@ \version "2.13.18" \header { +%% Translation of GIT committish: ee2fdacf2ff3acd7e6fb7c4005dfe698b1cc4eed + + texidoc = " +Este ejemplo demuestra cómo se puede definir el grabador de ámbito en +el espacio del usuario, con un grabador de Scheme. + +Esto es básicamente una reescritura en Scheme del código de +@file{lily/ambitus-engraver.cc}. + +" + + doctitle = "Definir un grabador en Scheme: grabador de ámbito" + lsrtags = "contexts-and-engravers" diff --git a/Documentation/snippets/using-ly-grob-object-to-access-grobs-with--tweak.ly b/Documentation/snippets/using-ly-grob-object-to-access-grobs-with--tweak.ly index 66fb591ebc..c27f75ba23 100644 --- a/Documentation/snippets/using-ly-grob-object-to-access-grobs-with--tweak.ly +++ b/Documentation/snippets/using-ly-grob-object-to-access-grobs-with--tweak.ly @@ -5,6 +5,46 @@ \version "2.13.18" \header { +%% Translation of GIT committish: ee2fdacf2ff3acd7e6fb7c4005dfe698b1cc4eed + + texidoc = " + +Se puede acceder @qq{lateralmente} a algunos grobs desde dentro de la +función de callback de otro grob. Éstos se encuentran relacionados +normalmente como @qq{layout objects} (objetos de presentación) en la +sección @qq{Internal properties} (propiedades internas) de un +interface de grob. Se usa la función @code{ly:grob-object} para +acceder a estos grobs. + + +Se presentan más abajo como ejemplo algunas formas de addecer a grobs +desde dentro de una función de callback de NoteHead, pero la técnica +no se limita a las cabezas de nota. Sin embargo, la función de +callback de NoteHead es especialmente importante, porque es la función +de callback implícita que utiliza la instrucción @code{\\tweak}. + + +La función de ejemplo que se define abajo (\"display-grobs\") no es +probablemente tan útil, pero muestra que se está accediendo +efectivamente a los grobs. + + +Salida de ejemplo de la consola: + + +@example +-------------------- +#-Grob Accidental - +#-Grob Arpeggio - +#-Grob Stem - +@end example + + +" + + doctitle = "Utilizar ly:grob-object para acceder a los grobs con \\tweak" + + lsrtags = "tweaks-and-overrides" texidoc = " diff --git a/Documentation/snippets/using-the-whiteout-property.ly b/Documentation/snippets/using-the-whiteout-property.ly index 8efbcf1f58..2905204537 100644 --- a/Documentation/snippets/using-the-whiteout-property.ly +++ b/Documentation/snippets/using-the-whiteout-property.ly @@ -5,6 +5,31 @@ \version "2.13.18" \header { +%% Translation of GIT committish: ee2fdacf2ff3acd7e6fb7c4005dfe698b1cc4eed + + texidoc = " + +Se puede imprimir cualquier objeto gráfico sobre un fondo blanco para +enmascarar parte de los objetos que están por debajo. Esto puede ser +útil para mejorar el aspecto de las colisiones en situaciones +complejas cuando no es práctico reposicionar los objetos. Es +necesario establecer explícitamente la propiedad de capa +(@code{layer}) para controlar qué objetos resultan enmascarados por el +fondo blanco. + +En este ejemplo, la colisión de la ligadura de unión con la indicación +de compás resulta mejorada enmascarando la parte de la ligadura que +cruza a la indicación de compás mediante el establecimiento de la +propiedad @code{whiteout} de @code{TimeSignature}. Para hacer esto, +se mueve @code{TimeSignature} a una capa por encima de @code{Tie}, que +se deja en la capa predeterminada de 1, y @code{StaffSymbol} se mueve +a una capa por encima de @code{TimeSignature} de manera que no resulte +enmascarada. + +" + + doctitle = "Uso de la propiedad whiteout" + lsrtags = "expressive-marks, editorial-annotations" texidoc = " Any graphical object can be printed over a white backgound to -- 2.39.2