]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/it/usage/running.itely
Doc-it: update
[lilypond.git] / Documentation / it / usage / running.itely
index 74b238600f64febcbe5dc2900b9b93be9cfc7a2a..a2c3445b9a8c2efdf0ace0cee5e55e1577779244 100644 (file)
@@ -1,7 +1,7 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: it -*-
 
 @ignore
-    Translation of GIT committish: 93d725094ee629b2d5200ab5a75b609579a62973
+    Translation of GIT committish: 62b428826f37228ab4644dbaabac7935c17ecdcd
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  For details, see the Contributors'
@@ -55,16 +55,16 @@ obiettivi di questo manuale; si prega di consultare altra documentazione su
 questo argomento se non si conosce la linea di comando.
 
 @menu
-* Utilizzo di lilypond::
+* Utilizzo di LilyPond::
 * Opzioni di base della linea di comando per LilyPond::
 * Opzioni avanzate della linea di comando per LilyPond::
 * Variabili d'ambiente::
 * LilyPond in una gabbia chroot::
 @end menu
 
-@node Utilizzo di lilypond
+@node Utilizzo di LilyPond
 @unnumberedsubsec Utilizzo di @command{lilypond}
-@translationof Invoking lilypond
+@translationof Invoking LilyPond
 
 L'eseguibile @command{lilypond} può essere lanciato dalla linea di comando
 nel seguente modo.
@@ -101,28 +101,37 @@ produrrà come output @var{base}@file{-violin.pdf} e
 @var{base}@file{-cello-1.pdf}.
 
 
-@unnumberedsubsubsec Comandi standard da shell
+@unnumberedsubsubsec Usare LilyPond con funzionalità standard della shell
 
-Se la shell (ovvero la finestra dei comandi) utilizzata supporta le normali
-redirezioni, potrebbe essere utile usare i seguenti comandi per dirigere
-l'output di una console in un file:
+Dato che LilyPond è un'applicazione a linea di comando, si possono sfruttare
+le funzionalità della @q{shell} usata per lanciare LilyPond.
 
-@itemize
+Per esempio:
 
-@item
-@code{lilypond file.ly 1>stdout.log} per redirigere l'output normale
+@example
+lilypond *.ly
+@end example
 
-@item
-@code{lilypond file.ly 2>stderr.log} per redirigere i messaggi di errore
+@noindent
+elaborerà tutti i file LilyPond nella directory corrente.
 
-@item
-@code{lilypond file.ly &>all.log} per redirigere tutto l'output
+Potrebbe essere utile anche redirigere l'output della console (per esempio
+in un file):
 
-@end itemize
+@example
+lilypond file.ly 1> stdout.txt
+
+lilypond file.ly 2> stderr.txt
 
-Consulta la documentazione della tua shell per vedere se supporta queste
-opzioni o se la sintassi è diversa.  Nota che questi sono comandi shell
-e non hanno niente a che fare con lilypond.
+lilypond file.ly &> all.txt
+@end example
+
+@noindent
+Questi tre comandi redirigono rispettivamente l'output @q{normale}, gli
+@q{errori} o @q{tutto} in un file di testo.  Consulta la documentazione
+della tua shell, del prompt dei comandi (Windows), delle applicazioni
+Terminale o Console (MacOS X), per vedere se la redirezione dell'output
+è supportata o se la sintassi è diversa.
 
 
 @node Opzioni di base della linea di comando per LilyPond
@@ -190,9 +199,9 @@ Imposta il file di inizializzazione su @var{file} (predefinito: @file{init.ly}).
 @cindex percorso di ricerca
 
 @item -I, --include=@var{directory}
-Aggiunge @var{directory} al percorso di ricerca per i file di input.
 
 È possibile assegnare più opzioni -I.  La ricerca inizierà nella prima
+Aggiunge @var{directory} al percorso di ricerca per i file di input.
 directory definita, e se il file da includere non viene trovato
 la ricerca continuerà nelle directory seguenti.
 
@@ -408,8 +417,7 @@ incorporati, per ogni pagina dell'output.  Si raccomanda di installare i
 font Century Schoolbook, inclusi nell'installazione di LilyPond, per una
 resa ottimale.  In UNIX basta copiare questi font dalla directory di
 LilyPond (solitamente @file{/usr/share/lilypond/VERSION/fonts/otf/}) in
-@file{~/.fonts/}.  L'output SVG dovrebbe essere compatibile con qualsiasi
-editor SVG o user agent.  C'è anche un'opzione @code{svg-woff} (sotto) per
+@file{~/.fonts/}.  C'è anche un'opzione @code{svg-woff} (sotto) per
 poter usare i file di font woff nel backend SVG.
 
 @item
@@ -553,8 +561,8 @@ essere compresa tra virgolette precedute dal segno di escape.
 @tab Imposta il formato di output di GhostScript per le immagini raster.
 
 @item @code{point-and-click}
-@tab @code{#f}
-@tab Aggiunge i collegamenti @q{punta e clicca} all'output @code{PDF}. Si veda
+@tab @code{#t}
+@tab Aggiunge i collegamenti @q{punta e clicca} all'output PDF e SVG. Si veda
 @ref{Point and click}.
 
 @item @code{preview}
@@ -619,9 +627,9 @@ scempio, ad esempio
 
 @quotation
 @verbatim
-#(system "rm -rf /")
+#(s ystem "rm -rf /")  % troppo pericoloso per scriverlo correttamente
 {
-  c4^$(ly:gulp-file "/etc/passwd")
+  c4^$(ly:gulp-file "/etc/passwd") % malvagio ma non distruttivo
 }
 @end verbatim
 @end quotation
@@ -670,13 +678,12 @@ di output.
 @item @code{strokeadjust}
 @tab @code{#f}
 @tab Forza l'aggiustamento del tratto da parte di PostScript.  Questa opzione
-è utile quando il @code{PDF} è generato dall'output PostScript (l'aggiustamento
+è utile quando il PDF è generato dall'output PostScript (l'aggiustamento
 del tratto di solito è abilitato automaticamente per gli strumenti bitmap
-a bassa risoluzione).  Senza questa opzione, le anteprime@tie{}@code{PDF}
-tendono a produrre larghezze dei gambi molto variabili alle risoluzioni
-tipiche dei monitor.  L'opzione non produce effetti visibili sulla
-qualità di stampa e causa un notevole aumento della dimensione dei file
-@code{PDF}.
+a bassa risoluzione).  Senza questa opzione, i lettori PDF tendono a
+produrre larghezze dei gambi molto variabili alle risoluzioni tipiche
+dei monitor.  L'opzione non produce effetti visibili sulla qualità di
+stampa e causa un notevole aumento della dimensione dei file PDF.
 
 
 @item @code{svg-woff}
@@ -922,12 +929,19 @@ test.ly:2:19: error: not a duration: 5
            5 g' @}
 @end example
 
-Queste posizioni indicano la migliore ipotesi di LilyPond a proposito del
-punto in cui l'avvertimento o l'errore sono comparsi, ma (per loro
+Queste posizioni indicano il punto in cui LilyPond ritiene più probabile
+che siano apparsi l'avvertimento o l'errore, ma (per loro
 stessa natura) avvertimenti ed errori capitano quando succede qualcosa
-di imprevisto.  Se non riesci a vedere un errore nella riga indicata
-del file di input, prova a controllare una o due righe sopra la posizione
-indicata.
+di imprevisto.  Se non riesci a vedere un errore nella riga suggerita,
+prova a controllare una o due righe sopra la posizione indicata.
+
+Attenzione: l'analisi degli errori è sempre attivata nel corso dei vari
+passaggi di elaborazione.  Per esempio, se ci sono parti di input che
+sono elaborati varie volte (es: per produrre l'output midi e quello
+grafico) oppure se viene usata la stessa variabile musicale in vari
+contesti, potrebbe apparire lo stesso messaggio molteplici volte.  Anche
+la diagnosi eseguita in uno degli @q{ultimi} passaggi (es: controlli di
+battuta) può apparire varie volte.
 
 Maggiori informazioni sugli errori si trovano in @ref{Errori comuni}.
 
@@ -948,6 +962,7 @@ comprese, è facile gestirle.
 * Messaggio di errore FT_Get_Glyph_Name::
 * Avvertimento sul fatto che le affinità del rigo devono solo diminuire::
 * Messaggio di errore new inaspettato::
+* Avviso ignorare troppe collisioni tra colonne di nota::
 @end menu
 
 @node La musica esce dalla pagina
@@ -1011,29 +1026,6 @@ corretto per colorare le teste di tutte le note è
 }
 @end lilypond
 
-Vediamo un secondo esempio.  Se un comando @code{\relative} viene posto
-dentro un comando @code{\repeat}, vengono generati due righi, il secondo
-spostato orizzontalmente rispetto al primo, perché il comando @code{\repeat}
-genera due blocchi @code{\relative}, ognuno dei quali crea implicitamente i
-blocchi @code{Staff} e @code{Voice}.
-
-@lilypond[quote,verbatim]
-\repeat unfold 2 {
-  \relative c' { c4 d e f }
-}
-@end lilypond
-
-Per correggere il problema basta istanziare esplicitamente il contesto
-@code{Voice}:
-
-@lilypond[quote,verbatim]
-\new Voice {
-  \repeat unfold 2 {
-    \relative c' { c4 d e f }
-  }
-}
-@end lilypond
-
 
 @node Messaggio di errore Unbound variable %
 @unnumberedsubsec Messaggio di errore Unbound variable %
@@ -1123,3 +1115,40 @@ che i nuovi righi siano avviati in parallelo, ovvero contemporaneamente:
   >>
 }
 @end lilypond
+
+@node Avviso ignorare troppe collisioni tra colonne di nota
+@unnumberedsubsec Avviso ignorare troppe collisioni tra colonne di nota
+@translationof Warning ignoring too many clashing note columns
+
+Se note appartenenti a due voci diverse con gambi nella stessa
+direzione si trovano nello stesso momento musicale, e per le voci
+non è stato specificato alcun spostamento, quando si compila il
+file apparirà il messaggio di avviso
+@samp{avviso: ignorare troppe collisioni tra colonne di nota}.
+Tale avviso apparirà anche quando le note non hanno gambi visibili,
+come nel caso delle semibrevi, se i gambi di note più brevi della
+stessa altezza sono nella stessa direzione.
+
+Ricorda che la direzione del gambo, a meno che non sia specificata, per
+esempio tramite @code{\voiceOne}, etc., dipende dalla posizione della
+nota sul rigo.  Dunque se la direzione del gambo non è specificata, l'avviso
+apparirà solo quando i gambi si trovano nella stessa direzione, ovvero
+quando le note si trovano nella stessa metà del rigo.
+
+Si possono evitare questi avvisi mettendo le note in voci in cui siano
+indicate le direzioni dei gambi e gli spostamenti, per esempio usando
+@code{\voiceOne}, etc.
+
+Le note delle voci con un numero maggiore di due, @code{\voiceThree} etc., sono
+spostate automaticamente per avitare la collisione tra colonne di note.  Ciò
+causa uno spostamento visibile delle note con gambo, mentre le semibrevi
+non sono spostate visibilmente, a meno che non si verifichi una reale collisione
+tra teste di nota oppure quando le voci si incrociano rispetto al loro ordine
+naturale (quando le note di @code{\voiceThree} sono più alte di quelle di
+@code{\voiceOne}, etc.)
+
+@seealso
+@rlearning{Definire esplicitamente le voci},
+@rlearning{Esempio musicale},
+@ruser{Polifonia su un singolo rigo},
+@ruser{Risoluzione delle collisioni}.