]> git.donarmstrong.com Git - lilypond.git/blob - Documentation/it/usage/running.itely
Merge branch 'lilypond/translation' of ssh://thsoft@git.sv.gnu.org/srv/git/lilypond...
[lilypond.git] / Documentation / it / usage / running.itely
1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: it -*-
2
3 @ignore
4     Translation of GIT committish: cff226053d927e433473697fe743bdfd721d2607
5
6     When revising a translation, copy the HEAD committish of the
7     version that you are working on.  For details, see the Contributors'
8     Guide, node Updating translation committishes..
9 @end ignore
10
11 @c \version "2.14.0"
12
13
14 @node Eseguire lilypond
15 @chapter Eseguire @command{lilypond}
16 @translationof Running LilyPond
17
18 Questo capitolo descrive dettagliatamente gli aspetti tecnici dell'esecuzione
19 di LilyPond.
20
21 @menu
22 * Uso normale::
23 * Uso da linea di comando::
24 * Messaggi di errore::
25 * Errori comuni::
26 @end menu
27
28
29 @node Uso normale
30 @section Uso normale
31 @translationof Normal usage
32
33 La maggior parte degli utenti esegue LilyPond attraverso un'interfaccia grafica
34 (GUI); se non lo hai già fatto, leggi il @rlearning{Tutorial}.  Se usi un editor
35 diverso per scrivere i file lilypond, leggi la documentazione di quel programma.
36
37
38 @node Uso da linea di comando
39 @section Uso da linea di comando
40 @translationof Command-line usage
41
42 Questa sezione contiene informazioni aggiuntive sull'uso di LilyPond da linea
43 di comando.  Questo può essere utile per assegnare opzioni aggiuntive al programma.
44 Inoltre, ci sono alcuni programmi complementari di @q{aiuto} (come
45 @code{midi2ly}) che funzionano solo da linea di comando.
46
47 Con @q{linea di comando} si intende la linea di comando del sistema operativo.
48 Gli utenti Windows avranno più familiarità con i termini @q{shell DOS} o
49 @q{shell dei comandi}.  Gli utenti MacOS@tie{}X avranno più familiarità con i termini
50 @q{terminale} o @q{console}.  Una configurazione ulteriore è necessaria
51 per gli utenti MacOS@tie{}X; si veda @rweb{MacOS X}.
52
53 Descrivere come usare questa parte di un sistema operativo non rientra negli
54 obiettivi di questo manuale; si prega di consultare altra documentazione su
55 questo argomento se non si conosce la linea di comando.
56
57 @menu
58 * Utilizzo di lilypond::
59 * Opzioni della linea di comando per lilypond::
60 * Variabili d'ambiente::
61 * LilyPond in una gabbia chroot::
62 @end menu
63
64 @node Utilizzo di lilypond
65 @unnumberedsubsec Utilizzo di @command{lilypond}
66 @translationof Invoking lilypond
67
68 L'eseguibile @command{lilypond} può essere lanciato dalla linea di comando
69 nel seguente modo.
70
71 @example
72 lilypond [@var{opzione}]@dots{} @var{file}@dots{}
73 @end example
74
75
76 Se invocato con un nome di file senza estensione, viene tentata per prima
77 l'estensione @file{.ly}.  Per leggere l'input da stdin, usare un
78 trattino (@code{-}) al posto di @var{file}.
79
80 Quando @file{file.ly} viene elaborato, lilypond creerà @file{file.ps}
81 e @file{file.pdf} come output.  Possono essere specificati molti file;
82 ognuno di essi sarà elaborato in modo indipendente.  @footnote{Lo status di
83 GUILE non viene resettato dopo l'elaborazione di un file @code{.ly}:
84 attenzione a non cambiare alcun valore predefinito dall'interno di Scheme.}
85
86 Se @file{file.ly} contiene più di un blocco @code{\book}, allora tutte le altre
87 partiture verranno salvate in file numerati, a partire da @file{file-1.pdf}.  Inoltre,
88 il valore di @code{output-suffix} (suffisso di output) sarà inserito tra la base
89 del nome del file e il numero.  Un file di input che contiene
90
91 @example
92 #(define output-suffix "violin")
93 \score @{ @dots{} @}
94 #(define output-suffix "cello")
95 \score @{ @dots{} @}
96 @end example
97
98 @noindent
99 produrrà come output @var{base}@file{-violin.pdf} e
100 @var{base}@file{-cello-1.pdf}.
101
102
103 @unnumberedsubsubsec Comandi standard da shell
104
105 Se la shell (ovvero la finestra dei comandi) utilizzata supporta le normali
106 redirezioni, potrebbe essere utile usare i seguenti comandi per dirigere
107 l'output di una console in un file:
108
109 @itemize
110
111 @item
112 @code{lilypond file.ly 1>stdout.log} per redirigere l'output normale
113
114 @item
115 @code{lilypond file.ly 2>stderr.log} per redirigere i messaggi di errore
116
117 @item
118 @code{lilypond file.ly &>all.log} per redirigere tutto l'output
119
120 @end itemize
121
122 Consulta la documentazione della tua shell per vedere se supporta queste
123 opzioni o se la sintassi è diversa.  Nota che questi sono comandi shell
124 e non hanno niente a che fare con lilypond.
125
126
127 @node Opzioni della linea di comando per lilypond
128 @unnumberedsubsec Opzioni della linea di comando per @command{lilypond}
129 @translationof Command line options for lilypond
130
131 @cindex Utilizzo di @command{lilypond}
132 @cindex opzioni della linea di comando per @command{lilypond}
133 @cindex linea di comando, opzioni di
134 @cindex switches
135
136 Sono contemplate le seguenti opzioni:
137
138 @table @code
139
140 @item -e,--evaluate=@var{espressione}
141 Valuta l'@var{espressione} di Scheme prima di analizzare qualsiasi file @file{.ly}.
142 Si possono specificare varie opzioni @code{-e}; saranno analizzate in modo
143 sequenziale.
144
145 L'espressione sarà analizzata nel modulo @code{guile-user}, dunque se vuoi
146 usare delle definizioni in @var{espressione}, usa
147
148 @example
149 lilypond -e '(define-public a 42)'
150 @end example
151
152 @noindent
153 nella linea di comando, e includi
154
155 @example
156 #(use-modules (guile-user))
157 @end example
158
159 @noindent
160 in cima al file @code{.ly}.
161
162 @item -f,--format=@var{formato}
163 Formati di output.  Come @code{formato} si può scegliere tra
164 @code{ps}, @code{pdf}, e @code{png}.
165
166 Esempio: @code{lilypond -fpng @var{file}.ly}
167
168
169
170 @item -d,--define-default=@var{variabile}=@var{valore}
171 Imposta l'opzione interna del programma, @var{variabile}, al valore di Scheme
172 @var{valore}.  Se @var{valore} non viene specificato, allora viene usato
173 @var{#t}.  Per disabilitare un'opzione, si può usare il prefisso @code{no-}
174 prima della @var{variabile}, ad esempio
175
176 @cindex punta e clicca, linea di comando
177
178 @example
179 -dno-point-and-click
180 @end example
181
182 @noindent
183 è equivalente a
184 @example
185 -dpoint-and-click='#f'
186 @end example
187
188 Di seguito alcune opzioni interessanti.
189
190 @cindex aiuto, linea di comando
191
192 @table @samp
193 @item help
194 L'esecuzione di @code{lilypond -dhelp} mostrerà tutte le opzioni disponibili
195 di @code{-d}.
196
197 @cindex paper-size, linea di comando
198
199 @item paper-size
200 Questa opzione imposta la dimensione predefinita del foglio,
201 @example
202 -dpaper-size=\"letter\"
203 @end example
204
205 @noindent
206 Nota che la stringa deve essere compresa tra virgolette precedute dal
207 segno di escape ( @code{\"} ).
208 @c Match " in previous line to help context-sensitive editors
209
210 @cindex safe, linea di comando
211
212 @item safe
213 Non si fida dell'input nel file @code{.ly}.
214
215 Quando la formattazione di LilyPond viene messa a disposizione tramite un server
216 web, si @b{DEVE} passare l'opzione @code{--safe} o l'opzione @code{--jail}.  L'opzione
217 @code{--safe} impedirà che il codice Scheme presente nell'input possa fare uno
218 scempio, ad esempio
219
220 @quotation
221 @verbatim
222 #(system "rm -rf /")
223 {
224   c4^#(ly:export (ly:gulp-file "/etc/passwd"))
225 }
226 @end verbatim
227 @end quotation
228
229 L'opzione @code{-dsafe} serve a valutare le espressioni Scheme presenti nell'input
230 in uno speciale modulo di sicurezza.  Questo modulo di sicurezza è derivato dal
231 modulo GUILE @file{safe-r5rs}, ma aggiunge alcune funzioni del
232 LilyPond API.  Queste funzioni sono elencate in @file{scm/safe-lily.scm}.
233
234 Inoltre, la modalità sicura non permette le direttive @code{\include} e
235 disabilita l'uso del backslash nelle stringhe @TeX{}.
236
237 In modalità sicura, non è possibile importare le variabili di LilyPond
238 in Scheme.
239
240 @code{-dsafe} @emph{non} rileva il sovrautilizzo di risorse.  È ancora possibile
241 far sì che il programma rimanga in sospeso per un tempo indefinito, ad esempio
242 alimentando il backend con strutture di dati cicliche.  Dunque se si vuole usare
243 LilyPond su un server web pubblicamente accessibile, si deve limitare il processo
244 nell'uso della CPU e della memoria.
245
246 La modalità sicura bloccherà la compilazione di molti utili frammenti di codice
247 LilyPond.  L'opzione @code{--jail} è un'alternativa più sicura, ma richiede
248 più lavoro per configurarla.
249
250 @cindex formato di output, impostare il
251 @item backend
252 il formato di output da usare per il back-end.  Per il @code{formato} si può
253 scegliere tra
254 @table @code
255 @item ps
256 @cindex PostScript, output
257  per PostScript.
258
259   I file Postscript includono i tipi di carattere TTF, Type1 e OTF.  Non vengono
260   inclusi i sottoinsiemi di questi tipi.  Se si usa un set di caratteri orientali,
261   si possono ottenere file di grosse dimensioni.
262
263 @item eps
264
265 @cindex Postscript, incapsulato
266 @cindex EPS (Encapsulated PostScript)
267
268  per PostScript incapsulato.  Invia ogni pagina (sistema) in un file
269 @file{EPS} separato, senza font, e in un unico file @file{EPS} con
270 tutte le pagine (sistemi) inclusi i font.
271
272 Questa è la modalità predefinita di @command{lilypond-book}.
273
274 @item svg
275
276 @cindex SVG (Scalable Vector Graphics)
277
278  per ottenere SVG (Scalable Vector Graphics).
279
280  Crea un singolo file SVG, senza font incorporati, per ogni pagina
281  dell'output.  Si raccomanda di installare i font Century
282  Schoolbook, inclusi nell'installazione di LilyPond, per una resa
283  ottimale.  In UNIX basta copiare questi font dalla directory di
284  LilyPond (solitamente
285  @file{/usr/share/lilypond/VERSION/fonts/otf/}) in
286  @file{~/.fonts/}.  L'output SVG dovrebbe essere compatibile con qualsiasi
287  editor SVG o user agent.
288
289 @item scm
290
291 @cindex Scheme, estrazione di
292
293  per estrarre i comandi di disegno grezzi e interni, basati su Scheme.
294
295 @item null
296  non produce la stampa della partitura; ha lo stesso effetto di @code{-dno-print-pages}.
297 @end table
298
299 Esempio: @code{lilypond -dbackend=svg @var{filename}.ly}
300
301 @item preview
302 @cindex preview, linea di comando
303 Genera un file di output che contiene i titoli e il primo sistema
304 del brano musicale.  Se si usano i blocchi @code{\bookpart}, i titoli e il
305 primo sistema di ogni @code{\bookpart} apparirà nell'output.
306 I backend @code{ps}, @code{eps}, e @code{svg} supportano questa
307 opzione.
308
309 @item print-pages
310 Genera tutte le pagine, come da impostazione predefinita.  @code{-dno-print-pages} è
311 utile in combinazione con @code{-dpreview}.
312
313 @end table
314
315
316
317 @item -h,--help
318 Mostra una sintesi dell'utilizzo.
319
320 @item -H,--header=@var{CAMPO}
321 Estrae un campo dell'intestazione nel file @file{NOME.@var{CAMPO}}.
322
323 @cindex ricerca dei file
324 @cindex percorso di ricerca
325 @item --include, -I=@var{directory}
326 Aggiunge @var{directory} al percorso di ricerca per i file di input.
327
328 È possibile assegnare più opzioni -I.  La ricerca inizierà nella prima
329 directory definita, e se il file da includere non viene trovato
330 la ricerca continuerà nelle directory seguenti.
331
332 @item -i,--init=@var{file}
333 Imposta il file di inizializzazione su @var{file} (predefinito: @file{init.ly}).
334
335 @cindex cartella, dirigere l'output in
336 @cindex nome del file di output, impostare
337
338 @item -o,--output=@var{FILE} or @var{CARTELLA}
339 Imposta il file di output predefinito @var{FILE} oppure, se una cartella con
340 quel nome esiste già, dirige l'output in @var{CARTELLA}, prendendo il nome
341 del file dal file di input.  In entrambi i casi verrà aggiunto il suffisso
342 appropriato (ad esempio @code{.pdf} per il pdf).
343
344
345 @cindex PostScript
346
347 @item --ps
348 Genera PostScript.
349
350 @cindex Portable Network Graphics (PNG)
351
352 @item --png
353 Genera immmagini di ogni pagina in formato PNG.  Questo implica
354 @code{--ps}.  La risoluzione in DPI dell'immagine può essere impostata con
355 @example
356 -dresolution=110
357 @end example
358
359 @cindex Portable Document Format (PDF)
360
361 @item --pdf
362 Genera PDF.  Questo implica @code{--ps}.
363
364
365
366 @item -j,--jail=@var{utente},@var{gruppo},@var{gabbia},@var{directory}
367 Esegue @command{lilypond} in una gabbia chroot.
368
369 L'opzione @code{--jail} fornisce un'alternativa più flessibile a
370 @code{--safe} quando la formattazione di LilyPond è messa a disposizione attraverso
371 un server web o quando LilyPond esegue sorgenti provenienti dall'esterno.
372
373 L'opzione @code{--jail} modifica la radice di @command{lilypond} in
374 @var{gabbia} appena prima di iniziare il vero processo di compilazione.  L'utente
375 e il gruppo vengono poi modificati per corrispondere a quelli forniti, e la
376 directory corrente viene spostata in @var{directory}.  Questa configurazione
377 garantisce che non sia possibile (almeno in teoria) uscire dalla gabbia.  Si noti
378 che perché @code{--jail} funzioni @command{lilypond} deve essere eseguito come root;
379 di solito questo si fa in modo sicuro col comando @command{sudo}.
380
381 Configurare una gabbia è una questione un po' delicata, perché bisogna essere
382 sicuri che LilyPond possa trovare tutto quello di cui ha bisogno per compilare il
383 sorgente @emph{dentro la gabbia}.  Una configurazione tipica comprende i seguenti
384 elementi:
385
386 @table @asis
387 @item Impostare un filesystem distinto
388 Si dovrebbe creare un filesystem separato LilyPond, così che possa essere
389 montato con opzioni di sicurezza come @code{noexec}, @code{nodev}, e
390 @code{nosuid}.  In questo modo è impossibile lanciare degli eseguibili o
391 scrivere su un dispositivo direttamente da LilyPond.  Se non si vuole creare
392 una partizione separata, si può creare un file di dimensioni ragionevoli e usarlo
393 per montare un dispositivo di loop.  Un filesystem separato garantisce inoltre
394 che LilyPond non possa scrivere su uno spazio maggiore di quanto permesso.
395
396 @item Impostare un altro utente
397 Per eseguire LilyPond in una gabbia si dovrebbe usare un altro utente e gruppo
398 (ad esempio, @code{lily}/@code{lily}) con pochi privilegi.  Ci dovrebbe essere
399 una sola directory scrivibile da questo utente, che dovrebbe essere passata in
400 @var{dir}.
401
402 @item Preparare la gabbia
403 LilyPond ha bisogno di leggere alcuni file quando viene lanciato.  Tutti questi
404 file devono essere copiati nella gabbia, sotto lo stesso percorso in cui appaiono
405 nel vero filesystem principale.  Si deve copiare l'intero contenuto dell'installazione
406 LilyPond installation (ad esempio, @file{/usr/share/lilypond}).
407
408 Se c'è un problema, il modo più semplice per individuarlo è lanciare
409 LilyPond usando @command{strace}, che permetterà di scoprire quali
410 file mancano.
411
412 @item Eseguire LilyPond
413 In una gabbia montata con @code{noexec} è impossibile eseguire qualsiasi
414 programma esterno.  Dunque LilyPond deve essere eseguito con un backend che
415 non richieda tale programma.  Come è già stato detto, deve essere eseguito
416 con privilegi di superutente (che ovviamente perderà immediatamente),
417 possibilmente con l'uso di @command{sudo}.  È una buona idea limitare il
418 numero di secondi di tempo della CPU che LilyPond può usare (ad esempio con @command{ulimit
419 -t}), e, se il sistema operativo lo permette, la quantità di memoria che
420 può essere allocata.
421 @end table
422
423
424 @item -v,--version
425 Mostra informazioni sulla versione.
426
427 @item -V,--verbose
428 Aumenta la prolissità: mostra i percorsi completi di tutti i file letti, e dà
429 informazioni sui tempi.
430
431 @item -w,--warranty
432 Mostra la garanzia con cui viene distribuito GNU LilyPond.  (Distribuito
433 con @strong{NESSUNA GARANZIA}!)
434 @end table
435
436
437 @node Variabili d'ambiente
438 @unnumberedsubsec Variabili d'ambiente
439 @translationof Environment variables
440
441 @cindex LANG
442 @cindex LILYPOND_DATADIR
443
444 @command{lilypond} riconosce le seguenti variabili d'ambiente:
445 @table @code
446 @item LILYPOND_DATADIR
447 Specifica la directory predefinita in cui saranno cercati i messaggi della
448 localizzazione e i file di dati.  Questa directory deve contenere
449 sottodirectory chiamate @file{ly/}, @file{ps/}, @file{tex/}, etc.
450
451 @item LANG
452 Determina la lingua per i messaggi di avviso.
453
454 @item LILYPOND_GC_YIELD
455 Una variabile, in forma di percentuale, che regola il modo in cui viene gestita
456 la memoria.  Con valori più alti il programma usa più memoria, con valori
457 più bassi usa più tempo della CPU.  Il valore predefinito è @code{70}.
458
459 @end table
460
461
462 @node LilyPond in una gabbia chroot
463 @unnumberedsubsec LilyPond in una gabbia chroot
464 @translationof LilyPond in chroot jail
465
466 Configurare un server perché esegua LilyPond in una gabbia chroot è un lavoro
467 complesso.  La procedura è spiegata sotto.  Gli esempi si riferiscono a
468 Ubuntu Linux e potrebbero richiedere l'uso di @code{sudo} in alcune situazioni.
469
470 @itemize
471
472 @item Installa i pacchetti necessari: LilyPond, GhostScript e ImageMagick.
473
474 @item Crea un nuovo utente dal nome @code{lily}:
475
476 @example
477 adduser lily
478 @end example
479
480 @noindent
481 Questo comando creerà anche un nuovo gruppo per l'utente @code{lily}, e una
482 cartella home,
483 @code{/home/lily}
484
485 @item Nella cartella home dell'utente @code{lily} crea un file da usare come
486 filesystem separato:
487
488 @example
489 dd if=/dev/zero of=/home/lily/loopfile bs=1k count= 200000
490 @end example
491
492 @noindent
493 In questo esempio è stato creato un file di 200MB da usare come filesystem della
494 gabbia.
495
496 @item Crea un dispositivo di loop, crea e monta un filesystem, quindi crea
497 una cartella scrivibile dall'utente @code{lily}:
498
499 @example
500 mkdir /mnt/lilyloop
501 losetup /dev/loop0 /home/lily/loopfile
502 mkfs -t ext3 /dev/loop0 200000
503 mount -t ext3 /dev/loop0 /mnt/lilyloop
504 mkdir /mnt/lilyloop/lilyhome
505 chown lily /mnt/lilyloop/lilyhome
506 @end example
507
508 @item Nella configurazione dei server, JAIL sarà @code{/mnt/lilyloop}
509 e DIR sarà @code{/lilyhome}.
510
511 @item Crea un grande albero delle directory nella gabbia copiando i file
512 necessari, come mostrato nello script di esempio più in basso.
513
514 Puoi usare @code{sed} per creare i comandi di copia necessari per un certo
515 eseguibile:
516
517 @example
518 for i in "/usr/local/lilypond/usr/bin/lilypond" "/bin/sh" "/usr/bin/;  \
519   do ldd $i | sed 's/.*=> \/\(.*\/\)\([^(]*\).*/mkdir -p \1 \&\&  \
520     cp -L \/\1\2 \1\2/' | sed 's/\t\/\(.*\/\)\(.*\) (.*)$/mkdir -p  \
521       \1 \&\& cp -L \/\1\2 \1\2/' | sed '/.*=>.*/d'; done
522 @end example
523
524 @end itemize
525
526 @subheading Script di esempio per Ubuntu 8.04 a 32-bit
527
528 @example
529 #!/bin/sh
530 ## defaults set here
531
532 username=lily
533 home=/home
534 loopdevice=/dev/loop0
535 jaildir=/mnt/lilyloop
536 # the prefix (without the leading slash!)
537 lilyprefix=usr/local
538 # the directory where lilypond is installed on the system
539 lilydir=/$lilyprefix/lilypond/
540
541 userhome=$home/$username
542 loopfile=$userhome/loopfile
543 adduser $username
544 dd if=/dev/zero of=$loopfile bs=1k count=200000
545 mkdir $jaildir
546 losetup $loopdevice $loopfile
547 mkfs -t ext3 $loopdevice 200000
548 mount -t ext3 $loopdevice $jaildir
549 mkdir $jaildir/lilyhome
550 chown $username $jaildir/lilyhome
551 cd $jaildir
552
553 mkdir -p bin usr/bin usr/share usr/lib usr/share/fonts $lilyprefix tmp
554 chmod a+w tmp
555
556 cp -r -L $lilydir $lilyprefix
557 cp -L /bin/sh /bin/rm bin
558 cp -L /usr/bin/convert /usr/bin/gs usr/bin
559 cp -L /usr/share/fonts/truetype usr/share/fonts
560
561 # Now the library copying magic
562 for i in "$lilydir/usr/bin/lilypond" "$lilydir/usr/bin/guile" "/bin/sh"  \
563   "/bin/rm" "/usr/bin/gs" "/usr/bin/convert"; do ldd $i | sed 's/.*=>  \
564     \/\(.*\/\)\([^(]*\).*/mkdir -p \1 \&\& cp -L \/\1\2 \1\2/' | sed  \
565       's/\t\/\(.*\/\)\(.*\) (.*)$/mkdir -p \1 \&\& cp -L \/\1\2 \1\2/'  \
566         | sed '/.*=>.*/d'; done | sh -s
567
568 # The shared files for ghostscript...
569       cp -L -r /usr/share/ghostscript usr/share
570 # The shared files for ImageMagick
571       cp -L -r /usr/lib/ImageMagick* usr/lib
572
573 ### Now, assuming that you have test.ly in /mnt/lilyloop/lilyhome,
574 ### you should be able to run:
575 ### Note that /$lilyprefix/bin/lilypond is a script, which sets the
576 ### LD_LIBRARY_PATH - this is crucial
577       /$lilyprefix/bin/lilypond -jlily,lily,/mnt/lilyloop,/lilyhome test.ly
578 @end example
579
580 @c " keep quote signs balanced for context-sensitive editors
581
582 @node Messaggi di errore
583 @section Messaggi di errore
584 @translationof Error messages
585
586 @cindex messaggi di errore
587 Quando si compila un file possono apparire vari messaggi di errore:
588
589 @table @emph
590
591 @item Avvertimento
592 @cindex avvertimento
593 Qualcosa appare sospetto.  Se stai cercando di fare qualcosa di insolito
594 allora comprenderai il messaggio e potrai ignorarlo.
595 Tuttavia di solito i messaggi di avvertimento indicano che il file di input ha
596 qualcosa che non va.
597
598 @item Errore
599 @cindex errore
600 C'è qualcosa di assolutamente sbagliato.  Il passo attualmente in elaborazione
601 (analisi, interpretazione o formattazione) verrà completato, ma il passo
602 successivo verrà saltato.
603
604 @item Errore fatale
605 @cindex errore fatale
606 C'è qualcosa di assolutamente sbagliato e LilyPond non può continuare.  Questo
607 accade raramente.  La causa più comune è un'errata installazione dei tipi di
608 carattere.
609
610 @item Errore Scheme
611 @cindex traccia, Scheme
612 @cindex traccia di chiamata
613 @cindex errore Scheme
614 Gli errori che capitano mentre si esegue del codice Scheme sono individuati
615 dall'interprete Scheme.  Se si esegue con l'opzione di prolissità (@code{-V} o
616 @code{--verbose}), viene stampata una traccia della chiamata di funzione
617 responsabile dell'errore.
618
619 @item Errore di programmazione
620 @cindex Errore di programmazione
621 Si è verificata una qualche incongruenza interna.  Questi messaggi di errore
622 servono ad aiutare programmatori e debugger.  Di solito si possono
623 ignorare.  Talvolta sono talmente numerosi da nascondere il resto
624 dell'output.
625
626 @item Sospeso (core dumped)
627 @cindex Sospeso (core dumped)
628 Segnala un serio errore di programmazione che ha mandato in crash il
629 programma.  Questi errori sono considerati critici.  Se ti imbatti in un
630 errore simile, invia una segnalazione di errore.
631 @end table
632
633 @cindex errori, formato del messaggio
634 Se gli avvertimenti e gli errori possono essere collegati
635 a una parte specifica del file di input, i messaggi di errore
636 hanno la seguente forma
637
638 @example
639 @var{file}:@var{riga}:@var{colonna}: @var{messaggio}
640 @var{riga di input responsabile dell'errore}
641 @end example
642
643 Nella riga responsabile si inserisce un a capo per indicare la colonna
644 in cui è stato trovato l'errore.  Ad esempio,
645
646 @example
647 test.ly:2:19: error: not a duration: 5
648   @{ c'4 e'
649            5 g' @}
650 @end example
651
652 Queste posizioni indicano la migliore ipotesi di LilyPond a proposito del
653 punto in cui l'avvertimento o l'errore sono comparsi, ma (per loro
654 stessa natura) avvertimenti ed errori capitano quando succede qualcosa
655 di imprevisto.  Se non riesci a vedere un errore nella riga indicata
656 del file di input, prova a controllare una o due righe sopra la posizione
657 indicata.
658
659 Maggiori informazioni sugli errori si trovano in @ref{Errori comuni}.
660
661
662 @node Errori comuni
663 @section Errori comuni
664 @translationof Common errors
665
666 Le condizioni di errore descritte di seguito capitano spesso, ma la causa
667 non è ovvia né facile da trovare.  Una volta che sono state individuate e
668 comprese, è facile gestirle.
669
670
671 @menu
672 * La musica esce dalla pagina::
673 * Appare un rigo in più::
674 * Errore apparente in ../ly/init.ly::
675 * Messaggio di errore Unbound variable %::
676 * Messaggio di errore FT_Get_Glyph_Name::
677 * Avvertimento sul fatto che le affinità del rigo devono solo diminuire::
678 @end menu
679
680 @node La musica esce dalla pagina
681 @unnumberedsubsec La musica esce dalla pagina
682 @translationof Music runs off the page
683
684 Se la musica esce dalla pagina al di là del margine destro o appare
685 eccessivamente compressa, quasi sempre è dovuto all'inserimento di
686 una durata errata di una nota, che fa sì che l'ultima nota di una misura si
687 estenda oltre la barra di divisione.  Non è sbagliato se la nota finale di
688 una misura non termina entro la barra di divisione inserita automaticamente, perché
689 semplicemente si assume che la nota continui nella misura successiva.  Ma se
690 si presenta una lunga sequenza di misure simili, la musica può
691 apparire compressa o può uscire dalla pagina perché gli a capo
692 automatici possono essere inseriti soltanto alla fine di misure complete,
693 ovvero quando tutte le note finiscono prima o alla fine della misura.
694
695 @warning{Una durata sbagliata può inibire l'interruzione di
696 linea, portando a una linea di musica estremamente compressa o
697 a musica che esce dalla pagina.}
698
699 La durata errata può essere trovata facilmente se si usano i controlli di
700 battuta, si veda @ruser{Bar and bar number checks}.
701
702 Se si vuole davvero ottenere una serie di tali misure sovrapposte
703 bisogna inserire una barra di divisione invisibile nel punto in cui
704 si desidera l'interruzione di linea.  Per i dettagli si veda @ruser{Bar lines}.
705
706
707 @node Appare un rigo in più
708 @unnumberedsubsec Appare un rigo in più
709 @translationof An extra staff appears
710
711 Se i contesti non sono creati esplicitamente con @code{\new} o
712 @code{\context}, saranno creati senza avviso appena si incontra
713 un comando che non può essere applicato a un contesto
714 esistente.  Nelle partiture semplici la creazione automatica dei contesti
715 è utile: infatti la maggior parte degli esempi nei manuali LilyPond sfrutta
716 questa semplificazione.  Talvolta, però, la creazione silenziosa di contesti
717 può causare la comparsa di nuovi righi o partiture non desiderate.  Ad esempio,
718 si potrebbe pensare che il seguente codice colori di rosso tutte le teste
719 delle note nel rigo, ma in realtà produce due righi, di cui il più basso
720 conserva il colore nero predefinito per le teste delle note.
721
722 @lilypond[quote,verbatim,relative=2]
723 \override Staff.NoteHead #'color = #red
724 \new Staff { a }
725 @end lilypond
726
727 Questo accade perché non esiste un contesto @code{Staff} quando viene
728 elaborata l'istruzione di override, quindi ne viene implicitamente creato uno e
729 l'override viene applicato ad esso.  Ma poi il comando @code{\new Staff} crea
730 un altro rigo separato nel quale vengono inserite le note.  Il codice
731 corretto per colorare le teste di tutte le note è
732
733 @lilypond[quote,verbatim,relative=2]
734 \new Staff {
735   \override Staff.NoteHead #'color = #red
736   a
737 }
738 @end lilypond
739
740 Vediamo un secondo esempio.  Se un comando @code{\relative} viene posto
741 dentro un comando @code{\repeat}, vengono generati due righi, il secondo
742 spostato orizzontalmente rispetto al primo, perché il comando @code{\repeat}
743 genera due blocchi @code{\relative}, ognuno dei quali crea implicitamente i
744 blocchi @code{Staff} e @code{Voice}.
745
746 @lilypond[quote,verbatim]
747 \repeat unfold 2 {
748   \relative c' { c4 d e f }
749 }
750 @end lilypond
751
752 Per correggere il problema basta istanziare esplicitamente il contesto
753 @code{Voice}:
754
755 @lilypond[quote,verbatim]
756 \new Voice {
757   \repeat unfold 2 {
758     \relative c' { c4 d e f }
759   }
760 }
761 @end lilypond
762
763
764 @node Errore apparente in ../ly/init.ly
765 @unnumberedsubsec Errore apparente in @code{../ly/init.ly}
766 @translationof Apparent error in ../ly/init.ly
767
768 Possono apparire diversi strani messaggi di errore relativi a errori di
769 sintassi in @file{../ly/init.ly} se il file di input non ha una forma corretta,
770 ad esempio se contiene delle parentesi o delle virgolette non chiuse
771 correttamente.
772
773 L'errore più comune è la mancanza di una parentesi graffa, (@code{@}}), alla fine
774 di un blocco @code{score}.  In questo caso la soluzione è ovvia: controlla
775 che il blocco @code{score} sia chiuso correttamente.  La struttura corretta
776 di un file di input è descritta in @rlearning{Come funzionano i file di input di LilyPond}.
777 Per evitare questi errori conviene usare un editor che evidenzi automaticamente
778 le parentesi e le graffe corrispondenti.
779
780 Un'altra causa frequente di errore è la mancanza di uno spazio tra l'ultima
781 sillaba di un blocco di testo (lyrics) e la parentesi graffa che chiude il
782 blocco, (@code{@}}).  Senza questa separazione, la graffa viene considerata
783 come parte della sillaba.  Si consiglia di assicurarsi sempre che ci sia
784 uno spazio prima e dopo @emph{ogni} parentesi graffa.  Per comprendere l'importanza
785 di questo quando si usa il testo, si veda @ruser{Entering lyrics}.
786
787 Questo messaggio di errore può apparire anche nel caso in cui sia omessa la
788 virgoletta di chiusura, (@code{"}).  In questo caso il messaggio di errore
789 @c keep "-matching straight in fancy editors
790 dovrebbe dare un numero di riga vicino alla riga sbagliata.  La virgoletta
791 non chiusa sarà solitamente una o due righe sopra.
792
793 @node Messaggio di errore Unbound variable %
794 @unnumberedsubsec Messaggio di errore Unbound variable %
795 @translationof Error message Unbound variable %
796
797 Questo messaggio di errore comparirà in fondo alla console di
798 output o nel file di log insieme al messaggio @qq{GUILE signalled an error ...}
799 ogni volta che viene chiamata una routine di Scheme che contenga (erroneamente)
800 un commento @emph{LilyPond} invece di un commento @emph{Scheme}.
801
802 I commenti LilyPond iniziano con un segno di percentuale, (@code{%}), e non
803 devono essere usati all'interno delle routine di Scheme.  I commenti Scheme
804 iniziano con un punto e virgola, (@code{;}).
805
806 @node Messaggio di errore FT_Get_Glyph_Name
807 @unnumberedsubsec Messaggio di errore FT_Get_Glyph_Name
808 @translationof Error message FT_Get_Glyph_Name
809
810 Questo messaggio di errore compare nella console di output o nel file di log file
811 se un file di input contiene un carattere non-ASCII e non è stato salvato nella
812 codifica UTF-8.  Per dettagli si veda @ruser{Text encoding}.
813
814
815 @node Avvertimento sul fatto che le affinità del rigo devono solo diminuire
816 @unnumberedsubsec Avvertimento sul fatto che le affinità del rigo devono solo diminuire
817 @translationof Warning staff affinities should only decrease
818
819 Questo avvertimento può apparire se non ci sono dei righi nell'output,
820 ad esempio se ci sono solo un contesto @code{ChordName} e un
821 contesto @code{Lyrics}, come in un lead sheet.  Si possono evitare questi
822 messaggi di avvertimento facendo in modo che uno dei contesti si comporti
823 come un rigo inserendo
824
825 @example
826 \override VerticalAxisGroup #'staff-affinity = ##f
827 @end example
828
829 @noindent
830 all'inizio del contesto.  Per dettagli si veda @qq{Spacing of non-staff lines} in
831 @ruser{Flexible vertical spacing within systems}.