1 @c -*- coding: utf-8; mode: texinfo; -*-
3 Translation of GIT committish: a00fb9828b12ac0c12e0aa18628e6cb6eb2dce2f
5 When revising a translation, copy the HEAD committish of the
6 version that you are working on. See TRANSLATION for details.
14 @lilypondfile[quote]{text-headword.ly}
16 Esta sección explica cómo incluir texto (con diversos estilos de
17 formateo) en las partituras.
20 Ciertos elementos de texto de los que no nos ocupamos aquí se tratan
21 en otras secciones específicas: @ref{Vocal music}, @ref{Titles and
24 @cindex texto, en otros idiomas
25 @warning{Para escribir texto con caracteres acentuados y especiales
26 (como los de idiomas distintos del inglés), sencillamente inserte los
27 caracteres directamente en el archivo de LilyPond. El archivo se debe
28 guardar como UTF-8. Para ver más información, consulte @ref{Text
39 @subsection Writing text
41 Esta sección presenta las distintas formas de añadir texto a una
52 @subsubsection Text scripts
54 @cindex Texto, inscripciones de
55 @cindex texto, elementos no vacíos de
56 @cindex no vacíos, textos
58 Es posible añadir cadenas de texto arbitrarias a una partitura, como
59 se muestra en el ejemplo siguiente. Tales indicaciones se pueden
60 colocar también manulamente encima o debajo del pentagrama utilizando
61 la sintaxis simple que se describe en @ref{Direction and placement}.
63 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
64 d8^"pizz." e f g a4-"scherz." f
67 En LilyPond, estas cadenas de texto se llaman objetos de
68 @command{markup} o de marcado. Esta sintaxis es en realidad una
69 abreviatura; se puede añadir explícitamente a una nota un formateado
70 de texto más complejo utilizando un bloque @code{\markup}, como se
71 describe bajo @ref{Formatting text}.
73 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
74 d8^\markup { \italic pizz. } e f g
75 a4_\markup { \tiny scherz. \bold molto } f
78 De forma predeterminada, las indicaciones de texto no afectan al
79 espaciado de las notas. Sin embargo, su anchura sí podría tenerse en
80 cuenta: en el siguiente ejemplo, la primera cadena de texto no afecta
81 al espaciado, pero la segunda sí afecta.
83 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
84 d8^"pizz." e f g \textLengthOn a4_"scherzando" f
89 @funindex \textLengthOn
91 @funindex \textLengthOff
97 Referencia de la notación:
98 @ref{Formatting text},
99 @ref{Direction and placement}.
101 Fragmentos de código:
104 Referencia de funcionamiento interno:
105 @rinternals{TextScript}.
109 La comprobación necesaria para asegurar que las inscripciones de texto
110 y la letra de las canciones se mantienen dentro de los márgenes, es
111 una tarea computacional relativamente grande. Para acelerar el
112 procesado, LilyPond no realiza estos cálculos de forma predeterminada;
113 para habilitarlos, utilice
116 \override Score.PaperColumn #'keep-inside-line = ##t
121 @subsubsection Text spanners
123 @cindex text spanners
125 Ciertas indicaciones de ejecución, p.ej., @i{rallentando} o
126 @i{accelerando}, se escriben como texto y se extienden sobre muchos
127 compases mediante líneas de puntos. Estos objetos, que reciben el
128 nombre de @q{spanners} u objetos de extensión, se pueden crear dede
129 una nota hasta otra usando la siguiente sintaxis:
131 @lilypond[verbatim,quote,ragged-right,fragment,relative=2]
132 \override TextSpanner #'bound-details #'left #'text = "rit."
138 La cadena de texto que imprimir se establece a través de propiedades
139 de objeto. De forma predeterminada se imprime en estilo cursiva, pero
140 se pueden conseguir distintos efectos de formato utilizando bloques
141 @code{\markup}, como se describe en @ref{Formatting text}.
143 @lilypond[quote,ragged-right,fragment,relative=2,verbatim]
144 \override TextSpanner #'bound-details #'left #'text =
145 \markup { \upright "rit." }
150 El estilo de la línea, así como la cadena de texto, se pueden definir
151 como una propiedad de objeto. Esta sintaxis se describe en @ref{Line
156 @funindex textSpannerUp
157 @code{\textSpannerUp},
158 @funindex textSpannerDown
159 @code{\textSpannerDown},
160 @funindex textSpannerNeutral
161 @code{\textSpannerNeutral}
165 Referencia de la notación:
168 Fragmentos de código:
171 Referencia de funcionamiento interno:
172 @rinternals{TextSpanner}.
176 @subsubsection Text marks
178 @cindex coda sobre la línea divisoria
179 @cindex segno sobre la línea divisoria
180 @cindex calderón sobre la línea divisoria
181 @cindex líneas divisorias, símbolos sobre las
184 Se pueden añadir a la partitura varios elementos de texto con la
185 sintaxis que se describe en @ref{Rehearsal marks}:
187 @lilypond[verbatim,quote,ragged-right,fragment,relative=2]
188 c4\mark "Allegro" c c c
191 Esta sintaxis posibilita colocar cualquier texto sobre la línea
192 divisoria; se pueden incorporar formatos más complejos para el texto
193 usando un bloque @code{\markup}, como está explicado en
194 @ref{Formatting text}. Esto se puede usar para imprimir letraros como
195 coda, segno o calderón, especificando el nombre del símbolo
198 @lilypond[fragment,quote,ragged-right,verbatim,relative=2]
199 c1 \mark \markup { \musicglyph #"scripts.ufermata" }
204 Estos objetos se tipografían solamente sobre el pentagrama superior de
205 la partitura; dependiendo de si están especificados al final o en
206 medio de un compás, se colocarán sobre la línea divisoria o entra las
207 notas. Si se especifican al principio de la partitura o en un salto
208 de línea, las llamadas se imprimen al principio de la línea (o de la
209 línea siguiente, en el caso de un salto de línea).
211 @lilypond[fragment,quote,ragged-right,verbatim,relative=2]
213 c\mark "assai" \break
220 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
221 {printing-marks-at-the-end-of-a-line-or-a-score.ly}
223 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
224 {aligning-marks-with-various-notation-objects.ly}
226 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
227 {printing-marks-on-every-staff.ly}
231 Referencia de la notación:
232 @ref{Rehearsal marks},
233 @ref{Formatting text},
236 Fragmentos de código:
239 Referencia de funcionamiento interno:
240 @rinternals{RehearsalMark}.
243 @c IMO this is a bug; hopefully it'll be fixed soon, so I can
244 @c delete this sentence. -gp
245 @c A workaround is suggested in the first @snippets item -vv
247 Si se introduce una llamada al final del último compás de la partitura
248 (donde no hay línea siguiente), la llamada no se imprime en absoluto.
251 @subsubsection Separate text
253 @cindex separate text
254 @cindex standalone text
255 @cindex top-level text
256 @cindex text, standalone
259 Un bloque @code{\markup} puede existir de forma independiente, fuera
260 de cualquier bloque @code{\score}, como una @qq{expresión de nivel
261 superior}. Esta sintaxis se describe en @ref{File structure}.
263 @lilypond[verbatim,quote]
265 Tomorrow, and tomorrow, and tomorrow...
270 Esto hace posible imprimir texto separado de la música, lo que es
271 especialmente útil cuando el archivo de entrada contiene varias
272 piezas, tal y como se describe en @ref{Multiple scores in a book}.
274 @lilypond[quote,ragged-right,verbatim]
279 Tomorrow, and tomorrow, and tomorrow...
286 Usando una sintaxis específica, los bloques de texto se pueden
287 repartir entre varias páginas, posibilitando la impresión de
288 documentos de texto o libros (y por tanto para usar LilyPond como un
289 editor de textos). Esta sintaxis se describe en @ref{Multi-page
296 @funindex \markuplines
302 TODO: add convenient snippets in input/new -vv
307 Referencia de la notación:
308 @ref{Formatting text},
309 @ref{File structure},
310 @ref{Multiple scores in a book},
311 @ref{Multi-page markup}.
313 Fragmentos de código:
316 Referencia de funcionamiento interno:
317 @rinternals{TextScript}.
320 @node Formatting text
321 @subsection Formatting text
323 Esta sección presenta los formateados básico y avanzado de texto,
324 usando la sintaxis específica del modo de @code{\markup}.
327 * Text markup introduction::
328 * Selecting font and font size::
330 * Graphic notation inside markup::
331 * Music notation inside markup::
332 * Multi-page markup::
335 @node Text markup introduction
336 @subsubsection Text markup introduction
339 @cindex texto, marcado de
340 @cindex marcado de texto
341 @cindex tipografiar texto
343 Se usa un bloque @code{\markup} para tipografiar texto con una
344 sintaxis ampliable específica que se denomina @qq{modo de marcado}.
346 @cindex marcado, expresiones de
347 @cindex marcado, sintaxis
349 La sintaxis del marcado es similar a la sintaxis usual de LilyPond:
350 una expresión @code{\markup} se encierra entre llaves
351 @code{@{ @dots{} @}}.
353 En el modo de marcado, las instrucciones específicas se introducen
354 mediante la barra invertida @code{\}. Estas instrucciones sólo
355 afectan a la primera expresión que venga a continuación.
357 Las expresiones de marcado también se pueden encerrar entre comillas
358 @code{"..."}. Estas expresiones se escriben como cadenas de texto y no
359 pueden contener expresiones anidadas ni otras instrucciones. Por
360 tanto, generalmente se prefieren las llaves a las comillas; el ejemplo
361 siguiente muestra las dos sintaxis.
363 @lilypond[quote,verbatim,fragment,relative=1]
365 a2^\markup { poco \italic più forte }
367 d2_\markup { \italic "string. assai" }
369 b1^\markup { \bold { molto \italic agitato } }
373 @cindex caracteres especiales en modo de marcado
374 @cindex marcado, caracteres especiales en modo de
375 @cindex reservados, impresión de caracteres
376 @cindex impresión de caracteres especiales
378 Los caracteres especiales como @code{\} y @code{#} se pueden imprimir
379 fácilmente utilizando comillas. Las propias comillas sólo se imprimen
380 cuando se preceden por una barra invertida:
382 @lilypond[quote,verbatim,fragment,relative=1]
384 a^\markup "##\ LEPORELLO \##"
385 a_\markup "Bravi! \"Cosa rara\"!"
390 La forma en que están definidas las expresiones de marcado afectan a
391 la manera en que se apilan, se centran o se alinean al usar las
392 instrucciones descritas en @ref{Text alignment}.
394 @lilypond[quote,verbatim,fragment,relative=1]
395 c1^\markup { \column { a bbbb \line { c d } } }
396 c1^\markup { \center-align { a bbbb c } }
397 c1^\markup { \line { a b c } }
400 No se conservan como independientes aquellas listas de palabras que no
401 estén encerradas entre comillas o precedidas de una instrucción
402 previa. En el ejemplo siguiente, las dos primeras expresiones
403 @code{\markup} son equivalentes:
405 @lilypond[quote,verbatim,fragment,relative=1]
406 c1^\markup { \center-align { a bbb c } }
407 c1^\markup { \center-align { a { bbb c } } }
408 c1^\markup { \center-align { a \line { bbb c } } }
412 Los marcados se pueden almacenar dentro de variables. Estas variables
413 se pueden adjuntar directamente a las notas:
415 @lilypond[quote,verbatim]
416 allegro = \markup { \bold \large Allegro }
426 Se puede encontrar una lista exhaustiva de las instrucciones
427 específicas de @code{\markup} en @ref{Text markup commands}.
433 @ref{Text markup commands}.
435 Fragmentos de código:
438 Referencia de funcionamiento interno:
439 @rinternals{TextScript}.
442 @file{scm/@/new@/-markup@/.scm}.
447 @c FIXME: this is totally deprecated, isn't it? -vv
448 @c Kerning or generation of ligatures is only done when the @TeX{}
449 @c backend is used. In this case, LilyPond does not account for them
450 @c so texts will be spaced slightly too wide.
452 @c is the following sentence really relevant? -vv
453 Los errores de sintaxis para el modo de marcado a menudo producen
457 @node Selecting font and font size
458 @subsubsection Selecting font and font size
460 UNTRANSLATED NODE: IGNORE ME
463 @subsubsection Text alignment
465 UNTRANSLATED NODE: IGNORE ME
467 @node Graphic notation inside markup
468 @subsubsection Graphic notation inside markup
470 UNTRANSLATED NODE: IGNORE ME
472 @node Music notation inside markup
473 @subsubsection Music notation inside markup
475 UNTRANSLATED NODE: IGNORE ME
477 @node Multi-page markup
478 @subsubsection Multi-page markup
480 Así como @code{\markup} se utiliza para introducir un bloque de texto
481 no divisible en líneas, se puede usar @code{\markuplines} en el nivel
482 más alto del código para introducir líneas de texto que pueden abarcar
488 Un texto muy largo de líneas justificadas.
492 Otro párrafo muy largo.
499 @code{\markuplines} acepta una lista de marcado, esto es: o bien el
500 resultado de una instrucción de lista de marcado, o bien una lista de
501 elementos de marcado o de listas de marcado. Las instrucciones de
502 lista de marcad predefinidas se explican en @ref{Text markup list
508 @ref{Text markup list commands},
509 @ref{New markup list command definition}.
511 Fragmentos de código:
516 @funindex \markuplines
521 @c TODO: move the following subsubsec into NR3 -vv
527 * Entire document fonts::
528 * Single entry fonts::
531 @node Entire document fonts
532 @subsubsection Entire document fonts
534 También es posible cambiar la familia predeterminada de la fuente
535 tipográfica para todo el documento. Se hace llamando a la función
536 @code{make-pango-font-tree} desde dentro del bloque @code{\paper}.
537 Esta función toma los nombres de las familias de fuente que se quieren
538 usar para el texto en tipo romano, sans-serif y monoespaciado. Por
541 @cindex fuente, establecer la familia de
550 (make-pango-font-tree "Times New Roman"
557 c'^\markup { roman: foo \sans bla \typewriter bar }
561 @c we don't do Helvetica / Courier, since GS incorrectly loads
565 @node Single entry fonts
566 @subsubsection Single entry fonts
568 @cindex fuente, selección
569 @cindex fuente, ampliación
570 @funindex font-interface
572 Mediante el ajusta de las propiedades de objeto descritas a
573 continuación, podemos elegir una fuente de entre las familias
574 preconfiguradas. LilyPond contempla de forma predeterminada las
575 fuentes de música «Feta». Las fuentes del texto se eligen a través de
576 Pango/FontConfig. La fuente de tipo serif predeterminada es New
577 Century Schoolbook, y las fuentes de tipo sans y máquina de escribir a
578 lo que tenga por predeterminado la instalación de Pango.
582 @item @code{font-encoding}
583 es un símbolo que establece la presentación de los glifos. Sólo se
584 debería ajustar para seleccionar distintos tipos de fuente que no sean
587 @code{fetaBraces} para las llaves de los pentagramas de piano,
588 @code{fetaMusic} es la fuente estándar para música, incluidos los
589 glifos de la música antigua, @code{fetaDynamic} para los matices
590 dinámicos y @code{fetaNumber} para los números.
592 @item @code{font-family}
593 es un símbolo que indica la clase general del tipo. Están
594 contempladas @code{roman} (Computer Modern), @code{sans} y
597 @item @code{font-shape}
598 es un símbolo que indica la forma de la fuente. Están disponibles
599 normalmente varias formas de tipografía para cada una de las familas
600 de fuente. se puede elegir entre @code{italic} (cursiva), @code{caps}
601 (versalitas) y @code{upright} (recta).
603 @item @code{font-series}
604 es un símbolo que indica la serie de la tipografía. En general
605 existen varias series de fuente para cada familia y forma de una
606 tipografía. Se puede elegir entre @code{medium} (normal) y
607 @code{bold} (negrita).
611 Las fuentes que se eligen de esta manera provienen de una hoja de
612 estilos predefinida. Si quiere usar una tipografía de fuera de la
613 hoja de estilos establezca el valor de la propiedad @code{font-name}:
615 @lilypond[fragment,verbatim]
617 \override Staff.TimeSignature #'font-name = #"Charter"
618 \override Staff.TimeSignature #'font-size = #2
621 \override #'(font-name . "Vera Bold")
622 { This text is in Vera Bold }
628 Se puede usar cualquier fuente, en la medida en que esté disponible
629 para Pango/FontConfig. Para obtener una lista completa de todas las
630 fuentes dispoonibles, ejecute la instrucción
633 lilypond -dshow-available-fonts blabla
636 (el último argumento puede ser blabla o cualquier otra cosa, pero debe
640 El tamaño de la fuente se puede ajustar con la propiedad
641 @code{font-size}. El tamaño que resulta se considera en relación al
642 tamaño @code{text-font-size} tal y como está definido en el bloque
645 @cindex fuente, tamaño de
646 @cindex fuente, ampliación de la
650 Fragmentos de código: