1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: it -*-
4 Translation of GIT committish: 10bd5cc93870ac4b884b8cb938cfc6a19c768097
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} (graphical)
104 @ref{Windows, @sourceimage{logo-windows,,,}}
105 @ref{Windows, Microsoft Windows} (graphical)
108 @ref{Command-line, @sourceimage{logo-linux,,,}
109 @sourceimage{logo-freebsd,,,}
110 @sourceimage{logo-macosx,,,}
111 @sourceimage{logo-windows,,,}
113 @ref{Command-line, All operating systems} (command-line)
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: @rglos{pitch}, @rglos{interval},
202 @rglos{scale}, @rglos{middle C}, @rglos{octave},
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: @rglos{beam}, @rglos{duration},
307 @rglos{whole note}, @rglos{half note}, @rglos{quarter note},
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: @rglos{rest}.
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: @rglos{time signature}.
366 Il @notation{tempo} si imposta con il comando @code{\time}:
368 @lilypond[verbatim,quote]
379 @subheading Tempo marks
382 @cindex metronome marks
387 Glossario musicale: @rglos{tempo indication}, @rglos{metronome}.
389 L' @notation{indicazione di tempo} e l' @notation{indicazione metronomica} si
390 impostano col comando @code{\tempo}:
392 @lilypond[verbatim,quote]
401 \tempo "Presto" 4 = 120
410 @cindex chiave di violino
418 Glossario musicale: @rglos{clef}.
420 La @notation{chiave} si imposta con il comando @code{\clef}:
422 @lilypond[verbatim,quote]
436 @subheading Tutto insieme
438 Ecco un piccolo esempio che mostra tutti questi elementi insieme:
440 @lilypond[verbatim,quote]
444 \tempo "Andante" 4 = 120
454 Guida alla notazione: @ruser{Writing pitches},
455 @ruser{Writing rhythms}, @ruser{Writing rests},
456 @ruser{Time signature}, @ruser{Clef}.
459 @node Lavorare sui file di input
460 @subsection Lavorare sui file di input
461 @translationof Working on input files
463 @cindex parentesi graffe
464 @cindex graffe, parentesi
466 @cindex commento di linea
467 @cindex linea, commento di
468 @cindex commento di blocco
469 @cindex blocco, commento di
470 @cindex sensibile alle maiuscole
471 @cindex insensibile agli spazi
473 @cindex versionamento
475 @cindex numero di versione
480 @funindex %@{ ... %@}
482 I file di input di LilyPond sono simili ai file sorgenti di molti comuni
483 linguaggi di programmazione. Contengono una dichiarazione di versione, sono
484 sensibili alle maiuscole, e in generale gli spazi bianchi vengono ignorati. Le
485 espressioni musicali si formano con parentesi graffe @w{@code{@{ @}}}, e i commenti
486 sono indicati con @code{%} o @w{@code{%@{ @dots{} %@}}}@tie{}.
488 Se le frasi precedenti ti sembrano assurde, non preoccuparti! Spiegheremo
489 cosa significano tutti questi termini:
494 @strong{Dichiarazione di versione}:
495 Ogni file LilyPond dovrebbe contenere una dichiarazione di versione. Una
496 dichiarazione di versione è una linea che indica la versione di LilyPond per la
497 quale il file è stato scritto, come nel seguente esempio:
500 \version "@w{@version{}}"
503 Per convenzione, la dichiarazione di versione viene posta all'inizio del file
506 La dichiarazione di versione è importante per almeno due ragioni. Primo,
507 permette l'aggiornamento automatico del file di input file via via che la
508 sintassi di LilyPond cambia. Secondo, indica la versione di LilyPond richiesta
509 per compilare il file.
511 Se la dichiarazione di versione è omessa dal file di input, LilyPond stampa
512 un avvertimento durante la compilazione del file.
515 @strong{Sensibile alle maiuscole}:
516 distingue tra lettere in minuscolo (es:
517 @w{@code{a, b, s, t}}) o in maiuscolo (es: @w{@code{A, B, S, T}}).
518 Le note sono in minuscolo: @w{@code{@{ c d e @}}} è un input valido;
519 @w{@code{@{ C D E @}}} causerà un messaggio di errore.
522 @strong{Insensibile agli spazi}:
523 non importa quanti spazi (o tabulazioni o nuove linee) aggiungi.
524 @w{@samp{@{ c4 d e @}}} ha lo stesso significato di
525 @w{@samp{@{ c4 @tie{} @tie{} @tie{} d e @}}} e:
533 Certo, l'esempio precedente è scomodo da leggere. Una buona regola
534 pratica è indentare i blocchi di codice con una tabulazione o due spazi:
542 Tuttavia, uno spazio bianco @emph{è} necessario per separare molti elementi
543 sintattici gli uni dagli altri. In altre parole, lo spazio bianco può essere
544 @emph{aggiunto}, ma non può essere @emph{eliminato}. Dal momento che uno
545 spazio bianco mancante può dare adito a strani errori, si consiglia di
546 inserire sempre uno spazio bianco prima e dopo ogni elemento sintattico,
547 ad esempio, prima e dopo ogni parentesi graffa.
550 @strong{Espressioni}:
551 ogni parte dell'input di LilyPond deve avere @strong{@{@tie{}parentesi@tie{}graffe@tie{}@}}
552 intorno. Queste parentesi dicono a LilyPond che l'input costituisce
553 un'espressione musicale singola, proprio come le parentesi @code{()} in
554 matematica. Per evitare ambiguità, le parentesi dovrebbero essere
555 racchiuse tra spazi, a meno che non si trovino all'inizio o alla fine di una linea.
557 Anche un comando di LilyPond seguito da un'espressione semplice in
558 parentesi (come @q{@w{@code{@bs{}relative c' @{ @dots{} @}}}}) conta come
559 un'espressione musicale singola.
562 @cindex commento di linea
563 @cindex commento di blocco
566 un commento è un appunto per il lettore umano dell'input musicale; viene
567 ignorato quando l'input viene analizzato, dunque non ha alcun effetto
568 sull'output finale. Ci sono due tipi di commenti. Il simbolo di percentuale
569 @code{%} introduce un commento di linea; tutto quello che sta dopo @code{%}
570 su quella linea verrà ignorato. Per convenzione, un commento di linea viene
571 posto @emph{sopra} il codice a cui si riferisce.
575 % this comment refers to the Bs
579 Un commento di blocco segna come commento un'intera sezione di input musicale.
580 Tutto ciò che è compreso tra @code{%@{} e @code{%@}} viene ignorato.
581 Tuttavia, i commenti di blocco non si @q{annidano}. Ovvero non si può
582 inserire un commento di blocco dentro a un altro commento di blocco. Se
583 ci provi, il primo @code{%@}} interromperà @emph{entrambi} i commenti di
584 blocco. Il seguente frammento mostra gli usi possibili per i commenti:
587 % notes for twinkle twinkle follow
591 This line, and the notes below are ignored,
592 since they are in a block comment.
601 @node Gestire gli errori
602 @section Gestire gli errori
603 @translationof Dealing with errors
605 @cindex troubleshooting
607 Talvolta LilyPond non genera l'output che vorresti. Questa
608 sezione fornisce alcuni link che possono aiutarti a risolvere i
609 problemi che potrai incontrare.
613 * Consigli generali per la risoluzione dei problemi::
614 * Alcuni errori comuni::
617 @node Consigli generali per la risoluzione dei problemi
618 @subsection Consigli generali per la risoluzione dei problemi
619 @translationof General troubleshooting tips
621 La risoluzione dei problemi in LilyPond può essere un compito impegnativo
622 per le persone che sono abituate a un'interfaccia grafica, perché è possibile
623 creare dei file di input non validi. Quando questo accade, un approccio logico
624 è il modo migliore per identificare e risolvere il problema. Alcune linee guida
625 che ti aiutano a imparare questo sono indicate in @rprogram{Troubleshooting}.
628 @node Alcuni errori comuni
629 @subsection Alcuni errori comuni
630 @translationof Some common errors
632 @cindex errori comuni
634 Ci sono alcuni errori comuni che sono difficili da risolvere basandosi
635 soltanto sui messaggi di errore che compaiono. Questi sono
636 descritti in @rprogram{Common errors}.
639 @node Come leggere i manuali
640 @section Come leggere i manuali
641 @translationof How to read the manuals
643 Questa sezione spiega come leggere la documentazione in modo efficiente, e
644 introduce anche alcune utili funzionalità interattive che sono disponibili
645 nella versione online della documentazione.
649 * Esempi cliccabili::
650 * Panoramica dei manuali::
654 @node Materiale omesso
655 @subsection Materiale omesso
656 @translationof Omitted material
658 @cindex come leggere il manuale
659 @cindex manuale, leggere
660 @cindex leggere il manuale
661 @cindex cliccabili, esempi
662 @cindex esempi cliccabili
663 @cindex consigli su come costruire i file
665 @cindex costruire i file, consigli
666 @cindex file, consigli per costruirli
668 L'input di LilyPond deve essere compreso dai segni @code{@{ @}} o da
669 @q{@w{@code{@bs{}relative c'' @{ @dots{} @}}}}, come abbiamo visto in @ref{Lavorare
670 sui file di input}. Nella parte restante di questo manuale, gran parte
671 degli esempi ometterà questi segni. Per replicare gli esempi, puoi copiare
672 e incollare l'input mostrato, ma @strong{devi} aggiungere
673 @q{@w{@code{@bs{}relative c'' @{ @dots{} @}}}} in questo modo:
677 @dots{}example goes here@dots{}
681 Perché omettere le parentesi? Gran parte degli esempi in questo manuale
682 possono essere inseriti nel mezzo di un pezzo più ampio. Per questi esempi,
683 non ha senso includere @q{@w{@code{@bs{}relative c'' @{ @dots{} @}}}} --
684 non si deve mettere un @code{\relative} dentro un altro
685 @code{\relative}! Se includessimo @q{@w{@code{@bs{}relative c'' @{ @dots{} @}}}}
686 in ogni esempio, non potresti copiare un piccolo esempio della
687 documentazione e incollarlo dentro a un tuo brano più
688 esteso. La maggior parte delle persone vuole aggiungere del materiale a
689 un brano esistente, per questo abbiamo strutturato il manuale in questo modo.
691 Ricorda che i file LilyPond dovrebbero avere una dichiarazione di
692 versione (@code{\version}). Nei manuali la dichiarazione è omessa
693 perché gli esempi sono frammenti di codice e non file completi.
694 Ma dovresti prendere l'abitudine di includerla nei tuoi file.
696 @node Esempi cliccabili
697 @subsection Esempi cliccabili
698 @translationof Clickable examples
700 @warning{Queste funzionalità sono disponibili soltanto nei manuali in HTML.}
702 Molte persone imparano ad usare un programma provando e smanettando.
703 Questo è possibile anche con LilyPond. Se clicchi su un'immagine
704 nella versione HTML di questo manuale, vedrai l'esatto input
705 LilyPond usato per generare quell'immagine. Provalo su
711 c4-\markup { \bold \huge { Click here. } }
715 Tagliando e copiando quel che si trova nella sezione @qq{ly snippet},
716 puoi ricavare un modello di partenza per sperimentare. Per vedere esattamente
717 lo stesso output (larghezza della linea e tutto il resto), copia tutto da @qq{Start
718 cut-&-pastable section} alla fine del file.
723 @n ode Keyboard navigation
724 @s ubsection Keyboard navigation
726 @warning{This features is only available in the HTML manuals.}
728 @c TODO: once this is figured out, insert it here.
730 We are currently working on this feature.
734 @node Panoramica dei manuali
735 @subsection Panoramica dei manuali
736 @translationof Overview of manuals
738 La documentazione su LilyPond è vasta. I nuovi utenti talvolta
739 sono confusi su quali parti dovrebbero leggere, e ogni tanto
740 saltano la lettura di parti fondamentali.
742 @warning{Non saltare le parti importanti della
743 documentazione. Altrimenti ti risulterà molto più difficile comprendere
744 le sezioni successive.}
749 @strong{Prima di fare @emph{qualsiasi} tentativo}: leggi il @ref{Tutorial}
750 e la @ref{Notazione comunemente utilizzata} del Manuale di apprendimento. Se
751 ti imbatti in termini musicali che non conosci, cercali nel @rglosnamed{Top, Glossario}.
754 @strong{Prima di tentare di scrivere un pezzo musicale completo}: leggi
755 i @ref{Concetti fondamentali} del Manuale di apprendimento. Dopo puoi dare
756 un'occhiata alle sezioni rilevanti della @rusernamed{Top, Notation reference}.
759 @strong{Prima di cercare di cambiare l'output predefinito}: leggi il
760 @ref{Tweaking output} del Manuale di apprendimento.
763 @strong{Prima di iniziare un grande progetto}: leggi il documento
764 @rprogram{Suggestions for writing files} del manuale di Uso del programma.