# Importer et exporter des données

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

## Importer depuis Internet

&appname; peut chercher sur divers sites Internet en utilisant la &fetch-dialog;. Les entrées peuvent être directement importées et ajoutées à votre collection. Les différents fournisseurs peuvent être configurés via les Options de sources de données.

Les recherches peuvent utiliser cinq critères différents : Titre, Personne, ISBN, UPC/EAN ou mot)clef. Tous les critères ne sont pas disponibles pour certaines sources. Une fois la recherche débutée, le bouton Chercher se transforme en bouton Stop qui permet d'arrêter la recherche. Au fur et à mesure que les résultats sont obtenus, ils sont automatiquement ajoutés à la liste sous la boite de recherche. Cliquer sur une entrée affiche le résultat sans l'ajouter à la collection. Cliquer sur le bouton Ajouter l'entrée ajoute toutes les entrées sélectionnées à votre collection. Cliquer sur le bouton Effacer efface tous les résultats et initialise la recherche.

La &fetch-dialog; &appname;
La &fetch-dialog; &appname;

La &fetch-dialog; &appname;

Seules les entrées ayant le même type de collection peuvent être trouvées. La colonne Description fournit des informations supplémentaires à propos de l'entrée, afin de différencier les vidéos de différents formats ou les livres ayant des reliures différentes. Une fois qu'une entrée a été ajoutée à la collection, une icône est ajoutée dans la première colonne de la liste.

Afin de faciliter l'utilisation de lecteurs de code barre, les recherches peuvent porter sur plusieurs valeurs ISBN à la fois. Cocher la case Recherche ISBN multiple désactive la boite de recherche et active le bouton Liste ISBN..., qui ouvre une boite de dialogue permettant d'entrer plusieurs lignes. Chaque numéro ISBN doit être sur une ligne différente. Après avoir fermé la boite de dialogue, la mise en forme de chaque numéro ISBN est vérifiée. Le procédé de validation ISBN permet de convertir les valeurs EAN à 13 chiffres, ainsi que les codes UPC au format ISBN classique. La liste de numéros ISBN peut également être lue à partir d'un fichier texte.

## Importer des données

&appname; propose trois différentes actions lors de l'import de données. Remplacer la collection indique que la collection ouverte doit être fermée, et une nouvelle créée à partir des données importées. Ajouter à la collection indique à &appname; d'ajouter toutes les entrées de la collection importée à celle ouverte, et d'ajouter les champs manquant. Fusionner avec la collection ouverte a le même effet qu'ajouter ; mais chaque entrée importée est comparée avec celles existant déjà, et celles en double sont ignorées. Il est prévu dans le futur d'améliorer l'algorithme pour identifier les entrées en double ; mais pour le moment, en dehors des collections musicales, tous les champs doivent être identiques. Pour les collections musicales, &appname; compare seulement l'artiste et l'album, et les plages sont fusionnées pour les entrées correspondantes. L'import de fichiers audio peut générer des listes de titres en fusionnant les entrées.

### Importer des données &appname;

D'autres fichiers de données &appname; peuvent être importés. Remplacer la collection actuelle en important un fichier &appname; donne le même résultat qu'une simple ouverture du fichier. L'intérêt d'importer des données &appname; est principalement pour les ajouter ou les fusionner deux collections ensemble.

### Importer des données CSV

Les valeurs séparées par des virgules (CSV) sont un moyen courant d'importer et d'exporter des données tabulaires. Les différentes valeurs de champs sont séparées par des virgules, chaque entrée occupant une ligne. Les titres des champs peuvent être inclus comme en-tête en première ligne. N'importe quel caractère ou chaîne de caractère autre que la virgule peut également être utilisé pour délimiter les champs.

La boite de dialogue d'import CVS
La boite de dialogue d'import CVS

La boite de dialogue d'import CVS

Commencer par sélectionner le type de collection que vous souhaitez importer. Si vous ajoutez ou fusionnez avec la collection ouverte, le type est limité à celui la collection courante. Si la première ligne du fichier CSV contient les titres des champs, cochez la case correspondante et l'outil d'import comparera automatiquement les titres avec ceux des champs de la collection ouverte. Si les titres concordent, l'en-tête de cette colonne change pour indiquer que cette colonne a été assignée à un champ. Si le fichier utilise un autre séparateur que la virgule, assurez-vous de changer l'option en conséquence.

Pour que &appname; puisse importer correctement le fichier, il doit connaître la correspondance entre les champs et les numéros de colonne. Si la colonne a seulement un nombre dans son en-tête, les données de cette colonne ne seront pas importées. Vous devez assigner un champ à chaque colonne en sélectionnant une colonne, soit en cliquant dessus, soit en changeant le numéro de colonne manuellement, puis en sélectionnant le champ à y associer depuis la liste déroulante et en cliquant sur le bouton Assigner le champ. Si vous souhaitez ajouter un nouveau champ à la collection, la dernière entrée du menu déroulant ouvre la &fields-dialog;.

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

### Importer les données d'un CD audio

&appname;peut utiliser le service freedb.org pour trouver des informations à propos d'un CD, y compris la liste des titres. En fonction de la distribution que vous utilisez, les paramètres d'accès à ce service peuvent être configurés dans le centre de contrôle &kde;. L'artiste et le titre du CD, le genre, l'année et la liste des titres sont tous ajoutés.

De plus, si le disque est de type CD-Text, les informations contenues sont lues et ajoutées à l'entrée importée.

### Importer les données d'un fichier audio

&appname; peut parcourir un répertoire et lire les tags de formats de fichiers audio communs, tels que `mp3` ou `ogg`. Les titres sont ajoutés à une collection musicale, dans laquelle chaque entrée représente un album. Si le fichier musical contient un numéro de piste, le titre est ajouté a la position correcte dans la liste de l'album. L'artiste et le genre de musique sont également ajoutés à l'entrée. Si les données contiennent des commentaires, ceux-ci sont ajoutés au champ commentaires de l'entrée, précédés du nom de fichier.

De plus, si un répertoire contient un ficher `.directory` et que le nom du répertoire concorde avec le titre d'un album, l'entrée `Icon` du fichier desktop est utilisée en tant que couverture de l'album.

L'import de méta-données de fichiers audio peut être fait en parcourant un répertoire de façon récursive pour trouver tous les fichiers audio contenus dans ce répertoire. Cependant, les liens symboliques ne sont pas suivis. &appname; utilise la bibliothèque TagLib pour lire les données des fichiers audio, et peut donc importer les données de tous les formats reconnus par TagLib.

### Importer des bibliothèques Alexandria

Alexandria est un gestionnaire de collection de livres pour le bureau Gnome. L'importeur offre la possibilité d'importer les bibliothèques trouvées dans `$`HOME`/.alexandria/`.

### Importer des données BibTeX

BibTeX est un format de bibliographie utilisé avec le système de préparation de documents LaTeX. Différents types de références bibliographiques peuvent être incluses dans le fichier. &appname; importe les fichiers BibTeX sous forme de collection bibliographique.

Si l'outil d'import BibTeX rencontre des champs dans le fichier qui ne sont pas dans la collection bibliographique par défaut, ils sont ajoutés en tant que champs de type Texte Simple; avec deux exceptions. Si la valeur du champ contient plus de 100 caractères, il est transformé en champs de type Paragraphe. Si la valeur du champs contient un &URL; ou une référence à un fichier, un champs de type URL est créé. &appname; utilise une copie interne de la bibliothèque btparse pour traiter les fichier BibTeX.

### Importer des données BibTeXML

BibTeXML est une représentation &xml; de données BibTeX. Les données importées d'un fichier BibTeXML sont traitées de la même manière que les données BibTeX.

### Importer des données MODS

MODS est un format pour représenter divers types de collections. Pour le moment, seuls les livres peuvent être importés dans &appname;.

### Importer des données RIS

Le format RIS est un format de fichier bibliographique utilisé entre autres par Référence Manager. &appname; les fichiers RIS en tant que collection bibliographique.

### Importer des données GCfilms

GCfilms est un gestionnaire de collection de films. Normalement, les fichiers de données GCfilms se trouvent dans le répertoire `$`HOME`/.local/share/gcfilms/`.

### Importer une liste de fichiers

Le meilleur moyen de créer un catalogue de fichiers est d'importer le contenu d'un répertoire. La recherche dans le répertoire peut être récursive, pour ajouter tous les fichiers trouvés. L'outil d'import est particulièrement utile pour les listes de sauvegardes et les catalogues de fichiers, tels que les CD or DVD. De plus, des prévisualisations en image des fichiers peuvent être créées. Cependant, ceci peut prendre du temps s'il est nécessaire de lire un nombre important de fichiers. Les prévisualisations sont du même type que celles affichées dans le gestionnaire de fichiers &kde;.

### Importer des données &xml; via XSLT

N'importe quel fichier peut être importé dans &appname;, pourvu qu'il existe une feuille de style XSL disponible pour convertir le fichier au format &appname;. &appname; charge automatiquement la feuille de style et effectue le traitement XSLT nécessaire pour charger le fichier &xml;.

## Exporter des données

Lors de l'export de données de la collection, les valeurs des entrées peuvent être exportées telles qu'elles ont été créées, ou avec la mise en forme automatique fournie par &appname;. De plus, l'export peut être limité aux entrées sélectionnées, la barre d'état indiquant le nombre d'entrées sélectionnées.

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

Options d'export générales
Options d'export générales

### Exporter en &xml;

Le format de fichier pour &appname; est un fichier &xml; compressé au format zip. Exporter en &xml; crée le fichier &xml; sans le compresser. Les images peuvent être intégrées dans le fichier &xml; sous forme de donnée encodée au format base64 dans un élément image.

### Exporter au format Zip

Le format de fichier standard pour &appname; est un fichier zip, contenant le fichier de collection &xml;, et, si souhaité, toutes les images référencées dans la collection. Si les images sont conservées dans le répertoire de l'application, exporter au format Zip créera un fichier de données 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 répertoire portant le même nom que le fichier HTML avec le suffixe `_files`.

Le format par défaut est similaire à celui pour l'impression et permet de modifier le code HTML de plusieurs manières. Les en-tête des champs peuvent être imprimés en haut de chaque colonne ; malheureusement &kde; ne permet pas encore de répéter les en-tête des tableaux sur chaque page. Les entrées peuvent être regroupées de la même manière que dans la &group-view;.

De plus, des fichiers individuels peuvent être créés pour chaque entrée de la collection, avec les liens générés dans le fichier HTML racine. Les fichiers d'entrées sont créés dans le même répertoire que les images. Les fichiers d'entrées HTML utilisent la feuille de style courante, comme dans la &entry-view;.

Options d'export HTML
Options d'export HTML

### Exporter en CSV

Les valeurs séparées par des virgules (CSV) sont un moyen courant d'importer et d'exporter des données tabulaires. Les différentes valeurs de champs sont séparées par des virgules, chaque entrée occupant une ligne. Les titres des champs peuvent être inclus comme en-tête en première ligne. N'importe quel caractère ou chaîne de caractère autre que la virgule peut également être utilisé pour délimiter les champs.

Options d'export CSV
Options d'export CSV

### Exporter en Pilot-DB

Pilot-DB est un format de base de données pour Palm OS. Diverses applications de bureau peuvent lire et écrire les fichiers Pilot-DB. Les fichiers `.pdb` exportés peuvent être transférés vers un PDA et utilisés directement. Pour le moment, &appname; ne peut pas importer de fichier Pilot-DB.

Options d'export Pilot-DB Export
Options d'export Pilot-DB Export

### Exporting Alexandria

Alexandria est un outil de gestion de bibliothèques pour l'environnement de bureau GNOME. &appname; peut importer une partie limitée des champs des collections de livres vers le point d'enregistrement par défaut des données Alexandria.

### Exporting ONIX

ONIX est un format XML pour la représentation et transmettre les informations des livres dans un cadre industriel, essentiellement pour les vendeurs. &appname; peut exporter des collections de livres en utilisant un sous-ensemble d'ONIX.

### Exporter en BibTeX

Lors de l'export en format BibTeX, les valeurs de champs peuvent être échappées avec des parenthèses ou des guillemets. Si des macros sont utilisées dans la collection, elles peuvent être exportées en tant que macros ou appliquées. Pour les champs de type &URL;, &appname; peut peut inclure les valeurs du champs dans un tag `\url{...}`. Enfin, les entrées de contenant pas de clef de citation peuvent être ignorées au lieu de voir des clefs automatiquement générées par &appname;.

Options d'export BibTeX
Options d'export BibTeX

### Exporter en BibTeXML

Bibtexml est un format permettant de conserver des données BibTeX au format XML.

### Exporting GCfilms

GCfilms est un autre outil de gestion de collection de fil,s. &appname; peut exporter un nombre limité de champs d'une collection de vidéos vers un fichier GCfilms.

### Exporter en &xml; via &xslt;

Enfin, &appname; est capable de traiter sa représentation &xml; interne des données de la collection avec une feuille de style XSL externe avant d'exporter. Ce type d'opération peut être utile pour générer des rapports en texte ou d'autres types de fichiers.

## Travailler avec des citations

Lorsque vous travaillez avec une bibliographie, les citations de l'entrée sélectionnée peuvent être générées et utilisées par d'autres applications. Une citation dans le format BibTeX peut être copiée vers le presse-papier, puis collée dans un fichier LaTeX. Les citations BibTeX peuvent également être transmises à une application externe telle que LyX ou Kile grâce à ce que l'on appelle des lyxpipe. Enfin une gestion limitée de l'export vers OpenOffice.org Writer est disponible.

### Travailler avec OpenOffice.org

&appname; dispose d'une gestion limitée de l'envoi de citation vers OpenOffice.org Writer et de la mise à jour de la bibliographie d'un document. Un greffon spécifique est utilisé, et si ce dernier est disponible, le menu permettant de citer une entrée dans Writer est disponible. S'il ne l'est pas, c'est que &appname; n'a pas pu trouver ou charger le greffon. Plus d'informations concernant la compilation de &appname; avec la gestion de OpenOffice.org activée sont disponibles dans une section ultérieure..

OpenOffice.org doit être configuré pour permettre les interactions avec d'autres applications. Deux méthodes sont disponibles : les tuyaux ou TCP/IP. Les tuyaux sont plus simples et plus rapides. Pour lancer Writer et s'y connecter a l'aide de tuyaux, la commande suivante peut être utilisée :

    % oowriter "-accept=pipe,name=OOo_pipe;urp;StarOffice.ServiceManager"

Le tuyau ou le port TCP peuvent être configurés à chaque fois que OpenOffice.org est exécuté. Consultez la documentation OpenOffice.org pour plus de détails.

Pour insérer une citation, sélectionnez une entrée, puis utilisez Citer l'entrée dans OpenOffice.org. Writer doit déjà être en cours d'exécution. &appname; tentera de s'y connecter. En cas d'échec, il vous demandera plus d'informations concernant la connexion.

Boite de dialogue de connexion OpenOffice.org Connection Dialog
Boite de dialogue de connexion OpenOffice.org Connection Dialog

Sélectionnez le type de connexion, soit tuyau ou TCP!IP. Puis entrez le nom du tuyau, ou le nom d'hôte et le port TCP. &appname; conservera en mémoire vos paramètres de connexion pour les futures utilisations.