1 @c -*- coding: utf-8; mode: texinfo; -*-
3 Translation of GIT committish: 2583260566074fd263a84d515ef637267563d371
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 }
623 @funindex \normal-size-super
624 @funindex normal-size-super
626 È possibile stampare il testo come pedice o apice. Per impostazione
627 predefinita, questo appaiono in corpo più piccolo, ma si può usare
628 anche un corpo normale:
630 @lilypond[quote,verbatim]
633 \line { 1 \super st movement }
634 \line { 1 \normal-size-super st movement
635 \sub { (part two) } }
640 @cindex famiglie di tipi di carattere
641 @cindex tipi di carattere, famiglie
643 La modalità di markup fornisce un modo semplice per scegliere famiglie
644 di caratteri diverse. Se non specificato altrimenti, viene scelto
645 automaticamente il carattere tipografico con grazie (il tipo romano);
646 nell'ultima linea dell'esempio seguente non c'è differenza tra la
647 prima e la seconda parola.
649 @lilypond[quote,verbatim]
652 \line { Act \number 1 }
653 \line { \sans { Scene I. } }
654 \line { \typewriter { Verona. An open place. } }
655 \line { Enter \roman Valentine and Proteus. }
661 Alcune di queste famiglie di caratteri, usate per elementi specifici come i
662 numeri o le dinamiche, non forniscono tutti i caratteri, come accennato in
663 @ref{New dynamic marks} e @ref{Manual repeat marks}.
665 @c \concat is actually documented in Align (it is not
666 @c a font-switching command). But we need it here. -vv
668 Se usati all'interno di una parola, alcuni comandi che cambiano il tipo di
669 carattere o la formattazione potrebbero produrre uno spazio vuoto
670 indesiderato. Si può facilmente risolvere concatenando insieme gli
673 @lilypond[quote,verbatim]
677 \concat { 1 \super st }
681 \concat { \dynamic p , }
682 \italic { con dolce espressione }
688 Una lista completa dei comandi per cambiare il tipo di carattere o per usare
689 tipi di carattere personalizzati si trova in @ref{Font}.
691 È possibile anche definire i propri gruppi di tipi di carattere, come
692 è spiegato in @ref{Fonts}.
700 @funindex \normalsize
724 Guida alla notazione:
726 @ref{New dynamic marks},
727 @ref{Manual repeat marks},
731 @file{scm/define-markup-commands.scm}.
736 Guida al funzionamento interno:
737 @rinternals{TextScript}.
740 L'uso dei comandi di dimensionamento dei caratteri @code{\teeny}, @code{\tiny},
741 @code{\small}, @code{\normalsize}, @code{\large} e @code{\huge} produce
742 una spaziatura della linea imprevedibile rispetto all'uso di @code{\fontsize}.
745 @node Allineamento del testo
746 @unnumberedsubsubsec Allineamento del testo
747 @translationof Text alignment
749 @cindex testo, allineamento
750 @cindex allineare il testo
751 @cindex allineare il markup
752 @cindex markup, allineare
754 Questa sottosezione spiega come posizionare il testo nella modalità
755 markup. Gli oggetti markup possono anche essere spostati interamente
756 tramite la sintassi descritta in @rlearning{Spostare gli oggetti}.
758 @c Padding commands should be mentioned on this page, but
759 @c most of these require \box to be more clearly illustrated. -vv
761 @cindex testo, allineamento orizzontale
762 @cindex allineamento orizzontale del testo
764 @funindex \left-align
766 @funindex \center-align
767 @funindex center-align
768 @funindex \right-align
769 @funindex right-align
771 Gli oggetti di markup possono essere allineati in vari modi. Per impostazione
772 predefinita, l'indicazione testuale è allineata rispetto al suo margine
773 sinistro: nell'esempio seguente, non c'è differenza tra il primo e il
776 @lilypond[quote,verbatim]
778 d''1-\markup { poco }
780 d-\markup { \left-align poco }
782 d-\markup { \center-align { poco } }
784 d-\markup { \right-align poco }
791 L'allineamento orizzontale può essere ritoccato usando un valore numerico:
793 @lilypond[quote,verbatim]
795 a'1-\markup { \halign #-1 poco }
797 a,-\markup { \halign #0 poco }
799 a,-\markup { \halign #0.5 poco }
801 a,-\markup { \halign #2 poco }
806 Alcuni oggetti possono avere proprie procedure di allineamento, e dunque
807 non sono influenzate da questi comandi. È possibile spostare tali
808 oggetti di markup tutti insieme, come mostrato ad esempio in
811 @cindex testo, allineamento verticale
812 @cindex allineamento verticale del testo
821 @c QUERY Should the function of ``\null'' be clarified? rp
823 L'allineamento verticale è un po' più complesso. Come si è detto prima, gli
824 oggetti di markup possono essere spostati tutti insieme; tuttavia è anche
825 possibile spostare elementi specifici all'interno di un blocco markup. In
826 questo caso l'elemento da spostare deve essere preceduto da un @emph{punto di riferimento}, che
827 può essere un altro elemento markup o un oggetto invisibile. L'esempio seguente
828 illustra queste due possibilità; l'ultimo markup in questo esempio non ha un
829 punto di riferimento e di conseguenza non si muove.
831 @lilypond[quote,verbatim]
835 \raise #2 { Scène 1 }
840 \lower #4 \bold { Très modéré }
844 \raise #4 \italic { Une forêt. }
850 @funindex \general-align
851 @funindex general-align
854 @funindex \translate-scaled
855 @funindex translate-scaled
857 Alcuni comandi possono cambiare l'allineamento sia orizzontale che verticale
858 degli oggetti testuali in modalità markup. Qualsiasi oggetto interessato
859 da questi comandi deve essere preceduto da un punto di riferimento:
861 @lilypond[quote,verbatim]
865 \translate #'(-1 . 2) "Scène 1"
870 \general-align #Y #3.2 \bold "Très modéré"
875 \translate-scaled #'(-1 . 2) \teeny "Une forêt."
881 @cindex markup multilinea
882 @cindex multilinea, markup
883 @cindex testo multilinea
884 @cindex multilinea, testo
885 @cindex testo in colonne
886 @cindex colonne, testo
890 @funindex \center-column
891 @funindex center-column
893 Un oggetto markup può includere varie linee di testo. Nell'esempio
894 seguente, ogni elemento o espressione viene posizionato sulla sua
895 linea, allineato a sinistra o centrato:
897 @lilypond[quote,verbatim]
913 @cindex centrare il testo sulla pagina
914 @cindex testo, centrare sulla pagina
915 @cindex markup, centrare sulla pagina
920 Analogalmente, una lista di elementi o espressioni può essere distesa
921 per riempire l'intera larghezza orizzontale della linea (se c'è un solo
922 elemento, verrà centrato sulla pagina). Queste espressioni possono
923 a loro volta includere del testo multilinea o una qualsiasi altra
924 espressione di markup:
926 @lilypond[quote,verbatim]
929 \line { William S. Gilbert }
931 \huge \smallCaps "The Mikado"
933 \smallCaps "The Town of Titipu"
935 \line { Sir Arthur Sullivan }
943 @cindex testo a capo automaticamente
944 @cindex testo giustificato
945 @cindex giustificato, testo
946 @cindex a capo, testo
947 @cindex markup, testo a capo
948 @cindex markup, testo giustificato
955 Indicazioni testuali lunghe possono andare a capo automaticamente in base
956 alla larghezza della linea specificata. Possono essere allineate a
957 sinistra o giustificate, come mostra l'esempio seguente.
959 @lilypond[quote,verbatim]
962 \line \smallCaps { La vida breve }
963 \line \bold { Acto I }
965 (La escena representa el corral de una casa de
966 gitanos en el Albaicín de Granada. Al fondo una
967 puerta por la que se ve el negro interior de
968 una Fragua, iluminado por los rojos resplandores
973 \line \bold { Acto II }
974 \override #'(line-width . 50)
976 (Calle de Granada. Fachada de la casa de Carmela
977 y su hermano Manuel con grandes ventanas abiertas
978 a través de las que se ve el patio
979 donde se celebra una alegre fiesta)
985 @cindex testo, comandi di allineamento del
986 @cindex markup, comandi di allineamento del testo
987 @cindex allineamento, testo, comandi
989 Una lista completa dei comandi di allineamento del testo si trova in
993 Manuale d'apprendimento:
994 @rlearning{Spostare gli oggetti}.
996 Guida alla notazione:
1001 @file{scm/define-markup-commands.scm}.
1006 Guida al funzionamento interno:
1007 @rinternals{TextScript}.
1010 @node Notazione grafica nel blocco markup
1011 @unnumberedsubsubsec Notazione grafica nel blocco markup
1012 @translationof Graphic notation inside markup
1014 @cindex grafica, inclusione
1015 @cindex disegnare oggetti grafici
1016 @cindex oggetti grafici, disegnare
1017 @cindex oggetti grafici incorporati
1018 @cindex oggetti grafici, includere
1020 Si possono aggiungere vari oggetti grafici a una partitura attraverso
1021 i comandi di markup.
1023 @cindex decorazione del testo
1024 @cindex incorniciatura del testo
1025 @cindex testo, incorniciatura
1026 @cindex testo, decorazione
1027 @cindex markup, decorazione
1028 @cindex markup, incorniciatura
1034 @funindex \rounded-box
1035 @funindex rounded-box
1041 Alcuni comandi di markup consentono di decorare gli elementi testuali con
1042 degli elementi grafici, come è illustrato nell'esempio seguente.
1044 @lilypond[quote,verbatim]
1045 \markup \fill-line {
1053 \bracket "1866 - 1925"
1056 \rounded-box \bold Prelude
1061 @cindex padding intorno al testo
1062 @cindex testo, padding
1063 @cindex markup, padding
1065 @funindex \pad-markup
1066 @funindex pad-markup
1069 @funindex \pad-to-box
1070 @funindex pad-to-box
1071 @funindex \pad-around
1072 @funindex pad-around
1074 Alcuni comandi possono richiedere un aumento del padding intorno al
1075 testo; per farlo si usano dei comandi di markup, descritti in modo
1076 esaustivo in @ref{Align}.
1078 @lilypond[quote,verbatim]
1079 \markup \fill-line {
1081 \box "Charles Ives (1874 - 1954)"
1083 \box \pad-markup #2 "THE UNANSWERED QUESTION"
1084 \box \pad-x #8 "A Cosmic Landscape"
1091 \box \pad-to-box #'(-5 . 20) #'(0 . 5)
1092 \bold "Largo to Presto"
1095 "String quartet keeps very even time,
1096 Flute quartet keeps very uneven time."
1100 @cindex notazione grafica
1101 @cindex simboli non musicali
1105 @funindex \draw-circle
1106 @funindex draw-circle
1107 @funindex \filled-box
1108 @funindex filled-box
1111 @funindex \draw-line
1113 @funindex \arrow-head
1114 @funindex arrow-head
1116 Si possono produrre altri elementi grafici o simboli che non richiedono
1117 alcun testo. Come con qualsiasi espressione di markup, tali oggetti
1118 possono essere combinati.
1120 @lilypond[quote,verbatim]
1123 \draw-circle #4 #0.4 ##f
1124 \filled-box #'(-4 . 4) #'(-0.5 . 0.5) #1
1130 \draw-line #'(0 . 4)
1131 \arrow-head #Y #DOWN ##f
1136 @cindex grafica inclusa
1137 @cindex immagini incluse
1142 @funindex \postscript
1143 @funindex postscript
1145 Le funzionalità grafiche avanzate comprendono la possibilità di includere
1146 file di immagini convertite nel formato Encapsulated PostScript
1147 (@emph{eps}), oppure di inserire la grafica direttamente nel file di input,
1148 usando del codice PostScript nativo. In tal caso, può essere utile specificare
1149 esplicitamente la dimensione del disegno, come è mostrato sotto:
1151 @lilypond[quote,verbatim,fragment]
1154 \epsfile #X #10 #"./context-example.eps"
1155 \with-dimensions #'(0 . 6) #'(0 . 10)
1171 Una lista completa dei comandi specifici per la grafica si trova in
1175 Guida alla notazione:
1178 @ref{Editorial annotations},
1182 @file{scm/define-markup-commands.scm},
1183 @file{scm/stencil.scm}.
1188 Guida al funzionamento interno:
1189 @rinternals{TextScript}.
1192 @node Notazione musicale nel blocco markup
1193 @unnumberedsubsubsec Notazione musicale nel blocco markup
1194 @translationof Music notation inside markup
1196 @cindex notazione dentro il blocco markup
1197 @cindex musica dentro il blocco markup
1198 @cindex markup, notazione musicale dentro
1200 Si possono aggiungere vari elementi della notazione musicale dentro un
1203 Per le note e le alterazioni esistono dei comandi markup appositi:
1205 @lilypond[quote,verbatim,fragment]
1209 \note-by-number #1 #1 #1.5
1212 \natural \semiflat \flat
1213 \sesquiflat \doubleflat
1217 \natural \semisharp \sharp
1218 \sesquisharp \doublesharp
1223 Anche altri oggetti della notazione possono essere stampati in
1226 @lilypond[quote,verbatim]
1229 ees\finger \markup \tied-lyric #"4~1"
1230 fis_\markup { \dynamic rf }
1242 Più in generale, qualsiasi simbolo musicale disponibile può essere incluso
1243 separatamente in un oggetto markup, come è illustrato sotto. Una lista
1244 completa di questi simboli e dei loro nomi si trova in
1245 @ref{The Feta font}.
1247 @lilypond[quote,verbatim]
1250 c'^\markup { \musicglyph #"eight" }
1252 c,8._\markup { \musicglyph #"clefs.G_change" }
1254 c2^\markup { \musicglyph #"timesig.neomensural94" }
1258 Un altro modo per stampare glifi non testuali è descritto in
1259 @ref{Fonts explained}. È utile per stampare parentesi di varie
1262 La modalità markup supporta anche i diagrammi per strumenti specifici:
1264 @lilypond[quote,verbatim]
1267 \fret-diagram-terse #"x;x;o;2;3;2;"
1270 \harp-pedal #"^-v|--ov^"
1275 \musicglyph #"accordion.discant"
1277 \raise #0.5 \musicglyph #"accordion.dot"
1278 \raise #1.5 \musicglyph #"accordion.dot"
1283 @c The accordion diagram is actually taken from a snippet.
1286 Questi diagrammi sono documentati in @ref{Instrument Specific Markup}.
1288 @cindex partitura dentro il blocco markup
1289 @cindex markup, partitura dentro
1291 È possibile annidare perfino un'intera partitura in un oggetto markup. In tal
1292 caso, il blocco @code{\score} annidato deve contenere un blocco @code{\layout},
1293 come è illustrato qui:
1295 @lilypond[quote,verbatim]
1299 \relative { c'4 d e f }
1308 Una lista completa dei comandi relativi alla notazione musicale si trova
1312 Guida alla notazione:
1314 @ref{The Feta font},
1315 @ref{Fonts explained}.
1318 @file{scm/define-markup-commands.scm},
1319 @file{scm/fret-diagrams.scm},
1320 @file{scm/harp-pedals.scm}.
1325 Guida al funzionamento interno:
1326 @rinternals{TextScript}.
1329 @node Testo formattato su più pagine
1330 @unnumberedsubsubsec Testo formattato su più pagine
1331 @translationof Multi-page markup
1333 @cindex testo formattato su più pagine
1334 @cindex markup, multipagina
1335 @cindex multipagina, testo
1336 @cindex testo esteso su più pagine
1338 @funindex \markuplist
1339 @funindex markuplist
1340 @funindex \justified-lines
1341 @funindex justified-lines
1342 @funindex \wordwrap-lines
1343 @funindex wordwrap-lines
1345 Sebbene gli oggetti di markup standard non possano avere interruzioni, una
1346 specifica sintassi permette di inserire linee di testo che possono estendersi
1349 @lilypond[quote,verbatim]
1352 Un testo molto lungo di linee giustificate.
1356 Un altro paragrafo molto lungo.
1363 Questa sintassi accetta una lista di oggetti di markup, che possono essere
1366 il risultato di un comando \markuplist,
1368 una lista di markup,
1370 una lista di \markuplists.
1373 Una lista completa dei comandi che si possono usare con \markuplist si
1374 trova in @ref{Text markup list commands}.
1377 Guida alla notazione:
1378 @ref{Text markup list commands}.
1381 @rextend{New markup list command definition}.
1384 @file{scm/define-markup-commands.scm}.
1389 Guida al funzionamento interno:
1390 @rinternals{TextScript}.
1392 @funindex \markuplist
1393 @funindex markuplist
1400 @node Tipi di carattere
1401 @subsection Tipi di carattere
1402 @translationof Fonts
1404 Questa sezione presenta il modo in cui sono gestiti i tipi di carattere e come
1405 possono essere modificati nelle partiture.
1408 * Tipi di carattere in dettaglio::
1409 * Tipi di carattere per singolo oggetto::
1410 * Tipi di carattere per l'intero documento::
1413 @node Tipi di carattere in dettaglio
1414 @unnumberedsubsubsec Tipi di carattere in dettaglio
1415 @translationof Fonts explained
1418 @cindex tipi di carattere
1420 @cindex graffe, varie dimensioni
1421 @cindex font non testuali nel markup
1423 @funindex font-interface
1425 I tipi di carattere vengono gestiti attraverso varie librerie. FontConfig
1426 rileva i tipi di carattere disponibili nel sistema; i tipi selezionati
1427 sono riprodotti con Pango.
1429 I tipi di carattere della notazione musicale possono essere descritti
1430 come un insieme di glifi specifici, ordinati in varie famiglie. La
1431 seguente sintassi permette di usare vari caratteri @code{feta} di LilyPond
1432 (non testuali) direttamente nella modalità markup:
1434 @lilypond[quote,verbatim,fragment]
1437 \override #'(font-encoding . fetaBraces)
1439 \override #'(font-encoding . fetaText)
1441 \override #'(font-encoding . fetaMusic)
1442 \lookup #"noteheads.s0petrucci"
1448 Tuttavia, tutti questi glifi, ad eccezione delle graffe di varie
1449 dimensioni contenute in @code{fetaBraces}, sono già utilizzabili
1450 con la sintassi ben più semplice descritta in @ref{Music notation inside markup}.
1452 Quando si usano i glifi contenuti in @code{fetaBraces}, la dimensione
1453 della graffa viene specificata dalla parte numerica del nome del glifo,
1454 in unità arbitrarie. Può essere specificato qualsiasi numero intero da
1455 @code{0} a @code{575} compresi, dove @code{0} corrisponde alla graffa
1456 più piccola. Il valore ottimale deve essere determinato per tentativi.
1457 Questi glifi sono tutte graffe sinistre; le graffe destre si possono
1458 ottenere con la rotazione, vedi @ref{Rotating objects}.
1460 Sono disponibili tre famiglie di tipi di carattere: il @emph{roman}
1461 (con grazie), che usa di default New Century Schoolbook, il
1462 @emph{sans} (senza grazie) e il tipo monospaziato @emph{typewriter} -- queste
1463 ultime due famiglie sono determinate dall'installazione di Pango.
1465 @warning{Non ci sono tipi predefiniti associati con le famiglie @emph{sans}
1466 e @emph{typewriter}. Un file di input che usa una di queste famiglie
1467 può produrre output diversi su computer diversi. Per garantire un output
1468 coerente su piattaforme diverse, occorre specificare i tipi di carattere
1469 per nome e quei tipi devono essere presenti in qualsiasi sistema che
1470 elabori il file. Si veda @ref{Single entry fonts} e
1471 @ref{Entire document fonts}.}
1473 Ogni famiglia può avere forme e serie differenti. L'esempio seguente
1474 illustra la possibilità di scegliere famiglie, forme, serie e
1475 dimensioni alternative. Il valore specificato per @code{font-size} è
1476 la modifica relativa alla dimensione predefinita.
1478 @lilypond[quote,verbatim,fragment]
1479 \override Score.RehearsalMark.font-family = #'typewriter
1480 \mark \markup "Ouverture"
1481 \override Voice.TextScript.font-shape = #'italic
1482 \override Voice.TextScript.font-series = #'bold
1483 d''2.^\markup "Allegro"
1484 \override Voice.TextScript.font-size = #-3
1489 Una sintassi simile si usa nella modalità markup; tuttavia in questo
1490 caso è preferibile usare la sintassi più semplice spiegata in
1491 @ref{Selecting font and font size}:
1493 @lilypond[quote,verbatim]
1497 \override #'(font-shape . italic)
1498 \override #'(font-size . 4)
1502 \override #'(font-family . typewriter)
1504 \override #'(font-series . bold)
1508 \override #'(font-family . sans)
1515 Sebbene sia semplice passare a un tipo di carattere preconfigurato, è anche
1516 possibile usare altri tipi, come viene spiegato nelle sezioni successive:
1517 @ref{Single entry fonts} e @ref{Entire document fonts}.
1520 Guida alla notazione:
1521 @ref{The Feta font},
1522 @ref{Music notation inside markup},
1523 @ref{Rotating objects},
1524 @ref{Selecting font and font size},
1528 @node Tipi di carattere per singolo oggetto
1529 @unnumberedsubsubsec Tipi di carattere per singolo oggetto
1530 @translationof Single entry fonts
1532 Si può usare nella partitura qualsiasi tipo di carattere che sia installato
1533 nel sistema operativo e riconosciuto da FontConfig, usando la seguente
1536 @lilypond[quote,verbatim,fragment]
1537 \override Staff.TimeSignature.font-name = #"Bitstream Charter"
1538 \override Staff.TimeSignature.font-size = #2
1542 \override #'(font-name . "Bitstream Vera Sans,sans-serif, Oblique Bold")
1543 { Vera Oblique Bold }
1547 @cindex tipi di carattere, trovare quelli disponibili
1548 @cindex trovare i tipi di carattere disponibili
1549 @cindex elencare i tipi di carattere disponibili
1550 @cindex tipi di carattere disponibili, elenco
1552 @funindex show-available-fonts
1554 Lanciando lilypond con la seguente opzione si ottiene un elenco di tutti i
1555 tipi di carattere disponibili nel sistema operativo:
1558 lilypond -dshow-available-fonts x
1562 Guida alla notazione:
1563 @ref{Fonts explained},
1564 @ref{Entire document fonts}.
1569 @c A source file gets never installed...
1571 @c @file{lily/font-config-scheme.cc}.
1574 @node Tipi di carattere per l'intero documento
1575 @unnumberedsubsubsec Tipi di carattere per l'intero documento
1576 @translationof Entire document fonts
1578 È possibile modificare i tipi di carattere usati come tipi predefiniti
1579 nelle famiglie @emph{roman}, @emph{sans} e @emph{typewriter} specificandoli, in
1580 questo ordine, come è mostrato nell'esempio seguente, che ridimensiona
1581 automaticamente i caratteri col valore impostato per la dimensione globale
1582 del rigo. I tipi di carattere sono spiegati in @ref{Fonts explained}.
1584 @cindex famiglie di tipi di carattere, impostare
1585 @cindex tipi di carattere, modificarli per l'intero documento
1587 @funindex make-pango-font-tree
1589 @lilypond[verbatim,quote]
1592 (make-pango-font-tree "Times New Roman"
1595 (/ staff-height pt 20)))
1602 \typewriter typewriter. }
1606 @c we don't do Helvetica / Courier, since GS incorrectly loads
1610 Guida alla notazione:
1611 @ref{Fonts explained},
1612 @ref{Single entry fonts},
1613 @ref{Selecting font and font size},