1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
3 Translation of GIT committish: 7ba0a22641cb0c7f5949d66a06d1e2e1fd0b3033
5 When revising a translation, copy the HEAD committish of the
6 version that you are working on. For details, see the Contributors'
7 Guide, node Updating translation committishes..
16 @lilypondfile[quote]{text-headword.ly}
18 Esta sección explica cómo incluir texto (con diversos estilos de
19 formateo) en las partituras.
22 Ciertos elementos de texto de los que no nos ocupamos aquí se tratan
23 en otras secciones específicas: @ref{Música vocal}, @ref{Títulos y
27 * Escritura del texto::
28 * Formatear el texto::
32 @node Escritura del texto
33 @subsection Escritura del texto
34 @translationof Writing text
36 Esta sección presenta las distintas formas de añadir texto a una
39 @cindex texto, en otros idiomas
40 @warning{Para escribir texto con caracteres acentuados y especiales
41 (como los de idiomas distintos del inglés), sencillamente inserte los
42 caracteres directamente en el archivo de LilyPond. El archivo se debe
43 guardar como UTF-8. Para ver más información, consulte
44 @ref{Codificación del texto}.}
49 * Extensiones de texto::
50 * Indicaciones de texto::
55 @node Guiones de texto
56 @unnumberedsubsubsec Guiones de texto
57 @translationof Text scripts
59 @cindex texto, inscripciones de
60 @cindex texto, elementos no vacíos de
61 @cindex no vacíos, textos
62 @cindex texto destacado
64 Es posible añadir indicaciones de @qq{texto entre comillas} a una
65 partitura, como se muestra en el ejemplo siguiente. Estas
66 indicaciones se pueden colocar manualmente por encima o por debajo
67 del pentagrama, utilizando la sintaxis que se describe en
68 @ref{Dirección y posición}.
70 @lilypond[quote,verbatim,relative=2]
71 a8^"pizz." g f e a4-"scherz." f
74 Esta sintaxis es en realidad una abreviatura; se puede añadir
75 explícitamente a una nota un formateado de texto más complejo
76 utilizando un bloque @code{\markup}, como se describe bajo
77 @ref{Formatear el texto}.
79 @lilypond[quote,verbatim,relative=2]
80 a8^\markup { \italic pizz. } g f e
81 a4_\markup { \tiny scherz. \bold molto } f
84 De forma predeterminada, las indicaciones de texto no afectan al
85 espaciado de las notas. Sin embargo, su anchura sí podría tenerse en
86 cuenta: en el siguiente ejemplo, la primera cadena de texto no afecta
87 al espaciado, pero la segunda sí afecta.
89 @lilypond[quote,verbatim,relative=2]
95 Se pueden adjuntar articulaciones a las notas, además de inscripciones
96 de texto. Para ver más información, consulte @ref{Articulaciones y
99 Para ver más información sobre el orden relativo de las inscripciones
100 de texto y las articulaciones, consulte @rlearning{Colocación de los
103 @funindex \textLengthOn
104 @funindex textLengthOn
105 @funindex \textLengthOff
106 @funindex textLengthOff
109 @code{\textLengthOn},
110 @code{\textLengthOff}.
115 Manual de aprendizaje:
116 @rlearning{Colocación de los objetos}.
118 Referencia de la notación:
119 @ref{Formatear el texto},
120 @ref{Dirección y posición}.
122 Fragmentos de código:
125 Referencia de funcionamiento interno:
126 @rinternals{TextScript}.
129 @cindex texto fuera del margen
130 @cindex margen, texto fuera del
131 @cindex texto, mantener dentro del margen
132 @cindex letra, mantener dentro del margen
137 La comprobación necesaria para asegurar que las inscripciones de texto
138 y la letra de las canciones se mantienen dentro de los márgenes, es
139 una tarea computacional relativamente grande. Para acelerar el
140 procesado, LilyPond no realiza estos cálculos de forma predeterminada;
141 para habilitarlos, utilice
144 \override Score.PaperColumn #'keep-inside-line = ##t
148 @node Extensiones de texto
149 @unnumberedsubsubsec Extensiones de texto
150 @translationof Text spanners
152 @cindex texto, elementos de extensión
154 Ciertas indicaciones de ejecución, p.ej., @i{rallentando} o
155 @i{accelerando}, se escriben como texto y se extienden sobre muchos
156 compases mediante líneas de puntos. Estos objetos, que reciben el
157 nombre de @q{spanners} u objetos de extensión, se pueden crear desde
158 una nota hasta otra usando la siguiente sintaxis:
160 @lilypond[verbatim,quote,relative=2]
161 \override TextSpanner #'(bound-details left text) = "rit."
166 @cindex texto, formateado de los elementos de extensión
167 @cindex formato de los elementos de extensión de texto
170 La cadena de texto que imprimir se establece a través de propiedades
171 de objeto. De forma predeterminada se imprime en estilo cursiva, pero
172 se pueden conseguir distintos efectos de formato utilizando bloques
173 @code{\markup}, como se describe en @ref{Formatear el texto}.
175 @lilypond[quote,relative=2,verbatim]
176 \override TextSpanner #'(bound-details left text) =
177 \markup { \upright "rit." }
182 El estilo de la línea, así como la cadena de texto, se pueden definir
183 como una propiedad de objeto. Esta sintaxis se describe en
184 @ref{Estilos de línea}. Los extensores de texto
185 forman parte del contexto @code{Dynamics}; véase
186 @rinternals{Dynamics}.
189 @funindex \textSpannerUp
190 @funindex textSpannerUp
191 @funindex \textSpannerDown
192 @funindex textSpannerDown
193 @funindex \textSpannerNeutral
194 @funindex textSpannerNeutral
198 @code{\textSpannerUp},
199 @code{\textSpannerDown},
200 @code{\textSpannerNeutral}.
204 LilyPond sólo puede manejar un objeto de extensión de texto por cada
209 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
210 {dynamics-text-spanner-postfix.ly}
212 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
213 {dynamics-custom-text-spanner-postfix.ly}
216 Referencia de la notación:
217 @ref{Estilos de línea},
218 @ref{Matices dinámicos}.
220 Fragmentos de código:
222 @rlsr{Expressive marks}.
224 Referencia de funcionamiento interno:
225 @rinternals{TextSpanner},
226 @rinternals{Dynamics}.
229 @node Indicaciones de texto
230 @unnumberedsubsubsec Indicaciones de texto
231 @translationof Text marks
233 @cindex texto, indicaciones de
234 @cindex indicaciones de texto
235 @cindex texto sobre la barra de compás
236 @cindex coda sobre la línea divisoria
237 @cindex segno sobre la línea divisoria
238 @cindex calderón sobre la línea divisoria
239 @cindex líneas divisorias, símbolos sobre las
246 Se pueden añadir a la partitura varios elementos de texto con la
247 sintaxis que se describe en @ref{Llamadas de ensayo}:
249 @c \mark needs to be placed on a separate line (it's not
250 @c attached to an object like \markup is). -vv
252 @lilypond[verbatim,quote,relative=2]
258 Esta sintaxis posibilita colocar cualquier texto sobre la línea
259 divisoria; se pueden incorporar formatos más complejos para el texto
260 usando un bloque @code{\markup}, como está explicado en
261 @ref{Formatear el texto}:
263 @lilypond[quote,verbatim,relative=1]
265 \mark \markup { \italic { colla parte } }
271 Esta sintaxis también permite imprimir símbolos especiales como
272 llamadas, segno o calderones, especificando el nombre del símbolo
273 correspondiente como se explica en @ref{Notación musical dentro de elementos de marcado}:
275 @lilypond[quote,verbatim,relative=2]
277 \mark \markup { \musicglyph #"scripts.ufermata" }
282 Estos objetos se tipografían solamente sobre el pentagrama superior de
283 la partitura; dependiendo de si están especificados al final o en
284 medio de un compás, se colocarán sobre la línea divisoria o entre las
285 notas. Si se especifican en un salto de línea, las llamadas se
286 imprimen al principio de la línea siguiente.
288 @lilypond[quote,verbatim,relative=2]
298 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
299 {printing-marks-at-the-end-of-a-line.ly}
301 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
302 {aligning-marks-with-various-notation-objects.ly}
304 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
305 {printing-marks-on-every-staff.ly}
309 Referencia de la notación:
310 @ref{Llamadas de ensayo},
311 @ref{Formatear el texto},
312 @ref{Notación musical dentro de elementos de marcado},
313 @ref{La tipografía Feta}.
315 Fragmentos de código:
318 Referencia de funcionamiento interno:
319 @rinternals{MarkEvent},
320 @rinternals{Mark_engraver},
321 @rinternals{RehearsalMark}.
325 @unnumberedsubsubsec Texto separado
326 @translationof Separate text
328 @cindex separado, texto
329 @cindex texto separado
330 @cindex independiente, texto
331 @cindex nivel superior, texto del
332 @cindex texto del nivel superior
333 @cindex texto independiente
338 Un bloque @code{\markup} puede existir de forma independiente, fuera
339 de cualquier bloque @code{\score}, como una @qq{expresión de nivel
340 superior}. Esta sintaxis se describe en @ref{Estructura del archivo}.
342 @lilypond[verbatim,quote]
344 Tomorrow, and tomorrow, and tomorrow...
349 Esto hace posible imprimir texto separado de la música, lo que es
350 especialmente útil cuando el archivo de entrada contiene varias
351 piezas, tal y como se describe en @ref{Varias partituras en un libro}.
353 @lilypond[quote,verbatim]
358 Tomorrow, and tomorrow, and tomorrow...
365 Los bloques de texto independientes pueden abarcar varias páginas,
366 posibilitando la impresión de documentos de texto o libros
367 íntegramente desde LilyPond. Esta funcionalidad y la sintaxis que
368 requiere se describen en @ref{Elementos de marcado de varias páginas}.
373 @funindex \markuplines
374 @funindex markuplines
384 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
385 {stand-alone-two-column-markup.ly}
389 Referencia de la notación:
390 @ref{Formatear el texto},
391 @ref{Estructura del archivo},
392 @ref{Varias partituras en un libro},
393 @ref{Elementos de marcado de varias páginas}.
395 Fragmentos de código:
398 Referencia de funcionamiento interno:
399 @rinternals{TextScript}.
402 @node Formatear el texto
403 @subsection Formatear el texto
404 @translationof Formatting text
406 Esta sección presenta los formateados básico y avanzado de texto,
407 usando la sintaxis específica del modo de @code{\markup}.
410 * Introducción al marcado de texto::
411 * Instrucciones de marcado de texto más usuales::
412 * Alineación de texto::
413 * Notación gráfica dentro de elementos de marcado::
414 * Notación musical dentro de elementos de marcado::
415 * Elementos de marcado de varias páginas::
418 @node Introducción al marcado de texto
419 @unnumberedsubsubsec Introducción al marcado de texto
420 @translationof Text markup introduction
423 @cindex texto, marcado de
424 @cindex marcado de texto
425 @cindex tipografiar texto
430 Se usa un bloque @code{\markup} para tipografiar texto con una
431 sintaxis ampliable que se denomina @qq{modo de marcado}.
433 @cindex marcado, expresiones de
434 @cindex expresiones de marcado
435 @cindex marcado, sintaxis
436 @cindex sintaxis del marcado
438 La sintaxis del marcado es similar a la sintaxis usual de LilyPond:
439 una expresión @code{\markup} se encierra entre llaves @code{@{ @dots{}
440 @}}. Una sola palabra se considera como una expresión mínima, y por
441 tanto no necesita estar encerrada entre llaves.
443 A diferencia de las indicaciones de @qq{texto entrecomillado} simples,
444 los bloques @code{\markup} pueden contener expresiones anidadas o
445 instrucciones de marcado, que se introducen utilizando el carácter de
446 barra invertida @code{\} . Estas instrucciones sólo afectan a la
447 expresión que sigue inmediatamente.
449 @lilypond[quote,verbatim,relative=2]
451 a2^\markup { poco \italic più forte }
453 d2_\markup { \italic "string. assai" }
455 b1^\markup { \bold { molto \italic agitato } }
459 @cindex caracteres especiales en modo de marcado
460 @cindex marcado, caracteres especiales en modo de
461 @cindex reservados, impresión de caracteres
462 @cindex impresión de caracteres especiales
463 @cindex texto entrecomillado en modo de marcado
465 Un bloque @code{\markup} puede contener también cadenas de texto entre
466 comillas. Dichas cadenas se tratan como expresiones de texto mínimas,
467 y por tanto cualquier instrucción de marcado o carácter especial (como
468 @code{\} y @code{#}) se imprimen literalmente sin afectar al formateo
469 del texto. Se puede hacer que se impriman las propias comillas si se
470 les antepone una barra invertida.
472 @lilypond[quote,verbatim,relative=2]
473 a1^"\italic markup..."
474 a_\markup { \italic "... prints \"italic\" letters!" }
478 Para que se traten como una expresión distinta, es necesario que las
479 listas de palabras estén encerradas entre comillas o precedidas de una
480 instrucción. La forma en que están definidas las expresiones de
481 marcado afecta a cómo se apilan, se centran y se alinean estas
482 expresiones; en el ejemplo siguiente, la segunda expresión
483 @code{\markup} se trata igual que la primera:
485 @lilypond[quote,verbatim,relative=2]
486 c1^\markup { \center-column { a bbb c } }
487 c1^\markup { \center-column { a { bbb c } } }
488 c1^\markup { \center-column { a \line { bbb c } } }
489 c1^\markup { \center-column { a "bbb c" } }
492 Los marcados se pueden almacenar dentro de variables. Estas variables
493 se pueden adjuntar directamente a las notas:
495 @lilypond[quote,verbatim]
496 allegro = \markup { \bold \large Allegro }
506 Se puede encontrar una lista exhaustiva de las instrucciones
507 específicas de @code{\markup} en @ref{Text markup commands}.
511 Referencia de la notación:
512 @ref{Text markup commands}.
514 Fragmentos de código:
518 @file{scm/markup.scm}.
523 Los errores de sintaxis para el modo de marcado a menudo producen
527 @node Instrucciones de marcado de texto más usuales
528 @unnumberedsubsubsec Instrucciones de marcado de texto más usuales
529 @translationof Selecting font and font size
531 @cindex fuente tipográfica, cambiar
532 @cindex cambio de la fuente tipográfica
541 Está contemplado de forma básica el cambio de la fuente tipográfica en
544 @lilypond[quote,verbatim,relative=2]
547 \italic { non troppo \underline Vivo }
550 d,_\markup { \italic quasi \smallCaps Tromba }
554 @cindex fuente tipográfica, tamaño de
555 @cindex texto, tamaño de
566 El tamaño de los caracteres también se puede alterar de distintas
571 el tamaño de la tipografía se puede definir a una serie de tamaños
572 estándar predefinidos,
575 el tamaño de la tipografía se puede establecer a un valor absoluto,
578 el tamaño de la tipografía también se puede cambiar de forma relativa
579 respecto de su valor anterior.
583 El ejemplo siguiente ejemplifica estos tres métodos:
585 @lilypond[quote,verbatim,relative=1]
592 \fontsize #5 Sinfonia
599 \magnify #0.6 { e sentimento } )
612 El texto se puede imprimir como subíndice o como superíndice. De
613 forma predeterminada se imprimen en un tamaño menor, pero también se
614 puede usar un tamaño normal:
616 @lilypond[quote,verbatim]
619 \line { 1 \super st movement }
620 \line { 1 \normal-size-super st movement
621 \sub { (part two) } }
626 @cindex fuente tipográfica, familias de
628 El modo de marcado ofrece una manera fácil de elegir familias de
629 tipografía alternativas. A no ser que se especifique de otro modo, se
630 selecciona automáticamente la fuente predeterminada con serifa, de
631 tipo romano: en la última línea del ejemplo siguiente, no hay
632 diferencia entre la primera y la segunda palabra.
634 @lilypond[quote,verbatim]
637 \line { Act \number 1 }
638 \line { \sans { Scene I. } }
639 \line { \typewriter { Verona. An open place. } }
640 \line { Enter \roman Valentine and Proteus. }
646 Algunas de estas familias, usadas para elementos específicos como
647 números o matices, no ofrecen todos los caracteres, como se explica en
648 @ref{Indicaciones dinámicas contemporáneas} y @ref{Marcas de repetición manual}.
650 @c \concat is actually documented in Align (it is not
651 @c a font-switching command). But we need it here. -vv
653 Si se usan dentro de una palabra, algunas instrucciones de cambio de
654 tipografía o de formateo pueden producir un espacio vacío no deseado.
655 Esto se puede solucionar concatenando en uno solo los distintos
658 @lilypond[quote,verbatim]
662 \concat { 1 \super st }
666 \concat { \dynamic p , }
667 \italic { con dolce espressione }
673 Se puede encontrar una lista exhaustiva de instrucciones de cambio y
674 utilización personalizada de las fuentes tipográficas en @ref{Font}.
676 También es posible definir conjuntos personalizados de fuentes, tal y
677 como se explica en @ref{Tipografías}.
685 @funindex \normalsize
710 Referencia de la notación:
712 @ref{Indicaciones dinámicas contemporáneas},
713 @ref{Marcas de repetición manual},
716 Fragmentos de código:
719 Referencia de funcionamiento interno:
720 @rinternals{TextScript}.
723 @file{scm/define-markup-commands.scm}.
726 @node Alineación de texto
727 @unnumberedsubsubsec Alineación de texto
728 @translationof Text alignment
730 @cindex texto, alineación de
731 @cindex alinear texto
732 @cindex alinear texto de marcado
733 @cindex alinear elementos de marcado
734 @cindex marcado, elementos, alinear
735 @cindex marcado, texto, alinear
737 Esta subsección trata sobre cómo colocar texto en el modo de marcado.
738 Los objetos de marcado también se pueden mover como un todo, usando la
739 sintaxis que se describe en @rlearning{Mover objetos}.
741 @c Padding commands should be mentioned on this page, but
742 @c most of these require \box to be more clearly illustrated. -vv
744 @cindex texto, alineación horizontal
745 @cindex horizontal, alineación de texto
747 @funindex \left-align
749 @funindex \center-align
750 @funindex center-align
751 @funindex \right-align
752 @funindex right-align
754 Los objetos de marcado se pueden alinear de distintas maneras. De
755 forma predeterminada, una indicación de texto se alinea sobre el borde
756 izquierdo: en el ejemplo siguiente, no existe diferencia entre los
757 marcados primero y segundo.
759 @lilypond[quote,verbatim,relative=2]
762 d-\markup { \left-align poco }
764 d-\markup { \center-align { poco } }
766 d-\markup { \right-align poco }
772 Se puede realizar un ajuste fino de la alineación horizontal usando un
775 @lilypond[quote,verbatim,relative=2]
776 a1-\markup { \halign #-1 poco }
778 a,-\markup { \halign #0 poco }
780 a,-\markup { \halign #0.5 poco }
782 a,-\markup { \halign #2 poco }
786 Ciertos objetos pueden poseer sus propios procedimientos de
787 alineación, y por tanto no resultan afectados por estas instrucciones.
788 Es posible mover estos objetos de marcado como un todo, como se
789 muestra por ejemplo en @ref{Indicaciones de texto}.
791 @cindex texto, alineación vertical
792 @cindex vertical, alineación de texto
801 La alineación vertical es un poco más compleja. Como se ha dicho más
802 arriba, los objetos de marcado se pueden mover como un todo; sin
803 embargo, también es posible mover elementos específicos dentro de un
804 bloque de marcado. En este caso, el elemento a mover se debe preceder
805 de un @emph{punto de anclaje}, que puede ser otro elemento de marcado
806 o un objeto invisible. El ejemplo siguiente ejemplifica estas dos
807 posibilidades; el último marcado en este ejemplo no tiene punto de
808 anclaje y por ello no resulta movido.
810 @lilypond[quote,verbatim,relative=1]
813 \raise #2 { Scène 1 }
818 \lower #4 \bold { Très modéré }
822 \raise #4 \italic { Une forêt. }
827 @funindex \general-align
828 @funindex general-align
831 @funindex \translate-scaled
832 @funindex translate-scaled
834 Algunas instrucciones pueden afectar tanto a la alineación horizontal
835 como a la vertical de los objetos de texto en el modo de marcado.
836 Cualquier objeto afectado por estas instrucciones se deben preceder de
839 @lilypond[quote,verbatim,relative=1]
842 \translate #'(-1 . 2) "Scène 1"
847 \general-align #Y #3.2 \bold "Très modéré"
852 \translate-scaled #'(-1 . 2) \teeny "Une forêt."
857 @cindex varias líneas, marcado
858 @cindex marcado de varias líneas
859 @cindex varias líneas, texto
860 @cindex texto de varias líneas
861 @cindex texto en columnas
862 @cindex columnas, texto
866 @funindex \center-column
867 @funindex center-column
869 Un objeto de marcado puede incluir varias líneas de texto. En el
870 ejemplo siguiente, cada elemento o expresión se sitúa en su propia
871 línea, ya sea alineada por la izquierda o centrada:
873 @lilypond[quote,verbatim]
889 @cindex centrar texto en la página
890 @cindex texto, centrar en la página
891 @cindex marcado, centrar en la página
896 De forma similar, una lista de elementos o expresiones se puede
897 repartir de forma que rellene por completo el ancho de la línea
898 horizontal (si hay un solo elemento, se centra en el papel). A su
899 vez, estas expresiones pueden incluir texto de varias líneas o
900 cualquier otra expresión de marcado:
902 @lilypond[quote,verbatim]
905 \line { William S. Gilbert }
907 \huge \smallCaps "The Mikado"
909 \smallCaps "The Town of Titipu"
911 \line { Sir Arthur Sullivan }
919 @cindex texto ajustado a palabras
920 @cindex texto justificado
921 @cindex justificado, texto
922 @cindex ajustado a palabras, texto
923 @cindex marcado, texto, ajustado a palabras
924 @cindex texto de marcado ajustado a palabras
925 @cindex ajuste de línea, texto con
933 Las indicaciones de texto largas se pueden también ajustar
934 automáticamente según un ancho de línea dado. Estarán alineados por
935 la izquierda o justificados, como se muestra en el ejemplo siguiente.
937 @lilypond[quote,verbatim]
940 \line \smallCaps { La vida breve }
941 \line \bold { Acto I }
943 (La escena representa el corral de una casa de
944 gitanos en el Albaicín de Granada. Al fondo una
945 puerta por la que se ve el negro interior de
946 una Fragua, iluminado por los rojos resplandores
951 \line \bold { Acto II }
952 \override #'(line-width . 50)
954 (Calle de Granada. Fachada de la casa de Carmela
955 y su hermano Manuel con grandes ventanas abiertas
956 a través de las que se ve el patio
957 donde se celebra una alegre fiesta)
963 @cindex texto, instrucciones de alineación
964 @cindex marcado, texto, instrucciones de alineación
965 @cindex alineación, instrucciones de texto
967 Hay una lista exhaustiva de instrucciones de alineación de texto en
972 Manual de aprendizaje:
973 @rlearning{Mover objetos}.
975 Referencia de la notación:
977 @ref{Indicaciones de texto}.
979 Fragmentos de código:
982 Referencia de funcionamiento interno:
983 @rinternals{TextScript}.
986 @file{scm/define-markup-commands.scm}.
989 @node Notación gráfica dentro de elementos de marcado
990 @unnumberedsubsubsec Notación gráfica dentro de elementos de marcado
991 @translationof Graphic notation inside markup
993 @cindex gráficos, insertar
994 @cindex dibujar objetos gráficos
995 @cindex gráficos, dibujar objetos
996 @cindex insertar objetos gráficos
997 @cindex gráficos, insertar objetos
999 Se puede añadir diversos objetos gráficos a una partitura, utilizando
1000 instrucciones de marcado.
1002 @cindex enmarcar texto
1003 @cindex texto, enmarcar
1004 @cindex texto, decorar
1005 @cindex marcado, texto, decorar
1006 @cindex marcado, texto, enmarcar
1007 @cindex decorar texto
1013 @funindex \rounded-box
1014 @funindex rounded-box
1020 Ciertas instrucciones de marcado permiten la decoración de elementos
1021 de texto con gráficos, como se muestra en el ejemplo siguiente.
1023 @lilypond[quote,verbatim]
1024 \markup \fill-line {
1032 \bracket "1866 - 1925"
1035 \rounded-box \bold Prelude
1040 @cindex relleno alrededor de texto
1041 @cindex texto, relleno de
1042 @cindex marcado, relleno de textos de
1044 @funindex \pad-markup
1045 @funindex pad-markup
1048 @funindex \pad-to-box
1049 @funindex pad-to-box
1050 @funindex \pad-around
1051 @funindex pad-around
1053 Algunas instrucciones pueden requerir un aumento del relleno alrededor
1054 del texto: esto se puede conseguir con algunas instrucciones de
1055 marcado descritas exhaustivamente en @ref{Align}.
1057 @lilypond[quote,verbatim]
1058 \markup \fill-line {
1060 \box "Charles Ives (1874 - 1954)"
1062 \box \pad-markup #2 "THE UNANSWERED QUESTION"
1063 \box \pad-x #8 "A Cosmic Landscape"
1070 \box \pad-to-box #'(-5 . 20) #'(0 . 5)
1071 \bold "Largo to Presto"
1074 "String quartet keeps very even time,
1075 Flute quartet keeps very uneven time."
1079 @cindex gráfica, notación
1080 @cindex símbolos no musicales
1081 @cindex no musicales, símbolos
1082 @cindex notación gráfica
1086 @funindex \draw-circle
1087 @funindex draw-circle
1088 @funindex \filled-box
1089 @funindex filled-box
1092 @funindex \draw-line
1094 @funindex \arrow-head
1095 @funindex arrow-head
1097 Se pueden imprimir otros símbolos o elementos gráficos sin que se
1098 requiera ningún otro texto. De igual manera que en el caso de las
1099 expresiones de marcado, dichos objetos se pueden combinar:
1101 @lilypond[quote,verbatim]
1104 \draw-circle #4 #0.4 ##f
1105 \filled-box #'(-4 . 4) #'(-0.5 . 0.5) #1
1111 \draw-line #'(0 . 4)
1112 \arrow-head #Y #DOWN ##f
1117 @cindex insertar gráficos
1118 @cindex imágenes, insertar
1119 @cindex gráficos, insertar
1124 @funindex \postscript
1125 @funindex postscript
1127 Entre las funcionalidades gráficas avanzadas se encuentran la
1128 posibilidad de incluir archivos de imagen externos convertidos al
1129 formato de PostScript Encapsulado (@emph{eps}), y la inclusión directa
1130 de gráficos dentro del archivo de entrada, usando código PostScript
1131 nativo. En tal caso puede ser de utilidad la especificación explícita
1132 del tamaño del dibujo, como se ejemplifica a continuación:
1134 @lilypond[quote,verbatim,relative=1]
1137 \epsfile #X #10 #"./context-example.eps"
1138 \with-dimensions #'(0 . 6) #'(0 . 10)
1154 Hay una lista exhaustiva de instrucciones específicas de gráficos en
1159 Referencia de la notación:
1161 @ref{Anotaciones editoriales}.
1163 Fragmentos de código:
1166 Referencia de funcionamiento interno:
1167 @rinternals{TextScript}.
1170 @file{scm/define-markup-commands.scm},
1171 @file{scm/stencil.scm}.
1174 @node Notación musical dentro de elementos de marcado
1175 @unnumberedsubsubsec Notación musical dentro de elementos de marcado
1176 @translationof Music notation inside markup
1178 @cindex notación dentro de marcado
1179 @cindex música dentro de marcado
1180 @cindex marcado, notación musical dentro de
1182 Se pueden añadir a la partitura diversos elementos de notación
1183 musical, dentro de un objeto de marcado.
1185 Las notas y las alteraciones se pueden escribir utilizando
1186 instrucciones de marcado:
1188 @lilypond[quote,verbatim,relative=2]
1192 \note-by-number #1 #1 #1.5
1195 \natural \semiflat \flat
1196 \sesquiflat \doubleflat
1200 \natural \semisharp \sharp
1201 \sesquisharp \doublesharp
1206 Otros objetos de notación se pueden también imprimir en el modo de
1209 @lilypond[quote,verbatim,relative=1]
1216 fis_\markup { \dynamic rf }
1227 De forma más general, cualquier símbolo musical disponible se puede
1228 incluir por separado dentro de un objeto de marcado, como se
1229 ejemplifica a continuación; hay una lista exhaustiva de estos símbolos
1230 y sus nombres en @ref{La tipografía Feta}.
1232 @lilypond[quote,verbatim,relative=2]
1234 c'^\markup { \musicglyph #"eight" }
1236 c,8._\markup { \musicglyph #"clefs.G_change" }
1238 c2^\markup { \musicglyph #"timesig.neomensural94" }
1241 Otra forma de imprimir glifos que no son de texto se encuentra
1242 descrita en @ref{Explicación de las fuentes tipográficas}. Tiene la
1243 utilidad de imprimir llaves de distintos tamaños.
1245 El modo de marcado también contempla diagramas para instrumentos
1248 @lilypond[quote,verbatim,relative=2]
1250 \fret-diagram-terse #"x;x;o;2;3;2;"
1253 \harp-pedal #"^-v|--ov^"
1258 \musicglyph #"accordion.discant"
1260 \raise #0.5 \musicglyph #"accordion.dot"
1261 \raise #1.5 \musicglyph #"accordion.dot"
1265 @c The accordion diagram is actually taken from a snippet.
1268 Dichos diagramas se encuentran documentados en @ref{Instrument
1271 @cindex partitura dentro marcado
1272 @cindex marcado, partitura dentro de
1274 Incluso una partitura completa se puede incluir dentro de un objeto de
1275 marcado. En tal caso, el bloque anidado @code{\score} debe contener
1276 un bloque @code{\layout}, como se muestra aquí:
1278 @lilypond[quote,verbatim,relative=1]
1281 \relative c' { c4 d e f }
1289 Hay una lista exhaustiva de instrucciones relacionadas con la notación
1290 musical en @ref{Music}.
1294 Referencia de la notación:
1296 @ref{La tipografía Feta},
1297 @ref{Explicación de las fuentes tipográficas}.
1299 Fragmentos de código:
1302 Referencia de funcionamiento interno:
1303 @rinternals{TextScript}.
1306 @file{scm/define-markup-commands.scm},
1307 @file{scm/fret-diagrams.scm},
1308 @file{scm/harp-pedals.scm}.
1311 @node Elementos de marcado de varias páginas
1312 @unnumberedsubsubsec Elementos de marcado de varias páginas
1313 @translationof Multi-page markup
1315 @cindex páginas, marcado de varias
1316 @cindex marcado de varias páginas
1317 @cindex marcado, texto de, varias páginas
1318 @cindex texto que ocupa varias páginas
1320 @funindex \markuplines
1321 @funindex markuplines
1322 @funindex \justified-lines
1323 @funindex justified-lines
1324 @funindex \wordwrap-lines
1325 @funindex wordwrap-lines
1327 Aunque los objetos de marcado estándar no se pueden dividir, una
1328 sintaxis específica hace posible la introducción de líneas de texto
1329 que pueden abarcar varias páginas:
1332 @lilypond[quote,verbatim]
1335 Un texto muy largo de líneas justificadas.
1339 Otro párrafo muy largo.
1346 Esta sintaxis acepta una lista de elementos de marcado, que pueden ser
1349 el resultado de una instrucción de lista de marcado,
1351 una lista de marcados,
1353 o una lista de listas de marcado.
1356 Hay una lista exhaustiva de las instrucciones de lista de marcado en
1357 @ref{Text markup list commands}.
1361 Referencia de la notación:
1362 @ref{Text markup list commands}.
1364 Fragmentos de código:
1367 Manual de extensión:
1368 @rextend{New markup list command definition}.
1370 Referencia de funcionamiento interno:
1371 @rinternals{TextScript}.
1374 @file{scm/define-markup-commands.scm}.
1377 @funindex \markuplines
1378 @funindex markuplines
1381 @code{\markuplines}.
1386 @subsection Tipografías
1387 @translationof Fonts
1389 Esta sección presenta la forma en que se manejan las fuentes
1390 tipográficas, y cómo se pueden cambiar en las partituras.
1393 * Explicación de las fuentes tipográficas::
1394 * Fuentes de un solo elemento::
1395 * Fuentes tipográficas del documento completo::
1399 @node Explicación de las fuentes tipográficas
1400 @unnumberedsubsubsec Explicación de las fuentes tipográficas
1401 @translationof Fonts explained
1404 @cindex fuentes tipográficas, explicación
1405 @cindex llaves de distintos tamaños
1406 @cindex fuentes tipográficas, explicación
1407 @cindex llaves de varios tamaños
1408 @cindex fuentes tipográficas de símbolos en marcado
1409 @cindex símbolos, fuentes tipográficas en el marcado
1411 @funindex font-interface
1413 Las fuentes tipográficas se manejan a través de distintas bibliotecas.
1414 FontConfig se utiliza para detectar las tipografías disponibles en el
1415 sistema; las tipografías seleccionadas se trazan utilizando Pango.
1417 Las tipografías de notación musical se pueden describir como un
1418 conjunto de glifos específicos, ordenados en varias familias. La
1419 siguiente sintaxis permite usar directamente varias tipografías
1420 @code{feta} de LilyPond distintas a las de texto en el modo de
1423 @lilypond[quote,verbatim,relative=2]
1426 \override #'(font-encoding . fetaBraces)
1428 \override #'(font-encoding . fetaText)
1430 \override #'(font-encoding . fetaMusic)
1431 \lookup #"noteheads.s0petrucci"
1437 Sin embargo, todos estos glifos excepto las llaves de varios tamaños
1438 que están contenidas en la fuente tipográfica @code{fetaBraces} están
1439 disponibles utilizando la sintaxis más sencilla que se describe en
1440 @ref{Notación musical dentro de elementos de marcado}.
1442 Cuando se usan los glifos de la fuente de llaves @code{fetaBraces}, el
1443 tamaño de la llave se especifica por la parte numérica del nombre del
1444 glifo, en unidades arbitrarias. Se puede especificar cualquier entero
1445 de @code{0} a @code{575} inclusive, siendo @code{0} el que produce la
1446 llave más pequeña. El valor óptimo se debe determinar por ensayo y
1447 error. Todos estos glifos son llaves izquierdas; las llaves derechas
1448 se pueden obtener mediante rotación, véase @ref{Rotación de objetos}.
1450 Están disponibles tres familias de tipografías de texto: la tipografía
1451 @emph{romana} (con serifa), que de forma predeterminada es New Century
1452 Schoolbook, la fuente @emph{sans} y la fuente monoespaciada @emph{de
1453 máquina de escribir}. Estas dos últimas familias vienen determinadas
1454 por la instalación de Pango.
1456 Cada familia puede incluir distintas formas y series. El ejemplo
1457 siguiente muestra la posibilidad de seleccionar familias, formas,
1458 series y tamaños alternativos. El valor que se da a @code{font-size}
1459 es el cambio requerido a partir del tamaño predeterminado.
1461 @lilypond[quote,verbatim,relative=2]
1462 \override Score.RehearsalMark #'font-family = #'typewriter
1463 \mark \markup "Ouverture"
1464 \override Voice.TextScript #'font-shape = #'italic
1465 \override Voice.TextScript #'font-series = #'bold
1466 d2.^\markup "Allegro"
1467 \override Voice.TextScript #'font-size = #-3
1472 Se puede usar una sintaxis similar en el modo de marcado, aunque en
1473 este caso es preferible usar la sintaxis sencilla que se explica en
1474 @ref{Instrucciones de marcado de texto más usuales}:
1476 @lilypond[quote,verbatim]
1480 \override #'(font-shape . italic)
1481 \override #'(font-size . 4)
1485 \override #'(font-family . typewriter)
1487 \override #'(font-series . bold)
1491 \override #'(font-family . sans)
1498 Aunque es fácil cambiar entre las fuentes tipográficas
1499 preconfiguradas, también es posible usar otras fuentes, como se
1500 explica en las siguientes secciones: @ref{Fuentes de un solo elemento} y
1501 @ref{Fuentes tipográficas del documento completo}.
1505 Referencia de la notación:
1506 @ref{La tipografía Feta},
1507 @ref{Notación musical dentro de elementos de marcado},
1508 @ref{Instrucciones de marcado de texto más usuales},
1512 @node Fuentes de un solo elemento
1513 @unnumberedsubsubsec Fuentes de un solo elemento
1514 @translationof Single entry fonts
1516 Se puede usar en una partitura cualquier fuente tipográfica que esté
1517 instalada en el sistema operativo y reconocida por parte de
1518 FontConfig, usando la siguiente sintaxis:
1520 @lilypond[quote,verbatim,relative=2]
1521 \override Staff.TimeSignature #'font-name = #"Bitstream Charter"
1522 \override Staff.TimeSignature #'font-size = #2
1526 \override #'(font-name . "Vera Bold")
1531 @cindex fuentes tipográficas, buscar, disponibles
1532 @cindex buscar fuentes tipográficas disponibles
1533 @cindex listar fuentes tipográficas disponibles
1534 @cindex disponibles, listar las fuentes tipográficas
1536 @funindex show-available-fonts
1538 La instrucción siguiente presenta una lista de todas las tipografías
1539 disponibles en el sistema operativo:
1542 lilypond -dshow-available-fonts x
1547 Referencia de la notación:
1548 @ref{Explicación de las fuentes tipográficas},
1549 @ref{Fuentes tipográficas del documento completo}.
1551 Fragmentos de código:
1554 @c A source file gets never installed...
1556 @c @file{lily/font-config-scheme.cc}.
1559 @node Fuentes tipográficas del documento completo
1560 @unnumberedsubsubsec Fuentes tipográficas del documento completo
1561 @translationof Entire document fonts
1563 Se pueden cambiar las fuentes tipográficas que se usan como
1564 tipografías predeterminadas en las familias @emph{romana},
1565 @emph{sans-serif} y @emph{monoespaciada}, especificándolas en este
1566 orden como se ve en el ejemplo de abajo. Para leer más explicaciones
1567 sobre las fuentes tipográficas, consulte @ref{Explicación de las fuentes tipográficas}.
1569 @cindex fuente, establecer la familia de
1570 @cindex fuentes tipográficas, cambiar para todo el documento
1572 @funindex make-pango-font-tree
1574 @lilypond[verbatim,quote]
1578 (make-pango-font-tree "Times New Roman"
1581 (/ myStaffSize 20)))
1588 \typewriter typewriter. }
1592 @c we don't do Helvetica / Courier, since GS incorrectly loads
1597 Referencia de la notación:
1598 @ref{Explicación de las fuentes tipográficas},
1599 @ref{Fuentes de un solo elemento},
1600 @ref{Instrucciones de marcado de texto más usuales},