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

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

diff --git a/Documentation/es/user/text.itely b/Documentation/es/user/text.itely
index 4d2b704e45aa8399cb3efdba9c6a8deed8cfb436..869c7c7192524a761c4f1e42f46b171cb57f732b 100644 (file)
--- a/Documentation/es/user/text.itely
+++ b/Documentation/es/user/text.itely
@@ -1,12 +1,12 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
 @ignore
-    Translation of GIT committish: 0646758d26f727fc27fc13a87df2362388909e5d
+    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
 
-@c \version "2.11.65"
+@c \version "2.12.0"
 
 @node Text
 @section Text
@@ -27,6 +27,12 @@ headers}.
 * Fonts::
 @end menu
 
+@node Writing text
+@subsection Writing text
+
+Esta sección presenta las distintas formas de añadir texto a una
+partitura.
+
 @cindex texto, en otros idiomas
 @warning{Para escribir texto con caracteres acentuados y especiales
 (como los de idiomas distintos del inglés), sencillamente inserte los
@@ -34,11 +40,6 @@ caracteres directamente en el archivo de LilyPond.  El archivo se debe
 guardar como UTF-8.  Para ver más información, consulte @ref{Text
 encoding}.}
 
-@node Writing text
-@subsection Writing text
-
-Esta sección presenta las distintas formas de añadir texto a una
-partitura.
 
 @menu
 * Text scripts::
@@ -56,14 +57,11 @@ partitura.
 @cindex no vacíos, textos
 @cindex texto destacado
 
-Es posible añadir indicaciones de @qq{texto entrecomillado} a una
-partitura, como se muestra en el ejemplo siguiente.  Tales
-indicaciones se pueden colocar también manulamente encima o debajo del
-pentagrama utilizando la sintaxis que se describe en @ref{Direction
-and placement}.
+Es posible añadir indicaciones de @qq{texto entre comillas} a una
+partitura.
 
-@lilypond[quote,fragment,ragged-right,verbatim,relative=1]
-d8^"pizz." e f g a4-"scherz." f
+@lilypond[quote,verbatim,relative=2]
+a8^"pizz." g f e a4-"scherz." f
 @end lilypond
 
 Esta sintaxis es en realidad una abreviatura; se puede añadir
@@ -71,18 +69,22 @@ explícitamente a una nota un formateado de texto más complejo
 utilizando un bloque @code{\markup}, como se describe bajo
 @ref{Formatting text}.
 
-@lilypond[quote,fragment,ragged-right,verbatim,relative=1]
-d8^\markup { \italic pizz. } e f g
+@lilypond[quote,verbatim,relative=2]
+a8^\markup { \italic pizz. } g f e
 a4_\markup { \tiny scherz. \bold molto } f
 @end lilypond
 
+Tales indicaciones se pueden colocar también manualmente encima o
+debajo del pentagrama utilizando la sintaxis que se describe en
+@ref{Direction and placement}.
+
 De forma predeterminada, las indicaciones de texto no afectan al
 espaciado de las notas.  Sin embargo, su anchura sí podría tenerse en
 cuenta: en el siguiente ejemplo, la primera cadena de texto no afecta
 al espaciado, pero la segunda sí afecta.
 
-@lilypond[quote,fragment,ragged-right,verbatim,relative=1]
-d8^"pizz." e f g
+@lilypond[quote,verbatim,relative=2]
+a8^"pizz." g f e
 \textLengthOn
 a4_"scherzando" f
 @end lilypond
@@ -129,10 +131,10 @@ para habilitarlos, utilice
 Ciertas indicaciones de ejecución, p.ej., @i{rallentando} o
 @i{accelerando}, se escriben como texto y se extienden sobre muchos
 compases mediante líneas de puntos.  Estos objetos, que reciben el
-nombre de @q{spanners} u objetos de extensión, se pueden crear dede
+nombre de @q{spanners} u objetos de extensión, se pueden crear desde
 una nota hasta otra usando la siguiente sintaxis:
 
-@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
+@lilypond[verbatim,quote,relative=2]
 \override TextSpanner #'(bound-details left text) = "rit."
 b1\startTextSpan
 e,\stopTextSpan
@@ -144,7 +146,7 @@ de objeto.  De forma predeterminada se imprime en estilo cursiva, pero
 se pueden conseguir distintos efectos de formato utilizando bloques
 @code{\markup}, como se describe en @ref{Formatting text}.
 
-@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
+@lilypond[quote,relative=2,verbatim]
 \override TextSpanner #'(bound-details left text) =
   \markup { \upright "rit." }
 b1\startTextSpan c
@@ -169,7 +171,8 @@ styles}.
 @seealso
 Referencia de la notación:
 @ref{Line styles},
-@ref{Dynamics}.
+@ref{Dynamics},
+@ref{Direction and placement}.
 
 Fragmentos de código:
 @rlsr{Text}.
@@ -193,7 +196,7 @@ sintaxis que se describe en @ref{Rehearsal marks}:
 @c \mark needs to be placed on a separate line (it's not
 @c attached to an object like \markup is). -vv
 
-@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
+@lilypond[verbatim,quote,relative=2]
 c4
 \mark "Allegro"
 c c c
@@ -204,7 +207,7 @@ divisoria; se pueden incorporar formatos más complejos para el texto
 usando un bloque @code{\markup}, como está explicado en
 @ref{Formatting text}:
 
-@lilypond[fragment,quote,ragged-right,verbatim,relative=1]
+@lilypond[quote,verbatim,relative=1]
 <c e>1
 \mark \markup { \italic { colla parte } }
 <d f>2 <e g>
@@ -214,10 +217,10 @@ usando un bloque @code{\markup}, como está explicado en
 @noindent
 Esta sintaxis también permite imprimir símbolos especiales como
 llamadas, segno o calderones, especificando el nombre del símbolo
-correspondiente como se esplica en @ref{Music notation inside markup}:
+correspondiente como se explica en @ref{Music notation inside markup}:
 
-@lilypond[fragment,quote,ragged-right,verbatim,relative=1]
-<f bes>2 <d aes'>
+@lilypond[quote,verbatim,relative=2]
+<bes f>2 <aes d>
 \mark \markup { \musicglyph #"scripts.ufermata" }
 <e g>1
 @end lilypond
@@ -229,7 +232,7 @@ medio de un compás, se colocarán sobre la línea divisoria o entre las
 notas.  Si se especifican en un salto de línea, las llamadas se
 imprimen al principio de la línea siguiente.
 
-@lilypond[fragment,quote,ragged-right,verbatim,relative=2]
+@lilypond[quote,verbatim,relative=2]
 \mark "Allegro"
 c1 c
 \mark "assai" \break
@@ -277,7 +280,6 @@ Si se introduce una llamada al final del último compás de la partitura
 @cindex top-level text
 @cindex text, standalone
 @funindex \markup
-@funindex \markuplines
 
 Un bloque @code{\markup} puede existir de forma independiente, fuera
 de cualquier bloque @code{\score}, como una @qq{expresión de nivel
@@ -294,7 +296,7 @@ Esto hace posible imprimir texto separado de la música, lo que es
 especialmente útil cuando el archivo de entrada contiene varias
 piezas, tal y como se describe en @ref{Multiple scores in a book}.
 
-@lilypond[quote,ragged-right,verbatim]
+@lilypond[quote,verbatim]
 \score {
   c'1
 }
@@ -313,17 +315,16 @@ requiere se describen en @ref{Multi-page markup}.
 
 
 @predefined
+@funindex \markuplines
 @code{\markup},
 @code{\markuplines}.
 @endpredefined
 
 
-@ignore
 @snippets
 
-TODO: add convenient snippets in input/new -vv
-@end ignore
-
+@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
+{stand-alone-two-column-markup.ly}
 
 @seealso
 Referencia de la notación:
@@ -380,8 +381,8 @@ instrucciones de marcado, que se introducen utilizando el carácter de
 barra invertida @code{\} . Estas instrucciones sólo afectan a la
 expresión que sigue inmediatamente.
 
-@lilypond[quote,verbatim,fragment,relative=1]
-e1-\markup intenso
+@lilypond[quote,verbatim,relative=2]
+a1-\markup intenso
 a2^\markup { poco \italic più forte  }
 c e1
 d2_\markup { \italic "string. assai" }
@@ -403,10 +404,10 @@ y por tanto cualquier instrucción de marcado o carácter especial (como
 del texto.  Se puede hacer que se impriman las propias comillas si se
 les antepone una barra invertida.
 
-@lilypond[quote,verbatim,fragment,relative=1]
-d1^"\italic markup..."
-d_\markup { \italic "... prints \"italic\" letters!" }
-d d
+@lilypond[quote,verbatim,relative=2]
+a1^"\italic markup..."
+a_\markup { \italic "... prints \"italic\" letters!" }
+a a
 @end lilypond
 
 Para que se traten como una expresión distinta, es necesario que las
@@ -655,11 +656,11 @@ sintaxis que se describe en @rlearning{Moving objects}.
 @funindex \right-align
 
 Los objetos de marcado se pueden alinear de distintas maneras.  De
-foma predeterminada, una indicación de texto se alinea sobre el borde
+forma predeterminada, una indicación de texto se alinea sobre el borde
 izquierdo: en el ejemplo siguiente, no existe diferencia entre los
 marcados primero y segundo.
 
-@lilypond[quote,verbatim,fragment,relative=1]
+@lilypond[quote,verbatim,relative=2]
 d1-\markup { poco }
 f
 d-\markup { \left-align poco }
@@ -674,7 +675,7 @@ d-\markup { \right-align poco }
 Se puede realizar un ajuste fino de la alineación horizontal usando un
 valor numérico:
 
-@lilypond[quote,verbatim,fragment,relative=1]
+@lilypond[quote,verbatim,relative=2]
 a1-\markup { \halign #-1 poco }
 e'
 a,-\markup { \halign #0 poco }
@@ -704,7 +705,7 @@ o un objeto invisible.  El ejemplo siguiente ejemplifica estas dos
 posibilidades; el último marcado en este ejemplo no tiene punto de
 anclaje y por ello no resulta movido.
 
-@lilypond[quote,verbatim,fragment,relative=1]
+@lilypond[quote,verbatim,relative=1]
 d2^\markup {
   Acte I
   \raise #2 { Scène 1 }
@@ -725,12 +726,12 @@ a'4 a g2 a
 @funindex \translate
 @funindex \translate-scaled
 
-Algunas instrucciones pueden afcetar tanto a la alineación horizontal
+Algunas instrucciones pueden afectar tanto a la alineación horizontal
 como a la vertical de los objetos de texto en el modo de marcado.
 Cualquier objeto afectado por estas instrucciones se deben preceder de
 un punto de anclaje:
 
-@lilypond[quote,verbatim,fragment,relative=1]
+@lilypond[quote,verbatim,relative=1]
 d2^\markup {
   Acte I
   \translate #'(-1 . 2) "Scène 1"
@@ -977,7 +978,7 @@ de gráficos dentro del archivo de entrada, usando código PostScript
 nativo.  En tal caso puede ser de utilidad la especificación explícita
 del tamaño del dibujo, como se ejemplifica a continuación:
 
-@lilypond[quote,verbatim,fragment,relative=1]
+@lilypond[quote,verbatim,relative=1]
 c1^\markup {
   \combine
     \epsfile #X #10 #"./context-example.eps"
@@ -1026,7 +1027,7 @@ musical, dentro de un objeto de marcado.
 Las notas y las alteraciones se pueden escribir utilizando
 instrucciones de marcado:
 
-@lilypond[quote,verbatim,fragment,relative=2]
+@lilypond[quote,verbatim,relative=2]
 a2 a^\markup {
   \note #"4" #1
   =
@@ -1047,7 +1048,7 @@ a1_\markup {
 Otros objetos de notación se pueden también imprimir en el modo de
 marcado:
 
-@lilypond[quote,verbatim,fragment,relative=1]
+@lilypond[quote,verbatim,relative=1]
 g1 bes
 ees-\markup {
   \finger 4
@@ -1070,7 +1071,7 @@ incluir por separado dentro de un objeto de marcado, como se
 ejemplifica a continuación; hay una lista exhaustiva de estos símbolos
 y sus nombres en @ref{The Feta font}.
 
-@lilypond[quote,verbatim,fragment,relative=2]
+@lilypond[quote,verbatim,relative=2]
 c2
 c'^\markup { \musicglyph #"eight" }
 c,4
@@ -1078,16 +1079,16 @@ c,8._\markup { \musicglyph #"clefs.G_change" }
 c16
 c2^\markup { \musicglyph #"timesig.neomensural94" }
 @end lilypond
-@c TODO: add \lookup here? -vv
 
 @noindent
 Otra forma de imprimir glifos que no son de texto se encuentra
-descrita en @ref{Fonts explained}.
+descrita en @ref{Fonts explained}.  Tiene la utilidad de imprimir
+llaves de distintos tamaños.
 
 El modo de marcado también contempla diagramas para instrumentos
 específicos:
 
-@lilypond[quote,verbatim,fragment,relative=2]
+@lilypond[quote,verbatim,relative=2]
 c1^\markup {
   \fret-diagram-terse #"x;x;o;2;3;2;"
 }
@@ -1114,10 +1115,10 @@ Incluso una partitura completa se puede incluir dentro de un objeto de
 marcado.  En tal caso, el bloque anidado @code{\score} debe contener
 un bloque @code{\layout}, como se muestra aquí:
 
-@lilypond[quote,verbatim,fragment,relative=1]
+@lilypond[quote,verbatim,relative=1]
 c4 d^\markup {
   \score {
-    \relative { c4 d e f }
+    \relative c' { c4 d e f }
     \layout { }
   }
 }
@@ -1161,7 +1162,7 @@ que pueden abarcar varias páginas:
     Un texto muy largo de líneas justificadas.
     ...
   }
-  \justified-lines {
+  \wordwrap-lines {
     Otro párrafo muy largo.
     ...
   }
@@ -1222,6 +1223,8 @@ tipográficas, y cómo se pueden cambiar en las partituras.
 
 @cindex Pango
 @cindex fuentes tipográficas, explicación
+@cindex llaves de distintos tamaños
+
 @funindex font-interface
 
 Las fuentes tipográficas se manejan a través de distintas bibliotecas.
@@ -1234,7 +1237,7 @@ siguiente sintaxis permite usar directamente varias tipografías
 @code{feta} de LilyPond distintas a las de texto en el modo de
 marcado:
 
-@lilypond[quote,verbatim,fragment,relative=2]
+@lilypond[quote,verbatim,relative=2]
 a1^\markup {
   \vcenter {
     \override #'(font-encoding . fetaBraces)
@@ -1250,8 +1253,18 @@ a1^\markup {
 @end lilypond
 
 @noindent
-Una sintaxis más simple pero más limitada se describe en @ref{Music
-notation inside markup}.
+Sin embargo, todos estos glifos excepto las llaves de varios tamaños
+que están contenidas en la fuente tipográfica @code{fetaBraces} están
+disponibles utilizando la sintaxis más sencilla que se describe en
+@ref{Music notation inside markup}.
+
+Cuando se usan los glifos de la fuente de llaves @code{fetaBraces}, el
+tamaño de la llave se especifica por la parte numérica del nombre del
+glifo, en unidades arbitrarias.  Se puede especificar cualquier entero
+de @code{0} a @code{575} inclusive, siendo @code{0} el que produce la
+llave más pequeña.  El valor óptimo se debe determinar por ensayo y
+error.  Todos estos glifos son llaves izquierdas; las llaves derechas
+se pueden obtener mediante rotación, véase @ref{Rotating objects}.
 
 Están disponibles tres familias de tipografías de texto: la tipografía
 @emph{romana} (con serifa), que de forma predeterminada es New Century
@@ -1261,16 +1274,17 @@ por la instalación de Pango.
 
 Cada familia puede incluir distintas formas y series.  El ejemplo
 siguiente muestra la posibilidad de seleccionar familias, formas,
-series y tamaños alternativos:
-
-@lilypond[quote,verbatim,fragment,relative=2]
-  \override Score.RehearsalMark #'font-family = #'typewriter
-  \mark \markup "Ouverture"
-  \key d \major
-  \override  Voice.TextScript #'font-shape = #'italic
-  \override  Voice.TextScript #'font-series = #'bold
-  d'2.^\markup "Allegro"
-  r4
+series y tamaños alternativos.  El valor que se da a @code{font-size}
+es el cambio requerido a partir del tamaño predeterminado.
+
+@lilypond[quote,verbatim,relative=2]
+\override Score.RehearsalMark #'font-family = #'typewriter
+\mark \markup "Ouverture"
+\override Voice.TextScript #'font-shape = #'italic
+\override Voice.TextScript #'font-series = #'bold
+d2.^\markup "Allegro"
+\override Voice.TextScript #'font-size = #-3
+c4^smaller
 @end lilypond
 
 @noindent
@@ -1300,13 +1314,10 @@ este caso es preferible usar la sintaxis sencilla que se explica en
 }
 @end lilypond
 
-@ignore
-@c FIXME: This needs an example -vv
-
-The size of the font may be set with the @code{font-size}
-property.  The resulting size is taken relative to the
-@code{text-font-size} as defined in the @code{\paper} block.
-@end ignore
+Aunque es fácil cambiar entre las fuentes tipográficas
+preconfiguradas, también es posible usar otras fuentes, como se
+explica en las siguientes secciones: @ref{Single entry fonts} y
+@ref{Entire document fonts}.
 
 
 @seealso
@@ -1324,12 +1335,12 @@ Se puede usar en una partitura cualquier fuente tipográfica que esté
 instalada en el sistema operativo y reconocida por parte de
 FontConfig, usando la siguiente sintaxis:
 
-@lilypond[quote,verbatim,fragment,relative=1]
+@lilypond[quote,verbatim,relative=2]
 \override Staff.TimeSignature #'font-name = #"Charter"
 \override Staff.TimeSignature #'font-size = #2
 \time 3/4
 
-c1_\markup {
+a1_\markup {
   \override #'(font-name . "Vera Bold")
     { Vera Bold }
 }
@@ -1364,11 +1375,11 @@ Archivos de inicio:
 @node Entire document fonts
 @unnumberedsubsubsec Entire document fonts
 
-Se puede cambiar la familia predeterminada de la fuente tipográfica
-para todo el documento.  En este caso se debe usar la siguiente
-sintaxis, proporcionando tres familias de fuente que se usarán
-respectivamente como tipografías @emph{romana}, @emph{sans-serif} y
-@emph{monoespaciada}, como se explica en @ref{Fonts explained}.
+Se pueden cambiar las fuentes tipográficas que se usan como
+tipografías predeterminadas en las familias @emph{romana},
+@emph{sans-serif} y @emph{monoespaciada}, especificándolas en este
+orden como se ve en el ejemplo de abajo.  Para leer más explicaciones
+sobre las fuentes tipográficas, consulte @ref{Fonts explained}.
 
 @cindex fuente, establecer la familia de
 @funindex make-pango-font-tree