1 @c -*- coding: utf-8; mode: texinfo; -*-
3 Translation of GIT committish: 130ce199aa0cedce7779abf9bc131ef96368f9b8
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..
12 @c Translators: Federico Bruni
13 @c Translation checkers:
19 @lilypondfile[quote]{text-headword.ly}
21 Questa sezione spiega come includere del testo (con vari tipi di
22 formattazione) nelle partiture musicali.
25 Alcuni elementi testuali che non sono trattati qui sono discussi in altre
26 sezioni specifiche: @ref{Vocal music}, @ref{Titles and headers}.
29 * Inserimento del testo::
30 * Formattazione del testo::
34 @node Inserimento del testo
35 @subsection Inserimento del testo
36 @translationof Writing text
38 Questa sezione presenta vari modi di aggiungere del testo a una partitura.
40 @cindex testo, altre lingue
41 @warning{Per scrivere caratteri accentati e speciali (come quelli di
42 altre lingue), basta inserire semplicemente i caratteri nel file
43 LilyPond, purché il file sia salvato in formato UTF-8. Ulteriori informazioni
44 in @ref{Text encoding}.}
48 * Estensori del testo::
49 * Indicazioni testuali::
55 @unnumberedsubsubsec Scritte
56 @translationof Text scripts
59 @cindex elementi testuali non vuoti
60 @cindex testo tra virgolette
62 Si possono aggiungere a una partitura delle semplici indicazioni con
63 del @qq{testo tra virgolette}, come mostrato nell'esempio seguente.
64 Tali indicazioni possono essere posizionate sopra o sotto il rigo,
65 usando la sintassi descritta in @ref{Direction and placement}.
67 @lilypond[quote,verbatim]
68 \relative { a'8^"pizz." g f e a4-"scherz." f }
71 In realtà questa sintassi è una scorciatoia; si può specificare una formattazione
72 del testo più complessa usando in modo esplicito un blocco @code{\markup}, come
73 è spiegato in @ref{Formatting text}.
75 @lilypond[quote,verbatim]
77 a'8^\markup { \italic pizz. } g f e
78 a4_\markup { \tiny scherz. \bold molto } f }
81 Le indicazioni testuali, di norma, non influenzano la spaziatura delle note.
82 Ma è possibile far sì che la loro larghezza venga presa in considerazione:
83 nell'esempio seguente la prima stringa di testo non influenza la spaziatura,
86 @lilypond[quote,verbatim]
94 Oltre alle scritte, si possono attaccare alle note anche le
95 articolazioni. Ulteriori informazioni in @ref{Articulations and ornamentations}.
97 Per maggiori informazioni sull'ordinamento relativo delle scritte e delle
98 articolazioni si veda @rlearning{Posizionamento degli oggetti}.
100 @funindex \textLengthOn
101 @funindex textLengthOn
102 @funindex \textLengthOff
103 @funindex textLengthOff
106 @code{\textLengthOn},
107 @code{\textLengthOff}.
111 Manuale d'apprendimento:
112 @rlearning{Posizionamento degli oggetti}.
114 Guida alla notazione:
115 @ref{Formatting text},
116 @ref{Direction and placement},
117 @ref{Articulations and ornamentations}.
122 Guida al funzionamento interno:
123 @rinternals{TextScript}.
125 @cindex testo fuori dal margine
126 @cindex margine, testo che va oltre
127 @cindex testo, tenerlo dentro il margine
128 @cindex testo vocale, tenerlo dentro il margine
131 Per verificare che le scritte e il testo vocale siano entro i margini
132 occorrono ulteriori calcoli. Nei casi in cui è richiesta un'esecuzione
133 leggermente più veloce, usare
136 \override Score.PaperColumn.keep-inside-line = ##f
140 @node Estensori del testo
141 @unnumberedsubsubsec Estensori del testo
142 @translationof Text spanners
144 @cindex estensori del testo
146 Alcune indicazioni esecutive, per esempio @notation{rallentando} o
147 @notation{accelerando}, appaiono in forma testuale e vengono estese
148 lungo molteplici note con delle linee punteggiate. Tali oggetti,
149 chiamati @qq{estensori} (spanner), si creano collegando due note
150 con la seguente sintassi:
152 @lilypond[verbatim,quote]
154 \override TextSpanner.bound-details.left.text = "rit."
160 @cindex estensori del testo, formattazione
161 @cindex formattare gli estensori del testo
164 La stringa testuale da stampare viene impostata attraverso le proprietà
165 dell'oggetto. Per impostazione predefinita, appare in corsivo, ma si
166 può ottenere una formattazione diversa tramite i blocchi @code{\markup}, come
167 è spiegato in @ref{Formatting text}.
169 @lilypond[quote,verbatim]
171 \override TextSpanner.bound-details.left.text =
172 \markup { \upright "rit." }
178 Lo stile della linea, così come la stringa testuale, può essere definito come
179 una proprietà dell'oggetto. Questa sintassi è descritta in @ref{Line styles}.
181 @funindex \textSpannerUp
182 @funindex textSpannerUp
183 @funindex \textSpannerDown
184 @funindex textSpannerDown
185 @funindex \textSpannerNeutral
186 @funindex textSpannerNeutral
190 @code{\textSpannerUp},
191 @code{\textSpannerDown},
192 @code{\textSpannerNeutral}.
196 LilyPond è capace di gestire un solo estensore del testo per ogni voce.
200 @lilypondfile[verbatim,quote,texidoc,doctitle]
201 {dynamics-text-spanner-postfix.ly}
203 @lilypondfile[verbatim,quote,texidoc,doctitle]
204 {dynamics-custom-text-spanner-postfix.ly}
207 Guida alla notazione:
210 @ref{Formatting text}.
214 @rlsr{Expressive marks}.
216 Guida al funzionamento interno:
217 @rinternals{TextSpanner}.
220 @node Indicazioni testuali
221 @unnumberedsubsubsec Indicazioni testuali
222 @translationof Text marks
225 @cindex indicazioni testuali
226 @cindex testo, indicazioni
227 @cindex testo sulla stanghetta
228 @cindex coda sulla stanghetta
229 @cindex segno sulla stanghetta
230 @cindex corona sulla stanghetta
231 @cindex stanghette, simboli sulle
238 Si possono aggiungere vari elementi testuali a una partitura tramite la
239 sintassi descritta in @ref{Rehearsal marks}:
241 @c \mark needs to be placed on a separate line (it's not
242 @c attached to an object like \markup is). -vv
244 @lilypond[verbatim,quote]
252 Questa sintassi permette di porre del testo sopra una stanghetta;
253 una formattazione del testo più complessa è possibile grazie al
254 blocco @code{\markup}, come è spiegato in @ref{Formatting text}:
256 @lilypond[quote,verbatim]
259 \mark \markup { \italic { colla parte } }
266 Questa sintassi permette anche di stampare segni speciali, come coda, segno
267 o corona, se si specifica il nome appropriato del simbolo, come è spiegato
268 in @ref{Music notation inside markup}:
270 @lilypond[quote,verbatim]
273 \mark \markup { \musicglyph #"scripts.ufermata" }
279 Tali oggetti vengono posizionati soltanto sopra il rigo superiore della
280 partitura; a seconda che siano inseriti alla fine o a metà di una battuta,
281 possono trovarsi sopra la stanghetta o tra le note. Se inserito prima di
282 un'interruzione di linea, l'indicazione apparirà all'inizio della linea
285 @lilypond[quote,verbatim,ragged-right]
294 @funindex \markLengthOn
295 @funindex markLengthOn
296 @funindex \markLengthOff
297 @funindex markLengthOff
300 @code{\markLengthOn},
301 @code{\markLengthOff}.
306 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
307 {printing-marks-at-the-end-of-a-line.ly}
309 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
310 {printing-marks-on-every-staff.ly}
313 Guida alla notazione:
314 @ref{Rehearsal marks},
315 @ref{Formatting text},
316 @ref{Music notation inside markup},
322 Guida al funzionamento interno:
323 @rinternals{MarkEvent},
324 @rinternals{Mark_engraver},
325 @rinternals{RehearsalMark}.
329 @unnumberedsubsubsec Testo separato
330 @translationof Separate text
332 @cindex testo separato
333 @cindex testo indipendente
334 @cindex testo al livello superiore
339 Un blocco @code{\markup} può esistere di per sé, fuori da qualsiasi
340 blocco @code{\score}, come un'@tie{@qq{espressione di livello superiore}}. Questa
341 sintassi è descritta in @ref{File structure}.
343 @lilypond[verbatim,quote]
345 Tomorrow, and tomorrow, and tomorrow...
350 Ciò permette di stampare il testo in modo autonomo dalla musica, ed è
351 utile soprattutto quando il file di input contiene vari brani musicali,
352 come è spiegato in @ref{Multiple scores in a book}.
354 @lilypond[quote,verbatim]
359 Tomorrow, and tomorrow, and tomorrow...
366 Blocchi di testo separati possono essere estesi per molte pagine, rendendo
367 possibile la realizzazione di documenti o libri interamente con LilyPond.
368 Questa funzionalità, e la sintassi specifica che richiede, è descritta
369 in @ref{Multi-page markup}.
373 @funindex \markuplist
384 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
385 {stand-alone-two-column-markup.ly}
388 Guida alla notazione:
389 @ref{Formatting text},
390 @ref{File structure},
391 @ref{Multiple scores in a book},
392 @ref{Multi-page markup}.
397 Guida al funzionamento interno:
398 @rinternals{TextScript}.
401 @node Formattazione del testo
402 @subsection Formattazione del testo
403 @translationof Formatting text
405 Questa sezione presenta la formattazione del testo basilare e quella avanzata,
406 usando la sintassi specifica della modalità @code{\markup}.
409 * Introduzione al testo a margine::
410 * Scelta del tipo di carattere e della dimensione::
411 * Allineamento del testo::
412 * Notazione grafica nel blocco markup::
413 * Notazione musicale nel blocco markup::
414 * Testo formattato su più pagine::
417 @node Introduzione al testo a margine
418 @unnumberedsubsubsec Introduzione al testo a margine
419 @translationof Text markup introduction
422 @cindex testo a margine
428 Un blocco @code{\markup} permette di comporre del testo con un'ampia
429 sintassi chiamata @qq{modalità markup}.
431 @cindex markup, espressioni
432 @cindex espressioni di markup
433 @cindex sintassi di markup
434 @cindex markup, sintassi
436 La sintassi di markup è simile alla solita sintassi di LilyPond: un'espressione
437 @code{\markup} viene racchiusa tra parentesi graffe @code{@{@dots{} @}}. Una
438 singola parola viene considerata un'espressione minima, e quindi non è
439 necessario racchiuderla tra parentesi.
441 Diversamente dalle indicazioni testuali @qq{tra virgolette}, i blocchi
442 @code{\markup} possono contenere espressioni o comandi di markup annidati,
443 inseriti col carattere di barra inversa @code{\}. Tali comandi hanno
444 effetto solo sulla prima espressione che segue.
446 @lilypond[quote,verbatim]
449 a2^\markup { poco \italic più forte }
451 d2_\markup { \italic "string. assai" }
453 b1^\markup { \bold { molto \italic agitato } }
458 @cindex caratteri speciali in modalità markup
459 @cindex modalità markup, caratteri speciali
460 @cindex caratteri riservati, stampare
461 @cindex stampare i caratteri riservati
462 @cindex stampare i caratteri speciali
463 @cindex testo tra virgolette in modalità markup
464 @cindex modalità markup, testo tra virgolette
466 Un blocco @code{\markup} può contenere anche stringhe di testo tra
467 virgolette. Tali stringhe vengono trattate come espressioni testuali
468 minime, e quindi qualsiasi comando di markup o carattere speciale
469 (come @code{\} e@tie{}@code{#}) apparirà alla lettera senza influenzare
470 la formattazione del testo. Le stesse doppie virgolette possono essere
471 stampate facendole precedere da una barra inversa.
473 @lilypond[quote,verbatim]
475 a'1^"\italic markup..."
476 a_\markup { \italic "... prints \"italic\" letters!" }
481 Perché sia trattata come un'espressione distinta, una lista di parole deve
482 essere racchiusa tra virgolette doppie o preceduta da un comando. Il modo
483 in cui le espressioni musicali sono definite influenza il modo in cui
484 saranno sistemate, centrate e allineate; nell'esempio seguente, la seconda
485 espressione di @code{\markup} viene trattata nello stesso modo della prima:
487 @lilypond[quote,verbatim]
489 c1^\markup { \center-column { a bbb c } }
490 c1^\markup { \center-column { a { bbb c } } }
491 c1^\markup { \center-column { a \line { bbb c } } }
492 c1^\markup { \center-column { a "bbb c" } }
496 I markup possono essere salvati in delle variabili, che possono poi essere
497 attaccate direttamente alle note:
499 @lilypond[quote,verbatim]
500 allegro = \markup { \bold \large Allegro }
510 Una lista completa dei comandi specifici di @code{\markup} si trova in
511 @ref{Text markup commands}.
514 Guida alla notazione:
515 @ref{Text markup commands}.
521 @file{scm/markup.scm}.
524 Gli errori di sintassi relativi alla modalità markup possono essere poco chiari.
527 @node Scelta del tipo di carattere e della dimensione
528 @unnumberedsubsubsec Scelta del tipo di carattere e della dimensione
529 @translationof Selecting font and font size
531 @cindex tipi di carattere, cambiare
532 @cindex cambiare i tipi di carattere
533 @cindex font, cambiare
542 La modalità markup permette di cambiare il tipo di carattere:
544 @lilypond[quote,verbatim]
548 \italic { non troppo \underline Vivo }
551 d,_\markup { \italic quasi \smallCaps Tromba }
556 @cindex dimensione del tipo di carattere
557 @cindex tipo di carattere, dimensione
558 @cindex dimensione del testo
559 @cindex testo, dimensione
561 @funindex \abs-fontsize
571 Si può modificare la dimensione del tipo di carattere, rispetto alla
572 dimensione globale del rigo, in vari modi.
574 Si può impostare su una dimensione predefinita,
576 @lilypond[quote,verbatim]
578 b1_\markup { \huge Sinfonia }
579 b1^\markup { \teeny da }
580 b1-\markup { \normalsize camera }
584 oppure in modo proporzionale rispetto al valore precedente,
586 @lilypond[quote,verbatim]
588 b1_\markup { \larger Sinfonia }
589 b1^\markup { \smaller da }
590 b1-\markup { \magnify #0.6 camera }
594 Può essere aumentata o diminuita rispetto al valore impostato per la
595 dimensione globale del rigo:
597 @lilypond[quote,verbatim]
599 b1_\markup { \fontsize #-2 Sinfonia }
600 b1^\markup { \fontsize #1 da }
601 b1-\markup { \fontsize #3 camera }
605 Si può impostare anche su una dimensione fissa (in punti), indipendentemente
606 dalla dimensione globale del rigo:
608 @lilypond[quote,verbatim]
610 b1_\markup { \abs-fontsize #20 Sinfonia }
611 b1^\markup { \abs-fontsize #8 da }
612 b1-\markup { \abs-fontsize #14 camera }
616 Se il testo contiene degli spazi, è meglio racchiuderlo tutto tra virgolette,
617 in modo che la dimensione di ciascun spazio sia adatta alla dimensione degli
620 @lilypond[quote,verbatim]
621 \markup \fontsize #6 \bold { Sinfonia da camera }
622 \markup \fontsize #6 \bold { "Sinfonia da camera" }
632 @funindex \normal-size-super
633 @funindex normal-size-super
635 È possibile stampare il testo come pedice o apice. Per impostazione
636 predefinita, questo appaiono in corpo più piccolo, ma si può usare
637 anche un corpo normale:
639 @lilypond[quote,verbatim]
642 \line { 1 \super st movement }
643 \line { 1 \normal-size-super st movement
644 \sub { (part two) } }
649 @cindex famiglie di tipi di carattere
650 @cindex tipi di carattere, famiglie
652 La modalità di markup fornisce un modo semplice per scegliere famiglie
653 di caratteri diverse. Se non specificato altrimenti, viene scelto
654 automaticamente il carattere tipografico con grazie (il tipo romano);
655 nell'ultima linea dell'esempio seguente non c'è differenza tra la
656 prima e la seconda parola.
658 @lilypond[quote,verbatim]
661 \line { Act \number 1 }
662 \line { \sans { Scene I. } }
663 \line { \typewriter { Verona. An open place. } }
664 \line { Enter \roman Valentine and Proteus. }
670 Alcune di queste famiglie di caratteri, usate per elementi specifici come i
671 numeri o le dinamiche, non forniscono tutti i caratteri, come accennato in
672 @ref{New dynamic marks} e @ref{Manual repeat marks}.
674 @c \concat is actually documented in Align (it is not
675 @c a font-switching command). But we need it here. -vv
677 Se usati all'interno di una parola, alcuni comandi che cambiano il tipo di
678 carattere o la formattazione potrebbero produrre uno spazio vuoto
679 indesiderato. Si può facilmente risolvere concatenando insieme gli
682 @lilypond[quote,verbatim]
686 \concat { 1 \super st }
690 \concat { \dynamic p , }
691 \italic { con dolce espressione }
697 Una lista completa dei comandi per cambiare il tipo di carattere o per usare
698 tipi di carattere personalizzati si trova in @ref{Font}.
700 È possibile anche definire i propri gruppi di tipi di carattere, come
701 è spiegato in @ref{Fonts}.
709 @funindex \normalsize
733 Guida alla notazione:
735 @ref{New dynamic marks},
736 @ref{Manual repeat marks},
740 @file{scm/define-markup-commands.scm}.
745 Guida al funzionamento interno:
746 @rinternals{TextScript}.
749 L'uso dei comandi di dimensionamento dei caratteri @code{\teeny}, @code{\tiny},
750 @code{\small}, @code{\normalsize}, @code{\large} e @code{\huge} produce
751 una spaziatura della linea imprevedibile rispetto all'uso di @code{\fontsize}.
754 @node Allineamento del testo
755 @unnumberedsubsubsec Allineamento del testo
756 @translationof Text alignment
758 @cindex testo, allineamento
759 @cindex allineare il testo
760 @cindex allineare il markup
761 @cindex markup, allineare
763 Questa sottosezione spiega come posizionare il testo nella modalità
764 markup. Gli oggetti markup possono anche essere spostati interamente
765 tramite la sintassi descritta in @rlearning{Spostare gli oggetti}.
767 @c Padding commands should be mentioned on this page, but
768 @c most of these require \box to be more clearly illustrated. -vv
770 @cindex testo, allineamento orizzontale
771 @cindex allineamento orizzontale del testo
773 @funindex \left-align
775 @funindex \center-align
776 @funindex center-align
777 @funindex \right-align
778 @funindex right-align
780 Gli oggetti di markup possono essere allineati in vari modi. Per impostazione
781 predefinita, l'indicazione testuale è allineata rispetto al suo margine
782 sinistro: nell'esempio seguente, non c'è differenza tra il primo e il
785 @lilypond[quote,verbatim]
787 d''1-\markup { poco }
789 d-\markup { \left-align poco }
791 d-\markup { \center-align { poco } }
793 d-\markup { \right-align poco }
800 L'allineamento orizzontale può essere ritoccato usando un valore numerico:
802 @lilypond[quote,verbatim]
804 a'1-\markup { \halign #-1 poco }
806 a,-\markup { \halign #0 poco }
808 a,-\markup { \halign #0.5 poco }
810 a,-\markup { \halign #2 poco }
815 Alcuni oggetti possono avere proprie procedure di allineamento, e dunque
816 non sono influenzate da questi comandi. È possibile spostare tali
817 oggetti di markup tutti insieme, come mostrato ad esempio in
820 @cindex testo, allineamento verticale
821 @cindex allineamento verticale del testo
830 @c QUERY Should the function of ``\null'' be clarified? rp
832 L'allineamento verticale è un po' più complesso. Come si è detto prima, gli
833 oggetti di markup possono essere spostati tutti insieme; tuttavia è anche
834 possibile spostare elementi specifici all'interno di un blocco markup. In
835 questo caso l'elemento da spostare deve essere preceduto da un @emph{punto di riferimento}, che
836 può essere un altro elemento markup o un oggetto invisibile. L'esempio seguente
837 illustra queste due possibilità; l'ultimo markup in questo esempio non ha un
838 punto di riferimento e di conseguenza non si muove.
840 @lilypond[quote,verbatim]
844 \raise #2 { Scène 1 }
849 \lower #4 \bold { Très modéré }
853 \raise #4 \italic { Une forêt. }
859 @funindex \general-align
860 @funindex general-align
863 @funindex \translate-scaled
864 @funindex translate-scaled
866 Alcuni comandi possono cambiare l'allineamento sia orizzontale che verticale
867 degli oggetti testuali in modalità markup. Qualsiasi oggetto interessato
868 da questi comandi deve essere preceduto da un punto di riferimento:
870 @lilypond[quote,verbatim]
874 \translate #'(-1 . 2) "Scène 1"
879 \general-align #Y #3.2 \bold "Très modéré"
884 \translate-scaled #'(-1 . 2) \teeny "Une forêt."
890 @cindex markup multilinea
891 @cindex multilinea, markup
892 @cindex testo multilinea
893 @cindex multilinea, testo
894 @cindex testo in colonne
895 @cindex colonne, testo
899 @funindex \center-column
900 @funindex center-column
902 Un oggetto markup può includere varie linee di testo. Nell'esempio
903 seguente, ogni elemento o espressione viene posizionato sulla sua
904 linea, allineato a sinistra o centrato:
906 @lilypond[quote,verbatim]
922 @cindex centrare il testo sulla pagina
923 @cindex testo, centrare sulla pagina
924 @cindex markup, centrare sulla pagina
929 Analogalmente, una lista di elementi o espressioni può essere distesa
930 per riempire l'intera larghezza orizzontale della linea (se c'è un solo
931 elemento, verrà centrato sulla pagina). Queste espressioni possono
932 a loro volta includere del testo multilinea o una qualsiasi altra
933 espressione di markup:
935 @lilypond[quote,verbatim]
938 \line { William S. Gilbert }
940 \huge \smallCaps "The Mikado"
942 \smallCaps "The Town of Titipu"
944 \line { Sir Arthur Sullivan }
952 @cindex testo a capo automaticamente
953 @cindex testo giustificato
954 @cindex giustificato, testo
955 @cindex a capo, testo
956 @cindex markup, testo a capo
957 @cindex markup, testo giustificato
964 Indicazioni testuali lunghe possono andare a capo automaticamente in base
965 alla larghezza della linea specificata. Possono essere allineate a
966 sinistra o giustificate, come mostra l'esempio seguente.
968 @lilypond[quote,verbatim]
971 \line \smallCaps { La vida breve }
972 \line \bold { Acto I }
974 (La escena representa el corral de una casa de
975 gitanos en el Albaicín de Granada. Al fondo una
976 puerta por la que se ve el negro interior de
977 una Fragua, iluminado por los rojos resplandores
982 \line \bold { Acto II }
983 \override #'(line-width . 50)
985 (Calle de Granada. Fachada de la casa de Carmela
986 y su hermano Manuel con grandes ventanas abiertas
987 a través de las que se ve el patio
988 donde se celebra una alegre fiesta)
994 @cindex testo, comandi di allineamento del
995 @cindex markup, comandi di allineamento del testo
996 @cindex allineamento, testo, comandi
998 Una lista completa dei comandi di allineamento del testo si trova in
1002 Manuale d'apprendimento:
1003 @rlearning{Spostare gli oggetti}.
1005 Guida alla notazione:
1010 @file{scm/define-markup-commands.scm}.
1015 Guida al funzionamento interno:
1016 @rinternals{TextScript}.
1019 @node Notazione grafica nel blocco markup
1020 @unnumberedsubsubsec Notazione grafica nel blocco markup
1021 @translationof Graphic notation inside markup
1023 @cindex grafica, inclusione
1024 @cindex disegnare oggetti grafici
1025 @cindex oggetti grafici, disegnare
1026 @cindex oggetti grafici incorporati
1027 @cindex oggetti grafici, includere
1029 Si possono aggiungere vari oggetti grafici a una partitura attraverso
1030 i comandi di markup.
1032 @cindex decorazione del testo
1033 @cindex incorniciatura del testo
1034 @cindex testo, incorniciatura
1035 @cindex testo, decorazione
1036 @cindex markup, decorazione
1037 @cindex markup, incorniciatura
1043 @funindex \rounded-box
1044 @funindex rounded-box
1050 Alcuni comandi di markup consentono di decorare gli elementi testuali con
1051 degli elementi grafici, come è illustrato nell'esempio seguente.
1053 @lilypond[quote,verbatim]
1054 \markup \fill-line {
1062 \bracket "1866 - 1925"
1065 \rounded-box \bold Prelude
1070 @cindex padding intorno al testo
1071 @cindex testo, padding
1072 @cindex markup, padding
1074 @funindex \pad-markup
1075 @funindex pad-markup
1078 @funindex \pad-to-box
1079 @funindex pad-to-box
1080 @funindex \pad-around
1081 @funindex pad-around
1083 Alcuni comandi possono richiedere un aumento del padding intorno al
1084 testo; per farlo si usano dei comandi di markup, descritti in modo
1085 esaustivo in @ref{Align}.
1087 @lilypond[quote,verbatim]
1088 \markup \fill-line {
1090 \box "Charles Ives (1874 - 1954)"
1092 \box \pad-markup #2 "THE UNANSWERED QUESTION"
1093 \box \pad-x #8 "A Cosmic Landscape"
1100 \box \pad-to-box #'(-5 . 20) #'(0 . 5)
1101 \bold "Largo to Presto"
1104 "String quartet keeps very even time,
1105 Flute quartet keeps very uneven time."
1109 @cindex notazione grafica
1110 @cindex simboli non musicali
1114 @funindex \draw-circle
1115 @funindex draw-circle
1116 @funindex \filled-box
1117 @funindex filled-box
1120 @funindex \draw-line
1122 @funindex \arrow-head
1123 @funindex arrow-head
1125 Si possono produrre altri elementi grafici o simboli che non richiedono
1126 alcun testo. Come con qualsiasi espressione di markup, tali oggetti
1127 possono essere combinati.
1129 @lilypond[quote,verbatim]
1132 \draw-circle #4 #0.4 ##f
1133 \filled-box #'(-4 . 4) #'(-0.5 . 0.5) #1
1139 \draw-line #'(0 . 4)
1140 \arrow-head #Y #DOWN ##f
1145 @cindex grafica inclusa
1146 @cindex immagini incluse
1151 @funindex \postscript
1152 @funindex postscript
1154 Le funzionalità grafiche avanzate comprendono la possibilità di includere
1155 file di immagini convertite nel formato Encapsulated PostScript
1156 (@emph{eps}), oppure di inserire la grafica direttamente nel file di input,
1157 usando del codice PostScript nativo. In tal caso, può essere utile specificare
1158 esplicitamente la dimensione del disegno, come è mostrato sotto:
1160 @lilypond[quote,verbatim,fragment]
1163 \epsfile #X #10 #"./context-example.eps"
1164 \with-dimensions #'(0 . 6) #'(0 . 10)
1180 Una lista completa dei comandi specifici per la grafica si trova in
1184 Guida alla notazione:
1187 @ref{Editorial annotations},
1191 @file{scm/define-markup-commands.scm},
1192 @file{scm/stencil.scm}.
1197 Guida al funzionamento interno:
1198 @rinternals{TextScript}.
1201 @node Notazione musicale nel blocco markup
1202 @unnumberedsubsubsec Notazione musicale nel blocco markup
1203 @translationof Music notation inside markup
1205 @cindex notazione dentro il blocco markup
1206 @cindex musica dentro il blocco markup
1207 @cindex markup, notazione musicale dentro
1209 Si possono aggiungere vari elementi della notazione musicale dentro un
1212 Per le note e le alterazioni esistono dei comandi markup appositi:
1214 @lilypond[quote,verbatim,fragment]
1218 \note-by-number #1 #1 #1.5
1221 \natural \semiflat \flat
1222 \sesquiflat \doubleflat
1226 \natural \semisharp \sharp
1227 \sesquisharp \doublesharp
1232 Anche altri oggetti della notazione possono essere stampati in
1235 @lilypond[quote,verbatim]
1238 ees\finger \markup \tied-lyric #"4~1"
1239 fis_\markup { \dynamic rf }
1251 Più in generale, qualsiasi simbolo musicale disponibile può essere incluso
1252 separatamente in un oggetto markup, come è illustrato sotto. Una lista
1253 completa di questi simboli e dei loro nomi si trova in
1254 @ref{The Feta font}.
1256 @lilypond[quote,verbatim]
1259 c'^\markup { \musicglyph #"eight" }
1261 c,8._\markup { \musicglyph #"clefs.G_change" }
1263 c2^\markup { \musicglyph #"timesig.neomensural94" }
1267 Un altro modo per stampare glifi non testuali è descritto in
1268 @ref{Fonts explained}. È utile per stampare parentesi di varie
1271 La modalità markup supporta anche i diagrammi per strumenti specifici:
1273 @lilypond[quote,verbatim]
1276 \fret-diagram-terse #"x;x;o;2;3;2;"
1279 \harp-pedal #"^-v|--ov^"
1284 \musicglyph #"accordion.discant"
1286 \raise #0.5 \musicglyph #"accordion.dot"
1287 \raise #1.5 \musicglyph #"accordion.dot"
1292 @c The accordion diagram is actually taken from a snippet.
1295 Questi diagrammi sono documentati in @ref{Instrument Specific Markup}.
1297 @cindex partitura dentro il blocco markup
1298 @cindex markup, partitura dentro
1300 È possibile annidare perfino un'intera partitura in un oggetto markup. In tal
1301 caso, il blocco @code{\score} annidato deve contenere un blocco @code{\layout},
1302 come è illustrato qui:
1304 @lilypond[quote,verbatim]
1308 \relative { c'4 d e f }
1317 Una lista completa dei comandi relativi alla notazione musicale si trova
1321 Guida alla notazione:
1323 @ref{The Feta font},
1324 @ref{Fonts explained}.
1327 @file{scm/define-markup-commands.scm},
1328 @file{scm/fret-diagrams.scm},
1329 @file{scm/harp-pedals.scm}.
1334 Guida al funzionamento interno:
1335 @rinternals{TextScript}.
1338 @node Testo formattato su più pagine
1339 @unnumberedsubsubsec Testo formattato su più pagine
1340 @translationof Multi-page markup
1342 @cindex testo formattato su più pagine
1343 @cindex markup, multipagina
1344 @cindex multipagina, testo
1345 @cindex testo esteso su più pagine
1347 @funindex \markuplist
1348 @funindex markuplist
1349 @funindex \justified-lines
1350 @funindex justified-lines
1351 @funindex \wordwrap-lines
1352 @funindex wordwrap-lines
1354 Sebbene gli oggetti di markup standard non possano avere interruzioni, una
1355 specifica sintassi permette di inserire linee di testo che possono estendersi
1358 @lilypond[quote,verbatim]
1361 Un testo molto lungo di linee giustificate.
1365 Un altro paragrafo molto lungo.
1372 Questa sintassi accetta una lista di oggetti di markup, che possono essere
1375 il risultato di un comando \markuplist,
1377 una lista di markup,
1379 una lista di \markuplists.
1382 Una lista completa dei comandi che si possono usare con \markuplist si
1383 trova in @ref{Text markup list commands}.
1386 Guida alla notazione:
1387 @ref{Text markup list commands}.
1390 @rextend{New markup list command definition}.
1393 @file{scm/define-markup-commands.scm}.
1398 Guida al funzionamento interno:
1399 @rinternals{TextScript}.
1401 @funindex \markuplist
1402 @funindex markuplist
1409 @node Tipi di carattere
1410 @subsection Tipi di carattere
1411 @translationof Fonts
1413 Questa sezione presenta il modo in cui sono gestiti i tipi di carattere e come
1414 possono essere modificati nelle partiture.
1417 * Tipi di carattere in dettaglio::
1418 * Tipi di carattere per singolo oggetto::
1419 * Tipi di carattere per l'intero documento::
1422 @node Tipi di carattere in dettaglio
1423 @unnumberedsubsubsec Tipi di carattere in dettaglio
1424 @translationof Fonts explained
1427 @cindex tipi di carattere
1429 @cindex graffe, varie dimensioni
1430 @cindex font non testuali nel markup
1432 @funindex font-interface
1434 I tipi di carattere vengono gestiti attraverso varie librerie. FontConfig
1435 rileva i tipi di carattere disponibili nel sistema; i tipi selezionati
1436 sono riprodotti con Pango.
1438 I tipi di carattere della notazione musicale possono essere descritti
1439 come un insieme di glifi specifici, ordinati in varie famiglie. La
1440 seguente sintassi permette di usare vari caratteri @code{feta} di LilyPond
1441 (non testuali) direttamente nella modalità markup:
1443 @lilypond[quote,verbatim,fragment]
1446 \override #'(font-encoding . fetaBraces)
1448 \override #'(font-encoding . fetaText)
1450 \override #'(font-encoding . fetaMusic)
1451 \lookup #"noteheads.s0petrucci"
1457 Tuttavia, tutti questi glifi, ad eccezione delle graffe di varie
1458 dimensioni contenute in @code{fetaBraces}, sono già utilizzabili
1459 con la sintassi ben più semplice descritta in @ref{Music notation inside markup}.
1461 Quando si usano i glifi contenuti in @code{fetaBraces}, la dimensione
1462 della graffa viene specificata dalla parte numerica del nome del glifo,
1463 in unità arbitrarie. Può essere specificato qualsiasi numero intero da
1464 @code{0} a @code{575} compresi, dove @code{0} corrisponde alla graffa
1465 più piccola. Il valore ottimale deve essere determinato per tentativi.
1466 Questi glifi sono tutte graffe sinistre; le graffe destre si possono
1467 ottenere con la rotazione, vedi @ref{Rotating objects}.
1469 Sono disponibili tre famiglie di tipi di carattere:
1472 Il tipo @emph{roman} (con grazie), il cui valore predefinito è LilyPond Serif
1473 (un alias di TeX Gyre Schola).
1475 Il tipo @emph{sans} (senza grazie), il cui valore predefinito è LilyPond Sans
1476 Serif (un alias di TeX Gyre Heros).
1478 Il tipo monospaziato @emph{typewriter}, il cui valore predefinito è LilyPond
1479 Monospace (un alias di TeX Gyre Cursor).
1482 Ogni famiglia può avere forme e serie differenti. L'esempio seguente
1483 illustra la possibilità di scegliere famiglie, forme, serie e
1484 dimensioni alternative. Il valore specificato per @code{font-size} è
1485 la modifica relativa alla dimensione predefinita.
1487 @lilypond[quote,verbatim,fragment]
1488 \override Score.RehearsalMark.font-family = #'typewriter
1489 \mark \markup "Ouverture"
1490 \override Voice.TextScript.font-shape = #'italic
1491 \override Voice.TextScript.font-series = #'bold
1492 d''2.^\markup "Allegro"
1493 \override Voice.TextScript.font-size = #-3
1498 Una sintassi simile si usa nella modalità markup; tuttavia in questo
1499 caso è preferibile usare la sintassi più semplice spiegata in
1500 @ref{Selecting font and font size}:
1502 @lilypond[quote,verbatim]
1506 \override #'(font-shape . italic)
1507 \override #'(font-size . 4)
1511 \override #'(font-family . typewriter)
1513 \override #'(font-series . bold)
1517 \override #'(font-family . sans)
1524 Sebbene sia semplice passare a un tipo di carattere preconfigurato, è anche
1525 possibile usare altri tipi, come viene spiegato nelle sezioni successive:
1526 @ref{Single entry fonts} e @ref{Entire document fonts}.
1529 Guida alla notazione:
1530 @ref{The Feta font},
1531 @ref{Music notation inside markup},
1532 @ref{Rotating objects},
1533 @ref{Selecting font and font size},
1537 @node Tipi di carattere per singolo oggetto
1538 @unnumberedsubsubsec Tipi di carattere per singolo oggetto
1539 @translationof Single entry fonts
1541 Si può usare nella partitura qualsiasi tipo di carattere che sia installato
1542 nel sistema operativo e riconosciuto da FontConfig, usando la seguente
1545 @lilypond[quote,verbatim,fragment]
1546 \override Staff.TimeSignature.font-name = #"Bitstream Charter"
1547 \override Staff.TimeSignature.font-size = #2
1551 \override #'(font-name . "Bitstream Vera Sans,sans-serif, Oblique Bold")
1552 { Vera Oblique Bold }
1556 @cindex tipi di carattere, trovare quelli disponibili
1557 @cindex trovare i tipi di carattere disponibili
1558 @cindex elencare i tipi di carattere disponibili
1559 @cindex tipi di carattere disponibili, elenco
1561 @var{font-name} può essere definito da una lista separata da virgola di
1562 @q{font} e una lista separata da spazi di @q{stili}. Se il @q{font} nella
1563 lista è installato e contiene il glifo richiesto, verrà usato, altrimenti
1564 sarà usato al suo posto il font @emph{successivo}.
1566 @funindex show-available-fonts
1568 Lanciando lilypond con la seguente opzione si ottiene un elenco di tutti i
1569 tipi di carattere disponibili nel sistema operativo:
1572 lilypond -dshow-available-fonts x
1576 Guida alla notazione:
1577 @ref{Fonts explained},
1578 @ref{Entire document fonts}.
1583 @c A source file gets never installed...
1585 @c @file{lily/font-config-scheme.cc}.
1588 @node Tipi di carattere per l'intero documento
1589 @unnumberedsubsubsec Tipi di carattere per l'intero documento
1590 @translationof Entire document fonts
1592 È possibile modificare i tipi di carattere usati come tipi predefiniti nelle
1593 famiglie @emph{roman}, @emph{sans} e @emph{typewriter} specificandoli, in questo
1594 ordine, come è mostrato nell'esempio seguente, che ridimensiona automaticamente
1595 i caratteri col valore impostato per la dimensione globale del rigo. In modo
1596 analogo a @ref{Single entry fonts}, si può indicare con una lista separata da
1597 virgole di @q{font}. Gli @q{stili} dei font, invece, non possono essere
1598 definiti. I tipi di carattere sono spiegati in @ref{Fonts explained}.
1600 @cindex famiglie di tipi di carattere, impostare
1601 @cindex tipi di carattere, modificarli per l'intero documento
1603 @funindex make-pango-font-tree
1605 @lilypond[verbatim,quote]
1608 (make-pango-font-tree "Times New Roman"
1609 "Nimbus Sans,Nimbus Sans L"
1611 (/ staff-height pt 20)))
1618 \typewriter typewriter. }
1622 @c we don't do Helvetica / Courier, since GS incorrectly loads
1626 Guida alla notazione:
1627 @ref{Fonts explained},
1628 @ref{Single entry fonts},
1629 @ref{Selecting font and font size},