1 @c -*- coding: utf-8; mode: texinfo; -*-
3 Translation of GIT committish: 640edfbe2c332ccd7ddedc819106d001eed51c76
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{Direzione e posizionamento}.
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{Formattazione del testo}.
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{Articolazioni e abbellimenti}.
97 Per maggiori informazioni sull'ordinamento relativo delle scritte e delle
98 articolazioni si veda @rlearning{Posizionamento degli oggetti}.
100 @funindex \textLengthOn
101 @funindex \textLengthOff
104 @code{\textLengthOn},
105 @code{\textLengthOff}.
109 Manuale d'apprendimento:
110 @rlearning{Posizionamento degli oggetti}.
112 Guida alla notazione:
113 @ref{Formattazione del testo},
114 @ref{Direzione e posizionamento},
115 @ref{Articolazioni e abbellimenti}.
120 Guida al funzionamento interno:
121 @rinternals{TextScript}.
123 @cindex testo fuori dal margine
124 @cindex margine, testo che va oltre
125 @cindex testo, tenerlo dentro il margine
126 @cindex testo vocale, tenerlo dentro il margine
129 Per verificare che le scritte e il testo vocale siano entro i margini
130 occorrono ulteriori calcoli. Nei casi in cui è richiesta un'esecuzione
131 leggermente più veloce, usare
134 \override Score.PaperColumn.keep-inside-line = ##f
138 @node Estensori del testo
139 @unnumberedsubsubsec Estensori del testo
140 @translationof Text spanners
142 @cindex estensori del testo
144 Alcune indicazioni esecutive, per esempio @notation{rallentando} o
145 @notation{accelerando}, appaiono in forma testuale e vengono estese
146 lungo molteplici note con delle linee punteggiate. Tali oggetti,
147 chiamati @qq{estensori} (spanner), si creano collegando due note
148 con la seguente sintassi:
150 @lilypond[verbatim,quote]
152 \override TextSpanner.bound-details.left.text = "rit."
158 @cindex estensori del testo, formattazione
159 @cindex formattare gli estensori del testo
162 La stringa testuale da stampare viene impostata attraverso le proprietà
163 dell'oggetto. Per impostazione predefinita, appare in corsivo, ma si
164 può ottenere una formattazione diversa tramite i blocchi @code{\markup}, come
165 è spiegato in @ref{Formattazione del testo}.
167 @lilypond[quote,verbatim]
169 \override TextSpanner.bound-details.left.text =
170 \markup { \upright "rit." }
176 Lo stile della linea, così come la stringa testuale, può essere definito come
177 una proprietà dell'oggetto. Questa sintassi è descritta in @ref{Line styles}.
179 @funindex \textSpannerUp
180 @funindex \textSpannerDown
181 @funindex \textSpannerNeutral
185 @code{\textSpannerUp},
186 @code{\textSpannerDown},
187 @code{\textSpannerNeutral}.
191 LilyPond è capace di gestire un solo estensore del testo per ogni voce.
195 @lilypondfile[verbatim,quote,texidoc,doctitle]
196 {dynamics-text-spanner-postfix.ly}
198 @lilypondfile[verbatim,quote,texidoc,doctitle]
199 {dynamics-custom-text-spanner-postfix.ly}
202 Guida alla notazione:
205 @ref{Formattazione del testo}.
209 @rlsr{Expressive marks}.
211 Guida al funzionamento interno:
212 @rinternals{TextSpanner}.
215 @node Indicazioni testuali
216 @unnumberedsubsubsec Indicazioni testuali
217 @translationof Text marks
220 @cindex indicazioni testuali
221 @cindex testo, indicazioni
222 @cindex testo sulla stanghetta
223 @cindex coda sulla stanghetta
224 @cindex segno sulla stanghetta
225 @cindex corona sulla stanghetta
226 @cindex stanghette, simboli sulle
231 Si possono aggiungere vari elementi testuali a una partitura tramite la
232 sintassi descritta in @ref{Rehearsal marks}:
234 @c \mark needs to be placed on a separate line (it's not
235 @c attached to an object like \markup is). -vv
237 @lilypond[verbatim,quote]
248 Questa sintassi permette di porre del testo sopra una stanghetta;
249 una formattazione del testo più complessa è possibile grazie al
250 blocco @code{\markup}, come è spiegato in @ref{Formattazione del testo}:
252 @lilypond[quote,verbatim]
255 \mark \markup { \italic { colla parte } }
262 Questa sintassi permette anche di stampare segni speciali, come coda, segno
263 o corona, se si specifica il nome appropriato del simbolo, come è spiegato
264 in @ref{Music notation inside markup}:
266 @lilypond[quote,verbatim]
269 \mark \markup { \musicglyph #"scripts.ufermata" }
275 Tali oggetti vengono posizionati soltanto sopra il rigo superiore della
276 partitura; a seconda che siano inseriti alla fine o a metà di una battuta,
277 possono trovarsi sopra la stanghetta o tra le note. Se inserito prima di
278 un'interruzione di linea, l'indicazione apparirà all'inizio della linea
281 @lilypond[quote,verbatim,ragged-right]
290 @funindex \markLengthOn
291 @funindex \markLengthOff
294 @code{\markLengthOn},
295 @code{\markLengthOff}.
300 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
301 {printing-marks-at-the-end-of-a-line.ly}
303 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
304 {printing-marks-on-every-staff.ly}
307 Guida alla notazione:
308 @ref{Rehearsal marks},
309 @ref{Formattazione del testo},
310 @ref{Music notation inside markup},
311 @ref{Il font Emmentaler}.
316 Guida al funzionamento interno:
317 @rinternals{MarkEvent},
318 @rinternals{Mark_engraver},
319 @rinternals{RehearsalMark}.
323 @unnumberedsubsubsec Testo separato
324 @translationof Separate text
326 @cindex testo separato
327 @cindex testo indipendente
328 @cindex testo al livello superiore
332 Un blocco @code{\markup} può esistere di per sé, fuori da qualsiasi
333 blocco @code{\score}, come un'@tie{@qq{espressione di livello superiore}}. Questa
334 sintassi è descritta in @ref{File structure}.
336 @lilypond[verbatim,quote]
338 Tomorrow, and tomorrow, and tomorrow...
343 Ciò permette di stampare il testo in modo autonomo dalla musica, ed è
344 utile soprattutto quando il file di input contiene vari brani musicali,
345 come è spiegato in @ref{Multiple scores in a book}.
347 @lilypond[quote,verbatim]
352 Tomorrow, and tomorrow, and tomorrow...
359 Blocchi di testo separati possono essere estesi per molte pagine, rendendo
360 possibile la realizzazione di documenti o libri interamente con LilyPond.
361 Questa funzionalità, e la sintassi specifica che richiede, è descritta
362 in @ref{Multi-page markup}.
365 @funindex \markuplist
375 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
376 {stand-alone-two-column-markup.ly}
379 Guida alla notazione:
380 @ref{Formattazione del testo},
381 @ref{File structure},
382 @ref{Multiple scores in a book},
383 @ref{Multi-page markup}.
388 Guida al funzionamento interno:
389 @rinternals{TextScript}.
392 @node Formattazione del testo
393 @subsection Formattazione del testo
394 @translationof Formatting text
396 Questa sezione presenta la formattazione del testo basilare e quella avanzata,
397 usando la sintassi specifica della modalità @code{\markup}.
400 * Introduzione al testo a margine::
401 * Scelta del tipo di carattere e della dimensione::
402 * Allineamento del testo::
403 * Notazione grafica nel blocco markup::
404 * Notazione musicale nel blocco markup::
405 * Testo formattato su più pagine::
408 @node Introduzione al testo a margine
409 @unnumberedsubsubsec Introduzione al testo a margine
410 @translationof Text markup introduction
413 @cindex testo a margine
418 Un blocco @code{\markup} permette di comporre del testo con un'ampia
419 sintassi chiamata @qq{modalità markup}.
421 @cindex markup, espressioni
422 @cindex espressioni di markup
423 @cindex sintassi di markup
424 @cindex markup, sintassi
426 La sintassi di markup è simile alla solita sintassi di LilyPond: un'espressione
427 @code{\markup} viene racchiusa tra parentesi graffe @code{@{@dots{} @}}. Una
428 singola parola viene considerata un'espressione minima, e quindi non è
429 necessario racchiuderla tra parentesi.
431 Diversamente dalle indicazioni testuali @qq{tra virgolette}, i blocchi
432 @code{\markup} possono contenere espressioni o comandi di markup annidati,
433 inseriti col carattere di barra inversa @code{\}. Tali comandi hanno
434 effetto solo sulla prima espressione che segue.
436 @lilypond[quote,verbatim]
439 a2^\markup { poco \italic più forte }
441 d2_\markup { \italic "string. assai" }
443 b1^\markup { \bold { molto \italic agitato } }
448 @cindex caratteri speciali in modalità markup
449 @cindex modalità markup, caratteri speciali
450 @cindex caratteri riservati, stampare
451 @cindex stampare i caratteri riservati
452 @cindex stampare i caratteri speciali
453 @cindex testo tra virgolette in modalità markup
454 @cindex modalità markup, testo tra virgolette
456 Un blocco @code{\markup} può contenere anche stringhe di testo tra
457 virgolette. Tali stringhe vengono trattate come espressioni testuali
458 minime, e quindi qualsiasi comando di markup o carattere speciale
459 (come @code{\} e@tie{}@code{#}) apparirà alla lettera senza influenzare
460 la formattazione del testo. Le stesse doppie virgolette possono essere
461 stampate facendole precedere da una barra inversa.
463 @lilypond[quote,verbatim]
465 a'1^"\italic markup..."
466 a_\markup { \italic "... prints \"italic\" letters!" }
471 Perché sia trattata come un'espressione distinta, una lista di parole deve
472 essere racchiusa tra virgolette doppie o preceduta da un comando. Il modo
473 in cui le espressioni musicali sono definite influenza il modo in cui
474 saranno sistemate, centrate e allineate; nell'esempio seguente, la seconda
475 espressione di @code{\markup} viene trattata nello stesso modo della prima:
477 @lilypond[quote,verbatim]
479 c1^\markup { \center-column { a bbb c } }
480 c1^\markup { \center-column { a { bbb c } } }
481 c1^\markup { \center-column { a \line { bbb c } } }
482 c1^\markup { \center-column { a "bbb c" } }
486 I markup possono essere salvati in delle variabili, che possono poi essere
487 attaccate direttamente alle note:
489 @lilypond[quote,verbatim]
490 allegro = \markup { \bold \large Allegro }
500 Una lista completa dei comandi specifici di @code{\markup} si trova in
501 @ref{Text markup commands}.
504 Guida alla notazione:
505 @ref{Text markup commands}.
511 @file{scm/markup.scm}.
514 I messaggi di errore di sintassi relativi alla modalità markup possono
518 @node Scelta del tipo di carattere e della dimensione
519 @unnumberedsubsubsec Scelta del tipo di carattere e della dimensione
520 @translationof Selecting font and font size
522 @cindex tipi di carattere, cambiare
523 @cindex cambiare i tipi di carattere
524 @cindex font, cambiare
530 La modalità markup permette di cambiare il tipo di carattere:
532 @lilypond[quote,verbatim]
536 \italic { non troppo \underline Vivo }
539 d,_\markup { \italic quasi \smallCaps Tromba }
544 @cindex dimensione del tipo di carattere
545 @cindex tipo di carattere, dimensione
546 @cindex dimensione del testo
547 @cindex testo, dimensione
549 @funindex \abs-fontsize
555 Si può modificare la dimensione del tipo di carattere, rispetto alla
556 dimensione globale del rigo, in vari modi.
558 Si può impostare su una dimensione predefinita.
560 @lilypond[quote,verbatim]
562 b1_\markup { \huge Sinfonia }
563 b1^\markup { \teeny da }
564 b1-\markup { \normalsize camera }
568 oppure in modo proporzionale rispetto al valore precedente.
570 @lilypond[quote,verbatim]
572 b1_\markup { \larger Sinfonia }
573 b1^\markup { \smaller da }
574 b1-\markup { \magnify #0.6 camera }
578 Può essere aumentata o diminuita rispetto al valore impostato per la
579 dimensione globale del rigo.
581 @lilypond[quote,verbatim]
583 b1_\markup { \fontsize #-2 Sinfonia }
584 b1^\markup { \fontsize #1 da }
585 b1-\markup { \fontsize #3 camera }
589 Si può impostare anche su una dimensione fissa (in punti), indipendentemente
590 dalla dimensione globale del rigo.
592 @lilypond[quote,verbatim]
594 b1_\markup { \abs-fontsize #20 Sinfonia }
595 b1^\markup { \abs-fontsize #8 da }
596 b1-\markup { \abs-fontsize #14 camera }
600 Se il testo contiene degli spazi, è meglio racchiuderlo tutto tra virgolette,
601 in modo che la dimensione di ciascun spazio sia adatta alla dimensione degli
604 @lilypond[quote,verbatim]
605 \markup \fontsize #6 \bold { Sinfonia da camera }
606 \markup \fontsize #6 \bold { "Sinfonia da camera" }
614 @funindex \normal-size-super
616 È possibile stampare il testo come pedice o apice. Per impostazione
617 predefinita, questo appaiono in corpo più piccolo, ma si può usare
618 anche un corpo normale:
620 @lilypond[quote,verbatim]
623 \line { 1 \super st movement }
624 \line { 1 \normal-size-super st movement
625 \sub { (part two) } }
630 @cindex famiglie di tipi di carattere
631 @cindex tipi di carattere, famiglie
633 La modalità di markup fornisce un modo semplice per scegliere famiglie
634 di caratteri diverse. Se non specificato altrimenti, viene scelto
635 automaticamente il carattere tipografico con grazie (il tipo romano);
636 nell'ultima linea dell'esempio seguente non c'è differenza tra la
637 prima e la seconda parola.
639 @lilypond[quote,verbatim]
642 \line { Act \number 1 }
643 \line { \sans { Scene I. } }
644 \line { \typewriter { Verona. An open place. } }
645 \line { Enter \roman Valentine and Proteus. }
651 Alcune di queste famiglie di caratteri, usate per elementi specifici come i
652 numeri o le dinamiche, non forniscono tutti i caratteri, come accennato in
653 @ref{New dynamic marks} e @ref{Manual repeat marks}.
655 @c \concat is actually documented in Align (it is not
656 @c a font-switching command). But we need it here. -vv
658 Se usati all'interno di una parola, alcuni comandi che cambiano il tipo di
659 carattere o la formattazione potrebbero produrre uno spazio vuoto
660 indesiderato. Si può facilmente risolvere concatenando insieme gli
663 @lilypond[quote,verbatim]
667 \concat { 1 \super st }
671 \concat { \dynamic p , }
672 \italic { con dolce espressione }
678 Una lista completa dei comandi per cambiare il tipo di carattere o per usare
679 tipi di carattere personalizzati si trova in @ref{Font}.
681 È possibile anche definire i propri gruppi di tipi di carattere, come
682 è spiegato in @ref{Fonts}.
687 @funindex \normalsize
706 Guida alla notazione:
708 @ref{New dynamic marks},
709 @ref{Manual repeat marks},
713 @file{scm/define-markup-commands.scm}.
718 Guida al funzionamento interno:
719 @rinternals{TextScript}.
722 L'uso dei comandi di dimensionamento dei caratteri @code{\teeny}, @code{\tiny},
723 @code{\small}, @code{\normalsize}, @code{\large} e @code{\huge} produce
724 una spaziatura della linea imprevedibile rispetto all'uso di @code{\fontsize}.
727 @node Allineamento del testo
728 @unnumberedsubsubsec Allineamento del testo
729 @translationof Text alignment
731 @cindex testo, allineamento
732 @cindex allineare il testo
733 @cindex allineare il markup
734 @cindex markup, allineare
736 Questa sottosezione spiega come posizionare il testo nella modalità
737 markup. Gli oggetti markup possono anche essere spostati interamente
738 tramite la sintassi descritta in @rlearning{Spostare gli oggetti}.
740 @c Padding commands should be mentioned on this page, but
741 @c most of these require \box to be more clearly illustrated. -vv
743 @cindex testo, allineamento orizzontale
744 @cindex allineamento orizzontale del testo
746 @funindex \left-align
747 @funindex \center-align
748 @funindex \right-align
750 Gli oggetti di markup possono essere allineati in vari modi. Per impostazione
751 predefinita, l'indicazione testuale è allineata rispetto al suo margine
752 sinistro: nell'esempio seguente, non c'è differenza tra il primo e il
755 @lilypond[quote,verbatim]
757 d''1-\markup { poco }
759 d-\markup { \left-align poco }
761 d-\markup { \center-align { poco } }
763 d-\markup { \right-align poco }
769 L'allineamento orizzontale può essere ritoccato usando un valore numerico:
771 @lilypond[quote,verbatim]
773 a'1-\markup { \halign #-1 poco }
775 a,-\markup { \halign #0 poco }
777 a,-\markup { \halign #0.5 poco }
779 a,-\markup { \halign #2 poco }
784 Alcuni oggetti possono avere proprie procedure di allineamento, e dunque
785 non sono influenzate da questi comandi. È possibile spostare tali
786 oggetti di markup tutti insieme, come mostrato ad esempio in
789 @cindex testo, allineamento verticale
790 @cindex allineamento verticale del testo
796 @c QUERY Should the function of ``\null'' be clarified? rp
798 L'allineamento verticale è un po' più complesso. Come si è detto prima, gli
799 oggetti di markup possono essere spostati tutti insieme; tuttavia è anche
800 possibile spostare elementi specifici all'interno di un blocco markup. In
801 questo caso l'elemento da spostare deve essere preceduto da un @emph{punto di riferimento}, che
802 può essere un altro elemento markup o un oggetto invisibile. L'esempio seguente
803 illustra queste due possibilità; l'ultimo markup in questo esempio non ha un
804 punto di riferimento e di conseguenza non si muove.
806 @lilypond[quote,verbatim]
810 \raise #2 { Scène 1 }
815 \lower #4 \bold { Très modéré }
819 \raise #4 \italic { Une forêt. }
825 @funindex \general-align
827 @funindex \translate-scaled
829 Alcuni comandi possono cambiare l'allineamento sia orizzontale che verticale
830 degli oggetti testuali in modalità markup. Qualsiasi oggetto interessato
831 da questi comandi deve essere preceduto da un punto di riferimento:
833 @lilypond[quote,verbatim]
837 \translate #'(-1 . 2) "Scène 1"
842 \general-align #Y #3.2 \bold "Très modéré"
847 \translate-scaled #'(-1 . 2) \teeny "Une forêt."
853 @cindex markup multilinea
854 @cindex multilinea, markup
855 @cindex testo multilinea
856 @cindex multilinea, testo
857 @cindex testo in colonne
858 @cindex colonne, testo
861 @funindex \center-column
863 Un oggetto markup può includere varie linee di testo. Nell'esempio
864 seguente, ogni elemento o espressione viene posizionato sulla sua
865 linea, allineato a sinistra o centrato:
867 @lilypond[quote,verbatim]
883 @cindex centrare il testo sulla pagina
884 @cindex testo, centrare sulla pagina
885 @cindex markup, centrare sulla pagina
889 Analogalmente, una lista di elementi o espressioni può essere distesa
890 per riempire l'intera larghezza orizzontale della linea (se c'è un solo
891 elemento, verrà centrato sulla pagina). Queste espressioni possono
892 a loro volta includere del testo multilinea o una qualsiasi altra
893 espressione di markup:
895 @lilypond[quote,verbatim]
898 \line { William S. Gilbert }
900 \huge \smallCaps "The Mikado"
902 \smallCaps "The Town of Titipu"
904 \line { Sir Arthur Sullivan }
912 @cindex testo a capo automaticamente
913 @cindex testo giustificato
914 @cindex giustificato, testo
915 @cindex a capo, testo
916 @cindex markup, testo a capo
917 @cindex markup, testo giustificato
922 Indicazioni testuali lunghe possono andare a capo automaticamente in base
923 alla larghezza della linea specificata. Possono essere allineate a
924 sinistra o giustificate, come mostra l'esempio seguente.
926 @lilypond[quote,verbatim]
929 \line \smallCaps { La vida breve }
930 \line \bold { Acto I }
932 (La escena representa el corral de una casa de
933 gitanos en el Albaicín de Granada. Al fondo una
934 puerta por la que se ve el negro interior de
935 una Fragua, iluminado por los rojos resplandores
940 \line \bold { Acto II }
941 \override #'(line-width . 50)
943 (Calle de Granada. Fachada de la casa de Carmela
944 y su hermano Manuel con grandes ventanas abiertas
945 a través de las que se ve el patio
946 donde se celebra una alegre fiesta)
952 @cindex testo, comandi di allineamento del
953 @cindex markup, comandi di allineamento del testo
954 @cindex allineamento, testo, comandi
956 Una lista completa dei comandi di allineamento del testo si trova in
960 Manuale d'apprendimento:
961 @rlearning{Spostare gli oggetti}.
963 Guida alla notazione:
968 @file{scm/define-markup-commands.scm}.
973 Guida al funzionamento interno:
974 @rinternals{TextScript}.
977 @node Notazione grafica nel blocco markup
978 @unnumberedsubsubsec Notazione grafica nel blocco markup
979 @translationof Graphic notation inside markup
981 @cindex grafica, inclusione
982 @cindex disegnare oggetti grafici
983 @cindex oggetti grafici, disegnare
984 @cindex oggetti grafici incorporati
985 @cindex oggetti grafici, includere
987 Si possono aggiungere vari oggetti grafici a una partitura attraverso
990 @cindex decorazione del testo
991 @cindex incorniciatura del testo
992 @cindex testo, incorniciatura
993 @cindex testo, decorazione
994 @cindex markup, decorazione
995 @cindex markup, incorniciatura
999 @funindex \rounded-box
1003 Alcuni comandi di markup consentono di decorare gli elementi testuali con
1004 degli elementi grafici, come è illustrato nell'esempio seguente.
1006 @lilypond[quote,verbatim]
1007 \markup \fill-line {
1015 \bracket "1866 - 1925"
1018 \rounded-box \bold Prelude
1023 @cindex padding intorno al testo
1024 @cindex testo, padding
1025 @cindex markup, padding
1027 @funindex \pad-markup
1029 @funindex \pad-to-box
1030 @funindex \pad-around
1032 Alcuni comandi possono richiedere un aumento del padding intorno al
1033 testo; per farlo si usano dei comandi di markup, descritti in modo
1034 esaustivo in @ref{Align}.
1036 @lilypond[quote,verbatim]
1037 \markup \fill-line {
1039 \box "Charles Ives (1874 - 1954)"
1041 \box \pad-markup #2 "THE UNANSWERED QUESTION"
1042 \box \pad-x #8 "A Cosmic Landscape"
1049 \box \pad-to-box #'(-5 . 20) #'(0 . 5)
1050 \bold "Largo to Presto"
1053 "String quartet keeps very even time,
1054 Flute quartet keeps very uneven time."
1058 @cindex notazione grafica
1059 @cindex simboli non musicali
1062 @funindex \draw-circle
1063 @funindex \filled-box
1065 @funindex \draw-line
1066 @funindex \arrow-head
1068 Si possono produrre altri elementi grafici o simboli che non richiedono
1069 alcun testo. Come con qualsiasi espressione di markup, tali oggetti
1070 possono essere combinati.
1072 @lilypond[quote,verbatim]
1075 \draw-circle #4 #0.4 ##f
1076 \filled-box #'(-4 . 4) #'(-0.5 . 0.5) #1
1082 \draw-line #'(0 . 4)
1083 \arrow-head #Y #DOWN ##f
1088 @cindex grafica inclusa
1089 @cindex immagini incluse
1093 @funindex \postscript
1095 Le funzionalità grafiche avanzate comprendono la possibilità di includere
1096 file di immagini convertite nel formato Encapsulated PostScript
1097 (@emph{eps}), oppure di inserire la grafica direttamente nel file di input,
1098 usando del codice PostScript nativo. In tal caso, può essere utile specificare
1099 esplicitamente la dimensione del disegno, come è mostrato sotto:
1101 @lilypond[quote,verbatim,fragment]
1104 \epsfile #X #10 #"./context-example.eps"
1105 \with-dimensions #'(0 . 6) #'(0 . 10)
1121 Una lista completa dei comandi specifici per la grafica si trova in
1125 Guida alla notazione:
1128 @ref{Note editoriali},
1132 @file{scm/define-markup-commands.scm},
1133 @file{scm/stencil.scm}.
1138 Guida al funzionamento interno:
1139 @rinternals{TextScript}.
1142 @node Notazione musicale nel blocco markup
1143 @unnumberedsubsubsec Notazione musicale nel blocco markup
1144 @translationof Music notation inside markup
1146 @cindex notazione dentro il blocco markup
1147 @cindex musica dentro il blocco markup
1148 @cindex markup, notazione musicale dentro
1150 Si possono aggiungere vari elementi della notazione musicale dentro un
1153 Per le note e le alterazioni esistono dei comandi markup appositi:
1155 @lilypond[quote,verbatim,fragment]
1159 \note-by-number #1 #1 #1.5
1162 \natural \semiflat \flat
1163 \sesquiflat \doubleflat
1167 \natural \semisharp \sharp
1168 \sesquisharp \doublesharp
1173 Anche altri oggetti della notazione possono essere stampati in
1176 @lilypond[quote,verbatim]
1179 ees\finger \markup \tied-lyric #"4~1"
1180 fis_\markup { \dynamic rf }
1192 Più in generale, qualsiasi simbolo musicale disponibile può essere incluso
1193 separatamente in un oggetto markup, come è illustrato sotto. Una lista
1194 completa di questi simboli e dei loro nomi si trova in
1195 @ref{Il font Emmentaler}.
1197 @lilypond[quote,verbatim]
1200 c'^\markup { \musicglyph #"eight" }
1202 c,8._\markup { \musicglyph #"clefs.G_change" }
1204 c2^\markup { \musicglyph #"timesig.neomensural94" }
1208 Un altro modo per stampare glifi non testuali è descritto in
1209 @ref{Fonts explained}. È utile per stampare parentesi di varie
1212 La modalità markup supporta anche i diagrammi per strumenti specifici:
1214 @lilypond[quote,verbatim]
1217 \fret-diagram-terse #"x;x;o;2;3;2;"
1220 \harp-pedal #"^-v|--ov^"
1225 \musicglyph #"accordion.discant"
1227 \raise #0.5 \musicglyph #"accordion.dot"
1228 \raise #1.5 \musicglyph #"accordion.dot"
1233 @c The accordion diagram is actually taken from a snippet.
1236 Questi diagrammi sono documentati in @ref{Instrument Specific Markup}.
1238 @cindex partitura dentro il blocco markup
1239 @cindex markup, partitura dentro
1241 È possibile annidare perfino un'intera partitura in un oggetto markup. In tal
1242 caso, il blocco @code{\score} annidato deve contenere un blocco @code{\layout},
1243 come è illustrato qui:
1245 @lilypond[quote,verbatim]
1249 \relative { c'4 d e f }
1258 Una lista completa dei comandi relativi alla notazione musicale si trova
1262 Guida alla notazione:
1264 @ref{Il font Emmentaler},
1265 @ref{Fonts explained}.
1268 @file{scm/define-markup-commands.scm},
1269 @file{scm/fret-diagrams.scm},
1270 @file{scm/harp-pedals.scm}.
1275 Guida al funzionamento interno:
1276 @rinternals{TextScript}.
1279 @node Testo formattato su più pagine
1280 @unnumberedsubsubsec Testo formattato su più pagine
1281 @translationof Multi-page markup
1283 @cindex testo formattato su più pagine
1284 @cindex markup, multipagina
1285 @cindex multipagina, testo
1286 @cindex testo esteso su più pagine
1288 @funindex \markuplist
1289 @funindex \justified-lines
1290 @funindex \wordwrap-lines
1292 Sebbene gli oggetti di markup standard non possano avere interruzioni, una
1293 specifica sintassi permette di inserire linee di testo che possono estendersi
1296 @lilypond[quote,verbatim]
1299 Un testo molto lungo di linee giustificate.
1303 Un altro paragrafo molto lungo.
1310 Questa sintassi accetta una lista di oggetti di markup, che possono essere
1313 il risultato di un comando \markuplist,
1315 una lista di markup,
1317 una lista di \markuplists.
1320 Una lista completa dei comandi che si possono usare con \markuplist si
1321 trova in @ref{Text markup list commands}.
1324 Guida alla notazione:
1325 @ref{Text markup list commands}.
1328 @rextend{New markup list command definition}.
1331 @file{scm/define-markup-commands.scm}.
1336 Guida al funzionamento interno:
1337 @rinternals{TextScript}.
1339 @funindex \markuplist
1346 @node Tipi di carattere
1347 @subsection Tipi di carattere
1348 @translationof Fonts
1350 Questa sezione presenta il modo in cui sono gestiti i tipi di carattere e come
1351 possono essere modificati nelle partiture.
1354 * Tipi di carattere in dettaglio::
1355 * Tipi di carattere per singolo oggetto::
1356 * Tipi di carattere per l'intero documento::
1359 @node Tipi di carattere in dettaglio
1360 @unnumberedsubsubsec Tipi di carattere in dettaglio
1361 @translationof Fonts explained
1364 @cindex tipi di carattere
1366 @cindex graffe, varie dimensioni
1367 @cindex font non testuali nel markup
1369 @funindex font-interface
1371 I tipi di carattere vengono gestiti attraverso varie librerie. FontConfig
1372 rileva i tipi di carattere disponibili nel sistema; i tipi selezionati
1373 sono riprodotti con Pango.
1375 I tipi di carattere della notazione musicale possono essere descritti
1376 come un insieme di glifi specifici, ordinati in varie famiglie. La
1377 seguente sintassi permette di usare vari glifi @emph{Feta} di LilyPond
1378 direttamente nella modalità markup:
1380 @lilypond[quote,verbatim,fragment]
1383 \override #'(font-encoding . fetaBraces)
1385 \override #'(font-encoding . fetaText)
1387 \override #'(font-encoding . fetaMusic)
1388 \lookup #"noteheads.s0petrucci"
1394 Tuttavia, tutti questi glifi, ad eccezione delle graffe di varie
1395 dimensioni contenute in @code{fetaBraces}, sono già utilizzabili
1396 con la sintassi ben più semplice descritta in @ref{Music notation inside markup}.
1398 Quando si usano i glifi contenuti in @code{fetaBraces}, la dimensione
1399 della graffa viene specificata dalla parte numerica del nome del glifo,
1400 in unità arbitrarie. Può essere specificato qualsiasi numero intero da
1401 @code{0} a @code{575} compresi, dove @code{0} corrisponde alla graffa
1402 più piccola. Il valore ottimale deve essere determinato per tentativi.
1403 Questi glifi sono tutte graffe sinistre; le graffe destre si possono
1404 ottenere con la rotazione, vedi @ref{Rotating objects}.
1406 Sono disponibili tre famiglie di font: il font @emph{roman} (con grazie), il
1407 font @emph{sans} (senza grazie) e il font monospaziato @emph{typewriter}.
1409 Per il backend @code{svg}:
1410 @multitable @columnfractions .15 .30
1411 @headitem Famiglia @tab Font predefinito
1412 @item @emph{roman} @tab @code{serif}
1413 @item @emph{sans} @tab @code{sans-serif}
1414 @item @emph{typewriter} @tab @code{monospace}
1417 @code{serif}, @code{sans-serif}, e @code{monospace} sono
1418 @code{generic-family} (famiglie generiche) nelle specifiche
1421 Per gli altri backend:
1422 @multitable @columnfractions .15 .30 .55
1423 @headitem Famiglia @tab Font predefinito (alias) @tab Elenchi di definizione di alias
1425 @tab @code{LilyPond Serif}
1428 C059, Century SchoolBook URW, Century Schoolbook L,
1432 @tab @code{LilyPond Sans Serif}
1435 Nimbus Sans, Nimbus Sans L, DejaVu Sans,
1437 @item @emph{typewriter}
1438 @tab @code{LilyPond Monospace}
1441 Nimbus Mono PS, Nimbus Mono, Nimbus Mono L,
1446 @code{LilyPond Serif}, @code{LilyPond Sans Serif},
1447 e @code{LilyPond Monospace} sono font alias definiti
1448 nel file di configurazione FontConfig specifico per LilyPond
1449 @code{00-lilypond-fonts.conf}.
1450 Se un carattere non esiste nel primo font elencato, il font successivo
1451 dell'elenco verrà usato al suo posto per quel carattere.
1452 I dettagli delle definizioni degli alias si trovano nel file
1453 @code{00-lilypond-fonts.conf} all'interno della directory
1456 Ogni famiglia può avere forme e serie differenti. L'esempio seguente
1457 illustra la possibilità di scegliere famiglie, forme, serie e
1458 dimensioni alternative. Il valore specificato per @code{font-size} è
1459 la modifica relativa alla dimensione predefinita.
1461 @lilypond[quote,verbatim,fragment]
1462 \override Score.RehearsalMark.font-family = #'typewriter
1463 \mark \markup "Ouverture"
1464 \override Voice.TextScript.font-shape = #'italic
1465 \override Voice.TextScript.font-series = #'bold
1466 d''2.^\markup "Allegro"
1467 \override Voice.TextScript.font-size = #-3
1472 Una sintassi simile si usa nella modalità markup; tuttavia in questo
1473 caso è preferibile usare la sintassi più semplice spiegata in
1474 @ref{Selecting font and font size}:
1476 @lilypond[quote,verbatim]
1480 \override #'(font-shape . italic)
1481 \override #'(font-size . 4)
1485 \override #'(font-family . typewriter)
1487 \override #'(font-series . bold)
1491 \override #'(font-family . sans)
1499 Quando si usano i font OpenType, sono disponibili le funzionalità
1501 Nota bene: non tutti i font OpenType hanno a disposizione tutte le funzioni.
1502 Se si richiede una funzionalità che non esiste nel font scelto, tale
1503 funzionalità viene semplicemente ignorata.
1505 @lilypond[quote,verbatim]
1507 \markup { Stile normale: Hello HELLO }
1508 \markup { \caps { Maiuscoletto: Hello } }
1509 \markup { \override #'(font-features . ("smcp"))
1510 { Maiuscoletto vero: Hello } }
1513 \markup { Stile numerico normale: 0123456789 }
1514 \markup { \override #'(font-features . ("onum"))
1515 { Stile numerico vecchio: 0123456789 } }
1517 % Alternative stilistiche
1518 \markup { \override #'(font-features . ("salt 0"))
1519 { Alternative stilistiche 0: εφπρθ } }
1520 \markup { \override #'(font-features . ("salt 1"))
1521 { Alternative stilistiche 1: εφπρθ } }
1523 % Funzionalità multiple
1524 \markup { \override #'(font-features . ("onum" "smcp" "salt 1"))
1525 { Funzionalità multiple: Hello 0123456789 εφπρθ } }
1528 @noindent L'elenco completo delle funzionalità del font OpenType è
1530 @uref{https://www.microsoft.com/typography/otspec/featurelist.htm}
1532 @noindent Per identificare le funzionalità dei font OpenType leggere qui:
1533 @uref{http://lists.gnu.org/archive/html/lilypond-devel/2017-08/msg00004.html}
1535 Sebbene sia semplice passare a un tipo di carattere preconfigurato, è anche
1536 possibile usare altri tipi, come viene spiegato nelle sezioni successive:
1537 @ref{Single entry fonts} e @ref{Tipi di carattere per l'intero documento}.
1540 Guida alla notazione:
1541 @ref{Il font Emmentaler},
1542 @ref{Music notation inside markup},
1543 @ref{Rotating objects},
1544 @ref{Selecting font and font size},
1548 @node Tipi di carattere per singolo oggetto
1549 @unnumberedsubsubsec Tipi di carattere per singolo oggetto
1550 @translationof Single entry fonts
1552 Si può usare nella partitura qualsiasi tipo di carattere che sia installato
1553 nel sistema operativo e riconosciuto da FontConfig, usando la seguente
1556 @lilypond[quote,verbatim,fragment]
1557 \override Staff.TimeSignature.font-name = #"Bitstream Charter"
1558 \override Staff.TimeSignature.font-size = #2
1562 \override #'(font-name . "Bitstream Vera Sans,sans-serif, Oblique Bold")
1563 { Vera Oblique Bold }
1567 @cindex tipi di carattere, trovare quelli disponibili
1568 @cindex trovare i tipi di carattere disponibili
1569 @cindex elencare i tipi di carattere disponibili
1570 @cindex tipi di carattere disponibili, elenco
1572 @var{font-name} può essere definito da una lista separata da virgola di
1573 @q{font} e una lista separata da spazi di @q{stili}. Se il @q{font} nella
1574 lista è installato e contiene il glifo richiesto, verrà usato, altrimenti
1575 sarà usato al suo posto il font @emph{successivo}.
1577 @funindex show-available-fonts
1579 Lanciando lilypond con la seguente opzione si ottiene un elenco di tutti i
1580 tipi di carattere disponibili nel sistema operativo:
1583 lilypond -dshow-available-fonts x
1587 Guida alla notazione:
1588 @ref{Fonts explained},
1589 @ref{Tipi di carattere per l'intero documento}.
1594 @c A source file gets never installed...
1596 @c @file{lily/font-config-scheme.cc}.
1599 @node Tipi di carattere per l'intero documento
1600 @unnumberedsubsubsec Tipi di carattere per l'intero documento
1601 @translationof Entire document fonts
1603 È possibile modificare i tipi di carattere usati come tipi predefiniti nelle
1604 famiglie @emph{roman}, @emph{sans} e @emph{typewriter} specificandoli, in questo
1605 ordine, come è mostrato nell'esempio seguente, che ridimensiona automaticamente
1606 i caratteri col valore impostato per la dimensione globale del rigo. In modo
1607 analogo a @ref{Single entry fonts}, si può indicare con una lista separata da
1608 virgole di @q{font}. Gli @q{stili} dei font, invece, non possono essere
1609 definiti. I tipi di carattere sono spiegati in @ref{Fonts explained}.
1611 @cindex famiglie di tipi di carattere, impostare
1612 @cindex tipi di carattere, modificarli per l'intero documento
1614 @funindex make-pango-font-tree
1616 @lilypond[verbatim,quote]
1619 (make-pango-font-tree "Times New Roman"
1620 "Nimbus Sans,Nimbus Sans L"
1622 (/ staff-height pt 20)))
1629 \typewriter typewriter. }
1633 @c we don't do Helvetica / Courier, since GS incorrectly loads
1637 Guida alla notazione:
1638 @ref{Fonts explained},
1639 @ref{Single entry fonts},
1640 @ref{Selecting font and font size},