]> git.donarmstrong.com Git - lilypond.git/commitdiff
Doc-es: update Tweaks, Changing, Fretted, Input, Appendices.
authorFrancisco Vila <francisco.vila@hispalinux.es>
Wed, 22 Feb 2012 16:16:19 +0000 (17:16 +0100)
committerFrancisco Vila <francisco.vila@hispalinux.es>
Thu, 23 Feb 2012 09:46:37 +0000 (10:46 +0100)
Documentation/es/learning/tweaks.itely
Documentation/es/notation/changing-defaults.itely
Documentation/es/notation/fretted-strings.itely
Documentation/es/notation/input.itely
Documentation/es/notation/notation-appendices.itely

index 38c7d2d77a780f6c33d1c8b053f618d10b985bb0..e37194885b5a3038593f8922cc56244b360c65d3 100644 (file)
@@ -1,7 +1,7 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
 
 @ignore
-    Translation of GIT committish: d6b6b53d09a0fb8e137e7cfcec39fe22dc7b6872
+    Translation of GIT committish: 1f0a00b69403290b7fc7527b9ab100f95533f954
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  For details, see the Contributors'
@@ -332,8 +332,10 @@ detalles consulte @rextend{Trucos difíciles}.
 @funindex tweak
 
 La última instrucción de trucaje que está disponible es @code{\tweak}.
-Se debe utilizar para cambiar las propiedades de objetos que suceden
-en el mismo momento musical, como las notas de un acorde.  El uso de
+Se debe utilizar cuando varios objetos tienen lugar
+en el mismo momento musical pero solo queremos cambiar las propiedades
+de algunos de ellos, como una sola nota dentro de un acorde.
+El uso de
 @code{\override} para la sobreescritura afectaría a todas las notas
 del acorde, mientras que @code{\tweak} afecta solamente al siguiente
 elemento del flujo de entrada.
@@ -364,11 +366,7 @@ el elemento inmediatamente siguiente dentro del flujo de entrada.  Sin
 embargo, es efectivo solamente sobre objetos que se crean directamente
 a partir del flujo de entrada, en esencia las cabezas y las
 articulaciones; los objetos como las plicas y las alteraciones se
-crean con posterioridad y no se pueden trucar de esta forma.  Es más,
-cuando se aplica a las cabezas de las notas, éstas @emph{deben} estar
-dentro de un acorde, es decir, dentro de ángulos simples, así que para
-trucar una sola nota la instrucción @code{\tweak} se debe colocar
-dentro de ángulos simples junto con la nota.
+crean con posterioridad y no se pueden trucar de esta forma.
 
 Así pues, volviendo a nuestro ejemplo, el tamaño de la nota intermedia
 se cambiaría de la siguiente forma:
@@ -406,7 +404,10 @@ a4^"Black"
 
 @noindent
 Observe que la instrucción @code{\tweak} debe venir precedida de una
-marca de articulación como si ella misma fuera una articulación.
+marca de articulación porque la propia expresión trucada debe aplicarse
+como una articulación.  En el caso de más de una sobreescritura de dirección
+(@code{^} o @code{_}), gana la sobreescritura situada más a la izquierda
+porque se aplica en último lugar.
 
 @cindex grupos especiales anidados
 @cindex tresillos anidados
@@ -3794,7 +3795,7 @@ VerseOne = \lyrics {
 }
 
 VerseTwo = \lyricmode {
-  O | \emphasize Christ, \normal whose voice the | wa -- ters heard,
+  O | \once \emphasize Christ, whose voice the | wa -- ters heard,
 }
 
 VerseThree = \lyricmode {
@@ -3844,19 +3845,17 @@ las partes que tienen todos los @code{#()}.  Esto se explicará en
 @lilypond[quote,verbatim,ragged-right]
 mpdolce =
 #(make-dynamic-script
-  (markup #:hspace 0
-          #:translate '(5 . 0)
-          #:line (#:dynamic "mp"
-                  #:text #:italic "dolce")))
+  #{ \markup { \hspace #0
+               \translate #'(5 . 0)
+               \line { \dynamic "mp"
+                       \text \italic "dolce" } }
+  #})
 
 inst =
 #(define-music-function
      (parser location string)
      (string?)
-   (make-music
-    'TextScriptEvent
-    'direction UP
-    'text (markup #:bold (#:box string))))
+   #{ ^\markup \bold \box #string #})
 
 \relative c'' {
   \tempo 4=50
@@ -3883,19 +3882,17 @@ otro archivo:
 %%% guardar esto en un archivo de nombre "definiciones.ily"
 mpdolce =
 #(make-dynamic-script
-  (markup #:hspace 0
-          #:translate '(5 . 0)
-          #:line (#:dynamic "mp"
-                  #:text #:italic "dolce")))
+  #@{ \markup @{ \hspace #0
+               \translate #'(5 . 0)
+               \line @{ \dynamic "mp"
+                       \text \italic "dolce" @} @}
+  #@})
 
 inst =
 #(define-music-function
      (parser location string)
      (string?)
-   (make-music
-    'TextScriptEvent
-    'direction UP
-    'text (markup #:bold (#:box string))))
+   #@{ ^\markup \bold \box #string #@})
 @end example
 
 Haremos referencia a este archivo utilizando la instrucción
@@ -3924,19 +3921,17 @@ archivo como @file{musica.ly}).
 @lilypond[quote,ragged-right]
 mpdolce =
 #(make-dynamic-script
-  (markup #:hspace 0
-          #:translate '(5 . 0)
-          #:line (#:dynamic "mp"
-                  #:text #:italic "dolce")))
+  #{ \markup { \hspace #0
+               \translate #'(5 . 0)
+               \line { \dynamic "mp"
+                       \text \italic "dolce" } }
+  #})
 
 inst =
 #(define-music-function
      (parser location string)
      (string?)
-   (make-music
-    'TextScriptEvent
-    'direction UP
-    'text (markup #:bold (#:box string))))
+   #{ ^\markup \bold \box #string #})
 
 \relative c'' {
   \tempo 4=50
@@ -3962,19 +3957,17 @@ Sustituyamos nuestro archivo @file{definiciones.ily} con éste:
 %%%  definiciones.ily
 mpdolce =
 #(make-dynamic-script
-  (markup #:hspace 0
-          #:translate '(5 . 0)
-          #:line (#:dynamic "mp"
-                  #:text #:italic "dolce")))
+  #@{ \markup @{ \hspace #0
+               \translate #'(5 . 0)
+               \line @{ \dynamic "mp"
+                       \text \italic "dolce" @} @}
+  #@})
 
 inst =
 #(define-music-function
      (parser location string)
      (string?)
-   (make-music
-    'TextScriptEvent
-    'direction UP
-    'text (markup #:bold (#:box string))))
+   #@{ ^\markup \bold \box #string #@})
 
 \layout@{
   \context @{
@@ -3997,19 +3990,17 @@ inst =
 @lilypond[quote,ragged-right]
 mpdolce =
 #(make-dynamic-script
-  (markup #:hspace 0
-          #:translate '(5 . 0)
-          #:line (#:dynamic "mp"
-                  #:text #:italic "dolce")))
+  #{ \markup { \hspace #0
+               \translate #'(5 . 0)
+               \line { \dynamic "mp"
+                       \text \italic "dolce" } }
+  #})
 
 inst =
 #(define-music-function
      (parser location string)
      (string?)
-   (make-music
-    'TextScriptEvent
-    'direction UP
-    'text (markup #:bold (#:box string))))
+   #{ ^\markup \bold \box #string #})
 
 \layout{
   \context {
@@ -4050,19 +4041,17 @@ también vamos a aumentar el tamaño general de la salida.
 %%%  definiciones.ily
 mpdolce =
 #(make-dynamic-script
-  (markup #:hspace 0
-          #:translate '(5 . 0)
-          #:line (#:dynamic "mp"
-                  #:text #:italic "dolce")))
+  #@{ \markup @{ \hspace #0
+               \translate #'(5 . 0)
+               \line @{ \dynamic "mp"
+                       \text \italic "dolce" @} @}
+  #@})
 
 inst =
 #(define-music-function
      (parser location string)
      (string?)
-   (make-music
-    'TextScriptEvent
-    'direction UP
-    'text (markup #:bold (#:box string))))
+   #@{ ^\markup \bold \box #string #@})
 
 #(set-global-staff-size 23)
 
@@ -4086,19 +4075,17 @@ inst =
 @lilypond[quote,ragged-right]
 mpdolce =
 #(make-dynamic-script
-  (markup #:hspace 0
-          #:translate '(5 . 0)
-          #:line (#:dynamic "mp"
-                  #:text #:italic "dolce")))
+  #{ \markup { \hspace #0
+               \translate #'(5 . 0)
+               \line { \dynamic "mp"
+                       \text \italic "dolce" } }
+  #})
 
 inst =
 #(define-music-function
      (parser location string)
      (string?)
-   (make-music
-    'TextScriptEvent
-    'direction UP
-    'text (markup #:bold (#:box string))))
+   #{ ^\markup \bold \box #string #})
 
 #(set-global-staff-size 23)
 
index f6b45f646af79ac12c0c85a53ab4e13e3a0b38d0..46f36c5339084af95c8f764e3e39a7aaa649193e 100644 (file)
@@ -1,7 +1,7 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
 
 @ignore
-Translation of GIT committish: ffb5c20633459831cea21859f3423ea50060d705
+Translation of GIT committish: 18cfd801fa7fcd698e924f3b530862714f3e3013
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  For details, see the Contributors'
@@ -3222,6 +3222,7 @@ ajustes finos a la apariencia de la partitura impresa.
 * Agrupación vertical de objetos gráficos::
 * Modificación de los sellos::
 * Modificación de las formas::
+* Contenedores unpure-pure::
 @end menu
 
 
@@ -3764,6 +3765,116 @@ inicio y la dirección según se requiera.
 Referencia de funcionamiento interno:
 @rinternals{TieColumn}.
 
+@cindex Scheme, contenedores puros
+@cindex Scheme, contenedores no-puros
+@cindex puros, contenedores de Scheme
+@cindex no-puros: contenedores de Scheme
+@cindex horizontal, sobreescribir el espaciado
+
+@node Contenedores unpure-pure
+@subsection Contenedores unpure-pure
+@translationof Unpure-pure containers
+
+Los contenedores @q{unpure-pure} (pura y no pura) son útiles para la
+sobreescritura de los cálculos del espaciado en el @emph{eje Y}
+(concretamente @code{Y-offset} e @code{Y-extent}) con una función de
+Scheme en lugar de un literal, es decir, un número o una pareja de
+números.
+
+Para ciertos objetos gráficos, las dimensiones @code{Y-extent} están
+basadas en la propiedad @code{stencil}, la sobreescritura de la
+propiedad de sello de éstos requiere una sobreescritura adicional de
+@code{Y-extent} con un contenedor unpure-pure.  Cuando una función
+sobreescribe una dimensión @code{Y-offset} y/o @code{Y-extent} se
+supone que esto dispara los cálculos de los saltos de línea
+prematuramente durante la compilación.  Así pues, la función no se
+evalúa en absoluto (devolviendo por lo general un valor de @samp{0} o
+@samp{'(0 . 0)}) lo que puede dar lugar a colisiones.  Una función
+@q{pura} no afecta a las propiedades, objetos o suicidios de grobs, y
+por ello siempre ven sus valores relacionados con el eje Y evaluados
+correctamente.
+
+Actualmente hay unas treinta funciones que ya se consideran @q{puras}
+y los contenedores Unpure-pure son una manera de establecer funciones
+que no están en esta lista como @q{puras}.  La función @q{pura} se
+evalúa @emph{antes} de cualquier salto de línea y así el espaciado
+horizontal se puede ajustar @q{a tiempo}.  La función @q{impura} se
+evalúa entonces @emph{después} del salto de línea.
+
+@warning{Dado que es difícil saber siempre qué funciones están en esta
+lista, recomendamos que cualquier función @q{pura} que estemos creando
+no utilice los grobs @code{Beam} o @code{VerticalAlignment}.}
+
+Un contenedor @q{unpure-pure} se contruye de la manera siguiente:
+
+@code{(ly:make-unpure-pure-container f0 f1)}
+
+donde @code{f0} es una función que toma @var{n} argumentos (@var{n >=
+1}) y el primer argumento siempre debe ser el grob.  Ésta es la
+función que da el resultado real.  @var{f1} es la función que se
+etiqueta como @q{pura} que toma @var{n + 2} argumentos.  De nuevo, el
+primer argumento debe ser siempre el grob pero los argumentos segundo
+y tercero son argumentos de @q{inicio} y de @q{final}.
+
+@var{inicio} y @var{final} son, a todos los efectos, valores mudos que
+sólo tienen importancia para los @code{objetos de extensión} (o sea:
+@code{Hairpin}, regulador, o @code{Beam}, barra), que pueden devolver
+distintas estimaciones de altura basadas en una columna de inicio y
+una de final.
+
+El resto son los otros argumentos para la primera función (que puede
+no ser ninguno si @var{n = 1}).
+
+El resultado de la segunda función se usa como una aproximación del
+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.
+
+@lilypond[verbatim,quote,ragged-right]
+#(define (square-line-circle-space grob)
+(let* ((pitch (ly:event-property (ly:grob-property grob 'cause) 'pitch))
+      (notename (ly:pitch-notename pitch)))
+ (if (= 0 (modulo notename 2))
+     (make-circle-stencil 0.5 0.0 #t)
+     (make-filled-box-stencil '(0 . 1.0)
+                              '(-0.5 . 0.5)))))
+
+squareLineCircleSpace = {
+  \override NoteHead #'stencil = #square-line-circle-space
+}
+
+smartSquareLineCircleSpace = {
+  \squareLineCircleSpace
+  \override NoteHead #'Y-extent =
+   #(ly:make-unpure-pure-container
+      ly:grob::stencil-height
+      (lambda (grob start end) (ly:grob::stencil-height grob)))
+}
+
+\new Voice \with { \remove "Stem_engraver" }
+\relative c'' {
+  \squareLineCircleSpace
+  cis4 ces cisis c
+  \smartSquareLineCircleSpace
+  cis4 ces cisis c
+}
+@end lilypond
+
+En el primer compás, sin el contenedor @emph{unpure-pure}, el motor de
+espaciado no conoce la anchura de la cabeza de la nota y permite que
+colisione con las alteraciones accidentales.  En el segundo compás, el
+motor de espaciado conoce la anchura de las cabezas de las notas y
+evita la colisión mediante el alargamiento de la línea en la medida
+adecuada.
+
+Normalmente, para cálculos simples se pueden usar funciones casi
+idénticas tanto para las partes @q{no pura} y @q{pura}, simplemente
+cambiando el número de argumentos que se pasan a, y el ámbito de, la
+función.
+
+@warning{Si una función está caracterizada como @q{pura} y resulta que
+no lo es, el resultado puede ser inesperado.}
+
 
 @node Uso de las funciones musicales
 @section Uso de las funciones musicales
index a450966f1b1ac2dc285223b343c12871a239d744..b558b6b225a5d9298a24a2993cf7c8614f33608c 100644 (file)
@@ -1,7 +1,7 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
 
 @ignore
-    Translation of GIT committish: 9630731c95c8e1c64dc3588d8b37edce83dc9fa0
+    Translation of GIT committish: 940309ad0e403897f556c8253e69708121b91765
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  For details, see the Contributors'
@@ -267,33 +267,34 @@ es 0.
 >>
 @end lilypond
 
-@funindex \tabChordRepetition
+@funindex \tabChordRepeats
+@funindex \chordRepeats
 @cindex acordes, repetición de
 @cindex repetición con @code{q}
 
 Las construcciones de acorde se pueden repetir mediante el símbolo de
-repetición de acordes @code{q}.  Para utilizar esta posibilidad en
-combinación con la tablatura, se proporciona
-@code{\tabChordRepetition}, que preserva la información de cuerdas
-dada explícitamente dentro de las construcciones de acorde, de forma
-que los acordes repetidos den lugar a representaciones de tablatura
-idénticas.
+repetición de acordes @code{q}.  En combinación con las tablaturas, su
+comportamiento de eliminar números de cuerda y de dedos junto a otros
+eventos es fastidioso, por lo que quizá quiera ejecutar
+@example
+\chordRepeats #'(string-number-event fingering-event)
+@end example
+explícitamente sobre expresiones musicales en las tablaturas que
+utilicen @ref{Repetición de acordes}.  Esta instrucción en particular
+es tan común que está disponible como @code{\tabChordRepeats}.
 
 @lilypond[quote,verbatim]
-\tabChordRepetition
-
 guitar = \relative c' {
-  r8 <gis\4 cis\3 b\2>~ q4 q8~ q q4
+  r8 <gis-6 cis-6 b-0>~ q4 q8~ q q4
 }
 
 \new StaffGroup <<
   \new Staff {
     \clef "treble_8"
-    \override Voice.StringNumber #'transparent = ##t
     \guitar
   }
   \new TabStaff {
-    \guitar
+    \tabChordRepeats \guitar
   }
 >>
 @end lilypond
@@ -391,9 +392,9 @@ como sus alturas de sonido:
 
 @lilypond[verbatim,quote]
 firstHarmonic = {
-  <d'\4\harmonic>4
-  <g'\3\harmonic>4
-  <b'\2\harmonic>2
+  d'4\4\harmonic
+  g'4\3\harmonic
+  b'2\2\harmonic
 }
 \score {
   <<
@@ -403,12 +404,12 @@ firstHarmonic = {
 }
 @end lilypond
 
-Observe que la instrucción @code{\harmonic} se debe situar siempre
-dentro de una construcción de acorde. Sólo tiene sentido para
-armónicos sobre una cuerda abierta en el duodécimo traste.  Cualquier
-otro armónico debe estar calculado por parte de LilyPond.  Se puede
-conseguir esto indicando el traste en que debe rozar la cuerda el dedo
-de la mano que pisa.
+Observe que la instrucción @code{\harmonic} se debe adjuntar siempre a
+notas individuales (posiblemente dentro de un acorde) en lugar de a
+acordes completos. Sólo tiene sentido para armónicos sobre una cuerda
+abierta en el duodécimo traste.  Cualquier otro armónico debe estar
+calculado por parte de LilyPond.  Se puede conseguir esto indicando el
+traste en que debe rozar la cuerda el dedo de la mano que pisa.
 
 @lilypond[verbatim,quote]
 fretHarmonics = {
index d9af64c417f7afa714092d642cb0e33a56ecc926..99087ae5639ee663f2996fead97631089c900f87 100644 (file)
@@ -1,7 +1,7 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
 
 @ignore
-    Translation of GIT committish: 69618c55ab79b032a109ba9f347831ede1048abc
+    Translation of GIT committish: 18cfd801fa7fcd698e924f3b530862714f3e3013
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  For details, see the Contributors'
@@ -1090,7 +1090,7 @@ los indicadores (y por tanto las notas al pie) durante la compilación.
 @translationof Automatic footnotes
 
 Las notas al pie automáticas aceptan tres argumentos; el @var{Objeto de
-presentación} que anotar, la posición @var{(x . y)} del indicador y un
+presentación} que anotar, la posición @samp{(x . y)} del indicador y un
 elemento de @code{\markup} que aparecerá en la nota, en la parte
 inferior de la página.
 
@@ -1187,7 +1187,7 @@ uso de la instrucción @code{\auto-footnote}:
 
 Las notas al pie manuales toman cuatro argumentos;
 el @var{objeto de presentación} que se va a anotar,
-la posición @var{(x . y)} del indicador, y dos instrucciones
+la posición @samp{(x . y)} del indicador, y dos instrucciones
 @code{\markup}; la primera es el indicador adjunto a la nota o grob, y
 la segunda es la nota al pie, en la parte inferior de la página.
 
index 62a914b45ab0f6b498a9fe57911cad7d1beb59ca..406622566172fc1d85f9f1665ec0683ba4dce7f0 100644 (file)
@@ -1,7 +1,7 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
 
 @ignore
-    Translation of GIT committish: 3c77203e4d07000d4d888df5f5031a3623d43980
+    Translation of GIT committish: 18dda6b2f5fbea91a174b60eb22bbb73591b9b64
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  For details, see the Contributors'
@@ -648,6 +648,7 @@ consulte @ref{Formatear el texto}.
 * Glifos de neomensural::
 * Glifos de Petrucci::
 * Glifos de Solesmes::
+* Glifos de la notación del canto kievano::
 @end menu
 
 
@@ -913,6 +914,15 @@ consulte @ref{Formatear el texto}.
             \doc-chars #solesmes
 @end lilypond
 
+@node Glifos de la notación del canto kievano
+@unnumberedsubsec Glifos de la notación del canto kievano
+@translationof Kievan Notation glyphs
+
+@lilypond[quote]
+\include "font-table.ly"
+\markuplist \override-lines #'(word-space . 4)
+            \doc-chars #kievan
+@end lilypond
 
 @node Estilos de cabezas de nota
 @appendixsec Estilos de cabezas de nota