@c -*- coding: utf-8; mode: texinfo; documentlanguage: it -*-
@ignore
- Translation of GIT committish: 2055f35c47a045a50a01ff4dba8524322cfc3b48
+ Translation of GIT committish: 7f48cb638958a728209577caa41bbaca8a2e4ef2
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.19.22"
@c Note: keep this node named so that `info lilypond-book' brings you here.
@node lilypond-book
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}.
+dalla linea di comando; per maggiori informazioni, si veda
+@ref{Uso da linea di comando}. 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::
Ad esempio,
\begin{lilypond}
-\relative c' {
- c2 e2 \times 2/3 { f8 a b } a2 e4
+\relative {
+ c'2 e2 \tuplet 3/2 { f8 a b } a2 e4
}
\end{lilypond}
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}
lilypond-book --output=out --pdf lilybook.lytex
@emph{lilypond-book (GNU LilyPond) @version{} }
@emph{Lettura di lilybook.lytex...}
-@emph{..tagliato molto output..}
+@emph{@dots{}tagliato molto output@dots{}}
@emph{Compilazione di lilybook.tex...}
cd out
pdflatex lilybook.tex
-@emph{..tagliato molto output..}
+@emph{@dots{}tagliato molto output@dots{}}
xpdf lilybook.pdf
@emph{(sostituisci @command{xpdf} col tuo lettore PDF preferito)}
@end example
@subheading Output
-I documenti per \verb+lilypond-book+ possono combinare liberamente musica e testo.
-Ad esempio,
+I documenti per @command{lilypond-book} possono combinare liberamente musica
+e testo. Ad esempio,
@lilypond
-\relative c' {
- c2 e2 \times 2/3 { f8 a b } a2 e4
+\relative {
+ c'2 e2 \tuplet 3/2 { f8 a b } a2 e4
}
@end lilypond
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 @{ @}}.
title = "Una scala in LilyPond"
}
- \relative c' {
- c d e f g a b c
+ \relative {
+ c' d e f g a b c
}
}
@end lilypond
@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@{@dots{}@}}, dove si può inserire direttamente del
+codice lilypond corto
+
+@item
+l'ambiente @code{\begin@{lilypond@}@dots{}\end@{lilypond@}}, dove si può inserire
+direttamente del codice lilypond più lungo
+
+@item
+il comando @code{\lilypondfile@{@dots{}@}} per inserire un file lilypond
+
+@item
+il comando @code{\musicxmlfile@{@dots{}@}} 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.
@example
\onlyFirstNSystems@{3@}
-\begin@{lilypond@}...\end@{lilypond@}
+\begin@{lilypond@}@dots{}\end@{lilypond@}
\onlyFirstNSystems@{1@}
-\begin@{lilypond@}...\end@{lilypond@}
+\begin@{lilypond@}@dots{}\end@{lilypond@}
@end example
@seealso
Esistono opzioni specifiche da linea di comando per @command{lilypond-book} e
altri dettagli da conoscere quando si elaborano documenti @LaTeX{}; si veda
-@ref{Invoking lilypond-book}.
+@ref{Utilizzo di lilypond-book}.
@node 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@{@dots{}@}}, dove si può inserire direttamente del
+codice lilypond corto
+
+@item
+l'ambiente @code{\begin@{lilypond@}@dots{}\end@{lilypond@}}, dove si può inserire
+direttamente del codice lilypond più lungo
+
+@item
+il comando @code{\lilypondfile@{@dots{}@}} per inserire un file lilypond
+
+@item
+il comando @code{\musicxmlfile@{@dots{}@}} 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
@lilypond[fragment,staffsize=11]{<c' e' g'>}
-Diversamente da @LaTeX{}, @code{@@lilypond@{...@}} non genera un'immagine
+Diversamente da @LaTeX{}, @code{@@lilypond@{@dots{}@}} non genera un'immagine
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@{@dots{}@}}, dove si può inserire direttamente del
+codice lilypond corto
+
+@item
+l'ambiente @code{\begin@{lilypond@}@dots{}\end@{lilypond@}}, dove si può inserire
+direttamente del codice lilypond più lungo
+
+@item
+il comando @code{\lilypondfile@{@dots{}@}} per inserire un file lilypond
+
+@item
+il comando @code{\musicxmlfile@{@dots{}@}} 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>
\key c \minor c4 es g2
@end lilypond
-Per le immagini in linea, si usa @code{<lilypond ... />}, dove le opzioni
+Per le immagini in linea, si usa @code{<lilypond @dots{} />}, dove le opzioni
sono distinte dalla musica attraverso i due punti, ad esempio
@example
Per includere file separati, si usa
@example
-<lilypondfile @var{option1} @var{option2} ...>@var{filename}</lilypondfile>
+<lilypondfile @var{opzione1} @var{opzione2} @dots{}>@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}.
+@code{lilypondfile}, si veda @ref{Opzioni dei frammenti musicali}.
Inoltre, @code{<lilypondversion/>} mostra la versione di
lilypond impiegata.
<textobject>
<programlisting language="lilypond" role="fragment verbatim staffsize=16 ragged-right relative=2">
\context Staff \with @{
- \remove Time_signature_engraver
- \remove Clef_engraver@}
+ \remove "Time_signature_engraver"
+ \remove "Clef_engraver"@}
@{ c4( fis) @}
</programlisting>
</textobject>
@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
testuale non mostrerà il blocco @code{relative}, ovvero
@example
-\relative c' @{ % begin verbatim
- c4 e2 g4
+\relative @{ % begin verbatim
+ c'4 e2 g4
f2 e % end verbatim
@}
@end example
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
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
PDF con strumenti come @command{ps2pdf} e @command{pdf2ps} inclusi nel pacchetto
Ghostscript.
-Per creare un file PDF con PDF@LaTeX{}, si usa
+Per creare un file PDF con PDF@LaTeX{}, si usa:
@example
lilypond-book --pdf tuofile.lytex
@cindex type1, carattere
@cindex dvips
@cindex utilizzo di dvips
-Per produrre l'output PDF attraverso @LaTeX{}/@command{dvips}/@command{ps2pdf},
-bisogna usare questi comandi
+Per produrre l'output PDF attraverso @LaTeX{}/@command{dvips}/@command{ps2pdf}:
@example
lilypond-book tuofile.lytex
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}.
+
+Gli ambienti come:
+
+@example
+\begin@{lilypond@} @dots{} \end@{lilypond@}
+@end example
+
+@noindent
+non sono interpretati da @LaTeX{}. @code{lilypond-book} estrae questi
+@q{ambienti} e li copia in file in un suo formato per poter eseguire
+LilyPond su di essi. Prende quindi gli elementi grafici risultanti
+e crea un file @file{.tex} dove le macro
+@code{\begin@{lilypond@}}@dots{}@code{\end@{lilypond@}} sono poi
+sostituite da comandi di @q{inclusione di immagini}. È a questo
+punto che @LaTeX{} viene eseguito (anche se @LaTeX{} è stato eseguito
+in precedenza, in realtà ha agito su un documento @q{vuoto} solo per
+fare alcuni calcoli, come per esempio di @code{\linewidth}).
+
+@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
@command{texi2dvi} o @command{makeinfo}, a seconda del formato di output
che si vuole creare.
@ifinfo
-@xref{Format with texi2dvi, , , texinfo, GNU Texinfo}, e @ref{Creating
-an Info File, , , texinfo, GNU Texinfo}.
+@xref{Format with texi2dvi, , , texinfo, GNU Texinfo}, e
+@ref{Creating an Info File, , , texinfo, GNU Texinfo}.
@end ifinfo
@ifnotinfo
Si veda la documentazione di Texinfo per ulteriori dettagli.
Specifica il tipo di documento da elaborare: @code{html}, @code{latex},
@code{texi} (il formato predefinito) o @code{docbook}. Se manca questa opzione,
@command{lilypond-book} cerca di rilevare il formato automaticamente, si veda
-@ref{Filename extensions}. Attualmente, @code{texi} è equivalente a
+@ref{Estensioni dei nomi di file}. Attualmente, @code{texi} è equivalente a
@code{texi-html}.
@c This complicated detail is not implemented, comment it out -jm
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}
@example
lilypond-book --output=out tuofile.lytex
cd out
-...
+@dots{}
@end example
-@itemx --skip-lily-check
+@item --skip-lily-check
Non si arresta se non viene trovato l'output di lilypond. Viene usata per la
documentazione Info di LilyPond, che è priva di immagini.
-@itemx --skip-png-check
+@item --skip-png-check
Non si arresta se non vengono trovate immagini PNG per i file EPS. Viene usata
per la documentazione Info di LilyPond, che è priva di immagini.
-@itemx --lily-output-dir=@var{dir}
+@item --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 --info-images-dir=@var{dir}
+@item --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.
+
+@item --info-images-dir=@var{dir}
Formatta l'output di Texinfo in modo che Info cerchi le immagini della musica
in @var{dir}.
-@itemx --latex-program=@var{prog}
+@item --latex-program=@var{prog}
Lancia l'eseguibile @command{prog} invece di @command{latex}. Questa opzione
è utile, ad esempio, se il documento è elaborato con @command{xelatex}.
-@itemx --left-padding=@var{quantità}
+@item --left-padding=@var{quantità}
Crea una spaziatura corrispondente a questa quantità tra i riquadri EPS. @var{quantità} è
misurata in millimetri e il valore predefinito è 3.0. Questa opzione si usa
se i righi dello spartito oltrepassano il margine destro.
@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{}.
-@itemx --use-source-file-names
+@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.
+
+@item --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
@knownissues
-Il comando Texinfo @code{@@pagesizes} non viene inrerpretato. Allo stesso
+Il comando Texinfo @code{@@pagesizes} non viene interpretato. Allo stesso
modo, i comandi @LaTeX{} che modificano i margini e la larghezza della linea
dopo il preambolo vengono ignorati.
Si può usare qualsiasi estensione per il file di input, ma se non si usa
l'estensione raccomandata per uno specifico formato potrebbe essere
necessario specificare a mano il formato di output; per i dettagli si veda
-@ref{Invoking lilypond-book}. Altrimenti, @command{lilypond-book} sceglie
+@ref{Utilizzo di lilypond-book}. Altrimenti, @command{lilypond-book} sceglie
automaticamente il formato di output in base all'estensione del file di input.
@quotation
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}.
Normale testo LaTeX.
\begin@{lilypond@}
-\relative c'' @{
- a4 b c d
+\relative @{
+ a'4 b c d
@}
\end@{lilypond@}
Testo Texinfo
@@lilypond
-\relative c' @{
+\relative @{
a4 b c d
@}
@@end lilypond
I documenti per lilypond-book possono combinare liberamente musica e testo. Ad
esempio,
<lilypond>
-\relative c'' @{
- a4 b c d
+\relative @{
+ a'4 b c d
@}
</lilypond>
</p>
<p>
-Ancora un po' di Lilypond, questa volta con delle opzioni:
+Ancora un po' di LilyPond, questa volta con delle opzioni:
<lilypond fragment quote staffsize=26 verbatim>
a4 b c d
(format #f "~a, section, 1, @{~a@}, ~a" page text label))))
(formatted-toc-items (map format-line (toc-items)))
(whole-string (string-join formatted-toc-items ",\n"))
- (output-name (ly:parser-output-name parser))
+ (output-name (ly:parser-output-name))
(outfilename (format "~a.toc" output-name))
(outfile (open-output-file outfilename)))
(if (output-port? outfile)
Altri modi per combinare testo e musica (senza usare
@command{lilypond-book}) sono trattati in
-@ref{LilyPond output in other programs}.
-
-
+@ref{Inclusione di partiture LilyPond in altri programmi}.