Imported Upstream version 2.16.0

[lilypond.git] / Documentation / it / usage / lilypond-book.itely

diff --git a/Documentation/it/usage/lilypond-book.itely b/Documentation/it/usage/lilypond-book.itely
index 81f0d77717b898fa019c1b0ef95864c145da8878..bd9450a896d5125e0304b294121f8bb43a57be33 100644 (file)
--- a/Documentation/it/usage/lilypond-book.itely
+++ b/Documentation/it/usage/lilypond-book.itely
@@ -1,14 +1,14 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: it -*-
 
 @ignore
 @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
 
 
     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
 
 @c Note: keep this node named so that `info lilypond-book' brings you here.
 @node lilypond-book


@@ -27,23 +27,23 @@ dei caratteri vengono regolate per adeguarsi alla formattazione del documento.
 
 Si tratta di un programma separato da @command{lilypond} e viene lanciato
 dalla linea di comando; per maggiori informazioni, si veda @ref{Command-line
 
 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
 
 Questo procedimento può essere applicato ai documenti @LaTeX{}, HTML, Texinfo
 o DocBook.
 
 @cindex texinfo

-@cindex latex
+@cindex LaTex

 @cindex texinfo
 @cindex texi
 @cindex texinfo
 @cindex texi

-@cindex html
+@cindex HTML

 @cindex docbook
 @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::
 
 @menu
 * Un esempio di documento musicologico::


@@ -100,9 +100,9 @@ Le opzioni vengono specificate tra parentesi quadre.
 Se l'esempio è più grande, è possibile metterlo in un file separato e inserirlo
 con \verb+\lilypondfile+.
 
 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}
 che si trovi nella stessa directory di questo file.)
 
 \end{document}


@@ -160,7 +160,7 @@ c'4 f16
 Se l'esempio è più grande, è possibile riportarlo in un file a parte e inserirlo
 con \verb+\lilypondfile+.
 
 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 @{ @}}.
 
 Perché sia visibile la @code{tagline}, predefinita o personalizzata, l'intero
 frammento deve essere compreso in un costrutto @code{\book @{ @}}.


@@ -204,27 +204,43 @@ Si veda
 @emph{The Not So Short Introduction to @LaTeX{}}} per una panoramica
 sull'uso di @LaTeX{}.
 
 @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@}
 
 @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}@}
 \lilypondfile[le,opzioni,vanno,qui]@{@var{nomefile}@}

+
+\musicxmlfile[le,opzioni,vanno,qui]@{@var{nomefile}@}

 @end example
 
 @noindent
 @end example
 
 @noindent

-oppure
-
-@example
-\lilypond[le,opzioni,vanno,qui]@{ CODICE LILYPOND @}
-@end example

 
 Inoltre, @code{\lilypondversion} mostra la versione
 di lilypond impiegata.
 
 Inoltre, @code{\lilypondversion} mostra la versione
 di lilypond impiegata.


@@ -402,26 +418,40 @@ Texinfo è il formato standard per la documentazione del progetto GNU.  Un
 esempio di documento Texinfo è questo stesso manuale.  Le versioni del manuale
 in formato HTML, PDF e Info vengono generate da un documento Texinfo.
 
 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
 
 @example

-@@lilypond[options,go,here]
+@@lilypond[le,opzioni,vanno,qui]

   IL TUO CODICE LILYPOND
 @@end lilypond
   IL TUO CODICE LILYPOND
 @@end lilypond

-@end example

 
 

-@noindent
-oppure
-
-@example

 @@lilypond[le,opzioni,vanno,qui]@{ IL TUO CODICE LILYPOND @}
 @@lilypond[le,opzioni,vanno,qui]@{ IL TUO CODICE LILYPOND @}

-@end example
-
-@noindent
-oppure

 
 

-@example

 @@lilypondfile[le,opzioni,vanno,qui]@{@var{nomefile}@}
 @@lilypondfile[le,opzioni,vanno,qui]@{@var{nomefile}@}

+
+@@musicxmlfile[le,opzioni,vanno,qui]@{@var{nomefile}@}

 @end example
 
 Inoltre, @code{@@lilypondversion} mostra la versione di
 @end example
 
 Inoltre, @code{@@lilypondversion} mostra la versione di


@@ -467,7 +497,52 @@ nel testo.  Prende sempre un paragrafo proprio.
 @subsection HTML
 @translationof HTML
 
 @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>
 
 @example
 <lilypond fragment relative=2>


@@ -496,6 +571,9 @@ Per includere file separati, si usa
 <lilypondfile @var{option1} @var{option2} ...>@var{filename}</lilypondfile>
 @end example
 
 <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}.
 
 Per una lista di opzioni da usare con gli elementi @code{lilypond} e
 @code{lilypondfile}, si veda @ref{Music fragment options}.
 


@@ -597,11 +675,9 @@ Imposta la dimensione del pentagramma a @var{altezza}, misurata in punti.
 
 @item ragged-right
 Produce linee con margine destro irregolare e spaziatura naturale, ovvero
 
 @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
 
 @item noragged-right
 Per i frammenti di una sola linea, fa sì che la lunghezza del rigo venga estesa


@@ -737,7 +813,8 @@ chiama @file{foo.ly}, verrà creato un file @file{foo.texidoc} a patto che
 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
 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
 
 
 Se il file @file{foo.ly} contiene
 


@@ -773,13 +850,6 @@ contiene un campo @code{texidoc@var{LANG}}, quando si lancia @command{lilypond}
 con l'opzione @option{--header=@/texidoc@var{LANG}} verrà incluso
 @file{foo.texidoc@var{LANG}} invece di @file{foo.texidoc}.
 
 con l'opzione @option{--header=@/texidoc@var{LANG}} verrà incluso
 @file{foo.texidoc@var{LANG}} invece di @file{foo.texidoc}.
 

-@item lilyquote
-(Solo per l'output Texinfo.)  Questa opzione è simile alla citazione, ma solo
-il frammento musicale (e l'opzionale blocco di testo sottinteso dall'opzione
-@code{verbatim}) vengono inseriti in un blocco di citazione.  Questa opzione è
-utile se si vuole citare (@code{quote}) il frammento musicale ma non il
-blocco della documentazione @code{texidoc}.
-

 @item doctitle
 (Solo per l'output Texinfo.) Questa opzione funziona in modo simile
 all'opzione @code{texidoc}: se @command{lilypond} viene lanciato con
 @item doctitle
 (Solo per l'output Texinfo.) Questa opzione funziona in modo simile
 all'opzione @code{texidoc}: se @command{lilypond} viene lanciato con


@@ -858,7 +928,20 @@ verranno incluse nei file @file{.ps} e @file{.pdf}.
 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
 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
 
 
 @subsubheading Texinfo
 


@@ -914,7 +997,14 @@ Aggiunge @var{dir} al percorso di inclusione.  @command{lilypond-book} cerca
 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
 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}
 
 @item -o @var{dir}
 @itemx --output=@var{dir}


@@ -941,10 +1031,17 @@ per la documentazione Info di LilyPond, che è priva di immagini.
 
 @itemx --lily-output-dir=@var{dir}
 Scrive i file lily-XXX nella directory @var{dir}, crea un link nella
 
 @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.
 
 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}.
 @itemx --info-images-dir=@var{dir}
 Formatta l'output di Texinfo in modo che Info cerchi le immagini della musica
 in @var{dir}.


@@ -966,21 +1063,26 @@ a destra della stessa quantità.
 @item -P @var{comando}
 @itemx --process=@var{comando}
 Elabora i frammenti di LilyPond con @var{comando}.  Il comando predefinito è
 @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 --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
 @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
 
 @item -V
 @itemx --verbose

-Mostra un output dettagliato.
+Mostra un output dettagliato.  Questo è equivalente a @code{--loglevel=DEBUG}.

 
 @item -v
 @itemx --version
 
 @item -v
 @itemx --version


@@ -1026,7 +1128,7 @@ automaticamente il formato di output in base all'estensione del file di input.
 
 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
 
 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}.
 
 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}.