X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fit%2Fusage%2Fexternal.itely;h=1535ff89334de7bfa5d7ad6f477d422a27d0adf7;hb=58dbefb1d96549bfa612629a67405edef13f2b9b;hp=ddae2b9cdcdcc8b8f21ab8a33673fbb686e345ec;hpb=0f761d8b9f964fc6719fccd0c1be90ef769767f1;p=lilypond.git diff --git a/Documentation/it/usage/external.itely b/Documentation/it/usage/external.itely index ddae2b9cdc..1535ff8933 100644 --- a/Documentation/it/usage/external.itely +++ b/Documentation/it/usage/external.itely @@ -1,14 +1,14 @@ @c -*- coding: utf-8; mode: texinfo; documentlanguage: it -*- @ignore - Translation of GIT committish: 07c022f5e65a806e27c3f5f4f4bdae4020c1af8e + 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.16.0" +@c \version "2.19.21" @node Programmi esterni @chapter Programmi esterni @@ -44,7 +44,7 @@ elementi musicali. @translationof Configuring the system for point and click Quando questa funzionalità è attiva, LilyPond aggiunge dei collegamenti -ipertestuali al file PDF. Questi collegamenti vengono inviati a un +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. @@ -125,14 +125,16 @@ suo pacchetto difettoso. @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:} è -@example +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 example +@end smallexample + +Dopo questi comandi: -Dopo questi comandi, @example gnome-open textedit:///etc/issue:1:0:0 @end example @@ -145,7 +147,8 @@ dovrebbe lanciare @file{lilypond-invoke-editor} per l'apertura del file. 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 +che abbia il nome @file{lilypond-invoke-editor.desktop} e il seguente contenuto: + @example [Desktop Entry] Version=1.0 @@ -165,7 +168,8 @@ xdg-desktop-menu install ./lilypond-invoke-editor.desktop xdg-mime default lilypond-invoke-editor.desktop x-scheme-handler/textedit @end example -Dopo questi comandi, +Dopo questi comandi: + @example gnome-open textedit:///etc/issue:1:0:0 @end example @@ -212,11 +216,11 @@ con altri visualizzatori. @cindex file di output, dimensione La funzionalità "punta e clicca" è abilitata di default quando si creano -i file PDF. +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 @@ -237,7 +241,7 @@ lilypond -dno-point-and-click file.ly @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.} @@ -260,8 +264,8 @@ Codice interno al file @file{.ly}: @example \pointAndClickTypes #'note-event -\relative c' @{ - c2\f( f) +\relative @{ + c'2\f( f) @} @end example @@ -269,8 +273,8 @@ oppure @example #(ly:set-option 'point-and-click 'note-event) -\relative c' @{ - c2\f( f) +\relative @{ + c'2\f( f) @} @end example @@ -291,8 +295,8 @@ Codice interno al file @file{.ly}: @example \pointAndClickTypes #'(note-event dynamic-event) -\relative c' @{ - c2\f( f) +\relative @{ + c'2\f( f) @} @end example @@ -300,8 +304,8 @@ oppure @example #(ly:set-option 'point-and-click '(note-event dynamic-event)) -\relative c' @{ - c2\f( f) +\relative @{ + c'2\f( f) @} @end example @@ -526,10 +530,9 @@ che viene usato per rappresentare la notazione musicale. @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 @@ -595,8 +598,8 @@ il file di input è un file MusicXML compresso in un archivio ZIP. @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 @@ -629,7 +632,7 @@ 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 @@ -665,9 +668,10 @@ lo fa. @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 @@ -677,7 +681,7 @@ ETF (Enigma Transport Format) è un formato usato da Finale, un prodotto di Coda 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} @@ -713,7 +717,7 @@ confondono @command{etf2ly}. Le sequenze di abbellimenti non sono risolte corre LilyPond non supporta la conversione da altri formati, ma esistono alcuni strumenti esterni che possono generare file LilyPond. L'elenco si trova -in @rweb{Easier editing}. +in @rweb{Editing facilitato}. @@ -725,41 +729,55 @@ Questa sezione presenta dei metodi per integrare testo e musica diversi dal metodo automatizzato di @command{lilypond-book}. @menu -* Tante citazioni da una grande partitura:: -* Inserire l'output di LilyPond in OpenOffice e LibreOffice:: -* 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 e LibreOffice -@unnumberedsubsec Inserire l'output di LilyPond in OpenOffice e LibreOffice -@translationof Inserting LilyPond output into OpenOffice and LibreOffice +@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 e LibreOffice 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 +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. La maggior parte dei programmi può inserire l'output di LilyPond -in formato @file{PNG}, @file{EPS} o @file{PDF}. +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@{ @@ -771,36 +789,48 @@ le seguenti opzioni scoreTitleMarkup = ##f @} -@{ c1 @} +@var{@dots{} music @dots{}} @end example -Per creare file immagine utili, si usa +@noindent +Per creare immagini @file{EPS}: @example -EPS - lilypond -dbackend=eps -dno-gs-load-fonts -dinclude-eps-fonts myfile.ly +@end example -PNG +@noindent +Per creare immagini @file{PNG}: +@example lilypond -dbackend=eps -dno-gs-load-fonts -dinclude-eps-fonts --png miofile.ly +@end example -Un file PNG trasparente +@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 example +@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{Estrarre frammenti musicali}. @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{Lavorare coi file di input}. @menu * Articolazione MIDI:: @@ -811,28 +841,15 @@ scaricarlo e includerlo manualmente con @code{\include}. @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{Miglioramento dell'output MIDI}.