@c -*- coding: utf-8; mode: texinfo; documentlanguage: it -*-
@ignore
- Translation of GIT committish: 2055f35c47a045a50a01ff4dba8524322cfc3b48
+ Translation of GIT committish: f71ede90de06fdc16dad9ed75f38558efe819080
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.13.36"
+@c \version "2.16.0"
@c Note: keep this node named so that `info lilypond-book' brings you here.
@node lilypond-book
Si tratta di un programma separato da @command{lilypond} e viene lanciato
dalla linea di comando; per maggiori informazioni, si veda @ref{Command-line
-usage}. Chi usa MacOS 10.3 o 10.4 e non riesce ad eseguire
-@code{lilypond-book} veda @rweb{MacOS X}.
+usage}. In caso di problemi nell'eseguire @code{lilypond-book} da linea di
+comando su Windows o Mac OS X, si veda @rweb{Windows} o @rweb{MacOS X}.
Questo procedimento può essere applicato ai documenti @LaTeX{}, HTML, Texinfo
o DocBook.
@cindex texinfo
-@cindex latex
+@cindex LaTex
@cindex texinfo
@cindex texi
-@cindex html
+@cindex HTML
@cindex docbook
-@cindex documenti, aggiungere musica ai
-@cindex HTML, musica in
-@cindex Texinfo, musica in
-@cindex DocBook, musica in
-@cindex @LaTeX{}, musica in
+@cindex documenti, aggiungere musica
+@cindex HTML, aggiungere musica
+@cindex Texinfo, aggiungere musica
+@cindex DocBook, aggiungere musica
+@cindex LaTeX, aggiungere musica
@menu
* Un esempio di documento musicologico::
Se l'esempio è più grande, è possibile metterlo in un file separato e inserirlo
con \verb+\lilypondfile+.
-\lilypondfile[quote,noindent]{screech-boink.ly}
+\lilypondfile[quote,noindent]{screech-and-boink.ly}
-(Se vuoi provare, sostituisci @file{screech-boink.ly} con qualsiasi file @file{.ly}
+(Se vuoi provare, sostituisci @file{screech-and-boink.ly} con qualsiasi file @file{.ly}
che si trovi nella stessa directory di questo file.)
\end{document}
Se l'esempio è più grande, è possibile riportarlo in un file a parte e inserirlo
con \verb+\lilypondfile+.
-@lilypondfile[quote,noindent]{screech-boink.ly}
+@lilypondfile[quote,noindent]{screech-and-boink.ly}
Perché sia visibile la @code{tagline}, predefinita o personalizzata, l'intero
frammento deve essere compreso in un costrutto @code{\book @{ @}}.
@emph{The Not So Short Introduction to @LaTeX{}}} per una panoramica
sull'uso di @LaTeX{}.
-La musica si inserisce in vari modi:
+@code{lilypond-book} fornisce i seguenti comandi e ambienti per includere
+la musica nei file @LaTeX{}:
+
+@itemize
+
+@item
+il comando @code{\lilypond@{...@}}, dove si può inserire direttamente del
+codice lilypond corto
+
+@item
+l'ambiente @code{\begin@{lilypond@}...\end@{lilypond@}}, dove si può inserire
+direttamente del codice lilypond più lungo
+
+@item
+il comando @code{\lilypondfile@{...@}} per inserire un file lilypond
+
+@item
+il comando @code{\musicxmlfile@{...@}} per inserire un file MusicXML, che
+sarà elaborato da @code{musicxml2ly} e da @code{lilypond}.
+
+@end itemize
+
+Nel file di input, la musica viene specificata con uno dei seguenti comandi:
@example
\begin@{lilypond@}[le,opzioni,vanno,qui]
CODICE LILYPOND
\end@{lilypond@}
-@end example
-@noindent
-oppure
+\lilypond[le,opzioni,vanno,qui]@{ CODICE LILYPOND @}
-@example
\lilypondfile[le,opzioni,vanno,qui]@{@var{nomefile}@}
+
+\musicxmlfile[le,opzioni,vanno,qui]@{@var{nomefile}@}
@end example
@noindent
-oppure
-
-@example
-\lilypond[le,opzioni,vanno,qui]@{ CODICE LILYPOND @}
-@end example
Inoltre, @code{\lilypondversion} mostra la versione
di lilypond impiegata.
esempio di documento Texinfo è questo stesso manuale. Le versioni del manuale
in formato HTML, PDF e Info vengono generate da un documento Texinfo.
-Nel file di input, la musica viene indicata con
+@code{lilypond-book} fornisce i seguenti comandi e ambienti per includere
+musica nei file Texinfo:
+
+@itemize
+
+@item
+il comando @code{\lilypond@{...@}}, dove si può inserire direttamente del
+codice lilypond corto
+
+@item
+l'ambiente @code{\begin@{lilypond@}...\end@{lilypond@}}, dove si può inserire
+direttamente del codice lilypond più lungo
+
+@item
+il comando @code{\lilypondfile@{...@}} per inserire un file lilypond
+
+@item
+il comando @code{\musicxmlfile@{...@}} per inserire un file MusicXML, che
+sarà elaborato da @code{musicxml2ly} e da @code{lilypond}.
+
+@end itemize
+
+Nel file di input, la musica viene specificata con uno dei seguenti comandi
@example
-@@lilypond[options,go,here]
+@@lilypond[le,opzioni,vanno,qui]
IL TUO CODICE LILYPOND
@@end lilypond
-@end example
-
-@noindent
-oppure
-@example
@@lilypond[le,opzioni,vanno,qui]@{ IL TUO CODICE LILYPOND @}
-@end example
-@noindent
-oppure
-
-@example
@@lilypondfile[le,opzioni,vanno,qui]@{@var{nomefile}@}
+
+@@musicxmlfile[le,opzioni,vanno,qui]@{@var{nomefile}@}
@end example
Inoltre, @code{@@lilypondversion} mostra la versione di
@subsection HTML
@translationof HTML
-La musica si inserisce in questo modo
+@code{lilypond-book} fornisce i seguenti comandi e ambienti per includere
+musica nei file HTML:
+
+@itemize
+
+@item
+il comando @code{\lilypond@{...@}}, dove si può inserire direttamente del
+codice lilypond corto
+
+@item
+l'ambiente @code{\begin@{lilypond@}...\end@{lilypond@}}, dove si può inserire
+direttamente del codice lilypond più lungo
+
+@item
+il comando @code{\lilypondfile@{...@}} per inserire un file lilypond
+
+@item
+il comando @code{\musicxmlfile@{...@}} per inserire un file MusicXML, che
+sarà elaborato da @code{musicxml2ly} e da @code{lilypond}.
+
+@end itemize
+
+Nel file di input, la musica viene specificata con uno dei seguenti comandi:
+
+\begin@{lilypond@}[le,opzioni,vanno,qui]
+ CODICE LILYPOND
+\end@{lilypond@}
+
+\lilypond[le,opzioni,vanno,qui]@{ CODICE LILYPOND @}
+
+\lilypondfile[le,opzioni,vanno,qui]@{@var{nomefile}@}
+
+\musicxmlfile[le,opzioni,vanno,qui]@{@var{nomefile}@}
+@example
+<lilypond le opzioni vanno qui>
+ CODICE LILYPOND
+</lilypond>
+
+<lilypond le opzioni vanno qui: CODICE LILYPOND />
+
+<lilypondfile le opzioni vanno qui>@var{nomefile}</lilypondfile>
+
+<musicxmlfile le opzioni vanno qui>@var{nomefile}</musicxmlfile>
+@end example
+
+Ad esempio, puoi scrivere
@example
<lilypond fragment relative=2>
<lilypondfile @var{option1} @var{option2} ...>@var{filename}</lilypondfile>
@end example
+@code{<musicxmlfile>} usa la stessa sintassi di @code{<lilypondfile>}, ma semplicemente
+si riferisce a un file MusicXML invece che a un file LilyPond.
+
Per una lista di opzioni da usare con gli elementi @code{lilypond} e
@code{lilypondfile}, si veda @ref{Music fragment options}.
@item ragged-right
Produce linee con margine destro irregolare e spaziatura naturale, ovvero
-viene aggiunto @code{ragged-right = ##t} al frammento LilyPond. Questa è
-l'impostazione predefinita per il comando @code{\lilypond@{@}} se non è presente
-un'opzione @code{line-width}. È anche l'impostazione predefinita per l'ambiente
-@code{lilypond} se viene usata l'opzione @code{fragment} senza specificare
-esplicitamente la larghezza della linea.
+viene aggiunto @code{ragged-right = ##t} al frammento LilyPond. Frammenti
+con un solo rigo avranno sempre il margine destro irregolare, a meno che
+non venga specificato esplicitamente @code{noragged-right}.
@item noragged-right
Per i frammenti di una sola linea, fa sì che la lunghezza del rigo venga estesa
ci sia un campo @code{texidoc} nel blocco @code{\header}. L'opzione @code{texidoc}
fa sì che @command{lilypond-book} includa tali file, aggiungendo il loro
contenuto in forma di blocco di documentazione proprio prima del frammento
-di musica.
+di musica (ma fuori dall'ambiente @code{example} generato da un'opzione
+@code{quote})..
Se il file @file{foo.ly} contiene
L'esecuzione di @command{dvips} potrebbe generare dei messaggi di avviso
relativi ai caratteri; questi messaggi sono innocui e possono
essere ignorati. Se esegui @command{latex} in modalità due colonne, ricorda
-di aggiungere @code{-t landscape} alle opzioni di @command{dvips}.
+di aggiungere @option{-t landscape} alle opzioni di @command{dvips}.
+
+@knownissues
+Il comando @code{\pageBreak} non funziona all'interno dell'ambiente
+@code{\begin@{lilypond@} @dots{} \end@{lilypond@}}.
+
+Molte variabili del blocco @code{\paper} non funzionano all'interno dell'ambiente
+@code{\begin@{lilypond@} @dots{} \end@{lilypond@}}. Usa
+@code{\newcommand} con @code{\betweenLilyPondSystem} nel preambolo;
+
+@example
+\newcommand@{\betweenLilyPondSystem@}[1]@{\vspace@{36mm@}\linebreak@}
+@end example
+
@subsubheading Texinfo
anche dei frammenti già compilati nel percorso di inclusione e non li riscrive
nella directory di output, quindi in alcuni casi è necessario eseguire
ulteriori comandi come @command{makeinfo} o @command{latex} con le stesse
-opzioni @code{-I @var{dir}}.
+opzioni @option{-I @var{dir}}.
+
+@item -l @var{loglevel}
+@itemx --loglevel=@var{loglevel}
+Imposta la verbosità dell'output su @var{loglevel}. I valori possibili sono @code{NONE},
+@code{ERROR}, @code{WARNING}, @code{PROGRESS} (predefinito) e @code{DEBUG}. Se
+questa opzione non viene usata e la variabile d'ambiente @code{LILYPOND_BOOK_LOGLEVEL}
+è impostata, il suo valore viene usato come loglevel.
@item -o @var{dir}
@itemx --output=@var{dir}
@itemx --lily-output-dir=@var{dir}
Scrive i file lily-XXX nella directory @var{dir}, crea un link nella
-directory @code{--output}. Si usa questa opzione per risparmiare tempo nella
+directory @option{--output}. Si usa questa opzione per risparmiare tempo nella
compilazione di documenti situati in directory diverse che condividono
molti identici frammenti.
+@itemx --lily-loglevel=@var{loglevel}
+Set the output verbosity of the invoked @command{lilypond} calls to @var{loglevel}.
+I valori possibili sono @code{NONE}, @code{ERROR}, @code{WARNING}, @code{BASIC_PROGRESS},
+@code{PROGRESS}, @code{INFO} (predefinito) e @code{DEBUG}. Se questa opzione
+non viene usata e la variabile d'ambiente @code{LILYPOND_LOGLEVEL} è
+impostata, il suo valore viene usato come loglevel.
+
@itemx --info-images-dir=@var{dir}
Formatta l'output di Texinfo in modo che Info cerchi le immagini della musica
in @var{dir}.
@item -P @var{comando}
@itemx --process=@var{comando}
Elabora i frammenti di LilyPond con @var{comando}. Il comando predefinito è
-@code{lilypond}. @code{lilypond-book} non userà @code{--filter} e
-@code{--process} contemporaneamente.
+@code{lilypond}. @code{lilypond-book} non userà @option{--filter} e
+@option{--process} contemporaneamente.
@item --pdf
Crea file PDF da usare con PDF@LaTeX{}.
+@item --redirect-lilypond-output
+Per impostazione predefinita, l'output viene mostrato sul terminale. Questa
+opzione redirige tutto l'output in dei file di log nella stessa directory dei
+file sorgente.
+
@itemx --use-source-file-names
Salva i file di output dei frammenti con lo stesso nome, esclusa l'estensione,
dei sorgenti. Questa opzione funziona solo con i frammenti inclusi con
-@code{lilypondfile} e solo se le directory indicate da @code{--output-dir} e
-@code{--lily-output-dir} sono diverse.
+@code{lilypondfile} e solo se le directory indicate da @option{--output-dir} e
+@option{--lily-output-dir} sono diverse.
@item -V
@itemx --verbose
-Mostra un output dettagliato.
+Mostra un output dettagliato. Questo è equivalente a @code{--loglevel=DEBUG}.
@item -v
@itemx --version
Se si usa per il file di input la stessa estensione che @command{lilypond-book}
usa per il file di output e se il file di input è nella stessa directory
-in cui lavora @command{lilypond-book}, bisogna usare l'opzione @code{--output}
+in cui lavora @command{lilypond-book}, bisogna usare l'opzione @option{--output}
per far sì che @command{lilypond-book} sia eseguito; altrimenti si ferma e
mostra un messaggio di errore simile a @qq{L'output sovrascriverebbe il file di input}.