1 @c -*- coding: utf-8; mode: texinfo; -*-
3 Translation of GIT committish: bfc3420ada8810d57156e9fc871560188f044a64
5 When revising a translation, copy the HEAD committish of the
6 version that you are working on. For details, see the Contributors'
7 Guide, node Updating translation committishes..
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 \textLengthOff
104 @code{\textLengthOn},
105 @code{\textLengthOff}.
109 Manuale d'apprendimento:
110 @rlearning{Posizionamento degli oggetti}.
112 Guida alla notazione:
113 @ref{Formatting text},
114 @ref{Direction and placement},
115 @ref{Articulations and ornamentations}.
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{Formatting text}.
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{Formatting text}.
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{Formatting text}:
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{Formatting text},
310 @ref{Music notation inside markup},
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{Formatting text},
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 Gli errori di sintassi relativi alla modalità markup possono essere poco chiari.
517 @node Scelta del tipo di carattere e della dimensione
518 @unnumberedsubsubsec Scelta del tipo di carattere e della dimensione
519 @translationof Selecting font and font size
521 @cindex tipi di carattere, cambiare
522 @cindex cambiare i tipi di carattere
523 @cindex font, cambiare
529 La modalità markup permette di cambiare il tipo di carattere:
531 @lilypond[quote,verbatim]
535 \italic { non troppo \underline Vivo }
538 d,_\markup { \italic quasi \smallCaps Tromba }
543 @cindex dimensione del tipo di carattere
544 @cindex tipo di carattere, dimensione
545 @cindex dimensione del testo
546 @cindex testo, dimensione
548 @funindex \abs-fontsize
554 Si può modificare la dimensione del tipo di carattere, rispetto alla
555 dimensione globale del rigo, in vari modi.
557 Si può impostare su una dimensione predefinita,
559 @lilypond[quote,verbatim]
561 b1_\markup { \huge Sinfonia }
562 b1^\markup { \teeny da }
563 b1-\markup { \normalsize camera }
567 oppure in modo proporzionale rispetto al valore precedente,
569 @lilypond[quote,verbatim]
571 b1_\markup { \larger Sinfonia }
572 b1^\markup { \smaller da }
573 b1-\markup { \magnify #0.6 camera }
577 Può essere aumentata o diminuita rispetto al valore impostato per la
578 dimensione globale del rigo:
580 @lilypond[quote,verbatim]
582 b1_\markup { \fontsize #-2 Sinfonia }
583 b1^\markup { \fontsize #1 da }
584 b1-\markup { \fontsize #3 camera }
588 Si può impostare anche su una dimensione fissa (in punti), indipendentemente
589 dalla dimensione globale del rigo:
591 @lilypond[quote,verbatim]
593 b1_\markup { \abs-fontsize #20 Sinfonia }
594 b1^\markup { \abs-fontsize #8 da }
595 b1-\markup { \abs-fontsize #14 camera }
599 Se il testo contiene degli spazi, è meglio racchiuderlo tutto tra virgolette,
600 in modo che la dimensione di ciascun spazio sia adatta alla dimensione degli
603 @lilypond[quote,verbatim]
604 \markup \fontsize #6 \bold { Sinfonia da camera }
605 \markup \fontsize #6 \bold { "Sinfonia da camera" }
613 @funindex \normal-size-super
615 È possibile stampare il testo come pedice o apice. Per impostazione
616 predefinita, questo appaiono in corpo più piccolo, ma si può usare
617 anche un corpo normale:
619 @lilypond[quote,verbatim]
622 \line { 1 \super st movement }
623 \line { 1 \normal-size-super st movement
624 \sub { (part two) } }
629 @cindex famiglie di tipi di carattere
630 @cindex tipi di carattere, famiglie
632 La modalità di markup fornisce un modo semplice per scegliere famiglie
633 di caratteri diverse. Se non specificato altrimenti, viene scelto
634 automaticamente il carattere tipografico con grazie (il tipo romano);
635 nell'ultima linea dell'esempio seguente non c'è differenza tra la
636 prima e la seconda parola.
638 @lilypond[quote,verbatim]
641 \line { Act \number 1 }
642 \line { \sans { Scene I. } }
643 \line { \typewriter { Verona. An open place. } }
644 \line { Enter \roman Valentine and Proteus. }
650 Alcune di queste famiglie di caratteri, usate per elementi specifici come i
651 numeri o le dinamiche, non forniscono tutti i caratteri, come accennato in
652 @ref{New dynamic marks} e @ref{Manual repeat marks}.
654 @c \concat is actually documented in Align (it is not
655 @c a font-switching command). But we need it here. -vv
657 Se usati all'interno di una parola, alcuni comandi che cambiano il tipo di
658 carattere o la formattazione potrebbero produrre uno spazio vuoto
659 indesiderato. Si può facilmente risolvere concatenando insieme gli
662 @lilypond[quote,verbatim]
666 \concat { 1 \super st }
670 \concat { \dynamic p , }
671 \italic { con dolce espressione }
677 Una lista completa dei comandi per cambiare il tipo di carattere o per usare
678 tipi di carattere personalizzati si trova in @ref{Font}.
680 È possibile anche definire i propri gruppi di tipi di carattere, come
681 è spiegato in @ref{Fonts}.
686 @funindex \normalsize
705 Guida alla notazione:
707 @ref{New dynamic marks},
708 @ref{Manual repeat marks},
712 @file{scm/define-markup-commands.scm}.
717 Guida al funzionamento interno:
718 @rinternals{TextScript}.
721 L'uso dei comandi di dimensionamento dei caratteri @code{\teeny}, @code{\tiny},
722 @code{\small}, @code{\normalsize}, @code{\large} e @code{\huge} produce
723 una spaziatura della linea imprevedibile rispetto all'uso di @code{\fontsize}.
726 @node Allineamento del testo
727 @unnumberedsubsubsec Allineamento del testo
728 @translationof Text alignment
730 @cindex testo, allineamento
731 @cindex allineare il testo
732 @cindex allineare il markup
733 @cindex markup, allineare
735 Questa sottosezione spiega come posizionare il testo nella modalità
736 markup. Gli oggetti markup possono anche essere spostati interamente
737 tramite la sintassi descritta in @rlearning{Spostare gli oggetti}.
739 @c Padding commands should be mentioned on this page, but
740 @c most of these require \box to be more clearly illustrated. -vv
742 @cindex testo, allineamento orizzontale
743 @cindex allineamento orizzontale del testo
745 @funindex \left-align
746 @funindex \center-align
747 @funindex \right-align
749 Gli oggetti di markup possono essere allineati in vari modi. Per impostazione
750 predefinita, l'indicazione testuale è allineata rispetto al suo margine
751 sinistro: nell'esempio seguente, non c'è differenza tra il primo e il
754 @lilypond[quote,verbatim]
756 d''1-\markup { poco }
758 d-\markup { \left-align poco }
760 d-\markup { \center-align { poco } }
762 d-\markup { \right-align poco }
768 L'allineamento orizzontale può essere ritoccato usando un valore numerico:
770 @lilypond[quote,verbatim]
772 a'1-\markup { \halign #-1 poco }
774 a,-\markup { \halign #0 poco }
776 a,-\markup { \halign #0.5 poco }
778 a,-\markup { \halign #2 poco }
783 Alcuni oggetti possono avere proprie procedure di allineamento, e dunque
784 non sono influenzate da questi comandi. È possibile spostare tali
785 oggetti di markup tutti insieme, come mostrato ad esempio in
788 @cindex testo, allineamento verticale
789 @cindex allineamento verticale del testo
795 @c QUERY Should the function of ``\null'' be clarified? rp
797 L'allineamento verticale è un po' più complesso. Come si è detto prima, gli
798 oggetti di markup possono essere spostati tutti insieme; tuttavia è anche
799 possibile spostare elementi specifici all'interno di un blocco markup. In
800 questo caso l'elemento da spostare deve essere preceduto da un @emph{punto di riferimento}, che
801 può essere un altro elemento markup o un oggetto invisibile. L'esempio seguente
802 illustra queste due possibilità; l'ultimo markup in questo esempio non ha un
803 punto di riferimento e di conseguenza non si muove.
805 @lilypond[quote,verbatim]
809 \raise #2 { Scène 1 }
814 \lower #4 \bold { Très modéré }
818 \raise #4 \italic { Une forêt. }
824 @funindex \general-align
826 @funindex \translate-scaled
828 Alcuni comandi possono cambiare l'allineamento sia orizzontale che verticale
829 degli oggetti testuali in modalità markup. Qualsiasi oggetto interessato
830 da questi comandi deve essere preceduto da un punto di riferimento:
832 @lilypond[quote,verbatim]
836 \translate #'(-1 . 2) "Scène 1"
841 \general-align #Y #3.2 \bold "Très modéré"
846 \translate-scaled #'(-1 . 2) \teeny "Une forêt."
852 @cindex markup multilinea
853 @cindex multilinea, markup
854 @cindex testo multilinea
855 @cindex multilinea, testo
856 @cindex testo in colonne
857 @cindex colonne, testo
860 @funindex \center-column
862 Un oggetto markup può includere varie linee di testo. Nell'esempio
863 seguente, ogni elemento o espressione viene posizionato sulla sua
864 linea, allineato a sinistra o centrato:
866 @lilypond[quote,verbatim]
882 @cindex centrare il testo sulla pagina
883 @cindex testo, centrare sulla pagina
884 @cindex markup, centrare sulla pagina
888 Analogalmente, una lista di elementi o espressioni può essere distesa
889 per riempire l'intera larghezza orizzontale della linea (se c'è un solo
890 elemento, verrà centrato sulla pagina). Queste espressioni possono
891 a loro volta includere del testo multilinea o una qualsiasi altra
892 espressione di markup:
894 @lilypond[quote,verbatim]
897 \line { William S. Gilbert }
899 \huge \smallCaps "The Mikado"
901 \smallCaps "The Town of Titipu"
903 \line { Sir Arthur Sullivan }
911 @cindex testo a capo automaticamente
912 @cindex testo giustificato
913 @cindex giustificato, testo
914 @cindex a capo, testo
915 @cindex markup, testo a capo
916 @cindex markup, testo giustificato
921 Indicazioni testuali lunghe possono andare a capo automaticamente in base
922 alla larghezza della linea specificata. Possono essere allineate a
923 sinistra o giustificate, come mostra l'esempio seguente.
925 @lilypond[quote,verbatim]
928 \line \smallCaps { La vida breve }
929 \line \bold { Acto I }
931 (La escena representa el corral de una casa de
932 gitanos en el Albaicín de Granada. Al fondo una
933 puerta por la que se ve el negro interior de
934 una Fragua, iluminado por los rojos resplandores
939 \line \bold { Acto II }
940 \override #'(line-width . 50)
942 (Calle de Granada. Fachada de la casa de Carmela
943 y su hermano Manuel con grandes ventanas abiertas
944 a través de las que se ve el patio
945 donde se celebra una alegre fiesta)
951 @cindex testo, comandi di allineamento del
952 @cindex markup, comandi di allineamento del testo
953 @cindex allineamento, testo, comandi
955 Una lista completa dei comandi di allineamento del testo si trova in
959 Manuale d'apprendimento:
960 @rlearning{Spostare gli oggetti}.
962 Guida alla notazione:
967 @file{scm/define-markup-commands.scm}.
972 Guida al funzionamento interno:
973 @rinternals{TextScript}.
976 @node Notazione grafica nel blocco markup
977 @unnumberedsubsubsec Notazione grafica nel blocco markup
978 @translationof Graphic notation inside markup
980 @cindex grafica, inclusione
981 @cindex disegnare oggetti grafici
982 @cindex oggetti grafici, disegnare
983 @cindex oggetti grafici incorporati
984 @cindex oggetti grafici, includere
986 Si possono aggiungere vari oggetti grafici a una partitura attraverso
989 @cindex decorazione del testo
990 @cindex incorniciatura del testo
991 @cindex testo, incorniciatura
992 @cindex testo, decorazione
993 @cindex markup, decorazione
994 @cindex markup, incorniciatura
998 @funindex \rounded-box
1002 Alcuni comandi di markup consentono di decorare gli elementi testuali con
1003 degli elementi grafici, come è illustrato nell'esempio seguente.
1005 @lilypond[quote,verbatim]
1006 \markup \fill-line {
1014 \bracket "1866 - 1925"
1017 \rounded-box \bold Prelude
1022 @cindex padding intorno al testo
1023 @cindex testo, padding
1024 @cindex markup, padding
1026 @funindex \pad-markup
1028 @funindex \pad-to-box
1029 @funindex \pad-around
1031 Alcuni comandi possono richiedere un aumento del padding intorno al
1032 testo; per farlo si usano dei comandi di markup, descritti in modo
1033 esaustivo in @ref{Align}.
1035 @lilypond[quote,verbatim]
1036 \markup \fill-line {
1038 \box "Charles Ives (1874 - 1954)"
1040 \box \pad-markup #2 "THE UNANSWERED QUESTION"
1041 \box \pad-x #8 "A Cosmic Landscape"
1048 \box \pad-to-box #'(-5 . 20) #'(0 . 5)
1049 \bold "Largo to Presto"
1052 "String quartet keeps very even time,
1053 Flute quartet keeps very uneven time."
1057 @cindex notazione grafica
1058 @cindex simboli non musicali
1061 @funindex \draw-circle
1062 @funindex \filled-box
1064 @funindex \draw-line
1065 @funindex \arrow-head
1067 Si possono produrre altri elementi grafici o simboli che non richiedono
1068 alcun testo. Come con qualsiasi espressione di markup, tali oggetti
1069 possono essere combinati.
1071 @lilypond[quote,verbatim]
1074 \draw-circle #4 #0.4 ##f
1075 \filled-box #'(-4 . 4) #'(-0.5 . 0.5) #1
1081 \draw-line #'(0 . 4)
1082 \arrow-head #Y #DOWN ##f
1087 @cindex grafica inclusa
1088 @cindex immagini incluse
1092 @funindex \postscript
1094 Le funzionalità grafiche avanzate comprendono la possibilità di includere
1095 file di immagini convertite nel formato Encapsulated PostScript
1096 (@emph{eps}), oppure di inserire la grafica direttamente nel file di input,
1097 usando del codice PostScript nativo. In tal caso, può essere utile specificare
1098 esplicitamente la dimensione del disegno, come è mostrato sotto:
1100 @lilypond[quote,verbatim,fragment]
1103 \epsfile #X #10 #"./context-example.eps"
1104 \with-dimensions #'(0 . 6) #'(0 . 10)
1120 Una lista completa dei comandi specifici per la grafica si trova in
1124 Guida alla notazione:
1127 @ref{Editorial annotations},
1131 @file{scm/define-markup-commands.scm},
1132 @file{scm/stencil.scm}.
1137 Guida al funzionamento interno:
1138 @rinternals{TextScript}.
1141 @node Notazione musicale nel blocco markup
1142 @unnumberedsubsubsec Notazione musicale nel blocco markup
1143 @translationof Music notation inside markup
1145 @cindex notazione dentro il blocco markup
1146 @cindex musica dentro il blocco markup
1147 @cindex markup, notazione musicale dentro
1149 Si possono aggiungere vari elementi della notazione musicale dentro un
1152 Per le note e le alterazioni esistono dei comandi markup appositi:
1154 @lilypond[quote,verbatim,fragment]
1158 \note-by-number #1 #1 #1.5
1161 \natural \semiflat \flat
1162 \sesquiflat \doubleflat
1166 \natural \semisharp \sharp
1167 \sesquisharp \doublesharp
1172 Anche altri oggetti della notazione possono essere stampati in
1175 @lilypond[quote,verbatim]
1178 ees\finger \markup \tied-lyric #"4~1"
1179 fis_\markup { \dynamic rf }
1191 Più in generale, qualsiasi simbolo musicale disponibile può essere incluso
1192 separatamente in un oggetto markup, come è illustrato sotto. Una lista
1193 completa di questi simboli e dei loro nomi si trova in
1194 @ref{The Feta font}.
1196 @lilypond[quote,verbatim]
1199 c'^\markup { \musicglyph #"eight" }
1201 c,8._\markup { \musicglyph #"clefs.G_change" }
1203 c2^\markup { \musicglyph #"timesig.neomensural94" }
1207 Un altro modo per stampare glifi non testuali è descritto in
1208 @ref{Fonts explained}. È utile per stampare parentesi di varie
1211 La modalità markup supporta anche i diagrammi per strumenti specifici:
1213 @lilypond[quote,verbatim]
1216 \fret-diagram-terse #"x;x;o;2;3;2;"
1219 \harp-pedal #"^-v|--ov^"
1224 \musicglyph #"accordion.discant"
1226 \raise #0.5 \musicglyph #"accordion.dot"
1227 \raise #1.5 \musicglyph #"accordion.dot"
1232 @c The accordion diagram is actually taken from a snippet.
1235 Questi diagrammi sono documentati in @ref{Instrument Specific Markup}.
1237 @cindex partitura dentro il blocco markup
1238 @cindex markup, partitura dentro
1240 È possibile annidare perfino un'intera partitura in un oggetto markup. In tal
1241 caso, il blocco @code{\score} annidato deve contenere un blocco @code{\layout},
1242 come è illustrato qui:
1244 @lilypond[quote,verbatim]
1248 \relative { c'4 d e f }
1257 Una lista completa dei comandi relativi alla notazione musicale si trova
1261 Guida alla notazione:
1263 @ref{The Feta font},
1264 @ref{Fonts explained}.
1267 @file{scm/define-markup-commands.scm},
1268 @file{scm/fret-diagrams.scm},
1269 @file{scm/harp-pedals.scm}.
1274 Guida al funzionamento interno:
1275 @rinternals{TextScript}.
1278 @node Testo formattato su più pagine
1279 @unnumberedsubsubsec Testo formattato su più pagine
1280 @translationof Multi-page markup
1282 @cindex testo formattato su più pagine
1283 @cindex markup, multipagina
1284 @cindex multipagina, testo
1285 @cindex testo esteso su più pagine
1287 @funindex \markuplist
1288 @funindex \justified-lines
1289 @funindex \wordwrap-lines
1291 Sebbene gli oggetti di markup standard non possano avere interruzioni, una
1292 specifica sintassi permette di inserire linee di testo che possono estendersi
1295 @lilypond[quote,verbatim]
1298 Un testo molto lungo di linee giustificate.
1302 Un altro paragrafo molto lungo.
1309 Questa sintassi accetta una lista di oggetti di markup, che possono essere
1312 il risultato di un comando \markuplist,
1314 una lista di markup,
1316 una lista di \markuplists.
1319 Una lista completa dei comandi che si possono usare con \markuplist si
1320 trova in @ref{Text markup list commands}.
1323 Guida alla notazione:
1324 @ref{Text markup list commands}.
1327 @rextend{New markup list command definition}.
1330 @file{scm/define-markup-commands.scm}.
1335 Guida al funzionamento interno:
1336 @rinternals{TextScript}.
1338 @funindex \markuplist
1345 @node Tipi di carattere
1346 @subsection Tipi di carattere
1347 @translationof Fonts
1349 Questa sezione presenta il modo in cui sono gestiti i tipi di carattere e come
1350 possono essere modificati nelle partiture.
1353 * Tipi di carattere in dettaglio::
1354 * Tipi di carattere per singolo oggetto::
1355 * Tipi di carattere per l'intero documento::
1358 @node Tipi di carattere in dettaglio
1359 @unnumberedsubsubsec Tipi di carattere in dettaglio
1360 @translationof Fonts explained
1363 @cindex tipi di carattere
1365 @cindex graffe, varie dimensioni
1366 @cindex font non testuali nel markup
1368 @funindex font-interface
1370 I tipi di carattere vengono gestiti attraverso varie librerie. FontConfig
1371 rileva i tipi di carattere disponibili nel sistema; i tipi selezionati
1372 sono riprodotti con Pango.
1374 I tipi di carattere della notazione musicale possono essere descritti
1375 come un insieme di glifi specifici, ordinati in varie famiglie. La
1376 seguente sintassi permette di usare vari caratteri @code{feta} di LilyPond
1377 (non testuali) direttamente nella modalità markup:
1379 @lilypond[quote,verbatim,fragment]
1382 \override #'(font-encoding . fetaBraces)
1384 \override #'(font-encoding . fetaText)
1386 \override #'(font-encoding . fetaMusic)
1387 \lookup #"noteheads.s0petrucci"
1393 Tuttavia, tutti questi glifi, ad eccezione delle graffe di varie
1394 dimensioni contenute in @code{fetaBraces}, sono già utilizzabili
1395 con la sintassi ben più semplice descritta in @ref{Music notation inside markup}.
1397 Quando si usano i glifi contenuti in @code{fetaBraces}, la dimensione
1398 della graffa viene specificata dalla parte numerica del nome del glifo,
1399 in unità arbitrarie. Può essere specificato qualsiasi numero intero da
1400 @code{0} a @code{575} compresi, dove @code{0} corrisponde alla graffa
1401 più piccola. Il valore ottimale deve essere determinato per tentativi.
1402 Questi glifi sono tutte graffe sinistre; le graffe destre si possono
1403 ottenere con la rotazione, vedi @ref{Rotating objects}.
1405 Sono disponibili tre famiglie di tipi di carattere:
1408 Il tipo @emph{roman} (con grazie), il cui valore predefinito è LilyPond Serif
1409 (un alias di TeX Gyre Schola).
1411 Il tipo @emph{sans} (senza grazie), il cui valore predefinito è LilyPond Sans
1412 Serif (un alias di TeX Gyre Heros).
1414 Il tipo monospaziato @emph{typewriter}, il cui valore predefinito è LilyPond
1415 Monospace (un alias di TeX Gyre Cursor).
1418 Ogni famiglia può avere forme e serie differenti. L'esempio seguente
1419 illustra la possibilità di scegliere famiglie, forme, serie e
1420 dimensioni alternative. Il valore specificato per @code{font-size} è
1421 la modifica relativa alla dimensione predefinita.
1423 @lilypond[quote,verbatim,fragment]
1424 \override Score.RehearsalMark.font-family = #'typewriter
1425 \mark \markup "Ouverture"
1426 \override Voice.TextScript.font-shape = #'italic
1427 \override Voice.TextScript.font-series = #'bold
1428 d''2.^\markup "Allegro"
1429 \override Voice.TextScript.font-size = #-3
1434 Una sintassi simile si usa nella modalità markup; tuttavia in questo
1435 caso è preferibile usare la sintassi più semplice spiegata in
1436 @ref{Selecting font and font size}:
1438 @lilypond[quote,verbatim]
1442 \override #'(font-shape . italic)
1443 \override #'(font-size . 4)
1447 \override #'(font-family . typewriter)
1449 \override #'(font-series . bold)
1453 \override #'(font-family . sans)
1460 Sebbene sia semplice passare a un tipo di carattere preconfigurato, è anche
1461 possibile usare altri tipi, come viene spiegato nelle sezioni successive:
1462 @ref{Single entry fonts} e @ref{Entire document fonts}.
1465 Guida alla notazione:
1466 @ref{The Feta font},
1467 @ref{Music notation inside markup},
1468 @ref{Rotating objects},
1469 @ref{Selecting font and font size},
1473 @node Tipi di carattere per singolo oggetto
1474 @unnumberedsubsubsec Tipi di carattere per singolo oggetto
1475 @translationof Single entry fonts
1477 Si può usare nella partitura qualsiasi tipo di carattere che sia installato
1478 nel sistema operativo e riconosciuto da FontConfig, usando la seguente
1481 @lilypond[quote,verbatim,fragment]
1482 \override Staff.TimeSignature.font-name = #"Bitstream Charter"
1483 \override Staff.TimeSignature.font-size = #2
1487 \override #'(font-name . "Bitstream Vera Sans,sans-serif, Oblique Bold")
1488 { Vera Oblique Bold }
1492 @cindex tipi di carattere, trovare quelli disponibili
1493 @cindex trovare i tipi di carattere disponibili
1494 @cindex elencare i tipi di carattere disponibili
1495 @cindex tipi di carattere disponibili, elenco
1497 @var{font-name} può essere definito da una lista separata da virgola di
1498 @q{font} e una lista separata da spazi di @q{stili}. Se il @q{font} nella
1499 lista è installato e contiene il glifo richiesto, verrà usato, altrimenti
1500 sarà usato al suo posto il font @emph{successivo}.
1502 @funindex show-available-fonts
1504 Lanciando lilypond con la seguente opzione si ottiene un elenco di tutti i
1505 tipi di carattere disponibili nel sistema operativo:
1508 lilypond -dshow-available-fonts x
1512 Guida alla notazione:
1513 @ref{Fonts explained},
1514 @ref{Entire document fonts}.
1519 @c A source file gets never installed...
1521 @c @file{lily/font-config-scheme.cc}.
1524 @node Tipi di carattere per l'intero documento
1525 @unnumberedsubsubsec Tipi di carattere per l'intero documento
1526 @translationof Entire document fonts
1528 È possibile modificare i tipi di carattere usati come tipi predefiniti nelle
1529 famiglie @emph{roman}, @emph{sans} e @emph{typewriter} specificandoli, in questo
1530 ordine, come è mostrato nell'esempio seguente, che ridimensiona automaticamente
1531 i caratteri col valore impostato per la dimensione globale del rigo. In modo
1532 analogo a @ref{Single entry fonts}, si può indicare con una lista separata da
1533 virgole di @q{font}. Gli @q{stili} dei font, invece, non possono essere
1534 definiti. I tipi di carattere sono spiegati in @ref{Fonts explained}.
1536 @cindex famiglie di tipi di carattere, impostare
1537 @cindex tipi di carattere, modificarli per l'intero documento
1539 @funindex make-pango-font-tree
1541 @lilypond[verbatim,quote]
1544 (make-pango-font-tree "Times New Roman"
1545 "Nimbus Sans,Nimbus Sans L"
1547 (/ staff-height pt 20)))
1554 \typewriter typewriter. }
1558 @c we don't do Helvetica / Courier, since GS incorrectly loads
1562 Guida alla notazione:
1563 @ref{Fonts explained},
1564 @ref{Single entry fonts},
1565 @ref{Selecting font and font size},