X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fes%2Fuser%2Ftext.itely;h=231d78e0072cc280051e32bee25f5c2b9769eef6;hb=a8c9e8a7ca320ab0df5fd32e717fd62cd7635ce6;hp=fe5277c361dd461b7447b4b201e88647374960f8;hpb=5a46a0878f5d8b89dd60280af3293e19e782b6f7;p=lilypond.git diff --git a/Documentation/es/user/text.itely b/Documentation/es/user/text.itely index fe5277c361..231d78e007 100644 --- 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: 41ef91786a08102d9b9a839f6a2f40cec263d723 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:: @@ -62,8 +63,8 @@ indicaciones se pueden colocar también manulamente encima o debajo del pentagrama utilizando la sintaxis que se describe en @ref{Direction and placement}. -@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,8 +72,8 @@ 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 @@ -81,22 +82,22 @@ 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 +108,7 @@ Fragmentos de código: Referencia de funcionamiento interno: @rinternals{TextScript}. + @knownissues La comprobación necesaria para asegurar que las inscripciones de texto @@ -131,7 +133,7 @@ compases mediante líneas de puntos. Estos objetos, que reciben el nombre de @q{spanners} u objetos de extensión, se pueden crear dede 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 +145,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,17 +156,18 @@ 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}. @@ -191,7 +194,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 +205,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 @@ -214,8 +217,8 @@ 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}: -@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 +230,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 +249,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 +263,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 +278,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 +294,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 +311,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 +379,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 +402,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 +441,6 @@ específicas de @code{\markup} en @ref{Text markup commands}. @seealso - Referencia de la notación: @ref{Text markup commands}. @@ -593,27 +596,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}, @@ -654,7 +658,7 @@ foma 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 +673,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 +703,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,7 +729,7 @@ 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 +840,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 +976,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 +999,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 +1025,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 +1046,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 +1069,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,7 +1077,11 @@ c,8._\markup { \musicglyph #"clefs.G_change" } c16 c2^\markup { \musicglyph #"timesig.neomensural94" } @end lilypond + @c TODO: add \lookup here? -vv +@c Probably better not to document \lookup, which is useful only for +@c printing braces, and instead document \left-brace and \right-brace +@c when these become available -td @noindent Otra forma de imprimir glifos que no son de texto se encuentra @@ -1082,7 +1090,7 @@ descrita en @ref{Fonts explained}. 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 +1117,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 +1131,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 +1164,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 +1185,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 +1200,11 @@ Referencia de funcionamiento interno: Archivos de inicio: @file{scm/@/define@/-markup@/-commands@/.scm}. + @predefined @funindex \markuplines -@code{\markuplines} +@code{\markuplines}. +@endpredefined @node Fonts @@ -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) @@ -1254,16 +1264,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 +1304,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 +1325,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 +1349,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 +1361,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 +1395,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},