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 fe5277c361dd461b7447b4b201e88647374960f8..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,32 +69,36 @@ 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
 
-@predefined
 
+@predefined
 @funindex \textLengthOn
 @code{\textLengthOn},
 @funindex \textLengthOff
-@code{\textLengthOff}
+@code{\textLengthOff}.
+@endpredefined
 
 
 @seealso
-
 Referencia de la notación:
 @ref{Formatting text},
 @ref{Direction and placement}.
@@ -107,6 +109,7 @@ Fragmentos de código:
 Referencia de funcionamiento interno:
 @rinternals{TextScript}.
 
+
 @knownissues
 
 La comprobación necesaria para asegurar que las inscripciones de texto
@@ -128,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
@@ -143,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
@@ -154,20 +157,22 @@ El estilo de la línea, así como la cadena de texto, se pueden definir
 como una propiedad de objeto.  Esta sintaxis se describe en @ref{Line
 styles}.
 
-@predefined
 
+@predefined
 @funindex textSpannerUp
 @code{\textSpannerUp},
 @funindex textSpannerDown
 @code{\textSpannerDown},
 @funindex textSpannerNeutral
-@code{\textSpannerNeutral}
+@code{\textSpannerNeutral}.
+@endpredefined
 
-@seealso
 
+@seealso
 Referencia de la notación:
 @ref{Line styles},
-@ref{Dynamics}.
+@ref{Dynamics},
+@ref{Direction and placement}.
 
 Fragmentos de código:
 @rlsr{Text}.
@@ -191,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
@@ -202,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>
@@ -212,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
@@ -227,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
@@ -246,8 +251,8 @@ c  c
 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
 {printing-marks-on-every-staff.ly}
 
-@seealso
 
+@seealso
 Referencia de la notación:
 @ref{Rehearsal marks},
 @ref{Formatting text},
@@ -260,6 +265,7 @@ Fragmentos de código:
 Referencia de funcionamiento interno:
 @rinternals{RehearsalMark}.
 
+
 @knownissues
 @c  To be removed when Issue 69 in the tracker gets fixed. -vv
 
@@ -274,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
@@ -291,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
 }
@@ -308,19 +313,20 @@ posibilitando la impresión de documentos de texto o libros
 íntegramente desde LilyPond.  Esta funcionalidad y la sintaxis que
 requiere se describen en @ref{Multi-page markup}.
 
-@predefined
 
+@predefined
+@funindex \markuplines
 @code{\markup},
-@code{\markuplines}
+@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:
 @ref{Formatting text},
 @ref{File structure},
@@ -375,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" }
@@ -398,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
@@ -437,7 +443,6 @@ específicas de @code{\markup} en @ref{Text markup commands}.
 
 
 @seealso
-
 Referencia de la notación:
 @ref{Text markup commands}.
 
@@ -593,27 +598,28 @@ utilización personalizada de las fuentes tipográficas en @ref{Font}.
 También es posible definir conjuntos personalizados de fuentes, tal y
 como se explica en @ref{Fonts}.
 
-@predefined
 
+@predefined
 @funindex \teeny
-@funindex \tiny
-@funindex \small
-@funindex \normalsize
-@funindex \large
-@funindex \huge
-@funindex \smaller
-@funindex \larger
 @code{\teeny},
+@funindex \tiny
 @code{\tiny},
+@funindex \small
 @code{\small},
+@funindex \normalsize
 @code{\normalsize},
+@funindex \large
 @code{\large},
+@funindex \huge
 @code{\huge},
+@funindex \smaller
 @code{\smaller},
+@funindex \larger
 @code{\larger}.
+@endpredefined
 
-@seealso
 
+@seealso
 Referencia de la notación:
 @ref{Font},
 @ref{New dynamic marks},
@@ -650,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 }
@@ -669,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 }
@@ -699,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 }
@@ -720,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"
@@ -836,8 +842,8 @@ la izquierda o justificados, como se muestra en el ejemplo siguiente.
 Hay una lista exhaustiva de instrucciones de alineación de texto en
 @ref{Align}.
 
-@seealso
 
+@seealso
 Manual de aprendizaje:
 @rlearning{Moving objects}.
 
@@ -972,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"
@@ -995,8 +1001,8 @@ c
 Hay una lista exhaustiva de instrucciones específicas de gráficos en
 @ref{Graphic}.
 
-@seealso
 
+@seealso
 Referencia de la notación:
 @ref{Graphic},
 @ref{Editorial annotations}.
@@ -1021,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
   =
@@ -1042,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
@@ -1065,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
@@ -1073,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;"
 }
@@ -1109,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 { }
   }
 }
@@ -1123,8 +1129,8 @@ c d e f
 Hay una lista exhaustiva de instrucciones relacionadas con la notación
 musical en @ref{Music}.
 
-@seealso
 
+@seealso
 Referencia de la notación:
 @ref{Music},
 @ref{The Feta font},
@@ -1156,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.
     ...
   }
@@ -1177,8 +1183,8 @@ o una lista de listas de marcado.
 Hay una lista exhaustiva de las instrucciones de lista de marcado en
 @ref{Text markup list commands}.
 
-@seealso
 
+@seealso
 Referencia de la notación:
 @ref{Text markup list commands},
 @ref{New markup list command definition}.
@@ -1192,9 +1198,11 @@ Referencia de funcionamiento interno:
 Archivos de inicio:
 @file{scm/@/define@/-markup@/-commands@/.scm}.
 
+
 @predefined
 @funindex \markuplines
-@code{\markuplines}
+@code{\markuplines}.
+@endpredefined
 
 
 @node Fonts
@@ -1215,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.
@@ -1227,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)
@@ -1243,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
@@ -1254,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
@@ -1293,16 +1314,13 @@ este caso es preferible usar la sintaxis sencilla que se explica en
 }
 @end lilypond
 
-@ignore
-@c FIXME: This needs an example -vv
+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}.
 
-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
 
 @seealso
-
 Referencia de la notación:
 @ref{The Feta font},
 @ref{Music notation inside markup},
@@ -1317,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 }
 }
@@ -1341,8 +1359,8 @@ lilypond -dshow-available-fonts x
 El último argumento de la instrucción puede ser cualquiera, pero debe
 estar presente.
 
-@seealso
 
+@seealso
 Referencia de la notación:
 @ref{Fonts explained},
 @ref{Entire document fonts}.
@@ -1353,14 +1371,15 @@ Fragmentos de código:
 Archivos de inicio:
 @file{lily/@/font@/-config@/-scheme@/.cc}.
 
+
 @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
@@ -1386,8 +1405,8 @@ respectivamente como tipografías @emph{romana}, @emph{sans-serif} y
 @c we don't do Helvetica / Courier, since GS incorrectly loads
 @c Apple TTF fonts
 
-@seealso
 
+@seealso
 Referencia de la notación:
 @ref{Fonts explained},
 @ref{Single entry fonts},