1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
3 Translation of GIT committish: 42d5df998cb69b0c66f967b3b5043e83bc504be6
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},
121 @ref{Articulaciones y ornamentos}.
123 Fragmentos de código:
126 Referencia de funcionamiento interno:
127 @rinternals{TextScript}.
130 @cindex texto fuera del margen
131 @cindex margen, texto fuera del
132 @cindex texto, mantener dentro del margen
133 @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}.
186 @funindex \textSpannerUp
187 @funindex textSpannerUp
188 @funindex \textSpannerDown
189 @funindex textSpannerDown
190 @funindex \textSpannerNeutral
191 @funindex textSpannerNeutral
195 @code{\textSpannerUp},
196 @code{\textSpannerDown},
197 @code{\textSpannerNeutral}.
201 LilyPond sólo puede manejar un objeto de extensión de texto por cada
206 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
207 {dynamics-text-spanner-postfix.ly}
209 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
210 {dynamics-custom-text-spanner-postfix.ly}
213 Referencia de la notación:
214 @ref{Estilos de línea},
215 @ref{Matices dinámicos},
216 @ref{Formatear el texto}.
218 Fragmentos de código:
220 @rlsr{Expressive marks}.
222 Referencia de funcionamiento interno:
223 @rinternals{TextSpanner}.
226 @node Indicaciones de texto
227 @unnumberedsubsubsec Indicaciones de texto
228 @translationof Text marks
230 @cindex texto, indicaciones de
231 @cindex indicaciones de texto
232 @cindex texto sobre la barra de compás
233 @cindex coda sobre la línea divisoria
234 @cindex segno sobre la línea divisoria
235 @cindex calderón sobre la línea divisoria
236 @cindex líneas divisorias, símbolos sobre las
243 Se pueden añadir a la partitura varios elementos de texto con la
244 sintaxis que se describe en @ref{Llamadas de ensayo}:
246 @c \mark needs to be placed on a separate line (it's not
247 @c attached to an object like \markup is). -vv
249 @lilypond[verbatim,quote,relative=2]
255 Esta sintaxis posibilita colocar cualquier texto sobre la línea
256 divisoria; se pueden incorporar formatos más complejos para el texto
257 usando un bloque @code{\markup}, como está explicado en
258 @ref{Formatear el texto}:
260 @lilypond[quote,verbatim,relative=1]
262 \mark \markup { \italic { colla parte } }
268 Esta sintaxis también permite imprimir símbolos especiales como
269 llamadas, segno o calderones, especificando el nombre del símbolo
270 correspondiente como se explica en
271 @ref{Notación musical dentro de elementos de marcado}:
273 @lilypond[quote,verbatim,relative=2]
275 \mark \markup { \musicglyph #"scripts.ufermata" }
280 Estos objetos se tipografían solamente sobre el pentagrama superior de
281 la partitura; dependiendo de si están especificados al final o en
282 medio de un compás, se colocarán sobre la línea divisoria o entre las
283 notas. Si se especifican en un salto de línea, las llamadas se
284 imprimen al principio de la línea siguiente.
286 @lilypond[quote,verbatim,relative=2]
296 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
297 {printing-marks-at-the-end-of-a-line.ly}
299 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
300 {aligning-marks-with-various-notation-objects.ly}
302 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
303 {printing-marks-on-every-staff.ly}
307 Referencia de la notación:
308 @ref{Llamadas de ensayo},
309 @ref{Formatear el texto},
310 @ref{Notación musical dentro de elementos de marcado},
311 @ref{La tipografía Feta}.
313 Fragmentos de código:
316 Referencia de funcionamiento interno:
317 @rinternals{MarkEvent},
318 @rinternals{Mark_engraver},
319 @rinternals{RehearsalMark}.
323 @unnumberedsubsubsec Texto separado
324 @translationof Separate text
326 @cindex separado, texto
327 @cindex texto separado
328 @cindex independiente, texto
329 @cindex nivel superior, texto del
330 @cindex texto del nivel superior
331 @cindex texto independiente
336 Un bloque @code{\markup} puede existir de forma independiente, fuera
337 de cualquier bloque @code{\score}, como una @qq{expresión de nivel
338 superior}. Esta sintaxis se describe en @ref{Estructura del archivo}.
340 @lilypond[verbatim,quote]
342 Tomorrow, and tomorrow, and tomorrow...
347 Esto hace posible imprimir texto separado de la música, lo que es
348 especialmente útil cuando el archivo de entrada contiene varias
349 piezas, tal y como se describe en @ref{Varias partituras en un libro}.
351 @lilypond[quote,verbatim]
356 Tomorrow, and tomorrow, and tomorrow...
363 Los bloques de texto independientes pueden abarcar varias páginas,
364 posibilitando la impresión de documentos de texto o libros
365 íntegramente desde LilyPond. Esta funcionalidad y la sintaxis que
366 requiere se describen en @ref{Elementos de marcado de varias páginas}.
371 @funindex \markuplines
372 @funindex markuplines
382 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
383 {stand-alone-two-column-markup.ly}
387 Referencia de la notación:
388 @ref{Formatear el texto},
389 @ref{Estructura del archivo},
390 @ref{Varias partituras en un libro},
391 @ref{Elementos de marcado de varias páginas}.
393 Fragmentos de código:
396 Referencia de funcionamiento interno:
397 @rinternals{TextScript}.
400 @node Formatear el texto
401 @subsection Formatear el texto
402 @translationof Formatting text
404 Esta sección presenta los formateados básico y avanzado de texto,
405 usando la sintaxis específica del modo de @code{\markup}.
408 * Introducción al marcado de texto::
409 * Seleccionar la tipografía y su tamaño::
410 * Alineación de texto::
411 * Notación gráfica dentro de elementos de marcado::
412 * Notación musical dentro de elementos de marcado::
413 * Elementos de marcado de varias páginas::
416 @node Introducción al marcado de texto
417 @unnumberedsubsubsec Introducción al marcado de texto
418 @translationof Text markup introduction
421 @cindex texto, marcado de
422 @cindex marcado de texto
423 @cindex tipografiar texto
428 Se usa un bloque @code{\markup} para tipografiar texto con una
429 sintaxis ampliable que se denomina @qq{modo de marcado}.
431 @cindex marcado, expresiones de
432 @cindex expresiones de marcado
433 @cindex marcado, sintaxis
434 @cindex sintaxis del marcado
436 La sintaxis del marcado es similar a la sintaxis usual de LilyPond:
437 una expresión @code{\markup} se encierra entre llaves
438 @code{@{ @dots{} @}}. Una sola palabra se considera como una
439 expresión mínima, y por tanto no necesita estar encerrada entre
442 A diferencia de las indicaciones de @qq{texto entrecomillado} simples,
443 los bloques @code{\markup} pueden contener expresiones anidadas o
444 instrucciones de marcado, que se introducen utilizando el carácter de
445 barra invertida @code{\} . Estas instrucciones sólo afectan a la
446 expresión que sigue inmediatamente.
448 @lilypond[quote,verbatim,relative=2]
450 a2^\markup { poco \italic più forte }
452 d2_\markup { \italic "string. assai" }
454 b1^\markup { \bold { molto \italic agitato } }
458 @cindex caracteres especiales en modo de marcado
459 @cindex marcado, caracteres especiales en modo de
460 @cindex reservados, impresión de caracteres
461 @cindex impresión de caracteres especiales
462 @cindex texto entrecomillado en modo de marcado
464 Un bloque @code{\markup} puede contener también cadenas de texto entre
465 comillas. Dichas cadenas se tratan como expresiones de texto mínimas,
466 y por tanto cualquier instrucción de marcado o carácter especial (como
467 @code{\} y @code{#}) se imprimen literalmente sin afectar al formateo
468 del texto. Se puede hacer que se impriman las propias comillas si se
469 les antepone una barra invertida.
471 @lilypond[quote,verbatim,relative=2]
472 a1^"\italic markup..."
473 a_\markup { \italic "... prints \"italic\" letters!" }
477 Para que se traten como una expresión distinta, es necesario que las
478 listas de palabras estén encerradas entre comillas o precedidas de una
479 instrucción. La forma en que están definidas las expresiones de
480 marcado afecta a cómo se apilan, se centran y se alinean estas
481 expresiones; en el ejemplo siguiente, la segunda expresión
482 @code{\markup} se trata igual que la primera:
484 @lilypond[quote,verbatim,relative=2]
485 c1^\markup { \center-column { a bbb c } }
486 c1^\markup { \center-column { a { bbb c } } }
487 c1^\markup { \center-column { a \line { bbb c } } }
488 c1^\markup { \center-column { a "bbb c" } }
491 Los marcados se pueden almacenar dentro de variables. Estas variables
492 se pueden adjuntar directamente a las notas:
494 @lilypond[quote,verbatim]
495 allegro = \markup { \bold \large Allegro }
505 Se puede encontrar una lista exhaustiva de las instrucciones
506 específicas de @code{\markup} en @ref{Text markup commands}.
510 Referencia de la notación:
511 @ref{Text markup commands}.
513 Fragmentos de código:
517 @file{scm/markup.scm}.
521 Los errores de sintaxis para el modo de marcado a menudo producen
525 @node Seleccionar la tipografía y su tamaño
526 @unnumberedsubsubsec Seleccionar la tipografía y su tamaño
527 @translationof Selecting font and font size
529 @cindex fuente tipográfica, cambiar
530 @cindex cambio de la fuente tipográfica
539 Está contemplado de forma básica el cambio de la fuente tipográfica en
542 @lilypond[quote,verbatim,relative=2]
545 \italic { non troppo \underline Vivo }
548 d,_\markup { \italic quasi \smallCaps Tromba }
552 @cindex fuente tipográfica, tamaño de
553 @cindex texto, tamaño de
564 El tamaño de los caracteres también se puede alterar de distintas
569 el tamaño de la tipografía se puede definir a una serie de tamaños
570 estándar predefinidos,
573 el tamaño de la tipografía se puede establecer a un valor absoluto,
576 el tamaño de la tipografía también se puede cambiar de forma relativa
577 respecto de su valor anterior.
581 El ejemplo siguiente ejemplifica estos tres métodos:
583 @lilypond[quote,verbatim,relative=1]
590 \fontsize #5 Sinfonia
597 \magnify #0.6 { e sentimento } )
610 El texto se puede imprimir como subíndice o como superíndice. De
611 forma predeterminada se imprimen en un tamaño menor, pero también se
612 puede usar un tamaño normal:
614 @lilypond[quote,verbatim]
617 \line { 1 \super st movement }
618 \line { 1 \normal-size-super st movement
619 \sub { (part two) } }
624 @cindex fuente tipográfica, familias de
626 El modo de marcado ofrece una manera fácil de elegir familias de
627 tipografía alternativas. A no ser que se especifique de otro modo, se
628 selecciona automáticamente la fuente predeterminada con serifa, de
629 tipo romano: en la última línea del ejemplo siguiente, no hay
630 diferencia entre la primera y la segunda palabra.
632 @lilypond[quote,verbatim]
635 \line { Act \number 1 }
636 \line { \sans { Scene I. } }
637 \line { \typewriter { Verona. An open place. } }
638 \line { Enter \roman Valentine and Proteus. }
644 Algunas de estas familias, usadas para elementos específicos como
645 números o matices, no ofrecen todos los caracteres, como se explica en
646 @ref{Indicaciones dinámicas contemporáneas} y
647 @ref{Marcas de repetición manual}.
649 @c \concat is actually documented in Align (it is not
650 @c a font-switching command). But we need it here. -vv
652 Si se usan dentro de una palabra, algunas instrucciones de cambio de
653 tipografía o de formateo pueden producir un espacio vacío no deseado.
654 Esto se puede solucionar concatenando en uno solo los distintos
657 @lilypond[quote,verbatim]
661 \concat { 1 \super st }
665 \concat { \dynamic p , }
666 \italic { con dolce espressione }
672 Se puede encontrar una lista exhaustiva de instrucciones de cambio y
673 utilización personalizada de las fuentes tipográficas en @ref{Font}.
675 También es posible definir conjuntos personalizados de fuentes, tal y
676 como se explica en @ref{Tipografías}.
684 @funindex \normalsize
709 Referencia de la notación:
711 @ref{Indicaciones dinámicas contemporáneas},
712 @ref{Marcas de repetición manual},
715 Fragmentos de código:
718 Referencia de funcionamiento interno:
719 @rinternals{TextScript}.
722 @file{scm/define-markup-commands.scm}.
725 La utilización de las instrucciones de tamaño de texto
726 @code{\teeny}, @code{\tiny},
727 @code{\small}, @code{\normalsize}, @code{\large} y
728 @code{\huge} conducen a un espaciado de las líneas inconsistente
729 comparado con el uso de @code{\fontsize}.
732 @node Alineación de texto
733 @unnumberedsubsubsec Alineación de texto
734 @translationof Text alignment
736 @cindex texto, alineación de
737 @cindex alinear texto
738 @cindex alinear texto de marcado
739 @cindex alinear elementos de marcado
740 @cindex marcado, elementos, alinear
741 @cindex marcado, texto, alinear
743 Esta subsección trata sobre cómo colocar texto en el modo de marcado.
744 Los objetos de marcado también se pueden mover como un todo, usando la
745 sintaxis que se describe en @rlearning{Mover objetos}.
747 @c Padding commands should be mentioned on this page, but
748 @c most of these require \box to be more clearly illustrated. -vv
750 @cindex texto, alineación horizontal
751 @cindex horizontal, alineación de texto
753 @funindex \left-align
755 @funindex \center-align
756 @funindex center-align
757 @funindex \right-align
758 @funindex right-align
760 Los objetos de marcado se pueden alinear de distintas maneras. De
761 forma predeterminada, una indicación de texto se alinea sobre el borde
762 izquierdo: en el ejemplo siguiente, no existe diferencia entre los
763 marcados primero y segundo.
765 @lilypond[quote,verbatim,relative=2]
768 d-\markup { \left-align poco }
770 d-\markup { \center-align { poco } }
772 d-\markup { \right-align poco }
778 Se puede realizar un ajuste fino de la alineación horizontal usando un
781 @lilypond[quote,verbatim,relative=2]
782 a1-\markup { \halign #-1 poco }
784 a,-\markup { \halign #0 poco }
786 a,-\markup { \halign #0.5 poco }
788 a,-\markup { \halign #2 poco }
792 Ciertos objetos pueden poseer sus propios procedimientos de
793 alineación, y por tanto no resultan afectados por estas instrucciones.
794 Es posible mover estos objetos de marcado como un todo, como se
795 muestra por ejemplo en @ref{Indicaciones de texto}.
797 @cindex texto, alineación vertical
798 @cindex vertical, alineación de texto
807 La alineación vertical es un poco más compleja. Como se ha dicho más
808 arriba, los objetos de marcado se pueden mover como un todo; sin
809 embargo, también es posible mover elementos específicos dentro de un
810 bloque de marcado. En este caso, el elemento a mover se debe preceder
811 de un @emph{punto de anclaje}, que puede ser otro elemento de marcado
812 o un objeto invisible. El ejemplo siguiente ejemplifica estas dos
813 posibilidades; el último marcado en este ejemplo no tiene punto de
814 anclaje y por ello no resulta movido.
816 @lilypond[quote,verbatim,relative=1]
819 \raise #2 { Scène 1 }
824 \lower #4 \bold { Très modéré }
828 \raise #4 \italic { Une forêt. }
833 @funindex \general-align
834 @funindex general-align
837 @funindex \translate-scaled
838 @funindex translate-scaled
840 Algunas instrucciones pueden afectar tanto a la alineación horizontal
841 como a la vertical de los objetos de texto en el modo de marcado.
842 Cualquier objeto afectado por estas instrucciones se deben preceder de
845 @lilypond[quote,verbatim,relative=1]
848 \translate #'(-1 . 2) "Scène 1"
853 \general-align #Y #3.2 \bold "Très modéré"
858 \translate-scaled #'(-1 . 2) \teeny "Une forêt."
863 @cindex varias líneas, marcado
864 @cindex marcado de varias líneas
865 @cindex varias líneas, texto
866 @cindex texto de varias líneas
867 @cindex texto en columnas
868 @cindex columnas, texto
872 @funindex \center-column
873 @funindex center-column
875 Un objeto de marcado puede incluir varias líneas de texto. En el
876 ejemplo siguiente, cada elemento o expresión se sitúa en su propia
877 línea, ya sea alineada por la izquierda o centrada:
879 @lilypond[quote,verbatim]
895 @cindex centrar texto en la página
896 @cindex texto, centrar en la página
897 @cindex marcado, centrar en la página
902 De forma similar, una lista de elementos o expresiones se puede
903 repartir de forma que rellene por completo el ancho de la línea
904 horizontal (si hay un solo elemento, se centra en el papel). A su
905 vez, estas expresiones pueden incluir texto de varias líneas o
906 cualquier otra expresión de marcado:
908 @lilypond[quote,verbatim]
911 \line { William S. Gilbert }
913 \huge \smallCaps "The Mikado"
915 \smallCaps "The Town of Titipu"
917 \line { Sir Arthur Sullivan }
925 @cindex texto ajustado a palabras
926 @cindex texto justificado
927 @cindex justificado, texto
928 @cindex ajustado a palabras, texto
929 @cindex marcado, texto, ajustado a palabras
930 @cindex texto de marcado ajustado a palabras
931 @cindex ajuste de línea, texto con
939 Las indicaciones de texto largas se pueden también ajustar
940 automáticamente según un ancho de línea dado. Estarán alineados por
941 la izquierda o justificados, como se muestra en el ejemplo siguiente.
943 @lilypond[quote,verbatim]
946 \line \smallCaps { La vida breve }
947 \line \bold { Acto I }
949 (La escena representa el corral de una casa de
950 gitanos en el Albaicín de Granada. Al fondo una
951 puerta por la que se ve el negro interior de
952 una Fragua, iluminado por los rojos resplandores
957 \line \bold { Acto II }
958 \override #'(line-width . 50)
960 (Calle de Granada. Fachada de la casa de Carmela
961 y su hermano Manuel con grandes ventanas abiertas
962 a través de las que se ve el patio
963 donde se celebra una alegre fiesta)
969 @cindex texto, instrucciones de alineación
970 @cindex marcado, texto, instrucciones de alineación
971 @cindex alineación, instrucciones de texto
973 Hay una lista exhaustiva de instrucciones de alineación de texto en
978 Manual de aprendizaje:
979 @rlearning{Mover objetos}.
981 Referencia de la notación:
983 @ref{Indicaciones de texto}.
985 Fragmentos de código:
988 Referencia de funcionamiento interno:
989 @rinternals{TextScript}.
992 @file{scm/define-markup-commands.scm}.
995 @node Notación gráfica dentro de elementos de marcado
996 @unnumberedsubsubsec Notación gráfica dentro de elementos de marcado
997 @translationof Graphic notation inside markup
999 @cindex gráficos, insertar
1000 @cindex dibujar objetos gráficos
1001 @cindex gráficos, dibujar objetos
1002 @cindex insertar objetos gráficos
1003 @cindex gráficos, insertar objetos
1005 Se puede añadir diversos objetos gráficos a una partitura, utilizando
1006 instrucciones de marcado.
1008 @cindex enmarcar texto
1009 @cindex texto, enmarcar
1010 @cindex texto, decorar
1011 @cindex marcado, texto, decorar
1012 @cindex marcado, texto, enmarcar
1013 @cindex decorar texto
1019 @funindex \rounded-box
1020 @funindex rounded-box
1026 Ciertas instrucciones de marcado permiten la decoración de elementos
1027 de texto con gráficos, como se muestra en el ejemplo siguiente.
1029 @lilypond[quote,verbatim]
1030 \markup \fill-line {
1038 \bracket "1866 - 1925"
1041 \rounded-box \bold Prelude
1046 @cindex relleno alrededor de texto
1047 @cindex texto, relleno de
1048 @cindex marcado, relleno de textos de
1050 @funindex \pad-markup
1051 @funindex pad-markup
1054 @funindex \pad-to-box
1055 @funindex pad-to-box
1056 @funindex \pad-around
1057 @funindex pad-around
1059 Algunas instrucciones pueden requerir un aumento del relleno alrededor
1060 del texto: esto se puede conseguir con algunas instrucciones de
1061 marcado descritas exhaustivamente en @ref{Align}.
1063 @lilypond[quote,verbatim]
1064 \markup \fill-line {
1066 \box "Charles Ives (1874 - 1954)"
1068 \box \pad-markup #2 "THE UNANSWERED QUESTION"
1069 \box \pad-x #8 "A Cosmic Landscape"
1076 \box \pad-to-box #'(-5 . 20) #'(0 . 5)
1077 \bold "Largo to Presto"
1080 "String quartet keeps very even time,
1081 Flute quartet keeps very uneven time."
1085 @cindex gráfica, notación
1086 @cindex símbolos no musicales
1087 @cindex no musicales, símbolos
1088 @cindex notación gráfica
1092 @funindex \draw-circle
1093 @funindex draw-circle
1094 @funindex \filled-box
1095 @funindex filled-box
1098 @funindex \draw-line
1100 @funindex \arrow-head
1101 @funindex arrow-head
1103 Se pueden imprimir otros símbolos o elementos gráficos sin que se
1104 requiera ningún otro texto. De igual manera que en el caso de las
1105 expresiones de marcado, dichos objetos se pueden combinar:
1107 @lilypond[quote,verbatim]
1110 \draw-circle #4 #0.4 ##f
1111 \filled-box #'(-4 . 4) #'(-0.5 . 0.5) #1
1117 \draw-line #'(0 . 4)
1118 \arrow-head #Y #DOWN ##f
1123 @cindex insertar gráficos
1124 @cindex imágenes, insertar
1125 @cindex gráficos, insertar
1130 @funindex \postscript
1131 @funindex postscript
1133 Entre las funcionalidades gráficas avanzadas se encuentran la
1134 posibilidad de incluir archivos de imagen externos convertidos al
1135 formato de PostScript Encapsulado (@emph{eps}), y la inclusión directa
1136 de gráficos dentro del archivo de entrada, usando código PostScript
1137 nativo. En tal caso puede ser de utilidad la especificación explícita
1138 del tamaño del dibujo, como se ejemplifica a continuación:
1140 @lilypond[quote,verbatim,relative=1]
1143 \epsfile #X #10 #"./context-example.eps"
1144 \with-dimensions #'(0 . 6) #'(0 . 10)
1160 Hay una lista exhaustiva de instrucciones específicas de gráficos en
1165 Referencia de la notación:
1167 @ref{Anotaciones editoriales}.
1169 Fragmentos de código:
1172 Referencia de funcionamiento interno:
1173 @rinternals{TextScript}.
1176 @file{scm/define-markup-commands.scm},
1177 @file{scm/stencil.scm}.
1180 @node Notación musical dentro de elementos de marcado
1181 @unnumberedsubsubsec Notación musical dentro de elementos de marcado
1182 @translationof Music notation inside markup
1184 @cindex notación dentro de marcado
1185 @cindex música dentro de marcado
1186 @cindex marcado, notación musical dentro de
1188 Se pueden añadir a la partitura diversos elementos de notación
1189 musical, dentro de un objeto de marcado.
1191 Las notas y las alteraciones se pueden escribir utilizando
1192 instrucciones de marcado:
1194 @lilypond[quote,verbatim,relative=2]
1198 \note-by-number #1 #1 #1.5
1201 \natural \semiflat \flat
1202 \sesquiflat \doubleflat
1206 \natural \semisharp \sharp
1207 \sesquisharp \doublesharp
1212 Otros objetos de notación se pueden también imprimir en el modo de
1215 @lilypond[quote,verbatim,relative=1]
1222 fis_\markup { \dynamic rf }
1233 De forma más general, cualquier símbolo musical disponible se puede
1234 incluir por separado dentro de un objeto de marcado, como se
1235 ejemplifica a continuación; hay una lista exhaustiva de estos símbolos
1236 y sus nombres en @ref{La tipografía Feta}.
1238 @lilypond[quote,verbatim,relative=2]
1240 c'^\markup { \musicglyph #"eight" }
1242 c,8._\markup { \musicglyph #"clefs.G_change" }
1244 c2^\markup { \musicglyph #"timesig.neomensural94" }
1247 Otra forma de imprimir glifos que no son de texto se encuentra
1248 descrita en @ref{Explicación de las fuentes tipográficas}. Tiene la
1249 utilidad de imprimir llaves de distintos tamaños.
1251 El modo de marcado también contempla diagramas para instrumentos
1254 @lilypond[quote,verbatim,relative=2]
1256 \fret-diagram-terse #"x;x;o;2;3;2;"
1259 \harp-pedal #"^-v|--ov^"
1264 \musicglyph #"accordion.discant"
1266 \raise #0.5 \musicglyph #"accordion.dot"
1267 \raise #1.5 \musicglyph #"accordion.dot"
1271 @c The accordion diagram is actually taken from a snippet.
1274 Dichos diagramas se encuentran documentados en @ref{Instrument
1277 @cindex partitura dentro marcado
1278 @cindex marcado, partitura dentro de
1280 Incluso una partitura completa se puede incluir dentro de un objeto de
1281 marcado. En tal caso, el bloque anidado @code{\score} debe contener
1282 un bloque @code{\layout}, como se muestra aquí:
1284 @lilypond[quote,verbatim,relative=1]
1287 \relative c' { c4 d e f }
1295 Hay una lista exhaustiva de instrucciones relacionadas con la notación
1296 musical en @ref{Music}.
1300 Referencia de la notación:
1302 @ref{La tipografía Feta},
1303 @ref{Explicación de las fuentes tipográficas}.
1305 Fragmentos de código:
1308 Referencia de funcionamiento interno:
1309 @rinternals{TextScript}.
1312 @file{scm/define-markup-commands.scm},
1313 @file{scm/fret-diagrams.scm},
1314 @file{scm/harp-pedals.scm}.
1317 @node Elementos de marcado de varias páginas
1318 @unnumberedsubsubsec Elementos de marcado de varias páginas
1319 @translationof Multi-page markup
1321 @cindex páginas, marcado de varias
1322 @cindex marcado de varias páginas
1323 @cindex marcado, texto de, varias páginas
1324 @cindex texto que ocupa varias páginas
1326 @funindex \markuplines
1327 @funindex markuplines
1328 @funindex \justified-lines
1329 @funindex justified-lines
1330 @funindex \wordwrap-lines
1331 @funindex wordwrap-lines
1333 Aunque los objetos de marcado estándar no se pueden dividir, una
1334 sintaxis específica hace posible la introducción de líneas de texto
1335 que pueden abarcar varias páginas:
1338 @lilypond[quote,verbatim]
1341 Un texto muy largo de líneas justificadas.
1345 Otro párrafo muy largo.
1352 Esta sintaxis acepta una lista de elementos de marcado, que pueden ser
1355 el resultado de una instrucción de lista de marcado,
1357 una lista de marcados,
1359 o una lista de listas de marcado.
1362 Hay una lista exhaustiva de las instrucciones de lista de marcado en
1363 @ref{Text markup list commands}.
1367 Referencia de la notación:
1368 @ref{Text markup list commands}.
1370 Fragmentos de código:
1373 Manual de extensión:
1374 @rextend{New markup list command definition}.
1376 Referencia de funcionamiento interno:
1377 @rinternals{TextScript}.
1380 @file{scm/define-markup-commands.scm}.
1383 @funindex \markuplines
1384 @funindex markuplines
1387 @code{\markuplines}.
1392 @subsection Tipografías
1393 @translationof Fonts
1395 Esta sección presenta la forma en que se manejan las fuentes
1396 tipográficas, y cómo se pueden cambiar en las partituras.
1399 * Explicación de las fuentes tipográficas::
1400 * Fuentes de un solo elemento::
1401 * Fuentes tipográficas del documento completo::
1405 @node Explicación de las fuentes tipográficas
1406 @unnumberedsubsubsec Explicación de las fuentes tipográficas
1407 @translationof Fonts explained
1410 @cindex fuentes tipográficas, explicación
1411 @cindex llaves de distintos tamaños
1412 @cindex fuentes tipográficas, explicación
1413 @cindex llaves de varios tamaños
1414 @cindex fuentes tipográficas de símbolos en marcado
1415 @cindex símbolos, fuentes tipográficas en el marcado
1417 @funindex font-interface
1419 Las fuentes tipográficas se manejan a través de distintas bibliotecas.
1420 FontConfig se utiliza para detectar las tipografías disponibles en el
1421 sistema; las tipografías seleccionadas se trazan utilizando Pango.
1423 Las tipografías de notación musical se pueden describir como un
1424 conjunto de glifos específicos, ordenados en varias familias. La
1425 siguiente sintaxis permite usar directamente varias tipografías
1426 @code{feta} de LilyPond distintas a las de texto en el modo de
1429 @lilypond[quote,verbatim,relative=2]
1432 \override #'(font-encoding . fetaBraces)
1434 \override #'(font-encoding . fetaText)
1436 \override #'(font-encoding . fetaMusic)
1437 \lookup #"noteheads.s0petrucci"
1443 Sin embargo, todos estos glifos excepto las llaves de varios tamaños
1444 que están contenidas en la fuente tipográfica @code{fetaBraces} están
1445 disponibles utilizando la sintaxis más sencilla que se describe en
1446 @ref{Notación musical dentro de elementos de marcado}.
1448 Cuando se usan los glifos de la fuente de llaves @code{fetaBraces}, el
1449 tamaño de la llave se especifica por la parte numérica del nombre del
1450 glifo, en unidades arbitrarias. Se puede especificar cualquier entero
1451 de @code{0} a @code{575} inclusive, siendo @code{0} el que produce la
1452 llave más pequeña. El valor óptimo se debe determinar por ensayo y
1453 error. Todos estos glifos son llaves izquierdas; las llaves derechas
1454 se pueden obtener mediante rotación, véase @ref{Rotación de objetos}.
1456 Están disponibles tres familias de tipografías de texto: la tipografía
1457 @emph{romana} (con serifa), que de forma predeterminada es New Century
1458 Schoolbook, la fuente @emph{sans} y la fuente monoespaciada
1459 @emph{de máquina de escribir}. Estas dos últimas familias vienen
1460 determinadas por la instalación de Pango.
1462 Cada familia puede incluir distintas formas y series. El ejemplo
1463 siguiente muestra la posibilidad de seleccionar familias, formas,
1464 series y tamaños alternativos. El valor que se da a @code{font-size}
1465 es el cambio requerido a partir del tamaño predeterminado.
1467 @lilypond[quote,verbatim,relative=2]
1468 \override Score.RehearsalMark #'font-family = #'typewriter
1469 \mark \markup "Ouverture"
1470 \override Voice.TextScript #'font-shape = #'italic
1471 \override Voice.TextScript #'font-series = #'bold
1472 d2.^\markup "Allegro"
1473 \override Voice.TextScript #'font-size = #-3
1478 Se puede usar una sintaxis similar en el modo de marcado, aunque en
1479 este caso es preferible usar la sintaxis sencilla que se explica en
1480 @ref{Seleccionar la tipografía y su tamaño}:
1482 @lilypond[quote,verbatim]
1486 \override #'(font-shape . italic)
1487 \override #'(font-size . 4)
1491 \override #'(font-family . typewriter)
1493 \override #'(font-series . bold)
1497 \override #'(font-family . sans)
1504 Aunque es fácil cambiar entre las fuentes tipográficas
1505 preconfiguradas, también es posible usar otras fuentes, como se
1506 explica en las siguientes secciones: @ref{Fuentes de un solo elemento} y
1507 @ref{Fuentes tipográficas del documento completo}.
1511 Referencia de la notación:
1512 @ref{La tipografía Feta},
1513 @ref{Notación musical dentro de elementos de marcado},
1514 @ref{Rotación de objetos},
1515 @ref{Seleccionar la tipografía y su tamaño},
1519 @node Fuentes de un solo elemento
1520 @unnumberedsubsubsec Fuentes de un solo elemento
1521 @translationof Single entry fonts
1523 Se puede usar en una partitura cualquier fuente tipográfica que esté
1524 instalada en el sistema operativo y reconocida por parte de
1525 FontConfig, usando la siguiente sintaxis:
1527 @lilypond[quote,verbatim,relative=2]
1528 \override Staff.TimeSignature #'font-name = #"Bitstream Charter"
1529 \override Staff.TimeSignature #'font-size = #2
1533 \override #'(font-name . "Vera Bold")
1538 @cindex fuentes tipográficas, buscar, disponibles
1539 @cindex buscar fuentes tipográficas disponibles
1540 @cindex listar fuentes tipográficas disponibles
1541 @cindex disponibles, listar las fuentes tipográficas
1543 @funindex show-available-fonts
1545 La instrucción siguiente presenta una lista de todas las tipografías
1546 disponibles en el sistema operativo:
1549 lilypond -dshow-available-fonts x
1554 Referencia de la notación:
1555 @ref{Explicación de las fuentes tipográficas},
1556 @ref{Fuentes tipográficas del documento completo}.
1558 Fragmentos de código:
1561 @c A source file gets never installed...
1563 @c @file{lily/font-config-scheme.cc}.
1566 @node Fuentes tipográficas del documento completo
1567 @unnumberedsubsubsec Fuentes tipográficas del documento completo
1568 @translationof Entire document fonts
1570 Se pueden cambiar las fuentes tipográficas que se usan como
1571 tipografías predeterminadas en las familias @emph{romana},
1572 @emph{sans-serif} y @emph{monoespaciada}, especificándolas en este
1573 orden como se ve en el ejemplo de abajo. Para leer más explicaciones
1574 sobre las fuentes tipográficas, consulte @ref{Explicación de las fuentes tipográficas}.
1576 @cindex fuente, establecer la familia de
1577 @cindex fuentes tipográficas, cambiar para todo el documento
1579 @funindex make-pango-font-tree
1581 @lilypond[verbatim,quote]
1585 (make-pango-font-tree "Times New Roman"
1588 (/ myStaffSize 20)))
1595 \typewriter typewriter. }
1599 @c we don't do Helvetica / Courier, since GS incorrectly loads
1604 Referencia de la notación:
1605 @ref{Explicación de las fuentes tipográficas},
1606 @ref{Fuentes de un solo elemento},
1607 @ref{Seleccionar la tipografía y su tamaño},