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,relative=2]
68 a8^"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,relative=2]
76 a8^\markup { \italic pizz. } g f e
77 a4_\markup { \tiny scherz. \bold molto } f
80 Le indicazioni testuali, di norma, non influenzano la spaziatura delle note.
81 Ma è possibile far sì che la loro larghezza venga presa in considerazione:
82 nell'esempio seguente la prima stringa di testo non influenza la spaziatura,
85 @lilypond[quote,verbatim,relative=2]
91 Oltre alle scritte, si possono attaccare alle note anche le
92 articolazioni. Ulteriori informazioni in @ref{Articulations and ornamentations}.
94 Per maggiori informazioni sull'ordinamento relativo delle scritte e delle
95 articolazioni si veda @rlearning{Posizionamento degli oggetti}.
97 @funindex \textLengthOn
98 @funindex textLengthOn
99 @funindex \textLengthOff
100 @funindex textLengthOff
103 @code{\textLengthOn},
104 @code{\textLengthOff}.
108 Manuale d'apprendimento:
109 @rlearning{Posizionamento degli oggetti}.
111 Guida alla notazione:
112 @ref{Formatting text},
113 @ref{Direction and placement},
114 @ref{Articulations and ornamentations}.
119 Guida al funzionamento interno:
120 @rinternals{TextScript}.
122 @cindex testo fuori dal margine
123 @cindex margine, testo che va oltre
124 @cindex testo, tenerlo dentro il margine
125 @cindex testo vocale, tenerlo dentro il margine
128 Per verificare che le scritte e il testo vocale siano entro i margini
129 occorrono ulteriori calcoli. Nei casi in cui è richiesta un'esecuzione
130 leggermente più veloce, usare
133 \override Score.PaperColumn.keep-inside-line = ##f
137 @node Estensori del testo
138 @unnumberedsubsubsec Estensori del testo
139 @translationof Text spanners
141 @cindex estensori del testo
143 Alcune indicazioni esecutive, per esempio @notation{rallentando} o
144 @notation{accelerando}, appaiono in forma testuale e vengono estese
145 lungo molteplici note con delle linee punteggiate. Tali oggetti,
146 chiamati @qq{estensori} (spanner), si creano collegando due note
147 con la seguente sintassi:
149 @lilypond[verbatim,quote,relative=2]
150 \override TextSpanner.bound-details.left.text = "rit."
155 @cindex estensori del testo, formattazione
156 @cindex formattare gli estensori del testo
159 La stringa testuale da stampare viene impostata attraverso le proprietà
160 dell'oggetto. Per impostazione predefinita, appare in corsivo, ma si
161 può ottenere una formattazione diversa tramite i blocchi @code{\markup}, come
162 è spiegato in @ref{Formatting text}.
164 @lilypond[quote,relative=2,verbatim]
165 \override TextSpanner.bound-details.left.text =
166 \markup { \upright "rit." }
171 Lo stile della linea, così come la stringa testuale, può essere definito come
172 una proprietà dell'oggetto. Questa sintassi è descritta in @ref{Line styles}.
174 @funindex \textSpannerUp
175 @funindex textSpannerUp
176 @funindex \textSpannerDown
177 @funindex textSpannerDown
178 @funindex \textSpannerNeutral
179 @funindex textSpannerNeutral
183 @code{\textSpannerUp},
184 @code{\textSpannerDown},
185 @code{\textSpannerNeutral}.
189 LilyPond è capace di gestire un solo estensore del testo per ogni voce.
193 @lilypondfile[verbatim,quote,texidoc,doctitle]
194 {dynamics-text-spanner-postfix.ly}
196 @lilypondfile[verbatim,quote,texidoc,doctitle]
197 {dynamics-custom-text-spanner-postfix.ly}
200 Guida alla notazione:
203 @ref{Formatting text}.
207 @rlsr{Expressive marks}.
209 Guida al funzionamento interno:
210 @rinternals{TextSpanner}.
213 @node Indicazioni testuali
214 @unnumberedsubsubsec Indicazioni testuali
215 @translationof Text marks
218 @cindex indicazioni testuali
219 @cindex testo, indicazioni
220 @cindex testo sulla stanghetta
221 @cindex coda sulla stanghetta
222 @cindex segno sulla stanghetta
223 @cindex corona sulla stanghetta
224 @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,relative=2]
243 Questa sintassi permette di porre del testo sopra una stanghetta;
244 una formattazione del testo più complessa è possibile grazie al
245 blocco @code{\markup}, come è spiegato in @ref{Formatting text}:
247 @lilypond[quote,verbatim,relative=1]
249 \mark \markup { \italic { colla parte } }
255 Questa sintassi permette anche di stampare segni speciali, come coda, segno
256 o corona, se si specifica il nome appropriato del simbolo, come è spiegato
257 in @ref{Music notation inside markup}:
259 @lilypond[quote,verbatim,relative=2]
261 \mark \markup { \musicglyph #"scripts.ufermata" }
266 Tali oggetti vengono posizionati soltanto sopra il rigo superiore della
267 partitura; a seconda che siano inseriti alla fine o a metà di una battuta,
268 possono trovarsi sopra la stanghetta o tra le note. Se inserito prima di
269 un'interruzione di linea, l'indicazione apparirà all'inizio della linea
272 @lilypond[quote,verbatim,relative=2,ragged-right]
279 @funindex \markLengthOn
280 @funindex markLengthOn
281 @funindex \markLengthOff
282 @funindex markLengthOff
285 @code{\markLengthOn},
286 @code{\markLengthOff}.
291 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
292 {printing-marks-at-the-end-of-a-line.ly}
294 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
295 {printing-marks-on-every-staff.ly}
298 Guida alla notazione:
299 @ref{Rehearsal marks},
300 @ref{Formatting text},
301 @ref{Music notation inside markup},
307 Guida al funzionamento interno:
308 @rinternals{MarkEvent},
309 @rinternals{Mark_engraver},
310 @rinternals{RehearsalMark}.
314 @unnumberedsubsubsec Testo separato
315 @translationof Separate text
317 @cindex testo separato
318 @cindex testo indipendente
319 @cindex testo al livello superiore
324 Un blocco @code{\markup} può esistere di per sé, fuori da qualsiasi
325 blocco @code{\score}, come un'@tie{@qq{espressione di livello superiore}}. Questa
326 sintassi è descritta in @ref{File structure}.
328 @lilypond[verbatim,quote]
330 Tomorrow, and tomorrow, and tomorrow...
335 Ciò permette di stampare il testo in modo autonomo dalla musica, ed è
336 utile soprattutto quando il file di input contiene vari brani musicali,
337 come è spiegato in @ref{Multiple scores in a book}.
339 @lilypond[quote,verbatim]
344 Tomorrow, and tomorrow, and tomorrow...
351 Blocchi di testo separati possono essere estesi per molte pagine, rendendo
352 possibile la realizzazione di documenti o libri interamente con LilyPond.
353 Questa funzionalità, e la sintassi specifica che richiede, è descritta
354 in @ref{Multi-page markup}.
358 @funindex \markuplist
369 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
370 {stand-alone-two-column-markup.ly}
373 Guida alla notazione:
374 @ref{Formatting text},
375 @ref{File structure},
376 @ref{Multiple scores in a book},
377 @ref{Multi-page markup}.
382 Guida al funzionamento interno:
383 @rinternals{TextScript}.
386 @node Formattazione del testo
387 @subsection Formattazione del testo
388 @translationof Formatting text
390 Questa sezione presenta la formattazione del testo basilare e quella avanzata,
391 usando la sintassi specifica della modalità @code{\markup}.
394 * Introduzione al testo a margine::
395 * Scelta del tipo di carattere e della dimensione::
396 * Allineamento del testo::
397 * Notazione grafica nel blocco markup::
398 * Notazione musicale nel blocco markup::
399 * Testo formattato su più pagine::
402 @node Introduzione al testo a margine
403 @unnumberedsubsubsec Introduzione al testo a margine
404 @translationof Text markup introduction
407 @cindex testo a margine
413 Un blocco @code{\markup} permette di comporre del testo con un'ampia
414 sintassi chiamata @qq{modalità markup}.
416 @cindex markup, espressioni
417 @cindex espressioni di markup
418 @cindex sintassi di markup
419 @cindex markup, sintassi
421 La sintassi di markup è simile alla solita sintassi di LilyPond: un'espressione
422 @code{\markup} viene racchiusa tra parentesi graffe @code{@{@dots{} @}}. Una
423 singola parola viene considerata un'espressione minima, e quindi non è
424 necessario racchiuderla tra parentesi.
426 Diversamente dalle indicazioni testuali @qq{tra virgolette}, i blocchi
427 @code{\markup} possono contenere espressioni o comandi di markup annidati,
428 inseriti col carattere di barra inversa @code{\}. Tali comandi hanno
429 effetto solo sulla prima espressione che segue.
431 @lilypond[quote,verbatim,relative=2]
433 a2^\markup { poco \italic più forte }
435 d2_\markup { \italic "string. assai" }
437 b1^\markup { \bold { molto \italic agitato } }
441 @cindex caratteri speciali in modalità markup
442 @cindex modalità markup, caratteri speciali
443 @cindex caratteri riservati, stampare
444 @cindex stampare i caratteri riservati
445 @cindex stampare i caratteri speciali
446 @cindex testo tra virgolette in modalità markup
447 @cindex modalità markup, testo tra virgolette
449 Un blocco @code{\markup} può contenere anche stringhe di testo tra
450 virgolette. Tali stringhe vengono trattate come espressioni testuali
451 minime, e quindi qualsiasi comando di markup o carattere speciale
452 (come @code{\} e@tie{}@code{#}) apparirà alla lettera senza influenzare
453 la formattazione del testo. Le stesse doppie virgolette possono essere
454 stampate facendole precedere da una barra inversa.
456 @lilypond[quote,verbatim,relative=2]
457 a1^"\italic markup..."
458 a_\markup { \italic "... prints \"italic\" letters!" }
462 Perché sia trattata come un'espressione distinta, una lista di parole deve
463 essere racchiusa tra virgolette doppie o preceduta da un comando. Il modo
464 in cui le espressioni musicali sono definite influenza il modo in cui
465 saranno sistemate, centrate e allineate; nell'esempio seguente, la seconda
466 espressione di @code{\markup} viene trattata nello stesso modo della prima:
468 @lilypond[quote,verbatim,relative=2]
469 c1^\markup { \center-column { a bbb c } }
470 c1^\markup { \center-column { a { bbb c } } }
471 c1^\markup { \center-column { a \line { bbb c } } }
472 c1^\markup { \center-column { a "bbb c" } }
475 I markup possono essere salvati in delle variabili, che possono poi essere
476 attaccate direttamente alle note:
478 @lilypond[quote,verbatim]
479 allegro = \markup { \bold \large Allegro }
489 Una lista completa dei comandi specifici di @code{\markup} si trova in
490 @ref{Text markup commands}.
493 Guida alla notazione:
494 @ref{Text markup commands}.
500 @file{scm/markup.scm}.
503 Gli errori di sintassi relativi alla modalità markup possono essere poco chiari.
506 @node Scelta del tipo di carattere e della dimensione
507 @unnumberedsubsubsec Scelta del tipo di carattere e della dimensione
508 @translationof Selecting font and font size
510 @cindex tipi di carattere, cambiare
511 @cindex cambiare i tipi di carattere
512 @cindex font, cambiare
521 La modalità markup permette di cambiare il tipo di carattere:
523 @lilypond[quote,verbatim,relative=2]
526 \italic { non troppo \underline Vivo }
529 d,_\markup { \italic quasi \smallCaps Tromba }
533 @cindex dimensione del tipo di carattere
534 @cindex tipo di carattere, dimensione
535 @cindex dimensione del testo
536 @cindex testo, dimensione
538 @funindex \abs-fontsize
548 Si può modificare la dimensione del tipo di carattere, rispetto alla
549 dimensione globale del rigo, in vari modi.
551 Si può impostare su una dimensione predefinita,
553 @lilypond[quote,verbatim,relative=2]
554 b1_\markup { \huge Sinfonia }
555 b1^\markup { \teeny da }
556 b1-\markup { \normalsize camera }
559 oppure in modo proporzionale rispetto al valore precedente,
561 @lilypond[quote,verbatim,relative=2]
562 b1_\markup { \larger Sinfonia }
563 b1^\markup { \smaller da }
564 b1-\markup { \magnify #0.6 camera }
567 Può essere aumentata o diminuita rispetto al valore impostato per la
568 dimensione globale del rigo:
570 @lilypond[quote,verbatim,relative=2]
571 b1_\markup { \fontsize #-2 Sinfonia }
572 b1^\markup { \fontsize #1 da }
573 b1-\markup { \fontsize #3 camera }
576 Si può impostare anche su una dimensione fissa (in punti), indipendentemente
577 dalla dimensione globale del rigo:
579 @lilypond[quote,verbatim,relative=2]
580 b1_\markup { \abs-fontsize #20 Sinfonia }
581 b1^\markup { \abs-fontsize #8 da }
582 b1-\markup { \abs-fontsize #14 camera }
592 @funindex \normal-size-super
593 @funindex normal-size-super
595 È possibile stampare il testo come pedice o apice. Per impostazione
596 predefinita, questo appaiono in corpo più piccolo, ma si può usare
597 anche un corpo normale:
599 @lilypond[quote,verbatim]
602 \line { 1 \super st movement }
603 \line { 1 \normal-size-super st movement
604 \sub { (part two) } }
609 @cindex famiglie di tipi di carattere
610 @cindex tipi di carattere, famiglie
612 La modalità di markup fornisce un modo semplice per scegliere famiglie
613 di caratteri diverse. Se non specificato altrimenti, viene scelto
614 automaticamente il carattere tipografico con grazie (il tipo romano);
615 nell'ultima linea dell'esempio seguente non c'è differenza tra la
616 prima e la seconda parola.
618 @lilypond[quote,verbatim]
621 \line { Act \number 1 }
622 \line { \sans { Scene I. } }
623 \line { \typewriter { Verona. An open place. } }
624 \line { Enter \roman Valentine and Proteus. }
630 Alcune di queste famiglie di caratteri, usate per elementi specifici come i
631 numeri o le dinamiche, non forniscono tutti i caratteri, come accennato in
632 @ref{New dynamic marks} e @ref{Manual repeat marks}.
634 @c \concat is actually documented in Align (it is not
635 @c a font-switching command). But we need it here. -vv
637 Se usati all'interno di una parola, alcuni comandi che cambiano il tipo di
638 carattere o la formattazione potrebbero produrre uno spazio vuoto
639 indesiderato. Si può facilmente risolvere concatenando insieme gli
642 @lilypond[quote,verbatim]
646 \concat { 1 \super st }
650 \concat { \dynamic p , }
651 \italic { con dolce espressione }
657 Una lista completa dei comandi per cambiare il tipo di carattere o per usare
658 tipi di carattere personalizzati si trova in @ref{Font}.
660 È possibile anche definire i propri gruppi di tipi di carattere, come
661 è spiegato in @ref{Fonts}.
669 @funindex \normalsize
693 Guida alla notazione:
695 @ref{New dynamic marks},
696 @ref{Manual repeat marks},
700 @file{scm/define-markup-commands.scm}.
705 Guida al funzionamento interno:
706 @rinternals{TextScript}.
709 L'uso dei comandi di dimensionamento dei caratteri @code{\teeny}, @code{\tiny},
710 @code{\small}, @code{\normalsize}, @code{\large} e @code{\huge} produce
711 una spaziatura della linea imprevedibile rispetto all'uso di @code{\fontsize}.
714 @node Allineamento del testo
715 @unnumberedsubsubsec Allineamento del testo
716 @translationof Text alignment
718 @cindex testo, allineamento
719 @cindex allineare il testo
720 @cindex allineare il markup
721 @cindex markup, allineare
723 Questa sottosezione spiega come posizionare il testo nella modalità
724 markup. Gli oggetti markup possono anche essere spostati interamente
725 tramite la sintassi descritta in @rlearning{Spostare gli oggetti}.
727 @c Padding commands should be mentioned on this page, but
728 @c most of these require \box to be more clearly illustrated. -vv
730 @cindex testo, allineamento orizzontale
731 @cindex allineamento orizzontale del testo
733 @funindex \left-align
735 @funindex \center-align
736 @funindex center-align
737 @funindex \right-align
738 @funindex right-align
740 Gli oggetti di markup possono essere allineati in vari modi. Per impostazione
741 predefinita, l'indicazione testuale è allineata rispetto al suo margine
742 sinistro: nell'esempio seguente, non c'è differenza tra il primo e il
745 @lilypond[quote,verbatim,relative=2]
748 d-\markup { \left-align poco }
750 d-\markup { \center-align { poco } }
752 d-\markup { \right-align poco }
758 L'allineamento orizzontale può essere ritoccato usando un valore numerico:
760 @lilypond[quote,verbatim,relative=2]
761 a1-\markup { \halign #-1 poco }
763 a,-\markup { \halign #0 poco }
765 a,-\markup { \halign #0.5 poco }
767 a,-\markup { \halign #2 poco }
771 Alcuni oggetti possono avere proprie procedure di allineamento, e dunque
772 non sono influenzate da questi comandi. È possibile spostare tali
773 oggetti di markup tutti insieme, come mostrato ad esempio in
776 @cindex testo, allineamento verticale
777 @cindex allineamento verticale del testo
786 @c QUERY Should the function of ``\null'' be clarified? rp
788 L'allineamento verticale è un po' più complesso. Come si è detto prima, gli
789 oggetti di markup possono essere spostati tutti insieme; tuttavia è anche
790 possibile spostare elementi specifici all'interno di un blocco markup. In
791 questo caso l'elemento da spostare deve essere preceduto da un @emph{punto di riferimento}, che
792 può essere un altro elemento markup o un oggetto invisibile. L'esempio seguente
793 illustra queste due possibilità; l'ultimo markup in questo esempio non ha un
794 punto di riferimento e di conseguenza non si muove.
796 @lilypond[quote,verbatim,relative=1]
799 \raise #2 { Scène 1 }
804 \lower #4 \bold { Très modéré }
808 \raise #4 \italic { Une forêt. }
813 @funindex \general-align
814 @funindex general-align
817 @funindex \translate-scaled
818 @funindex translate-scaled
820 Alcuni comandi possono cambiare l'allineamento sia orizzontale che verticale
821 degli oggetti testuali in modalità markup. Qualsiasi oggetto interessato
822 da questi comandi deve essere preceduto da un punto di riferimento:
824 @lilypond[quote,verbatim,relative=1]
827 \translate #'(-1 . 2) "Scène 1"
832 \general-align #Y #3.2 \bold "Très modéré"
837 \translate-scaled #'(-1 . 2) \teeny "Une forêt."
842 @cindex markup multilinea
843 @cindex multilinea, markup
844 @cindex testo multilinea
845 @cindex multilinea, testo
846 @cindex testo in colonne
847 @cindex colonne, testo
851 @funindex \center-column
852 @funindex center-column
854 Un oggetto markup può includere varie linee di testo. Nell'esempio
855 seguente, ogni elemento o espressione viene posizionato sulla sua
856 linea, allineato a sinistra o centrato:
858 @lilypond[quote,verbatim]
874 @cindex centrare il testo sulla pagina
875 @cindex testo, centrare sulla pagina
876 @cindex markup, centrare sulla pagina
881 Analogalmente, una lista di elementi o espressioni può essere distesa
882 per riempire l'intera larghezza orizzontale della linea (se c'è un solo
883 elemento, verrà centrato sulla pagina). Queste espressioni possono
884 a loro volta includere del testo multilinea o una qualsiasi altra
885 espressione di markup:
887 @lilypond[quote,verbatim]
890 \line { William S. Gilbert }
892 \huge \smallCaps "The Mikado"
894 \smallCaps "The Town of Titipu"
896 \line { Sir Arthur Sullivan }
904 @cindex testo a capo automaticamente
905 @cindex testo giustificato
906 @cindex giustificato, testo
907 @cindex a capo, testo
908 @cindex markup, testo a capo
909 @cindex markup, testo giustificato
916 Indicazioni testuali lunghe possono andare a capo automaticamente in base
917 alla larghezza della linea specificata. Possono essere allineate a
918 sinistra o giustificate, come mostra l'esempio seguente.
920 @lilypond[quote,verbatim]
923 \line \smallCaps { La vida breve }
924 \line \bold { Acto I }
926 (La escena representa el corral de una casa de
927 gitanos en el Albaicín de Granada. Al fondo una
928 puerta por la que se ve el negro interior de
929 una Fragua, iluminado por los rojos resplandores
934 \line \bold { Acto II }
935 \override #'(line-width . 50)
937 (Calle de Granada. Fachada de la casa de Carmela
938 y su hermano Manuel con grandes ventanas abiertas
939 a través de las que se ve el patio
940 donde se celebra una alegre fiesta)
946 @cindex testo, comandi di allineamento del
947 @cindex markup, comandi di allineamento del testo
948 @cindex allineamento, testo, comandi
950 Una lista completa dei comandi di allineamento del testo si trova in
954 Manuale d'apprendimento:
955 @rlearning{Spostare gli oggetti}.
957 Guida alla notazione:
962 @file{scm/define-markup-commands.scm}.
967 Guida al funzionamento interno:
968 @rinternals{TextScript}.
971 @node Notazione grafica nel blocco markup
972 @unnumberedsubsubsec Notazione grafica nel blocco markup
973 @translationof Graphic notation inside markup
975 @cindex grafica, inclusione
976 @cindex disegnare oggetti grafici
977 @cindex oggetti grafici, disegnare
978 @cindex oggetti grafici incorporati
979 @cindex oggetti grafici, includere
981 Si possono aggiungere vari oggetti grafici a una partitura attraverso
984 @cindex decorazione del testo
985 @cindex incorniciatura del testo
986 @cindex testo, incorniciatura
987 @cindex testo, decorazione
988 @cindex markup, decorazione
989 @cindex markup, incorniciatura
995 @funindex \rounded-box
996 @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
1027 @funindex pad-markup
1030 @funindex \pad-to-box
1031 @funindex pad-to-box
1032 @funindex \pad-around
1033 @funindex pad-around
1035 Alcuni comandi possono richiedere un aumento del padding intorno al
1036 testo; per farlo si usano dei comandi di markup, descritti in modo
1037 esaustivo in @ref{Align}.
1039 @lilypond[quote,verbatim]
1040 \markup \fill-line {
1042 \box "Charles Ives (1874 - 1954)"
1044 \box \pad-markup #2 "THE UNANSWERED QUESTION"
1045 \box \pad-x #8 "A Cosmic Landscape"
1052 \box \pad-to-box #'(-5 . 20) #'(0 . 5)
1053 \bold "Largo to Presto"
1056 "String quartet keeps very even time,
1057 Flute quartet keeps very uneven time."
1061 @cindex notazione grafica
1062 @cindex simboli non musicali
1066 @funindex \draw-circle
1067 @funindex draw-circle
1068 @funindex \filled-box
1069 @funindex filled-box
1072 @funindex \draw-line
1074 @funindex \arrow-head
1075 @funindex arrow-head
1077 Si possono produrre altri elementi grafici o simboli che non richiedono
1078 alcun testo. Come con qualsiasi espressione di markup, tali oggetti
1079 possono essere combinati.
1081 @lilypond[quote,verbatim]
1084 \draw-circle #4 #0.4 ##f
1085 \filled-box #'(-4 . 4) #'(-0.5 . 0.5) #1
1091 \draw-line #'(0 . 4)
1092 \arrow-head #Y #DOWN ##f
1097 @cindex grafica inclusa
1098 @cindex immagini incluse
1103 @funindex \postscript
1104 @funindex postscript
1106 Le funzionalità grafiche avanzate comprendono la possibilità di includere
1107 file di immagini convertite nel formato Encapsulated PostScript
1108 (@emph{eps}), oppure di inserire la grafica direttamente nel file di input,
1109 usando del codice PostScript nativo. In tal caso, può essere utile specificare
1110 esplicitamente la dimensione del disegno, come è mostrato sotto:
1112 @lilypond[quote,verbatim,relative=1]
1115 \epsfile #X #10 #"./context-example.eps"
1116 \with-dimensions #'(0 . 6) #'(0 . 10)
1132 Una lista completa dei comandi specifici per la grafica si trova in
1136 Guida alla notazione:
1139 @ref{Editorial annotations},
1143 @file{scm/define-markup-commands.scm},
1144 @file{scm/stencil.scm}.
1149 Guida al funzionamento interno:
1150 @rinternals{TextScript}.
1153 @node Notazione musicale nel blocco markup
1154 @unnumberedsubsubsec Notazione musicale nel blocco markup
1155 @translationof Music notation inside markup
1157 @cindex notazione dentro il blocco markup
1158 @cindex musica dentro il blocco markup
1159 @cindex markup, notazione musicale dentro
1161 Si possono aggiungere vari elementi della notazione musicale dentro un
1164 Per le note e le alterazioni esistono dei comandi markup appositi:
1166 @lilypond[quote,verbatim,relative=2]
1170 \note-by-number #1 #1 #1.5
1173 \natural \semiflat \flat
1174 \sesquiflat \doubleflat
1178 \natural \semisharp \sharp
1179 \sesquisharp \doublesharp
1184 Anche altri oggetti della notazione possono essere stampati in
1187 @lilypond[quote,verbatim,relative=1]
1189 ees\finger \markup \tied-lyric #"4~1"
1190 fis_\markup { \dynamic rf }
1201 Più in generale, qualsiasi simbolo musicale disponibile può essere incluso
1202 separatamente in un oggetto markup, come è illustrato sotto. Una lista
1203 completa di questi simboli e dei loro nomi si trova in
1204 @ref{The Feta font}.
1206 @lilypond[quote,verbatim,relative=2]
1208 c'^\markup { \musicglyph #"eight" }
1210 c,8._\markup { \musicglyph #"clefs.G_change" }
1212 c2^\markup { \musicglyph #"timesig.neomensural94" }
1215 Un altro modo per stampare glifi non testuali è descritto in
1216 @ref{Fonts explained}. È utile per stampare parentesi di varie
1219 La modalità markup supporta anche i diagrammi per strumenti specifici:
1221 @lilypond[quote,verbatim,relative=2]
1223 \fret-diagram-terse #"x;x;o;2;3;2;"
1226 \harp-pedal #"^-v|--ov^"
1231 \musicglyph #"accordion.discant"
1233 \raise #0.5 \musicglyph #"accordion.dot"
1234 \raise #1.5 \musicglyph #"accordion.dot"
1238 @c The accordion diagram is actually taken from a snippet.
1241 Questi diagrammi sono documentati in @ref{Instrument Specific Markup}.
1243 @cindex partitura dentro il blocco markup
1244 @cindex markup, partitura dentro
1246 È possibile annidare perfino un'intera partitura in un oggetto markup. In tal
1247 caso, il blocco @code{\score} annidato deve contenere un blocco @code{\layout},
1248 come è illustrato qui:
1250 @lilypond[quote,verbatim,relative=1]
1253 \relative { c'4 d e f }
1261 Una lista completa dei comandi relativi alla notazione musicale si trova
1265 Guida alla notazione:
1267 @ref{The Feta font},
1268 @ref{Fonts explained}.
1271 @file{scm/define-markup-commands.scm},
1272 @file{scm/fret-diagrams.scm},
1273 @file{scm/harp-pedals.scm}.
1278 Guida al funzionamento interno:
1279 @rinternals{TextScript}.
1282 @node Testo formattato su più pagine
1283 @unnumberedsubsubsec Testo formattato su più pagine
1284 @translationof Multi-page markup
1286 @cindex testo formattato su più pagine
1287 @cindex markup, multipagina
1288 @cindex multipagina, testo
1289 @cindex testo esteso su più pagine
1291 @funindex \markuplist
1292 @funindex markuplist
1293 @funindex \justified-lines
1294 @funindex justified-lines
1295 @funindex \wordwrap-lines
1296 @funindex wordwrap-lines
1298 Sebbene gli oggetti di markup standard non possano avere interruzioni, una
1299 specifica sintassi permette di inserire linee di testo che possono estendersi
1302 @lilypond[quote,verbatim]
1305 Un testo molto lungo di linee giustificate.
1309 Un altro paragrafo molto lungo.
1316 Questa sintassi accetta una lista di oggetti di markup, che possono essere
1319 il risultato di un comando \markuplist,
1321 una lista di markup,
1323 una lista di \markuplists.
1326 Una lista completa dei comandi che si possono usare con \markuplist si
1327 trova in @ref{Text markup list commands}.
1330 Guida alla notazione:
1331 @ref{Text markup list commands}.
1334 @rextend{New markup list command definition}.
1337 @file{scm/define-markup-commands.scm}.
1342 Guida al funzionamento interno:
1343 @rinternals{TextScript}.
1345 @funindex \markuplist
1346 @funindex markuplist
1353 @node Tipi di carattere
1354 @subsection Tipi di carattere
1355 @translationof Fonts
1357 Questa sezione presenta il modo in cui sono gestiti i tipi di carattere e come
1358 possono essere modificati nelle partiture.
1361 * Tipi di carattere in dettaglio::
1362 * Tipi di carattere per singolo oggetto::
1363 * Tipi di carattere per l'intero documento::
1366 @node Tipi di carattere in dettaglio
1367 @unnumberedsubsubsec Tipi di carattere in dettaglio
1368 @translationof Fonts explained
1371 @cindex tipi di carattere
1373 @cindex graffe, varie dimensioni
1374 @cindex font non testuali nel markup
1376 @funindex font-interface
1378 I tipi di carattere vengono gestiti attraverso varie librerie. FontConfig
1379 rileva i tipi di carattere disponibili nel sistema; i tipi selezionati
1380 sono riprodotti con Pango.
1382 I tipi di carattere della notazione musicale possono essere descritti
1383 come un insieme di glifi specifici, ordinati in varie famiglie. La
1384 seguente sintassi permette di usare vari caratteri @code{feta} di LilyPond
1385 (non testuali) direttamente nella modalità markup:
1387 @lilypond[quote,verbatim,relative=2]
1390 \override #'(font-encoding . fetaBraces)
1392 \override #'(font-encoding . fetaText)
1394 \override #'(font-encoding . fetaMusic)
1395 \lookup #"noteheads.s0petrucci"
1401 Tuttavia, tutti questi glifi, ad eccezione delle graffe di varie
1402 dimensioni contenute in @code{fetaBraces}, sono già utilizzabili
1403 con la sintassi ben più semplice descritta in @ref{Music notation inside markup}.
1405 Quando si usano i glifi contenuti in @code{fetaBraces}, la dimensione
1406 della graffa viene specificata dalla parte numerica del nome del glifo,
1407 in unità arbitrarie. Può essere specificato qualsiasi numero intero da
1408 @code{0} a @code{575} compresi, dove @code{0} corrisponde alla graffa
1409 più piccola. Il valore ottimale deve essere determinato per tentativi.
1410 Questi glifi sono tutte graffe sinistre; le graffe destre si possono
1411 ottenere con la rotazione, vedi @ref{Rotating objects}.
1413 Sono disponibili tre famiglie di tipi di carattere: il @emph{roman}
1414 (con grazie), che usa di default New Century Schoolbook, il
1415 @emph{sans} (senza grazie) e il tipo monospaziato @emph{typewriter} -- queste
1416 ultime due famiglie sono determinate dall'installazione di Pango.
1418 @warning{Non ci sono tipi predefiniti associati con le famiglie @emph{sans}
1419 e @emph{typewriter}. Un file di input che usa una di queste famiglie
1420 può produrre output diversi su computer diversi. Per garantire un output
1421 coerente su piattaforme diverse, occorre specificare i tipi di carattere
1422 per nome e quei tipi devono essere presenti in qualsiasi sistema che
1423 elabori il file. Si veda @ref{Single entry fonts} e
1424 @ref{Entire document fonts}.}
1426 Ogni famiglia può avere forme e serie differenti. L'esempio seguente
1427 illustra la possibilità di scegliere famiglie, forme, serie e
1428 dimensioni alternative. Il valore specificato per @code{font-size} è
1429 la modifica relativa alla dimensione predefinita.
1431 @lilypond[quote,verbatim,relative=2]
1432 \override Score.RehearsalMark.font-family = #'typewriter
1433 \mark \markup "Ouverture"
1434 \override Voice.TextScript.font-shape = #'italic
1435 \override Voice.TextScript.font-series = #'bold
1436 d2.^\markup "Allegro"
1437 \override Voice.TextScript.font-size = #-3
1442 Una sintassi simile si usa nella modalità markup; tuttavia in questo
1443 caso è preferibile usare la sintassi più semplice spiegata in
1444 @ref{Selecting font and font size}:
1446 @lilypond[quote,verbatim]
1450 \override #'(font-shape . italic)
1451 \override #'(font-size . 4)
1455 \override #'(font-family . typewriter)
1457 \override #'(font-series . bold)
1461 \override #'(font-family . sans)
1468 Sebbene sia semplice passare a un tipo di carattere preconfigurato, è anche
1469 possibile usare altri tipi, come viene spiegato nelle sezioni successive:
1470 @ref{Single entry fonts} e @ref{Entire document fonts}.
1473 Guida alla notazione:
1474 @ref{The Feta font},
1475 @ref{Music notation inside markup},
1476 @ref{Rotating objects},
1477 @ref{Selecting font and font size},
1481 @node Tipi di carattere per singolo oggetto
1482 @unnumberedsubsubsec Tipi di carattere per singolo oggetto
1483 @translationof Single entry fonts
1485 Si può usare nella partitura qualsiasi tipo di carattere che sia installato
1486 nel sistema operativo e riconosciuto da FontConfig, usando la seguente
1489 @lilypond[quote,verbatim,relative=2]
1490 \override Staff.TimeSignature.font-name = #"Bitstream Charter"
1491 \override Staff.TimeSignature.font-size = #2
1495 \override #'(font-name . "Vera Bold")
1500 @cindex tipi di carattere, trovare quelli disponibili
1501 @cindex trovare i tipi di carattere disponibili
1502 @cindex elencare i tipi di carattere disponibili
1503 @cindex tipi di carattere disponibili, elenco
1505 @funindex show-available-fonts
1507 Lanciando lilypond con la seguente opzione si ottiene un elenco di tutti i
1508 tipi di carattere disponibili nel sistema operativo:
1511 lilypond -dshow-available-fonts x
1515 Guida alla notazione:
1516 @ref{Fonts explained},
1517 @ref{Entire document fonts}.
1522 @c A source file gets never installed...
1524 @c @file{lily/font-config-scheme.cc}.
1527 @node Tipi di carattere per l'intero documento
1528 @unnumberedsubsubsec Tipi di carattere per l'intero documento
1529 @translationof Entire document fonts
1531 È possibile modificare i tipi di carattere usati come tipi predefiniti
1532 nelle famiglie @emph{roman}, @emph{sans} e @emph{typewriter} specificandoli, in
1533 questo ordine, come è mostrato nell'esempio seguente, che ridimensiona
1534 automaticamente i caratteri col valore impostato per la dimensione globale
1535 del rigo. I tipi di carattere sono spiegati in @ref{Fonts explained}.
1537 @cindex famiglie di tipi di carattere, impostare
1538 @cindex tipi di carattere, modificarli per l'intero documento
1540 @funindex make-pango-font-tree
1542 @lilypond[verbatim,quote]
1545 (make-pango-font-tree "Times New Roman"
1548 (/ staff-height pt 20)))
1555 \typewriter typewriter. }
1559 @c we don't do Helvetica / Courier, since GS incorrectly loads
1563 Guida alla notazione:
1564 @ref{Fonts explained},
1565 @ref{Single entry fonts},
1566 @ref{Selecting font and font size},