1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: it -*-
4 Translation of GIT committish: 26a079ca2393d053315ef8dbef626c897dc9645a
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..
11 @include included/generating-output.itexi
18 Questo capitolo fornisce un'introduzione di base all'uso di LilyPond.
22 * Come scrivere i file di input::
23 * Gestire gli errori::
24 * Come leggere i manuali::
27 @node Compilare un file
28 @section Compilare un file
29 @translationof Compiling a file
40 @node Inserire l'input
41 @subsection Inserire l'input
42 @translationof Entering input
45 @cindex esempio iniziale
46 @cindex esempio, iniziale
47 @cindex maiuscole, sensibile alle
49 @qq{Compilazione} è il termine usato per indicare l'elaborazione di un
50 file di input in formato LilyPond per produrre uno o più file di output. I
51 file di output generalmente sono PDF (per la stampa e la visualizzazione),
52 MIDI (per la riproduzione audio) e PNG (per l'utilizzo online). I file di
53 input di LilyPond sono semplici file di testo.
55 Questo esempio mostra un semplice file di input:
58 \version "@w{@version{}}"
66 @c in this case we don't want verbatim
73 @warning{Le note e i testi nel file LilyPond devono essere sempre
74 scritti tra @w{@strong{@{ parentesi graffe @}}}. Per evitare ambiguità, le
75 parentesi dovrebbero essere delimitate da degli spazi, a meno che non si
76 trovino all'inizio o alla fine di una linea. Può darsi che in alcuni esempi
77 di questo manuale le parentesi verranno omesse, ma non dimenticarle
78 nella tua musica! Per maggiori informazioni sull'aspetto degli esempi
79 nel manuale, si veda @ref{Come leggere i manuali}.}
81 Inoltre, l'input di LilyPond è @strong{sensibile alle maiuscole}.
82 @w{@samp{@{ c d e @}}} è un input valido; @w{@samp{@{ C D E @}}} invece
83 produrrà un messaggio di errore.
87 @subheading Generare l'output
89 @c TODO: move index entries
91 @cindex vedere la musica
92 @cindex editor di testo
94 Come generare l'output di LilyPond dipende dal tuo sistema operativo e dai
100 @ref{MacOS X, @sourceimage{logo-macosx,,,}}
101 @ref{MacOS X, MacOS X} (grafico)
104 @ref{Windows, @sourceimage{logo-windows,,,}}
105 @ref{Windows, Microsoft Windows} (grafico)
108 @ref{Linea di comando, @sourceimage{logo-linux,,,}
109 @sourceimage{logo-freebsd,,,}
110 @sourceimage{logo-macosx,,,}
111 @sourceimage{logo-windows,,,}
113 @ref{Linea di comando, Tutti i sistemi operativi} (linea di comando)
117 Si noti che sono disponibili molti altri editor di testo con
118 un miglior supporto per LilyPond. Per maggiori informazioni, si veda
119 @rweb{Editing facilitato}.
121 @warning{La prima volta che si esegue LilyPond la compilazione potrà richiedere
122 uno o due minuti perché tutti i font di sistema devono essere prima
123 analizzati. In seguito, LilyPond sarà molto più veloce!}
128 @cindex eseguire LilyPond in MacOS X
129 @cindex MacOS X, eseguire LilyPond
137 @cindex eseguire LilyPond in Windows
138 @cindex Windows, eseguire LilyPond
143 @node Linea di comando
144 @subsection Linea di comando
145 @translationof Command-line
147 @cindex eseguire LilyPond in Unix
148 @cindex Unix, eseguire LilyPond
153 @node Come scrivere i file di input
154 @section Come scrivere i file di input
155 @translationof How to write input files
157 Questa sezione introduce le basi della sintassi di LilyPond e ha l'obiettivo
158 di aiutarti ad iniziare a scrivere i file di input.
161 * Notazione semplice::
162 * Lavorare sui file di input::
165 @node Notazione semplice
166 @subsection Notazione semplice
167 @translationof Simple notation
169 @cindex notazione semplice
170 @cindex notazione, semplice
172 LilyPond aggiungerà automaticamente alcuni elementi della notazione. Nell'esempio
173 seguente, abbiamo specificato soltanto quattro note, ma LilyPond
174 ha aggiunto una chiave, il tempo e le durate.
176 @lilypond[verbatim,quote]
183 Questo comportamento può essere modificato, ma nella maggior parte dei
184 casi questi valori sono utili.
190 @cindex modo relativo
193 @cindex alterazioni e modo relativo
194 @cindex modo relativo, e alterazioni
201 Glossario musicale: @rglosnamed{pitch,altezza}, @rglosnamed{interval,intervallo},
202 @rglosnamed{scale,scala}, @rglosnamed{middle C,Do centrale}, @rglosnamed{octave,ottava},
203 @rglosnamed{accidental,alterazione}.
205 Il modo più semplice per inserire le note è usare il modo @code{\relative}
206 (relativo). In questo modo, l'ottava viene scelta automaticamente in
207 base al principio per cui la nota che segue deve essere posizionata vicino
208 a quella precedente, ovvero deve essere posizionata nell'ottava che si trova
209 entro tre spazi di pentagramma dalla nota precedente. Per iniziare, scriveremo
210 il pezzo musicale più elementare, una @notation{scala}, in cui ogni nota
211 si trova entro una distanza di appena uno spazio di pentagramma dalla nota precedente.
213 @lilypond[verbatim,quote]
214 % set the starting point to middle C
221 La nota iniziale è un @notation{Do centrale}. Ogni nota successiva viene
222 posta il più vicino possibile alla nota precedente -- in altre parole, la prima
223 @code{c} è il Do più vicino al Do centrale. Questo è seguito dal Re
224 più vicino alla nota precedente. Possiamo creare melodie che hanno
225 intervalli più ampi, sempre usando soltanto il modo @code{\relative}:
227 @lilypond[verbatim,quote]
235 Non è necessario che la prima nota della melodia inizi con
236 la nota che specifica l'altezza iniziale. Nell'esempio
237 precedente, la prima nota -- il @code{Re} -- è il Re più vicino al
240 Se si aggiungono (o si rimuovono) apostrofi @code{'} o virgole @code{,} dal
241 comando @q{@w{@code{@bs{}relative c'}}}, possiamo cambiare l'ottava di
244 @lilypond[verbatim,quote]
245 % one octave above middle C
251 Il modo relativo all'inizio può apparire disorientante, ma è il sistema più
252 semplice per inserire gran parte delle melodie. Vediamo come questo calcolo
253 relativo funziona in pratica. Se si parte da un Si, che si trova sulla linea
254 centrale in chiave di violino, si possono raggiungere un Do, un Re e un Mi
255 entro 3 spazi di pentagramma andando in su, e un La, un Sol e un Fa entro 3
256 spazi di pentagramma andando in giù. Quindi se la nota che segue il Si è
257 un Do, un Re o un Mi, si troverà sopra il Si, mentre il La, il Sol
258 o il Fa si troveranno sotto.
260 @lilypond[verbatim,quote]
262 b c % c is 1 staff space up, so is the c above
263 b d % d is 2 up or 5 down, so is the d above
264 b e % e is 3 up or 4 down, so is the e above
265 b a % a is 6 up or 1 down, so is the a below
266 b g % g is 5 up or 2 down, so is the g below
267 b f % f is 4 up or 3 down, so is the f below
271 Accade esattamente lo stesso quando qualcuna di queste note ha un
272 diesis o un bemolle. Le @notation{Alterazioni} sono
273 @strong{completamente ignorate} nel calcolo della posizione relativa.
274 Viene fatto lo stesso conteggio dello spazio del pentagramma da
275 una nota in una qualsiasi altra posizione sul pentagramma.
277 Per inserire intervalli che sono più ampi di tre spazi di pentagramma, si può
278 alzare l'@notation{ottava} aggiungendo al nome della nota una virgoletta
279 ad apice singolo @code{'} (o apostrofo). Si può abbassare l'ottava
280 aggiungendo al nome della nota una virgola @code{,}.
282 @lilypond[verbatim,quote]
290 Per cambiare una nota di due (o più!) ottave, si usano multipli di
291 @code{''} o @code{,,} -- ma stai attento a usare due virgolette ad
292 apici semplici @code{''} e non quelle a doppi apici @code{"}@tie{}!
293 @c " - keeps quotes in order for context-sensitive editor -td
295 @subheading Durate (ritmi)
297 @cindex durate della nota
304 @cindex notazione delle durate
306 Glossario musicale: @rglosnamed{beam,coda}, @rglosnamed{duration,durata},
307 @rglosnamed{whole note,semibreve}, @rglosnamed{half note,minima}, @rglosnamed{quarter note,semiminima},
308 @rglosnamed{dotted note,nota puntata}.
310 La @notation{durata} di una nota viene indicata da un numero che segue
311 il nome della nota: @code{1} per una @notation{semibreve}, @code{2} per
312 una @notation{minima}, @code{4} per una @notation{semiminima} e
313 così via. Le @notation{Code} vengono aggiunte in automatico.
315 Se non si specifica una durata, si usa la durata precedente anche
316 per la nota successiva. La durata predefinita della prima nota è di un
319 @lilypond[verbatim,quote]
323 a16 a a a a32 a a a a64 a a a a a a a a2
327 Per creare @notation{note puntate}, aggiungi un punto @code{.} al
328 numero di durata. La durata di una nota puntata deve essere dichiarata
329 esplicitamente (cioè con un numero).
331 @lilypond[verbatim,quote]
342 @cindex notazione delle pause
344 Glossario musicale: @rglosnamed{rest,pausa}.
346 Una @notation{pausa} viene inserita proprio come una nota ma col nome
349 @lilypond[verbatim,quote]
357 @subheading Indicazione di tempo
359 @cindex tempo, indicazione di
364 Glossario musicale: @rglosnamed{time signature,indicazione di tempo}.
366 Il @notation{tempo} si imposta con il comando @code{\time}:
368 @lilypond[verbatim,quote]
379 @subheading Indicazioni di tempo
381 @cindex indicazioni di tempo
382 @cindex indicazioni metronomiche
387 Glossario musicale: @rglosnamed{tempo indication,indicazione di tempo},
388 @rglosnamed{metronome,metronomo}.
390 L' @notation{indicazione di tempo} e l' @notation{indicazione metronomica} si
391 impostano col comando @code{\tempo}:
393 @lilypond[verbatim,quote]
402 \tempo "Presto" 4 = 120
411 @cindex chiave di violino
419 Glossario musicale: @rglosnamed{clef,chiave}.
421 La @notation{chiave} si imposta con il comando @code{\clef}:
423 @lilypond[verbatim,quote]
437 @subheading Tutto insieme
439 Ecco un piccolo esempio che mostra tutti questi elementi insieme:
441 @lilypond[verbatim,quote]
445 \tempo "Andante" 4 = 120
455 Guida alla notazione: @ruser{Writing pitches},
456 @ruser{Writing rhythms}, @ruser{Writing rests},
457 @ruser{Time signature}, @ruser{Clef}.
460 @node Lavorare sui file di input
461 @subsection Lavorare sui file di input
462 @translationof Working on input files
464 @cindex parentesi graffe
465 @cindex graffe, parentesi
467 @cindex commento di linea
468 @cindex linea, commento di
469 @cindex commento di blocco
470 @cindex blocco, commento di
471 @cindex sensibile alle maiuscole
472 @cindex insensibile agli spazi
474 @cindex versionamento
476 @cindex numero di versione
481 @funindex %@{ ... %@}
483 I file di input di LilyPond sono simili ai file sorgenti di molti comuni
484 linguaggi di programmazione. Contengono una dichiarazione di versione, sono
485 sensibili alle maiuscole, e in generale gli spazi bianchi vengono ignorati. Le
486 espressioni musicali si formano con parentesi graffe @w{@code{@{ @}}}, e i commenti
487 sono indicati con @code{%} o @w{@code{%@{ @dots{} %@}}}@tie{}.
489 Se le frasi precedenti ti sembrano assurde, non preoccuparti! Spiegheremo
490 cosa significano tutti questi termini:
495 @strong{Dichiarazione di versione}:
496 Ogni file LilyPond deve contenere una dichiarazione di versione. Una
497 dichiarazione di versione è una linea che indica la versione di LilyPond per la
498 quale il file è stato scritto, come nel seguente esempio:
501 \version "@w{@version{}}"
504 Per convenzione, la dichiarazione di versione viene posta all'inizio del file
507 La dichiarazione di versione è importante per almeno due ragioni. Primo,
508 permette l'aggiornamento automatico del file di input file via via che la
509 sintassi di LilyPond cambia. Secondo, indica la versione di LilyPond richiesta
510 per compilare il file.
512 Se la dichiarazione di versione è omessa dal file di input, LilyPond mostra
513 un avvertimento durante la compilazione del file.
516 @strong{Sensibile alle maiuscole}:
517 distingue tra lettere in minuscolo (es:
518 @w{@code{a, b, s, t}}) o in maiuscolo (es: @w{@code{A, B, S, T}}).
519 Le note sono in minuscolo: @w{@code{@{ c d e @}}} è un input valido;
520 @w{@code{@{ C D E @}}} causerà un messaggio di errore.
523 @strong{Insensibile agli spazi}:
524 non importa quanti spazi (o tabulazioni o nuove linee) aggiungi.
525 @w{@samp{@{ c4 d e @}}} ha lo stesso significato di
526 @w{@samp{@{ c4 @tie{} @tie{} @tie{} d e @}}} e:
534 Certo, l'esempio precedente è scomodo da leggere. Una buona regola
535 pratica è indentare i blocchi di codice con una tabulazione o due spazi:
543 Tuttavia, uno spazio bianco @emph{è} necessario per separare molti elementi
544 sintattici gli uni dagli altri. In altre parole, lo spazio bianco può essere
545 @emph{aggiunto}, ma non può essere @emph{eliminato}. Dal momento che uno
546 spazio bianco mancante può dare adito a strani errori, si consiglia di
547 inserire sempre uno spazio bianco prima e dopo ogni elemento sintattico,
548 ad esempio, prima e dopo ogni parentesi graffa.
551 @strong{Espressioni}:
552 ogni parte dell'input di LilyPond deve avere @strong{@{@tie{}parentesi@tie{}graffe@tie{}@}}
553 intorno. Queste parentesi dicono a LilyPond che l'input costituisce
554 un'espressione musicale singola, proprio come le parentesi @code{()} in
555 matematica. Per evitare ambiguità, le parentesi dovrebbero essere
556 racchiuse tra spazi, a meno che non si trovino all'inizio o alla fine di una linea.
558 Anche un comando di LilyPond seguito da un'espressione semplice in
559 parentesi (come @q{@w{@code{@bs{}relative c' @{ @dots{} @}}}}) conta come
560 un'espressione musicale singola.
563 @cindex commento di linea
564 @cindex commento di blocco
567 un commento è un appunto per il lettore umano dell'input musicale; viene
568 ignorato quando l'input viene analizzato, dunque non ha alcun effetto
569 sull'output finale. Ci sono due tipi di commenti. Il simbolo di percentuale
570 @code{%} introduce un commento di linea; tutto quello che sta dopo @code{%}
571 su quella linea verrà ignorato. Per convenzione, un commento di linea viene
572 posto @emph{sopra} il codice a cui si riferisce.
576 % questo commento si riferisce ai Si
580 Un commento di blocco segna come commento un'intera sezione di input musicale.
581 Tutto ciò che è compreso tra @code{%@{} e @code{%@}} viene ignorato.
582 Tuttavia, i commenti di blocco non si @q{annidano}. Ovvero non si può
583 inserire un commento di blocco dentro a un altro commento di blocco. Se
584 ci provi, il primo @code{%@}} interromperà @emph{entrambi} i commenti di
585 blocco. Il seguente frammento mostra gli usi possibili per i commenti:
588 % ecco le note di "Ah! Vous dirai-je, Maman"
592 Questa linea e le note sotto vengono ignorate,
593 perché si trovano in un commento di blocco.
602 @node Gestire gli errori
603 @section Gestire gli errori
604 @translationof Dealing with errors
606 @cindex risoluzione dei problemi
608 Talvolta LilyPond non genera l'output che desideri. Questa
609 sezione fornisce alcuni link che possono aiutarti a risolvere i
610 problemi che potrai incontrare.
614 * Consigli generali per la risoluzione dei problemi::
615 * Alcuni errori comuni::
618 @node Consigli generali per la risoluzione dei problemi
619 @subsection Consigli generali per la risoluzione dei problemi
620 @translationof General troubleshooting tips
622 La risoluzione dei problemi in LilyPond può essere un compito impegnativo
623 per le persone che sono abituate a un'interfaccia grafica, perché è possibile
624 creare dei file di input non validi. Quando questo accade, un approccio logico
625 è il modo migliore per identificare e risolvere il problema. Alcune linee guida
626 che ti aiutano a imparare questo sono indicate in @rprogram{Risoluzione dei problemi}.
629 @node Alcuni errori comuni
630 @subsection Alcuni errori comuni
631 @translationof Some common errors
633 @cindex errori comuni
635 Ci sono alcuni errori comuni che sono difficili da risolvere basandosi
636 soltanto sui messaggi di errore che compaiono. Questi sono
637 descritti in @rprogram{Errori comuni}.
640 @node Come leggere i manuali
641 @section Come leggere i manuali
642 @translationof How to read the manuals
644 Questa sezione spiega come leggere la documentazione in modo efficiente e
645 introduce alcune utili funzionalità interattive che sono disponibili
646 nella versione online della documentazione.
650 * Esempi cliccabili::
651 * Panoramica dei manuali::
655 @node Materiale omesso
656 @subsection Materiale omesso
657 @translationof Omitted material
659 @cindex come leggere il manuale
660 @cindex manuale, leggere
661 @cindex leggere il manuale
662 @cindex cliccabili, esempi
663 @cindex esempi cliccabili
664 @cindex consigli su come costruire i file
666 @cindex costruire i file, consigli
667 @cindex file, consigli per costruirli
669 L'input di LilyPond deve essere compreso dai segni @code{@{ @}} o da
670 @q{@w{@code{@bs{}relative c'' @{ @dots{} @}}}}, come abbiamo visto in @ref{Lavorare
671 sui file di input}. Nel resto di questo manuale gran parte degli esempi
672 ometterà questi segni. Per replicare gli esempi, puoi copiare
673 e incollare l'input mostrato, ma @strong{devi} aggiungere
674 @q{@w{@code{@bs{}relative c'' @{ @dots{} @}}}} in questo modo:
678 @dots{}inserire qui l'esempio@dots{}
682 Perché omettere le parentesi? Gran parte degli esempi in questo manuale
683 possono essere inseriti nel mezzo di un pezzo più ampio. Per questi esempi,
684 non ha senso includere @q{@w{@code{@bs{}relative c'' @{ @dots{} @}}}} --
685 non si deve mettere un @code{\relative} dentro un altro
686 @code{\relative}! Se includessimo @q{@w{@code{@bs{}relative c'' @{ @dots{} @}}}}
687 in ogni esempio, non potresti copiare un piccolo esempio della
688 documentazione e incollarlo dentro a un tuo brano più
689 esteso. La maggior parte delle persone vuole aggiungere del materiale a
690 un brano esistente, per questo abbiamo strutturato il manuale in questo modo.
692 Ricorda che i file LilyPond devono avere una dichiarazione di
693 versione (@code{\version}). Nei manuali la dichiarazione è omessa
694 perché gli esempi sono frammenti di codice e non file completi.
695 Ma dovresti prendere l'abitudine di includerla nei tuoi file.
697 @node Esempi cliccabili
698 @subsection Esempi cliccabili
699 @translationof Clickable examples
701 @warning{Queste funzionalità sono disponibili soltanto nei manuali in HTML.}
703 Molte persone imparano ad usare un programma provando e smanettando.
704 Questo è possibile anche con LilyPond. Se clicchi su un'immagine
705 nella versione HTML di questo manuale, vedrai l'esatto input
706 LilyPond usato per generare quell'immagine. Provalo su
712 c4-\markup { \bold \huge { Clicca qui. } }
716 Tagliando e copiando quel che si trova nella sezione @qq{ly snippet},
717 puoi ricavare un modello di partenza per sperimentare. Per vedere esattamente
718 lo stesso output (larghezza della linea e tutto il resto), copia tutto da @qq{Start
719 cut-&-pastable section} alla fine del file.
724 @n ode Keyboard navigation
725 @s ubsection Keyboard navigation
727 @warning{This features is only available in the HTML manuals.}
729 @c TODO: once this is figured out, insert it here.
731 We are currently working on this feature.
735 @node Panoramica dei manuali
736 @subsection Panoramica dei manuali
737 @translationof Overview of manuals
739 La documentazione su LilyPond è vasta. I nuovi utenti talvolta
740 sono confusi su quali parti dovrebbero leggere, e ogni tanto
741 saltano la lettura di parti fondamentali.
743 @warning{Non saltare le parti importanti della
744 documentazione. Altrimenti ti risulterà molto più difficile
745 comprendere le sezioni successive.}
750 @strong{Prima di fare @emph{qualsiasi} tentativo}: leggi il @ref{Tutorial}
751 e la @ref{Notazione comunemente utilizzata} del Manuale di apprendimento. Se
752 ti imbatti in termini musicali che non conosci, cercali nel @rglosnamed{Top, Glossario}.
755 @strong{Prima di tentare di scrivere un pezzo musicale completo}: leggi
756 i @ref{Concetti fondamentali} del Manuale di apprendimento. Dopo puoi dare
757 un'occhiata alle sezioni rilevanti della @rusernamed{Top, Notation reference}.
760 @strong{Prima di cercare di cambiare l'output predefinito}: leggi il
761 @ref{Tweaking output} del Manuale di apprendimento.
764 @strong{Prima di iniziare un grande progetto}: leggi il documento
765 @rprogram{Consigli su come scrivere i file} del manuale di Uso del programma.