1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
3 Translation of GIT committish: 354e5ce3edd1dba03b4ecb68fc766bb46235f5d2
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]
71 \relative { a'8^"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]
81 a'8^\markup { \italic pizz. } g f e
82 a4_\markup { \tiny scherz. \bold molto } f }
85 De forma predeterminada, las indicaciones de texto no afectan al
86 espaciado de las notas. Sin embargo, su anchura sí podría tenerse en
87 cuenta: en el siguiente ejemplo, la primera cadena de texto no afecta
88 al espaciado, pero la segunda sí afecta.
90 @lilypond[quote,verbatim]
98 Se pueden adjuntar articulaciones a las notas, además de inscripciones
99 de texto. Para ver más información, consulte @ref{Articulaciones y
102 Para ver más información sobre el orden relativo de las inscripciones
103 de texto y las articulaciones, consulte @rlearning{Colocación de los
106 @funindex \textLengthOn
107 @funindex textLengthOn
108 @funindex \textLengthOff
109 @funindex textLengthOff
112 @code{\textLengthOn},
113 @code{\textLengthOff}.
117 Manual de aprendizaje:
118 @rlearning{Colocación de los objetos}.
120 Referencia de la notación:
121 @ref{Formatear el texto},
122 @ref{Dirección y posición},
123 @ref{Articulaciones y ornamentos}.
125 Fragmentos de código:
128 Referencia de funcionamiento interno:
129 @rinternals{TextScript}.
132 @cindex texto fuera del margen
133 @cindex margen, texto fuera del
134 @cindex texto, mantener dentro del margen
135 @cindex letra, mantener dentro del margen
138 La comprobación necesaria para asegurar que las inscripciones de texto
139 y la letra de las canciones se mantienen dentro de los márgenes,
140 requiere cálculos adicionales. En caso de que desee un proceso
141 ligeramente más rápido, puede utilizar
144 \override Score.PaperColumn.keep-inside-line = ##f
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]
162 \override TextSpanner.bound-details.left.text = "rit."
168 @cindex texto, formateado de los elementos de extensión
169 @cindex formato de los elementos de extensión de texto
172 La cadena de texto que imprimir se establece a través de propiedades
173 de objeto. De forma predeterminada se imprime en estilo cursiva, pero
174 se pueden conseguir distintos efectos de formato utilizando bloques
175 @code{\markup}, como se describe en @ref{Formatear el texto}.
177 @lilypond[quote,verbatim]
179 \override TextSpanner.bound-details.left.text =
180 \markup { \upright "rit." }
186 El estilo de la línea, así como la cadena de texto, se pueden definir
187 como una propiedad de objeto. Esta sintaxis se describe en
188 @ref{Estilos de línea}.
190 @funindex \textSpannerUp
191 @funindex textSpannerUp
192 @funindex \textSpannerDown
193 @funindex textSpannerDown
194 @funindex \textSpannerNeutral
195 @funindex textSpannerNeutral
199 @code{\textSpannerUp},
200 @code{\textSpannerDown},
201 @code{\textSpannerNeutral}.
205 LilyPond sólo puede manejar un objeto de extensión de texto por cada
209 @lilypondfile[verbatim,quote,texidoc,doctitle]
210 {dynamics-text-spanner-postfix.ly}
212 @lilypondfile[verbatim,quote,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},
219 @ref{Formatear el texto}.
221 Fragmentos de código:
223 @rlsr{Expressive marks}.
225 Referencia de funcionamiento interno:
226 @rinternals{TextSpanner}.
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]
260 Esta sintaxis posibilita colocar cualquier texto sobre la línea
261 divisoria; se pueden incorporar formatos más complejos para el texto
262 usando un bloque @code{\markup}, como está explicado en
263 @ref{Formatear el texto}:
265 @lilypond[quote,verbatim]
268 \mark \markup { \italic { colla parte } }
275 Esta sintaxis también permite imprimir símbolos especiales como
276 llamadas, segno o calderones, especificando el nombre del símbolo
277 correspondiente como se explica en
278 @ref{Notación musical dentro de elementos de marcado}:
280 @lilypond[quote,verbatim]
283 \mark \markup { \musicglyph #"scripts.ufermata" }
289 Estos objetos se tipografían solamente sobre el pentagrama superior de
290 la partitura; dependiendo de si están especificados al final o en
291 medio de un compás, se colocarán sobre la línea divisoria o entre las
292 notas. Si se especifican en un salto de línea, las llamadas se
293 imprimen al principio de la línea siguiente.
295 @lilypond[quote,verbatim,ragged-right]
304 @funindex \markLengthOn
305 @funindex markLengthOn
306 @funindex \markLengthOff
307 @funindex markLengthOff
310 @code{\markLengthOn},
311 @code{\markLengthOff}.
316 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
317 {printing-marks-at-the-end-of-a-line.ly}
319 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
320 {printing-marks-on-every-staff.ly}
323 Referencia de la notación:
324 @ref{Llamadas de ensayo},
325 @ref{Formatear el texto},
326 @ref{Notación musical dentro de elementos de marcado},
327 @ref{La tipografía Feta}.
329 Fragmentos de código:
332 Referencia de funcionamiento interno:
333 @rinternals{MarkEvent},
334 @rinternals{Mark_engraver},
335 @rinternals{RehearsalMark}.
339 @unnumberedsubsubsec Texto separado
340 @translationof Separate text
342 @cindex separado, texto
343 @cindex texto separado
344 @cindex independiente, texto
345 @cindex nivel superior, texto del
346 @cindex texto del nivel superior
347 @cindex texto independiente
352 Un bloque @code{\markup} puede existir de forma independiente, fuera
353 de cualquier bloque @code{\score}, como una @qq{expresión de nivel
354 superior}. Esta sintaxis se describe en @ref{Estructura del archivo}.
356 @lilypond[verbatim,quote]
358 Tomorrow, and tomorrow, and tomorrow...
363 Esto hace posible imprimir texto separado de la música, lo que es
364 especialmente útil cuando el archivo de entrada contiene varias
365 piezas, tal y como se describe en @ref{Varias partituras en un libro}.
367 @lilypond[quote,verbatim]
372 Tomorrow, and tomorrow, and tomorrow...
379 Los bloques de texto independientes pueden abarcar varias páginas,
380 posibilitando la impresión de documentos de texto o libros
381 íntegramente desde LilyPond. Esta funcionalidad y la sintaxis que
382 requiere se describen en @ref{Elementos de marcado de varias páginas}.
387 @funindex \markuplist
397 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
398 {stand-alone-two-column-markup.ly}
401 Referencia de la notación:
402 @ref{Formatear el texto},
403 @ref{Estructura del archivo},
404 @ref{Varias partituras en un libro},
405 @ref{Elementos de marcado de varias páginas}.
407 Fragmentos de código:
410 Referencia de funcionamiento interno:
411 @rinternals{TextScript}.
414 @node Formatear el texto
415 @subsection Formatear el texto
416 @translationof Formatting text
418 Esta sección presenta los formateados básico y avanzado de texto,
419 usando la sintaxis específica del modo de @code{\markup}.
422 * Introducción al marcado de texto::
423 * Seleccionar la tipografía y su tamaño::
424 * Alineación de texto::
425 * Notación gráfica dentro de elementos de marcado::
426 * Notación musical dentro de elementos de marcado::
427 * Elementos de marcado de varias páginas::
430 @node Introducción al marcado de texto
431 @unnumberedsubsubsec Introducción al marcado de texto
432 @translationof Text markup introduction
435 @cindex texto, marcado de
436 @cindex marcado de texto
437 @cindex tipografiar texto
442 Se usa un bloque @code{\markup} para tipografiar texto con una
443 sintaxis ampliable que se denomina @qq{modo de marcado}.
445 @cindex marcado, expresiones de
446 @cindex expresiones de marcado
447 @cindex marcado, sintaxis
448 @cindex sintaxis del marcado
450 La sintaxis del marcado es similar a la sintaxis usual de LilyPond:
451 una expresión @code{\markup} se encierra entre llaves
452 @code{@{ @dots{} @}}. Una sola palabra se considera como una
453 expresión mínima, y por tanto no necesita estar encerrada entre
456 A diferencia de las indicaciones de @qq{texto entrecomillado} simples,
457 los bloques @code{\markup} pueden contener expresiones anidadas o
458 instrucciones de marcado, que se introducen utilizando el carácter de
459 barra invertida @code{\} . Estas instrucciones sólo afectan a la
460 expresión que sigue inmediatamente.
462 @lilypond[quote,verbatim]
465 a2^\markup { poco \italic più forte }
467 d2_\markup { \italic "string. assai" }
469 b1^\markup { \bold { molto \italic agitato } }
474 @cindex caracteres especiales en modo de marcado
475 @cindex marcado, caracteres especiales en modo de
476 @cindex reservados, impresión de caracteres
477 @cindex impresión de caracteres especiales
478 @cindex texto entrecomillado en modo de marcado
480 Un bloque @code{\markup} puede contener también cadenas de texto entre
481 comillas. Dichas cadenas se tratan como expresiones de texto mínimas,
482 y por tanto cualquier instrucción de marcado o carácter especial (como
483 @code{\} y@tie{}@code{#}) se imprimen literalmente sin afectar al formateo
484 del texto. Se puede hacer que se impriman las propias comillas si se
485 les antepone una barra invertida.
487 @lilypond[quote,verbatim]
489 a'1^"\italic markup..."
490 a_\markup { \italic "... prints \"italic\" letters!" }
495 Para que se traten como una expresión distinta, es necesario que las
496 listas de palabras estén encerradas entre comillas o precedidas de una
497 instrucción. La forma en que están definidas las expresiones de
498 marcado afecta a cómo se apilan, se centran y se alinean estas
499 expresiones; en el ejemplo siguiente, la segunda expresión
500 @code{\markup} se trata igual que la primera:
502 @lilypond[quote,verbatim]
504 c1^\markup { \center-column { a bbb c } }
505 c1^\markup { \center-column { a { bbb c } } }
506 c1^\markup { \center-column { a \line { bbb c } } }
507 c1^\markup { \center-column { a "bbb c" } }
511 Los marcados se pueden almacenar dentro de variables. Estas variables
512 se pueden adjuntar directamente a las notas:
514 @lilypond[quote,verbatim]
515 allegro = \markup { \bold \large Allegro }
525 Se puede encontrar una lista exhaustiva de las instrucciones
526 específicas de @code{\markup} en @ref{Text markup commands}.
529 Referencia de la notación:
530 @ref{Text markup commands}.
532 Fragmentos de código:
536 @file{scm/markup.scm}.
539 Los errores de sintaxis para el modo de marcado a menudo producen
543 @node Seleccionar la tipografía y su tamaño
544 @unnumberedsubsubsec Seleccionar la tipografía y su tamaño
545 @translationof Selecting font and font size
547 @cindex fuente tipográfica, cambiar
548 @cindex cambio de la fuente tipográfica
557 Está contemplado de forma básica el cambio de la fuente tipográfica en
560 @lilypond[quote,verbatim]
564 \italic { non troppo \underline Vivo }
567 d,_\markup { \italic quasi \smallCaps Tromba }
572 @cindex fuente tipográfica, tamaño de
573 @cindex texto, tamaño de
575 @funindex \abs-fontsize
585 El tamaño de la fuente tipográfica se puede alterar en relación al
586 tamaño global del pentagrama, de una serie de formas como se ve a
589 Se puede fijar a un tamaño predefinido,
591 @lilypond[quote,verbatim]
593 b1_\markup { \huge Sinfonia }
594 b1^\markup { \teeny da }
595 b1-\markup { \normalsize camera }
599 Se puede establecer a un tamaño relativo al valor anterior,
601 @lilypond[quote,verbatim]
603 b1_\markup { \larger Sinfonia }
604 b1^\markup { \smaller da }
605 b1-\markup { \magnify #0.6 camera }
609 Se puede aumentar o disminuir de forma relativa al valor fijado por el
610 tamaño global del pentagrama,
612 @lilypond[quote,verbatim]
614 b1_\markup { \fontsize #-2 Sinfonia }
615 b1^\markup { \fontsize #1 da }
616 b1-\markup { \fontsize #3 camera }
620 También se puede establecer a un tamaño de puntos fijo,
621 independientemente del tamaño global del pentagrama,
623 @lilypond[quote,verbatim]
625 b1_\markup { \abs-fontsize #20 Sinfonia }
626 b1^\markup { \abs-fontsize #8 da }
627 b1-\markup { \abs-fontsize #14 camera }
638 @funindex \normal-size-super
639 @funindex normal-size-super
641 El texto se puede imprimir como subíndice o como superíndice. De
642 forma predeterminada se imprimen en un tamaño menor, pero también se
643 puede usar un tamaño normal:
645 @lilypond[quote,verbatim]
648 \line { 1 \super st movement }
649 \line { 1 \normal-size-super st movement
650 \sub { (part two) } }
655 @cindex fuente tipográfica, familias de
657 El modo de marcado ofrece una manera fácil de elegir familias de
658 tipografía alternativas. A no ser que se especifique de otro modo, se
659 selecciona automáticamente la fuente predeterminada con serifa, de
660 tipo romano: en la última línea del ejemplo siguiente, no hay
661 diferencia entre la primera y la segunda palabra.
663 @lilypond[quote,verbatim]
666 \line { Act \number 1 }
667 \line { \sans { Scene I. } }
668 \line { \typewriter { Verona. An open place. } }
669 \line { Enter \roman Valentine and Proteus. }
675 Algunas de estas familias, usadas para elementos específicos como
676 números o matices, no ofrecen todos los caracteres, como se explica en
677 @ref{Indicaciones dinámicas contemporáneas} y
678 @ref{Marcas de repetición manual}.
680 @c \concat is actually documented in Align (it is not
681 @c a font-switching command). But we need it here. -vv
683 Si se usan dentro de una palabra, algunas instrucciones de cambio de
684 tipografía o de formateo pueden producir un espacio vacío no deseado.
685 Esto se puede solucionar concatenando en uno solo los distintos
688 @lilypond[quote,verbatim]
692 \concat { 1 \super st }
696 \concat { \dynamic p , }
697 \italic { con dolce espressione }
703 Se puede encontrar una lista exhaustiva de instrucciones de cambio y
704 utilización personalizada de las fuentes tipográficas en @ref{Font}.
706 También es posible definir conjuntos personalizados de fuentes, tal y
707 como se explica en @ref{Tipografías}.
715 @funindex \normalsize
739 Referencia de la notación:
741 @ref{Indicaciones dinámicas contemporáneas},
742 @ref{Marcas de repetición manual},
746 @file{scm/define-markup-commands.scm}.
748 Fragmentos de código:
751 Referencia de funcionamiento interno:
752 @rinternals{TextScript}.
755 La utilización de las instrucciones de tamaño de texto
756 @code{\teeny}, @code{\tiny},
757 @code{\small}, @code{\normalsize}, @code{\large} y
758 @code{\huge} conducen a un espaciado de las líneas inconsistente
759 comparado con el uso de @code{\fontsize}.
762 @node Alineación de texto
763 @unnumberedsubsubsec Alineación de texto
764 @translationof Text alignment
766 @cindex texto, alineación de
767 @cindex alinear texto
768 @cindex alinear texto de marcado
769 @cindex alinear elementos de marcado
770 @cindex marcado, elementos, alinear
771 @cindex marcado, texto, alinear
773 Esta subsección trata sobre cómo colocar texto en el modo de marcado.
774 Los objetos de marcado también se pueden mover como un todo, usando la
775 sintaxis que se describe en @rlearning{Mover objetos}.
777 @c Padding commands should be mentioned on this page, but
778 @c most of these require \box to be more clearly illustrated. -vv
780 @cindex texto, alineación horizontal
781 @cindex horizontal, alineación de texto
783 @funindex \left-align
785 @funindex \center-align
786 @funindex center-align
787 @funindex \right-align
788 @funindex right-align
790 Los objetos de marcado se pueden alinear de distintas maneras. De
791 forma predeterminada, una indicación de texto se alinea sobre el borde
792 izquierdo: en el ejemplo siguiente, no existe diferencia entre los
793 marcados primero y segundo.
795 @lilypond[quote,verbatim]
797 d''1-\markup { poco }
799 d-\markup { \left-align poco }
801 d-\markup { \center-align { poco } }
803 d-\markup { \right-align poco }
810 Se puede realizar un ajuste fino de la alineación horizontal usando un
813 @lilypond[quote,verbatim]
815 a'1-\markup { \halign #-1 poco }
817 a,-\markup { \halign #0 poco }
819 a,-\markup { \halign #0.5 poco }
821 a,-\markup { \halign #2 poco }
826 Ciertos objetos pueden poseer sus propios procedimientos de
827 alineación, y por tanto no resultan afectados por estas instrucciones.
828 Es posible mover estos objetos de marcado como un todo, como se
829 muestra por ejemplo en @ref{Indicaciones de texto}.
831 @cindex texto, alineación vertical
832 @cindex vertical, alineación de texto
841 La alineación vertical es un poco más compleja. Como se ha dicho más
842 arriba, los objetos de marcado se pueden mover como un todo; sin
843 embargo, también es posible mover elementos específicos dentro de un
844 bloque de marcado. En este caso, el elemento a mover se debe preceder
845 de un @emph{punto de anclaje}, que puede ser otro elemento de marcado
846 o un objeto invisible. El ejemplo siguiente ejemplifica estas dos
847 posibilidades; el último marcado en este ejemplo no tiene punto de
848 anclaje y por ello no resulta movido.
850 @lilypond[quote,verbatim]
854 \raise #2 { Scène 1 }
859 \lower #4 \bold { Très modéré }
863 \raise #4 \italic { Une forêt. }
869 @funindex \general-align
870 @funindex general-align
873 @funindex \translate-scaled
874 @funindex translate-scaled
876 Algunas instrucciones pueden afectar tanto a la alineación horizontal
877 como a la vertical de los objetos de texto en el modo de marcado.
878 Cualquier objeto afectado por estas instrucciones se deben preceder de
881 @lilypond[quote,verbatim]
885 \translate #'(-1 . 2) "Scène 1"
890 \general-align #Y #3.2 \bold "Très modéré"
895 \translate-scaled #'(-1 . 2) \teeny "Une forêt."
901 @cindex varias líneas, marcado
902 @cindex marcado de varias líneas
903 @cindex varias líneas, texto
904 @cindex texto de varias líneas
905 @cindex texto en columnas
906 @cindex columnas, texto
910 @funindex \center-column
911 @funindex center-column
913 Un objeto de marcado puede incluir varias líneas de texto. En el
914 ejemplo siguiente, cada elemento o expresión se sitúa en su propia
915 línea, ya sea alineada por la izquierda o centrada:
917 @lilypond[quote,verbatim]
933 @cindex centrar texto en la página
934 @cindex texto, centrar en la página
935 @cindex marcado, centrar en la página
940 De forma similar, una lista de elementos o expresiones se puede
941 repartir de forma que rellene por completo el ancho de la línea
942 horizontal (si hay un solo elemento, se centra en el papel). A su
943 vez, estas expresiones pueden incluir texto de varias líneas o
944 cualquier otra expresión de marcado:
946 @lilypond[quote,verbatim]
949 \line { William S. Gilbert }
951 \huge \smallCaps "The Mikado"
953 \smallCaps "The Town of Titipu"
955 \line { Sir Arthur Sullivan }
963 @cindex texto ajustado a palabras
964 @cindex texto justificado
965 @cindex justificado, texto
966 @cindex ajustado a palabras, texto
967 @cindex marcado, texto, ajustado a palabras
968 @cindex texto de marcado ajustado a palabras
969 @cindex ajuste de línea, texto con
977 Las indicaciones de texto largas se pueden también ajustar
978 automáticamente según un ancho de línea dado. Estarán alineados por
979 la izquierda o justificados, como se muestra en el ejemplo siguiente.
981 @lilypond[quote,verbatim]
984 \line \smallCaps { La vida breve }
985 \line \bold { Acto I }
987 (La escena representa el corral de una casa de
988 gitanos en el Albaicín de Granada. Al fondo una
989 puerta por la que se ve el negro interior de
990 una Fragua, iluminado por los rojos resplandores
995 \line \bold { Acto II }
996 \override #'(line-width . 50)
998 (Calle de Granada. Fachada de la casa de Carmela
999 y su hermano Manuel con grandes ventanas abiertas
1000 a través de las que se ve el patio
1001 donde se celebra una alegre fiesta)
1007 @cindex texto, instrucciones de alineación
1008 @cindex marcado, texto, instrucciones de alineación
1009 @cindex alineación, instrucciones de texto
1011 Hay una lista exhaustiva de instrucciones de alineación de texto en
1015 Manual de aprendizaje:
1016 @rlearning{Mover objetos}.
1018 Referencia de la notación:
1020 @ref{Indicaciones de texto}.
1023 @file{scm/define-markup-commands.scm}.
1025 Fragmentos de código:
1028 Referencia de funcionamiento interno:
1029 @rinternals{TextScript}.
1032 @node Notación gráfica dentro de elementos de marcado
1033 @unnumberedsubsubsec Notación gráfica dentro de elementos de marcado
1034 @translationof Graphic notation inside markup
1036 @cindex gráficos, insertar
1037 @cindex dibujar objetos gráficos
1038 @cindex gráficos, dibujar objetos
1039 @cindex insertar objetos gráficos
1040 @cindex gráficos, insertar objetos
1042 Se puede añadir diversos objetos gráficos a una partitura, utilizando
1043 instrucciones de marcado.
1045 @cindex enmarcar texto
1046 @cindex texto, enmarcar
1047 @cindex texto, decorar
1048 @cindex marcado, texto, decorar
1049 @cindex marcado, texto, enmarcar
1050 @cindex decorar texto
1056 @funindex \rounded-box
1057 @funindex rounded-box
1063 Ciertas instrucciones de marcado permiten la decoración de elementos
1064 de texto con gráficos, como se muestra en el ejemplo siguiente.
1066 @lilypond[quote,verbatim]
1067 \markup \fill-line {
1075 \bracket "1866 - 1925"
1078 \rounded-box \bold Prelude
1083 @cindex relleno alrededor de texto
1084 @cindex texto, relleno de
1085 @cindex marcado, relleno de textos de
1087 @funindex \pad-markup
1088 @funindex pad-markup
1091 @funindex \pad-to-box
1092 @funindex pad-to-box
1093 @funindex \pad-around
1094 @funindex pad-around
1096 Algunas instrucciones pueden requerir un aumento del relleno alrededor
1097 del texto: esto se puede conseguir con algunas instrucciones de
1098 marcado descritas exhaustivamente en @ref{Align}.
1100 @lilypond[quote,verbatim]
1101 \markup \fill-line {
1103 \box "Charles Ives (1874 - 1954)"
1105 \box \pad-markup #2 "THE UNANSWERED QUESTION"
1106 \box \pad-x #8 "A Cosmic Landscape"
1113 \box \pad-to-box #'(-5 . 20) #'(0 . 5)
1114 \bold "Largo to Presto"
1117 "String quartet keeps very even time,
1118 Flute quartet keeps very uneven time."
1122 @cindex gráfica, notación
1123 @cindex símbolos no musicales
1124 @cindex no musicales, símbolos
1125 @cindex notación gráfica
1129 @funindex \draw-circle
1130 @funindex draw-circle
1131 @funindex \filled-box
1132 @funindex filled-box
1135 @funindex \draw-line
1137 @funindex \arrow-head
1138 @funindex arrow-head
1140 Se pueden imprimir otros símbolos o elementos gráficos sin que se
1141 requiera ningún otro texto. De igual manera que en el caso de las
1142 expresiones de marcado, dichos objetos se pueden combinar:
1144 @lilypond[quote,verbatim]
1147 \draw-circle #4 #0.4 ##f
1148 \filled-box #'(-4 . 4) #'(-0.5 . 0.5) #1
1154 \draw-line #'(0 . 4)
1155 \arrow-head #Y #DOWN ##f
1160 @cindex insertar gráficos
1161 @cindex imágenes, insertar
1162 @cindex gráficos, insertar
1167 @funindex \postscript
1168 @funindex postscript
1170 Entre las funcionalidades gráficas avanzadas se encuentran la
1171 posibilidad de incluir archivos de imagen externos convertidos al
1172 formato de PostScript Encapsulado (@emph{eps}), y la inclusión directa
1173 de gráficos dentro del archivo de entrada, usando código PostScript
1174 nativo. En tal caso puede ser de utilidad la especificación explícita
1175 del tamaño del dibujo, como se ejemplifica a continuación:
1177 @lilypond[quote,verbatim,fragment]
1180 \epsfile #X #10 #"./context-example.eps"
1181 \with-dimensions #'(0 . 6) #'(0 . 10)
1197 Hay una lista exhaustiva de instrucciones específicas de gráficos en
1201 Referencia de la notación:
1203 @ref{Anotaciones editoriales}.
1206 @file{scm/define-markup-commands.scm},
1207 @file{scm/stencil.scm}.
1209 Fragmentos de código:
1212 Referencia de funcionamiento interno:
1213 @rinternals{TextScript}.
1216 @node Notación musical dentro de elementos de marcado
1217 @unnumberedsubsubsec Notación musical dentro de elementos de marcado
1218 @translationof Music notation inside markup
1220 @cindex notación dentro de marcado
1221 @cindex música dentro de marcado
1222 @cindex marcado, notación musical dentro de
1224 Se pueden añadir a la partitura diversos elementos de notación
1225 musical, dentro de un objeto de marcado.
1227 Las notas y las alteraciones se pueden escribir utilizando
1228 instrucciones de marcado:
1230 @lilypond[quote,verbatim,fragment]
1234 \note-by-number #1 #1 #1.5
1237 \natural \semiflat \flat
1238 \sesquiflat \doubleflat
1242 \natural \semisharp \sharp
1243 \sesquisharp \doublesharp
1248 Otros objetos de notación se pueden también imprimir en el modo de
1251 @lilypond[quote,verbatim]
1254 ees\finger \markup \tied-lyric #"4~1"
1255 fis_\markup { \dynamic rf }
1267 De forma más general, cualquier símbolo musical disponible se puede
1268 incluir por separado dentro de un objeto de marcado, como se
1269 ejemplifica a continuación; hay una lista exhaustiva de estos símbolos
1270 y sus nombres en @ref{La tipografía Feta}.
1272 @lilypond[quote,verbatim]
1275 c'^\markup { \musicglyph #"eight" }
1277 c,8._\markup { \musicglyph #"clefs.G_change" }
1279 c2^\markup { \musicglyph #"timesig.neomensural94" }
1283 Otra forma de imprimir glifos que no son de texto se encuentra
1284 descrita en @ref{Explicación de las fuentes tipográficas}. Tiene la
1285 utilidad de imprimir llaves de distintos tamaños.
1287 El modo de marcado también contempla diagramas para instrumentos
1290 @lilypond[quote,verbatim]
1293 \fret-diagram-terse #"x;x;o;2;3;2;"
1296 \harp-pedal #"^-v|--ov^"
1301 \musicglyph #"accordion.discant"
1303 \raise #0.5 \musicglyph #"accordion.dot"
1304 \raise #1.5 \musicglyph #"accordion.dot"
1309 @c The accordion diagram is actually taken from a snippet.
1312 Dichos diagramas se encuentran documentados en @ref{Instrument
1315 @cindex partitura dentro marcado
1316 @cindex marcado, partitura dentro de
1318 Incluso una partitura completa se puede incluir dentro de un objeto de
1319 marcado. En tal caso, el bloque anidado @code{\score} debe contener
1320 un bloque @code{\layout}, como se muestra aquí:
1322 @lilypond[quote,verbatim]
1326 \relative { c'4 d e f }
1335 Hay una lista exhaustiva de instrucciones relacionadas con la notación
1336 musical en @ref{Music}.
1339 Referencia de la notación:
1341 @ref{La tipografía Feta},
1342 @ref{Explicación de las fuentes tipográficas}.
1345 @file{scm/define-markup-commands.scm},
1346 @file{scm/fret-diagrams.scm},
1347 @file{scm/harp-pedals.scm}.
1349 Fragmentos de código:
1352 Referencia de funcionamiento interno:
1353 @rinternals{TextScript}.
1356 @node Elementos de marcado de varias páginas
1357 @unnumberedsubsubsec Elementos de marcado de varias páginas
1358 @translationof Multi-page markup
1360 @cindex páginas, marcado de varias
1361 @cindex marcado de varias páginas
1362 @cindex marcado, texto de, varias páginas
1363 @cindex texto que ocupa varias páginas
1365 @funindex \markuplist
1366 @funindex markuplist
1367 @funindex \justified-lines
1368 @funindex justified-lines
1369 @funindex \wordwrap-lines
1370 @funindex wordwrap-lines
1372 Aunque los objetos de marcado estándar no se pueden dividir, una
1373 sintaxis específica hace posible la introducción de líneas de texto
1374 que pueden abarcar varias páginas:
1377 @lilypond[quote,verbatim]
1380 Un texto muy largo de líneas justificadas.
1384 Otro párrafo muy largo.
1391 Esta sintaxis acepta una lista de elementos de marcado, que pueden ser
1394 el resultado de una instrucción de lista de marcado,
1396 una lista de marcados,
1398 o una lista de listas de marcado.
1401 Hay una lista exhaustiva de las instrucciones de lista de marcado en
1402 @ref{Text markup list commands}.
1405 Referencia de la notación:
1406 @ref{Text markup list commands}.
1409 @file{scm/define-markup-commands.scm}.
1411 Manual de extensión:
1412 @rextend{New markup list command definition}.
1414 Fragmentos de código:
1417 Referencia de funcionamiento interno:
1418 @rinternals{TextScript}.
1420 @funindex \markuplist
1421 @funindex markuplist
1429 @subsection Tipografías
1430 @translationof Fonts
1432 Esta sección presenta la forma en que se manejan las fuentes
1433 tipográficas, y cómo se pueden cambiar en las partituras.
1436 * Explicación de las fuentes tipográficas::
1437 * Fuentes de un solo elemento::
1438 * Fuentes tipográficas del documento completo::
1442 @node Explicación de las fuentes tipográficas
1443 @unnumberedsubsubsec Explicación de las fuentes tipográficas
1444 @translationof Fonts explained
1447 @cindex fuentes tipográficas, explicación
1448 @cindex llaves de distintos tamaños
1449 @cindex fuentes tipográficas, explicación
1450 @cindex llaves de varios tamaños
1451 @cindex fuentes tipográficas de símbolos en marcado
1452 @cindex símbolos, fuentes tipográficas en el marcado
1454 @funindex font-interface
1456 Las fuentes tipográficas se manejan a través de distintas bibliotecas.
1457 FontConfig se utiliza para detectar las tipografías disponibles en el
1458 sistema; las tipografías seleccionadas se trazan utilizando Pango.
1460 Las tipografías de notación musical se pueden describir como un
1461 conjunto de glifos específicos, ordenados en varias familias. La
1462 siguiente sintaxis permite usar directamente varias tipografías
1463 @code{feta} de LilyPond distintas a las de texto en el modo de
1466 @lilypond[quote,verbatim,fragment]
1469 \override #'(font-encoding . fetaBraces)
1471 \override #'(font-encoding . fetaText)
1473 \override #'(font-encoding . fetaMusic)
1474 \lookup #"noteheads.s0petrucci"
1480 Sin embargo, todos estos glifos excepto las llaves de varios tamaños
1481 que están contenidas en la fuente tipográfica @code{fetaBraces} están
1482 disponibles utilizando la sintaxis más sencilla que se describe en
1483 @ref{Notación musical dentro de elementos de marcado}.
1485 Cuando se usan los glifos de la fuente de llaves @code{fetaBraces}, el
1486 tamaño de la llave se especifica por la parte numérica del nombre del
1487 glifo, en unidades arbitrarias. Se puede especificar cualquier entero
1488 de @code{0} a @code{575} inclusive, siendo @code{0} el que produce la
1489 llave más pequeña. El valor óptimo se debe determinar por ensayo y
1490 error. Todos estos glifos son llaves izquierdas; las llaves derechas
1491 se pueden obtener mediante rotación, véase @ref{Rotación de objetos}.
1493 Están disponibles tres familias de tipografías de texto: la tipografía
1494 @emph{romana} (con serifa), que de forma predeterminada es New Century
1495 Schoolbook, la fuente @emph{sans} y la fuente monoespaciada
1496 @emph{de máquina de escribir}. Estas dos últimas familias vienen
1497 determinadas por la instalación de Pango.
1499 @warning{No existen fuentes tipográficas predeterminadas asociadas
1500 con las familias de fuente @emph{sans} y @emph{typewriter}. Un
1501 archivo de entrada que especifica alguna de éstas puede dar lugar
1502 a salidas diferentes en distintos sistemas. Para asegurar un
1503 resultado consistente entre distintas plataformas, se deben
1504 especificar las tipografías por su nombre, y dichas fuentes deben
1505 estar disponibles en cualquier sistema que vaya a procesar el
1506 documento. Véase @ref{Fuentes de un solo elemento} y
1507 @ref{Fuentes tipográficas del documento completo}.}
1509 Cada familia puede incluir distintas formas y series. El ejemplo
1510 siguiente muestra la posibilidad de seleccionar familias, formas,
1511 series y tamaños alternativos. El valor que se da a @code{font-size}
1512 es el cambio requerido a partir del tamaño predeterminado.
1514 @lilypond[quote,verbatim,fragment]
1515 \override Score.RehearsalMark.font-family = #'typewriter
1516 \mark \markup "Ouverture"
1517 \override Voice.TextScript.font-shape = #'italic
1518 \override Voice.TextScript.font-series = #'bold
1519 d''2.^\markup "Allegro"
1520 \override Voice.TextScript.font-size = #-3
1525 Se puede usar una sintaxis similar en el modo de marcado, aunque en
1526 este caso es preferible usar la sintaxis sencilla que se explica en
1527 @ref{Seleccionar la tipografía y su tamaño}:
1529 @lilypond[quote,verbatim]
1533 \override #'(font-shape . italic)
1534 \override #'(font-size . 4)
1538 \override #'(font-family . typewriter)
1540 \override #'(font-series . bold)
1544 \override #'(font-family . sans)
1551 Aunque es fácil cambiar entre las fuentes tipográficas
1552 preconfiguradas, también es posible usar otras fuentes, como se
1553 explica en las siguientes secciones: @ref{Fuentes de un solo elemento} y
1554 @ref{Fuentes tipográficas del documento completo}.
1557 Referencia de la notación:
1558 @ref{La tipografía Feta},
1559 @ref{Notación musical dentro de elementos de marcado},
1560 @ref{Rotación de objetos},
1561 @ref{Seleccionar la tipografía y su tamaño},
1565 @node Fuentes de un solo elemento
1566 @unnumberedsubsubsec Fuentes de un solo elemento
1567 @translationof Single entry fonts
1569 Se puede usar en una partitura cualquier fuente tipográfica que esté
1570 instalada en el sistema operativo y reconocida por parte de
1571 FontConfig, usando la siguiente sintaxis:
1573 @lilypond[quote,verbatim,fragment]
1574 \override Staff.TimeSignature.font-name = #"Bitstream Charter"
1575 \override Staff.TimeSignature.font-size = #2
1579 \override #'(font-name . "Bitstream Vera Sans,sans-serif, Oblique Bold")
1580 { Vera Oblique Bold }
1584 @cindex fuentes tipográficas, buscar, disponibles
1585 @cindex buscar fuentes tipográficas disponibles
1586 @cindex listar fuentes tipográficas disponibles
1587 @cindex disponibles, listar las fuentes tipográficas
1589 @funindex show-available-fonts
1591 La instrucción siguiente presenta una lista de todas las tipografías
1592 disponibles en el sistema operativo:
1595 lilypond -dshow-available-fonts x
1599 Referencia de la notación:
1600 @ref{Explicación de las fuentes tipográficas},
1601 @ref{Fuentes tipográficas del documento completo}.
1603 Fragmentos de código:
1606 @c A source file gets never installed...
1608 @c @file{lily/font-config-scheme.cc}.
1611 @node Fuentes tipográficas del documento completo
1612 @unnumberedsubsubsec Fuentes tipográficas del documento completo
1613 @translationof Entire document fonts
1615 Se pueden cambiar las fuentes tipográficas que se usan como
1616 tipografías predeterminadas en las familias @emph{romana},
1617 @emph{sans-serif} y @emph{monoespaciada}, especificándolas en este
1618 orden como se ve en el ejemplo de abajo, que escala las tipografías
1619 automáticamente con el valor fijado para el tamaño global del pentagrama.
1620 Para leer más explicaciones
1621 sobre las fuentes tipográficas, consulte @ref{Explicación de las fuentes tipográficas}.
1623 @cindex fuente, establecer la familia de
1624 @cindex fuentes tipográficas, cambiar para todo el documento
1626 @funindex make-pango-font-tree
1628 @lilypond[verbatim,quote]
1631 (make-pango-font-tree "Times New Roman"
1634 (/ staff-height pt 20)))
1641 \typewriter typewriter. }
1645 @c we don't do Helvetica / Courier, since GS incorrectly loads
1649 Referencia de la notación:
1650 @ref{Explicación de las fuentes tipográficas},
1651 @ref{Fuentes de un solo elemento},
1652 @ref{Seleccionar la tipografía y su tamaño},