@c -*- coding: utf-8; mode: texinfo; documentlanguage: it -*-
@ignore
- Translation of GIT committish: 44011e382e91f43fb6752b3fbbf8d8984131a565
+ 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.17.11"
+@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}. 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}.
+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.
Ad esempio,
\begin{lilypond}
-\relative c' {
- c2 e2 \tuplet 3/2 { f8 a b } a2 e4
+\relative {
+ c'2 e2 \tuplet 3/2 { f8 a b } a2 e4
}
\end{lilypond}
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 \tuplet 3/2 { f8 a b } a2 e4
+\relative {
+ c'2 e2 \tuplet 3/2 { f8 a b } a2 e4
}
@end lilypond
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
@itemize
@item
-il comando @code{\lilypond@{...@}}, dove si può inserire direttamente del
+il comando @code{\lilypond@{@dots{}@}}, dove si può inserire direttamente del
codice lilypond corto
@item
-l'ambiente @code{\begin@{lilypond@}...\end@{lilypond@}}, dove si può inserire
+l'ambiente @code{\begin@{lilypond@}@dots{}\end@{lilypond@}}, dove si può inserire
direttamente del codice lilypond più lungo
@item
-il comando @code{\lilypondfile@{...@}} per inserire un file lilypond
+il comando @code{\lilypondfile@{@dots{}@}} per inserire un file lilypond
@item
-il comando @code{\musicxmlfile@{...@}} per inserire un file MusicXML, che
+il comando @code{\musicxmlfile@{@dots{}@}} per inserire un file MusicXML, che
sarà elaborato da @code{musicxml2ly} e da @code{lilypond}.
@end itemize
@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
@itemize
@item
-il comando @code{\lilypond@{...@}}, dove si può inserire direttamente del
+il comando @code{\lilypond@{@dots{}@}}, dove si può inserire direttamente del
codice lilypond corto
@item
-l'ambiente @code{\begin@{lilypond@}...\end@{lilypond@}}, dove si può inserire
+l'ambiente @code{\begin@{lilypond@}@dots{}\end@{lilypond@}}, dove si può inserire
direttamente del codice lilypond più lungo
@item
-il comando @code{\lilypondfile@{...@}} per inserire un file lilypond
+il comando @code{\lilypondfile@{@dots{}@}} per inserire un file lilypond
@item
-il comando @code{\musicxmlfile@{...@}} per inserire un file MusicXML, che
+il comando @code{\musicxmlfile@{@dots{}@}} per inserire un file MusicXML, che
sarà elaborato da @code{musicxml2ly} e da @code{lilypond}.
@end itemize
@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.
@itemize
@item
-il comando @code{\lilypond@{...@}}, dove si può inserire direttamente del
+il comando @code{\lilypond@{@dots{}@}}, dove si può inserire direttamente del
codice lilypond corto
@item
-l'ambiente @code{\begin@{lilypond@}...\end@{lilypond@}}, dove si può inserire
+l'ambiente @code{\begin@{lilypond@}@dots{}\end@{lilypond@}}, dove si può inserire
direttamente del codice lilypond più lungo
@item
-il comando @code{\lilypondfile@{...@}} per inserire un file lilypond
+il comando @code{\lilypondfile@{@dots{}@}} per inserire un file lilypond
@item
-il comando @code{\musicxmlfile@{...@}} per inserire un file MusicXML, che
+il comando @code{\musicxmlfile@{@dots{}@}} per inserire un file MusicXML, che
sarà elaborato da @code{musicxml2ly} e da @code{lilypond}.
@end itemize
\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.
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
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 (ma fuori dall'ambiente @code{example} generato da un'opzione
-@code{quote})..
+@code{quote}).
Se il file @file{foo.ly} contiene
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
essere ignorati. Se esegui @command{latex} in modalità due colonne, ricorda
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@}}.
@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
@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 @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}
+@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.
-@itemx --info-images-dir=@var{dir}
+@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.
opzione redirige tutto l'output in dei file di log nella stessa directory dei
file sorgente.
-@itemx --use-source-file-names
+@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 @option{--output-dir} e
@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
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}.