1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
3 Translation of GIT committish: 0646758d26f727fc27fc13a87df2362388909e5d
5 When revising a translation, copy the HEAD committish of the
6 version that you are working on. See TRANSLATION for details.
14 @lilypondfile[quote]{text-headword.ly}
16 Esta sección explica cómo incluir texto (con diversos estilos de
17 formateo) en las partituras.
20 Ciertos elementos de texto de los que no nos ocupamos aquí se tratan
21 en otras secciones específicas: @ref{Vocal music}, @ref{Titles and
30 @cindex texto, en otros idiomas
31 @warning{Para escribir texto con caracteres acentuados y especiales
32 (como los de idiomas distintos del inglés), sencillamente inserte los
33 caracteres directamente en el archivo de LilyPond. El archivo se debe
34 guardar como UTF-8. Para ver más información, consulte @ref{Text
38 @subsection Writing text
40 Esta sección presenta las distintas formas de añadir texto a una
52 @unnumberedsubsubsec Text scripts
54 @cindex Texto, inscripciones de
55 @cindex texto, elementos no vacíos de
56 @cindex no vacíos, textos
57 @cindex texto destacado
59 Es posible añadir indicaciones de @qq{texto entrecomillado} a una
60 partitura, como se muestra en el ejemplo siguiente. Tales
61 indicaciones se pueden colocar también manulamente encima o debajo del
62 pentagrama utilizando la sintaxis que se describe en @ref{Direction
65 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
66 d8^"pizz." e f g a4-"scherz." f
69 Esta sintaxis es en realidad una abreviatura; se puede añadir
70 explícitamente a una nota un formateado de texto más complejo
71 utilizando un bloque @code{\markup}, como se describe bajo
72 @ref{Formatting text}.
74 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
75 d8^\markup { \italic pizz. } e f g
76 a4_\markup { \tiny scherz. \bold molto } f
79 De forma predeterminada, las indicaciones de texto no afectan al
80 espaciado de las notas. Sin embargo, su anchura sí podría tenerse en
81 cuenta: en el siguiente ejemplo, la primera cadena de texto no afecta
82 al espaciado, pero la segunda sí afecta.
84 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
92 @funindex \textLengthOn
94 @funindex \textLengthOff
95 @code{\textLengthOff}.
101 Referencia de la notación:
102 @ref{Formatting text},
103 @ref{Direction and placement}.
105 Fragmentos de código:
108 Referencia de funcionamiento interno:
109 @rinternals{TextScript}.
113 La comprobación necesaria para asegurar que las inscripciones de texto
114 y la letra de las canciones se mantienen dentro de los márgenes, es
115 una tarea computacional relativamente grande. Para acelerar el
116 procesado, LilyPond no realiza estos cálculos de forma predeterminada;
117 para habilitarlos, utilice
120 \override Score.PaperColumn #'keep-inside-line = ##t
125 @unnumberedsubsubsec Text spanners
127 @cindex text spanners
129 Ciertas indicaciones de ejecución, p.ej., @i{rallentando} o
130 @i{accelerando}, se escriben como texto y se extienden sobre muchos
131 compases mediante líneas de puntos. Estos objetos, que reciben el
132 nombre de @q{spanners} u objetos de extensión, se pueden crear dede
133 una nota hasta otra usando la siguiente sintaxis:
135 @lilypond[verbatim,quote,ragged-right,fragment,relative=2]
136 \override TextSpanner #'(bound-details left text) = "rit."
142 La cadena de texto que imprimir se establece a través de propiedades
143 de objeto. De forma predeterminada se imprime en estilo cursiva, pero
144 se pueden conseguir distintos efectos de formato utilizando bloques
145 @code{\markup}, como se describe en @ref{Formatting text}.
147 @lilypond[quote,ragged-right,fragment,relative=2,verbatim]
148 \override TextSpanner #'(bound-details left text) =
149 \markup { \upright "rit." }
154 El estilo de la línea, así como la cadena de texto, se pueden definir
155 como una propiedad de objeto. Esta sintaxis se describe en @ref{Line
160 @funindex textSpannerUp
161 @code{\textSpannerUp},
162 @funindex textSpannerDown
163 @code{\textSpannerDown},
164 @funindex textSpannerNeutral
165 @code{\textSpannerNeutral}.
171 Referencia de la notación:
175 Fragmentos de código:
178 Referencia de funcionamiento interno:
179 @rinternals{TextSpanner}.
183 @unnumberedsubsubsec Text marks
185 @cindex coda sobre la línea divisoria
186 @cindex segno sobre la línea divisoria
187 @cindex calderón sobre la línea divisoria
188 @cindex líneas divisorias, símbolos sobre las
191 Se pueden añadir a la partitura varios elementos de texto con la
192 sintaxis que se describe en @ref{Rehearsal marks}:
194 @c \mark needs to be placed on a separate line (it's not
195 @c attached to an object like \markup is). -vv
197 @lilypond[verbatim,quote,ragged-right,fragment,relative=2]
203 Esta sintaxis posibilita colocar cualquier texto sobre la línea
204 divisoria; se pueden incorporar formatos más complejos para el texto
205 usando un bloque @code{\markup}, como está explicado en
206 @ref{Formatting text}:
208 @lilypond[fragment,quote,ragged-right,verbatim,relative=1]
210 \mark \markup { \italic { colla parte } }
216 Esta sintaxis también permite imprimir símbolos especiales como
217 llamadas, segno o calderones, especificando el nombre del símbolo
218 correspondiente como se esplica en @ref{Music notation inside markup}:
220 @lilypond[fragment,quote,ragged-right,verbatim,relative=1]
222 \mark \markup { \musicglyph #"scripts.ufermata" }
227 Estos objetos se tipografían solamente sobre el pentagrama superior de
228 la partitura; dependiendo de si están especificados al final o en
229 medio de un compás, se colocarán sobre la línea divisoria o entre las
230 notas. Si se especifican en un salto de línea, las llamadas se
231 imprimen al principio de la línea siguiente.
233 @lilypond[fragment,quote,ragged-right,verbatim,relative=2]
243 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
244 {printing-marks-at-the-end-of-a-line-or-a-score.ly}
246 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
247 {aligning-marks-with-various-notation-objects.ly}
249 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
250 {printing-marks-on-every-staff.ly}
254 Referencia de la notación:
255 @ref{Rehearsal marks},
256 @ref{Formatting text},
257 @ref{Music notation inside markup},
260 Fragmentos de código:
263 Referencia de funcionamiento interno:
264 @rinternals{RehearsalMark}.
267 @c To be removed when Issue 69 in the tracker gets fixed. -vv
269 Si se introduce una llamada al final del último compás de la partitura
270 (donde no hay línea siguiente), la llamada no se imprime en absoluto.
273 @unnumberedsubsubsec Separate text
275 @cindex separate text
276 @cindex standalone text
277 @cindex top-level text
278 @cindex text, standalone
280 @funindex \markuplines
282 Un bloque @code{\markup} puede existir de forma independiente, fuera
283 de cualquier bloque @code{\score}, como una @qq{expresión de nivel
284 superior}. Esta sintaxis se describe en @ref{File structure}.
286 @lilypond[verbatim,quote]
288 Tomorrow, and tomorrow, and tomorrow...
293 Esto hace posible imprimir texto separado de la música, lo que es
294 especialmente útil cuando el archivo de entrada contiene varias
295 piezas, tal y como se describe en @ref{Multiple scores in a book}.
297 @lilypond[quote,ragged-right,verbatim]
302 Tomorrow, and tomorrow, and tomorrow...
309 Los bloques de texto independientes pueden abarcar varias páginas,
310 posibilitando la impresión de documentos de texto o libros
311 íntegramente desde LilyPond. Esta funcionalidad y la sintaxis que
312 requiere se describen en @ref{Multi-page markup}.
324 TODO: add convenient snippets in input/new -vv
329 Referencia de la notación:
330 @ref{Formatting text},
331 @ref{File structure},
332 @ref{Multiple scores in a book},
333 @ref{Multi-page markup}.
335 Fragmentos de código:
338 Referencia de funcionamiento interno:
339 @rinternals{TextScript}.
342 @node Formatting text
343 @subsection Formatting text
345 Esta sección presenta los formateados básico y avanzado de texto,
346 usando la sintaxis específica del modo de @code{\markup}.
349 * Text markup introduction::
350 * Selecting font and font size::
352 * Graphic notation inside markup::
353 * Music notation inside markup::
354 * Multi-page markup::
357 @node Text markup introduction
358 @unnumberedsubsubsec Text markup introduction
361 @cindex texto, marcado de
362 @cindex marcado de texto
363 @cindex tipografiar texto
366 Se usa un bloque @code{\markup} para tipografiar texto con una
367 sintaxis ampliable que se denomina @qq{modo de marcado}.
369 @cindex marcado, expresiones de
370 @cindex marcado, sintaxis
372 La sintaxis del marcado es similar a la sintaxis usual de LilyPond:
373 una expresión @code{\markup} se encierra entre llaves @code{@{ @dots{}
374 @}}. Una sola palabra se considera como una expresión mínima, y por
375 tanto no necesita estar encerrada entre llaves.
377 A diferencia de las indicaciones de @qq{texto entrecomillado} simples,
378 los bloques @code{\markup} pueden contener expresiones anidadas o
379 instrucciones de marcado, que se introducen utilizando el carácter de
380 barra invertida @code{\} . Estas instrucciones sólo afectan a la
381 expresión que sigue inmediatamente.
383 @lilypond[quote,verbatim,fragment,relative=1]
385 a2^\markup { poco \italic più forte }
387 d2_\markup { \italic "string. assai" }
389 b1^\markup { \bold { molto \italic agitato } }
393 @cindex caracteres especiales en modo de marcado
394 @cindex marcado, caracteres especiales en modo de
395 @cindex reservados, impresión de caracteres
396 @cindex impresión de caracteres especiales
397 @cindex texto entrecomillado en modo de marcado
399 Un bloque @code{\markup} puede contener también cadenas de texto entre
400 comillas. Dichas cadenas se tratan como expresiones de texto mínimas,
401 y por tanto cualquier instrucción de marcado o carácter especial (como
402 @code{\} y @code{#}) se imprimen literalmente sin afectar al formateo
403 del texto. Se puede hacer que se impriman las propias comillas si se
404 les antepone una barra invertida.
406 @lilypond[quote,verbatim,fragment,relative=1]
407 d1^"\italic markup..."
408 d_\markup { \italic "... prints \"italic\" letters!" }
412 Para que se traten como una expresión distinta, es necesario que las
413 listas de palabras estén encerradas entre comillas o precedidas de una
414 instrucción. La forma en que están definidas las expresiones de
415 marcado afecta a cómo se apilan, se centran y se alinean estas
416 expresiones; en el ejemplo siguiente, la segunda expresión
417 @code{\markup} se trata igual que la primera:
419 @lilypond[quote,verbatim,fragment,relative=1]
420 c1^\markup { \center-column { a bbb c } }
421 c1^\markup { \center-column { a { bbb c } } }
422 c1^\markup { \center-column { a \line { bbb c } } }
423 c1^\markup { \center-column { a "bbb c" } }
426 Los marcados se pueden almacenar dentro de variables. Estas variables
427 se pueden adjuntar directamente a las notas:
429 @lilypond[quote,verbatim]
430 allegro = \markup { \bold \large Allegro }
440 Se puede encontrar una lista exhaustiva de las instrucciones
441 específicas de @code{\markup} en @ref{Text markup commands}.
446 Referencia de la notación:
447 @ref{Text markup commands}.
449 Fragmentos de código:
453 @file{scm/@/markup@/.scm}.
458 Los errores de sintaxis para el modo de marcado a menudo producen
462 @node Selecting font and font size
463 @unnumberedsubsubsec Selecting font and font size
465 @cindex fuente tipográfica, cambiar
470 Está contemplado de forma básica el cambio de la fuente tipográfica en
473 @lilypond[quote,verbatim,relative=2]
476 \italic { non troppo \underline Vivo }
479 d,_\markup { \italic quasi \smallCaps Tromba }
484 @cindex fuente tipográfica, tamaño de
485 @cindex texto, tamaño de
491 El tamaño de los caracteres también se puede alterar de distintas
496 el tamaño de la tipografía se puede definir a una serie de tamaños
497 estándar predefinidos,
500 el tamaño de la tipografía se puede establecer a un valor absoluto,
503 el tamaño de la tipografía también se puede cambiar de forma relativa
504 respecto de su valor anterior.
508 El ejemplo siguiente ejemplifica estos tres métodos:
510 @lilypond[quote,verbatim,relative=1]
517 \fontsize #5 Sinfonia
524 \magnify #0.6 { e sentimento } )
534 El texto se puede imprimir como subíndice o como superíndice. De
535 forma predeterminada se imprimen en un tamaño menor, pero también se
536 puede usar un tamaño normal:
538 @lilypond[quote,verbatim]
541 \line { 1 \super st movement }
542 \line { 1 \normal-size-super st movement
543 \sub { (part two) } }
548 @cindex fuente tipográfica, familias de
550 El modo de marcado ofrece una manera fácil de elegir familias de
551 tipografía alternativas. A no ser que se especifique de otro modo, se
552 selecciona automáticamente la fuente predeterminada con serifa, de
553 tipo romano: en la última línea del ejemplo siguiente, no hay
554 diferencia entre la primera y la segunda palabra.
556 @lilypond[quote,verbatim]
559 \line { Act \number 1 }
560 \line { \sans { Scene I. } }
561 \line { \typewriter { Verona. An open place. } }
562 \line { Enter \roman Valentine and Proteus. }
568 Algunas de estas familias, usadas para elementos específicos como
569 números o matices, no ofrecen todos los caracteres, como se explica en
570 @ref{New dynamic marks} y @ref{Manual repeat marks}.
572 @c \concat is actually documented in Align (it is not
573 @c a font-switching command). But we need it here. -vv
575 Si se usan dentro de una palabra, algunas instrucciones de cambio de
576 tipografía o de formateo pueden producir un espacio vacío no deseado.
577 Esto se puede solucionar concatenando en uno solo los distintos
580 @lilypond[quote,verbatim]
584 \concat { 1 \super st }
588 \concat { \dynamic p , }
589 \italic { con dolce espressione }
595 Se puede encontrar una lista exhaustiva de instrucciones de cambio y
596 utilización personalizada de las fuentes tipográficas en @ref{Font}.
598 También es posible definir conjuntos personalizados de fuentes, tal y
599 como se explica en @ref{Fonts}.
609 @funindex \normalsize
624 Referencia de la notación:
626 @ref{New dynamic marks},
627 @ref{Manual repeat marks},
630 Fragmentos de código:
633 Referencia de funcionamiento interno:
634 @rinternals{TextScript}.
637 @file{scm/@/define@/-markup@/-commands@/.scm}.
641 @unnumberedsubsubsec Text alignment
643 @cindex texto alineación de
644 @cindex alinear texto
646 Esta subsección trata sobre cómo colocar texto en el modo de marcado.
647 Los objetos de marcado también se pueden mover como un todo, usando la
648 sintaxis que se describe en @rlearning{Moving objects}.
650 @c Padding commands should be mentioned on this page, but
651 @c most of these require \box to be more clearly illustrated. -vv
653 @cindex texto, alineación horizontal
654 @cindex horizontal, alineación de texto
655 @funindex \left-align
656 @funindex \center-align
657 @funindex \right-align
659 Los objetos de marcado se pueden alinear de distintas maneras. De
660 foma predeterminada, una indicación de texto se alinea sobre el borde
661 izquierdo: en el ejemplo siguiente, no existe diferencia entre los
662 marcados primero y segundo.
664 @lilypond[quote,verbatim,fragment,relative=1]
667 d-\markup { \left-align poco }
669 d-\markup { \center-align { poco } }
671 d-\markup { \right-align poco }
676 Se puede realizar un ajuste fino de la alineación horizontal usando un
679 @lilypond[quote,verbatim,fragment,relative=1]
680 a1-\markup { \halign #-1 poco }
682 a,-\markup { \halign #0 poco }
684 a,-\markup { \halign #0.5 poco }
686 a,-\markup { \halign #2 poco }
690 Ciertos objetos pueden poseer sus propios procedimientos de
691 alineación, y por tanto no resultan afectados por estas instrucciones.
692 Es posible mover estos objetos de marcado como un todo, como se
693 muestra por ejemplo en @ref{Text marks}.
695 @cindex texto, alineación vertical
696 @cindex vertical, alineación de texto
700 La alineación vertical es un poco más compleja. Como se ha dicho más
701 arriba, los objetos de marcado se pueden mover como un todo; sin
702 embargo, también es posible mover elementos específicos dentro de un
703 bloque de marcado. En este caso, el elemento a mover se debe preceder
704 de un @emph{punto de anclaje}, que puede ser otro elemento de marcado
705 o un objeto invisible. El ejemplo siguiente ejemplifica estas dos
706 posibilidades; el último marcado en este ejemplo no tiene punto de
707 anclaje y por ello no resulta movido.
709 @lilypond[quote,verbatim,fragment,relative=1]
712 \raise #2 { Scène 1 }
717 \lower #4 \bold { Très modéré }
721 \raise #4 \italic { Une forêt. }
726 @funindex \general-align
728 @funindex \translate-scaled
730 Algunas instrucciones pueden afcetar tanto a la alineación horizontal
731 como a la vertical de los objetos de texto en el modo de marcado.
732 Cualquier objeto afectado por estas instrucciones se deben preceder de
735 @lilypond[quote,verbatim,fragment,relative=1]
738 \translate #'(-1 . 2) "Scène 1"
743 \general-align #Y #3.2 \bold "Très modéré"
748 \translate-scaled #'(-1 . 2) \teeny "Une forêt."
754 @funindex \center-column
756 @cindex varias líneas, marcado de
757 @cindex texto de varias líneas
758 @cindex columnas, texto en
760 Un objeto de marcado puede incluir varias líneas de texto. En el
761 ejemplo siguiente, cada elemento o expresión se sitúa en su propia
762 línea, ya sea alineada por la izquierda o centrada:
764 @lilypond[quote,verbatim]
782 @cindex centrar texto en la página
784 De forma similar, una lista de elementos o expresiones se puede
785 repartir de forma que rellene por completo el ancho de la línea
786 horizontal (si hay un solo elemento, se centra en el papel). A su
787 vez, estas expresiones pueden incluir texto de varias líneas o
788 cualquier otra expresión de marcado:
790 @lilypond[quote,verbatim]
793 \line { William S. Gilbert }
795 \huge \smallCaps "The Mikado"
797 \smallCaps "The Town of Titipu"
799 \line { Sir Arthur Sullivan }
810 @cindex ajuste de línea, texto con
811 @cindex justificado, texto
813 Las indicaciones de texto largas se pueden también ajustar
814 automáticamente según un ancho de línea dado. Estarán alineados por
815 la izquierda o justificados, como se muestra en el ejemplo siguiente.
817 @lilypond[quote,verbatim]
820 \line \smallCaps { La vida breve }
821 \line \bold { Acto I }
823 (La escena representa el corral de una casa de
824 gitanos en el Albaicín de Granada. Al fondo una
825 puerta por la que se ve el negro interior de
826 una Fragua, iluminado por los rojos resplandores
831 \line \bold { Acto II }
832 \override #'(line-width . 50)
834 (Calle de Granada. Fachada de la casa de Carmela
835 y su hermano Manuel con grandes ventanas abiertas
836 a través de las que se ve el patio
837 donde se celebra una alegre fiesta)
843 Hay una lista exhaustiva de instrucciones de alineación de texto en
848 Manual de aprendizaje:
849 @rlearning{Moving objects}.
851 Referencia de la notación:
855 Fragmentos de código:
858 Referencia de funcionamiento interno:
859 @rinternals{TextScript}.
862 @file{scm/@/define@/-markup@/-commands@/.scm}.
865 @node Graphic notation inside markup
866 @unnumberedsubsubsec Graphic notation inside markup
868 @cindex gráficos, insertar
869 @cindex dibujar objetos gráficos
871 Se puede añadir diversos objetos gráficos a una partitura, utilizando
872 instrucciones de marcado.
876 @funindex \rounded-box
880 @cindex decorar texto
881 @cindex enmarcar texto
883 Ciertas instrucciones de marcado permiten la decoración de elementos
884 de texto con gráficos, como se muestra en el ejemplo siguiente.
886 @lilypond[quote,verbatim]
895 \bracket "1866 - 1925"
898 \rounded-box \bold Prelude
903 @funindex \pad-markup
905 @funindex \pad-to-box
906 @funindex \pad-around
908 @cindex relleno alrededor del texto
909 @cindex texto, relleno de
911 Algunas instrucciones pueden requerir un aumento del relleno alrededor
912 del texto: esto se puede conseguir con algunas instrucciones de
913 marcado descritas exhaustivamente en @ref{Align}.
915 @lilypond[quote,verbatim]
918 \box "Charles Ives (1874 - 1954)"
920 \box \pad-markup #2 "THE UNANSWERED QUESTION"
921 \box \pad-x #8 "A Cosmic Landscape"
928 \box \pad-to-box #'(-5 . 20) #'(0 . 5)
929 \bold "Largo to Presto"
932 "String quartet keeps very even time,
933 Flute quartet keeps very uneven time."
938 @funindex \draw-circle
939 @funindex \filled-box
942 @funindex \arrow-head
944 @cindex gráfica, notación
945 @cindex símbolos no musicales
947 Se pueden imprimir otros símbolos o elementos gráficos sin que se
948 requiera ningún otro texto. De igual manera que en el caso de las
949 expresiones de marcado, dichos objetos se pueden combinar:
951 @lilypond[quote,verbatim]
954 \draw-circle #4 #0.4 ##f
955 \filled-box #'(-4 . 4) #'(-0.5 . 0.5) #1
962 \arrow-head #Y #DOWN ##f
968 @funindex \postscript
970 @cindex insertar gráficos
971 @cindex imágenes, insertar
972 @cindex gráficos, insertar
975 Entre las funcionalidades gráficas avanzadas se encuentran la
976 posibilidad de incluir archivos de imagen externos convertidos al
977 formato de PostScript Encapsulado (@emph{eps}), y la inclusión directa
978 de gráficos dentro del archivo de entrada, usando código PostScript
979 nativo. En tal caso puede ser de utilidad la especificación explícita
980 del tamaño del dibujo, como se ejemplifica a continuación:
982 @lilypond[quote,verbatim,fragment,relative=1]
985 \epsfile #X #10 #"./context-example.eps"
986 \with-dimensions #'(0 . 6) #'(0 . 10)
1002 Hay una lista exhaustiva de instrucciones específicas de gráficos en
1007 Referencia de la notación:
1009 @ref{Editorial annotations}.
1011 Fragmentos de código:
1014 Referencia de funcionamiento interno:
1015 @rinternals{TextScript}.
1018 @file{scm/@/define@/-markup@/-commands@/.scm},
1019 @file{scm/@/stencil@/.scm}.
1022 @node Music notation inside markup
1023 @unnumberedsubsubsec Music notation inside markup
1025 Se pueden añadir a la partitura diversos elementos de notación
1026 musical, dentro de un objeto de marcado.
1028 Las notas y las alteraciones se pueden escribir utilizando
1029 instrucciones de marcado:
1031 @lilypond[quote,verbatim,fragment,relative=2]
1035 \note-by-number #1 #1 #1.5
1038 \natural \semiflat \flat
1039 \sesquiflat \doubleflat
1043 \natural \semisharp \sharp
1044 \sesquisharp \doublesharp
1049 Otros objetos de notación se pueden también imprimir en el modo de
1052 @lilypond[quote,verbatim,fragment,relative=1]
1059 fis_\markup { \dynamic rf }
1070 De forma más general, cualquier símbolo musical disponible se puede
1071 incluir por separado dentro de un objeto de marcado, como se
1072 ejemplifica a continuación; hay una lista exhaustiva de estos símbolos
1073 y sus nombres en @ref{The Feta font}.
1075 @lilypond[quote,verbatim,fragment,relative=2]
1077 c'^\markup { \musicglyph #"eight" }
1079 c,8._\markup { \musicglyph #"clefs.G_change" }
1081 c2^\markup { \musicglyph #"timesig.neomensural94" }
1083 @c TODO: add \lookup here? -vv
1086 Otra forma de imprimir glifos que no son de texto se encuentra
1087 descrita en @ref{Fonts explained}.
1089 El modo de marcado también contempla diagramas para instrumentos
1092 @lilypond[quote,verbatim,fragment,relative=2]
1094 \fret-diagram-terse #"x;x;o;2;3;2;"
1097 \harp-pedal #"^-v|--ov^"
1102 \musicglyph #"accordion.accDiscant"
1104 \raise #0.5 \musicglyph #"accordion.accDot"
1105 \raise #1.5 \musicglyph #"accordion.accDot"
1109 @c The accordion diagram is actually taken from a snippet.
1112 Dichos diagramas se encuentran documentados es @ref{Instrument
1115 Incluso una partitura completa se puede incluir dentro de un objeto de
1116 marcado. En tal caso, el bloque anidado @code{\score} debe contener
1117 un bloque @code{\layout}, como se muestra aquí:
1119 @lilypond[quote,verbatim,fragment,relative=1]
1122 \relative { c4 d e f }
1130 Hay una lista exhaustiva de instrucciones relacionadas con la notación
1131 musical en @ref{Music}.
1135 Referencia de la notación:
1137 @ref{The Feta font},
1138 @ref{Fonts explained}.
1140 Fragmentos de código:
1143 Referencia de funcionamiento interno:
1144 @rinternals{TextScript}.
1147 @file{scm/@/define@/-markup@/-commands@/.scm},
1148 @file{scm/@/fret@/-diagrams@/.scm},
1149 @file{scm/@/harp@/-pedals@/.scm}.
1152 @node Multi-page markup
1153 @unnumberedsubsubsec Multi-page markup
1155 Aunque los objetos de marcado estándar no se pueden dividir, una
1156 sintaxis específica hace posible la introducción de líneas de texto
1157 que pueden abarcar varias páginas:
1160 @lilypond[quote,verbatim]
1163 Un texto muy largo de líneas justificadas.
1167 Otro párrafo muy largo.
1174 Esta sintaxis acepta una lista de elementos de marcado, que pueden ser
1177 el resultado de una instrucción de lista de marcado,
1179 una lista de marcados,
1181 o una lista de listas de marcado.
1184 Hay una lista exhaustiva de las instrucciones de lista de marcado en
1185 @ref{Text markup list commands}.
1189 Referencia de la notación:
1190 @ref{Text markup list commands},
1191 @ref{New markup list command definition}.
1193 Fragmentos de código:
1196 Referencia de funcionamiento interno:
1197 @rinternals{TextScript}.
1200 @file{scm/@/define@/-markup@/-commands@/.scm}.
1204 @funindex \markuplines
1205 @code{\markuplines}.
1212 Esta sección presenta la forma en que se manejan las fuentes
1213 tipográficas, y cómo se pueden cambiar en las partituras.
1217 * Single entry fonts::
1218 * Entire document fonts::
1222 @node Fonts explained
1223 @unnumberedsubsubsec Fonts explained
1226 @cindex fuentes tipográficas, explicación
1227 @funindex font-interface
1229 Las fuentes tipográficas se manejan a través de distintas bibliotecas.
1230 FontConfig se utiliza para detectar las tipografías disponibles en el
1231 sistema; las tipografías seleccionadas se trazan utilizando Pango.
1233 Las tipografías de notación musical se pueden describir como un
1234 conjunto de glifos específicos, ordenados en varias familias. La
1235 siguiente sintaxis permite usar directamente varias tipografías
1236 @code{feta} de LilyPond distintas a las de texto en el modo de
1239 @lilypond[quote,verbatim,fragment,relative=2]
1242 \override #'(font-encoding . fetaBraces)
1244 \override #'(font-encoding . fetaNumber)
1246 \override #'(font-encoding . fetaDynamic)
1248 \override #'(font-encoding . fetaMusic)
1249 \lookup #"noteheads.s0petrucci"
1255 Una sintaxis más simple pero más limitada se describe en @ref{Music
1256 notation inside markup}.
1258 Están disponibles tres familias de tipografías de texto: la tipografía
1259 @emph{romana} (con serifa), que de forma predeterminada es New Century
1260 Schoolbook, la fuente @emph{sans} y la fuente monoespaciada @emph{de
1261 máquina de escribir}. Estas dos últimas familias vienen determinadas
1262 por la instalación de Pango.
1264 Cada familia puede incluir distintas formas y series. El ejemplo
1265 siguiente muestra la posibilidad de seleccionar familias, formas,
1266 series y tamaños alternativos:
1268 @lilypond[quote,verbatim,fragment,relative=2]
1269 \override Score.RehearsalMark #'font-family = #'typewriter
1270 \mark \markup "Ouverture"
1272 \override Voice.TextScript #'font-shape = #'italic
1273 \override Voice.TextScript #'font-series = #'bold
1274 d'2.^\markup "Allegro"
1279 Se puede usar una sintaxis similar en el modo de marcado, aunque en
1280 este caso es preferible usar la sintaxis sencilla que se explica en
1281 @ref{Selecting font and font size}:
1283 @lilypond[quote,verbatim]
1287 \override #'(font-shape . italic)
1288 \override #'(font-size . 4)
1292 \override #'(font-family . typewriter)
1294 \override #'(font-series . bold)
1298 \override #'(font-family . sans)
1306 @c FIXME: This needs an example -vv
1308 The size of the font may be set with the @code{font-size}
1309 property. The resulting size is taken relative to the
1310 @code{text-font-size} as defined in the @code{\paper} block.
1315 Referencia de la notación:
1316 @ref{The Feta font},
1317 @ref{Music notation inside markup},
1318 @ref{Selecting font and font size},
1322 @node Single entry fonts
1323 @unnumberedsubsubsec Single entry fonts
1325 Se puede usar en una partitura cualquier fuente tipográfica que esté
1326 instalada en el sistema operativo y reconocida por parte de
1327 FontConfig, usando la siguiente sintaxis:
1329 @lilypond[quote,verbatim,fragment,relative=1]
1330 \override Staff.TimeSignature #'font-name = #"Charter"
1331 \override Staff.TimeSignature #'font-size = #2
1335 \override #'(font-name . "Vera Bold")
1340 @funindex show-available-fonts
1342 La instrucción siguiente presenta una lista de todas las tipografías
1343 disponibles en el sistema operativo:
1346 lilypond -dshow-available-fonts x
1350 El último argumento de la instrucción puede ser cualquiera, pero debe
1355 Referencia de la notación:
1356 @ref{Fonts explained},
1357 @ref{Entire document fonts}.
1359 Fragmentos de código:
1363 @file{lily/@/font@/-config@/-scheme@/.cc}.
1365 @node Entire document fonts
1366 @unnumberedsubsubsec Entire document fonts
1368 Se puede cambiar la familia predeterminada de la fuente tipográfica
1369 para todo el documento. En este caso se debe usar la siguiente
1370 sintaxis, proporcionando tres familias de fuente que se usarán
1371 respectivamente como tipografías @emph{romana}, @emph{sans-serif} y
1372 @emph{monoespaciada}, como se explica en @ref{Fonts explained}.
1374 @cindex fuente, establecer la familia de
1375 @funindex make-pango-font-tree
1377 @lilypond[verbatim,quote]
1381 (make-pango-font-tree "Times New Roman"
1384 (/ myStaffSize 20)))
1391 \typewriter typewriter. }
1395 @c we don't do Helvetica / Courier, since GS incorrectly loads
1400 Referencia de la notación:
1401 @ref{Fonts explained},
1402 @ref{Single entry fonts},
1403 @ref{Selecting font and font size},