X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fes%2Fuser%2Ftext.itely;h=869c7c7192524a761c4f1e42f46b171cb57f732b;hb=1423508c355989fa26a8cfe5985b0d6e1ab0a538;hp=3cabc78a01ac9a4251d5e9027190029f880f5db0;hpb=31c5fd7a58a5db058a4aea65eb2957d12f7dab76;p=lilypond.git diff --git a/Documentation/es/user/text.itely b/Documentation/es/user/text.itely index 3cabc78a01..869c7c7192 100644 --- a/Documentation/es/user/text.itely +++ b/Documentation/es/user/text.itely @@ -1,12 +1,12 @@ -@c -*- coding: utf-8; mode: texinfo; -*- +@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*- @ignore - Translation of GIT committish: 7c57f1469e057f25f5d7a7b75c18f33bb4e5bed9 + 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.61" +@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,11 +131,11 @@ 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] -\override TextSpanner #'bound-details #'left #'text = "rit." +@lilypond[verbatim,quote,relative=2] +\override TextSpanner #'(bound-details left text) = "rit." b1\startTextSpan e,\stopTextSpan @end lilypond @@ -143,8 +146,8 @@ 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] -\override TextSpanner #'bound-details #'left #'text = +@lilypond[quote,relative=2,verbatim] +\override TextSpanner #'(bound-details left text) = \markup { \upright "rit." } b1\startTextSpan c e,\stopTextSpan @@ -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] 1 \mark \markup { \italic { colla parte } } 2 @@ -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] -2 +@lilypond[quote,verbatim,relative=2] +2 \mark \markup { \musicglyph #"scripts.ufermata" } 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" @@ -827,7 +833,7 @@ la izquierda o justificados, como se muestra en el ejemplo siguiente. (Calle de Granada. Fachada de la casa de Carmela y su hermano Manuel con grandes ventanas abiertas a través de las que se ve el patio - donde se celebra una alegre fiesta.) + donde se celebra una alegre fiesta) } } } @@ -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},