1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: it -*-
4 Translation of GIT committish: 09ef86c87175cc6c1071eedb022ed1d01a93bcaf
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
17 @translationof Tutorial
19 Questo capitolo fornisce un'introduzione di base all'uso di LilyPond.
23 * Come scrivere i file di input::
24 * Gestire gli errori::
25 * Come leggere i manuali::
28 @node Compilare un file
29 @section Compilare un file
30 @translationof Compiling a file
39 @node Inserire l'input
40 @subsection Inserire l'input
41 @translationof Entering input
44 @cindex esempio iniziale
45 @cindex esempio, iniziale
46 @cindex maiuscole, sensibile alle
52 @qq{Compilazione} è il termine usato per indicare l'elaborazione di un
53 file di input in formato LilyPond per produrre uno o più file di output. I
54 file di output generalmente sono PDF (per la stampa e la visualizzazione),
55 MIDI (per la riproduzione audio) e PNG (per l'utilizzo online). I file di
56 input di LilyPond sono semplici file di testo.
58 Questo esempio mostra un semplice file di input:
61 \version "@w{@version{}}"
69 @c in this case we don't want verbatim
76 @warning{Le note e i testi nel file LilyPond devono essere sempre
77 scritti tra @w{@strong{@{ parentesi graffe @}}}. Per evitare ambiguità, le
78 parentesi dovrebbero essere delimitate da degli spazi, a meno che non si
79 trovino all'inizio o alla fine di una linea. Può darsi che in alcuni esempi
80 di questo manuale le parentesi verranno omesse, ma non dimenticarle
81 nella tua musica! Per maggiori informazioni sull'aspetto degli esempi
82 nel manuale, si veda @ref{Come leggere i manuali}.}
84 Inoltre, l'input di LilyPond è @strong{sensibile alle maiuscole}.
85 @w{@samp{@{ c d e @}}} è un input valido; @w{@samp{@{ C D E @}}} invece
86 produrrà un messaggio di errore.
90 @node Generare l'output
91 @unnumberedsubsubsec Generare l'output
92 @translationof Producing output
94 @c TODO: move index entries
96 @cindex vedere la musica
97 @cindex editor di testo
99 Come generare l'output di LilyPond dipende dal tuo sistema operativo e dai
105 @ref{MacOS X, @sourceimage{logo-macosx,,,}}
106 @ref{MacOS X, MacOS X} (grafico)
109 @ref{Windows, @sourceimage{logo-windows,,,}}
110 @ref{Windows, Microsoft Windows} (grafico)
113 @ref{Linea di comando, @sourceimage{logo-linux,,,}
114 @sourceimage{logo-freebsd,,,}
115 @sourceimage{logo-macosx,,,}
116 @sourceimage{logo-windows,,,}
118 @ref{Linea di comando, Tutti i sistemi operativi} (linea di comando)
122 Si noti che sono disponibili molti altri editor di testo con
123 un miglior supporto per LilyPond. Per maggiori informazioni, si veda
124 @rweb{Editing facilitato}.
126 @warning{La prima volta che si esegue LilyPond la compilazione potrà richiedere
127 uno o due minuti perché tutti i font di sistema devono essere prima
128 analizzati. In seguito, LilyPond sarà molto più veloce!}
133 @cindex eseguire LilyPond in MacOS X
134 @cindex MacOS X, eseguire LilyPond
142 @cindex eseguire LilyPond in Windows
143 @cindex Windows, eseguire LilyPond
148 @node Linea di comando
149 @subsection Linea di comando
150 @translationof Command-line
152 @cindex eseguire LilyPond in Unix
153 @cindex Unix, eseguire LilyPond
158 @node Come scrivere i file di input
159 @section Come scrivere i file di input
160 @translationof How to write input files
162 Questa sezione introduce le basi della sintassi di LilyPond e ha l'obiettivo
163 di aiutarti ad iniziare a scrivere i file di input.
166 * Notazione semplice::
167 * Lavorare sui file di input::
170 @node Notazione semplice
171 @subsection Notazione semplice
172 @translationof Simple notation
174 @cindex notazione semplice
175 @cindex notazione, semplice
181 * Indicazione di tempo::
182 * Indicazioni di tempo::
187 LilyPond aggiungerà automaticamente alcuni elementi della notazione. Nell'esempio
188 seguente, abbiamo specificato soltanto quattro note, ma LilyPond
189 ha aggiunto una chiave, il tempo e le durate.
191 @lilypond[verbatim,quote]
198 Questo comportamento può essere modificato, ma nella maggior parte dei
199 casi questi valori sono utili.
203 @unnumberedsubsubsec Altezze
204 @translationof Pitches
207 @cindex modo relativo
210 @cindex alterazioni e modo relativo
211 @cindex modo relativo, e alterazioni
217 Glossario musicale: @rglosnamed{pitch,altezza}, @rglosnamed{interval,intervallo},
218 @rglosnamed{scale,scala}, @rglosnamed{middle C,Do centrale}, @rglosnamed{octave,ottava},
219 @rglosnamed{accidental,alterazione}.
221 LilyPond usa lettere minuscole per indicare le altezze. Le lettere da
222 @code{c} a@tie{}@code{b} denotano le altezze nella
223 @q{piccola ottava} sotto il @notation{Do centrale}. L'aggiunta dei
224 suffissi @code{'} o@tie{}@code{,} indica ottave più alte o più basse.
225 Ecco una scala che inizia con un @notation{Do centrale}, e un arpeggio:
227 @lilypond[verbatim,quote]
228 { c' d' e' f' g' a' b' c'' g c' e' g' c'' e'' g'' c''' }
231 Il modo più semplice per inserire le note è usare il modo @code{\relative}
232 (relativo). In questo modo, l'ottava viene scelta automaticamente in
233 base al principio per cui la nota che segue deve essere posizionata vicino
234 a quella precedente, ovvero deve essere posizionata nell'ottava che si trova
235 entro tre spazi di pentagramma dalla nota precedente. Per iniziare, scriveremo
236 il pezzo musicale più elementare, una @notation{scala}, in cui ogni nota
237 si trova entro una distanza di appena uno spazio di pentagramma dalla nota precedente.
239 @lilypond[verbatim,quote]
246 La nota iniziale è un @notation{Do centrale}, specificato da @code{c'}. Ogni
247 nota successiva viene posta il più vicino possibile alla nota precedente -- in
248 altre parole, la prima @code{c} è il Do più vicino al Do centrale. Questo è
249 seguito dal Re più vicino alla nota precedente. Possiamo creare melodie che
250 hanno intervalli più ampi, sempre usando soltanto il modo @code{\relative}:
252 @lilypond[verbatim,quote]
260 Nell'esempio precedente, la prima nota -- il @code{d'} con un segno @code{'} -- è
261 il Re nell'ottava che inizia dal Do centrale e va su fino al Si.
264 Se si aggiungono (o si rimuovono) apostrofi @code{'} o virgole @code{,} dalla
265 prima nota, possiamo cambiare l'ottava di partenza:
267 @lilypond[verbatim,quote]
273 Il modo relativo all'inizio può apparire disorientante, ma è il sistema più
274 semplice per inserire gran parte delle melodie. Vediamo come questo calcolo
275 relativo funziona in pratica. Se si parte da un Si, che si trova sulla linea
276 centrale in chiave di violino, si possono raggiungere un Do, un Re e un Mi
277 entro 3 spazi di pentagramma andando in su, e un La, un Sol e un Fa entro 3
278 spazi di pentagramma andando in giù. Quindi se la nota che segue il Si è
279 un Do, un Re o un Mi, si troverà sopra il Si, mentre il La, il Sol
280 o il Fa si troveranno sotto.
282 @lilypond[verbatim,quote]
284 b' c % c is 1 staff space up, so is the c above
285 b d % d is 2 up or 5 down, so is the d above
286 b e % e is 3 up or 4 down, so is the e above
287 b a % a is 6 up or 1 down, so is the a below
288 b g % g is 5 up or 2 down, so is the g below
289 b f % f is 4 up or 3 down, so is the f below
293 Accade esattamente lo stesso quando qualcuna di queste note ha un
294 diesis o un bemolle. Le @notation{Alterazioni} sono
295 @strong{completamente ignorate} nel calcolo della posizione relativa.
296 Viene fatto lo stesso conteggio dello spazio del pentagramma da
297 una nota in una qualsiasi altra posizione sul pentagramma.
299 Per inserire intervalli che sono più ampi di tre spazi di pentagramma, si può
300 alzare l'@notation{ottava} aggiungendo al nome della nota una virgoletta
301 ad apice singolo @code{'} (o apostrofo). Si può abbassare l'ottava
302 aggiungendo al nome della nota una virgola @code{,}.
304 @lilypond[verbatim,quote]
312 Per cambiare una nota di due (o più!) ottave, si usano multipli di
313 @code{''} o @code{,,} -- ma stai attento a usare due virgolette ad
314 apici semplici @code{''} e non quelle a doppi apici @code{"}@tie{}!
315 @c " - keeps quotes in order for context-sensitive editor -td
318 @unnumberedsubsubsec Durate (ritmi)
319 @translationof Duration (rhythms)
321 @cindex durate della nota
328 @cindex notazione delle durate
330 Glossario musicale: @rglosnamed{beam,coda}, @rglosnamed{duration,durata},
331 @rglosnamed{whole note,semibreve}, @rglosnamed{half note,minima}, @rglosnamed{quarter note,semiminima},
332 @rglosnamed{dotted note,nota puntata}.
334 La @notation{durata} di una nota viene indicata da un numero che segue
335 il nome della nota: @code{1} per una @notation{semibreve}, @code{2} per
336 una @notation{minima}, @code{4} per una @notation{semiminima} e
337 così via. Le @notation{Code} vengono aggiunte in automatico.
339 Se non si specifica una durata, si usa la durata precedente anche
340 per la nota successiva. La durata predefinita della prima nota è di un
343 @lilypond[verbatim,quote]
347 a16 a a a a32 a a a a64 a a a a a a a a2
351 Per creare @notation{note puntate}, aggiungi un punto @code{.} al
352 numero di durata. La durata di una nota puntata deve essere dichiarata
353 esplicitamente (cioè con un numero).
355 @lilypond[verbatim,quote]
364 @unnumberedsubsubsec Pause
368 @cindex notazione delle pause
370 Glossario musicale: @rglosnamed{rest,pausa}.
372 Una @notation{pausa} viene inserita proprio come una nota ma col nome
375 @lilypond[verbatim,quote]
383 @node Indicazione di tempo
384 @unnumberedsubsubsec Indicazione di tempo
385 @translationof Time signature
387 @cindex tempo, indicazione di
391 Glossario musicale: @rglosnamed{time signature,indicazione di tempo}.
393 Il @notation{tempo} si imposta con il comando @code{\time}:
395 @lilypond[verbatim,quote]
406 @node Indicazioni di tempo
407 @unnumberedsubsubsec Indicazioni di tempo
408 @translationof Tempo marks
410 @cindex indicazioni di tempo
411 @cindex indicazioni metronomiche
415 Glossario musicale: @rglosnamed{tempo indication,indicazione di tempo},
416 @rglosnamed{metronome,metronomo}.
418 L' @notation{indicazione di tempo} e l' @notation{indicazione metronomica} si
419 impostano col comando @code{\tempo}:
421 @lilypond[verbatim,quote]
430 \tempo "Presto" 4 = 120
437 @unnumberedsubsubsec Chiave
441 @cindex chiave di violino
448 Glossario musicale: @rglosnamed{clef,chiave}.
450 La @notation{chiave} si imposta con il comando @code{\clef}:
452 @lilypond[verbatim,quote]
467 @unnumberedsubsubsec Tutto insieme
468 @translationof All together
470 Ecco un piccolo esempio che mostra tutti questi elementi insieme:
472 @lilypond[verbatim,quote]
476 \tempo "Andante" 4 = 120
486 Guida alla notazione: @ruser{Inserimento delle altezze},
487 @ruser{Inserimento delle durate}, @ruser{Inserimento delle pause},
488 @ruser{Indicazione di tempo}, @ruser{Chiave}.
491 @node Lavorare sui file di input
492 @subsection Lavorare sui file di input
493 @translationof Working on input files
495 @cindex parentesi graffe
496 @cindex graffe, parentesi
498 @cindex commento di linea
499 @cindex linea, commento di
500 @cindex commento di blocco
501 @cindex blocco, commento di
502 @cindex sensibile alle maiuscole
503 @cindex insensibile agli spazi
505 @cindex versionamento
507 @cindex numero di versione
512 @funindex %@{ ... %@}
514 I file di input di LilyPond sono simili ai file sorgenti di molti comuni
515 linguaggi di programmazione. Contengono una dichiarazione di versione, sono
516 sensibili alle maiuscole, e in generale gli spazi bianchi vengono ignorati. Le
517 espressioni musicali si formano con parentesi graffe @w{@code{@{ @}}}, e i commenti
518 sono indicati con @code{%} o @w{@code{%@{ @dots{} %@}}}@tie{}.
520 Se le frasi precedenti ti sembrano assurde, non preoccuparti! Spiegheremo
521 cosa significano tutti questi termini:
526 @strong{Dichiarazione di versione}:
527 Ogni file LilyPond deve contenere una dichiarazione di versione. Una
528 dichiarazione di versione è una linea che indica la versione di LilyPond per la
529 quale il file è stato scritto, come nel seguente esempio:
532 \version "@w{@version{}}"
535 Per convenzione, la dichiarazione di versione viene posta all'inizio del file
538 La dichiarazione di versione è importante per almeno due ragioni. Primo,
539 permette l'aggiornamento automatico del file di input file via via che la
540 sintassi di LilyPond cambia. Secondo, indica la versione di LilyPond richiesta
541 per compilare il file.
543 Se la dichiarazione di versione è omessa dal file di input, LilyPond mostra
544 un avvertimento durante la compilazione del file.
547 @strong{Sensibile alle maiuscole}:
548 distingue tra lettere in minuscolo (es:
549 @w{@code{a, b, s, t}}) o in maiuscolo (es: @w{@code{A, B, S, T}}).
550 Le note sono in minuscolo: @w{@code{@{ c d e @}}} è un input valido;
551 @w{@code{@{ C D E @}}} causerà un messaggio di errore.
554 @strong{Insensibile agli spazi}:
555 non importa quanti spazi (o tabulazioni o nuove linee) aggiungi.
556 @w{@samp{@{ c4 d e @}}} ha lo stesso significato di
557 @w{@samp{@{ c4 @tie{} @tie{} @tie{} d e @}}} e:
565 Certo, l'esempio precedente è scomodo da leggere. Una buona regola
566 pratica è indentare i blocchi di codice con una tabulazione o due spazi:
574 Tuttavia, uno spazio bianco @emph{è} necessario per separare molti elementi
575 sintattici gli uni dagli altri. In altre parole, lo spazio bianco può essere
576 @emph{aggiunto}, ma non può essere @emph{eliminato}. Dal momento che uno
577 spazio bianco mancante può dare adito a strani errori, si consiglia di
578 inserire sempre uno spazio bianco prima e dopo ogni elemento sintattico,
579 ad esempio, prima e dopo ogni parentesi graffa.
582 @strong{Espressioni}:
583 ogni parte dell'input di LilyPond deve avere @strong{@{@tie{}parentesi@tie{}graffe@tie{}@}}
584 intorno. Queste parentesi dicono a LilyPond che l'input costituisce
585 un'espressione musicale singola, proprio come le parentesi @code{()} in
586 matematica. Per evitare ambiguità, le parentesi dovrebbero essere
587 racchiuse tra spazi, a meno che non si trovino all'inizio o alla fine di una linea.
589 Anche un comando di LilyPond seguito da un'espressione semplice in
590 parentesi (come @q{@w{@code{@bs{}relative c' @{ @dots{} @}}}}) conta come
591 un'espressione musicale singola.
594 @cindex commento di linea
595 @cindex commento di blocco
598 un commento è un appunto per il lettore umano dell'input musicale; viene
599 ignorato quando l'input viene analizzato, dunque non ha alcun effetto
600 sull'output finale. Ci sono due tipi di commenti. Il simbolo di percentuale
601 @code{%} introduce un commento di linea; tutto quello che sta dopo @code{%}
602 su quella linea verrà ignorato. Per convenzione, un commento di linea viene
603 posto @emph{sopra} il codice a cui si riferisce.
607 % questo commento si riferisce ai Si
611 Un commento di blocco segna come commento un'intera sezione di input musicale.
612 Tutto ciò che è compreso tra @code{%@{} e @code{%@}} viene ignorato.
613 Tuttavia, i commenti di blocco non si @q{annidano}. Ovvero non si può
614 inserire un commento di blocco dentro a un altro commento di blocco. Se
615 ci provi, il primo @code{%@}} interromperà @emph{entrambi} i commenti di
616 blocco. Il seguente frammento mostra gli usi possibili per i commenti:
619 % ecco le note di "Ah! Vous dirai-je, Maman"
623 Questa linea e le note sotto vengono ignorate,
624 perché si trovano in un commento di blocco.
633 @node Gestire gli errori
634 @section Gestire gli errori
635 @translationof Dealing with errors
637 @cindex risoluzione dei problemi
639 Talvolta LilyPond non genera l'output che desideri. Questa
640 sezione fornisce alcuni link che possono aiutarti a risolvere i
641 problemi che potrai incontrare.
645 * Consigli generali per la risoluzione dei problemi::
646 * Alcuni errori comuni::
649 @node Consigli generali per la risoluzione dei problemi
650 @subsection Consigli generali per la risoluzione dei problemi
651 @translationof General troubleshooting tips
653 La risoluzione dei problemi in LilyPond può essere un compito impegnativo
654 per le persone che sono abituate a un'interfaccia grafica, perché è possibile
655 creare dei file di input non validi. Quando questo accade, un approccio logico
656 è il modo migliore per identificare e risolvere il problema. Alcune linee guida
657 che ti aiutano a imparare questo sono indicate in @rprogram{Risoluzione dei problemi}.
660 @node Alcuni errori comuni
661 @subsection Alcuni errori comuni
662 @translationof Some common errors
664 @cindex errori comuni
666 Ci sono alcuni errori comuni che sono difficili da risolvere basandosi
667 soltanto sui messaggi di errore che compaiono. Questi sono
668 descritti in @rprogram{Errori comuni}.
671 @node Come leggere i manuali
672 @section Come leggere i manuali
673 @translationof How to read the manuals
675 Questa sezione spiega come leggere la documentazione in modo efficiente e
676 introduce alcune utili funzionalità interattive che sono disponibili
677 nella versione online della documentazione.
681 * Esempi cliccabili::
682 * Panoramica dei manuali::
686 @node Materiale omesso
687 @subsection Materiale omesso
688 @translationof Omitted material
690 @cindex come leggere il manuale
691 @cindex manuale, leggere
692 @cindex leggere il manuale
693 @cindex cliccabili, esempi
694 @cindex esempi cliccabili
695 @cindex consigli su come costruire i file
697 @cindex costruire i file, consigli
698 @cindex file, consigli per costruirli
700 L'input di LilyPond deve essere compreso dai segni @code{@{ @}} o da
701 @q{@w{@code{@bs{}relative @{ @dots{} @}}}}, come abbiamo visto in
702 @ref{Lavorare sui file di input}. Nel resto di questo manuale alcuni
703 esempi brevi ometteranno questi segni. Per replicare questi esempi, puoi
704 copiare l'input mostrato e incollarlo tra @code{@{} e @code{@}} nel tuo
709 @dots{}inserire qui l'esempio@dots{}
713 Ricorda che i file LilyPond devono avere una dichiarazione di
714 versione (@code{\version}). Nei manuali la dichiarazione è omessa
715 perché gli esempi sono frammenti di codice e non file completi.
716 Ma dovresti prendere l'abitudine di includerla nei tuoi file.
718 @node Esempi cliccabili
719 @subsection Esempi cliccabili
720 @translationof Clickable examples
722 @warning{Queste funzionalità sono disponibili soltanto nei manuali in HTML.}
724 Molte persone imparano ad usare un programma provando e smanettando.
725 Questo è possibile anche con LilyPond. Se clicchi su un'immagine
726 nella versione HTML di questo manuale, vedrai l'esatto input
727 LilyPond usato per generare quell'immagine. Provalo su
733 c''4-\markup { \bold \huge { Clicca qui. } }
737 Tagliando e copiando quel che si trova nella sezione @qq{ly snippet},
738 puoi ricavare un modello di partenza per sperimentare. Per vedere esattamente
739 lo stesso output (larghezza della linea e tutto il resto), copia tutto da @qq{Start
740 cut-&-pastable section} alla fine del file.
745 @n ode Keyboard navigation
746 @s ubsection Keyboard navigation
748 @warning{This features is only available in the HTML manuals.}
750 @c TODO: once this is figured out, insert it here.
752 We are currently working on this feature.
756 @node Panoramica dei manuali
757 @subsection Panoramica dei manuali
758 @translationof Overview of manuals
760 La documentazione su LilyPond è vasta. I nuovi utenti talvolta
761 sono confusi su quali parti dovrebbero leggere, e ogni tanto
762 saltano la lettura di parti fondamentali.
764 @warning{Non saltare le parti importanti della
765 documentazione. Altrimenti ti risulterà molto più difficile
766 comprendere le sezioni successive.}
771 @strong{Prima di fare @emph{qualsiasi} tentativo}: leggi il @ref{Tutorial}
772 e la @ref{Notazione comunemente utilizzata} del Manuale di apprendimento. Se
773 ti imbatti in termini musicali che non conosci, cercali nel @rglosnamed{Top, Glossario}.
776 @strong{Prima di tentare di scrivere un pezzo musicale completo}: leggi
777 i @ref{Concetti fondamentali} del Manuale di apprendimento. Dopo puoi dare
778 un'occhiata alle sezioni rilevanti della @rusernamed{Top, Guida alla notazione}.
781 @strong{Prima di cercare di cambiare l'output predefinito}: leggi
782 @ref{Modifica dell'output} del Manuale di apprendimento.
785 @strong{Prima di iniziare un grande progetto}: leggi il documento
786 @rprogram{Consigli su come scrivere i file} del manuale di Uso del programma.