1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: it -*-
4 Translation of GIT committish: d36171e34d236d890f5dc511b895037188c6c7cb
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..
13 @node Consigli su come scrivere i file
14 @chapter Consigli su come scrivere i file
15 @translationof Suggestions for writing files
17 Ora puoi iniziare a scrivere file di input di LilyPond più grandi --
18 non più i piccoli esempi del tutorial, ma pezzi completi.
19 Ma qual è il modo migliore di farlo?
21 Finché LilyPond comprende i file di input e produce l'output che
22 desideri, non importa quale aspetto abbiano i file di input. Tuttavia,
23 ci sono altri aspetti da tenere a mente quando si scrivono
24 file di input di LilyPond.
27 @item Che fare in caso di errore? La struttura data a un file LilyPond può
28 rendere l'individuazione di certi tipi di errore più facile (o più difficile).
30 @item Che fare se vuoi inviare i tuoi file di input a qualcuno? E se decidi di
31 modificare i tuoi file di input dopo qualche anno? Alcuni file di input di
32 LilyPond sono comprensibili a prima vista; altri ti possono lasciare a grattarti
35 @item Che fare se vuoi aggiornare il tuo file per poterlo usare con una
36 versione più recente di LilyPond? Con l'evolversi di LilyPond, la sintassi di
37 input si trova soggetta a occasionali cambiamenti. Alcune modifiche possono
38 essere fatte in automatico con @code{convert-ly}, ma altre potrebbero richiedere
39 un intervento manuale. I file di input di LilyPond possono essere strutturati
40 in moda da essere poi aggiornati in modo più semplice (o più difficile).
46 * Scrivere musica esistente::
48 * Risoluzione dei problemi::
53 @node Consigli generali
54 @section Consigli generali
55 @translationof General suggestions
57 Ecco alcuni consigli che possono aiutare a evitare (e risolvere) i
58 problemi più comuni in fase di scrittura:
61 @item @strong{Includere sempre il numero di @code{\version} in ogni file di input},
62 non importa quanto piccolo possa essere il file. Ciò impedisce di dover
63 ricordare con quale versione di LilyPond è stato creato il file ed è
64 importante soprattutto per @ref{Updating files with convert-ly} (che ha
65 bisogno della dichiarazione @code{\version}); o quando si inviano i file
66 di input a altri utenti (per esempio, quando si chiede aiuto nelle mailing
67 list). Nota che tutti i modelli contengono l'informazione su @code{\version}.
70 @strong{Scrivere ciascuna battuta su una singola riga del file di input}. Ciò
71 semplifica molto l'analisi dei problemi del file di input.
74 @strong{Inserire i @ruser{Controlli di battuta e del numero di battuta} e
75 i @ruser{Controlli di ottava}}. Inserendo @q{controlli} di questo tipo nei
76 file di input, si può individuare un errore più rapidamente. Quanto spesso
77 aggiungere i controlli dipende dalla complessità della musica da scrivere. Per
78 composizioni semplici, aggiungere controlli in pochi punti strategici può essere
79 sufficiente, ma per musica più complessa, con molte voci e/o righi, è consigliabile
80 inserire i controlli dopo ogni battuta.
83 @strong{Inserire commenti nei file di input}. Riferimenti a temi musicali
84 (@q{secondo tema nei violini,} @q{quarta variazione,} etc.) o numeri di battuta
85 inseriti come commenti rendono molto più semplice la lettura del file di input,
86 specialmente se occorre modificare qualcosa successivamente o passare i file
87 di input di LilyPond a un'altra persona.
90 @strong{Aggiungere durate esplicite all'inizio delle @q{sezioni}}.
91 Per esempio, @code{c4 d e} invece di @code{c d e f} può semplificare il
92 riarrangiamento della musica in un momento successivo.
95 @strong{Imparare a allineare e indentare le parentesi e la musica parallela}.
96 Molti problemi sono spesso causati da parentesi @q{mancanti}. Indentare
97 chiaramente le parentesi di @q{apertura} e di @q{chiusura} (o gli indicatori
98 @code{<<} e @code{>>}) aiuta a evitare tali problemi. Per esempio,
118 è molto più semplice da leggere di
121 \new Staff @{ \relative @{ r4 g'8 g c4 c8 d | e4 r8
123 << @{ f8 c c @} \new Staff @{ f8 f c @} >> r4 | @} @}
127 @strong{Tenere separato il contenuto musicale dallo stile} mettendo gli
128 @code{\override} nel blocco @code{\layout}:
132 @var{@dots{}music@dots{}}
134 \override TabStaff.Stemstencil = ##f
139 Ciò non creerà un nuovo contesto ma sarà applicato quando ne viene creato
140 uno. Vedi anche @rlearning{Ridurre l'input grazie a variabili e funzioni} e
141 @rlearning{Fogli di stile}.
146 @node Scrivere musica esistente
147 @section Scrivere musica esistente
148 @translationof Typesetting existing music
150 Se stai riportando della musica da una partitura esistente (ovvero il brano
151 contenuto in uno spartito già scritto),
155 @item Inserisci in LilyPond le note del manoscritto (la copia fisica della
156 musica) un sistema alla volta (ma sempre una battuta per linea di testo),
157 e controlla ogni sistema completato. Puoi usare le proprietà
158 @code{showLastLength} o @code{showFirstLength} per velocizzare
159 l'elaborazione -- vedi @ruser{Saltare la musica già corretta}.
161 @item Definisci @code{mBreak = @{ \break @}} e inserisci @code{\mBreak}
162 nel file di input ogni volta che nel manoscritto c'è un a capo. In questo
163 modo è più semplice confrontare la musica generata da LilyPond con quella
164 originale. Quando hai finito la revisione della partitura, puoi
165 definire @code{mBreak = @{ @}} per eliminare tutte queste interruzioni di
166 riga. Così LilyPond potrà inserire le interruzioni dove ritiene stiano
169 @item Quando si inserisce una parte per strumento traspositore all'interno
170 di una variabile, è consigliabile racchiudere le note tra parentesi graffe
173 \transpose c altezza-naturale @{@dots{}@}
177 (dove @code{altezza-naturale} corrisponde all'intonazione di base dello
178 strumento) così che la musica contenuta nella variabile sia effettivamente
179 scritta in Do. La puoi presentare trasposta quando la variabile viene usata,
180 se necessario, ma potresti non desiderarlo (ad esempio quando si stampa una
181 partitura in intonazione reale, quando si traspone una parte per trombone
182 dalla chiave di Sol alla chiave di basso, etc.). Errori nelle trasposizioni
183 sono meno probabili se tutta la musica contenuta nelle variabili è ad
186 Inoltre, trasponi sempre in relazione al Do. Questo significa che le uniche
187 altre tonalità che userai saranno le altezze naturali degli strumenti - bes
188 per una tromba in Si bemolle, aes per un clarinetto in La bemolle, etc.
193 @node Grandi progetti
194 @section Grandi progetti
195 @translationof Large projects
197 Quando si lavora a un grande progetto, definire una struttura chiara nel
198 file di input diventa vitale.
202 @item @strong{Usa una variabile per ogni voce}, con un minimo di
203 struttura nella definizione. La struttura della sezione
204 @code{\score} è la parte più probabilmente soggetta a cambiamenti;
205 è invece molto improbabile che la definizione di @code{violin} cambi
206 in una nuova versione di LilyPond.
209 violin = \relative @{
222 @item @strong{Separa le modifiche manuali (tweak) dalle definizioni musicali}. Questo
223 punto è stato menzionato prima; nei grandi progetti diventa di vitale
224 importanza. Potrebbe essere necessario modificare la definizione
225 di @code{fthenp}, ma si dovrebbe farlo una volta sola e senza toccare
226 niente in @code{violin}.
230 \dynamic f \italic \small @{ 2nd @} \hspace #0.1 \dynamic p @}
231 violin = \relative @{
239 @node Risoluzione dei problemi
240 @section Risoluzione dei problemi
241 @translationof Troubleshooting
243 Prima o poi ti capiterà di scrivere un file che LilyPond non
244 riesce a compilare. I messaggi inviati da LilyPond potrebbero aiutarti
245 a trovare l'errore, ma in molti casi sarà necessario fare qualche ricerca
246 per individuare l'origine del problema.
248 Gli strumenti più potenti a questo riguardo sono il commento della
249 linea singola (indicato da @code{%}) e il commento di blocco
250 (indicato da @code{%@{ @dots{} %@}}). Se non sai dove sia il problema,
251 inizia col commentare ampie parti del file di input. Dopo aver commentato
252 una sezione, prova a compilare di nuovo il file. Se funziona, allora il
253 problema deve trovarsi nella parte che hai appena commentato. Se non
254 funziona, continua a commentare il materiale finché non ottieni un codice
257 Nel caso estremo, potresti finire con soltanto
271 (in altre parole, un file senza musica)
273 Se dovesse succedere, non rinunciare. Decommenta un pezzetto -- ad esempio,
274 la parte di basso -- e vedi se funziona. Se non funziona,
275 allora commenta tutta la musica del basso (ma lascia
276 @code{\bass} in @code{\score} non commentato).
287 Ora inizia a decommentare mano a mano la parte di
288 @code{bass} finché non trovi la linea che causa il problema.
290 Un'altra tecnica di debug molto utile consiste nel creare
291 @rweb{Esempi minimi}.
294 @node Make e Makefile
295 @section Make e Makefile
296 @translationof Make and Makefiles
301 Tutte le piattaforme su cui Lilypond può essere installato supportano un
302 software chiamato @code{make}. Questo software legge un file speciale chiamato
303 @code{Makefile} che definisce quali file dipendono da quali altri e quali
304 comandi occorra dare al sistema operativo per produrre un file da un
305 altro. Ad esempio Makefile può spiegare come generare
306 @file{ballad.pdf} e @file{ballad.midi} da @file{ballad.ly} eseguendo
309 In alcune situazioni, è una buona idea creare un @code{Makefile}
310 per il proprio progetto, per proprio comodo o come cortesia
311 per quanti altri possano avere accesso ai file sorgente.
312 Questo vale per i progetti molto ampi con tanti file inclusi e
313 diverse opzioni di output (ad esempio, partitura completa, parti, partitura
314 del direttore, riduzione per pianoforte, etc.) o per progetti che
315 richiedono comandi difficili per la compilazione (come i progetti che
316 usano @code{lilypond-book}). I Makefile variano molto in complessità
317 e flessibilità, in base alle necessità e alle abilità degli autori.
318 Il programma GNU Make è installato nelle distribuzioni GNU/Linux
319 e su MacOS X ed è disponibile anche per Windows.
321 Si veda il @strong{Manuale di GNU Make} per conoscere in dettaglio l'uso di
322 @code{make}, dato che quel che segue dà solo un'idea delle sue potenzialità.
324 I comandi per definire delle regole in un Makefile cambiano in base
325 alla piattaforma; ad esempio le varie distribuzioni di GNU/Linux e
326 MacOS usano @code{bash}, mentre Windows usa @code{cmd}. Nota che su
327 MacOS X è necessario configurare il sistema per usare l'interprete da linea
328 di comando. Di seguito alcuni Makefile di esempio, con versioni sia per
329 GNU/Linux/MacOS sia per Windows.
331 Il primo esempio è per una composizione per orchestra in quattro
332 movimenti e presenta una directory strutturata come segue:
349 | |-- symphony-cello.ly
350 | |-- symphony-horn.ly
351 | |-- symphony-oboes.ly
352 | |-- symphony-viola.ly
353 | |-- symphony-violinOne.ly
354 | `-- symphony-violinTwo.ly
364 I file @file{.ly} nelle directory @file{Scores} e
365 @file{Parts} prendono le note dai file @file{.ily}
366 nella directory @file{Notes}:
369 %%% inizio del file "symphony-cello.ly"
370 \include ../symphonyDefs.ily
371 \include ../Notes/cello.ily
374 Il Makefile avrà i target di @code{score} (l'intero brano in partitura
375 completa), @code{movements} (singoli movimenti in partitura completa),
376 e @code{parts} (singole parti per i musicisti). C'è anche un
377 target @code{archive} che creerà un archivio compresso dei file sorgenti,
378 utile per la condivisione via web o email. Ecco un esempio di
379 Makefile per GNU/Linux e MacOS X. Dovrebbe essere salvato col
380 nome @code{Makefile} nella directory principale del progetto:
382 @warning{Quando si definisce un target o una regola di pattern, le
383 linee successive devono iniziare con i tabulatori, non con gli spazi.}
386 # Il prefisso al nome dei file di output
388 # Determinazione del numero dei processori
389 CPU_CORES=`cat /proc/cpuinfo | grep -m1 "cpu cores" | sed s/".*: "//`
390 # Il comando per eseguire lilypond
391 LILY_CMD = lilypond -ddelete-intermediate-files \
392 -dno-point-and-click -djob-count=$(CPU_CORES)
394 # I suffissi usati in questo Makefile.
395 .SUFFIXES: .ly .ily .pdf .midi
397 # I file di input e di output vengono cercati nelle directory elencate
398 # nella variabile VPATH. Tutte queste sono sottodirectory della directory
399 # corrente (assegnata dalla variabile `CURDIR' di GNU make).
406 # La regola di pattern per creare i file PDF e MIDI da un file di input LY.
407 # I file di output .pdf vengono messi nella sottodirectory `PDF', mentre i file
408 # .midi vanno nella sottodirectory `MIDI'.
410 $(LILY_CMD) $<; \ # questa linea inizia con una tabulazione
411 if test -f "$*.pdf"; then \
414 if test -f "$*.midi"; then \
415 mv "$*.midi" MIDI/; \
426 # Le dipendenze dei movimenti.
427 $(piece)I.pdf: $(piece)I.ly $(notes)
428 $(piece)II.pdf: $(piece)II.ly $(notes)
429 $(piece)III.pdf: $(piece)III.ly $(notes)
430 $(piece)IV.pdf: $(piece)IV.ly $(notes)
432 # Le dipendenze della partitura completa.
433 $(piece).pdf: $(piece).ly $(notes)
435 # Le dipendenze delle parti.
436 $(piece)-cello.pdf: $(piece)-cello.ly cello.ily
437 $(piece)-horn.pdf: $(piece)-horn.ly horn.ily
438 $(piece)-oboes.pdf: $(piece)-oboes.ly oboe.ily
439 $(piece)-viola.pdf: $(piece)-viola.ly viola.ily
440 $(piece)-violinOne.pdf: $(piece)-violinOne.ly violinOne.ily
441 $(piece)-violinTwo.pdf: $(piece)-violinTwo.ly violinTwo.ily
443 # Lanciare `make score' per generare la partitura completa di tutti i quattro
444 # movimenti in un unico file.
448 # Lanciare `make parts' per generare tutte le parti.
449 # Lanciare `make foo.pdf' per generare la parte per lo strumento `foo'.
450 # Esempio: `make symphony-cello.pdf'.
452 parts: $(piece)-cello.pdf \
453 $(piece)-violinOne.pdf \
454 $(piece)-violinTwo.pdf \
459 # Lanciare `make movements' per generare i file per i
460 # quattro movimenti separatamente.
462 movements: $(piece)I.pdf \
467 all: score parts movements
470 tar -cvvf stamitz.tar \ # questa linea inizia con una tabulazione
471 --exclude=*pdf --exclude=*~ \
472 --exclude=*midi --exclude=*.tar \
477 Ci sono alcune complicazioni specifiche della piattaforma Windows. Dopo aver
478 scaricato e installato GNU Make per Windows, bisogna impostare il percorso
479 corretto nelle variabili d'ambiente di sistema perché la
480 shell DOS possa trovare il programma Make. Per farlo, clicca col tasto destro
481 del mouse su "My Computer," poi scegli @code{Proprietà} e
482 @code{Avanzate}. Clicca su @code{Variabili di ambiente}, e poi nel
483 pannello @code{Variabili di Sistema}, nella sezione @code{Percorso}, clicca su
484 @code{modifica} e aggiungi il percorso al file eseguibile GNU Make, che
485 avrà un aspetto simile:
488 C:\Program Files\GnuWin32\bin
491 Lo stesso Makefile deve essere modificato per gestire diversi comandi
492 shell e gli spazi che sono presenti in alcune directory predefinite
493 di sistema. Il target @code{archive} target viene tolto perché Windows
494 non ha il comando @code{tar}; inoltre Windows ha una diversa estensione
495 predefinita per i file midi.
499 ## VERSIONE DI WINDOWS
502 LILY_CMD = lilypond -ddelete-intermediate-files \
503 -dno-point-and-click \
504 -djob-count=$(NUMBER_OF_PROCESSORS)
506 #get the 8.3 name of CURDIR (workaround for spaces in PATH)
507 workdir = $(shell for /f "tokens=*" %%b in ("$(CURDIR)") \
510 .SUFFIXES: .ly .ily .pdf .mid
519 $(LILY_CMD) $< # questa linea inizia con una tabulazione
520 if exist "$*.pdf" move /Y "$*.pdf" PDF/
521 if exist "$*.mid" move /Y "$*.mid" MIDI/
533 $(piece)I.pdf: $(piece)I.ly $(notes)
534 $(piece)II.pdf: $(piece)II.ly $(notes)
535 $(piece)III.pdf: $(piece)III.ly $(notes)
536 $(piece)IV.pdf: $(piece)IV.ly $(notes)
538 $(piece).pdf: $(piece).ly $(notes)
540 $(piece)-cello.pdf: $(piece)-cello.ly cello.ily
541 $(piece)-horn.pdf: $(piece)-horn.ly horn.ily
542 $(piece)-oboes.pdf: $(piece)-oboes.ly oboe.ily
543 $(piece)-viola.pdf: $(piece)-viola.ly viola.ily
544 $(piece)-violinOne.pdf: $(piece)-violinOne.ly violinOne.ily
545 $(piece)-violinTwo.pdf: $(piece)-violinTwo.ly violinTwo.ily
551 parts: $(piece)-cello.pdf \
552 $(piece)-violinOne.pdf \
553 $(piece)-violinTwo.pdf \
559 movements: $(piece)I.pdf \
564 all: score parts movements
568 Il Makefile seguente è per un documento @command{lilypond-book} fatto con
569 LaTeX. Questo progetto ha un indice, dunque il comando @command{latex} deve
570 essere eseguito due volte per aggiornare i collegamenti. I file di output
571 sono tutti salvati nella directory @code{out} per i file .pdf e nella directory
572 @code{htmlout} per i file html.
581 LILYBOOK_PDF=lilypond-book --output=$(OUTDIR) --pdf $(FILE).lytex
582 LILYBOOK_HTML=lilypond-book --output=$(WEBDIR) $(FILE).lytex
583 PDF=cd $(OUTDIR) && pdflatex $(FILE)
584 HTML=cd $(WEBDIR) && latex2html $(FILE)
585 INDEX=cd $(OUTDIR) && makeindex $(FILE)
586 PREVIEW=$(VIEWER) $(OUTDIR)/$(FILE).pdf &
591 $(LILYBOOK_PDF) # inizia con una tabulazione
592 $(PDF) # inizia con una tabulazione
593 $(INDEX) # inizia con una tabulazione
594 $(PDF) # inizia con una tabulazione
595 $(PREVIEW) # inizia con una tabulazione
598 $(LILYBOOK_HTML) # inizia con una tabulazione
599 $(HTML) # inizia con una tabulazione
600 cp -R $(WEBDIR)/$(FILE)/ ./ # inizia con una tabulazione
601 $(BROWSER) $(FILE)/$(FILE).html & # inizia con una tabulazione
604 cp $(OUTDIR)/$(FILE).pdf $(FILE).pdf # inizia con una tabulazione
607 rm -rf $(OUTDIR) # inizia con una tabulazione
610 rm -rf $(WEBDIR) # inizia con una tabulazione
613 tar -cvvf myproject.tar \ # inizia questa linea con una tabulazione
615 --exclude=htmlout/* \
616 --exclude=myproject/* \
623 @c TODO: make this thing work on Windows
625 Il Makefile precedente non funziona su Windows. Un'alternativa per
626 gli utenti Windows consiste nel creare un semplice file batch
627 contenente i comandi per la compilazione. Questo file non terrà
628 traccia delle dipendenze come fa invece un Makefile, ma almeno riduce
629 il processo di compilazione a un solo comando. Salva il codice
630 seguente come @command{build.bat} o @command{build.cmd}.
631 Il file batch può essere eseguito nel prompt DOS o semplicemente con
632 un doppio clic sulla sua icona.
635 lilypond-book --output=out --pdf myproject.lytex
641 copy out\myproject.pdf MyProject.pdf
648 @ref{Uso da linea di comando},