<chapter id="importing-exporting">
<title
>Importare ed esportare i dati</title>

<para
>&appname; è in grado di importare ed esportare vari tipi di file dati e di cercare informazioni in vari siti Internet. </para>

<sect1 id="internet-search">
<title
>Importare dati da Internet</title>
<para
>&appname; è in grado di effettuare ricerche in vari siti Internet utilizzando la finestra Ricerca Internet. Gli elementi posso essere importati direttamente e aggiunti all'attuale collezione. I vari fornitori sono configurati attraverso le<link linkend="data-sources-options"
>Opzioni della fonte dei dati</link
>. </para>

<para
>Le ricerche possono utilizzare diversi criteri: <guilabel
>Titolo</guilabel
>, <guilabel
>Persona</guilabel
>, <guilabel
>ISBN</guilabel
>, <guilabel
>UPC/EAN</guilabel
>, <guilabel
>LCCN</guilabel
>, o <guilabel
>Parole chiave</guilabel
>. Non tutti i criteri sono disponibili per alcune fonti di dati. I valori di <acronym
>ISBN</acronym
> e <acronym
>LCCN</acronym
> sono solo per i libri, mentre i valori <acronym
>UPC</acronym
> o <acronym
>EAN</acronym
> si applicano a ogni tipo di elemento.</para>

<para
>Quando una ricerca viene avviata il pulsante <guibutton
>Cerca</guibutton
> diventa <guibutton
>Ferma</guibutton
> che, se premuto, terminerà la ricerca. Se vengono trovati risultati questi vengono aggiunti alla lista sotto la casella di ricerca, e selezionandone uno verrà visualizzato senza però aggiungerlo alla collezione. Facendo clic sul pulsate <guibutton
>Aggiungi elemento</guibutton
> gli elementi selezionati verranno aggiunti. Se la ricerca ha prodotto più risultati di quelli visibili il pulsante <guibutton
>Ottieni più risultati</guibutton
> diventerà attivo. Facendo clic sul pulsante <guibutton
>Pulisci</guibutton
> tutti i risultati verranno rimossi e la ricerca azzerata. </para>

<screenshot>
<screeninfo
>La finestra <interface
>Ricerca Internet</interface
> di &appname;</screeninfo>
<mediaobject>
<imageobject
><imagedata format="PNG" fileref="fetch-dialog.png"/></imageobject>
<textobject
><phrase
>La <interface
>finestra Ricerca Internet</interface
> di &appname;</phrase
></textobject>
</mediaobject>
</screenshot>

<para
>Solo gli elementi che corrispondono al tipo di collezione in uso verranno trovati. La colonna <guilabel
>Descrizione</guilabel
> fornisce ulteriori informazioni sull'elemento, per differenziarlo da altri elementi simili, come altri video con formati diversi o libri con rilegature diverse. Quando un elemento è aggiunto con successo alla collezione un segno di spunta viene aggiunto alla prima colonna della lista. </para>

<para
>Si possono aggiungere più elementi in una sola volta usando il metodo standard &kde; di selezione multipla che in genere si effettua premendo i tasti &Shift; o &Ctrl; quando si fa clic sugli elementi. </para>

<para
>Per facilitare l'uso degli scanner di codici a barre, le ricerche possono includere più valori ISBN/UPC. Marcando la casella di selezione <guilabel
>Ricerca di ISBN/UPC multipli</guilabel
>, la casella di ricerca sarà disabilitata e il pulsante <guibutton
>Modifica valori ISBN/UPC...</guibutton
>, che apre una casella di testo multi linea, sarà attivo. Ogni valore ISBN dovrebbe essere inserito in una riga separata. Dopo aver chiuso la casella, i valori saranno convalidati per una corretta formattazione. La convalida ISBN è in grado di convertire valori EAN di 13 caratteri, così come interi codici <acronym
>UPC</acronym
> nella giusta formattazione. L'elenco ISBN può essere letto anche da un file di testo. </para>

</sect1>

<sect1 id="importing">
<title
>Importare dati</title>

<para
>&appname; offre tre diverse azioni in fase di importazione dei dati. <guilabel
>Sostituisci la collezione attuale</guilabel
> chiuderà la collezione attuale e ne creerà un'altra con i dati del file importato. <guilabel
>Aggiungi alla collezione attuale</guilabel
> farà sì che &appname; aggiunga tutti gli elementi del file importato alla collezione attuale, aggiungendo tutti i campi non presenti. L'azione <guilabel
>Fondi collezione</guilabel
> è identica all'aggiunta eccetto per il fatto che gli elementi importati saranno confrontati a quelli già presenti e gli elementi identici saranno saltati. &appname; prova a identificare gli elementi corrispondenti che non sono completamente identici confrontando i campi significativi e fonderà quindi gli elementi. Ad esempio, le collezioni musicali confrontano l'artista e l'album, e le tracce verrebbero unite per le voci corrispondenti. Lo <link linkend="importing-audio-files"
>strumento di importazione dei file audio</link
> è in grado di creare correttamente elenchi di tracce unendo gli elementi. </para>

<sect2 id="alternate-software">
<title
>Importare dati da altri programmi</title>

<para
>&appname; può importare i dati direttamente da una varietà di altri programmi di gestione delle collezioni, inclusi <application
><ulink url="https://gitlab.com/GCstar/GCstar"
>GCstar</ulink
></application
>, <application
><ulink url="https://www.datacrow.net/"
>Data Crow</ulink
></application
>, <application
><ulink url="https://github.com/mvz/alexandria-book-collection-manager"
>Alexandria</ulink
></application
>, <application
><ulink url="https://www.delicious-monster.com"
>Delicious Library</ulink
></application
>, <application
><ulink url="https://www.collectorz.com"
>Collectorz</ulink
></application
>, <application
><ulink url="http://www.antp.be/software/moviecatalog/"
>Ant Movie Catalog</ulink
></application
>, <application
><ulink url="https://en.wikipedia.org/wiki/Referencer"
>Referencer</ulink
></application
>, e <application
><ulink url="https://launchpad.net/griffith"
>Griffith</ulink
></application
>.</para>

</sect2>

<sect2 id="import-data-files">
<title
>Importare altri formati di dati</title>
<para
>&appname; può importare i dati da una varietà di altri formati di file, inclusi <acronym
>CSV</acronym
>, bibtex, dischi audio e file, <acronym
>MODS</acronym
>, &PDF;, e <acronym
>RIS</acronym
>.</para>

<sect3 id="importing-tellico">
<title
>Importare dati &appname;</title>

<para
>Altri file dati di &appname; possono essere importati direttamente. Sostituire la collezione attuale importando un file di &appname; è come aprire semplicemente il file stesso. Il senso nell'importare file dati di &appname; è principalmente quello di aggiungere o incorporare collezioni. </para>
</sect3>

<sect3 id="importing-csv">
<title
>Importare dati CSV</title>

<para
>I valori separati da virgole (<acronym
>CSV</acronym
>, "comma-separated values") sono un modo comune di importare ed esportare dati tabulari. Ogni valore di campo è separato da una virgola, con un elemento per ogni riga. Il titolo di campo possono essere inclusi nella prima riga. L'importazione dati CSV non è limitata all'uso della virgola come separatore ma si può usare ogni carattere o stringa. </para>

<screenshot>
<screeninfo
>La finestra di dialogo Importa CSV</screeninfo>
<mediaobject>
<imageobject
><imagedata format="PNG" fileref="csv-dialog.png"/></imageobject>
<textobject
><phrase
>La finestra di dialogo Importa CSV</phrase
></textobject>
</mediaobject>
</screenshot>

<para
>Prima di tutto selezionare il tipo di collezione che si sta importando. Se si sta aggiungendo o incorporando dati alla collezione aperta il tipo sarà limitato a quello della collezione corrente. Se la prima riga del file CSV contiene i titoli dei campi spuntare l'apposita casella. Così facendo i titoli verranno confrontati coi campi della collezione, e se coincidono l'intestazione di colonna cambierà per far vedere che la colonna è stata assegnata ad un campo. Se il file usa un delimitatore diverso dalla virgola assicurarsi di cambiare l'opzione di conseguenza. </para>

<para
>Per fare in modo che &appname; importi il file correttamente, bisogna che conosca quale campo corrisponde a ciascuna colonna. <emphasis
>Se le colonne hanno un numero nell'intestazione, i dati in quella colonna non saranno importati.</emphasis
> È possibile assegnare i campi alle colonne selezionando una colonna, sia facendoci clic che cambiando manualmente il numero di colonna, scegliendo poi il campo da assegnare dal menu a tendina e infine facendo clic sul pulsante <guibutton
>Assegna campo</guibutton
>. Se è necessario aggiungere un nuovo campo alla collezione, l'ultima voce del menu aprirà la <link linkend="fields-dialog"
><interface
>finestra Campi della collezione</interface
></link
>. </para>

<para
>Per compattezza, nella finestra sono visualizzate solo le prime cinque righe del file CSV importato. Tuttavia, saranno importate tutte le righe nel file. </para>

</sect3>

<sect3 id="importing-audio">
<title
>Importare dati da un &CD; audio</title>

<para
>&appname; è in grado di utilizzare il servizio  <ulink url="http://gnudb.org"
>freedb.org</ulink
> per ricercare informazioni su un &CD;, compresa l'elenco delle tracce. A seconda della propria distribuzione le opzioni di accesso al servizio possono essere impostate nelle &systemsettings; di &kde;. I dati di artista, titolo, genere, anno e l'elenco delle tracce saranno aggiunti tutti. </para>

<para
>Inoltre, se il disco contiene informazioni &CD;-Text queste saranno lette e aggiunte all'elemento importato. </para>
</sect3>

<sect3 id="importing-audio-files">
<title
>Importare metadati di file audio.</title>

<para
>&appname; è in grado di analizzare una cartella e leggere i tag per i tipi di file audio più comuni, come <literal role="extension"
>mp3</literal
> e <literal role="extension"
>ogg</literal
>. Le canzoni sono inserite in una collezione di musica, dove ogni elemento è un album. Se il nome della canzone contiene il numero di traccia il nome della stessa viene aggiunto nella giusta posizione nella lista delle tracce. Anche informazioni su artista e genere vengono aggiunte all'elemento. Se i tag della canzone contengono commenti questi vengono aggiunti al campo commenti preceduti dal nome del file. </para>

<para
>Inoltre se una cartella contiene un file <filename
>.directory</filename
> e il nome della cartella coincide col titolo dell'album l'elemento <literal
>Icon</literal
> nel file desktop viene usato come immagine per l'album. </para>

<para
>L'importatore di metadati di file audio può analizzare ricorsivamente una cartella per trovare file audio in qualsiasi sottocartella, anche se i collegamenti simbolici non vengono seguiti. &appname; utilizza la <ulink url="https://taglib.org"
>libreria TagLib</ulink
> per leggere i metadati dei file audio e quindi può importare dati da qualsiasi file supportato da TagLib. </para>

</sect3>

<sect3 id="importing-bibtex">
<title
>Importare dati Bibtex</title>

<para
><ulink url="http://en.wikipedia.org/wiki/Bibtex"
>Bibtex</ulink
> è un formato bibliografico utilizzato con il sistema di preparazione documenti LaTeX. Si possono includere varie referenze bibliografiche nel file. &appname; importa i file bibtex come una <link linkend="bibliography"
>collezione bibliografica</link
>. </para>

<para
>Se l'importatore bibtex incontrerà campi nel file che non sono inclusi nella collezione bibliografica predefinita, questi saranno aggiunti come campi di <link linkend="line"
>Testo semplice</link
>, con due eccezioni: se il valore contiene più di 100 caratteri sarà convertito come un campo<link linkend="para"
>paragrafo</link
>, se invece contiene un &URL; o un riferimento a un file sarà creato un campo <link linkend="url"
>&URL;</link
>. &appname; utilizza una copia interna della <ulink url="http://www.gerg.ca/software/btOOL/"
>libreria btparse</ulink
> per elaborare i file bibtex. </para>

<para
><ulink url="http://bibtexml.sf.net"
>Bibtexml</ulink
> è una rappresentazione &XML; di dati bibtex e i dati importati da questo formato sono trattati come dati bibtex. </para>
</sect3>

<sect3 id="importing-mods">
<title
>Importare dati MODS</title>

<para
><acronym
><ulink url="http://www.loc.gov/standards/mods/"
>MODS</ulink
></acronym
> è un formato utilizzato per rappresentare vari tipi di collezioni di media. Al momento, solo le collezioni di libri possono essere importate da &appname;, come una <link linkend="bibliography"
>collezione bibliografica</link
>. </para>

</sect3>

<sect3 id="importing-pdf">
<title
>Importare dati &PDF;</title>
<para
>Se &appname; è stato compilato con il supporto per <emphasis
>exempi</emphasis
> o <emphasis
>poppler</emphasis
> si possono importare i metadati dei file &PDF;. I metadati possono includere titolo, autore e data, così come identificatori che vengono poi utilizzati per aggiornare altre informazioni. </para>
</sect3>

<sect3 id="importing-ris">
<title
>Importare dati RIS</title>
<para
>Il <ulink url="https://en.wikipedia.org/wiki/RIS_(file_format)"
>formato <acronym
>RIS</acronym
></ulink
> è un formato di file bibliografici utilizzato da <application
>EndNote</application
>, <application
>Reference Manager</application
> e altri. &appname; importa i file RIS come <link linkend="bibliography"
>collezioni bibliografiche</link
>. </para>
</sect3>

</sect2>

<sect2 id="import-online-collection">
<title
>Importare collezioni in linea</title>
<para
>&appname; può collegarsi e importare da siti web che gestiscono collezioni personali.</para>

<sect3 id="importing-boardgamegeek">
<title
>Importa collezione BoardGameGeek</title>
<para
><ulink url="https://boardgamegeek.com"
>BoardGameGeek</ulink
> è una risorsa e una comunità di giochi da tavolo in linea. &appname; può importare i giochi da tavolo nella raccolta di un utente, purché la raccolta sia impostata per essere accessibile pubblicamente. La raccolta importata può essere limitata a quegli articoli marcati come di proprietà. </para>
</sect3>

<sect3 id="importing-goodreads">
<title
>Importare collezione Goodreads</title>
<para
><ulink url="https://www.goodreads.com"
>Goodreads</ulink
> è una rete sociale in linea per i lettori per tenere traccia delle raccolte di libri. &appname; può importare l'elenco dei libri nella raccolta di un utente, specificando il nome utente o l'ID utente, purché la raccolta sia impostata per essere accessibile pubblicamente. </para>
</sect3>

<sect3 id="importing-librarything">
<title
>Importare collezione LibraryThing</title>
<para
><ulink url="https://www.librarything.com"
>LibraryThing</ulink
> è un servizio in linea che aiuta le persone a catalogare facilmente i loro libri. &appname; può importare l'elenco dei libri nella raccolta di un utente, <ulink url="https://www.librarything.com/export.php?export_type=json"
>esportato in formato JSON</ulink
>. </para>
</sect3>

<sect3 id="importing-discogs">
<title
>Importare collezione Discogs</title>
<para
><ulink url="https://www.discogs.com"
>Discogs</ulink
> è una banca dati online e un negozio di musica. &appname; può importare l'elenco delle versioni musicali nella collezione utente, dato il nome utente, a condizione che la raccolta sia impostata come accessibile al pubblico. </para>
</sect3>

</sect2>

<sect2 id="importing-file-listing">
<title
>Importare liste di file</title>

<para
>&tellico; può analizzare le cartelle per importare le informazioni sui file, principalmente per creare una collezione di <link linkend="file-catalog"
>cataloghi di file</link
>. La cartella può essere cercata ricorsivamente, così da aggiungere tutti i file che vi sono contenuti. Questo importatore è utile per creare copie di sicurezza di elenchi e catalogazione di media, come &CD; o <acronym
>DVD</acronym
>. Inoltre, è possibile generare anteprime del contenuto dei file. Le anteprime dei file sono le stesse mostrate nel gestore dei file di &kde;. </para>

<para
>Le cartelle con file di ebook e video possono essere importate anche come collezioni di libri e di video. È possibile leggere i metadati dei file, inoltre, per i video, ogni file <literal role="extension"
>nfo</literal
> esistente viene utilizzato per completare le informazioni sulla voce video. </para>

</sect2>

<sect2 id="importing-xslt">
<title
>Importare dati &XML; tramite XSLT</title>

<para
>Qualsiasi file &XML; può essere importato in &appname; a condizione che un foglio di stile &XSL; sia disponibile per convertire il file nel formato di &appname;. &appname; carica automaticamente il foglio di stile ed esegue la conversione necessaria per caricare il file. </para>
</sect2>

</sect1>

<sect1 id="drag-n-drop">
<title
>Trascinamento</title>

<para
>Trascinare file dati sulla finestra principale di &appname; farà sì che il file venga importato, allo stesso modo che scegliendo il <link linkend="importing"
>comando importa</link
> dal menu. Il trascinamento funziona per i seguenti formati di file: Tellico, Bibtex, RIS &PDF; e EPub. È possibile importare anche più file alla volta.</para>

<para
>Quindi, se ad esempio si vuole creare un catalogo di molti <link linkend="importing-pdf"
>file &PDF;</link
> basterà selezionarli nel gestore dei file e trascinarli nella finestra di &appname;. &appname; importerà il maggior numero di metadati possibile, e poi recupererà informazioni dalle varie fonti di dati Internet impostate.</para>

</sect1>

<sect1 id="exporting">
<title
>Esportare i dati</title>

<para
>Quando si esportano i dati di una collezione i valori degli elementi possono essere formattati così come sono stati immessi o usando la <link linkend="field-formatting"
>formattazione automatica</link
> fornita da &appname;. Inoltre si può decidere di limitare gli elementi esportati a quelli selezionati. Il numero di elementi selezionati viene indicato nella <link linkend="status-bar"
>barra di stato</link
>. </para>

<para
>I file di testo esportati, come Bibtex o CSV, possono essere codificati in Unicode (UTF-8) o usando le impostazioni locali del sistema operativo. </para>

<screenshot>
<screeninfo
>Opzioni generali di esportazione</screeninfo>
<mediaobject>
<imageobject
><imagedata format="PNG" fileref="export-options.png"/></imageobject>
<textobject
><phrase
>Opzioni generali di esportazione</phrase
></textobject>
</mediaobject>
</screenshot>

<sect2 id="exporting-xml">
<title
>Esportare in &XML;</title>

<para
>Il formato dei file di dati di &appname; è un file &XML; compresso. Esportare in &XML; crea semplicemente il file &XML; senza comprimerlo. Le immagini possono essere incluse nel file &XML; come testo codificato in base64 e racchiuso in un elemento immagine, ma così facendo potrebbero essere creati file di dati di grandi dimensioni. </para>
</sect2>

<sect2 id="exporting-zip">
<title
>Esportare in Zip</title>

<para
>Il formato standard di &appname; è un file compresso che contiene il file &XML; e, facoltativamente, tutte le immagini inserite nella collezione. Se le immagini sono invece salvate nella cartella del programma queste saranno salvate in un solo file compresso dopo l'esportazione. </para>
</sect2>

<sect2 id="exporting-html">
<title
>Esportare in &HTML;</title>

<para
>L'esportazione in &HTML; usa il foglio di stile <filename
>tellico2html.xsl</filename
>. Le immagini sono esportate in una cartella con lo stesso nome del file &HTML; con l'aggiunta di <emphasis
><filename
>_files</filename
></emphasis
>. </para>

<para
>Il formato predefinito è simile al risultato stampato, e permette varie opzioni per modificare il codice &HTML;. Si possono visualizzare le intestazioni di campo in cima a ogni colonna, ma, sfortunatamente, &kde; non permette ancora di fare questa operazione per ogni pagina. Gli elementi possono essere anche raggruppati come nella <interface
>vista di gruppo</interface
>. </para>

<para
>Inoltre, si possono creare singoli file per ogni elemento della collezione con collegamenti dal file &HTML; principale. I file degli elementi saranno creati nella stessa cartella delle immagini. I file degli elementi &HTML; utilizzeranno il foglio di stile impostato, lo stesso che si può vedere nella <interface
>vista degli elementi</interface
>. </para>

<screenshot>
<screeninfo
>Opzioni di esportazione &HTML;</screeninfo>
<mediaobject>
<imageobject
><imagedata format="PNG" fileref="export-html.png"/></imageobject>
<textobject
><phrase
>Opzioni di esportazione &HTML;</phrase
></textobject>
</mediaobject>
</screenshot>
</sect2>

<sect2 id="exporting-csv">
<title
>Esportare in CSV</title>

<para
>I valori separati da virgole (CSV
>, «comma-separated values») sono un modo comune di importare ed esportare dati tabulari. Ogni valore di campo è separato da una virgola, con un elemento per ogni riga. Il titolo di campo possono essere inclusi come intestazioni nella prima riga. La delimitazione dei campi non è limitata all'uso della virgola ma si può usare ogni carattere o stringa. </para>

<screenshot>
<screeninfo
>Opzioni di esportazione in CSV</screeninfo>
<mediaobject>
<imageobject
><imagedata format="PNG" fileref="export-csv.png"/></imageobject>
<textobject
><phrase
>Opzioni di esportazione in CSV</phrase
></textobject>
</mediaobject>
</screenshot>
</sect2>

<sect2 id="exporting-alexandria">
<title
>Esportare in Alexandria</title>

<para
><application
><ulink url="https://github.com/mvz/alexandria-book-collection-manager"
>Alexandria</ulink
></application
> è un gestore di collezioni di libri per il desktop <ulink url="http://www.gnome.org"
>GNOME</ulink
>. &appname; è in grado di esportare un limitato sottoinsieme di campi di una collezione di libri nella posizione predefinita dei file di Alexandria. </para>

</sect2>

<sect2 id="exporting-onix">
<title
>Esportare in ONIX</title>

<para
><ulink url="http://www.editeur.org/onix.html"
>ONIX</ulink
> è un formato &XML; per rappresentare e comunicare informazioni sui prodotti dell'industria libraria, usato principalmente da chi vende libri. &appname; può esportare le collezioni di libri utilizzando un piccolo sottogruppo ONIX. </para>

</sect2>

<sect2 id="exporting-bibtex">
<title
>Esportare in Bibtex</title>

<para
>Quando si esporta in <ulink url="http://en.wikipedia.org/wiki/Bibtex"
>Bibtex</ulink
> i valori dei campi possono essere racchiusi da parentesi o interpunzioni. Se nella collezione vengono usate stringhe macro si può scegliere se esportarle come macro o espanderle. Per i campi &URL; i valori possono essere racchiusi in un tag <literal
>\url{...}</literal
>. Infine gli elementi che non hanno chiavi di citazione possono essere saltati o si può far generare automaticamente da &appname; una chiave. </para>

<screenshot>
<screeninfo
>Opzioni di esportazione in Bibtex</screeninfo>
<mediaobject>
<imageobject
><imagedata format="PNG" fileref="export-bibtex.png"/></imageobject>
<textobject
><phrase
>Opzioni di esportazione in Bibtex</phrase
></textobject>
</mediaobject>
</screenshot>
</sect2>

<sect2 id="exporting-gcstar">
<title
>Esportare in GCstar</title>

<para
><application
><ulink url="http://www.gcstar.org"
>GCstar</ulink
></application
> è un altro gestore di collezioni di film. &appname; è in grado di esportare la maggior parte dei tipi di collezione in un file di dati GCstar. </para>

</sect2>

<sect2 id="exporting-xslt">
<title
>Esportare &XML; tramite &xslt;</title>

<para
>Infine, &appname; è in grado di elaborare la rappresentazione interna &XML; dei dati di una collezione attraverso un foglio di stile &XSL; esterno prima dell'esportazione. Questo tipo di esportazione può tornare utile per generare resoconti testuali o altri tipi di file. </para>
</sect2>

</sect1>

<sect1 id="citations">
<title
>Lavorare con le citazioni</title>
<para
>Quando si lavora con una <link linkend="bibliography"
>bibliografia</link
> si possono generare citazioni per gli elementi selezionati da usare con varie altre applicazioni. Una citazione in formato bibtex può essere copiata negli appunti e successivamente incollata in un file latex. Le citazioni bibtex possono essere anche inviate ad un'applicazione esterna come <application
>LyX</application
> o <application
>Kile</application
> usando la cosiddetta <emphasis
><link linkend="hidden-bibtex-options"
>lyxpipe</link
></emphasis
>. </para>

</sect1>

</chapter>
