lilypond-book robustness: ensure EOL at the end of @verbatim

[lilypond.git] / Documentation / es / user / tweaks.itely

diff --git a/Documentation/es/user/tweaks.itely b/Documentation/es/user/tweaks.itely
index 363f66c31d19bd35c9151f7f7ac4a3e92e440ac1..55874258b91b59c4b0fe6f996b8850bdf56dd61d 100644 (file)
--- a/Documentation/es/user/tweaks.itely
+++ b/Documentation/es/user/tweaks.itely
@@ -1,13 +1,13 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
 @c This file is part of lilypond.tely
 @ignore
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
 @c This file is part of lilypond.tely
 @ignore

-    Translation of GIT committish: 17d84cfa9ddb152b05d1e17ab72109fb4eefa684
+    Translation of GIT committish: 45945bd973aa9161b10e3f517902afb7ef4b4a56

 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  See TRANSLATION for details.
 @end ignore
 
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  See TRANSLATION for details.
 @end ignore
 

-@c \version "2.11.65"
+@c \version "2.12.0"

 
 @node Tweaking output
 @chapter Tweaking output
 
 @node Tweaking output
 @chapter Tweaking output


@@ -126,8 +126,8 @@ que vamos a utilizar en este capítulo.
 @node Naming conventions of objects and properties
 @subsection Naming conventions of objects and properties
 
 @node Naming conventions of objects and properties
 @subsection Naming conventions of objects and properties
 

-@cindex nomemclatura, convenciones de, para objetos
-@cindex nomemclatura, convenciones de, para propiedades
+@cindex nomenclatura, convenciones de, para objetos
+@cindex nomenclatura, convenciones de, para propiedades

 @cindex objetos, convenciones de nomenclatura
 @cindex propiedades, convenciones de nomenclatura
 
 @cindex objetos, convenciones de nomenclatura
 @cindex propiedades, convenciones de nomenclatura
 


@@ -187,13 +187,13 @@ Ya hemos visto las instrucciones @code{\set} y @code{\with}, que se
 usan para cambiar las propiedades de los @strong{contextos} y para
 quitar y poner @strong{grabadores}, en @ref{Modifying context
 properties} y @ref{Adding and removing engravers}.  Ahora debemos
 usan para cambiar las propiedades de los @strong{contextos} y para
 quitar y poner @strong{grabadores}, en @ref{Modifying context
 properties} y @ref{Adding and removing engravers}.  Ahora debemos

-examinar algunas instrucciones importantes más.
+examinar algunas otras instrucciones importantes.

 
 La instrucción que cambia las propiedades de los @strong{objetos de
 presentación} es @code{\override}.  Puesto que esta instrucción debe
 modificar propiedades internas que se encuentran en un lugar profundo
 dentro de LilyPond, su sintaxis no es tan simple como la del resto de
 
 La instrucción que cambia las propiedades de los @strong{objetos de
 presentación} es @code{\override}.  Puesto que esta instrucción debe
 modificar propiedades internas que se encuentran en un lugar profundo
 dentro de LilyPond, su sintaxis no es tan simple como la del resto de

-las instrucciones que hemos visto hasta ahora.  Tiene que saber
+las instrucciones que hemos usado hasta ahora.  Tiene que saber

 exactamente qué propiedad de qué objeto y en qué contexto se debe
 modificar, y cuál debe ser su nuevo valor.  Veamos cómo se hace.
 
 exactamente qué propiedad de qué objeto y en qué contexto se debe
 modificar, y cuál debe ser su nuevo valor.  Veamos cómo se hace.
 


@@ -371,14 +371,14 @@ se cambiaría de la siguiente forma:
 @end lilypond
 
 Observe que la sintaxis de @code{\tweak} no es igual que la de
 @end lilypond
 
 Observe que la sintaxis de @code{\tweak} no es igual que la de

-@code{\override}.  Ni el contexto ni el objeto de
-presentación se deben especificar; de hecho, generaría un error
-hacerlo.  Los dos están implícitos por el siguiente elemento del flujo
-de entrada.  Así que la sintaxis genérica de la instrucción
-@code{\tweak} es, simplemente,
+@code{\override}.  Ni el contexto ni el objeto de presentación se
+deben especificar; de hecho, generaría un error hacerlo.  Los dos
+están implícitos por el siguiente elemento del flujo de entrada.
+Observe también que no debe haber un signo igual. Así que la sintaxis
+genérica de la instrucción @code{\tweak} es, simplemente,

 
 @example
 
 @example

-\tweak #'@var{propiedad-de-presentación} = #@var{valor}
+\tweak #'@var{propiedad-de-presentación} #@var{valor}

 @end example
 
 Una instrucción @code{\tweak} también se puede usar para modificar
 @end example
 
 Una instrucción @code{\tweak} también se puede usar para modificar


@@ -853,15 +853,15 @@ relacionados con los símbolos y las cadenas, consulte @ref{Scheme
 tutorial}.
 
 Así pues, la instrucción @code{\override} que necesitamos para
 tutorial}.
 
 Así pues, la instrucción @code{\override} que necesitamos para

-imprimir la letra en cursiva sería
+imprimir la letra en cursiva, es:

 
 @example
 \override LyricText #'font-shape = #'italic
 @end example
 
 @noindent
 
 @example
 \override LyricText #'font-shape = #'italic
 @end example
 
 @noindent

-y debe colocarse justo delante de, y cerca de, la letra a la que debe
-afectar, como esto:
+Esto debe escribirse justo delante de la letra a la que debe afectar,
+de esta forma:

 
 @cindex font-shape, propiedad, ejemplo
 @cindex italic, ejemplo
 
 @cindex font-shape, propiedad, ejemplo
 @cindex italic, ejemplo


@@ -1070,10 +1070,10 @@ contextos en los que el grabador de líneas divisorias opera.  Todos
 ellos son del tipo @code{Staff}, y así la razón de que la instrucción
 @code{\override} no funcionara como esperábamos, es porque
 @code{Barline} no se encuentra en el contexto predeterminado
 ellos son del tipo @code{Staff}, y así la razón de que la instrucción
 @code{\override} no funcionara como esperábamos, es porque
 @code{Barline} no se encuentra en el contexto predeterminado

-@code{Voice}.  Si el contexto se especifica mal, la instrucción
-simplemente no funciona.  No se produce ningún mensaje de error, y no
-se registra nada en el archivo log de registro.  Vamos a intentar
-corregirlo escribiendo el contexto correcto:
+@code{Voice}.  Si el contexto no se especifica correctamente, la
+instrucción simplemente no funciona.  No se produce ningún mensaje de
+error, y no se registra nada en el archivo log de registro.  Vamos a
+intentar corregirlo escribiendo el contexto correcto:

 
 @cindex BarLine, ejemplo de sobreescritura
 @cindex stencil, propiedad, ejemplo
 
 @cindex BarLine, ejemplo de sobreescritura
 @cindex stencil, propiedad, ejemplo


@@ -1090,6 +1090,22 @@ corregirlo escribiendo el contexto correcto:
 
 Ahora las barras de compás han desaparecido.
 
 
 Ahora las barras de compás han desaparecido.
 

+Sin embargo, observe que el establecimiento de la propiedad
+@code{stencil} al valor @code{#f} produce errores cuando las se
+requieren las dimensiones del objeto para un procesamiento correcto.
+Por ejemplo, se generan errores si la propiedad @code{stencil} del
+objeto @code{NoteHead} se establece al valor @code{#f}.  Si es el
+caso, podemos en vez de ello utilizar la función @code{point-stencil},
+que establece el sello a un objeto con tamaño nulo:
+
+@lilypond[quote,verbatim,relative=2]
+{
+  c c
+  \once \override NoteHead #'stencil = #point-stencil
+  c c
+}
+@end lilypond
+

 @subheading break-visibility
 
 @cindex break-visibility, propiedad
 @subheading break-visibility
 
 @cindex break-visibility, propiedad


@@ -1343,7 +1359,7 @@ pentagrama temporal, como en un @rglos{ossia}.
          <<
            { f c c }
            \new Staff \with {
          <<
            { f c c }
            \new Staff \with {

-             alignAboveContext = "main" }
+             alignAboveContext = #"main" }

            { f8 f c }
          >>
          r4 |
            { f8 f c }
          >>
          r4 |


@@ -1370,7 +1386,7 @@ el sello de cada uno de ellos a @code{#f}, como sigue:
     <<
       { f c c }
       \new Staff \with {
     <<
       { f c c }
       \new Staff \with {

-        alignAboveContext = "main"
+        alignAboveContext = #"main"

       }
       {
         \override Staff.Clef #'stencil = ##f
       }
       {
         \override Staff.Clef #'stencil = ##f


@@ -1433,7 +1449,7 @@ Así pues, podemos reemplazar el ejemplo anterior con
     <<
       { f c c }
       \new Staff \with {
     <<
       { f c c }
       \new Staff \with {

-        alignAboveContext = "main"
+        alignAboveContext = #"main"

         % Don't print clefs in this staff
         \override Clef #'stencil = ##f
         % Don't print time signatures in this staff
         % Don't print clefs in this staff
         \override Clef #'stencil = ##f
         % Don't print time signatures in this staff


@@ -1503,7 +1519,7 @@ Vamos a probarlo en nuestro ejemplo del ossia:
     <<
       { f c c }
       \new Staff \with {
     <<
       { f c c }
       \new Staff \with {

-        alignAboveContext = "main"
+        alignAboveContext = #"main"

         \override Clef #'stencil = ##f
         \override TimeSignature #'stencil = ##f
         % Reduce all font sizes by ~24%
         \override Clef #'stencil = ##f
         \override TimeSignature #'stencil = ##f
         % Reduce all font sizes by ~24%


@@ -1558,7 +1574,7 @@ siguiente forma:
 @cindex TimeSignature, ejemplo de sobreescritura
 @cindex fontSize, propiedad, ejemplo
 @cindex StaffSymbol, ejemplo de sobreescritura
 @cindex TimeSignature, ejemplo de sobreescritura
 @cindex fontSize, propiedad, ejemplo
 @cindex StaffSymbol, ejemplo de sobreescritura

-@cindex magstep function, ejemplo de utilización
+@cindex magstep, función, ejemplo de utilización

 @cindex staff-space, propiedad, ejemplo
 @cindex stencil, propiedad, ejemplo
 
 @cindex staff-space, propiedad, ejemplo
 @cindex stencil, propiedad, ejemplo
 


@@ -1570,7 +1586,7 @@ siguiente forma:
     <<
       { f c c }
       \new Staff \with {
     <<
       { f c c }
       \new Staff \with {

-        alignAboveContext = "main"
+        alignAboveContext = #"main"

         \override Clef #'stencil = ##f
         \override TimeSignature #'stencil = ##f
         fontSize = #-2
         \override Clef #'stencil = ##f
         \override TimeSignature #'stencil = ##f
         fontSize = #-2


@@ -1704,7 +1720,7 @@ pentagramas adyacentes:
 @node Within-staff objects
 @subsection Within-staff objects
 
 @node Within-staff objects
 @subsection Within-staff objects
 

-Ya hemos visto cómo las instrucciones @code{\voiceXXX} affectan a la
+Ya hemos visto cómo las instrucciones @code{\voiceXXX} afectan a la

 dirección de las ligaduras de expresión y de unión, digitaciones y
 todo lo demás que dependa de la dirección de las plicas.  Cuando se
 escribe música polifónica, estas instrucciones son esenciales para que
 dirección de las ligaduras de expresión y de unión, digitaciones y
 todo lo demás que dependa de la dirección de las plicas.  Cuando se
 escribe música polifónica, estas instrucciones son esenciales para que


@@ -1830,7 +1846,7 @@ digitación encima, debajo, a la izquierda o a la derecha de cada nota.
 
 En primer lugar, he aquí el efecto de @code{direction} sobre las
 digitaciones aplicadas a notas sueltas.  Se muestra en el primer
 
 En primer lugar, he aquí el efecto de @code{direction} sobre las
 digitaciones aplicadas a notas sueltas.  Se muestra en el primer

-compás el comportamiento predeterminado, y en los dos comases
+compás el comportamiento predeterminado, y en los dos compases

 siguiente el efecto de especificar @code{DOWN} y @code{UP}:
 
 @cindex Fingering, ejemplo de sobreescritura
 siguiente el efecto de especificar @code{DOWN} y @code{UP}:
 
 @cindex Fingering, ejemplo de sobreescritura


@@ -2121,6 +2137,35 @@ c\ff c \stopTextSpan
 c, c c c
 @end lilypond
 
 c, c c c
 @end lilypond
 

+@cindex ligaduras y outside-staff-priority
+@cindex ligaduras y articulaciones
+@cindex articulaciones y ligaduras
+
+De forma predeterminada, las ligaduras de expresión están clasificadas
+como objetos dentro-del-pentagrama, pero con frecuencia aparecen
+encima del pentagrama si las notas que une son muy agudas.  Ello puede
+empujar a una posición muy elevada a los objetos fuera-del-pentagrama
+como las articulaciones, pues la ligadura se colocará en primer lugar.
+La propiedad @code{avoid-slur} de la articulación se puede establecer
+al valor @code{'inside} (por dentro) para llevarla al interior de la
+ligadura, pero la propiedad @code{avoid-slur} es efectiva solamente si
+la prioridad @code{outside-staff-priority} está también ajustada al
+valor @code{#f}.  De forma alternativa, la prioridad
+@code{outside-staff-priority} de la ligadura se puede fijar en un
+valor numérico para hacer que se sitúe en línea con otros objetos
+fuera del pentagrama de acuerdo con este valor.  He aquí un ejemplo
+que muestra el efecto de los dos métodos:
+
+@lilypond[quote,verbatim,relative=2]
+c4( c^\markup\tiny\sharp d4.) c8
+c4(
+\once \override TextScript #'avoid-slur = #'inside
+\once \override TextScript #'outside-staff-priority = ##f
+c^\markup\tiny\sharp d4.) c8
+\once \override Slur #'outside-staff-priority = #500
+c4( c^\markup\tiny\sharp d4.) c8
+@end lilypond
+

 Los cambios en @code{outside-staff-priority} también se pueden emplear
 para controlar la situación vertical de los objetos individuales,
 aunque los resultados pueden no siempre ser deseables.  Suponga que
 Los cambios en @code{outside-staff-priority} también se pueden emplear
 para controlar la situación vertical de los objetos individuales,
 aunque los resultados pueden no siempre ser deseables.  Suponga que


@@ -2344,9 +2389,9 @@ que se estudia en la sección siguiente.
 
 @cindex mover objetos superpuestos
 @cindex mover objetos que colisionan
 
 @cindex mover objetos superpuestos
 @cindex mover objetos que colisionan

-@cindex moving grobs que colisionan
+@cindex mover grobs que colisionan

 @cindex objetos que colisionan, mover
 @cindex objetos que colisionan, mover

-@cindex grobs, mover, que colisionan
+@cindex grobs que colisionan, mover

 
 Aunque pueda sorprenderle, LilyPond no es perfecto.  Ciertos elementos
 de notación se pueden superponer, lo que es una lástima, pero en
 
 Aunque pueda sorprenderle, LilyPond no es perfecto.  Ciertos elementos
 de notación se pueden superponer, lo que es una lástima, pero en


@@ -3027,7 +3072,7 @@ que lo más fácil es introducir estas cuatro voces temporalmente en el
 momento en que se necesiten.  Si ha olvidado cómo hacerlo, lea
 @ref{I'm hearing Voices}.  Vamos a comenzar introduciendo las notas
 como dos variables y disponiendo la estructura de pentagramas en un
 momento en que se necesiten.  Si ha olvidado cómo hacerlo, lea
 @ref{I'm hearing Voices}.  Vamos a comenzar introduciendo las notas
 como dos variables y disponiendo la estructura de pentagramas en un

-bloque score, y veremos qué produce LilyPond de forma predeterminada:
+bloque Score, y veremos qué produce LilyPond de forma predeterminada:

 
 @lilypond[quote,verbatim,ragged-right]
 rhMusic = \relative c'' {
 
 @lilypond[quote,verbatim,ragged-right]
 rhMusic = \relative c'' {


@@ -3537,7 +3582,7 @@ Ambos métodos quitan de la salida impresa la indicación metronómica
 que alarga el calderón, y los dos afectan al tempo del MIDI tal y como
 queríamos, pero la indicación metronómica transparente de la primera
 línea fuerza una colocación muy alta de la indicación de tempo que
 que alarga el calderón, y los dos afectan al tempo del MIDI tal y como
 queríamos, pero la indicación metronómica transparente de la primera
 línea fuerza una colocación muy alta de la indicación de tempo que

-sigue, meintras que la segunda (con el sello suprimido) no lo hace.
+sigue, mientras que la segunda (con el sello suprimido) no lo hace.

 
 @node Using variables for tweaks
 @subsection Using variables for tweaks
 
 @node Using variables for tweaks
 @subsection Using variables for tweaks


@@ -3550,12 +3595,16 @@ Las instrucciones de sobreescritura son con frecuencia largas y
 tediosas de escribir, y se tienen que escribir de forma absolutamente
 correcta.  Si las mismas sobreescrituras se van a utilizar muchas
 veces, podría merecer la pena definir variables para guardarlas.
 tediosas de escribir, y se tienen que escribir de forma absolutamente
 correcta.  Si las mismas sobreescrituras se van a utilizar muchas
 veces, podría merecer la pena definir variables para guardarlas.

-Suponga que queremos realzar ciertas palabras de la letra de una
+
+Supongamos que queremos realzar ciertas palabras de la letra de una

 canción imprimiéndolas en cursiva y negrita.  Las instrucciones
 @code{\italic} y @code{\bold} sólo funcionan dentro de la letra de las
 canción imprimiéndolas en cursiva y negrita.  Las instrucciones
 @code{\italic} y @code{\bold} sólo funcionan dentro de la letra de las

-canciones si están incluidas dentro de un @code{\markup}, lo que las
-hace tediosas de escribir.  ¿Podríamos, como alternativa, utilizar las
-instrucciones @code{\override} y @code{\revert}?
+canciones si están incluidas, junto con la palabra o palabras que se
+pretenden modificar, dentro de un @code{\markup}, lo que las hace
+tediosas de escribir. La necesidad de incluir las propias palabras
+impide que se puedan usar en variables simples. ¿Podríamos, como
+alternativa, utilizar las instrucciones @code{\override} y
+@code{\revert}?

 
 @example
 @code{\override Lyrics . LyricText #'font-shape = #'italic}
 
 @example
 @code{\override Lyrics . LyricText #'font-shape = #'italic}


@@ -3566,9 +3615,13 @@ instrucciones @code{\override} y @code{\revert}?
 @end example
 
 Estas instrucciones también serían extremadamente tediosas de escribir
 @end example
 
 Estas instrucciones también serían extremadamente tediosas de escribir

-si hubiera muchas palabras que quisiéramos subrayar.  Entonces, en vez
-de esto las definimos como dos variables, y las usamos de la siguiente
-forma, aunque normalmente quizá elegiríamos unos nombres de variable
+si hubiera muchas palabras que quisiéramos subrayar.  Pero sí
+@emph{podemos} definirlas como dos variables y usarlas para delimitar
+las palabras que destacar.  Otra ventaja de la utilización de
+variables para estas sobreescrituras es que ya no son necesarios los
+espacios que rodean al punto, puesto que no se interpretan
+directamente en el modo @code{\lyricmode}.  He aquí un ejemplo de
+esto, aunque en la práctica quizá elegiríamos unos nombres de variable

 más cortos para que fueran más rápidos de teclear:
 
 @cindex LyricText, ejemplo de sobreescritura
 más cortos para que fueran más rápidos de teclear:
 
 @cindex LyricText, ejemplo de sobreescritura


@@ -3577,12 +3630,12 @@ más cortos para que fueran más rápidos de teclear:
 
 @lilypond[quote,verbatim]
 emphasize = {
 
 @lilypond[quote,verbatim]
 emphasize = {

-  \override Lyrics . LyricText #'font-shape = #'italic
-  \override Lyrics . LyricText #'font-series = #'bold
+  \override Lyrics.LyricText #'font-shape = #'italic
+  \override Lyrics.LyricText #'font-series = #'bold

 }
 normal = {
 }
 normal = {

-  \revert Lyrics . LyricText #'font-shape
-  \revert Lyrics . LyricText #'font-series
+  \revert Lyrics.LyricText #'font-shape
+  \revert Lyrics.LyricText #'font-series

 }
 
 global = { \time 4/4 \partial 4 \key c \major}
 }
 
 global = { \time 4/4 \partial 4 \key c \major}


@@ -3793,7 +3846,7 @@ dinámicamente a un valor determinado por el procedimiento en el
 momento en que se invoca.  En este ejemplo damos a las cabezas de las
 notas un color que depende de su posición dentro del pentagrama.
 
 momento en que se invoca.  En este ejemplo damos a las cabezas de las
 notas un color que depende de su posición dentro del pentagrama.
 

-@cindex x11-color function, ejemplo de utilización
+@cindex x11-color, función, ejemplo de utilización

 @cindex NoteHead, ejemplo de sobreescritura
 @cindex color, propiedad, establecer a procedimiento de Scheme
 
 @cindex NoteHead, ejemplo de sobreescritura
 @cindex color, propiedad, establecer a procedimiento de Scheme