1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
3 Translation of GIT committish: bfc3420ada8810d57156e9fc871560188f044a64
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
23 tratan 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
41 especiales (como los de idiomas distintos del inglés),
42 sencillamente inserte los caracteres directamente en el archivo de
43 LilyPond. El archivo se debe guardar como UTF-8. Para ver más
44 información, consulte @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
87 en cuenta: en el siguiente ejemplo, la primera cadena de texto no
88 afecta al espaciado, pero la segunda sí afecta.
90 @lilypond[quote,verbatim]
98 Se pueden adjuntar articulaciones a las notas, además de
99 inscripciones de texto. Para ver más información, consulte
100 @ref{Articulaciones y ornamentos}.
102 Para ver más información sobre el orden relativo de las
103 inscripciones de texto y las articulaciones, consulte
104 @rlearning{Colocación de los objetos}.
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
139 texto y la letra de las canciones se mantienen dentro de los
140 márgenes, requiere cálculos adicionales. En caso de que desee un
141 proceso 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
156 muchos compases mediante líneas de puntos. Estos objetos, que
157 reciben el nombre de @q{spanners} u objetos de extensión, se
158 pueden crear desde una nota hasta otra usando la siguiente
161 @lilypond[verbatim,quote]
163 \override TextSpanner.bound-details.left.text = "rit."
169 @cindex texto, formateado de los elementos de extensión
170 @cindex formato de los elementos de extensión de texto
173 La cadena de texto que imprimir se establece a través de
174 propiedades de objeto. De forma predeterminada se imprime en
175 estilo cursiva, pero se pueden conseguir distintos efectos de
176 formato utilizando bloques @code{\markup}, como se describe en
177 @ref{Formatear el texto}.
179 @lilypond[quote,verbatim]
181 \override TextSpanner.bound-details.left.text =
182 \markup { \upright "rit." }
188 El estilo de la línea, así como la cadena de texto, se pueden
189 definir como una propiedad de objeto. Esta sintaxis se describe
190 en @ref{Estilos de línea}.
192 @funindex \textSpannerUp
193 @funindex textSpannerUp
194 @funindex \textSpannerDown
195 @funindex textSpannerDown
196 @funindex \textSpannerNeutral
197 @funindex textSpannerNeutral
201 @code{\textSpannerUp},
202 @code{\textSpannerDown},
203 @code{\textSpannerNeutral}.
207 LilyPond sólo puede manejar un objeto de extensión de texto por
211 @lilypondfile[verbatim,quote,texidoc,doctitle]
212 {dynamics-text-spanner-postfix.ly}
214 @lilypondfile[verbatim,quote,texidoc,doctitle]
215 {dynamics-custom-text-spanner-postfix.ly}
218 Referencia de la notación:
219 @ref{Estilos de línea},
220 @ref{Matices dinámicos},
221 @ref{Formatear el texto}.
223 Fragmentos de código:
225 @rlsr{Expressive marks}.
227 Referencia de funcionamiento interno:
228 @rinternals{TextSpanner}.
231 @node Indicaciones de texto
232 @unnumberedsubsubsec Indicaciones de texto
233 @translationof Text marks
235 @cindex texto, indicaciones de
236 @cindex indicaciones de texto
237 @cindex texto sobre la barra de compás
238 @cindex coda sobre la línea divisoria
239 @cindex segno sobre la línea divisoria
240 @cindex calderón sobre la línea divisoria
241 @cindex líneas divisorias, símbolos sobre las
248 Se pueden añadir a la partitura varios elementos de texto con la
249 sintaxis que se describe en @ref{Llamadas de ensayo}:
251 @c \mark needs to be placed on a separate line (it's not
252 @c attached to an object like \markup is). -vv
254 @lilypond[verbatim,quote]
265 Esta sintaxis posibilita colocar cualquier texto sobre la línea
266 divisoria; se pueden incorporar formatos más complejos para el
267 texto usando un bloque @code{\markup}, como está explicado en
268 @ref{Formatear el texto}:
270 @lilypond[quote,verbatim]
273 \mark \markup { \italic { colla parte } }
280 Esta sintaxis también permite imprimir símbolos especiales como
281 llamadas, segno o calderones, especificando el nombre del símbolo
282 correspondiente como se explica en
283 @ref{Notación musical dentro de elementos de marcado}:
285 @lilypond[quote,verbatim]
288 \mark \markup { \musicglyph #"scripts.ufermata" }
294 Estos objetos se tipografían solamente sobre el pentagrama
295 superior de la partitura; dependiendo de si están especificados al
296 final o en medio de un compás, se colocarán sobre la línea
297 divisoria o entre las notas. Si se especifican en un salto de
298 línea, las llamadas se imprimen al principio de la línea
301 @lilypond[quote,verbatim,ragged-right]
310 @funindex \markLengthOn
311 @funindex markLengthOn
312 @funindex \markLengthOff
313 @funindex markLengthOff
316 @code{\markLengthOn},
317 @code{\markLengthOff}.
322 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
323 {printing-marks-at-the-end-of-a-line.ly}
325 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
326 {printing-marks-on-every-staff.ly}
329 Referencia de la notación:
330 @ref{Llamadas de ensayo},
331 @ref{Formatear el texto},
332 @ref{Notación musical dentro de elementos de marcado},
333 @ref{La tipografía Feta}.
335 Fragmentos de código:
338 Referencia de funcionamiento interno:
339 @rinternals{MarkEvent},
340 @rinternals{Mark_engraver},
341 @rinternals{RehearsalMark}.
345 @unnumberedsubsubsec Texto separado
346 @translationof Separate text
348 @cindex separado, texto
349 @cindex texto separado
350 @cindex independiente, texto
351 @cindex nivel superior, texto del
352 @cindex texto del nivel superior
353 @cindex texto independiente
358 Un bloque @code{\markup} puede existir de forma independiente,
359 fuera de cualquier bloque @code{\score}, como una @qq{expresión de
360 nivel superior}. Esta sintaxis se describe en
361 @ref{Estructura del archivo}.
363 @lilypond[verbatim,quote]
365 Tomorrow, and tomorrow, and tomorrow...
370 Esto hace posible imprimir texto separado de la música, lo que es
371 especialmente útil cuando el archivo de entrada contiene varias
372 piezas, tal y como se describe en
373 @ref{Varias partituras en un libro}.
375 @lilypond[quote,verbatim]
380 Tomorrow, and tomorrow, and tomorrow...
387 Los bloques de texto independientes pueden abarcar varias páginas,
388 posibilitando la impresión de documentos de texto o libros
389 íntegramente desde LilyPond. Esta funcionalidad y la sintaxis que
390 requiere se describen en
391 @ref{Elementos de marcado de varias páginas}.
396 @funindex \markuplist
406 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
407 {stand-alone-two-column-markup.ly}
410 Referencia de la notación:
411 @ref{Formatear el texto},
412 @ref{Estructura del archivo},
413 @ref{Varias partituras en un libro},
414 @ref{Elementos de marcado de varias páginas}.
416 Fragmentos de código:
419 Referencia de funcionamiento interno:
420 @rinternals{TextScript}.
423 @node Formatear el texto
424 @subsection Formatear el texto
425 @translationof Formatting text
427 Esta sección presenta los formateados básico y avanzado de texto,
428 usando la sintaxis específica del modo de @code{\markup}.
431 * Introducción al marcado de texto::
432 * Seleccionar la tipografía y su tamaño::
433 * Alineación de texto::
434 * Notación gráfica dentro de elementos de marcado::
435 * Notación musical dentro de elementos de marcado::
436 * Elementos de marcado de varias páginas::
439 @node Introducción al marcado de texto
440 @unnumberedsubsubsec Introducción al marcado de texto
441 @translationof Text markup introduction
444 @cindex texto, marcado de
445 @cindex marcado de texto
446 @cindex tipografiar texto
451 Se usa un bloque @code{\markup} para tipografiar texto con una
452 sintaxis ampliable que se denomina @qq{modo de marcado}.
454 @cindex marcado, expresiones de
455 @cindex expresiones de marcado
456 @cindex marcado, sintaxis
457 @cindex sintaxis del marcado
459 La sintaxis del marcado es similar a la sintaxis usual de
460 LilyPond: una expresión @code{\markup} se encierra entre llaves
461 @code{@{ @dots{} @}}. Una sola palabra se considera como una
462 expresión mínima, y por tanto no necesita estar encerrada entre
465 A diferencia de las indicaciones de @qq{texto entrecomillado}
466 simples, los bloques @code{\markup} pueden contener expresiones
467 anidadas o instrucciones de marcado, que se introducen utilizando
468 el carácter de barra invertida @code{\} . Estas instrucciones sólo
469 afectan a la expresión que sigue inmediatamente.
471 @lilypond[quote,verbatim]
474 a2^\markup { poco \italic più forte }
476 d2_\markup { \italic "string. assai" }
478 b1^\markup { \bold { molto \italic agitato } }
483 @cindex caracteres especiales en modo de marcado
484 @cindex marcado, caracteres especiales en modo de
485 @cindex reservados, impresión de caracteres
486 @cindex impresión de caracteres especiales
487 @cindex texto entrecomillado en modo de marcado
489 Un bloque @code{\markup} puede contener también cadenas de texto
490 entre comillas. Dichas cadenas se tratan como expresiones de
491 texto mínimas, y por tanto cualquier instrucción de marcado o
492 carácter especial (como @code{\} y@tie{}@code{#}) se imprimen
493 literalmente sin afectar al formateo del texto. Se puede hacer
494 que se impriman las propias comillas si se les antepone una barra
497 @lilypond[quote,verbatim]
499 a'1^"\italic markup..."
500 a_\markup { \italic "... prints \"italic\" letters!" }
505 Para que se traten como una expresión distinta, es necesario que
506 las listas de palabras estén encerradas entre comillas o
507 precedidas de una instrucción. La forma en que están definidas
508 las expresiones de marcado afecta a cómo se apilan, se centran y
509 se alinean estas expresiones; en el ejemplo siguiente, la segunda
510 expresión @code{\markup} se trata igual que la primera:
512 @lilypond[quote,verbatim]
514 c1^\markup { \center-column { a bbb c } }
515 c1^\markup { \center-column { a { bbb c } } }
516 c1^\markup { \center-column { a \line { bbb c } } }
517 c1^\markup { \center-column { a "bbb c" } }
521 Los marcados se pueden almacenar dentro de variables. Estas
522 variables se pueden adjuntar directamente a las notas:
524 @lilypond[quote,verbatim]
525 allegro = \markup { \bold \large Allegro }
535 Se puede encontrar una lista exhaustiva de las instrucciones
536 específicas de @code{\markup} en @ref{Text markup commands}.
539 Referencia de la notación:
540 @ref{Text markup commands}.
542 Fragmentos de código:
546 @file{scm/markup.scm}.
549 Los errores de sintaxis para el modo de marcado a menudo producen
553 @node Seleccionar la tipografía y su tamaño
554 @unnumberedsubsubsec Seleccionar la tipografía y su tamaño
555 @translationof Selecting font and font size
557 @cindex fuente tipográfica, cambiar
558 @cindex cambio de la fuente tipográfica
567 Está contemplado de forma básica el cambio de la fuente
568 tipográfica en el modo de marcado:
570 @lilypond[quote,verbatim]
574 \italic { non troppo \underline Vivo }
577 d,_\markup { \italic quasi \smallCaps Tromba }
582 @cindex fuente tipográfica, tamaño de
583 @cindex texto, tamaño de
585 @funindex \abs-fontsize
595 El tamaño de la fuente tipográfica se puede alterar en relación al
596 tamaño global del pentagrama, de una serie de formas como se ve a
599 Se puede fijar a un tamaño predefinido,
601 @lilypond[quote,verbatim]
603 b1_\markup { \huge Sinfonia }
604 b1^\markup { \teeny da }
605 b1-\markup { \normalsize camera }
609 Se puede establecer a un tamaño relativo al valor anterior,
611 @lilypond[quote,verbatim]
613 b1_\markup { \larger Sinfonia }
614 b1^\markup { \smaller da }
615 b1-\markup { \magnify #0.6 camera }
619 Se puede aumentar o disminuir de forma relativa al valor fijado
620 por el tamaño global del pentagrama,
622 @lilypond[quote,verbatim]
624 b1_\markup { \fontsize #-2 Sinfonia }
625 b1^\markup { \fontsize #1 da }
626 b1-\markup { \fontsize #3 camera }
630 También se puede establecer a un tamaño de puntos fijo,
631 independientemente del tamaño global del pentagrama,
633 @lilypond[quote,verbatim]
635 b1_\markup { \abs-fontsize #20 Sinfonia }
636 b1^\markup { \abs-fontsize #8 da }
637 b1-\markup { \abs-fontsize #14 camera }
641 Si el texto incluye espacios, es mejor escribir todo entre
642 comillas, de forma que el tamaño de cada espacio sea correcto para
643 el tamaño de los otros caracteres.
645 @lilypond[quote,verbatim]
646 \markup \fontsize #6 \bold { Sinfonia da camera }
647 \markup \fontsize #6 \bold { "Sinfonia da camera" }
657 @funindex \normal-size-super
658 @funindex normal-size-super
660 El texto se puede imprimir como subíndice o como superíndice. De
661 forma predeterminada se imprimen en un tamaño menor, pero también
662 se puede usar un tamaño normal:
664 @lilypond[quote,verbatim]
667 \line { 1 \super st movement }
668 \line { 1 \normal-size-super st movement
669 \sub { (part two) } }
674 @cindex fuente tipográfica, familias de
676 El modo de marcado ofrece una manera fácil de elegir familias de
677 tipografía alternativas. A no ser que se especifique de otro
678 modo, se selecciona automáticamente la fuente predeterminada con
679 serifa, de tipo romano: en la última línea del ejemplo siguiente,
680 no hay diferencia entre la primera y la segunda palabra.
682 @lilypond[quote,verbatim]
685 \line { Act \number 1 }
686 \line { \sans { Scene I. } }
687 \line { \typewriter { Verona. An open place. } }
688 \line { Enter \roman Valentine and Proteus. }
694 Algunas de estas familias, usadas para elementos específicos como
695 números o matices, no ofrecen todos los caracteres, como se explica en
696 @ref{Indicaciones dinámicas contemporáneas} y
697 @ref{Marcas de repetición manual}.
699 @c \concat is actually documented in Align (it is not
700 @c a font-switching command). But we need it here. -vv
702 Si se usan dentro de una palabra, algunas instrucciones de cambio
703 de tipografía o de formateo pueden producir un espacio vacío no
704 deseado. Esto se puede solucionar concatenando en uno solo los
705 distintos elementos de texto:
707 @lilypond[quote,verbatim]
711 \concat { 1 \super st }
715 \concat { \dynamic p , }
716 \italic { con dolce espressione }
722 Se puede encontrar una lista exhaustiva de instrucciones de cambio
723 y utilización personalizada de las fuentes tipográficas en
726 También es posible definir conjuntos personalizados de fuentes,
727 tal y como se explica en @ref{Tipografías}.
735 @funindex \normalsize
759 Referencia de la notación:
761 @ref{Indicaciones dinámicas contemporáneas},
762 @ref{Marcas de repetición manual},
766 @file{scm/define-markup-commands.scm}.
768 Fragmentos de código:
771 Referencia de funcionamiento interno:
772 @rinternals{TextScript}.
775 La utilización de las instrucciones de tamaño de texto
776 @code{\teeny}, @code{\tiny}, @code{\small}, @code{\normalsize},
777 @code{\large} y @code{\huge} conducen a un espaciado de las líneas
778 inconsistente comparado con el uso de @code{\fontsize}.
781 @node Alineación de texto
782 @unnumberedsubsubsec Alineación de texto
783 @translationof Text alignment
785 @cindex texto, alineación de
786 @cindex alinear texto
787 @cindex alinear texto de marcado
788 @cindex alinear elementos de marcado
789 @cindex marcado, elementos, alinear
790 @cindex marcado, texto, alinear
792 Esta subsección trata sobre cómo colocar texto en el modo de
793 marcado. Los objetos de marcado también se pueden mover como un
794 todo, usando la sintaxis que se describe en
795 @rlearning{Mover objetos}.
797 @c Padding commands should be mentioned on this page, but
798 @c most of these require \box to be more clearly illustrated. -vv
800 @cindex texto, alineación horizontal
801 @cindex horizontal, alineación de texto
803 @funindex \left-align
805 @funindex \center-align
806 @funindex center-align
807 @funindex \right-align
808 @funindex right-align
810 Los objetos de marcado se pueden alinear de distintas maneras. De
811 forma predeterminada, una indicación de texto se alinea sobre el
812 borde izquierdo: en el ejemplo siguiente, no existe diferencia
813 entre los marcados primero y segundo.
815 @lilypond[quote,verbatim]
817 d''1-\markup { poco }
819 d-\markup { \left-align poco }
821 d-\markup { \center-align { poco } }
823 d-\markup { \right-align poco }
830 Se puede realizar un ajuste fino de la alineación horizontal usando un
833 @lilypond[quote,verbatim]
835 a'1-\markup { \halign #-1 poco }
837 a,-\markup { \halign #0 poco }
839 a,-\markup { \halign #0.5 poco }
841 a,-\markup { \halign #2 poco }
846 Ciertos objetos pueden poseer sus propios procedimientos de
847 alineación, y por tanto no resultan afectados por estas
848 instrucciones. Es posible mover estos objetos de marcado como un
849 todo, como se muestra por ejemplo en @ref{Indicaciones de texto}.
851 @cindex texto, alineación vertical
852 @cindex vertical, alineación de texto
861 La alineación vertical es un poco más compleja. Como se ha dicho
862 más arriba, los objetos de marcado se pueden mover como un todo;
863 sin embargo, también es posible mover elementos específicos dentro
864 de un bloque de marcado. En este caso, el elemento a mover se
865 debe preceder de un @emph{punto de anclaje}, que puede ser otro
866 elemento de marcado o un objeto invisible. El ejemplo siguiente
867 ejemplifica estas dos posibilidades; el último marcado en este
868 ejemplo no tiene punto de anclaje y por ello no resulta movido.
870 @lilypond[quote,verbatim]
874 \raise #2 { Scène 1 }
879 \lower #4 \bold { Très modéré }
883 \raise #4 \italic { Une forêt. }
889 @funindex \general-align
890 @funindex general-align
893 @funindex \translate-scaled
894 @funindex translate-scaled
896 Algunas instrucciones pueden afectar tanto a la alineación
897 horizontal como a la vertical de los objetos de texto en el modo
898 de marcado. Cualquier objeto afectado por estas instrucciones se
899 deben preceder de un punto de anclaje:
901 @lilypond[quote,verbatim]
905 \translate #'(-1 . 2) "Scène 1"
910 \general-align #Y #3.2 \bold "Très modéré"
915 \translate-scaled #'(-1 . 2) \teeny "Une forêt."
921 @cindex varias líneas, marcado
922 @cindex marcado de varias líneas
923 @cindex varias líneas, texto
924 @cindex texto de varias líneas
925 @cindex texto en columnas
926 @cindex columnas, texto
930 @funindex \center-column
931 @funindex center-column
933 Un objeto de marcado puede incluir varias líneas de texto. En el
934 ejemplo siguiente, cada elemento o expresión se sitúa en su propia
935 línea, ya sea alineada por la izquierda o centrada:
937 @lilypond[quote,verbatim]
953 @cindex centrar texto en la página
954 @cindex texto, centrar en la página
955 @cindex marcado, centrar en la página
960 De forma similar, una lista de elementos o expresiones se puede
961 repartir de forma que rellene por completo el ancho de la línea
962 horizontal (si hay un solo elemento, se centra en el papel). A su
963 vez, estas expresiones pueden incluir texto de varias líneas o
964 cualquier otra expresión de marcado:
966 @lilypond[quote,verbatim]
969 \line { William S. Gilbert }
971 \huge \smallCaps "The Mikado"
973 \smallCaps "The Town of Titipu"
975 \line { Sir Arthur Sullivan }
983 @cindex texto ajustado a palabras
984 @cindex texto justificado
985 @cindex justificado, texto
986 @cindex ajustado a palabras, texto
987 @cindex marcado, texto, ajustado a palabras
988 @cindex texto de marcado ajustado a palabras
989 @cindex ajuste de línea, texto con
997 Las indicaciones de texto largas se pueden también ajustar
998 automáticamente según un ancho de línea dado. Estarán alineados
999 por la izquierda o justificados, como se muestra en el ejemplo
1002 @lilypond[quote,verbatim]
1005 \line \smallCaps { La vida breve }
1006 \line \bold { Acto I }
1008 (La escena representa el corral de una casa de
1009 gitanos en el Albaicín de Granada. Al fondo una
1010 puerta por la que se ve el negro interior de
1011 una Fragua, iluminado por los rojos resplandores
1016 \line \bold { Acto II }
1017 \override #'(line-width . 50)
1019 (Calle de Granada. Fachada de la casa de Carmela
1020 y su hermano Manuel con grandes ventanas abiertas
1021 a través de las que se ve el patio
1022 donde se celebra una alegre fiesta)
1028 @cindex texto, instrucciones de alineación
1029 @cindex marcado, texto, instrucciones de alineación
1030 @cindex alineación, instrucciones de texto
1032 Hay una lista exhaustiva de instrucciones de alineación de texto
1036 Manual de aprendizaje:
1037 @rlearning{Mover objetos}.
1039 Referencia de la notación:
1041 @ref{Indicaciones de texto}.
1044 @file{scm/define-markup-commands.scm}.
1046 Fragmentos de código:
1049 Referencia de funcionamiento interno:
1050 @rinternals{TextScript}.
1053 @node Notación gráfica dentro de elementos de marcado
1054 @unnumberedsubsubsec Notación gráfica dentro de elementos de marcado
1055 @translationof Graphic notation inside markup
1057 @cindex gráficos, insertar
1058 @cindex dibujar objetos gráficos
1059 @cindex gráficos, dibujar objetos
1060 @cindex insertar objetos gráficos
1061 @cindex gráficos, insertar objetos
1063 Se puede añadir diversos objetos gráficos a una partitura,
1064 utilizando instrucciones de marcado.
1066 @cindex enmarcar texto
1067 @cindex texto, enmarcar
1068 @cindex texto, decorar
1069 @cindex marcado, texto, decorar
1070 @cindex marcado, texto, enmarcar
1071 @cindex decorar texto
1077 @funindex \rounded-box
1078 @funindex rounded-box
1084 Ciertas instrucciones de marcado permiten la decoración de
1085 elementos de texto con gráficos, como se muestra en el ejemplo
1088 @lilypond[quote,verbatim]
1089 \markup \fill-line {
1097 \bracket "1866 - 1925"
1100 \rounded-box \bold Prelude
1105 @cindex relleno alrededor de texto
1106 @cindex texto, relleno de
1107 @cindex marcado, relleno de textos de
1109 @funindex \pad-markup
1110 @funindex pad-markup
1113 @funindex \pad-to-box
1114 @funindex pad-to-box
1115 @funindex \pad-around
1116 @funindex pad-around
1118 Algunas instrucciones pueden requerir un aumento del relleno
1119 alrededor del texto: esto se puede conseguir con algunas
1120 instrucciones de marcado descritas exhaustivamente en @ref{Align}.
1122 @lilypond[quote,verbatim]
1123 \markup \fill-line {
1125 \box "Charles Ives (1874 - 1954)"
1127 \box \pad-markup #2 "THE UNANSWERED QUESTION"
1128 \box \pad-x #8 "A Cosmic Landscape"
1135 \box \pad-to-box #'(-5 . 20) #'(0 . 5)
1136 \bold "Largo to Presto"
1139 "String quartet keeps very even time,
1140 Flute quartet keeps very uneven time."
1144 @cindex gráfica, notación
1145 @cindex símbolos no musicales
1146 @cindex no musicales, símbolos
1147 @cindex notación gráfica
1151 @funindex \draw-circle
1152 @funindex draw-circle
1153 @funindex \filled-box
1154 @funindex filled-box
1157 @funindex \draw-line
1159 @funindex \arrow-head
1160 @funindex arrow-head
1162 Se pueden imprimir otros símbolos o elementos gráficos sin que se
1163 requiera ningún otro texto. De igual manera que en el caso de las
1164 expresiones de marcado, dichos objetos se pueden combinar:
1166 @lilypond[quote,verbatim]
1169 \draw-circle #4 #0.4 ##f
1170 \filled-box #'(-4 . 4) #'(-0.5 . 0.5) #1
1176 \draw-line #'(0 . 4)
1177 \arrow-head #Y #DOWN ##f
1182 @cindex insertar gráficos
1183 @cindex imágenes, insertar
1184 @cindex gráficos, insertar
1189 @funindex \postscript
1190 @funindex postscript
1192 Entre las funcionalidades gráficas avanzadas se encuentran la
1193 posibilidad de incluir archivos de imagen externos convertidos al
1194 formato de PostScript Encapsulado (@emph{eps}), y la inclusión
1195 directa de gráficos dentro del archivo de entrada, usando código
1196 PostScript nativo. En tal caso puede ser de utilidad la
1197 especificación explícita del tamaño del dibujo, como se
1198 ejemplifica a continuación:
1200 @lilypond[quote,verbatim,fragment]
1203 \epsfile #X #10 #"./context-example.eps"
1204 \with-dimensions #'(0 . 6) #'(0 . 10)
1220 Hay una lista exhaustiva de instrucciones específicas de gráficos
1224 Referencia de la notación:
1227 @ref{Anotaciones editoriales},
1231 @file{scm/define-markup-commands.scm},
1232 @file{scm/stencil.scm}.
1234 Fragmentos de código:
1237 Referencia de funcionamiento interno:
1238 @rinternals{TextScript}.
1241 @node Notación musical dentro de elementos de marcado
1242 @unnumberedsubsubsec Notación musical dentro de elementos de marcado
1243 @translationof Music notation inside markup
1245 @cindex notación dentro de marcado
1246 @cindex música dentro de marcado
1247 @cindex marcado, notación musical dentro de
1249 Se pueden añadir a la partitura diversos elementos de notación
1250 musical, dentro de un objeto de marcado.
1252 Las notas y las alteraciones se pueden escribir utilizando
1253 instrucciones de marcado:
1255 @lilypond[quote,verbatim,fragment]
1259 \note-by-number #1 #1 #1.5
1262 \natural \semiflat \flat
1263 \sesquiflat \doubleflat
1267 \natural \semisharp \sharp
1268 \sesquisharp \doublesharp
1273 Otros objetos de notación se pueden también imprimir en el modo de
1276 @lilypond[quote,verbatim]
1279 ees\finger \markup \tied-lyric #"4~1"
1280 fis_\markup { \dynamic rf }
1292 De forma más general, cualquier símbolo musical disponible se
1293 puede incluir por separado dentro de un objeto de marcado, como se
1294 ejemplifica a continuación; hay una lista exhaustiva de estos
1295 símbolos y sus nombres en @ref{La tipografía Feta}.
1297 @lilypond[quote,verbatim]
1300 c'^\markup { \musicglyph #"eight" }
1302 c,8._\markup { \musicglyph #"clefs.G_change" }
1304 c2^\markup { \musicglyph #"timesig.neomensural94" }
1308 Otra forma de imprimir glifos que no son de texto se encuentra
1309 descrita en @ref{Explicación de las fuentes tipográficas}. Tiene
1310 la utilidad de imprimir llaves de distintos tamaños.
1312 El modo de marcado también contempla diagramas para instrumentos
1315 @lilypond[quote,verbatim]
1318 \fret-diagram-terse #"x;x;o;2;3;2;"
1321 \harp-pedal #"^-v|--ov^"
1326 \musicglyph #"accordion.discant"
1328 \raise #0.5 \musicglyph #"accordion.dot"
1329 \raise #1.5 \musicglyph #"accordion.dot"
1334 @c The accordion diagram is actually taken from a snippet.
1337 Dichos diagramas se encuentran documentados en @ref{Instrument
1340 @cindex partitura dentro marcado
1341 @cindex marcado, partitura dentro de
1343 Incluso una partitura completa se puede incluir dentro de un
1344 objeto de marcado. En tal caso, el bloque anidado @code{\score}
1345 debe contener un bloque @code{\layout}, como se muestra aquí:
1347 @lilypond[quote,verbatim]
1351 \relative { c'4 d e f }
1360 Hay una lista exhaustiva de instrucciones relacionadas con la
1361 notación musical en @ref{Music}.
1364 Referencia de la notación:
1366 @ref{La tipografía Feta},
1367 @ref{Explicación de las fuentes tipográficas}.
1370 @file{scm/define-markup-commands.scm},
1371 @file{scm/fret-diagrams.scm},
1372 @file{scm/harp-pedals.scm}.
1374 Fragmentos de código:
1377 Referencia de funcionamiento interno:
1378 @rinternals{TextScript}.
1381 @node Elementos de marcado de varias páginas
1382 @unnumberedsubsubsec Elementos de marcado de varias páginas
1383 @translationof Multi-page markup
1385 @cindex páginas, marcado de varias
1386 @cindex marcado de varias páginas
1387 @cindex marcado, texto de, varias páginas
1388 @cindex texto que ocupa varias páginas
1390 @funindex \markuplist
1391 @funindex markuplist
1392 @funindex \justified-lines
1393 @funindex justified-lines
1394 @funindex \wordwrap-lines
1395 @funindex wordwrap-lines
1397 Aunque los objetos de marcado estándar no se pueden dividir, una
1398 sintaxis específica hace posible la introducción de líneas de
1399 texto que pueden abarcar varias páginas:
1402 @lilypond[quote,verbatim]
1405 Un texto muy largo de líneas justificadas.
1409 Otro párrafo muy largo.
1416 Esta sintaxis acepta una lista de elementos de marcado, que pueden ser
1419 el resultado de una instrucción de lista de marcado,
1421 una lista de marcados,
1423 o una lista de listas de marcado.
1426 Hay una lista exhaustiva de las instrucciones de lista de marcado
1427 en @ref{Instrucciones de listas de marcado de texto}.
1430 Referencia de la notación:
1431 @ref{Instrucciones de listas de marcado de texto}.
1434 @file{scm/define-markup-commands.scm}.
1436 Manual de extensión:
1437 @rextend{Definición de nuevas instrucciones de lista de marcado}.
1439 Fragmentos de código:
1442 Referencia de funcionamiento interno:
1443 @rinternals{TextScript}.
1445 @funindex \markuplist
1446 @funindex markuplist
1454 @subsection Tipografías
1455 @translationof Fonts
1457 Esta sección presenta la forma en que se manejan las fuentes
1458 tipográficas, y cómo se pueden cambiar en las partituras.
1461 * Explicación de las fuentes tipográficas::
1462 * Fuentes de un solo elemento::
1463 * Fuentes tipográficas del documento completo::
1467 @node Explicación de las fuentes tipográficas
1468 @unnumberedsubsubsec Explicación de las fuentes tipográficas
1469 @translationof Fonts explained
1472 @cindex fuentes tipográficas, explicación
1473 @cindex llaves de distintos tamaños
1474 @cindex fuentes tipográficas, explicación
1475 @cindex llaves de varios tamaños
1476 @cindex fuentes tipográficas de símbolos en marcado
1477 @cindex símbolos, fuentes tipográficas en el marcado
1479 @funindex font-interface
1481 Las fuentes tipográficas se manejan a través de distintas
1482 bibliotecas. FontConfig se utiliza para detectar las tipografías
1483 disponibles en el sistema; las tipografías seleccionadas se trazan
1486 Las tipografías de notación musical se pueden describir como un
1487 conjunto de glifos específicos, ordenados en varias familias. La
1488 siguiente sintaxis permite usar directamente varias tipografías
1489 @code{feta} de LilyPond distintas a las de texto en el modo de
1492 @lilypond[quote,verbatim,fragment]
1495 \override #'(font-encoding . fetaBraces)
1497 \override #'(font-encoding . fetaText)
1499 \override #'(font-encoding . fetaMusic)
1500 \lookup #"noteheads.s0petrucci"
1506 Sin embargo, todos estos glifos excepto las llaves de varios
1507 tamaños que están contenidas en la fuente tipográfica
1508 @code{fetaBraces} están disponibles utilizando la sintaxis más
1509 sencilla que se describe en
1510 @ref{Notación musical dentro de elementos de marcado}.
1512 Cuando se usan los glifos de la fuente de llaves
1513 @code{fetaBraces}, el tamaño de la llave se especifica por la
1514 parte numérica del nombre del glifo, en unidades arbitrarias. Se
1515 puede especificar cualquier entero de @code{0} a @code{575}
1516 inclusive, siendo @code{0} el que produce la llave más pequeña.
1517 El valor óptimo se debe determinar por ensayo y error. Todos
1518 estos glifos son llaves izquierdas; las llaves derechas se pueden
1519 obtener mediante rotación, véase @ref{Rotación de objetos}.
1521 Están disponibles tres familias de fuentes tipográficas para el
1525 La fuente @emph{roman} (serif), que de forma predeterminada es
1526 LilyPond Serif (un alias de TeX Gyre Schola).
1528 La fuente @emph{sans}, que de forma predeterminada es LilyPond
1529 Sans Serif (un alias de TeX Gyre Heros).
1531 La fuente @emph{typewriter} mecanográfica (monoespaciada), que de
1532 forma predeterminada es LilyPond Monospace (un alias de TeX Gyre
1536 Cada familia puede incluir distintas formas y series. El ejemplo
1537 siguiente muestra la posibilidad de seleccionar familias, formas,
1538 series y tamaños alternativos. El valor que se da a
1539 @code{font-size} es el cambio requerido a partir del tamaño
1542 @lilypond[quote,verbatim,fragment]
1543 \override Score.RehearsalMark.font-family = #'typewriter
1544 \mark \markup "Ouverture"
1545 \override Voice.TextScript.font-shape = #'italic
1546 \override Voice.TextScript.font-series = #'bold
1547 d''2.^\markup "Allegro"
1548 \override Voice.TextScript.font-size = #-3
1553 Se puede usar una sintaxis similar en el modo de marcado, aunque
1554 en este caso es preferible usar la sintaxis sencilla que se
1555 explica en @ref{Seleccionar la tipografía y su tamaño}:
1557 @lilypond[quote,verbatim]
1561 \override #'(font-shape . italic)
1562 \override #'(font-size . 4)
1566 \override #'(font-family . typewriter)
1568 \override #'(font-series . bold)
1572 \override #'(font-family . sans)
1579 Aunque es fácil cambiar entre las fuentes tipográficas
1580 preconfiguradas, también es posible usar otras fuentes, como se
1581 explica en las siguientes secciones:
1582 @ref{Fuentes de un solo elemento} y
1583 @ref{Fuentes tipográficas del documento completo}.
1586 Referencia de la notación:
1587 @ref{La tipografía Feta},
1588 @ref{Notación musical dentro de elementos de marcado},
1589 @ref{Rotación de objetos},
1590 @ref{Seleccionar la tipografía y su tamaño},
1594 @node Fuentes de un solo elemento
1595 @unnumberedsubsubsec Fuentes de un solo elemento
1596 @translationof Single entry fonts
1598 Se puede usar en una partitura cualquier fuente tipográfica que
1599 esté instalada en el sistema operativo y reconocida por parte de
1600 FontConfig, usando la siguiente sintaxis:
1602 @lilypond[quote,verbatim,fragment]
1603 \override Staff.TimeSignature.font-name = #"Bitstream Charter"
1604 \override Staff.TimeSignature.font-size = #2
1608 \override #'(font-name . "Bitstream Vera Sans,sans-serif, Oblique Bold")
1609 { Vera Oblique Bold }
1613 @cindex fuentes tipográficas, buscar, disponibles
1614 @cindex buscar fuentes tipográficas disponibles
1615 @cindex listar fuentes tipográficas disponibles
1616 @cindex disponibles, listar las fuentes tipográficas
1618 @var{font-name} puede describirse usando una lista de @q{fuentes
1619 tipográfcias} separadas por comas y una lista de @q{estilos}
1620 separados por espacios. En la medida en que la @q{fuente
1621 tipográfica} de la lista esté instalada y contenga el glifo
1622 solicitado, se usará. En caso contrario, se usará como
1623 sustitución la @emph{siguiente} fuente tipográfica de la lista.
1625 @funindex show-available-fonts
1627 La ejecución de lilypond con la opción siguiente presenta una
1628 lista de todas las tipografías disponibles en el sistema
1632 lilypond -dshow-available-fonts x
1636 Referencia de la notación:
1637 @ref{Explicación de las fuentes tipográficas},
1638 @ref{Fuentes tipográficas del documento completo}.
1640 Fragmentos de código:
1643 @c A source file gets never installed...
1645 @c @file{lily/font-config-scheme.cc}.
1648 @node Fuentes tipográficas del documento completo
1649 @unnumberedsubsubsec Fuentes tipográficas del documento completo
1650 @translationof Entire document fonts
1652 Se pueden cambiar las fuentes tipográficas que se usan como
1653 tipografías predeterminadas en las familias @emph{romana},
1654 @emph{sans-serif} y @emph{monoespaciada}, especificándolas en este
1655 orden como se ve en el ejemplo de abajo, que escala las
1656 tipografías automáticamente con el valor fijado para el tamaño
1657 global del pentagrama. De forma parecida a
1658 @ref{Fuentes de un solo elemento}, se puede describir usando una
1659 lista de @q{fuentes tipográficas} separadas por comas. Sin
1660 embargo, los @q{estilos} de fuente no se pueden describir. Para
1661 leer más explicaciones sobre las fuentes tipográficas, consulte
1662 @ref{Explicación de las fuentes tipográficas}.
1664 @cindex fuente, establecer la familia de
1665 @cindex fuentes tipográficas, cambiar para todo el documento
1667 @funindex make-pango-font-tree
1669 @lilypond[verbatim,quote]
1672 (make-pango-font-tree "Times New Roman"
1673 "Nimbus Sans,Nimbus Sans L"
1675 (/ staff-height pt 20)))
1682 \typewriter typewriter. }
1686 @c we don't do Helvetica / Courier, since GS incorrectly loads
1690 Referencia de la notación:
1691 @ref{Explicación de las fuentes tipográficas},
1692 @ref{Fuentes de un solo elemento},
1693 @ref{Seleccionar la tipografía y su tamaño},