1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: it -*-
4 Translation of GIT committish: 88cfc9ee61dece9cffff98ab7f10318633698c39
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
38 @node Inserire l'input
39 @subsection Inserire l'input
40 @translationof Entering input
43 @cindex esempio iniziale
44 @cindex esempio, iniziale
45 @cindex maiuscole, sensibile alle
51 @qq{Compilazione} è il termine usato per indicare l'elaborazione di un
52 file di input in formato LilyPond per produrre uno o più file di output. I
53 file di output generalmente sono PDF (per la stampa e la visualizzazione),
54 MIDI (per la riproduzione audio) e PNG (per l'utilizzo online). I file di
55 input di LilyPond sono semplici file di testo.
57 Questo esempio mostra un semplice file di input:
60 \version "@w{@version{}}"
68 @c in this case we don't want verbatim
75 @warning{Le note e i testi nel file LilyPond devono essere sempre
76 scritti tra @w{@strong{@{ parentesi graffe @}}}. Per evitare ambiguità, le
77 parentesi dovrebbero essere delimitate da degli spazi, a meno che non si
78 trovino all'inizio o alla fine di una linea. Può darsi che in alcuni esempi
79 di questo manuale le parentesi verranno omesse, ma non dimenticarle
80 nella tua musica! Per maggiori informazioni sull'aspetto degli esempi
81 nel manuale, si veda @ref{How to read the manuals}.}
83 Inoltre, l'input di LilyPond è @strong{sensibile alle maiuscole}.
84 @w{@samp{@{ c d e @}}} è un input valido; @w{@samp{@{ C D E @}}} invece
85 produrrà un messaggio di errore.
89 @node Generare l'output
90 @unnumberedsubsubsec Generare l'output
91 @translationof Producing output
93 @c TODO: move index entries
95 @cindex vedere la musica
96 @cindex editor di testo
98 Come generare l'output di LilyPond dipende dal tuo sistema operativo e dai
104 @ref{MacOS X, @sourceimage{logo-macosx,,,}}
105 @ref{MacOS X, MacOS X} (grafico)
108 @ref{Windows, @sourceimage{logo-windows,,,}}
109 @ref{Windows, Microsoft Windows} (grafico)
112 @ref{Command-line, @sourceimage{logo-linux,,,}
113 @sourceimage{logo-freebsd,,,}
114 @sourceimage{logo-macosx,,,}
115 @sourceimage{logo-windows,,,}
117 @ref{Command-line, Tutti i sistemi operativi} (linea di comando)
121 Si noti che sono disponibili molti altri editor di testo con
122 un miglior supporto per LilyPond. Per maggiori informazioni, si veda
123 @rweb{Editing facilitato}.
125 @warning{La prima volta che si esegue LilyPond la compilazione potrà richiedere
126 uno o due minuti perché tutti i font di sistema devono essere prima
127 analizzati. In seguito, LilyPond sarà molto più veloce!}
132 @cindex eseguire LilyPond in MacOS X
133 @cindex MacOS X, eseguire LilyPond
141 @cindex eseguire LilyPond in Windows
142 @cindex Windows, eseguire LilyPond
147 @node Linea di comando
148 @subsection Linea di comando
149 @translationof Command-line
151 @cindex eseguire LilyPond in Unix
152 @cindex Unix, eseguire LilyPond
157 @node Come scrivere i file di input
158 @section Come scrivere i file di input
159 @translationof How to write input files
161 Questa sezione introduce le basi della sintassi di LilyPond e ha l'obiettivo
162 di aiutarti ad iniziare a scrivere i file di input.
165 * Notazione semplice::
166 * Lavorare sui file di input::
169 @node Notazione semplice
170 @subsection Notazione semplice
171 @translationof Simple notation
173 @cindex notazione semplice
174 @cindex notazione, semplice
180 * Indicazione di tempo::
181 * Indicazioni di tempo::
186 LilyPond aggiungerà automaticamente alcuni elementi della notazione. Nell'esempio
187 seguente, abbiamo specificato soltanto quattro note, ma LilyPond
188 ha aggiunto una chiave, il tempo e le durate.
190 @lilypond[verbatim,quote]
197 Questo comportamento può essere modificato, ma nella maggior parte dei
198 casi questi valori sono utili.
202 @unnumberedsubsubsec Altezze
203 @translationof Pitches
206 @cindex modo relativo
209 @cindex alterazioni e modo relativo
210 @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
392 Glossario musicale: @rglosnamed{time signature,indicazione di tempo}.
394 Il @notation{tempo} si imposta con il comando @code{\time}:
396 @lilypond[verbatim,quote]
407 @node Indicazioni di tempo
408 @unnumberedsubsubsec Indicazioni di tempo
409 @translationof Tempo marks
411 @cindex indicazioni di tempo
412 @cindex indicazioni metronomiche
417 Glossario musicale: @rglosnamed{tempo indication,indicazione di tempo},
418 @rglosnamed{metronome,metronomo}.
420 L' @notation{indicazione di tempo} e l' @notation{indicazione metronomica} si
421 impostano col comando @code{\tempo}:
423 @lilypond[verbatim,quote]
432 \tempo "Presto" 4 = 120
439 @unnumberedsubsubsec Chiave
443 @cindex chiave di violino
451 Glossario musicale: @rglosnamed{clef,chiave}.
453 La @notation{chiave} si imposta con il comando @code{\clef}:
455 @lilypond[verbatim,quote]
470 @unnumberedsubsubsec Tutto insieme
471 @translationof All together
473 Ecco un piccolo esempio che mostra tutti questi elementi insieme:
475 @lilypond[verbatim,quote]
479 \tempo "Andante" 4 = 120
489 Guida alla notazione: @ruser{Inserimento delle altezze},
490 @ruser{Inserimento delle durate}, @ruser{Inserimento delle pause},
491 @ruser{Indicazione di tempo}, @ruser{Chiave}.
494 @node Lavorare sui file di input
495 @subsection Lavorare sui file di input
496 @translationof Working on input files
498 @cindex parentesi graffe
499 @cindex graffe, parentesi
501 @cindex commento di linea
502 @cindex linea, commento di
503 @cindex commento di blocco
504 @cindex blocco, commento di
505 @cindex sensibile alle maiuscole
506 @cindex insensibile agli spazi
508 @cindex versionamento
510 @cindex numero di versione
515 @funindex %@{ ... %@}
517 I file di input di LilyPond sono simili ai file sorgenti di molti comuni
518 linguaggi di programmazione. Contengono una dichiarazione di versione, sono
519 sensibili alle maiuscole, e in generale gli spazi bianchi vengono ignorati. Le
520 espressioni musicali si formano con parentesi graffe @w{@code{@{ @}}}, e i commenti
521 sono indicati con @code{%} o @w{@code{%@{ @dots{} %@}}}@tie{}.
523 Se le frasi precedenti ti sembrano assurde, non preoccuparti! Spiegheremo
524 cosa significano tutti questi termini:
529 @strong{Dichiarazione di versione}:
530 Ogni file LilyPond deve contenere una dichiarazione di versione. Una
531 dichiarazione di versione è una linea che indica la versione di LilyPond per la
532 quale il file è stato scritto, come nel seguente esempio:
535 \version "@w{@version{}}"
538 Per convenzione, la dichiarazione di versione viene posta all'inizio del file
541 La dichiarazione di versione è importante per almeno due ragioni. Primo,
542 permette l'aggiornamento automatico del file di input file via via che la
543 sintassi di LilyPond cambia. Secondo, indica la versione di LilyPond richiesta
544 per compilare il file.
546 Se la dichiarazione di versione è omessa dal file di input, LilyPond mostra
547 un avvertimento durante la compilazione del file.
550 @strong{Sensibile alle maiuscole}:
551 distingue tra lettere in minuscolo (es:
552 @w{@code{a, b, s, t}}) o in maiuscolo (es: @w{@code{A, B, S, T}}).
553 Le note sono in minuscolo: @w{@code{@{ c d e @}}} è un input valido;
554 @w{@code{@{ C D E @}}} causerà un messaggio di errore.
557 @strong{Insensibile agli spazi}:
558 non importa quanti spazi (o tabulazioni o nuove linee) aggiungi.
559 @w{@samp{@{ c4 d e @}}} ha lo stesso significato di
560 @w{@samp{@{ c4 @tie{} @tie{} @tie{} d e @}}} e:
568 Certo, l'esempio precedente è scomodo da leggere. Una buona regola
569 pratica è indentare i blocchi di codice con una tabulazione o due spazi:
577 Tuttavia, uno spazio bianco @emph{è} necessario per separare molti elementi
578 sintattici gli uni dagli altri. In altre parole, lo spazio bianco può essere
579 @emph{aggiunto}, ma non può essere @emph{eliminato}. Dal momento che uno
580 spazio bianco mancante può dare adito a strani errori, si consiglia di
581 inserire sempre uno spazio bianco prima e dopo ogni elemento sintattico,
582 ad esempio, prima e dopo ogni parentesi graffa.
585 @strong{Espressioni}:
586 ogni parte dell'input di LilyPond deve avere @strong{@{@tie{}parentesi@tie{}graffe@tie{}@}}
587 intorno. Queste parentesi dicono a LilyPond che l'input costituisce
588 un'espressione musicale singola, proprio come le parentesi @code{()} in
589 matematica. Per evitare ambiguità, le parentesi dovrebbero essere
590 racchiuse tra spazi, a meno che non si trovino all'inizio o alla fine di una linea.
592 Anche un comando di LilyPond seguito da un'espressione semplice in
593 parentesi (come @q{@w{@code{@bs{}relative c' @{ @dots{} @}}}}) conta come
594 un'espressione musicale singola.
597 @cindex commento di linea
598 @cindex commento di blocco
601 un commento è un appunto per il lettore umano dell'input musicale; viene
602 ignorato quando l'input viene analizzato, dunque non ha alcun effetto
603 sull'output finale. Ci sono due tipi di commenti. Il simbolo di percentuale
604 @code{%} introduce un commento di linea; tutto quello che sta dopo @code{%}
605 su quella linea verrà ignorato. Per convenzione, un commento di linea viene
606 posto @emph{sopra} il codice a cui si riferisce.
610 % questo commento si riferisce ai Si
614 Un commento di blocco segna come commento un'intera sezione di input musicale.
615 Tutto ciò che è compreso tra @code{%@{} e @code{%@}} viene ignorato.
616 Tuttavia, i commenti di blocco non si @q{annidano}. Ovvero non si può
617 inserire un commento di blocco dentro a un altro commento di blocco. Se
618 ci provi, il primo @code{%@}} interromperà @emph{entrambi} i commenti di
619 blocco. Il seguente frammento mostra gli usi possibili per i commenti:
622 % ecco le note di "Ah! Vous dirai-je, Maman"
626 Questa linea e le note sotto vengono ignorate,
627 perché si trovano in un commento di blocco.
636 @node Gestire gli errori
637 @section Gestire gli errori
638 @translationof Dealing with errors
640 @cindex risoluzione dei problemi
642 Talvolta LilyPond non genera l'output che desideri. Questa
643 sezione fornisce alcuni link che possono aiutarti a risolvere i
644 problemi che potrai incontrare.
648 * Consigli generali per la risoluzione dei problemi::
649 * Alcuni errori comuni::
652 @node Consigli generali per la risoluzione dei problemi
653 @subsection Consigli generali per la risoluzione dei problemi
654 @translationof General troubleshooting tips
656 La risoluzione dei problemi in LilyPond può essere un compito impegnativo
657 per le persone che sono abituate a un'interfaccia grafica, perché è possibile
658 creare dei file di input non validi. Quando questo accade, un approccio logico
659 è il modo migliore per identificare e risolvere il problema. Alcune linee guida
660 che ti aiutano a imparare questo sono indicate in @rprogram{Risoluzione dei problemi}.
663 @node Alcuni errori comuni
664 @subsection Alcuni errori comuni
665 @translationof Some common errors
667 @cindex errori comuni
669 Ci sono alcuni errori comuni che sono difficili da risolvere basandosi
670 soltanto sui messaggi di errore che compaiono. Questi sono
671 descritti in @rprogram{Errori comuni}.
674 @node Come leggere i manuali
675 @section Come leggere i manuali
676 @translationof How to read the manuals
678 Questa sezione spiega come leggere la documentazione in modo efficiente e
679 introduce alcune utili funzionalità interattive che sono disponibili
680 nella versione online della documentazione.
684 * Esempi cliccabili::
685 * Panoramica dei manuali::
689 @node Materiale omesso
690 @subsection Materiale omesso
691 @translationof Omitted material
693 @cindex come leggere il manuale
694 @cindex manuale, leggere
695 @cindex leggere il manuale
696 @cindex cliccabili, esempi
697 @cindex esempi cliccabili
698 @cindex consigli su come costruire i file
700 @cindex costruire i file, consigli
701 @cindex file, consigli per costruirli
703 L'input di LilyPond deve essere compreso dai segni @code{@{ @}} o da
704 @q{@w{@code{@bs{}relative @{ @dots{} @}}}}, come abbiamo visto in
705 @ref{Working on input files}. Nel resto di questo manuale alcuni
706 esempi brevi ometteranno questi segni. Per replicare questi esempi, puoi
707 copiare l'input mostrato e incollarlo tra @code{@{} e @code{@}} nel tuo
712 @dots{}inserire qui l'esempio@dots{}
716 Ricorda che i file LilyPond devono avere una dichiarazione di
717 versione (@code{\version}). Nei manuali la dichiarazione è omessa
718 perché gli esempi sono frammenti di codice e non file completi.
719 Ma dovresti prendere l'abitudine di includerla nei tuoi file.
721 @node Esempi cliccabili
722 @subsection Esempi cliccabili
723 @translationof Clickable examples
725 @warning{Queste funzionalità sono disponibili soltanto nei manuali in HTML.}
727 Molte persone imparano ad usare un programma provando e smanettando.
728 Questo è possibile anche con LilyPond. Se clicchi su un'immagine
729 nella versione HTML di questo manuale, vedrai l'esatto input
730 LilyPond usato per generare quell'immagine. Provalo su
736 c''4-\markup { \bold \huge { Clicca qui. } }
740 Tagliando e copiando quel che si trova nella sezione @qq{ly snippet},
741 puoi ricavare un modello di partenza per sperimentare. Per vedere esattamente
742 lo stesso output (larghezza della linea e tutto il resto), copia tutto da @qq{Start
743 cut-&-pastable section} alla fine del file.
748 @n ode Keyboard navigation
749 @s ubsection Keyboard navigation
751 @warning{This features is only available in the HTML manuals.}
753 @c TODO: once this is figured out, insert it here.
755 We are currently working on this feature.
759 @node Panoramica dei manuali
760 @subsection Panoramica dei manuali
761 @translationof Overview of manuals
763 La documentazione su LilyPond è vasta. I nuovi utenti talvolta
764 sono confusi su quali parti dovrebbero leggere, e ogni tanto
765 saltano la lettura di parti fondamentali.
767 @warning{Non saltare le parti importanti della
768 documentazione. Altrimenti ti risulterà molto più difficile
769 comprendere le sezioni successive.}
774 @strong{Prima di fare @emph{qualsiasi} tentativo}: leggi il @ref{Tutorial}
775 e la @ref{Common notation} del Manuale di apprendimento. Se
776 ti imbatti in termini musicali che non conosci, cercali nel @rglosnamed{Top, Glossario}.
779 @strong{Prima di tentare di scrivere un pezzo musicale completo}: leggi
780 i @ref{Fundamental concepts} del Manuale di apprendimento. Dopo puoi dare
781 un'occhiata alle sezioni rilevanti della @rusernamed{Top, Guida alla notazione}.
784 @strong{Prima di cercare di cambiare l'output predefinito}: leggi
785 @ref{Tweaking output} del Manuale di apprendimento.
788 @strong{Prima di iniziare un grande progetto}: leggi il documento
789 @rprogram{Consigli su come scrivere i file} del manuale di Uso del programma.