Manuel de Tellico

# Manuel de Tellico

Robby Stephenson `<robby@periapsis.org>`

Traduction française : Stanislas Zeller
Traduction française : Pierre Buard
Relecture de la documentation française : Pierre Buard
Version 2.0 (28/08/2009)

Copyright © 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011 Robby Stephenson

Pour prendre connaissance des licences s'appliquant au logiciel et à cette documentation, veuillez vous référer à la dernière section.

Ce document est le manuel d'utilisation pour Tellico, un logiciel de gestion de collection.

Liste des tableaux

2.1. Modifications de types de champ autorisées
2.2. Exemples de formatage
7.1. Valeurs du type de collection
7.2. Valeurs du type de champ
7.3. Valeurs du drapeau de champ
7.4. Valeurs du format de champ

Chapitre 1. Introduction
Introduction

# Chapitre 1. Introduction

## Tellico

Tellico est un programme pour gérer des collections. Au départ simple gestionnaire de collections de livres, il a été étendu pour intégrer des modèles de collections de bibliographies, bandes dessinées, vidéos, musiques, monnaies, timbres, cartes, jeux vidéo, vins, jeux de plateau et fichiers. De plus, des collections personnalisées peuvent être créées pour tous types d'ensembles.

### Ce qu'est Tellico

Tellico archive les entrées d'une collection et propose un moyen simple d'ajouter des informations à chacune. Il fournit plusieurs types de champs et permet leur création en nombre illimité par l'utilisateur. Les entrées d'une collection peuvent être regroupées selon n'importe quel champ pour en facilité l'organisation et les vues personnalisables affichent autant d'informations que vous le souhaitez.

Les prêts peuvent être suivis, avec une intégration optionnelle à KOrganizer. Les collections sont importables et exportables depuis et vers plusieurs formats pour faciliter l'échange et la publication des données.

### Ce que Tellico n'est pas

Tellico n'est pas un lecteur audio ou vidéo. Il ne propose rien pour lire ou modifier des fichiers multimédia. Il ne permet pas non plus de modifier les images. Bien que Tellico ait certaines fonctionnalités pour gérer des listes bibliographiques, ce n'est pas un outil complet de gestion de références. Tellico n'a pas non plus la prétention d'avoir toutes les capacités d'un outil de base de données relationnelle.

Comme simili clause de non-responsabilité, Tellico est un passe-temps pour l'auteur et il n'est fait aucune garantie concernant ses fonctionnalités, son utilité ou quoi que ce soit d'autre. Plus d'informations sont disponibles dans la déclaration de licence.

Terminologie
Terminologie

## Terminologie

### Collections

Dans Tellico, la collection est un document. Une seule collection peut exister dans chaque fichier Tellico. Une collection contient un nombre non déterminé de champs et d'entrées. Tellico peut gérer douze types de collections spécifiques par défaut : livres, bibliographies, bandes dessinées, vidéos, musiques, cartes, pièces de monnaie, timbres, jeux, vins, jeux de plateau et listes de fichiers. En outre, un type de collection générique vide existe pour tout autre type de listes ou d'objets à collectionner.

### Champs de la collection

Chaque collection peut avoir un nombre illimité de champs. Tellico gère onze types de champs permettant une large variété de données. Les champs peuvent être modifiés avec la boîte de dialogue des champs de la collections et sont expliqués plus en détails dans la section Types de champs.

### Entrées de la collection

Une entrée est un enregistrement de base dans Tellico. Chaque entrée contient les valeurs correspondantes aux champs de la collection. Une collection peut avoir un nombre théoriquement illimité d'entrées. Cependant, la collection complète étant conservée en mémoire, un trop grand nombre d'entrées ralentirait l'application.

Tellico a été testé avec une collection de 10 000 entrées et la vitesse était satisfaisante. Cependant, si des images nombreuses ou volumineuses sont incluses dans la collection, le chargement et le traitement seront ralentis de façon importante. Les performances peuvent être améliorées en faisant en sorte que Tellico conserve les images séparées du fichier de données lui-même : soit dans le dossier de l'application, soit dans un dossier lié au fichier. Plus d'informations sont disponibles dans la section concernant la configuration.

Chapitre 2. Utiliser Tellico
Utiliser Tellico

# Chapitre 2. Utiliser Tellico

## Premiers pas

Par défaut, Tellico démarre avec une collection de livres vide. Pour travailler sur un autre type de collection, créez en une en utilisant le menu Fichier → Nouveau ou en cliquant sur le bouton dédié de la barre d'outils. Les collections sont livrées avec les champs les plus courants, mais vous pouvez en ajouter, modifier ou supprimer pour les adapter à vos besoins.

De nouvelles entrées peuvent être ajoutées en utilisant l'éditeur d'entrée. Le menu Collection → Nouvelle entrée ouvrira l'éditeur d'entrée, vide et prêt à être rempli. L'éditeur d'entrée peut aussi être ouvert en utilisant Configuration → Afficher l'éditeur d'entrée. Une fois les valeurs pour l'entrée saisies, vous pourrez les enregistrer dans la collection en utilisant le bouton Enregistrer l'entrée dans la boîte de dialogue de l'éditeur d'entrée, qui reste ouvert au cas où vous voudriez continuer à ajouter de nouvelles entrées. Après avoir enregistré une entrée dans la collection, vous pourrez la modifier en lui cliquant dessus dans la fenêtre principale. Si l'éditeur d'entrée n'est pas déjà ouvert, vous pourrez double-cliquer sur une entrée pour commencer à la modifier.

Si vous souhaiter inclure une image dans l'entrée, vous pourrez utiliser le sélecteur de fichiers standard de KDE en cliquant sur le bouton Sélectionner l'image... dans l'éditeur d'entrée ou bien glisser une image depuis le gestionnaire de fichiers ou du navigateur web directement dans l'éditeur d'entrée.

Lorsque vous sélectionnez une entrée, la vue des entrées affiche une vue formatée du contenu de l'entrée. Vous pouvez modifier le modèle utilisé pour afficher l'entrée dans la boîte de dialogue de configuration.

Les entrées dans la collection sont groupées quand elles partagent les mêmes valeurs pour certains champs, tel que l'auteur ou le réalisateur. Vous pouvez modifier le champ utilisé pour le groupement à l'aide de l'option dédiée dans la barre d'outils ou par le menu Configuration → Options de regroupement.

Le Filtre rapide est à votre disposition dans la barre d'outils afin de limité aisément les entrées visibles à celles qui contiennent le mot que vous y saisirez. Le filtre sert aussi à trouver rapidement une entrée. Vous pouvez y saisir le titre ou n'importe quel mot unique identifiant l'entrée pour que la vue détaillée affiche seulement les entrées correspondantes au filtre. La barre d'état affiche le nombre total d'entrées dans la collection et combien sont actuellement filtrées.

Utilisation générale
Utilisation générale

## Utilisation générale

La fenêtre principale comporte trois zones distinctes, affichant toutes des informations sur la collection d'une manière différente. La vue primaire est la Vue en détaillée en haut à droite, où les valeurs de tous les champs pour chaque entrée peuvent être affichées. Sur le coté gauche, les onglets affichent la Vue par groupe pour trier les entrées au sein d'une structure arborescente, la Vue filtrée permettant le suivi des entrées correspondantes à certains critères et la Vue des prêts où les emprunts sont listés. Enfin, la Vue des entrées présente une vue formatée des données pour une entrée ou une liste d'icônes pour un groupe d'entrées, en bas à droite.

### Vue en colonnes

N'importe quel champ des collections peut être affiché dans la Vue détaillée, même si les champs Paragraphe, Image, et Tableau ne seront probablement pas utiles. Un clic-droit sur l'en-tête d'une colonne ouvre un menu pour sélectionner les champs visibles. Les colonnes peuvent être redimensionnées et réarrangées de n'importe quelles manières et les réglages seront conservés entre les sessions.

### Vue par groupe

La Vue par groupes groupe les entrées dans une structure arborescente, par un champ autorisant le regroupement. Le nombre d'entrées de chaque groupe est affiché après son nom. Les groupes peuvent être développés ou réduits en cliquant sur le signe en forme de flèche ou en double-cliquant sur l'élément. Les options permettant de développer ou réduire tous les groupes sont accessibles par le menu contextuel à l'aide d'un clic-droit. L'arborescence peut être triée par nom de groupe ou par quantité en cliquant sur l'en-tête. Un groupe peut être aussi utilisé comme filtre de la Vue détaillée en réalisant un clic-droit sur l'élément du groupe.

Quand plus d'un champ de la collection a l'option Mise en forme comme un nom activée, un groupe additionnel est ajouté pour combiner tous ces champs en un seul pseudo-groupe Personnes.

Une entrée ne contenant pas de valeur dans le champ utilisé pour former les groupes, est placée dans la catégorie (Vide), illustrée par un dossier rouge.

### Vue par filtre

Si des filtres sont enregistrés pour la collection, la Vue par filtre devient active. À mesure que vous ajouterez ou modifierez des entrées, elles seront automatiquement vérifiées par rapport aux filtres et ajoutées ou supprimées si cela est approprié. Le filtre peut être modifié en double-cliquant sur l'élément désiré pour ouvrir la boîte de dialogue de Filtre avancée. Un clic-droit vous proposera de le supprimer complètement.

### Vue des prêts en cours

Une fois que des entrées sont marquées comme prêtées, la Vue des prêts en cours est ajoutée à la fenêtre afin de suivre ces entrées empruntées. Le suivi des prêts se fait par entrée : un clic-droit sur une entrée révélera une option pour modifier le prêt grâce à la Fenêtre des prêts.

### Vue des entrées

Une représentation formatée des valeurs de l'entrée est affichée dans la Vue des entrées. Des modèles sont utilisés pour la mise en page et les graphiques additionnels. Des modèles spécifiques à chaque type de collection peuvent être définis dans la boîte de dialogue de configuration, avec des couleurs et polices personnalisées.

Tous les modèles par défaut respecte les choix de couleur et de police mais les autres modèles personnalisés pourrez ne pas le faire. Les modèles par défaut rendent aussi les champs d'URL actifs, en utilisant l'association de fichier par défaut de KDE. À l'exportation en HTML, le modèle courant est employé pour exporter les fichiers d'entrée individuelle.

### Barre d'état

La barre d'état est utilisée pour afficher l'action présente de Tellico. Est inclu également, un compteur totalisant les entrées de la collection et, si un filtre est appliqué, combien sont actuellement visibles.

Éditer les entrées
Éditer les entrées

## Éditer les entrées

L'éditeur d'entrée est utilisé pour ajouter ou modifier les entrées de la collection. Un double-clic sur une entrée dans la Vue par groupes ou la Vue en colonnes ouvre l'éditeur d'entrée pour celle-ci. De nouvelles entrées peuvent être créées en utilisant le menu Collection, l'icône de la barre d'outils ou le bouton dans l'Éditeur d'entrées.

Fermer l'éditeur d'entrée quand les modifications ont été faites, mais pas enregistrées, fera apparaître un message d'avertissement. Les champs sont groupés par catégorie et s'affichent dans l'ordre de leur apparition dans la boîte de dialogue des Champs de collection. Ils peuvent aussi être réarrangés.

Cliquer sur l'intitulé du champ URL ouvrira le lien en utilisant l'association de fichiers par défaut de KDE. Le bouton sélecteur d'URL, à côté de l'entrée texte, affichera la boîte de dialogue d'ouverture de fichiers de KDE, bien que le champ ne soit pas limité aux fichiers locaux.

Pour les champs Image, le bouton Sélectionner l'image... ouvre la boîte de dialogue de sélection de fichiers de KDE. L'image sera enregistrée dans la collection sous son format d'origine et une version réduite sera affichée dans l'éditeur d'entrée. L'image peut être effacée à l'aide du bouton Effacer. Les images effacées sont supprimées de la collection.

Le composant graphique d'édition gère aussi le glisser-déposer. Glisser une image depuis un gestionnaire de fichiers ou un navigateur web revient à choisir une image dans le sélecteur de fichiers. Glisser une image depuis le composant graphique de modification vers la fenêtre du gestionnaire de fichiers Konqueror enregistrera l'image dans le dossier cible.

### Avertissement

Par défaut, les images sont stockées dans le fichier de données de la collection, conservant tout le contenu à un seul endroit. Cependant, trop d'images risque de ralentir Tellico significativement et augmenter la taille du fichier de données. Pour cela, Tellico propose d'enregistrer les images séparément, soit dans le dossier `$`KDEHOME`/share/apps/tellico/data/` ou dans un dossier au même emplacement que le fichier de données. Le chargement et l'enregistrement des fichiers de données seront plus rapides si les images sont stockées séparément, mais les fichiers de données ne sont plus portables ou archivables. Des fichiers de données archives peuvent tout de même être créés par Fichier+Exporter → Exporter en Zip....

Les champs Tableau contiennent cinq lignes, mais déplacer le curseur à la dernière ligne en ajoute automatiquement une autre. Pour les tableaux multi-colonnes, seule la première est utilisée pour grouper ou formater.

### Éditer plusieurs entrées

Plusieurs entrées peuvent être modifiées en même temps en sélectionnant plus d'une entrée dans la Vue par groupes ou dans la Vue en colonnes. Si plusieurs entrées sont sélectionnées, les champs contenant une même valeur dans chaque entrée sont activés. Si les entrées ont des valeurs différentes, les champs sont désactivés. Des cases à cocher sont ajoutées à la droite de chaque champ afin de définir si le champ doit être activé ou non, comme illustré dans la copie d'écran ci-dessous.

Seuls les champs activés seront modifiés quand les entrées sont enregistrées, facilitant l'édition à grande échelle. Par exemple, pour renseigner le « Médium » de toutes les entrées vidéos d'une collection, vérifiez que le champ « Médium » est activé. Saisissez DVD et enregistrez les entrées. Seul le champ « Médium » sera modifié, préservant toutes les valeurs des autres champs des entrées.

### Mettre à jour les données de l'entrée

Les entrées peuvent être automatiquement mises à jour en lançant une requête vers les sources de données disponibles pour le type de collection actuel, ce qui est très utile pour combiner les informations de plusieurs sources. Par exemple, vous pouvez ajouter un film à votre collection en utilisant les services web d'Amazon.com et mettre à jour l'entrée avec des informations additionnelles provenant de l'Internet Movie Database.

Seuls les champs vides sont mis à jour à moins que les propriétés de la source ne permettent de remplacer les informations existantes. Pour les scripts externes, un champ de mise à jour doit être spécifié dans les options de la source.

La mise à jour d'entrées s'initie par un clic-droit sur une entrée ou à l'aide du menu Collection → Mettre l'entrée à jour.

Modification des champs
Modification des champs

## Modification des champs

La boîte de dialogue des Champs de la collection vous permet d'ajouter de nouveaux champs à la collection, de modifier les champs existants ou de les supprimer.

### Liste des champs

Sur le coté gauche de la boîte de dialogue se trouve la liste des champs courants. Les champs modifiés sont indiqués en italique-gras. Les boutons en dessous de la liste ajoute ou supprime un champ et les flèches peuvent être employées pour en modifier leur ordre. L'ordre des champs dans la liste est important, car l'éditeur d'entrée l'utilise pour sa mise en page. Pour chaque catégorie, les champs seront affichés de gauche à droite, selon le trie de haut en bas dans cette liste.

### Propriétés des champs

Un champ est défini par son titre, son type, sa catégorie, sa description et, éventuellement, une valeur par défaut ou des valeurs autorisées. Le titre est employé partout comme référence au champ dans l'interface utilisateur. L'éditeur d'entrée l'utilise pour appeler des valeurs. La Vue en colonnes l'utilise comme en-tête de colonne. Les différents types de champ sont expliqués dans la section Types de champ. La description correspond à une infobulle dans l'éditeur d'entrée afin de fournir une explication sur le contenu du champ. De plus, pour les les champs avec une valeur dérivée, un modèle de valeur est utilisé pour formater le contenu du champ. La valeur par défaut est automatiquement ajoutée à la création d'une nouvelle entrée. La liste des valeurs autorisées, affichées dans les champs Choix, doivent être séparées par un point-virgule.

Les nouveaux champs peuvent être de n'importe quel type, mais les champs existants sont restreints aux types compatibles, comme détaillé dans le tableau ci-dessous :

Tableau 2.1. Modifications de types de champ autorisées

Type actuel | Nouveau type autorisé
--- | ---
Texte simple | Texte simple, Paragraphe, Nombre, URL, Tableau
Paragraphe | Texte simple, Paragraphe
Choix | Texte simple, Paragraphe, Choix, Nombre, URL, Tableau
Case à cocher | Texte simple, Paragraphe, Case à cocher, Nombre, URL, Tableau
Nombre | Texte simple, Paragraphe, Nombre, URL, Tableau
URL | Texte simple, Paragraphe, Nombre, URL, Tableau
Date | Texte simple, Date
Tableau | Texte simple, Paragraphe, Tableau
Image | Image
Note | Choix, Note

### Formatage des champs

Tellico permet de formater automatiquement les valeurs des champs. Le plus simple est la mise en majuscule automatique, qui met en majuscule les premières lettres de chaque mot, à l'exception de l'article. Le formatage des titre déplace certains articles du début vers la fin du champ ; par exemple, « Le Retour du Roi » deviendra « Retour du Roi, Le ». Les articles de titre sont configurables. Enfin, le formatage des noms essaie de séparer l'entrée pour que le nom dernier nom (ou nom famille) de la personne soit affiché en premier. Les préfixes et suffixes de noms sont configurables. Le groupe spécial Personnel applique aussi le formatage de noms à tous les champs, même si cela est désactivé dans la configuration globale.

Tous les formatages automatiques peuvent être désactivés en changeant les options globales à l'aide de la boîte de dialogue de Configuration. Globalement, la mise en majuscule est une option distincte du formatage ; ainsi, un titre peut être formaté automatiquement sans être mis en majuscule. Tous les types de champs ne permettent pas le formatage automatique.

Tableau 2.2. Exemples de formatage

Type de format | Valeur de champ | Majuscule automatique | Formatage automatique | Majuscule et formatage automatiques
--- | --- | --- | --- | ---
Titre | le retour du roi | Le Retour du Roi | retour du roi, le | Retour du Roi, Le
Nom | tom swift, jr. | Tom Swift, Jr. | swift, jr., tom | Swift, Jr., Tom

### Options de champ

Les champs ont également trois options génériques. Si l'auto-complètement est activé, Tellico met en cache les valeurs de chaque champ pour que l'éditeur d'entrée offre des suggestions en utilisant la configuration standard de KDE. Tous les types de champ ne permettent pas le complètement automatique. Tellico doit aussi savoir si un champ peut contenir plusieurs valeurs ou être utilisé pour grouper des entrées. Saisissez un point-virgule pour séparer plusieurs valeurs lors de l'édition d'une entrée.

Pour plus d'efficacité, n'activez pas l'auto-complètement à moins d'en avoir besoin. Plus il y a de champs avec le complètement automatique dans la collection, plus Tellico mettra de temps à charger le fichier.

Filtrage des entrées
Filtrage des entrées

## Filtrage des entrées

La boîte de dialogue du filtre avancé vous permet de limiter les entrées visibles dans la Vue en colonnes à partir d'une ou plusieurs règles de filtrage. Le filtre peut être utilisé pour trouver les entrées auxquelles correspondent toutes les règles définies dans la boîte de dialogue, ou simplement celles qui satisfont au moins une des règles. La boîte de dialogue du filtre avancé est aussi utile pour affiner une requête sur une collection.

Chaque ligne contient une règle de filtre. Sélectionnez le champ à vérifier dans la première boîte de la ligne, puis choisissez une règle de correspondance dans la boîte centrale. Les règles peuvent être équivalentes à des valeurs contenant un mot précis ou être strictement identiques. L'utilisation d'une expression rationnelle est également possible pour déterminer les correspondances, dans quel cas le bouton Modifier... devient actif pour éditer l'expression (si KRegExpEditor est installé sur votre ordinateur). Enfin, le mot ou la chaîne recherché doit être écrit dans la zone de saisie.

Jusqu'à huit règles peuvent être définies dans le filtre. Les boutons Plus et Moins sont utilisés pour ajouter ou supprimer des règles.

Les filtres peuvent être enregistrés, pour que toutes les entrées correspondantes soient groupées dans la Vue par filtre. La vue est dynamique afin que les entrées ajoutées ou modifiées soient groupées automatiquement. Pour enregistrer le filtre, écrivez un intitulé dans la zone de saisie et cliquez sur le bouton Enregistrer le filtre.

Les filtres précédemment enregistrés peuvent être modifiés avec un clic-droit sur l'élément de filtre dans la Vue par filtre et en sélectionnant Modifier le filtre. La boîte de dialogue du filtre avancé est ouverte pour renommer le filtre ou modifier les règles.

Pour trouver les livres de science-fiction que vous n'avez pas lu, cochez le bouton Vérifie toutes les règles suivantes, définissez la première règle en Genre contenant Science-Fiction et la deuxième Lu ne contenant pas true (pour les champs Case à cocher, la valeur interne est true (vrai)).

Pour trouver un livre de Bujold ou Weber, cochez le bouton Vérifie une des règles suivantes, définissez la première règle en Auteur contenant Bujold et la deuxième Auteur contenant Weber.

Générer des rapports
Générer des rapports

## Générer des rapports

Tellico peut générer divers rapports concernant votre collection. La boîte de dialogue Rapport cherche tous les modèles XSLT présents dans l'emplacement d'installation et dans `$`KDEHOME`/share/apps/tellico/report-templates/`. Vous pouvez donc en créer de nouveaux qui seront automatiquement identifiés et inclus comme options dans la boîte de dialogue Rapport. Des rapports complexes peuvent prendre du temps à être générés sur de grosses collections.

Les modèles installés avec Tellico incluent une liste de titres, la vue en colonnes par défaut, la vue en groupe, un résumé de tous les groupes et les valeurs les plus populaires dans ces groupes, un rapport de prêt, et un gros rapport incluant les images de couvertures. Sélectionnez le modèle désiré et cliquez sur le bouton Générer. Les rapports peuvent être imprimés ou enregistrés dans un fichier HTML.

Les entrées incluent dans le rapport seront limitées à celles visibles dans la Vue en colonnes ; ainsi, si un filtre est actif, la boîte de dialogue Rapport l'utilisera.

Suivi des prêts
Suivi des prêts

## Suivi des prêts

Tellico gère le suivi des prêts de n'importe quelles entrées de la collection. La Fenêtre des prêts peut être ouverte en utilisant l'élément Prêter l'article ou avec un clic-droit sur une entrée. Plusieurs entrées peuvent être prêtées en une fois.

Le nom de l'emprunteur peut être directement saisi ou pris depuis le carnet d'adresse par défaut de KDE en cliquant sur le bouton jouxtant la zone de texte. Il est supposé que la date de l'emprunt est celle du jour mais elle peut être modifiée. La date de retour est optionnelle et des remarques peuvent être ajoutées à propos du prêt.

Si une date de retour est saisie et que Tellico est compilé avec la prise en charge de libkcal, un pense-bête de prêt peut être ajouté à l'agenda par défaut de KDE comme un élément « à faire ». KOrganizer peut être utilisé pour afficher ces éléments.

Quand une entrée est prêtée, le champ Prêté est défini sur true (vrai). Si aucun champ de prêt n'existe dans la collection, il sera ajouté. Ne modifiez pas ce champ directement ! Les entrées prêtées peuvent être rendues en utilisant l'élément du menu ou avec un clic droit sur une entrée dans la Vue des prêts en cours.

Astuces générales
Astuces générales

## Astuces générales

Voici une liste des astuces apparaissant dans la fenêtre « Astuce du jour » de Tellico.

### Astuce

Si un livre a plus d'un auteur, vous devez séparer leurs noms par un point-virgule afin que Tellico sache les séparer et les utiliser individuellement. Les autres champs autorisant plusieurs valeurs doivent être saisies de la même façon : avec un point-virgule séparant chaque valeur.

### Astuce

Vous pouvez choisir les champs affichés dans la vue en liste à l'aide d'un clic droit sur l'en-tête de colonnes.

### Astuce

Vous pouvez ajouter, éditer ou modifier les champs de la collection à l'aide de la boîte de dialogue des Champs de la collection. Les boutons fléchés en dessous de la liste de champ servent à modifier la position du champ dans la liste, affectant l'apparence de l'éditeur d'entrée.

### Astuce

Si vous désirez filtrer à partir d'un champ Case à cocher, une valeur « true » (vrai) doit être utilisée. Pour afficher seulement les livres de science-fiction que vous n'avez pas lu, par exemple, cochez la case Vérifie toutes les règles suivantes, définissez la première règle pour avoir « Genre contenant science-fiction » (sans guillemets) et la deuxième règle « Lu ne contenant pas true » (sans guillemets).

### Astuce

Si un caractère autre qu'une lettre est utilisé dans le filtre rapide, la saisie sera interprétée comme une expression rationnelle. Pour afficher seulement les livres de Weber ou Bujold, par exemple, saisissez « weber|bujold » (sans guillemets) dans la boîte de filtres.

### Astuce

Vous pouvez éditer plus d'une entrée à la fois, en maintenant enfoncée la touche Maj ou Ctrl et en sélectionnant plusieurs entrées.

### Astuce

Vous pouvez convertir une collection existante de livres en bibliographie qui pourra ensuite être exportée vers le format BibTeX ou BibTeXML.

### Astuce

Si plus d'un champ est formaté comme un nom, un groupe additionnel intitulé « Personne » est ajouté à la collection, permettant aux auteurs et éditeurs d'être triés ou imprimés ensemble, par exemple.

### Astuce

Vous pouvez changer l'apparence des impressions en modifiant le fichier `tellico-printing.xsl`. Ce dernier génère du HTML dont le CSS influence des éléments comme la police, les marges, etc..

### Astuce

Double-cliquer sur une entrée ouvre l'éditeur d'entrée.

### Astuce

Vous pouvez ajouter des balises HTML aux champs Paragraphe pour le formatage, tel que <b>gras</b> ou <i>italique</i>.

### Astuce

Dans la Vue en colonnes, appuyez sur une lettre du clavier sélectionner l'entrée suivante commençant par cette lettre.

### Astuce

Vous pouvez utiliser les valeurs dérivées pour combiner des données provenant de plusieurs champs. Pour cela, cochez la case « valeur dérivée » et utilisez un modèle de valeur semblable à « `Valeur : %{champa}%{champb}` » ou %{...} sera remplacé par la valeur de champ appropriée. Ceci est utile pour collecter de nombreuses valeurs et les réunir dans seul champ, par exemple pour de meilleurs groupements et pour combiner des champs de différents types tout en respectant le trie approprié. Considérez comme exemple un champ « nombre » suivi d'un sous-champ de texte avec des entrées 3b, 14a.

Chapitre 3. Détails de Tellico
Détails de Tellico

# Chapitre 3. Détails de Tellico

## Types de champs

Chaque collection peut avoir un nombre illimité de champs. Tellico en gère onze types permettant une large gamme de données différentes.

### Texte simple

Le type de champ le plus basique est appelé Texte simple. Aucune restriction n'est placée sur les valeurs du champ et le composant graphique de saisie des données sert à saisir une ligne standard. Ce type est adapté aux champs ne nécessitant pas de valeurs longues, tel que l'auteur ou le genre.

### Nombre

Le type Nombre est identique au Texte simple, excepté que les données doivent être numérique. Les entrées seront triées numériquement dans la vue en colonne si une colonne de champ Nombre est sélectionnée. Un champ texte standard, avec de petits boutons en forme de flèches pour augmenter ou diminuer la valeur, est utilisé pour la saisie des données. Aucun formatage n'est appliqué.

### URL

Le type URL permet de lier vers d'autres documents, en utilisant les associations de type de fichiers standard de KDE pour ouvrir ces documents. Aucune validation n'est faite sur la valeur d'un champ URL mais les liens non valables ne seront pas ouverts. La saisie de donnée se fait dans un champ texte possédant un bouton pour afficher une boîte de dialogue d'ouverture de fichiers standard mais n'importe quels URL peuvent être utilisés. Les URL relatifs sont interprétés par rapport à l'emplacement du fichier de données, une fois qu'il a été enregistré.

Dans l'éditeur d'entrée, la légende devient le lien, tandis que dans la Vue des entrées, un lien hypertexte réel est utilisé. Ce type de champ est pratique pour lier les fichiers PDF des entrées bibliographiques ou pour des critiques de films par exemple. Aucun formatage n'est appliqué.

Les URL relatifs peuvent aussi être utilisés. Ils sont interprétés relativement à l'emplacement du fichier de données de Tellico. Dans L'éditeur d'entrée, le champ de saisi dispose d'un complètement automatique pour les emplacements de fichiers locaux. Si vous souhaitez que l'URL de la boîte de dialogue du sélecteur de fichiers de KDE soit interprété relativement à l'emplacement du document, alors une propriété du champ d'URL doit être définie comme relatif : true.

### Paragraphe

Pour les longs champs de texte, le type Paragraphe offre une zone texte large, toujours dans sa propre catégorie. Un champ Paragraphe ne peut pas avoir de valeurs multiples, ni être automatiquement formaté. Il ne peut pas être utilisé pour grouper. Il est conseillé de saisir les résumés, intrigues ou critiques dans ce type de champ.

### Choix

Quand un champ doit être limité à quelques valeurs prédéfinies, le type Choix est utilisé. Les valeurs acceptables sont présentées à l'aide d'un menu déroulant. Évidemment, plusieurs valeurs ne sont pas acceptées. Les champs tels que le type bibliographique ou note personnelle sont des champs de type Choix.

Les points-virgules doivent être utilisés pour séparer les valeurs autorisées.

### Case à cocher

Pour les champs qui indiquent une valeur « oui » ou « non », le type Case à cocher est disponible. Par défaut, la case n'est pas cochée. Les champs Case à cocher ne sont pas formatés et sont limités à des valeurs uniques. En interne, les valeurs de champ interprétées comme `true` (vrai) ou `false` (faux). Exemples : les champs cadeau ou prêt.

### Date

Un champ Date peut inclure un jour, un mois et une année. La date est affichée au format standard AAAA-MM-JJ, facilitant le tri. Le sélecteur de date standard de KDE peut être utilisé pour choisir la date avec la souris ou saisie directement. Le champ ne requière une date complète ; seule l'année peut être saisie, par exemple. Les valeurs multiples ne sont pas permises.

### Tableau

Les champs Tableau contiennent une ou plusieurs colonnes de valeurs. Dans L'éditeur d'entrée, le champ est présenté en utilisant une vue en cascade, avec des lignes numérotées. Quand la dernière ligne est sélectionnée, une ligne additionnelle est ajoutée. Le complètement automatique n'est pas disponible. Ce champ est utile pour lister les chapitres d'un livre, les scènes dans un film ou les morceaux d'un album. Les champs Tableau sont toujours dans une catégorie à part.

Le nombre de colonnes, au maximum de dix, est défini en ajoutant une propriété nommée columns (colonnes) à la définition du champ. Les colonnes peuvent être intitulées par un clic-droit sur l'en-tête ou en définissant des propriétés de champ appelées columns1 (colonnes1), etc.

Quand vous utilisez L'éditeur d'entrée pour les champs Tableau, les lignes peuvent être réarrangées en glissant la souris tout en maintenant appuyée la touche Ctrl. Un menu contextuel permettant d'insérer ou supprimer des lignes est également disponible par un clic-droit sur le tableau.

### Image

Les champs Image contiennent une image, de n'importe quel format géré par KDE ; plus couramment aux formats PNG ou JPEG. L'image peut être enregistrée directement dans le fichier de données de Tellico ou dans le dossier de données de l'application. Le sélecteur de fichier standard de KDE est utilisé pour permettre la saisie d'un URL ou la sélection d'un fichier disponible localement. Les images peuvent être glissées depuis un gestionnaire de fichiers ou un navigateur.

### Note

Les champs Note affichent un nombre d'étoiles représentant la note numérique d'une entrée. Par défaut, la note maximum est de cinq. Les minimum et maximum peuvent être modifiée par les propriétés de définition du champ dans la boîte de dialogue des Champs de la collection, intitulée minimum et maximum, respectivement.

### Champs de valeur dérivée

Les champs utilisant des valeurs dérivées sont un cas à part. Le type de champ correspond au type de valeur habituellement renseignée dans le champ, sauf que cette valeur est construite à partir d'autres champs en utilisant un format de chaîne dans la description du champ. Par exemple, si un champ à comme valeur modèle `%{title} %{year}` (titre et année), alors la valeur de ce champ deviendra le titre, suivi de l'année. Ce type de champ est principalement utilisé pour le champ de titre des collections de pièces, timbres, cartes à échanger et vins. Le nom du champ interne ou le titre du champ peut être utilisé dans la description pour le formatage.

Pour sélectionner une seule valeur d'un champ en contenant plusieurs, ajoutez un index de position au modèle, tel que `%{author:1}` pour le premier auteur. La position peut être négative, décomptée à partir de la fin : `%{author:-1}` serait alors le dernier auteur. Des valeurs de majuscule ou minuscule peuvent être employé dans la définition du modèle, tels que `%{author:1/l}` affiche le premier auteur en minuscule ou `%{author:1/u}` en majuscule.

Types de collection
Types de collection

## Types de collection

Tellico gère douze types de collections spécifiques par défaut : livres, entrées bibliographiques, bandes dessinées, films, musiques, jeux, cartes, pièces, timbres, vins, jeux de plateau et catalogue de fichiers. En plus, un modèle de collection générique vide est disponible pour toute autre collection. Les collections par défaut intègre un ensemble générique de champs. Vous pourrez en ajouter, modifier ou supprimer pour correspondre à vos besoins. La seule condition nécessaire est qu'une collection doit toujours avoir un champ Titre pour que la Vue par groupe fonctionne correctement. Pour certains types de collection, il s'agira simplement d'un champ à valeur dérivée combinant au moins deux autres champs.

En général, il n'y pas de différences fonctionnelles entre les types de collection. Vous pouvez créer une collection personnalisée pour vos livres aussi simplement qu'en utilisant la collection de livres par défaut. Mais Tellico choisit des icônes en fonction du type de collection et il peut y avoir des fonctionnalités spécialisées propres à un type de collection. Donc, si vous le pouvez, utiliser les collections par défaut. Si vous souhaitez créer une collection de vins, mais que vous n'aimez pas les champs par défaut, créez une collection de vins par défaut et supprimez ensuite tous les champs par défaut. De cette façon, Tellico identifiera quand même une collection de vins.

Par défaut, tous les types de collection inclus un champ ID affichant le numéro d'indexation de l'entrée. En plus, à l'exception des catalogues de fichiers, chaque collection inclut des champs affichant la date à laquelle l'entrée a été créée dans la collection ainsi que la date de la dernière modification.

### Collection de livres

Les collections de livres ont vingt-six champs par défaut : Titre, Sous-titre, Auteur, Format, Date d'achat, Prix d'achat, Éditeur, Édition, Année du copyright, Année de publication, ISBN#, LCCN#, Pages, Langue, Genre, Mots clés, Série, N° dans la série, Condition, Signé, Lu, Cadeau, Prêté, Note, Couverture et Commentaires.

Le champ ISBN# est spécial puisque les numéros ISBN sont automatiquement formatés et qu'une vérification est appliquée. Tellico reconnaît le champ ISBN si son nom de champ interne est isbn. Si vous l'avez supprimé ou si vous avez besoin de l'ajouter à un autre type de collection, créez le champ avec le titre ISBN et appliquez la modification, vous pourrez ensuite revenir et modifier le titre comme bon vous semble. Tellico créé un nom interne à partir du titre initial mais ne le modifie jamais si le titre est plus tard mis à jour.

### Bibliographies

Les bibliographies ont vingt-cinq champs par défaut : Titre, Type d'entrée, Auteur, Clé BibTeX, Titre du livre, Éditeur, Organisation, Maison d'édition, ISBN#, Adresse, Édition, Pages, Année, Journal, Mois, Nombre, Mode de publication, Chapitre, Série, N° dans la série, Volume, Référence croisée, Mots clés, Résumé et Notes.

Bien que les collections bibliographiques ne soient pas liées spécifiquement à BibTeX, les champs par défauts sont ceux habituellement utilisés par BibTeX. À l'exportation en BibTeX, une propriété étendue appelée bibtex est utilisée pour chaque champ afin de définir le champ BibTeX correspondant. Si vous ajoutez un champ à une bibliographie et que vous l'exportez au format BibTeX, n'oubliez pas de définir la propriété étendue bibtex.

Tellico a des fonctionnalités spécialisées pour les bibliographies. Les macros de saisie BibTeX peuvent être ajoutées, modifiées ou supprimées depuis Tellico et l'exportation BibTeX vous donne l'option d'étendre les macros. Les citations BibTeX peuvent être envoyées vers une application externe tel que LyX ou Kile en utilisant l'option dénommée lyxpipe.

Les collections de livres peuvent être converties en bibliographies. Les champs BibTeX par défaut sont ajoutés et les propriétés étendues définies. Cette fonctionnalité existe surtout pour convertir d'anciennes collections ; avant que le type bibliographie ai été séparé des collections de livres.

### Collections de bandes dessinées

Les collections de bandes dessinées ont vingt-deux champs par défaut : Titre, Sous-titre, Scénariste, Artiste, Série, Numéro, Maison d'édition, Édition, Année de publication, Pages, Pays, Langue, Genre, Mots clés, Condition, Date d'achat, Prix d'achat, Signé, Cadeau, Prêté, Couverture et Commentaires.

### Collection de vidéos

Les collections de vidéos ont trente champs par défaut : Titre, Médium, Année de production, Certification, Genre, Région, Nationalité, Format, Distribution, Réalisateur, Producteur, Scénariste, Compositeur, Studio, Langues disponibles, Langues des sous-titres, Plages audio, Durée, Format d'image, Écran large, Format couleur, Version du réalisateur, Résumé de l'action, Note personnelle, Date d'achat, Prix d'achat, Cadeau, Prêté, Couverture et Commentaires.

Le champ Distribution est un tableau à deux colonnes et les noms des acteurs sont prévus pour être dans la première colonne, avec leurs rôles dans la deuxième. La Durée est affichée en minutes, bien que vous puissiez modifier cela.

### Collections musicales

Les collections musicales ont quinze champs par défaut : Titre, Médium, Artiste, Label, Année, Genre, Pistes, Note, Date d'achat, Prix d'achat, Cadeau, Prêté, Mots clés, Couverture et Commentaires.

### Collection de jeux

Les collections de jeux ont seize champs par défaut : Titre, Plate-forme, Genre, Année de parution, Éditeur, Développeur, Classement ESRB, Description, Note personnelle, Terminé, Date d'achat, Prix d'achat, Cadeau, Prêté, Couverture et Commentaires.

### Collection de cartes

Les collections de cartes ont dix-sept champs par défaut : Titre, Joueur, Équipe, Marque, Numéro de carte, Année, Série, Type de carte, Date d'achat, Prix d'achat, Lieu, Cadeau, Mots clés, Quantité, Image recto, Image verso et Commentaires.

### Collection de pièces

Les collections de pièces ont seize champs par défaut : Titre, Type, Dénomination, Année, Monnaie, Pays, Pièce, État de conservation, Service d'évaluation, Date d'achat, Prix d'achat, Lieu, Cadeau, Observation, Verso et Commentaires.

### Collection de timbres

Les collections de timbres ont dix-huit champs par défaut : Titre, Description, Dénomination, Pays, Année, Couleur, Scott#, État de conservation, Annulé, Articulé, Centrée, Gommé, Date d'achat, Prix d'achat, Lieu, Cadeau, Image et Commentaires.

### Collection de vins

Les collections de vins ont quinze entrées par défaut : Titre, Producteur, Appellation, Variété, Type, Pays, Date d'achat, Prix d'achat, Lieu, Quantité, Bu par, Note, Cadeau, Étiquette et Commentaires.

### Collection de jeux de plateau

Les collections de jeux de plateau ont quinze champs par défaut : Titre, Genre, Mécanisme, Année de parution, Maison d'édition, Concepteur, Nombre de joueurs, Description, Note, Date d'achat, Prix d'achat, Cadeau, Prêté, Couverture et Commentaires.

### Catalogues de fichiers

Les catalogues de fichiers ont quatorze champs par défaut : Nom, URL, Description, Volume, Dossier, Type MIME, Taille, Permissions, Propriétaire, Groupe, Créé le, Modifié le, Informations additionnelles et Icône.

### Collections personnalisées

Les collections personnalisées ont un champ par défaut, le Titre. Elles devraient être utilisées lorsqu'un objet à collectionner n'est pas proposé parmi les types par défaut.

Chapitre 4. Importer et exporter des données
Importer et exporter des données

# Chapitre 4. Importer et exporter des données

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

## Importer depuis Internet

Tellico 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.

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
Importer des données

## Importer des données

Tellico 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 à Tellico 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 Tellico

D'autres fichiers de données Tellico peuvent être importés. Remplacer la collection courante en important un fichier Tellico revient à ouvrir le fichier lui-même. L'intérêt d'importer des données Tellico 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.

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 Tellico 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

Tellico 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 configuration du système 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

Tellico 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. Tellico 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. Tellico 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éé. Tellico 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. Tellico 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.

Tellico 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. Tellico 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 Tellico comme collection bibliographique.

### Importer des données PDF

Si Tellico, 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. Tellico 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. Tellico 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. Tellico 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 Tellico du moment qu'une feuille de style XSL est fournie pour convertir le fichier au format Tellico. Tellico charge automatiquement la feuille de style et effectue les actions XSLT requises pour ouvrir le fichier.

Glisser et déposer
Glisser et déposer

## Glisser et déposer

Glisser et déposer des fichiers de données dans la fenêtre principale de Tellico 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 Tellico. Tellico 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
Exporter des donné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 Tellico. 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.

### Exporter en XML

Le format de fichier pour les données de Tellico 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 Tellico 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.

### 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.

### 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 des fichiers Pilot-DB. Les fichiers `.pdb` exportés sont transférables vers un PDA et directement utilisables. Pour le moment, Tellico ne peut pas importer les fichiers Pilot-DB.

### Exporter vers Alexandria

Alexandria est un gestionnaire de collections de livres pour l'environnement de bureau GNOME. Tellico 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. Tellico 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, Tellico 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é.

### 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. Tellico peut exporter la plupart des types de collection vers un fichier de données GCstar.

### Exporter en XML à partir de XSLT

Enfin, Tellico 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
Travailler avec les citations

## 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.

Chapitre 5. Utilisation avancée
Utilisation avancée

# Chapitre 5. Utilisation avancée

## Options en ligne de commande

Lorsque vous lancez Tellico depuis la ligne de commande, plusieurs options existent pour ouvrir des fichiers de données. Elles peuvent être affichées en écrivant `tellico --help`.

    Utilisation : tellico [options-Qt] [options-KDE] [options] [filename]

    Tellico - un gestionnaire de collections pour KDE

    Options :
      --nofile                  Ne pas charger le dernier fichier ouvert
      --bibtex                  Importer le <filename> en tant que fichier bibtex
      --mods                    Importer le <filename> en tant que fichier MODS
      --ris                     Importer le <filename> en tant que fichier RIS

    Arguments :
      filename                  Fichier à ouvrir

L'interface D-Bus
L'interface D-Bus

## L'interface D-Bus

Tellico a une interface D-Bus minimale permettant de scripter ou d'interagir avec des applications lancées depuis la ligne de commande. Comme pour tous les appels D-Bus, vous devrez spécifier le service à contrôler ainsi que son interface. Le nom du service D-Bus est `org.kde.tellico`.

### Les commandes D-Bus

Deux objets D-Bus sont accessibles par l'interface de Tellico : `Tellico` et `Collections`.

#### L'objet `Tellico`

La liste complète des commandes D-Bus dans l'objet `tellico` est affichée ci-dessous :

    bool importTellico(QString file, QString action)
    bool importBibtex(QString file, QString action)
    bool importMODS(QString file, QString action)
    bool importRIS(QString file, QString action)
    bool exportXML(QString file)
    bool exportZip(QString file)
    bool exportBibtex(QString file)
    bool exportHTML(QString file)
    bool exportCSV(QString file)
    bool exportPilotDB(QString file)
    QList<int> selectedEntries()
    QList<int> filteredEntries()
    void openFile(QString file)
    void setFilter(QString text)
    bool showEntry(int id)

Pour les quatre commandes d'import : le premier argument est le fichier à importer et le deuxième correspond à l'action d'import. Trois actions sont disponibles : replace (remplacer), append (ajouter), et merge (fusionner). Quatre formats de fichier sont gérés pour l'import : fichiers XML Tellico, fichiers Bibtex, fichiers MODS et fichiers RIS.

La collection actuellement ouverte dans Tellico peut être exportée dans un fichier aux formats suivants : XML Tellico, ZIP Tellico, Bibtex HTML, comma-separated values (CSV) ou PilotDB.

Une liste des ID pour les entrées actuellement sélectionnées ou filtrées permet de faciliter l'affichage ou la mise à jour des entrées dans la vue.

Un nouveau fichier de données peut être ouvert en utilisant la commande openFile(). L'emplacement complet doit être spécifié.

Un nouveau filtre peut être défini en utilisant la commande setFilter(), équivalente à la saisie dans la boîte de filtre de la fenêtre principale.

En donnant un ID d'entrée, showEntry() sélectionnera cette entrée et affichera les détails dans la fenêtre principale.

#### L'objet `Collections`

La liste complète des commandes D-Bus dans l'objet `Collections` est affichée ci-dessous :

    int addEntry()
    bool removeEntry(int entryID)
    QStringList allValues(QString fieldName)
    QStringList entryValues(int entryID, QString fieldName)
    QStringList selectedBibtexKeys()
    QString entryBibtexKey(int entryID)
    bool setEntryValue(int entryID, QString fieldName, QString value)
    bool addEntryValue(int entryID, QString fieldName, QString value)

Une nouvelle entrée vierge peut être créée dans la collection courante en utilisant la commande addEntry(). La valeur retournée est l'ID de l'entrée, pouvant ensuite être utilisé pour définir les valeurs des champs. Une entrée peut être supprimée de la collection en appelant la commande removeEntry().

Appeler allValues() en utilisant simplement un nom de champ retournera toutes les valeurs pour ce champ pour les entrées actuellement sélectionnées. En l'absence de sélection, la liste sera vide. Si un ID d'entrée est inclus dans la commande, les valeurs des champs pour cette entrée spécifique seront retournées.

Si la collection courante est une bibliographie, appeler selectedBibtexKeys() retournera la clé de citation Bibtex pour toutes les entrées sélectionnées. La bibtexKey (clé Bibtex) pour une entrée spécifique peut être trouvée en utilisant la commande entryBibtexKey().

Les entrées sont modifiables directement depuis l'interface D-Bus. À partir d'un ID d'entrée, setEntryValue() définira la valeur du champ directement. Pour ajouter une valeur, sans affecter les valeurs existantes, utilisez addEntryValue(). La nouvelle valeur sera en annexe de la fin de la liste existante.

### Exemples D-Bus

Voici quelques exemples de scripts Tellico employant l'interface D-Bus.

    Ouvrir un fichier Bibtex
    % qdbus org.kde.tellico /Tellico org.kde.tellico.importBibtex "/home/robby/reference.bib" "replace"
    true

    Exporter un fichier Bibtex
    % qdbus org.kde.tellico /Tellico org.kde.tellico.exportBibtex ~/documents/reference.bib
    true

    Obtenir la clé de citation pour la sélection courante
    % qdbus org.kde.tellico /Collections org.kde.tellico.selectedBibtexKeys
    stephenson2004

    Ajouter une nouvelle entrée et en définir le titre
    % myid=`qdbus org.kde.tellico /Collections org.kde.tellico.addEntry`
    % qdbus org.kde.tellico /Collections org.kde.tellico.setEntryValue $myid title "Mon nouveau livre"
    true

Chapitre 6. Configuration
Configuration

# Chapitre 6. Configuration

La boîte de dialogue de configuration contient toutes les options pour la modification des comportements par défaut de Tellico.

Cliquer sur le bouton Appliquer déclenche l'application immédiate des modifications sans fermer la boîte de dialogue, tandis que le bouton Ok applique les modifications et ferme la boîte de dialogue. Le bouton Annuler ferme la boîte de dialogue, sans qu'aucune modification ne soit appliquée. Le bouton Par défaut réinitialise les options de la page courante de la boîte de dialogue avec les valeurs par défaut, tandis que le bouton Aide ouvre le Centre d'aide de KDE à la section relative du manuel de Tellico.

Des paramètres mineurs sont uniquement accessibles en modifiant directement le fichier de configuration. Voir les Options cachées.

## Options générales

Les Options générales déterminent le comportement général. Les images peuvent être incluses dans les fichiers de données ou enregistrées séparément dans le dossier d'application Tellico. Aussi, quand Tellico est lancé, il peut automatiquement rouvrir le dernier fichier de données utilisé. La boîte de dialogue Astuce du jour contient des conseils sur l'utilisation de Tellico et apparaît au démarrage du programme. Vous voudrez sans doute lire quelques conseils et ensuite désactiver la boîte de dialogue.

Les Options de mise en forme contrôlent le niveau de mise en forme automatique que Tellico applique. Par exemple, lisez la section de mise en forme du champ. Les majuscules et la mise en forme sont des options distinctes, puisqu'un champ peut être en majuscule sans modifier l'ordre des mots et vice versa. La mise en majuscule automatique peut être modifiée pour ignorer certains mots. La mise en forme automatique inclue des articles grammaticaux dans les titres, accompagnées des préfixes et suffixes pour les noms propres. Les valeurs sont sensibles à la casse et doivent être séparées par un point-virgule.

Les règles de mise en forme reflète l'usage en langue anglaise et ne s'appliquent pas nécessairement à d'autres langues. Les articles sont déplacés à la fin du titre et précédés d'une virgule. Les noms propres sont mis en forme pour afficher le nom de famille en premier, suivi d'une virgule et du prénom. Les suffixes personnels, tels que Jr., sont ajoutés au nom de famille. Les préfixes, tel que von, s'affichent avec le nom de famille mais sont ignorés lors des tris.

John Q. von Public, III deviendra von Public, III, John Q. et Public sera employé pour déterminer l'ordre de tri.

Seuls les préfixes uniques sont gérés. Si un nom inclut van der, par exemple, les deux van et der doivent être inclus dans la liste de préfixe de noms de famille. Les articles finissant par une apostrophe sont également gérés.

### Note

Les valeurs de la collection ne sont pas modifiées, uniquement le texte affiché par l'interface. Les options de mise en forme peuvent donc être modifiées et rétablies sans affecter les données de la collection.

Options d'impression
Options d'impression

## Options d'impression

Tellico utilise un modèle XSLT pour créer du HTML avant de l'envoyer au service d'impression de KDE. Seuls les champs visibles dans la Vue en colonne sont imprimés. De plus, si la collection a été filtrée, seules les entrées visibles seront imprimées. Au préalable, un message d'erreur sera affiché si le filtrage est activé.

Les Options d'impression vous permettent d'influer sur la mise en forme à l'impression de la collection. Si Mise en forme des titres et des noms est cochée, les champs seront formatés automatiquement à l'impression. Sinon, ils seront imprimés exactement comme saisis.

La feuille de style d'impression par défaut imprime la collection avec les valeurs de champ dans les colonnes. Imprimer les libellés des champs détermine si le titre du champ sera imprimé en haut de la colonne.

À l'impression, les entrées seront triées telles qu'elles sont dans la Vue en colonne. En plus, elles peuvent être groupées telles que dans la Vue en groupe.

Finalement, quand les champs des images sont inclus dans l'impression, les images peuvent être redimensionnées tout en conservant leurs proportions. La largeur maximale de l'image définit la taille la plus large possible de l'illustration, sans agrandir les plus petites.

Options des modèles
Options des modèles

## Options des modèles

La Vue des entrées utilise les modèles pour afficher les valeurs des champs. Vous pouvez spécifier un modèle différent pour chaque type de collection. Certains modèles, tel que les modèles Album ou Vidéo sont pour un type spécifique de collection et un court message d'erreur apparaîtra dans la Vue des entrées s'ils sont utilisés pour d'autres types. Le bouton Aperçu permet d'afficher un aperçu du modèle. Des polices et couleurs personnalisées peuvent être définies et appliquées à tous les modèles par défaut. Cependant, les modèles personnalisés peuvent choisir de les ignorer.

Des modèles additionnels peuvent être installés directement ou téléchargés depuis kde-files.org en cliquant sur le bouton Télécharger. Les modèles installés par l'utilisateur peuvent aussi être supprimés. Les modèles d'entrée sont enregistrés dans `$`KDEHOME`/share/apps/tellico/entry-templates/`.

Si vous créez un nouveau modèle, pensez à le publier sur kde-files.org !

Options des sources de données
Options des sources de données

## Options des sources de données

Tellico peut utiliser de nombreuses sources pour importer des données, configurables dans la boîte de dialogue des sources des données. Il y a de nombreuses sources disponibles pour différents genres :

- les services web d'Amazon.com,

- l'Internet Movie Database,

- les serveurs z39.50,

- les serveurs SRU,

- les bases de données Entrez (PubMed),

- Yahoo! Audio Search,

- AnimeNfo.com,

- Internet Bookshop Italia,

- ISBNdb.com,

- les modules externes GCstar,

- arxiv.org,

- bibsonomy.org,

- citebase.org,

- crossref.org,

- Discogs.com,

- Wine.com,

- TheMovieDB.org,

- MusicBrainz.org,

- GiantBomb.com,

- OpenLibrary.org,

- Freebase.com,

- d'autres scripts ou applications externes,

- une combinaison des sources ci-dessus.

De nouvelles sources peuvent être ajoutées en cliquant sur le bouton Nouveau..., tandis que des sources existantes peuvent être modifiées ou supprimées en utilisant les boutons Modifier... ou Effacer.... L'ordre des sources affichées dans les menus de mise à jour des entrées peut aussi être modifié.

Des modèles additionnels peuvent être téléchargés depuis le dépôt en ligne de l'auteur en cliquant sur le bouton Télécharger. Ces scripts sont signés avec GPG par l'auteur afin de se prémunir de scripts dangereux provenant de sources inconnues et pouvant endommager votre système.

### Avertissement

N'installez et ne lancez jamais un script à partir de sources non vérifiées. Ils sont exécutés avec les mêmes droits d'accès que l'utilisateur et, par conséquent, peuvent modifier ou supprimer des fichiers et dénaturer votre système.

La plupart de ces sources offre plus d'informations que les champs par défaut dans Tellico. Ces autres champs sont affichés sur la droite de la boîte de dialogue de configuration. Si certains de ces champs sont cochés, ils seront ajoutés à la collection quand une entrée est ajoutées depuis cette source.

### Sources de données littéraires et bibliographiques

#### Serveurs z39.50

Le protocole z39.50 est utilisé pour accéder aux fournisseurs d'informations bibliographiques et aux bibliothèques de part le monde. Une liste des serveurs z39.50 publics est disponible sur indexdata.dk, entre autres. Tellico est livré avec de nombreuses configurations prédéfinies pour les principales bibliothèques mais vous pouvez spécifier les informations de connexion manuellement.

Tellico peut lire des données au format MODS, USMARC/MARC21 ou UNIMARC, à l'aide de la bibliothèque yaz. En plus, il y a une prise en charge limitée du format GRS-1.

Pour utiliser une des bibliothèques prédéfinies, cochez la case et sélectionnez la bibliothèque souhaitée. Les autres entrées de configuration seront désactivées. Si vous avez besoin de définir les informations manuellement, décochez cette case.

Le port par défaut pour l'accès z39.50 est le 210 mais des serveurs peuvent utiliser un port différent. Tellico suppose que le serveur utilise le codage de caractères MARC-8, sauf mention contraire. Si un codage de caractères incorrect est utilisé, un message d'erreur peut apparaître sur la sortie du programme ou alors aucune entrée ne sera reçue.

Des serveurs requièrent un nom d'utilisateur et un mot de passe pour l'accès. Tellico peut utiliser et enregistrer ce mot de passe, mais gardez à l'esprit qu'il sera écrit dans le fichier de configuration de Tellico en clair, ce qui n'est pas sécurisé. Pour la plupart des serveurs publics, les champs utilisateur et mot de passe doivent être laissé vide.

#### Serveurs SRU

SRU, signifiant Search/Retrieve via URL (recherche et réception à partir d'un URL), est un protocole de recherche standard pour les recherches Internet. Certaines bibliothèques l'utilisent pour accéder à leur catalogue de données. Parmi elles, la bibliothèque du Congrès des É-U est probablement la plus connue.

#### Bases de données Entrez

Entrez est le système de réception et de recherche textuelle intégré utilisé par le Centre national d'informations bio-technologiques (National Center for Biotechnology Information ou NCBI). La base de données Entrez la plus connue est PubMed pour ses articles sur les sciences de la vie provenant de nombreux journaux traitant de biologie. Pour le moment, la seule base de données Entrez gérée par Tellico est PubMed.

#### Bases de données bibliographiques

arXiv.org, Bibsonomy, Citebase, et CrossRef sont des bases de données en ligne pour les articles académiques et les informations bibliographiques. Pour avoir accès aux sources de CrossRef, vous devez demander un compte et ajouter ces informations à la configuration de la source de données.

#### Librairie internet italienne

IBS, ou Internet Bookstore Italia est un marchand de livres italien en ligne.

#### ISBNdb.com

ISBNdb.com est une base de données de livres en ligne avec des bibliothèques de collection de données de part le monde.

#### OpenLibrary.org

OpenLibrary.org est une base de données de livres en ligne visant à disposer d'une page par livre publié.

### Sources de données sur les bandes dessinées

#### AnimeNfo.com

AnimeNfo est un site populaire d'informations sur les dessins animés japonais.

### Sources de données filmographiques

#### Internet Movie Database

Internet Movie Database fournit des informations sur les films et vidéos. Quand une recherche est lancée sur une Personne, et si plus d'un résultat est affiché, une boîte de dialogue est ouverte vous permettant de sélectionner la bonne personne. Les options de configuration incluent la sélection de la nationalité à employer sur IMDb et le téléchargement des images. Comme IMDb peut afficher un grand nombre d'acteurs, vous pouvez limiter la recherche à une quantité précise.

#### TheMovieDB.org

TheMovieDB.org est une base de données de films en ligne, libre et ouverte. L'inscription à un compte gratuit est nécessaire.

### Sources de données discographiques

#### Discogs.com

Discogs.com est une base de données discographique complétée par les utilisateurs et contenant des informations sur les artistes, labels et leurs œuvres. L'inscription à un compte gratuit est nécessaire.

#### MusicBrainz.org

MusicBrainz.org est une méta-base de données discographique communautaire dont le but est de créer un site exhaustif d'informations sur la musique.

#### Yahoo! Audio Search

Yahoo! Audio Search peut être utilisé pour rechercher des informations sur des albums de musique. Cette source est souvent indisponible ou hors d'état.

### Sources de données œnologiques

#### Wine.com

Wine.com est un commerçant de vins en ligne et offres l'accès à une base données sur les variétés de vins. L'inscription à un compte gratuit est nécessaire.

### Sources de données vidéo-ludiques

#### GiantBomb.com

GiantBomb.com est une importante base de données communautaire sur les jeux vidéo. L'inscription à un compte gratuit est nécessaire.

### Sources de données pour les types de collections multiples

#### Amazon.com

En utilisant les services web d'Amazon, Tellico peut rechercher des informations dans un des neuf sites nationaux exploités par Amazon.com : États-Unis, Royaume-Uni, Allemagne, Japon, France, Canada, Chine, Espagne et Italie.

Configurer chaque source d'Amazon.com requiert trois paramètres : l'emplacement du serveur, une taille d'image et un identifiant d'associé. Les informations dAmazon.com peuvent inclure une image, tel que l'affiche d'une vidéo ou la couverture d'un livre. Cette image peut être téléchargée dans trois différentes tailles, en fonction de l'objet. Un identifiant d'associé doit être utilisé pour accéder aux services web d'Amazon.com et sera inclus dans les liens vers les objets, comme requis dans le contrat de licence pour l'utilisation des services web d'Amazon.com.

#### Modules externes GCstar

Si GCstar est installé, Tellico peut tirer parti d'une grande gamme de modules externes de recherche pour GCstar. En fonction du type de collection, diverses ressources en ligne sont disponibles comme source de données dans Tellico.

#### Freebase.com

Freebase.com est une base de données en ligne collectant des informations sur tous les sujets. Tellico peut fouiller Freebase pour y trouver des informations sur les livres, bandes-dessinées, musiques, films, jeux vidéos et jeux de société.

#### Scripts ou applications externes

Pour faciliter l'intégration de modules tiers dans Tellico, des scripts ou applications externes peuvent être utilisés comme interface de recherche vers d'autres sources d'informations. Tellico lancera une commande et enverra les termes de recherche comme arguments.

Certains scripts sont distribués avec Tellico. Allocine.fr est une filmothèque française en ligne. Le Ministère de la Culture Espagnol est une base de donnée espagnole de livres en ligne. Dark Horse Comics est un éditeur de bandes-dessinés. Ces sources de données requièrent l'installation de Python. BoardGameGeek est un site web avec des données exhaustives sur les jeux de plateau et le script requiert ruby.

Le type de collection renvoyé par le script doit être défini, en même temps que le format de données. Tellico peut non seulement importer des données depuis des scripts utilisant le format XML par défaut de Tellico mais aussi dans d'autres formats, tel que BibTeX.

L'emplacement complet de l'application doit être saisi dans les options de la source. Soyez attentif au fait que l'application est exécutée sur le système avec les mêmes droits d'accès que l'utilisateur courant ; n'utilisez pas de scripts dont la provenance est incertaine. Cochez les cases dont les clés de recherche sont gérées par l'application et saisissez les options de ligne de commande requises dans les zones de saisies correspondantes. La valeur de recherche sera insérée où `%1` apparaît.

La dernière case à cocher et sa zone de saisie déterminant les options de ligne de commande sont utilisées pour mettre à jour des entrées déjà présentes dans la collection. Les champs des entrées utilisés pour trouver une mise à jour doivent être saisies au même format employé par les champs valeur dérivée.

### Combinaison de sources de données multiples

Des combinaisons, jusqu'à huit sources de données existantes, peuvent être utilisées comme sources uniques dont les résultats proviendront de la fusion de toutes le sources. Le type de collection à employer doit être renseigné avant d'ajouter des sources.

Seules les sources de données existantes peuvent être combinées. La requête est alors envoyée à chaque source dont les retours seront combinés. Puisque la fusion des résultats dépends de l'ordre de recherche, la combinaison varie en fonction de la rapidité de la source et du réseau.

Chapitre 7. Bidouiller Tellico
Bidouiller Tellico

# Chapitre 7. Bidouiller Tellico

Dans l'esprit du logiciel libre, vous êtes les bienvenues pour bidouiller Tellico comme vous le souhaitez. Vous devriez pouvoir écrire des scripts pour importer, exporter ou modifier les données très facilement. Ce chapitre vous donne plus d'informations sur ce qu'il est possible de faire.

## Format de fichier

Le fichier de données par défaut de Tellico est une archive zip, avec normalement l'extension `.tc`. À l'intérieur de cette archive se trouve un fichier `tellico.xml`. Des images peuvent être incluses dans le dossier `images/` de l'archive ou directement dans les données XML, encodées en base64. Il est possible que les images soient enregistrées dans le dossier de données de l'application, auquel cas, elles ne seront pas présente dans le fichier de données. Tellico peut aussi charger un fichier XML, seul et non compressé.

### Donnés XML

#### Collection

    <?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE tellico PUBLIC "-//Robby Stephenson/DTD Tellico V11.0//EN" "http://periapsis.org/tellico/dtd/v11/tellico.dtd">
    <tellico xmlns="http://periapsis.org/tellico/" syntaxVersion="11">
     <collection title="My Books" type="2">
     </collection>
    </tellico>

Le fichier commence par la déclaration et l'encodage XML requis, suivi du doctype. Quand un nouveau type de champ est ajouté ou que des propriétés additionnelles sont définies sur les champs par défaut, la version du doctype DTD est incrémentée. Tellico peut toujours ouvrir et lire n'importe quelles versions DTD précédentes, mais enregistrera les fichiers dans la version courante. L'emplacement DTD pointe vers un véritable fichier DTD.

L'élément de haut niveau est un élément <tellico>, contenant la déclaration de l'espace de nom par défaut et la version de syntaxe du fichier qui doit toujours correspondre au DTD.

L'élément <tellico> contient un élément <collection>. Les collections multiples ne sont pas abordées, pour l'instant. L'attribut title contient le titre de la collection, tandis que le type spécifie quelles sortes d'entrées sont contenues dans la collection. Les types autorisés sont listés ultérieurement. Un attribut optionnel entryTitle peut être utilisé pour spécifier le titre des entrées pour une collection personnalisée, et doit être au pluriel.

#### Champs

      <fields>
       <field flags="8" title="Title" category="General" format="1" type="1" name="title" />
       <field flags="7" title="Author" category="General" format="2" type="1" name="author" />
       <field flags="2" title="Binding" category="General" allowed="Hardback;Paperback;Trade Paperback;E-Book;Magazine;Journal" format="4" type="3" name="binding" >
        <prop name="default"
    >Paperback</prop>
       </field>
       <field flags="6" title="Publisher" category="Publishing" format="0" type="1" name="publisher" />
       <field flags="4" title="Edition" category="Publishing" format="0" type="1" name="edition" />
       <field flags="3" title="Copyright Year" category="Publishing" format="4" type="6" name="cr_year" />
       <field flags="2" title="Publication Year" category="Publishing" format="4" type="6" name="pub_year" />
       <field flags="0" title="ISBN#" category="Publishing" format="4" type="1" name="isbn" description="International Standard Book Number" />
       <field flags="7" title="Genre" category="Classification" format="0" type="1" name="genre" />
       <field flags="7" title="Keywords" category="Classification" format="0" type="1" name="keyword" />
       <field flags="0" title="Front Cover" category="Front Cover" format="4" type="10" name="cover" />
       <field flags="0" title="Comments" category="Personal" format="4" type="1" name="comments" />
       <field title="Rating" flags="2" category="Personal" format="4" type="14" name="rating">
        <prop name="maximum"
    >5</prop>
        <prop name="minimum"
    >1</prop>
       </field>
       <field title="ID" flags="32" category="Personal" format="4" type="6" name="id">
        <prop name="template"
    >%{@id}</prop>
       </field>

      </fields>

Tous les champs sont définis dans un élément <fields> unique. Toutes les informations pour un champ, à l'exception des propriétés étendues, sont incluses comme attributs de l'élément de <field>. Les valeurs autorisées pour flags, format, et type sont données dans la section suivante.

Les propriétés des champs sont utilisées pour définir les valeurs par défaut des champs (plage de notation, modèle de valeur dérivée, etc.). L'exemple ci-dessus inclut une valeur par défaut, une notation maximale et un modèle pour un champ ID dérivé.

#### Entrées

      <entry>
       <title
    >C++ Programming Language, The</title>
       <authors>
        <author
    >Stroustrup, Bjarne</author>
       </authors>
       <publisher
    >Addison-Wesley Pub Co</publisher>
       <edition
    >3rd</edition>
       <pub_year
    >1997</pub_year>
       <isbn
    >0-201-88954-4</isbn>
       <genres>
        <genre
    >Non-Fiction</genre>
       </genres>
       <keywords>
        <keyword
    >Programming</keyword>
        <keyword
    >Computers</keyword>
       </keywords>
       <cover
    >cf65a2f023b6cb9e9233323dca10ac7c.jpeg</cover>
      </entry>

Pour chaque champ de la collection, une <entrée> peut contenir un élément dont le nom est identique au nom d'un champ. Si plusieurs valeurs sont permises pour le champ, la lettre s est ensuite ajoutée au nom de champ pour créer un élément et chaque valeur est ajoutée comme un enfant de l'élément, comme dans le cas des champs author (auteur), genre et keyword (mot clé) ci-dessus.

Il en résulte que si des champs additionnels sont ajoutés à la collection, le fichier de données ne sera plus conforme au fichier DTD. Cependant, Tellico utilise un analyseur syntaxique XML non valable, les champs additionnels ne poseront donc aucun problème.

#### Images

      <images>
       <image width="111" format="JPEG" height="140" id="cf65a2f023b6cb9e9233323dca10ac7c.jpeg" />
      </images>

Dans l'élément <images>, chaque image référencée par une entrée est listée, avec des attributs décrivant la taille de l'image, le format et l'identifiant. Si l'image est contenue dans le fichier « zip », l'élément est vide. Sinon, l'image peut être ajoutée au flux XML, sous forme de texte et encodée en base64.

Valeurs du type de collection
Valeurs du type de collection

## Valeurs du type de collection

Le type de collection est indiqué par l'attribut type de l'élément de la collection. La valeur est identique à la valeur d'énumération Type dans `src/collection.h`.

Tableau 7.1. Valeurs du type de collection

Type de collection | Valeur
--- | ---
Collection personnalisée | 1
Collection de livres | 2
Collection de vidéos | 3
Collection musicale | 4
Bibliographie | 5
Collection de bandes-dessinées | 6
Collection de vins | 7
Collection de pièces | 8
Collection de timbres | 9
Collection de cartes | 10
Collection de jeux | 11
Catalogue de fichiers | 12
Collection de jeux de plateau | 13

Valeurs du type de champ
Valeurs du type de champ

## Valeurs du type de champ

Tellico inclura tous les champs par défaut pour une collection si le premier élément de champ porte le nom _default. Pour les champs Paragraphe, Tableau ou Image, la catégorie de champ doit être identique au titre de champ.

Le type d'un champ est donné dans l'attribut type de l'élément champ. La valeur est identique à la valeur d'énumération de FieldType dans `src/field.h`.

Tableau 7.2. Valeurs du type de champ

Type de champ | Valeur
--- | ---
Texte simple | 1
Paragraphe | 2
Choix | 3
Case à cocher | 4
Nombre | 6
URL | 7
Table | 8
Image | 10
Date | 12
Note | 14

Le champ peut avoir différents jeux de drapeaux, donnés comme une valeur OR bit-à-bit dans l'attribut des drapeaux sur l'élément de champ. Le drapeau empêchant l'utilisateur de supprimer un champ est conçu pour certaines choses comme la clé de citation pour les entrées bibliographiques.

Tableau 7.3. Valeurs du drapeau de champ

Drapeaux de champ | Valeur
--- | ---
Autoriser des valeurs multiples | `0x01`
Autoriser le regroupement | `0x02`
Autoriser l'auto-complètement | `0x04`
Interdire la suppression | `0x08`
Interdire l'édition | `0x10`
Valeur dérivée | `0x20`

Le format du champ est donné dans l'attribut du format sur l'élément de champ. Le formatage de date n'est pas utilisé actuellement. Le groupement par personne utilise tous les champs employant le formatage du nom. La définition du drapeau valeur dérivée implique que la valeur du champ sera générée à partir de la propriété du modèle des autres valeurs du champ.

Tableau 7.4. Valeurs du format de champ

Format de champ | Valeur
--- | ---
Mise en majuscule automatique seulement | 0
Mise en forme comme un titre | 1
Mise en forme comme un nom | 2
Mise en forme comme une date | 3
Pas de mise en forme | 4

Cacher les options de configuration
Cacher les options de configuration

## Cacher les options de configuration

Tellico a des options de configuration qui ne sont pas présentes dans la boîte de dialogue de Configuration. Elles n'étaient pas assez importantes pour encombrer la boîte de dialogue avec plus de paramètres mais présentent des options susceptibles de convenir à divers utilisateurs, l'application les lit depuis le fichier de configuration.

Les paramètres de Tellico sont enregistrés dans un fichier du dossier personnel de l'utilisateur appelé `$`KDEHOME`/share/config/tellicorc`. Dans ce fichier, les réglages sont regroupés dans des sections avec des noms entre crochets, tel que « [General Options] ». Pour ajouter un paramètre au groupe Options générales, cherchez la ligne dans le fichier de configuration avec ce nom de groupe. S'il n'apparaît pas, créez-le vous-même en ajoutant une ligne intitulée [Options générales]. Le paramètre peut ensuite être ajouté sous le nom de groupe.

### [General Options]

Ces paramètres doivent être placés dans le groupe General Options.

#### Max Icon Size

La taille maximale des icônes dans la Vue en icônes peut être modifiée avec ce paramètre. La valeur par défaut est 96. La taille doit être comprise entre 32 et 512.

#### Exemple

`Max Icon Size=128`

#### Icon Cache Size

Le nombre maximal d'icônes conservées en mémoire peut être modifié avec ce paramètre. La valeur par défaut est 1000.

#### Exemple

`Icon Cache Size=100`

#### Exemple

`Max Icon Size=128`

#### Taille du cache d'image

La taille maximale de mémoire allouée, en octets, à la mise en cache de toutes les images peut être modifiée avec ce paramètre. La valeur par défaut est 67108864.

#### Exemple

`Image Cache Size=256000000`

### [Options - bibtex]

Ces paramètres doivent être placés dans le groupe Options - bibtex.

#### lyxpipe

Ce paramètre définit l'emplacement de lyxpipe pour l'envoi de citations bibliographiques. Il ne doit pas inclure le suffixe `.in`.

#### Exemple

`lyxpipe=$HOME/.lyx/lyxpipe`

Traduction de caractère BibTeX
Traduction de caractère BibTeX

## Traduction de caractère BibTeX

Quand des fichiers BibTeX sont importés ou exportés, certains caractères sont traduits entre leurs équivalents TeX et les caractères Unicode. Ces cartographies de caractères sont contenus dans le fichier `BibTeX-translation.xml`, situés dans le dossier d'installation. La cartographie peut être modifiée, comme souhaitée. L'élément clé contient les caractères Unicode et les éléments de l'entrée contiennent les équivalents TeX, qui peuvent être une cartographie multiple. La première définition sera celle employée lors de l'exportation en BibTeX.

      <key char="À">
        <string
    >{\`A}</string>
        <string
    >\`{A}</string>
      </key>

Astuces XSLT
Astuces XSLT

## Astuces XSLT

Voici quelques astuces pour l'écriture XSLT afin d'analyser les données XML de Tellico (À faire).

Chapitre 8. Questions et réponses
Questions et réponses

# Chapitre 8. Questions et réponses

8.1. Comment saisir plusieurs auteurs ?
8.2. Puis-je modifier l'apparence de l'impression ?
8.3. De quelle manière puis-je grouper à partir d'une propriété autre que celle listée dans la barre d'outils ?
8.4. Pourquoi tous ces trucs bizarres s'affichent quand je lance Tellico ?
8.5. Comment puis-je choisir quelle colonne afficher ?
8.6. Comment filtrer avec quelque chose comme le champ « Lu » ?
8.7. Comment ajouter de nouveaux modèles d'entrées ?
8.8. La compilation et l'installation se sont déroulées correctement mais quand Tellico démarre, la fenêtre est vide. Que se passe t-il ?
8.9. Comment exporter les champs BibTeX additionnels ?
8.10. Où est passé Bookcase ?
8.11. Quel rapport y-a t-il entre le nom Tellico et la nature du programme ?
8.12. Pourquoi incluez-vous ces liens vers Amazon.com dans les résultats de recherche ?
8.13. Pourquoi n'utilisez-vous pas une vraie base de données ?

8.1. | Comment saisir plusieurs auteurs ?

Les noms des auteurs doivent être séparés par un point-virgule, comme ceci : `Brian W. Kernighan;Dennis M. Ritchie`. N'incluez pas le mot « et » ou quelque chose de similaire, même si vous avez vingt auteurs. Si vous avez l'option de formatage automatique cochée, le dernier nom sera ensuite automatiquement affiché en premier pour chaque auteur.

D'autres propriétés qui permettent des valeurs multiples, comme « genre » et « mots clés », sont saisies de la même manière, avec un point-virgule (;) séparant chaque valeur.

8.2. | Puis-je modifier l'apparence de l'impression ?

Oui, très certainement. Trouvez le fichier `tellico-printing.xsl` qui devrait être dans le dossier $`KDEDIR`/share/apps/tellico/. Vous pouvez le copier dans le dossier $`KDEHOME`/share/apps/tellico/ pour appliquer des modifications personnelles. Vous devrez maîtriser XSLT mais modifier ce fichier est la seule manière de modifier la présentation de l'impression. Le code HTML est généré depuis ce fichier et la manière la plus simple de modifier la présentation est de modifier le CSS dans la partie haute.

Soyez attentif au fait que le fichier `tellico-printing.xsl` référence un autre fichier, `tellico-common.xsl`, lequel contient des modèles XSLT courant. Si vous copiez `tellico-printing.xsl` vers $`KDEHOME`, vous devez soit modifier l'élément <xsl:import> pour le diriger vers l'emplacement actuel du fichier `tellico-common.xsl` ou copier également ce dernier.

8.3. | De quelle manière puis-je grouper à partir d'une propriété autre que celle listée dans la barre d'outils ?
| Pour permettre le groupement par champ ne le permettant pas par défaut, cochez la case « Autoriser le regroupement » pour ce champ particulier dans la boîte de dialogue « Champs de la collection ».
8.4. | Pourquoi tous ces trucs bizarres s'affichent quand je lance Tellico ?

Les « trucs bizarres » tel que :

    Tellico::updateCollectionToolBar
    GroupView::setGroupAttribute - author
    GroupView::slotAddCollection
    QCheckBox::property( "title" ) failed: property invalid
    or does not exist

sont des informations de débogage. Au moment de la compilation, vous pouvez désactiver cette option avec l'option ``--disable-debug``. Vous devriez aussi utiliser ``--enable-final`` qui occupe un peu plus de mémoire durant la compilation mais améliore le lancement de l'application.

Le dernier message est légèrement différent, cela veut simplement dire que votre installation Qt™ a été compilée avec des informations de débogage.

Ou, si Tellico est déjà installé, lancez `kdebugdialog` et vérifiez que « 0 (generic) » est décoché. Cela désactive les messages de débogage de toutes les applications génériques de KDE ; c'est-à-dire de celles qui ne sont pas officiellement distribuées par KDE.

8.5. | Comment puis-je choisir quelle colonne afficher ?
| Avec un clic-droit sur la barre d'en-tête. Vous pouvez aussi glisser les en-têtes pour réarranger les colonnes, et cliquez dessus pour les trier par ce champ.
8.6. | Comment filtrer avec quelque chose comme le champ « Lu » ?

Dans le logiciel, les champs à cocher sont enregistrés comme « true » (vrai), ainsi, si vous souhaitez filtrer pour n'afficher que les livres de science fiction que vous n'avez pas lu, par exemple, vous aurez besoin de deux règles. Vérifiez bien que le bouton « Vérifie toutes les règles suivantes » est coché. Définissez la première règle pour avoir « Genre » « contenant » « Science Fiction » (sans guillemet) et la deuxième règle « Lu » « ne contenant pas » « true » (sans guillemet).

Le filtre rapide dans la barre d'outils correspondra à tous les champs et, s'il contient des caractères spéciaux, le texte sera interprété comme une expression rationnelle. Si vous voulez rapidement filtrer vos livres pour afficher ceux de Weber ou Bujold, alors saisissez « weber|bujold » (sans guillemet) dans la barre d'outils.

8.7. | Comment ajouter de nouveaux modèles d'entrées ?

Il est conseillé d'enregistrer les modèles d'entrées dans `$`KDEHOME`/share/apps/tellico/entry-templates/` pour un seul utilisateur ou `$`KDEDIR`/share/apps/tellico/entry-templates/` pour tout le monde. Les modèles dans $`KDEHOME` annulent les fichiers du même nom dans $`KDEDIRS`. Les modèles d'entrées peuvent être limité à un type collection grâce à la boîte de dialogue de configuration.

Les modèles pour la boîte de dialogue de Rapport de collection sont enregistrés dans `$`KDEHOME`/share/apps/tellico/report-templates/`.

8.8. | La compilation et l'installation se sont déroulées correctement mais quand Tellico démarre, la fenêtre est vide. Que se passe t-il ?

Les programmes KDE recherchent des données dans les emplacements définis dans la variable d'environnement $`KDEDIRS`. Si vous installez dans `/usr/local` par exemple, alors que $`KDEDIRS` est vide ou contient uniquement `/usr`, Tellico ne trouvera pas les fichiers dont il a besoin. C'est particulièrement vrai pour SuSE® pour laquelle vous devez compiler avec ``--prefix`=`/opt/kde3``. Vous pouvez aussi ajouter une ligne à votre fichier `.profile` pour définir $`KDEDIRS`. Reportez-vous à la documentation de votre shell.

8.9. | Comment exporter les champs BibTeX additionnels ?

Tellico utilise la propriété bibtex pour savoir comment exporter les champs BibTeX. Si vous souhaiter ajouter des champs à exporter, tel qu'un résumé, ouvrez la boîte de dialogue Champs de la collection, et cliquez sur le bouton Régler les propriétés. Ajoutez une propriété bibtex ayant la valeur abstract (résumé). Ensuite, lorsque vous exporterez vers BibTeX ou BibTeXML, cette propriété sera utilisée comme nom de champ BibTeX.

8.10. | Où est passé Bookcase ?
| Suite à un conflit de marque, Bookcase a été renommé Tellico en septembre 2004. Tellico 0.12 est ensuite sorti, identique à Bookcase 0.11, excepté le changement de nom.
8.11. | Quel rapport y-a t-il entre le nom Tellico et la nature du programme ?
| Je pensais à plein d'autres noms, certain était en rapport avec les collections de livres. Cependant, Tellico peut prendre en charge bien plus que les livres, et d'ailleurs c'est un loisir, j'ai donc choisi un nom qui sonne bien (pour moi), un nom emprunté à une ville proche d'où j'ai grandi.
8.12. | Pourquoi incluez-vous ces liens vers Amazon.com dans les résultats de recherche ?
| Les termes du contrat pour l'accès aux services web Amazon.com requièrent que toutes les images réceptionnées depuis le site doivent être liées à Amazon.com, en plus d'un autre lien. L'identifiant d'associé Amazon.com est nécessairement inclus pour que les paiements référencés soient dûment collectés.
8.13. | Pourquoi n'utilisez-vous pas une vraie base de données ?

Quand j'ai commencé Tellico, j'apprenais le C++. Je ne connaissais pas SQL à ce moment-là et, encore aujourd'hui, je n'ai qu'une vague idée sur la façon de l'utiliser. Tout simplement, Tellico ne fonctionnait pas comme une base de données relationnelle et cela ne changera pas tant que je n'aurais pas appris SQL, ou simplement le temps et la motivation de modifier le modèle de données. Si cela vous ennuie, et bien, n'utilisez pas Tellico.

Bien entendu, toute personne souhaitant contribuer au code source est la bienvenue.

Chapitre 9. Référence des commandes
Référence des commandes

# Chapitre 9. Référence des commandes

## La fenêtre principale de Tellico

Chaque élément des menus est détaillé ci-dessous. Quand un raccourci clavier lance une fonctionnalité du menu, celui-ci accompagne l'élément décrit.

### Le menu Fichier

Fichier → Nouveau

  Cette commande crée une nouvelle collection. Tellico gère douze types de collections par défaut en plus d'une collection vide, personnalisable, définie par l'utilisateur.

Fichier → Ouvrir... (Ctrl+O)

  Cette commande ouvre un fichier dans Tellico.

Fichier → Récemment ouvert(s)

  Cette commande ouvre un fichier depuis un sous-menu contenant une liste des fichiers récemment ouverts.

Fichier → Enregistrer... (Ctrl+S)

  Cette commande enregistre la collection. Si le fichier est Sans titre, Enregistrer... est équivalent à Enregistrer sous. Activé uniquement lorsque la collection a été modifiée.

Fichier → Enregistrer sous...

  Cette commande enregistre la collection dans un nouveau fichier.

Fichier → Imprimer... (Ctrl+P)

  Cette commande imprime la collection. Les options d'impression peuvent être définies dans la boîte de dialogue de Configuration.

Fichier → Importer

  Cette commande importe des données depuis un autre fichier. Tellico peut importer des données depuis d'autres formats.

Fichier → Exporter

  Cette commande exporte la collection vers un autre format. Tellico peut exporter des données dans d'autres formats.

Fichier → Quitter (Ctrl+Q)

  Cette commande ferme la fenêtre de Tellico, si la collection a des modifications non enregistrées, vous serez invité à les enregistrer avant de continuer.

### Le menu Édition

Édition → Annuler (Ctrl+Z)

  Cette commande annule l'action précédente. Toutes les actions ne sont pas gérées par la commande d'annulation.

Édition → Refaire (Ctrl+Maj+Z)

  Cette commande rétablie l'action annulée.

Édition → Couper (Ctrl+X)

  Cette commande supprime le texte sélectionné et le copie dans le presse-papiers.

Édition → Copier (Ctrl+C)

  Cette commande copie le texte sélectionné vers le presse-papiers.

Édition → Coller (Ctrl+V)

  Cette commande colle le texte du presse-papiers, si présent, dans l'éditeur à la position du curseur.

Édition → Tout sélectionner (Ctrl+A)

  Cette commande sélectionne toutes les entrées de la collection, dans la Vue en colonnes.

Édition → Désélectionner (Ctrl+Maj+A)

  Cette commande désélectionne toutes les entrées de la collection.

Édition → Chercher sur Internet... (Ctrl+I)

  Cette commande ouvre la boîte de dialogue des Recherche Internet pour rechercher et importer des entrées depuis des sites web, comme Amazon.com.

Édition → Filtre avancé... (Ctrl+J)

  Cette commande ouvre la boîte de dialogue Filtre avancée.

### Le menu Collection

Collection → Nouvelle entrée (Ctrl+N)

  Cette commande ouvre l'éditeur d'entrée pour en créer une nouvelle.

Collection → Éditer l'entrée (Ctrl+E)

  Cette commande ouvre l'éditeur d'entrée pour modifier celles sélectionnées.

Collection → Dupliquer l'entrée (Ctrl+Y)

  Cette commande copie ou duplique les entrées sélectionnées en nouvelles entrées de la collection.

Collection → Supprimer l'entrée (Ctrl+D)

  Cette commande supprime les entrées sélectionnées.

Collection → Fusionner les entrées

  Cette commande fusionne les entrées sélectionnées.

Collection → Mettre l'entrée à jour

  Ce menu contient une liste de toutes les sources disponibles. Il peut être utilisé pour interroger automatiquement une source et mettre à jour les entrées sélectionnées.

Collection → Gestion des prêts...

  Cette commande ouvre une boîte de dialogue gérant les prêts des entrées sélectionnées.

Collection → Récupérer

  Cette commande vérifie si les entrées sélectionnées sont toujours en prêt.

Collection → Renommer la collection (Ctrl+R)

  Cette commande ouvre une boîte de dialogue pour renommer la collection.

Collection → Champs de la collection... (Ctrl+U)

  Cette commande ouvre la boîte de dialogue des Champs de la collection.

Collection → Générer des rapports...

  Cette commande ouvre la boîte de dialogue Rapport pour générer des rapports à propos de la collection.

Collection → Bibliographie → Convertir en bibliographie

  Cette commande convertit une collection de livres en bibliographie en ajoutant certains champs nécessaires à l'exportation vers BibTeX. Elle n'est disponible que pour les collections de livres.

Collection → Bibliographie → Ligne de Macros...

  Cette commande ouvre une boîte de dialogue pour modifier les macros BibTeX de la collection. Celle-ci n'est accessible que lors de l'édition d'une bibliographie.

Collection → Bibliographie → Vérifier les doublons

  Cette commande recherche les clés BibTeX en double et peut filtrer la collection pour afficher les entrées ayant des clés en double.

Collection → Bibliographie → Copier au format BibTeX vers le presse-papiers

  Cette commande copie une citation BibTeX vers le presse-papiers pour être collée dans un document LaTeX.

Collection → Bibliographie → Citer l'entrée dans LyX

  Cette commande envoie une citation pour les entrées sélectionnées vers lyxpipe pour servir dans LyX, Kile ou d'autres applications LaTeX. Celle-ci est activée seulement lors de l'édition d'une bibliographie.

### Le menu Configuration

Configuration → Barre d'outils affichées

  Cette commande permute l'affichage des barres d'outils.

Configuration → Afficher la barre d'état

  Cette commande permute l'affichage de la barre d'état.

Configuration → Afficher la vue par groupe

  Cette commande permute l'affichage de la Vue par groupe.

Configuration → Afficher l'éditeur d'entrée

  Cette commande permute l'affichage de l'éditeur d'entrée.

Configuration → Options de regroupement

  Cette commande modifie le champ utilisé pour grouper les entrées de la collection.

Configuration → Configurer les raccourcis clavier...

  Cette commande ouvre la boîte de dialogue de Configuration des raccourcis clavier de KDE.

Configuration → Configurer les barre d'outils...

  Cette commande ouvre la boîte de dialogue de Configuration de la barre d'outils de KDE.

Configuration → Configurer Tellico...

  Cette commande ouvre la boîte de dialogue de Configuration de Tellico.

### Le menu Aide

Voici les éléments standards du menu Aide de KDE :

Aide → Manuel utilisateur de Tellico (F1)

  Exécute le système d'aide de KDE en commençant par les pages d'aide de Tellico (ce document).

Aide → Qu'est-ce que c'est ? (Maj+F1)

  Change le curseur de la souris en une combinaison flèche et point d'interrogation (?). Cliquer sur des éléments dans Tellico ouvrira une fenêtre d'aide (s'il en existe une pour cet élément particulier), expliquant la fonction de l'élément en question.

Aide → Rapport de bogue...

  Ouvre une boîte de dialogue de rapport de bogue où vous pouvez signaler un bogue ou effectuer une requête de fonctionnalité sous la forme d'une liste de souhaits (« wishlist »).

Aide → À propos de Tellico

  Affiche des informations sur la version et sur l'auteur.

Aide → À propos de KDE

  Affiche la version de KDE et d'autres informations de base.

En plus des éléments standards du menu Aide de KDE, décris ci-dessus, Tellico propose une entrée supplémentaire :

Aide → Astuce du jour

  Cette commande ouvre la boîte de dialogue des astuces du jour. Vous pouvez consulter toutes les astuces en utilisant les boutons de la boîte de dialogue.

Chapitre 10. Remerciements et licence
Remerciements et licence

# Chapitre 10. Remerciements et licence

Tellico

Programme sous copyright 2001-2011 Robby Stephenson `(robby AT periapsis.org)`

Documentation sous copyright 2001-2011 Robby Stephenson `(robby AT periapsis.org)`

Traduction française par Stanislas Zeller `(uncensored.assault AT gmail.com)` et Pierre Buard `(pierre.buard AT gmail.com)` ; relecture par Pierre Buard `(pierre.buard AT gmail.com)`.

Ce programme est soumis aux termes de la Licence Générale Publique GNU (GNU General Public License).

Cette documentation est soumise aux termes de la Licence de Documentation Libre GNU (GNU Free Documentation License).

L'auteur de cette documentation vous permet aussi d'utiliser ce contenu sous les termes de la Licence de documentation FreeBSD, si vous le choisissez. Si vous souhaitez seulement permettre l'utilisation de votre version de ce contenu sous les termes de la Licence de documentation FreeBSD, et ne pas autoriser les autres à utiliser votre version de ce fichier sous les termes de la GFDL, indiquez votre décision en supprimant la mention GFDL et en la replaçant par la mention et les autres clauses requises par la Licence de documentation FreeBSD. Si vous ne supprimez pas la mention GFDL ci-dessus, un bénéficiaire peut utiliser votre version de ce fichier sous les termes de la GFDL ou la Licence de documentation FreeBSD.

Annexe A. Installation
Installation

# Annexe A. Installation

## Comment obtenir Tellico

Le site web de Tellico est à l'adresse http://tellico-project.org. Vous y trouverez les mises à jour et son actualité.

Compilation et installation
Compilation et installation

## Compilation et installation

Pour des informations détaillées sur comment compiler et installer les applications KDE, consultez la page Construire et Lancer KDE à partir des sources

Étant donné que KDE utilise cmake, vous ne devriez pas rencontrer de problèmes pour le compiler. Si c'est le cas, veuillez les signaler aux listes de discussions de KDE.