@c -*- coding: utf-8; mode: texinfo; documentlanguage: it -*-
@ignore
- Translation of GIT committish: 26a079ca2393d053315ef8dbef626c897dc9645a
+ 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'
Guide, node Updating translation committishes..
@end ignore
-@c \version "2.16.0"
+@c \version "2.17.6"
@node Eseguire lilypond
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.
@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
+
+lilypond file.ly &> all.txt
+@end example
-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.
+@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
@table @code
-@item -d,--define-default=@var{variabile}=@var{valore}
+@item -d, --define-default=@var{variabile}=@var{valore}
Si veda @ref{Advanced command line options for LilyPond}.
@cindex Scheme, valutazione dell'espressione
@cindex valutazione dell'espressione, Scheme
-@item -e,--evaluate=@var{espressione}
+@item -e, --evaluate=@var{espressione}
Valuta l'@var{espressione} di Scheme prima di analizzare qualsiasi file @file{.ly}.
Si possono specificare varie opzioni @option{-e}; saranno analizzate in modo
sequenziale.
@cindex output, formato
@cindex formato, output
-@item -f,--format=@var{formato}
+@item -f, --format=@var{formato}
Formati di output. Come @code{formato} si può scegliere tra
@code{ps}, @code{pdf} e @code{png}.
Esempio: @code{lilypond -fpng @var{file}.ly}
-@item -h,--help
+@item -h, --help
Mostra una sintesi dell'utilizzo.
-@item -H,--header=@var{CAMPO}
+@item -H, --header=@var{CAMPO}
Estrae un campo dell'intestazione nel file @file{NOME.@var{CAMPO}}.
-@item -i,--init=@var{file}
+@item -i, --init=@var{file}
Imposta il file di inizializzazione su @var{file} (predefinito: @file{init.ly}).
@cindex ricerca dei file
@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.
@cindex gabbia chroot, esecuzione all'interno di
-@item -j,--jail=@var{utente},@var{gruppo},@var{gabbia},@var{directory}
+@item -j, --jail=@var{utente},@var{gruppo},@var{gabbia},@var{directory}
Esegue @command{lilypond} in una gabbia chroot.
L'opzione @option{--jail} fornisce un'alternativa più flessibile a
@cindex loglevel
@cindex output dettagliato
-@item -l,--loglevel=@var{LIVELLO}
+@item -l, --loglevel=@var{LIVELLO}
Imposta la verbosità dell'output della console su @var{LIVELLO}. I valori possibili sono:
@table @code
Solo i messaggi di errore, niente avvisi o messaggi di elaborazione.
@item WARN
-Avvisi e nessaggi di errore, nessun messaggio di elaborazione.
+Avvisi e messaggi di errore, nessun messaggio di elaborazione.
@item BASIC_PROGRESS
Messaggi di elaborazione di base (riuscita), avvisi e errori.
@cindex output, impostare il nome del file
@cindex output, directory
-@item -o,--output=@var{FILE} o @var{CARTELLA}
+@item -o, --output=@var{FILE} o @var{CARTELLA}
Imposta il file di output predefinito @var{FILE} oppure, se una cartella con
quel nome esiste già, dirige l'output in @var{CARTELLA}, prendendo il nome
del file dal file di input. In entrambi i casi verrà aggiunto il suffisso
@cindex output, PNG (Portable Network Graphics)
@item --png
-Genera immmagini di ogni pagina in formato PNG. Questo implica
+Genera immagini di ogni pagina in formato PNG. Questo implica
@option{--ps}. La risoluzione in DPI dell'immagine può essere impostata con
@example
-dresolution=110
@item --pdf
Genera PDF. Questo implica @option{--ps}.
-@item -v,--version
+@item -v, --version
Mostra informazioni sulla versione.
-@item -V,--verbose
+@item -V, --verbose
Aumenta la prolissità: mostra i percorsi completi di tutti i file letti e dà
informazioni sui tempi.
-@item -w,--warranty
+@item -w, --warranty
Mostra la garanzia con cui viene distribuito GNU LilyPond. (Distribuito
con @strong{NESSUNA GARANZIA}!)
@table @code
@item -d@var{[nome-opzione]}=@var{[valore]},--define-default=@var{[nome-opzione]}=@var{[valore]}
-Imposta l'equivalente funzione interna di Scheme su @var{valore}. Se non
-viene specificato un @var{valore}, viene usato il valore predefinito. Per disabilitare
-un'opzione, si può usare il prefisso @code{no-} prima di @var{nome-opzione}, ad esempio
+Imposta l'equivalente funzione interna di Scheme su @var{valore}.
+
+@example
+-dbackend=svg
+@end example
+
+Se non viene specificato un @var{valore}, viene usato il valore
+predefinito. Per disabilitare un'opzione, si può usare il
+prefisso @code{no-} prima di @var{nome-opzione}, ad esempio
@cindex punta e clicca, linea di comando
@code{EPS}.
@item @code{backend}
-@tab @code{'ps}
+@tab @code{ps}
@tab Seleziona il backend. I file Postscript (predefinito) includono i tipi di
carattere @code{TTF}, @code{Type1} e @code{OTF}. Non vengono inclusi i sottoinsiemi
di questi tipi. Se si usa un set di caratteri @q{orientali}, si possono ottenere
file di grosse dimensioni.
@item
-@tab @code{'eps}
+@tab @code{eps}
@tab Encapsulated PostScript. Invia ogni pagina (sistema) in un file
@file{EPS} separato, senza font, e in un unico file @file{EPS} con
tutte le pagine (sistemi) inclusi i font. Questa è la modalità
predefinita di @command{lilypond-book}.
@item
-@tab @code{'null}
+@tab @code{null}
@tab non produce la stampa della partitura; ha lo stesso
effetto di @code{-dno-print-pages}.
@item
-@tab @code{'svg}
+@tab @code{svg}
@tab Scalable Vector Graphics. Crea un singolo file SVG, senza font
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
-@tab @code{'scm}
+@tab @code{scm}
@tab Estrae i comandi di disegno grezzi e interni, basati su Scheme.
@item @code{check-internal-types}
@item @code{max-markup-depth}
@tab @code{1024}
-@tab Maximum depth for the markup tree. If a markup has more levels,
-assume it will not terminate on its own, print a warning and return a
-null markup instead.
+@tab Massima profondità per la struttura del blocco markup. Se un blocco markup ha
+più livelli, assume che non terminerà da solo, stampa un avviso e restituisce
+al suo posto un markup vuoto.
@item @code{midi-extension}
@tab @code{"midi"}
@tab Converte le stringhe di testo in percorsi quando i glifi appartengono a
un font musicale.
-@item @code{old-relative}
-@tab @code{#f}
-@tab Fa sì che il modo @code{\relative} per la musica simultanea funzioni in
-modo simile alla sintassi degli accordi.
-
@item @code{paper-size}
@tab @code{\"a4\"}
@tab Imposta la dimensione predefinita del foglio. Nota che la stringa deve
@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}
titoli e il primo sistema. Se vengono usati i blocchi @code{\book} o
@code{\bookpart}, i titoli di @code{\book}, @code{\bookpart} o @code{\score}
appariranno nell'output, incluso il primo sistema di ogni blocco @code{\score}
-se la variabile @code{print-all-headers} di @code{\paper} è impistata
+se la variabile @code{print-all-headers} di @code{\paper} è impostata
su @code{#t}.
Per impedire il normale output, si usano le opzioni @option{-dprint-pages} o
@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
@item @code{separate-log-files}
@tab @code{#f}
@tab Per i file di input @code{FILE1.ly}, @code{FILE2.ly}, etc. salva i dati di
-log nei file @code{FILE1.log}, @code{FILE2.log}, ...
+log nei file @code{FILE1.log}, @code{FILE2.log}, @dots{}
@item @code{show-available-fonts}
@tab @code{#f}
@tab Non usa le directory dei file di input per costruire i nomi dei file
di output.
+@item @code{strokeadjust}
+@tab @code{#f}
+@tab Forza l'aggiustamento del tratto da parte di PostScript. Questa opzione
+è 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, 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}
@tab @code{#f}
@tab Usa i file di font woff nel backend SVG.
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}.
@menu
* La musica esce dalla pagina::
* Appare un rigo in più::
-* Errore apparente in ../ly/init.ly::
* Messaggio di errore Unbound variable %::
* 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
a musica che esce dalla pagina.}
La durata errata può essere trovata facilmente se si usano i controlli di
-battuta, si veda @ruser{Bar and bar number checks}.
+battuta, si veda @ruser{Controlli di battuta e del numero di battuta}.
Se si vuole davvero ottenere una serie di tali misure sovrapposte
bisogna inserire una barra di divisione invisibile nel punto in cui
-si desidera l'interruzione di linea. Per i dettagli si veda @ruser{Bar lines}.
+si desidera l'interruzione di linea. Per i dettagli si veda
+@ruser{Stanghette}.
@node Appare un rigo in più
conserva il colore nero predefinito per le teste delle note.
@lilypond[quote,verbatim,relative=2]
-\override Staff.NoteHead #'color = #red
+\override Staff.NoteHead.color = #red
\new Staff { a }
@end lilypond
@lilypond[quote,verbatim,relative=2]
\new Staff {
- \override Staff.NoteHead #'color = #red
+ \override Staff.NoteHead.color = #red
a
}
@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 Errore apparente in ../ly/init.ly
-@unnumberedsubsec Errore apparente in @code{../ly/init.ly}
-@translationof Apparent error in ../ly/init.ly
-
-Possono apparire diversi strani messaggi di errore relativi a errori di
-sintassi in @file{../ly/init.ly} se il file di input non ha una forma corretta,
-ad esempio se contiene delle parentesi o delle virgolette non chiuse
-correttamente.
-
-L'errore più comune è la mancanza di una parentesi graffa, (@code{@}}), alla fine
-di un blocco @code{score}. In questo caso la soluzione è ovvia: controlla
-che il blocco @code{score} sia chiuso correttamente. La struttura corretta
-di un file di input è descritta in @rlearning{Come funzionano i file di input di LilyPond}.
-Per evitare questi errori conviene usare un editor che evidenzi automaticamente
-le parentesi e le graffe corrispondenti.
-
-Un'altra causa frequente di errore è la mancanza di uno spazio tra l'ultima
-sillaba di un blocco di testo (lyrics) e la parentesi graffa che chiude il
-blocco, (@code{@}}). Senza questa separazione, la graffa viene considerata
-come parte della sillaba. Si consiglia di assicurarsi sempre che ci sia
-uno spazio prima e dopo @emph{ogni} parentesi graffa. Per comprendere l'importanza
-di questo quando si usa il testo, si veda @ruser{Entering lyrics}.
-
-Questo messaggio di errore può apparire anche nel caso in cui sia omessa la
-virgoletta di chiusura, (@code{"}). In questo caso il messaggio di errore
-@c keep "-matching straight in fancy editors
-dovrebbe dare un numero di riga vicino alla riga sbagliata. La virgoletta
-non chiusa sarà solitamente una o due righe sopra.
@node Messaggio di errore Unbound variable %
@unnumberedsubsec Messaggio di errore Unbound variable %
come un rigo inserendo
@example
-\override VerticalAxisGroup #'staff-affinity = ##f
+\override VerticalAxisGroup.staff-affinity = ##f
@end example
@noindent
all'inizio del contesto. Per dettagli si veda @qq{Spacing of non-staff lines} in
@ruser{Flexible vertical spacing within systems}.
+
+@node Messaggio di errore new inaspettato
+@unnumberedsubsec Messaggio di errore @code{@bs{}new} inaspettato
+@translationof Error message unexpected new
+
+Un blocco @code{\score} deve contenere una @emph{singola} espressione musicale.
+Se invece contiene vari @code{\new Staff}, @code{\new StaffGroup} o simili
+contesti introdotti con @code{\new} senza che questi siano racchiusi tra
+parentesi graffe, @code{@{ @dots{} @}}, o doppie parentesi uncinate, @code{<< @dots{} >>},
+ovvero così:
+
+@example
+\score @{
+ % Invalido! Genera l'errore: errore di sintassi, \new inaspettato
+ \new Staff @{ @dots{} @}
+ \new Staff @{ @dots{} @}
+@}
+@end example
+
+@noindent
+verrà generato questo messaggio di errore.
+
+Per evitare l'errore, è sufficiente racchiudere tutti i blocchi @code{\new} tra
+parentesi graffe o doppie parentesi uncinate.
+
+Se si usano le parentesi graffe, i blocchi @code{\new} appariranno in
+modo sequenziale:
+
+@lilypond[quote,verbatim]
+\score {
+ {
+ \new Staff { a' a' a' a' }
+ \new Staff { g' g' g' g' }
+ }
+}
+@end lilypond
+
+@noindent
+ma è più probabile che si debbano usare le doppie parentesi uncinate in modo
+che i nuovi righi siano avviati in parallelo, ovvero contemporaneamente:
+
+@lilypond[quote,verbatim]
+\score {
+ <<
+ \new Staff { a' a' a' a' }
+ \new Staff { g' g' g' g' }
+ >>
+}
+@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}.