1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
3 Translation of GIT committish: b6f94447415dded7c6e146b41b6139fe76cb84c4
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},
24 @ref{Títulos y encabezamientos}.
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}.
114 Manual de aprendizaje:
115 @rlearning{Colocación de los objetos}.
117 Referencia de la notación:
118 @ref{Formatear el texto},
119 @ref{Dirección y posición},
120 @ref{Articulaciones y ornamentos}.
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
135 La comprobación necesaria para asegurar que las inscripciones de texto
136 y la letra de las canciones se mantienen dentro de los márgenes,
137 requiere cálculos adicionales. En caso de que desee un proceso
138 ligeramente más rápido, puede utilizar
141 \override Score.PaperColumn.keep-inside-line = ##f
145 @node Extensiones de texto
146 @unnumberedsubsubsec Extensiones de texto
147 @translationof Text spanners
149 @cindex texto, elementos de extensión
151 Ciertas indicaciones de ejecución, p.ej., @i{rallentando} o
152 @i{accelerando}, se escriben como texto y se extienden sobre muchos
153 compases mediante líneas de puntos. Estos objetos, que reciben el
154 nombre de @q{spanners} u objetos de extensión, se pueden crear desde
155 una nota hasta otra usando la siguiente sintaxis:
157 @lilypond[verbatim,quote,relative=2]
158 \override TextSpanner.bound-details.left.text = "rit."
163 @cindex texto, formateado de los elementos de extensión
164 @cindex formato de los elementos de extensión de texto
167 La cadena de texto que imprimir se establece a través de propiedades
168 de objeto. De forma predeterminada se imprime en estilo cursiva, pero
169 se pueden conseguir distintos efectos de formato utilizando bloques
170 @code{\markup}, como se describe en @ref{Formatear el texto}.
172 @lilypond[quote,relative=2,verbatim]
173 \override TextSpanner.bound-details.left.text =
174 \markup { \upright "rit." }
179 El estilo de la línea, así como la cadena de texto, se pueden definir
180 como una propiedad de objeto. Esta sintaxis se describe en
181 @ref{Estilos de línea}.
183 @funindex \textSpannerUp
184 @funindex textSpannerUp
185 @funindex \textSpannerDown
186 @funindex textSpannerDown
187 @funindex \textSpannerNeutral
188 @funindex textSpannerNeutral
192 @code{\textSpannerUp},
193 @code{\textSpannerDown},
194 @code{\textSpannerNeutral}.
198 LilyPond sólo puede manejar un objeto de extensión de texto por cada
202 @lilypondfile[verbatim,quote,texidoc,doctitle]
203 {dynamics-text-spanner-postfix.ly}
205 @lilypondfile[verbatim,quote,texidoc,doctitle]
206 {dynamics-custom-text-spanner-postfix.ly}
209 Referencia de la notación:
210 @ref{Estilos de línea},
211 @ref{Matices dinámicos},
212 @ref{Formatear el texto}.
214 Fragmentos de código:
216 @rlsr{Expressive marks}.
218 Referencia de funcionamiento interno:
219 @rinternals{TextSpanner}.
222 @node Indicaciones de texto
223 @unnumberedsubsubsec Indicaciones de texto
224 @translationof Text marks
226 @cindex texto, indicaciones de
227 @cindex indicaciones de texto
228 @cindex texto sobre la barra de compás
229 @cindex coda sobre la línea divisoria
230 @cindex segno sobre la línea divisoria
231 @cindex calderón sobre la línea divisoria
232 @cindex líneas divisorias, símbolos sobre las
239 Se pueden añadir a la partitura varios elementos de texto con la
240 sintaxis que se describe en @ref{Llamadas de ensayo}:
242 @c \mark needs to be placed on a separate line (it's not
243 @c attached to an object like \markup is). -vv
245 @lilypond[verbatim,quote,relative=2]
251 Esta sintaxis posibilita colocar cualquier texto sobre la línea
252 divisoria; se pueden incorporar formatos más complejos para el texto
253 usando un bloque @code{\markup}, como está explicado en
254 @ref{Formatear el texto}:
256 @lilypond[quote,verbatim,relative=1]
258 \mark \markup { \italic { colla parte } }
264 Esta sintaxis también permite imprimir símbolos especiales como
265 llamadas, segno o calderones, especificando el nombre del símbolo
266 correspondiente como se explica en
267 @ref{Notación musical dentro de elementos de marcado}:
269 @lilypond[quote,verbatim,relative=2]
271 \mark \markup { \musicglyph #"scripts.ufermata" }
276 Estos objetos se tipografían solamente sobre el pentagrama superior de
277 la partitura; dependiendo de si están especificados al final o en
278 medio de un compás, se colocarán sobre la línea divisoria o entre las
279 notas. Si se especifican en un salto de línea, las llamadas se
280 imprimen al principio de la línea siguiente.
282 @lilypond[quote,verbatim,relative=2]
289 @funindex \markLengthOn
290 @funindex markLengthOn
291 @funindex \markLengthOff
292 @funindex markLengthOff
295 @code{\markLengthOn},
296 @code{\markLengthOff}.
301 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
302 {printing-marks-at-the-end-of-a-line.ly}
304 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
305 {aligning-marks-with-various-notation-objects.ly}
307 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
308 {printing-marks-on-every-staff.ly}
311 Referencia de la notación:
312 @ref{Llamadas de ensayo},
313 @ref{Formatear el texto},
314 @ref{Notación musical dentro de elementos de marcado},
315 @ref{La tipografía Feta}.
317 Fragmentos de código:
320 Referencia de funcionamiento interno:
321 @rinternals{MarkEvent},
322 @rinternals{Mark_engraver},
323 @rinternals{RehearsalMark}.
327 @unnumberedsubsubsec Texto separado
328 @translationof Separate text
330 @cindex separado, texto
331 @cindex texto separado
332 @cindex independiente, texto
333 @cindex nivel superior, texto del
334 @cindex texto del nivel superior
335 @cindex texto independiente
340 Un bloque @code{\markup} puede existir de forma independiente, fuera
341 de cualquier bloque @code{\score}, como una @qq{expresión de nivel
342 superior}. Esta sintaxis se describe en @ref{Estructura del archivo}.
344 @lilypond[verbatim,quote]
346 Tomorrow, and tomorrow, and tomorrow...
351 Esto hace posible imprimir texto separado de la música, lo que es
352 especialmente útil cuando el archivo de entrada contiene varias
353 piezas, tal y como se describe en @ref{Varias partituras en un libro}.
355 @lilypond[quote,verbatim]
360 Tomorrow, and tomorrow, and tomorrow...
367 Los bloques de texto independientes pueden abarcar varias páginas,
368 posibilitando la impresión de documentos de texto o libros
369 íntegramente desde LilyPond. Esta funcionalidad y la sintaxis que
370 requiere se describen en @ref{Elementos de marcado de varias páginas}.
375 @funindex \markuplist
385 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
386 {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 * Seleccionar la tipografía y su tamaño::
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
440 @code{@{ @dots{} @}}. Una sola palabra se considera como una
441 expresión mínima, y por tanto no necesita estar encerrada entre
444 A diferencia de las indicaciones de @qq{texto entrecomillado} simples,
445 los bloques @code{\markup} pueden contener expresiones anidadas o
446 instrucciones de marcado, que se introducen utilizando el carácter de
447 barra invertida @code{\} . Estas instrucciones sólo afectan a la
448 expresión que sigue inmediatamente.
450 @lilypond[quote,verbatim,relative=2]
452 a2^\markup { poco \italic più forte }
454 d2_\markup { \italic "string. assai" }
456 b1^\markup { \bold { molto \italic agitato } }
460 @cindex caracteres especiales en modo de marcado
461 @cindex marcado, caracteres especiales en modo de
462 @cindex reservados, impresión de caracteres
463 @cindex impresión de caracteres especiales
464 @cindex texto entrecomillado en modo de marcado
466 Un bloque @code{\markup} puede contener también cadenas de texto entre
467 comillas. Dichas cadenas se tratan como expresiones de texto mínimas,
468 y por tanto cualquier instrucción de marcado o carácter especial (como
469 @code{\} y@tie{}@code{#}) se imprimen literalmente sin afectar al formateo
470 del texto. Se puede hacer que se impriman las propias comillas si se
471 les antepone una barra invertida.
473 @lilypond[quote,verbatim,relative=2]
474 a1^"\italic markup..."
475 a_\markup { \italic "... prints \"italic\" letters!" }
479 Para que se traten como una expresión distinta, es necesario que las
480 listas de palabras estén encerradas entre comillas o precedidas de una
481 instrucción. La forma en que están definidas las expresiones de
482 marcado afecta a cómo se apilan, se centran y se alinean estas
483 expresiones; en el ejemplo siguiente, la segunda expresión
484 @code{\markup} se trata igual que la primera:
486 @lilypond[quote,verbatim,relative=2]
487 c1^\markup { \center-column { a bbb c } }
488 c1^\markup { \center-column { a { bbb c } } }
489 c1^\markup { \center-column { a \line { bbb c } } }
490 c1^\markup { \center-column { a "bbb c" } }
493 Los marcados se pueden almacenar dentro de variables. Estas variables
494 se pueden adjuntar directamente a las notas:
496 @lilypond[quote,verbatim]
497 allegro = \markup { \bold \large Allegro }
507 Se puede encontrar una lista exhaustiva de las instrucciones
508 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}.
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
555 @funindex \abs-fontsize
565 El tamaño de la fuente tipográfica se puede alterar en relación al
566 tamaño global del pentagrama, de una serie de formas como se ve a
569 Se puede fijar a un tamaño predefinido,
571 @lilypond[quote,verbatim,relative=2]
572 b1_\markup { \huge Sinfonia }
573 b1^\markup { \teeny da }
574 b1-\markup { \normalsize camera }
577 Se puede establecer a un tamaño relativo al valor anterior,
579 @lilypond[quote,verbatim,relative=2]
580 b1_\markup { \larger Sinfonia }
581 b1^\markup { \smaller da }
582 b1-\markup { \magnify #0.6 camera }
585 Se puede aumentar o disminuir de forma relativa al valor fijado por el
586 tamaño global del pentagrama,
588 @lilypond[quote,verbatim,relative=2]
589 b1_\markup { \fontsize #-2 Sinfonia }
590 b1^\markup { \fontsize #1 da }
591 b1-\markup { \fontsize #3 camera }
594 También se puede establecer a un tamaño de puntos fijo,
595 independientemente del tamaño global del pentagrama,
597 @lilypond[quote,verbatim,relative=2]
598 b1_\markup { \abs-fontsize #20 Sinfonia }
599 b1^\markup { \abs-fontsize #8 da }
600 b1-\markup { \abs-fontsize #14 camera }
610 @funindex \normal-size-super
611 @funindex normal-size-super
613 El texto se puede imprimir como subíndice o como superíndice. De
614 forma predeterminada se imprimen en un tamaño menor, pero también se
615 puede usar un tamaño normal:
617 @lilypond[quote,verbatim]
620 \line { 1 \super st movement }
621 \line { 1 \normal-size-super st movement
622 \sub { (part two) } }
627 @cindex fuente tipográfica, familias de
629 El modo de marcado ofrece una manera fácil de elegir familias de
630 tipografía alternativas. A no ser que se especifique de otro modo, se
631 selecciona automáticamente la fuente predeterminada con serifa, de
632 tipo romano: en la última línea del ejemplo siguiente, no hay
633 diferencia entre la primera y la segunda palabra.
635 @lilypond[quote,verbatim]
638 \line { Act \number 1 }
639 \line { \sans { Scene I. } }
640 \line { \typewriter { Verona. An open place. } }
641 \line { Enter \roman Valentine and Proteus. }
647 Algunas de estas familias, usadas para elementos específicos como
648 números o matices, no ofrecen todos los caracteres, como se explica en
649 @ref{Indicaciones dinámicas contemporáneas} y
650 @ref{Marcas de repetición manual}.
652 @c \concat is actually documented in Align (it is not
653 @c a font-switching command). But we need it here. -vv
655 Si se usan dentro de una palabra, algunas instrucciones de cambio de
656 tipografía o de formateo pueden producir un espacio vacío no deseado.
657 Esto se puede solucionar concatenando en uno solo los distintos
660 @lilypond[quote,verbatim]
664 \concat { 1 \super st }
668 \concat { \dynamic p , }
669 \italic { con dolce espressione }
675 Se puede encontrar una lista exhaustiva de instrucciones de cambio y
676 utilización personalizada de las fuentes tipográficas en @ref{Font}.
678 También es posible definir conjuntos personalizados de fuentes, tal y
679 como se explica en @ref{Tipografías}.
687 @funindex \normalsize
711 Referencia de la notación:
713 @ref{Indicaciones dinámicas contemporáneas},
714 @ref{Marcas de repetición manual},
718 @file{scm/define-markup-commands.scm}.
720 Fragmentos de código:
723 Referencia de funcionamiento interno:
724 @rinternals{TextScript}.
727 La utilización de las instrucciones de tamaño de texto
728 @code{\teeny}, @code{\tiny},
729 @code{\small}, @code{\normalsize}, @code{\large} y
730 @code{\huge} conducen a un espaciado de las líneas inconsistente
731 comparado con el uso de @code{\fontsize}.
734 @node Alineación de texto
735 @unnumberedsubsubsec Alineación de texto
736 @translationof Text alignment
738 @cindex texto, alineación de
739 @cindex alinear texto
740 @cindex alinear texto de marcado
741 @cindex alinear elementos de marcado
742 @cindex marcado, elementos, alinear
743 @cindex marcado, texto, alinear
745 Esta subsección trata sobre cómo colocar texto en el modo de marcado.
746 Los objetos de marcado también se pueden mover como un todo, usando la
747 sintaxis que se describe en @rlearning{Mover objetos}.
749 @c Padding commands should be mentioned on this page, but
750 @c most of these require \box to be more clearly illustrated. -vv
752 @cindex texto, alineación horizontal
753 @cindex horizontal, alineación de texto
755 @funindex \left-align
757 @funindex \center-align
758 @funindex center-align
759 @funindex \right-align
760 @funindex right-align
762 Los objetos de marcado se pueden alinear de distintas maneras. De
763 forma predeterminada, una indicación de texto se alinea sobre el borde
764 izquierdo: en el ejemplo siguiente, no existe diferencia entre los
765 marcados primero y segundo.
767 @lilypond[quote,verbatim,relative=2]
770 d-\markup { \left-align poco }
772 d-\markup { \center-align { poco } }
774 d-\markup { \right-align poco }
780 Se puede realizar un ajuste fino de la alineación horizontal usando un
783 @lilypond[quote,verbatim,relative=2]
784 a1-\markup { \halign #-1 poco }
786 a,-\markup { \halign #0 poco }
788 a,-\markup { \halign #0.5 poco }
790 a,-\markup { \halign #2 poco }
794 Ciertos objetos pueden poseer sus propios procedimientos de
795 alineación, y por tanto no resultan afectados por estas instrucciones.
796 Es posible mover estos objetos de marcado como un todo, como se
797 muestra por ejemplo en @ref{Indicaciones de texto}.
799 @cindex texto, alineación vertical
800 @cindex vertical, alineación de texto
809 La alineación vertical es un poco más compleja. Como se ha dicho más
810 arriba, los objetos de marcado se pueden mover como un todo; sin
811 embargo, también es posible mover elementos específicos dentro de un
812 bloque de marcado. En este caso, el elemento a mover se debe preceder
813 de un @emph{punto de anclaje}, que puede ser otro elemento de marcado
814 o un objeto invisible. El ejemplo siguiente ejemplifica estas dos
815 posibilidades; el último marcado en este ejemplo no tiene punto de
816 anclaje y por ello no resulta movido.
818 @lilypond[quote,verbatim,relative=1]
821 \raise #2 { Scène 1 }
826 \lower #4 \bold { Très modéré }
830 \raise #4 \italic { Une forêt. }
835 @funindex \general-align
836 @funindex general-align
839 @funindex \translate-scaled
840 @funindex translate-scaled
842 Algunas instrucciones pueden afectar tanto a la alineación horizontal
843 como a la vertical de los objetos de texto en el modo de marcado.
844 Cualquier objeto afectado por estas instrucciones se deben preceder de
847 @lilypond[quote,verbatim,relative=1]
850 \translate #'(-1 . 2) "Scène 1"
855 \general-align #Y #3.2 \bold "Très modéré"
860 \translate-scaled #'(-1 . 2) \teeny "Une forêt."
865 @cindex varias líneas, marcado
866 @cindex marcado de varias líneas
867 @cindex varias líneas, texto
868 @cindex texto de varias líneas
869 @cindex texto en columnas
870 @cindex columnas, texto
874 @funindex \center-column
875 @funindex center-column
877 Un objeto de marcado puede incluir varias líneas de texto. En el
878 ejemplo siguiente, cada elemento o expresión se sitúa en su propia
879 línea, ya sea alineada por la izquierda o centrada:
881 @lilypond[quote,verbatim]
897 @cindex centrar texto en la página
898 @cindex texto, centrar en la página
899 @cindex marcado, centrar en la página
904 De forma similar, una lista de elementos o expresiones se puede
905 repartir de forma que rellene por completo el ancho de la línea
906 horizontal (si hay un solo elemento, se centra en el papel). A su
907 vez, estas expresiones pueden incluir texto de varias líneas o
908 cualquier otra expresión de marcado:
910 @lilypond[quote,verbatim]
913 \line { William S. Gilbert }
915 \huge \smallCaps "The Mikado"
917 \smallCaps "The Town of Titipu"
919 \line { Sir Arthur Sullivan }
927 @cindex texto ajustado a palabras
928 @cindex texto justificado
929 @cindex justificado, texto
930 @cindex ajustado a palabras, texto
931 @cindex marcado, texto, ajustado a palabras
932 @cindex texto de marcado ajustado a palabras
933 @cindex ajuste de línea, texto con
941 Las indicaciones de texto largas se pueden también ajustar
942 automáticamente según un ancho de línea dado. Estarán alineados por
943 la izquierda o justificados, como se muestra en el ejemplo siguiente.
945 @lilypond[quote,verbatim]
948 \line \smallCaps { La vida breve }
949 \line \bold { Acto I }
951 (La escena representa el corral de una casa de
952 gitanos en el Albaicín de Granada. Al fondo una
953 puerta por la que se ve el negro interior de
954 una Fragua, iluminado por los rojos resplandores
959 \line \bold { Acto II }
960 \override #'(line-width . 50)
962 (Calle de Granada. Fachada de la casa de Carmela
963 y su hermano Manuel con grandes ventanas abiertas
964 a través de las que se ve el patio
965 donde se celebra una alegre fiesta)
971 @cindex texto, instrucciones de alineación
972 @cindex marcado, texto, instrucciones de alineación
973 @cindex alineación, instrucciones de texto
975 Hay una lista exhaustiva de instrucciones de alineación de texto en
979 Manual de aprendizaje:
980 @rlearning{Mover objetos}.
982 Referencia de la notación:
984 @ref{Indicaciones de texto}.
987 @file{scm/define-markup-commands.scm}.
989 Fragmentos de código:
992 Referencia de funcionamiento interno:
993 @rinternals{TextScript}.
996 @node Notación gráfica dentro de elementos de marcado
997 @unnumberedsubsubsec Notación gráfica dentro de elementos de marcado
998 @translationof Graphic notation inside markup
1000 @cindex gráficos, insertar
1001 @cindex dibujar objetos gráficos
1002 @cindex gráficos, dibujar objetos
1003 @cindex insertar objetos gráficos
1004 @cindex gráficos, insertar objetos
1006 Se puede añadir diversos objetos gráficos a una partitura, utilizando
1007 instrucciones de marcado.
1009 @cindex enmarcar texto
1010 @cindex texto, enmarcar
1011 @cindex texto, decorar
1012 @cindex marcado, texto, decorar
1013 @cindex marcado, texto, enmarcar
1014 @cindex decorar texto
1020 @funindex \rounded-box
1021 @funindex rounded-box
1027 Ciertas instrucciones de marcado permiten la decoración de elementos
1028 de texto con gráficos, como se muestra en el ejemplo siguiente.
1030 @lilypond[quote,verbatim]
1031 \markup \fill-line {
1039 \bracket "1866 - 1925"
1042 \rounded-box \bold Prelude
1047 @cindex relleno alrededor de texto
1048 @cindex texto, relleno de
1049 @cindex marcado, relleno de textos de
1051 @funindex \pad-markup
1052 @funindex pad-markup
1055 @funindex \pad-to-box
1056 @funindex pad-to-box
1057 @funindex \pad-around
1058 @funindex pad-around
1060 Algunas instrucciones pueden requerir un aumento del relleno alrededor
1061 del texto: esto se puede conseguir con algunas instrucciones de
1062 marcado descritas exhaustivamente en @ref{Align}.
1064 @lilypond[quote,verbatim]
1065 \markup \fill-line {
1067 \box "Charles Ives (1874 - 1954)"
1069 \box \pad-markup #2 "THE UNANSWERED QUESTION"
1070 \box \pad-x #8 "A Cosmic Landscape"
1077 \box \pad-to-box #'(-5 . 20) #'(0 . 5)
1078 \bold "Largo to Presto"
1081 "String quartet keeps very even time,
1082 Flute quartet keeps very uneven time."
1086 @cindex gráfica, notación
1087 @cindex símbolos no musicales
1088 @cindex no musicales, símbolos
1089 @cindex notación gráfica
1093 @funindex \draw-circle
1094 @funindex draw-circle
1095 @funindex \filled-box
1096 @funindex filled-box
1099 @funindex \draw-line
1101 @funindex \arrow-head
1102 @funindex arrow-head
1104 Se pueden imprimir otros símbolos o elementos gráficos sin que se
1105 requiera ningún otro texto. De igual manera que en el caso de las
1106 expresiones de marcado, dichos objetos se pueden combinar:
1108 @lilypond[quote,verbatim]
1111 \draw-circle #4 #0.4 ##f
1112 \filled-box #'(-4 . 4) #'(-0.5 . 0.5) #1
1118 \draw-line #'(0 . 4)
1119 \arrow-head #Y #DOWN ##f
1124 @cindex insertar gráficos
1125 @cindex imágenes, insertar
1126 @cindex gráficos, insertar
1131 @funindex \postscript
1132 @funindex postscript
1134 Entre las funcionalidades gráficas avanzadas se encuentran la
1135 posibilidad de incluir archivos de imagen externos convertidos al
1136 formato de PostScript Encapsulado (@emph{eps}), y la inclusión directa
1137 de gráficos dentro del archivo de entrada, usando código PostScript
1138 nativo. En tal caso puede ser de utilidad la especificación explícita
1139 del tamaño del dibujo, como se ejemplifica a continuación:
1141 @lilypond[quote,verbatim,relative=1]
1144 \epsfile #X #10 #"./context-example.eps"
1145 \with-dimensions #'(0 . 6) #'(0 . 10)
1161 Hay una lista exhaustiva de instrucciones específicas de gráficos en
1165 Referencia de la notación:
1167 @ref{Anotaciones editoriales}.
1170 @file{scm/define-markup-commands.scm},
1171 @file{scm/stencil.scm}.
1173 Fragmentos de código:
1176 Referencia de funcionamiento interno:
1177 @rinternals{TextScript}.
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]
1217 ees\finger \markup \tied-lyric #"4~1"
1218 fis_\markup { \dynamic rf }
1229 De forma más general, cualquier símbolo musical disponible se puede
1230 incluir por separado dentro de un objeto de marcado, como se
1231 ejemplifica a continuación; hay una lista exhaustiva de estos símbolos
1232 y sus nombres en @ref{La tipografía Feta}.
1234 @lilypond[quote,verbatim,relative=2]
1236 c'^\markup { \musicglyph #"eight" }
1238 c,8._\markup { \musicglyph #"clefs.G_change" }
1240 c2^\markup { \musicglyph #"timesig.neomensural94" }
1243 Otra forma de imprimir glifos que no son de texto se encuentra
1244 descrita en @ref{Explicación de las fuentes tipográficas}. Tiene la
1245 utilidad de imprimir llaves de distintos tamaños.
1247 El modo de marcado también contempla diagramas para instrumentos
1250 @lilypond[quote,verbatim,relative=2]
1252 \fret-diagram-terse #"x;x;o;2;3;2;"
1255 \harp-pedal #"^-v|--ov^"
1260 \musicglyph #"accordion.discant"
1262 \raise #0.5 \musicglyph #"accordion.dot"
1263 \raise #1.5 \musicglyph #"accordion.dot"
1267 @c The accordion diagram is actually taken from a snippet.
1270 Dichos diagramas se encuentran documentados en @ref{Instrument
1273 @cindex partitura dentro marcado
1274 @cindex marcado, partitura dentro de
1276 Incluso una partitura completa se puede incluir dentro de un objeto de
1277 marcado. En tal caso, el bloque anidado @code{\score} debe contener
1278 un bloque @code{\layout}, como se muestra aquí:
1280 @lilypond[quote,verbatim,relative=1]
1283 \relative c' { c4 d e f }
1291 Hay una lista exhaustiva de instrucciones relacionadas con la notación
1292 musical en @ref{Music}.
1295 Referencia de la notación:
1297 @ref{La tipografía Feta},
1298 @ref{Explicación de las fuentes tipográficas}.
1301 @file{scm/define-markup-commands.scm},
1302 @file{scm/fret-diagrams.scm},
1303 @file{scm/harp-pedals.scm}.
1305 Fragmentos de código:
1308 Referencia de funcionamiento interno:
1309 @rinternals{TextScript}.
1312 @node Elementos de marcado de varias páginas
1313 @unnumberedsubsubsec Elementos de marcado de varias páginas
1314 @translationof Multi-page markup
1316 @cindex páginas, marcado de varias
1317 @cindex marcado de varias páginas
1318 @cindex marcado, texto de, varias páginas
1319 @cindex texto que ocupa varias páginas
1321 @funindex \markuplist
1322 @funindex markuplist
1323 @funindex \justified-lines
1324 @funindex justified-lines
1325 @funindex \wordwrap-lines
1326 @funindex wordwrap-lines
1328 Aunque los objetos de marcado estándar no se pueden dividir, una
1329 sintaxis específica hace posible la introducción de líneas de texto
1330 que pueden abarcar varias páginas:
1333 @lilypond[quote,verbatim]
1336 Un texto muy largo de líneas justificadas.
1340 Otro párrafo muy largo.
1347 Esta sintaxis acepta una lista de elementos de marcado, que pueden ser
1350 el resultado de una instrucción de lista de marcado,
1352 una lista de marcados,
1354 o una lista de listas de marcado.
1357 Hay una lista exhaustiva de las instrucciones de lista de marcado en
1358 @ref{Text markup list commands}.
1361 Referencia de la notación:
1362 @ref{Text markup list commands}.
1365 @file{scm/define-markup-commands.scm}.
1367 Manual de extensión:
1368 @rextend{New markup list command definition}.
1370 Fragmentos de código:
1373 Referencia de funcionamiento interno:
1374 @rinternals{TextScript}.
1376 @funindex \markuplist
1377 @funindex markuplist
1385 @subsection Tipografías
1386 @translationof Fonts
1388 Esta sección presenta la forma en que se manejan las fuentes
1389 tipográficas, y cómo se pueden cambiar en las partituras.
1392 * Explicación de las fuentes tipográficas::
1393 * Fuentes de un solo elemento::
1394 * Fuentes tipográficas del documento completo::
1398 @node Explicación de las fuentes tipográficas
1399 @unnumberedsubsubsec Explicación de las fuentes tipográficas
1400 @translationof Fonts explained
1403 @cindex fuentes tipográficas, explicación
1404 @cindex llaves de distintos tamaños
1405 @cindex fuentes tipográficas, explicación
1406 @cindex llaves de varios tamaños
1407 @cindex fuentes tipográficas de símbolos en marcado
1408 @cindex símbolos, fuentes tipográficas en el marcado
1410 @funindex font-interface
1412 Las fuentes tipográficas se manejan a través de distintas bibliotecas.
1413 FontConfig se utiliza para detectar las tipografías disponibles en el
1414 sistema; las tipografías seleccionadas se trazan utilizando Pango.
1416 Las tipografías de notación musical se pueden describir como un
1417 conjunto de glifos específicos, ordenados en varias familias. La
1418 siguiente sintaxis permite usar directamente varias tipografías
1419 @code{feta} de LilyPond distintas a las de texto en el modo de
1422 @lilypond[quote,verbatim,relative=2]
1425 \override #'(font-encoding . fetaBraces)
1427 \override #'(font-encoding . fetaText)
1429 \override #'(font-encoding . fetaMusic)
1430 \lookup #"noteheads.s0petrucci"
1436 Sin embargo, todos estos glifos excepto las llaves de varios tamaños
1437 que están contenidas en la fuente tipográfica @code{fetaBraces} están
1438 disponibles utilizando la sintaxis más sencilla que se describe en
1439 @ref{Notación musical dentro de elementos de marcado}.
1441 Cuando se usan los glifos de la fuente de llaves @code{fetaBraces}, el
1442 tamaño de la llave se especifica por la parte numérica del nombre del
1443 glifo, en unidades arbitrarias. Se puede especificar cualquier entero
1444 de @code{0} a @code{575} inclusive, siendo @code{0} el que produce la
1445 llave más pequeña. El valor óptimo se debe determinar por ensayo y
1446 error. Todos estos glifos son llaves izquierdas; las llaves derechas
1447 se pueden obtener mediante rotación, véase @ref{Rotación de objetos}.
1449 Están disponibles tres familias de tipografías de texto: la tipografía
1450 @emph{romana} (con serifa), que de forma predeterminada es New Century
1451 Schoolbook, la fuente @emph{sans} y la fuente monoespaciada
1452 @emph{de máquina de escribir}. Estas dos últimas familias vienen
1453 determinadas por la instalación de Pango.
1455 Cada familia puede incluir distintas formas y series. El ejemplo
1456 siguiente muestra la posibilidad de seleccionar familias, formas,
1457 series y tamaños alternativos. El valor que se da a @code{font-size}
1458 es el cambio requerido a partir del tamaño predeterminado.
1460 @lilypond[quote,verbatim,relative=2]
1461 \override Score.RehearsalMark.font-family = #'typewriter
1462 \mark \markup "Ouverture"
1463 \override Voice.TextScript.font-shape = #'italic
1464 \override Voice.TextScript.font-series = #'bold
1465 d2.^\markup "Allegro"
1466 \override Voice.TextScript.font-size = #-3
1471 Se puede usar una sintaxis similar en el modo de marcado, aunque en
1472 este caso es preferible usar la sintaxis sencilla que se explica en
1473 @ref{Seleccionar la tipografía y su tamaño}:
1475 @lilypond[quote,verbatim]
1479 \override #'(font-shape . italic)
1480 \override #'(font-size . 4)
1484 \override #'(font-family . typewriter)
1486 \override #'(font-series . bold)
1490 \override #'(font-family . sans)
1497 Aunque es fácil cambiar entre las fuentes tipográficas
1498 preconfiguradas, también es posible usar otras fuentes, como se
1499 explica en las siguientes secciones: @ref{Fuentes de un solo elemento} y
1500 @ref{Fuentes tipográficas del documento completo}.
1503 Referencia de la notación:
1504 @ref{La tipografía Feta},
1505 @ref{Notación musical dentro de elementos de marcado},
1506 @ref{Rotación de objetos},
1507 @ref{Seleccionar la tipografía y su tamaño},
1511 @node Fuentes de un solo elemento
1512 @unnumberedsubsubsec Fuentes de un solo elemento
1513 @translationof Single entry fonts
1515 Se puede usar en una partitura cualquier fuente tipográfica que esté
1516 instalada en el sistema operativo y reconocida por parte de
1517 FontConfig, usando la siguiente sintaxis:
1519 @lilypond[quote,verbatim,relative=2]
1520 \override Staff.TimeSignature.font-name = #"Bitstream Charter"
1521 \override Staff.TimeSignature.font-size = #2
1525 \override #'(font-name . "Vera Bold")
1530 @cindex fuentes tipográficas, buscar, disponibles
1531 @cindex buscar fuentes tipográficas disponibles
1532 @cindex listar fuentes tipográficas disponibles
1533 @cindex disponibles, listar las fuentes tipográficas
1535 @funindex show-available-fonts
1537 La instrucción siguiente presenta una lista de todas las tipografías
1538 disponibles en el sistema operativo:
1541 lilypond -dshow-available-fonts x
1545 Referencia de la notación:
1546 @ref{Explicación de las fuentes tipográficas},
1547 @ref{Fuentes tipográficas del documento completo}.
1549 Fragmentos de código:
1552 @c A source file gets never installed...
1554 @c @file{lily/font-config-scheme.cc}.
1557 @node Fuentes tipográficas del documento completo
1558 @unnumberedsubsubsec Fuentes tipográficas del documento completo
1559 @translationof Entire document fonts
1561 Se pueden cambiar las fuentes tipográficas que se usan como
1562 tipografías predeterminadas en las familias @emph{romana},
1563 @emph{sans-serif} y @emph{monoespaciada}, especificándolas en este
1564 orden como se ve en el ejemplo de abajo, que escala las tipografías
1565 automáticamente con el valor fijado para el tamaño global del pentagrama.
1566 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]
1577 (make-pango-font-tree "Times New Roman"
1580 (/ staff-height pt 20)))
1587 \typewriter typewriter. }
1591 @c we don't do Helvetica / Courier, since GS incorrectly loads
1595 Referencia de la notación:
1596 @ref{Explicación de las fuentes tipográficas},
1597 @ref{Fuentes de un solo elemento},
1598 @ref{Seleccionar la tipografía y su tamaño},