# Importer et exporter des données

&appname; peut importer et exporter une grande variété de données, ainsi que rechercher des informations sur divers sites web.

## Importer depuis Internet

&appname; peut rechercher dans divers sites web en utilisant la boîte de dialogue Recherche Internet. Les entrées peuvent être directement importées et ajoutées à votre collection courante. Les divers fournisseurs sont configurés à partir des Options des sources données.

Les recherches peuvent utiliser différents critères : Titre, Personne, ISBN, UPC/EAN, LCCN ou Mot-clé. Ces critères sont disponibles en fonction du types de données ; les valeurs ISBN et LCCN > ne concernent que les livres, tandis que les valeurs UPC ou EAN peuvent s'appliquer à tout type d'élément.

Une fois la recherche lancée, le bouton Chercher deviendra Arrêter pour mettre un terme à la recherche. Les résultats trouvés sont ajoutés à la liste directement sous la boîte de recherche, où sélectionner un élément affichera le résultat sans l'ajouter à la collection. Cliquer sur le bouton Ajouter l'entrée ajoutera tous les éléments sélectionnés à votre collection. Si la source de données a plus de résultats qu'il était initialement demandé, le bouton Obtenir plus de résultats devient actif. Cliquer sur Effacer supprimera tous les résultats courants et réinitialisera la recherche.

La boîte de dialogue Recherche Internet de &appname;
La boîte de dialogue Recherche Internet de &appname;

Seules les entrées correspondantes au type de collection courant seront trouvées. La colonne Description fournit des informations additionnelles sur l'entrée, afin de différencier les formats vidéo et audio, ou les différentes reliures de livres par exemple. Une fois qu'une entrée est ajoutée avec succès à la collection, une coche apparaîtra dans la première colonne de la liste.

Plusieurs entrées peuvent être ajoutées à la fois en utilisant la méthode standard de &kde; pour la sélection multiple, qui habituellement nécessite de maintenir la touche &Maj; ou &Ctrl; appuyée quand vous cliquez sur un élément.

Pour faciliter l'utilisation des numériseurs de codes barres, les recherches peuvent inclure plusieurs valeurs ISBN/UPC. Sélectionner la case à cocher Recherche ISBN/UPC multiple désactivera la zone de recherche et activera le bouton Éditer les valeurs ISBN/UPC, qui ouvrira une boîte de saisie comprenant plusieurs lignes. Chaque ISBN doit être écrit sur une ligne. Après avoir fermé la boîte de texte, chaque ISBN sera validé pour le bon formatage. La validation ISBN peut convertir treize valeurs chiffres EAN, ainsi que des codes complets UPC, au formatage correct. La liste ISBN peut aussi être lue depuis un fichier texte.

## Importer des données

&appname; offre trois actions différentes à l'importation des données. Remplacer la collection actuelle fermera la collection courante, et en créera une nouvelle avec les données du fichier importé. Ajouter à la collection actuelle dit à &appname; d'ajouter toutes les entrées importées à la collection courante, en sus des champs inexistants. L'action Fusionner les collections est similaire à la précédente, sauf que chaque entrée importée est comparée à l'entrée actuelle et les entrées identiques sont ignorées. À l'avenir, il est prévu une amélioration heuristique de l'identification des entrées mais actuellement, sauf pour les collections musicales, elles doivent être identiques sur tous les champs. Les collections musicales comparent seulement l'artiste et l'album, les pistes sont alors fusionnées entre entrées correspondantes. L'outil Importer des données d'un fichier audio peut construire correctement des listes de pistes en fusionnant les entrées.

### Importer des données &appname;

D'autres fichiers de données &appname; peuvent être importés. Remplacer la collection courante en important un fichier &appname; revient à ouvrir le fichier lui-même. L'intérêt d'importer des données &appname; est d'ajouter ou fusionner deux collections ensembles.

### Importer des données CVS

Les valeurs séparées par des virgules (Comma-separated values ou CSV) permettent d'importer et d'exporter facilement des données tabulaires. Chaque valeur de champ est séparée par une virgule, avec une entrée par ligne. Les titres des champs peuvent être inclus dans la première ligne. L'outil d'importation CSV n'est pas limité à l'utilisation de virgules comme séparateur ; n'importe quel caractère ou chaîne est utilisable.

La boîte de dialogue d'importation CSV
La boîte de dialogue d'importation CSV

D'abord, sélectionnez le type de collection à importer. Si vous ajoutez ou fusionnez vers la collection courante, le type sera limité à celui de cette dernière. Si la première ligne du fichier CSV contient les titres des champs, cochez la case correspondante et l'outil d'importation comparera automatiquement les titres aux champs de la collection courante. Si un titre de champ correspond, l'en-tête pour cette colonne se modifiera pour indiquer que la colonne a été assignée à ce champ. Si le fichier emploi un séparateur différent de la virgule, pensez à modifier l'option en conséquence.

Afin que &appname; importe convenablement le fichier, l'application doit savoir quel champ correspond à chaque colonne. Si l'en-tête de la colonne se limite à un numéro, les données de cette colonne ne seront pas importées. Vous devriez assigner un champ à chaque colonne en la sélectionnant, en cliquant dessus ou en modifiant le numéro de colonne lui-même, puis en choisissant le champ à assigner à partir du menu déroulant et, enfin, en cliquant sur le bouton Assigner le champ. Si vous avez besoin d'ajouter un nouveau champ à la collection, la dernière entrée du menu déroulant ouvrira la Boîte de dialogue des Champs de la collection.

Seules les cinq premières lignes du fichier CSV importé sont affichées dans la boîte de dialogue.

### Importer des données d'un &CD; audio

&appname; est capable d'exploiter le service freedb.org pour rechercher des informations à propos d'un &CD;, telles que la liste des pistes. En fonction de votre distribution, les paramètres pour accéder à ce service peuvent être définis dans la &configurationDuSysteme; de &kde;. L'artiste, le titre, le genre, l'année et la liste des pistes du &CD; sont tous ajoutés.

De plus, si le disque contient du texte, cette information sera lue et ajoutée à l'entrée importée.

### Importer les méta-données d'un fichier audio

&appname; peut parcourir un dossier et lire les étiquettes des formats de fichiers audio communs, tels que `mp3` et `ogg`. Les morceaux sont saisis dans une collection de musique, où chaque entrée correspond à un album. Si les fichiers audio contiennent le numéro de piste, le nom du morceau est inséré dans l'emplacement adéquat dans la liste de pistes. Les informations concernant l'artiste et le genre sont aussi ajoutées à l'entrée. Si les étiquettes du morceau contiennent des commentaires, ils seront ajoutées au champ « Commentaires » de l'entrée, précédées du nom de fichier.

De plus, si un dossier contient un fichier `.directory` et que le nom du dossier correspond à un titre d'album, l'entrée `Icône` du fichier « desktop » est utilisé comme image de couverture pour l'album.

L'outil d'importation des méta-données d'un fichier audio peut analyser récursivement un dossier pour trouver tous les fichiers audio dans les sous-dossiers, bien que les liens symboliques ne seront pas résolus. &appname; utilise la bibliothèque TagLib pour lire les méta-données des fichiers audio et peut donc importer des données depuis n'importe quels types de fichiers gérés par TagLib.

### Importer des bibliothèques Alexandria

Alexandria est un gestionnaire alternatif de collections de livres pour l'environnement de bureau GNOME. L'outil d'importation permet d'importer n'importe quelles bibliothèques trouvées dans `$`HOME`/.alexandria/`.

### Importer des données d'un catalogue de films Ant

Le catalogue de films Ant est un gestionnaire alternatif de collections de films.

### Importer des données BibTeX

BibTeX est un format bibliographique utilisé avec le système de préparation de document LaTeX. Divers types de références bibliographiques peuvent être intégrées au fichier. &appname; importe des fichiers BibTeX comme collection bibliographique.

Si l'importation BibTeX rencontre dans le fichier des champs absents de la collection bibliographique par défaut, ils seront ajoutés comme champs Texte simple, avec deux exceptions. Si le contenu du champ dépasse les cent caractères, il devient un champ Paragraphe. S'il contient une &URL; ou fait référence à un fichier, alors un champ &URL; sera créé. &appname; utilise une copie interne de la bibliothèque btparse pour analyser les fichiers BibTeX.

### Importer des données BibTeXML

BibTeXML est une représentation &XML; des données BibTeX, et sont traitées à l'import de la même manière que les données BibTeX.

### Importer des données de la bibliothèque Delicious

Delicious Library est un gestionnaire alternatif de collections pour le bureau &Mac; OS X. &appname; importe un sous-ensemble des données utilisées par la bibliothèque.

### Importer des données GCstar

GCstar est un gestionnaire de collection alternatif. Sont gérées à l'importation, les collections de livres, de films, de musiques, de pièces, de jeux vidéos, de jeux de plateau et de vins.

&appname; peut aussi importer des fichiers de données GCfilms. GCfilms, un gestionnaire alternatif de collections de films, précéda GCstar. Normalement, les fichiers GCfilms se situe dans `$`HOME`/.local/share/gcfilms/`.

### Importer des données Griffith

Griffith est un gestionnaire alternatif de collections vidéo. &appname; peut importer la plupart des données provenant de Griffith.

### Importer des données MODS

MODS est un format représentant divers types de collections de média. Actuellement, seuls les livres sont importés par &appname; comme collection bibliographique.

### Importer des données PDF

Si &appname;, est compilé avec la prise en charge d'exempi ou de poppler, les méta-données des fichiers PDF peuvent être importées. Elles comprennent le titre, l'auteur et la date mais aussi les identifiants bibliographiques utiles pour mettre à jour les autres informations.

### Importer des données Referencer

Referencer est un gestionnaire bibliographique et d'organisation de documents pour le bureau GNOME. &appname; importera la plupart des données trouvées dans la base de données Referencer.

### Importer des données RIS

RIS est un format de fichiers bibliographiques utilisé, entre autres, par Reference Manager. &appname; importe des fichiers RIS comme collection bibliographique.

### Importer une collection Goodreads

Goodreads est un réseau social en ligne permettant aux lecteurs de suivre des collections de livres. &appname; peut importer la liste des livres de la collection d'un utilisateur, d'après son nom ou son identifiant, du moment que la collection est publique.

### Importer des listes de fichiers

La meilleure façon de créer un catalogue de fichiers consiste à importer le contenu d'un dossier. Celui-ci peut être analysé récursivement pour ajouter tous les fichiers contenus. Cet outil d'importation est très utile pour lister les sauvegardes et cataloguer des média, en listant &CD; ou DVD. De plus, des aperçus en images du contenu des fichiers peuvent être générés, bien que cela prenne du temps en présence d'un grand nombre de fichiers. Les aperçus des fichiers sont identiques à ceux affichés dans le gestionnaire de fichiers de &kde;.

### Importer des données &XML; à partir de XSLT

Les fichiers &XML; peuvent être importés dans &appname; du moment qu'une feuille de style &XSL; est fournie pour convertir le fichier au format &appname;. &appname; charge automatiquement la feuille de style et effectue les actions &xslt; requises pour ouvrir le fichier.

## Glisser et déposer

Glisser et déposer des fichiers de données dans la fenêtre principale de &appname; les importera, tout comme l'appel à une commande d'importation depuis le menu. Le glisser-déposer fonctionne pour les formats de fichiers suivants : Tellico, BibTeX, RIS, et PDF. Importer plusieurs fichiers à la fois est également possible.

Par exemple, si vous voulez cataloguer plusieurs fichiers PDF, sélectionnez-les dans le gestionnaire de fichiers et glissez-les vers la fenêtre de &appname;. &appname; en importera les méta-données qu'il gère et obtiendra ensuite les informations additionnelles des diverses sources Internet configurées.

## Exporter des données

Quand vous exportez des données de la collection, les valeurs des entrées peuvent être exportées comme saisies ou avec la mise en forme automatique fournie par &appname;. De plus, l'exportation peut être limitée aux entrées sélectionnées de la collection, la barre d'état affichant le nombre d'entrées choisies.

Les fichiers texte exportés, tels que BibTeX ou CSV, peuvent utiliser l'encodage de caractères Unicode (UTF-8) ou la locale actuelle du système d'exploitation.

Options générales de l'exportation
Options générales de l'exportation

### Exporter en &XML;

Le format de fichier pour les données de &appname; est le &XML; zippé. Exporter en &XML;, créer simplement un fichier &XML; sans le compresser. Les images peuvent être intégrées au fichier &XML; sous forme de données encodées en base64, bien que cela puisse créer de très gros fichiers texte.

### Exporter en Zip

Le format de fichier standard pour &appname; est le fichier Zip, contenant la collection en &XML; et, en option, toutes les images référencées dans la collection. Si les images sont stockées dans le dossier d'application, exporter en fichier Zip créera un fichier de données inclusif contenant toutes les images de la collection.

### Exporter en &HTML;

L'export &HTML; utilise la feuille de style `tellico2html.xsl`. Les images sont exportées dans un dossier ayant le même nom que le fichier &HTML; enregistré, la mention `_files` en plus.

Le format par défaut est similaire à l'impression et autorise diverses options modifiant le fichier &HTML;. Les en-têtes des champs peuvent être imprimées en haut de chaque colonne mais, malheureusement, &kde; ne permet pas encore de répéter les en-têtes des tableaux sur chaque page. Les entrées peuvent aussi être groupées dans la Vue par groupes.

De plus, des fichiers individuels peuvent être créés pour chaque entrée de la collection, liés dans un fichier &HTML; abrégé. Les fichiers d'entrées seront créés dans le même dossier que les images. Les fichiers &HTML; d'entrées utiliseront comme modèle la feuille de style définie, telle qu'affichée dans la Vue des entrées.

Options d'exportation &HTML;
Options d'exportation &HTML;

### Exporter en CSV

Les valeurs séparées par des virgules (Comma-separated values ou CSV) permettent d'importer et d'exporter facilement des données tabulaires. Chaque valeur de champ est séparée par une virgule, avec une entrée par ligne. Les titres des champs peuvent être inclus dans la première ligne. N'importe quel caractère ou chaîne est utilisable pour séparer les champs.

Options d'exportation CSV
Options d'exportation CSV

### Exporter en Pilot-DB

Pilot-DB est un format de base de données pour &PalmOS;. Diverses applications de bureau peuvent lire et écrire des fichiers Pilot-DB. Les fichiers `.pdb` exportés sont transférables vers un PDA et directement utilisables. Pour le moment, &appname; ne peut pas importer les fichiers Pilot-DB.

Options d'exportation Pilot-DB
Options d'exportation Pilot-DB

### Exporter vers Alexandria

Alexandria est un gestionnaire de collections de livres pour l'environnement de bureau GNOME. &appname; peut exporter un sous-ensemble des champs d'une collection de livres vers l'emplacement de données par défaut d'Alexandria.

### Exporter en ONIX

ONIX est un format &XML; dédié à la présentation et la communication d'informations sur les produits de l'industrie du livre, principalement destiné aux libraires. &appname; peut exporter des collections de livres en utilisant un sous-ensemble réduit d'ONIX.

### Exporter en BibTeX

À l'exportation en BibTeX, les valeurs des champs peuvent être échappées à l'aide de crochets ou de guillemets. Si des macros d'entrées sont utilisées dans la collection, elles peuvent être exportées comme macros ou bien étendues. Pour les champs &URL;, &appname; peut entourer leurs valeurs avec la balise `\url{...}`. Enfin, les entrées qui n'ont pas de clé de citation peuvent être ignorées au lieu de générer automatiquement la clé.

Options d'exportation BibTeX
Options d'exportation BibTeX

### Exporter en BibTeXML

BibTeXML est un format pour représenter des données BibTeX à partir du &XML;.

### Exporter vers GCstar

GCstar est un autre gestionnaire de collections de films. &appname; peut exporter la plupart des types de collection vers un fichier de données GCstar.

### Exporter en &XML; à partir de &xslt;

Enfin, &appname; peut traiter sa représentation &XML; interne des données de la collection à travers une feuille de style externe &XSL;, avant l'exportation. Ce type d'exportation est utile pour générer des rapports textuel ou d'autres types de fichiers.

## Travailler avec les citations

Quand vous travaillez avec une bibliographie, les citations des entrées sélectionnées peuvent être générées et utilisées par diverses applications. Une citation au format BibTeX peut être copiée vers le presse-papiers, puis être collée dans un fichier LaTeX. Les citations BibTeX peuvent aussi être envoyées vers une application tel que LyX ou Kile à l'aide de lyxpipe.