@c -*- coding: utf-8; mode: texinfo; documentlanguage: it -*-
@ignore
- Translation of GIT committish: 2055f35c47a045a50a01ff4dba8524322cfc3b48
+ Translation of GIT committish: afa67f5aac628a66db3de8f47244bde02581ed55
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.21"
@node Programmi esterni
@chapter Programmi esterni
@node Punta e clicca
@section Punta e clicca
@translationof Point and click
-
@cindex punta e clicca
-Il "punta e clicca" (@emph{point and click}) permette di individuare gli elementi
-musicali nell'input cliccando su di essi nel lettore PDF. In questo modo è più
-facile trovare la parte dell'input responsabile di un errore nello spartito.
+Il "punta e clicca" aggiunge dei collegamenti ai documenti pdf per certi
+elementi musicali.
+
+@menu
+* Configurare il sistema per il punta e clicca::
+* Abilitare il punta e clicca::
+* Punta e clicca selettivo::
+@end menu
+
+@node Configurare il sistema per il punta e clicca
+@subsection Configurare il sistema
+@translationof Configuring the system for point and click
Quando questa funzionalità è attiva, LilyPond aggiunge dei collegamenti
-ipertestuali al file PDF. Questi collegamenti vengono inviati al browser web,
-che apre un editor di testo col cursore posizionato nel punto giusto.
+ipertestuali al file PDF e SVG. Questi collegamenti vengono inviati a un
+@q{programma di supporto per URI} o al browser web, che apre un editor di testo
+col cursore posizionato nel punto giusto.
Perché questo procedimento funzioni è necessario configurare il lettore PDF
in modo che segua i collegamenti ipertestuali usando lo script @file{lilypond-invoke-editor}
fornito insieme a LilyPond.
-Per Xpdf su UNIX, occorre inserire la seguente linea nel file
-@file{xpdfrc}@footnote{Su UNIX, questo file si trova in
-@file{/etc/xpdfrc} o come @file{.xpdfrc} nella propria directory home.}
-
-@example
-urlCommand "lilypond-invoke-editor %s"
-@end example
-
@file{lilypond-invoke-editor} è un piccolo programma di supporto. Lancia un
editor per gli URI @code{textedit} e un browser web per altri URI. Valuta
la variabile d'ambiente @code{EDITOR} in base a questi schemi,
@noindent
per @code{LYEDITOR} è equivalente alla chiamata standard emacsclient.
+@menu
+* Usare Xpdf per il punta e clicca::
+* Usare GNOME 2 per il punta e clicca::
+* Usare GNOME 3 per il punta e clicca::
+* Ulteriore configurazione per Evince::
+@end menu
-@cindex file size, output
+@node Usare Xpdf per il punta e clicca
+@unnumberedsubsubsec Usare Xpdf
+@translationof Using Xpdf for point and click
+@cindex Xpdf
+
+Se si usa Xpdf su UNIX, si deve inserire la seguente riga nel file
+@file{xpdfrc}. Su UNIX, questo file può essere @file{/etc/xpdfrc}
+oppure @file{$HOME/.xpdfrc}.
+
+@example
+urlCommand "lilypond-invoke-editor %s"
+@end example
+
+Se si usa Ubuntu, è probabile che la versione di Xpdf
+installata nel sistema causi il crash per qualsiasi file PDF: questa
+situazione continua da molti anni ed è dovuta a una corrispondenza
+sbagliata tra librerie. Conviene installare un pacchetto aggiornato
+di @samp{xpdf} e il corrispondente pacchetto @samp{libpoppler} da
+Debian. Dopo aver verificato che funziona, si può usare il comando
+@example
+sudo apt-mark hold xpdf
+@end example
+@noindent
+per impedire a Ubuntu di sovrascriverlo al prossimo @q{aggiornamento} del
+suo pacchetto difettoso.
+
+@node Usare GNOME 2 per il punta e clicca
+@unnumberedsubsubsec Usare GNOME 2
+@translationof Using GNOME 2 for point and click
+
+Per usare GNOME 2 (e i visualizzatori PDF ad esso integrati), il magico
+comando che fornisce al sistema gli URI @samp{textedit:} è:
+
+@smallexample
+gconftool-2 -t string -s /desktop/gnome/url-handlers/textedit/command "lilypond-invoke-editor %s"
+gconftool-2 -s /desktop/gnome/url-handlers/textedit/needs_terminal false -t bool
+gconftool-2 -t bool -s /desktop/gnome/url-handlers/textedit/enabled true
+@end smallexample
+
+Dopo questi comandi:
+
+@example
+gnome-open textedit:///etc/issue:1:0:0
+@end example
+@noindent
+dovrebbe lanciare @file{lilypond-invoke-editor} per l'apertura del file.
+
+@node Usare GNOME 3 per il punta e clicca
+@unnumberedsubsubsec Usare GNOME 3
+@translationof Using GNOME 3 for point and click
+
+In GNOME 3, gli URI sono gestiti da @q{gvfs} invece che da
+@q{gconf}. Si crea un file in una directory locale (ad esempio @file{/tmp})
+che abbia il nome @file{lilypond-invoke-editor.desktop} e il seguente contenuto:
+
+@example
+[Desktop Entry]
+Version=1.0
+Name=lilypond-invoke-editor
+GenericName=Textedit URI handler
+Comment=URI handler for textedit:
+Exec=lilypond-invoke-editor %u
+Terminal=false
+Type=Application
+MimeType=x-scheme-handler/textedit;
+Categories=Editor
+NoDisplay=true
+@end example
+e poi si eseguono i comandi
+@example
+xdg-desktop-menu install ./lilypond-invoke-editor.desktop
+xdg-mime default lilypond-invoke-editor.desktop x-scheme-handler/textedit
+@end example
+
+Dopo questi comandi:
+
+@example
+gnome-open textedit:///etc/issue:1:0:0
+@end example
+@noindent
+dovrebbe lanciare @file{lilypond-invoke-editor} per l'apertura del file.
+
+@node Ulteriore configurazione per Evince
+@unnumberedsubsubsec Ulteriore configurazione per Evince
+@translationof Extra configuration for Evince
+@cindex Evince
+
+Se @code{gnome-open} funziona, ma Evince si rifiuta ancora di
+aprire i collegamenti punta e clicca a causa di permessi negati,
+potrebbe essere necessario cambiare il profilo Apparmor di
+Evince che controlla il tipo di azioni che Evince ha il
+permesso di eseguire.
+
+In Ubuntu, si modifica il file
+@file{/etc/apparmor.d/local/usr.bin.evince} e si aggiungono le
+seguenti righe:
+@example
+# Per i collegamenti Textedit
+/usr/local/bin/lilypond-invoke-editor Cx -> sanitized_helper,
+@end example
+@noindent
+
+Dopo aver aggiunto queste righe, si lancia il comando
+
+@example
+sudo apparmor_parser -r -T -W /etc/apparmor.d/usr.bin.evince
+@end example
+
+@noindent
+Ora Evince dovrebbe essere in grado di aprire i collegamenti punta e
+clicca. È probabile che configurazioni simili funzionino anche
+con altri visualizzatori.
+
+
+@node Abilitare il punta e clicca
+@unnumberedsubsec Abilitare il punta e clicca
+@translationof Enabling point and click
+
+@cindex dimensione del file di output
+@cindex file di output, dimensione
+
+La funzionalità "punta e clicca" è abilitata di default quando si creano
+i file PDF o SVG.
I collegamenti "punta e clicca" appesantiscono sensibilmente i file di output. Per
-ridurre la dimensione dei file PDF e PS, è possibile disattivare il "punta e
-clicca" inserendo
+ridurre la dimensione di questi file (e dei file PS), è possibile disattivare
+il "punta e clicca" inserendo
@example
\pointAndClickOff
@end example
@warning{Occorre sempre disattivare il "punta e clicca" nei file LilyPond
-che si vogliano diffondere, per evitare di includere nel file .pdf delle informazioni
+che si vogliano diffondere, per evitare di includere nel file PDF delle informazioni
sui percorsi del proprio computer: questo infatti può costituire un rischio di
sicurezza.}
+
+@node Punta e clicca selettivo
+@unnumberedsubsec Punta e clicca selettivo
+@translationof Selective point-and-click
+
+Per alcune applicazioni interattive, si potrebbe voler includere
+soltanto alcuni elementi punta e clicca. Ad esempio, se qualcuno
+volesse creare un'applicazione che riproduca audio o video a partire
+da una nota in particolare, sarebbe inopportuno che il clic sulla
+nota portasse alla posizione di un'alterazione o di una legatura
+che si trovi sopra quella nota.
+
+Questo può essere controllato indicando quali eventi includere:
+
+@itemize
+@item
+Codice interno al file @file{.ly}:
+
+@example
+\pointAndClickTypes #'note-event
+\relative @{
+ c'2\f( f)
+@}
+@end example
+
+oppure
+
+@example
+#(ly:set-option 'point-and-click 'note-event)
+\relative @{
+ c'2\f( f)
+@}
+@end example
+
+@item
+Linea di comando:
+
+@example
+lilypond -dpoint-and-click=note-event example.ly
+@end example
+
+@end itemize
+
+Si può includere più di un evento:
+
+@itemize
+@item
+Codice interno al file @file{.ly}:
+
+@example
+\pointAndClickTypes #'(note-event dynamic-event)
+\relative @{
+ c'2\f( f)
+@}
+@end example
+
+oppure
+
+@example
+#(ly:set-option 'point-and-click '(note-event dynamic-event))
+\relative @{
+ c'2\f( f)
+@}
+@end example
+
+@item
+Linea di comando:
+
+@smallexample
+lilypond \
+ -e"(ly:set-option 'point-and-click '(note-event dynamic-event))" \
+ example.ly
+@end smallexample
+
+
+@end itemize
+
+
@node LilyPond e gli editor di testo
@section LilyPond e gli editor di testo
@translationof Text editor support
filetype off
set runtimepath+=/usr/local/share/lilypond/current/vim/
filetype on
+syntax on
@end example
@noindent
Se LilyPond non è installato nella directory @file{/usr/local/},
modifica il percorso in modo adeguato. Questo argomento è trattato in
-@rlearning{Other sources of information}.
+@rlearning{Altre fonti di informazione}.
@node Altri editor
Altri editor (sia testuali che grafici) supportano LilyPond, ma i loro
specifici file di configurazione non sono distribuiti insieme a
LilyPond. Consulta la documentazione di questi programmi per maggiori
-informazioni. Questi editor sono elencati in @rweb{Easier editing}.
+informazioni. Questi editor sono elencati in @rweb{Editing facilitato}.
@node Conversione da altri formati
È possibile registrare un file MIDI usando una tastiera digitale e poi
convertirlo in file @file{.ly}. Tuttavia, la conversione da MIDI a LY non
è banale: l'esecuzione umana non sarà mai sufficientemente precisa dal punto di vista
-ritmico. Se lanciata con la quantizzazione (opzioni @code{-s} e @code{-d})
+ritmico. Se lanciata con la quantizzazione (opzioni @option{-s} e @option{-d})
@command{midi2ly} cerca di compensare questi errori di tempo, ma non è
molto efficace. Dunque non si raccomanda l'uso di @command{midi2ly}
per i file midi generati a partire da un'esecuzione umana.
@item -e, --explicit-durations
Crea durate esplicite.
-@item -h,--help
+@item -h, --help
Mostra una sintesi dell'utilizzo del programma.
@item -k, --key=@var{acc}[:@var{minor}]
Scrive l'output in @var{file}.
@item -s, --start-quant=@var{DUR}
-Quantize note starts on @var{DUR}.
+La quantizzazione delle note inizia su @var{DUR}.
@item -t, --allow-tuplet=@var{DUR}*@var{NUM}/@var{DEN}
Consente l'inserimento di gruppi irregolari @var{DUR}*@var{NUM}/@var{DEN}.
@command{musicxml2ly} estrae le note, le articolazioni, la struttura della
partitura, il testi, etc. da file MusicXML organizzati in parti; quindi li
-scrive in un file @file{.ly}. Si usa dalla linea di comando.
-
+scrive in un file @file{.ly}. Si lancia dalla linea di comando nel modo
+seguente:
-Si lancia dalla linea di comando nel modo seguente,
@example
musicxml2ly [@var{opzione}]@dots{} @var{file-xml}
@end example
@item -a, --absolute
converte le altezze relative in assolute.
-@item -h,--help
+@item -h, --help
mostra una sintesi dell'utilizzo e delle opzioni.
@item -l, --language=LANG
usa LANG per i nomi delle altezze, ad esempio 'deutsch' per i nomi delle note
in tedesco.
+@item --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}.
+
@item --lxml
usa il pacchetto Python lxml.etree per l'analisi della sintassi XML; usa meno
memoria e tempo del processore.
-@item --nd --no-articulation-directions
+@item -m, --midi
+attiva il blocco midi.
+
+@item -nd, --no-articulation-directions
non converte le direzioni (@code{^}, @code{_} o @code{-}) per
articolazioni, dinamiche, etc.
ignora le informazioni relative alle travature, impiegando la disposizione
automatica delle travature fornita da LilyPond.
-@item -o,--output=@var{file}
+@item -o, --output=@var{file}
imposta il nome del file di output su @var{file}. Se @var{file} è @file{-}, l'output
sarà salvato su stdout. Se non specificato, verrà usato @var{file-xml}@file{.ly}.
-@item -r,--relative
+@item -r, --relative
converte le altezze in modalità relativa (predefinito).
@item -v, --verbose
@item --version
Mostra informazioni sulla versione.
-@item -z,--compressed
+@item -z, --compressed
il file di input è un file MusicXML compresso in un archivio ZIP.
@end table
@subsection Utilizzo di @code{abc2ly}
@translationof Invoking abc2ly
-@warning{Questo programma non è supportato e potrebbe essere rimosso
-dalle future versioni di LilyPond.}
+@warning{Questo programma non è attualmente supportato e un giorno potrebbe
+essere rimosso dalle future versioni di LilyPond.}
@cindex ABC
@command{abc2ly} accetta le seguenti opzioni:
@table @code
-@item -b,--beams=None
+@item -b, --beams=None
preserva le regole di disposizione delle travature di ABC
-@item -h,--help
+@item -h, --help
mostra questo messaggio di aiuto
-@item -o,--output=@var{file}
+@item -o, --output=@var{file}
imposta il nome del file di output su @var{file}.
-@item -s,--strict
+@item -s, --strict
imposta una modalità di interpretazione letterale per effettuare una conversione stretta
@item --version
mostra informazioni sulla versione.
@end table
Esiste una rudimentale funzione per aggiungere codice LilyPond nel
-file sorgente ABC. Se scrivi:
+file sorgente ABC. Per esempio:
@example
%%LY voices \set autoBeaming = ##f
@subsection Utilizzo di @command{etf2ly}
@translationof Invoking etf2ly
-@warning{Questo programma non è supportato e potrebbe essere rimosso
-dalle future versioni di LilyPond.}
+@warning{Questo programma non è attualmente supportato e un giorno potrebbe
+essere rimosso dalle future versioni di LilyPond.}
+@cindex Enigma Transport Format
@cindex ETF
@cindex enigma
@cindex Finale
Music Technology. @command{etf2ly} converte parte di un file ETF
in un file LilyPond pronto all'uso.
-Si lancia dalla linea di comando nel modo seguente.
+Si lancia dalla linea di comando nel modo seguente:
@example
etf2ly [@var{opzione}]@dots{} @var{file-etf}
@command{etf2ly} accetta le seguenti opzioni:
@table @code
-@item -h,--help
+@item -h, --help
mostra questo messaggio di aiuto
-@item -o,--output=@var{FILE}
+@item -o, --output=@var{FILE}
imposta il nome del file di output su @var{FILE}
@item --version
mostra informazioni sulla versione
dal metodo automatizzato di @command{lilypond-book}.
@menu
-* Tante citazioni da una grande partitura::
-* Inserire l'output di LilyPond in OpenOffice.org::
-* Inserire l'output di LilyPond in altri programmi::
+* LuaTex::
+* OpenOffice e LibreOffice::
+* Altri programmi::
@end menu
-@node Tante citazioni da una grande partitura
-@unnumberedsubsec Tante citazioni da una grande partitura
-@translationof Many quotes from a large score
+@node LuaTex
+@subsection LuaTex
+@translationof LuaTex
+
+@cindex LuaTex
+@cindex lyluatex
-Per inserire molti frammenti di una grande partitura, si può usare anche
-la funzione di ritaglio dei sistemi; si veda @ruser{Extracting fragments of music}.
+Per integrare l'output di Lilypond in un documento, oltre a
+@code{lilypond-book}, esiste un programma alternativo che può
+essere usato con LuaTex:
+@uref{https://github.com/jperon/lyluatex/blob/master/README.en.md,lyluatex}.
-@node Inserire l'output di LilyPond in OpenOffice.org
-@unnumberedsubsec Inserire l'output di LilyPond in OpenOffice.org
-@translationof Inserting LilyPond output into OpenOffice.org
+@node OpenOffice e LibreOffice
+@subsection OpenOffice e LibreOffice
+@translationof OpenOffice and LibreOffice
@cindex OpenOffice.org
+@cindex LibreOffice.org
+@cindex OOoLilyPond
-La notazione di LilyPond può essere aggiunta a OpenOffice.org con
-@uref{http://@/ooolilypond@/.sourceforge@/.net@/,OOoLilyPond}.
+La notazione di LilyPond può essere aggiunta a OpenOffice e LibreOffice
+con @uref{http://@/ooolilypond@/.sourceforge@/.net@/,OOoLilyPond},
+un'estensione di OpenOffice.org che converte i file di LilyPond in immagini
+incluse nei documenti di OpenOffice.org. Sebbene non sia più sviluppato,
+sembra che funzioni ancora nella versione 4.
-@node Inserire l'output di LilyPond in altri programmi
-@unnumberedsubsec Inserire l'output di LilyPond in altri programmi
-@translationof Inserting LilyPond output into other programs
+@node Altri programmi
+@subsection Altri programmi
+@translationof Other programs
-Per inserire l'output di LilyPond in altri programmi, si usa @code{lilypond}
-invece di @code{lilypond-book}. Bisogna creare ogni esempio singolarmente
-e aggiungerlo al documento; consulta la documentazione del realtivo
-programma. La maggior parte dei programmi può inserire l'output di LilyPond
-in formato @file{PNG}, @file{EPS} o @file{PDF}.
+Per inserire l'output di LilyPond in altri programmi, si usa . Bisogna creare ogni esempio singolarmente
+e aggiungerlo al documento; consulta la documentazione del relativo
+programma.
+
+Altri programmi in grado di gestire i formati @file{PNG}, @file{EPS} o
+@file{PDF} dovrebbero usare @code{lilypond} invece di @code{lilypond-book}.
+Ciascun output di LilyPond deve essere creato e inserito separatamente.
+Consultare la documentazione del programma usato per sapere come inserire
+file.
Per ridurre lo spazio bianco intorno alla partitura LilyPond, si usano
-le seguenti opzioni
+le seguenti opzioni:
@example
\paper@{
scoreTitleMarkup = ##f
@}
-@{ c1 @}
+@var{@dots{} music @dots{}}
@end example
-Per creare un file @file{EPS}, si usa
+@noindent
+Per creare immagini @file{EPS}:
@example
-lilypond -dbackend=eps -dno-gs-load-fonts -dinclude-eps-fonts miofile.ly
+lilypond -dbackend=eps -dno-gs-load-fonts -dinclude-eps-fonts myfile.ly
+@end example
+
+@noindent
+Per creare immagini @file{PNG}:
-@file{PNG}:
+@example
lilypond -dbackend=eps -dno-gs-load-fonts -dinclude-eps-fonts --png miofile.ly
@end example
+@noindent
+Per creare immagini @file{PNG} trasparenti:
+
+@smallexample
+lilypond -dbackend=eps -dno-gs-load-fonts -dinclude-eps-fonts \
+ -dpixmap-format=pngalpha --png miofile.ly
+@end smallexample
+
+@cindex frammenti di musica
+@cindex citare frammenti di musica
+@cindex musica, citare frammenti
+
+Per inserire molti frammenti di una grande partitura, si può
+usare anche la funzione di ritaglio dei sistemi; si veda
+@ruser{Extracting fragments of music}.
+
@node Inclusioni indipendenti
@section @code{include} indipendenti
@translationof Independent includes
-Alcuni hanno scritto ampi (e utili!) frammenti di codice che possono
-essere condivisi da progetti diversi. Questo codice potrebbe alla fine
-entrare a far parte di LilyPond, ma finché questo non avviene occorre
-scaricarlo e includerlo manualmente con @code{\include}.
-
+Alcuni utenti hanno creato file che possono essere inclusi in LilyPond
+tramite @code{\include} per produrre certi effetti. Quelli elencati
+in questo capitolo fanno parte di Lilypond. Maggiori informazioni
+in @ruser{Working with input files}.
@menu
* Articolazione MIDI::
@subsection Articolazione MIDI
@translationof MIDI articulation
-LilyPond permette di generare l'output MIDI, che consente di
-@qq{verificare a orecchio} quanto è stato scritto. Tuttavia l'output
-contiene solo la dinamica, i segni di tempo espliciti, le note e le loro
-durate.
-
-Il progetto @emph{articulate} costituisce un tentativo di inviare al file
-MIDI maggiori informazioni sulla partitura. Il suo funzionamento si basa
-sull'abbreviazione delle note prive di legatura di portamento, in
-modo da @q{articolare} le note. Questa riduzione dipende dai segni di
-articolazione attaccati a una nota: staccato dimezza il valore della nota, tenuto
-assegna alla nota la sua intera durata, e così via. Lo script è consapevole anche dei
-trilli e dei gruppetti; può essere esteso per elaborare altri ornamenti come i
-mordenti.
-
-@example
-@uref{http://@/www@/.nicta@/.com@/.au/@/people/@/chubbp/@/articulate}
-@end example
-
-@knownissues
+@cindex MIDI
+@cindex Articulate, progetto
-La sua principale limitazione è che può agire solo sugli elementi che
-conosce: qualsiasi cosa che sia del semplice testo (invece di una proprietà
-della nota) viene dunque ignorato.
+Il progetto @uref{http://www.nicta.com.au/articulate,Articulate} è un
+tentativo di migliorare l'output MIDI di Lilypond. Aggiusta la durata
+delle note (che non si trovano in una legatura di portamento) in base
+ai segni di articolazione attaccati ad esse. Per esempio, @q{staccato}
+dimezza il valore della nota, @q{tenuto} assegna alla nota la sua
+durata completa, e così via.
+Maggiori informazioni in @ruser{Enhancing MIDI output}.