X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fit%2Fusage%2Flilypond-book.itely;h=bd9450a896d5125e0304b294121f8bb43a57be33;hb=32a34dcef0c0041c6d62677487a380b5c8b85712;hp=81f0d77717b898fa019c1b0ef95864c145da8878;hpb=f41973ff763d5972a85995b6d40c864281ec6714;p=lilypond.git diff --git a/Documentation/it/usage/lilypond-book.itely b/Documentation/it/usage/lilypond-book.itely index 81f0d77717..bd9450a896 100644 --- 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 - 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 @@ -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 -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:: @@ -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+. -\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} @@ -160,7 +160,7 @@ c'4 f16 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 @{ @}}. @@ -204,27 +204,43 @@ Si veda @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. @@ -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. -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 @@ -467,7 +497,52 @@ nel testo. Prende sempre un paragrafo proprio. @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 + + CODICE LILYPOND + + + + +@var{nomefile} + +@var{nomefile} +@end example + +Ad esempio, puoi scrivere @example @@ -496,6 +571,9 @@ Per includere file separati, si usa @var{filename} @end example +@code{} usa la stessa sintassi di @code{}, 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}. @@ -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 -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 @@ -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 -di musica. +di musica (ma fuori dall'ambiente @code{example} generato da un'opzione +@code{quote}).. 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}. -@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 @@ -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 -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 @@ -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 -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} @@ -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 -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}. @@ -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 è -@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 @@ -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 -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}.