# Utiliser &appname;

## Démarrage rapide

Par défaut, &appname; démarre avec une collection de livres vide. Pour travailler avec un autre type de collection, créez-la en utilisant le menu Fichier Nouveau, ou le bouton dans la barre d'outils. Les collections sont remplies avec certains des champs les plus communs ; mais vous pouvez en ajouter, enlever ou les modifier selon vos besoins.

Les nouvelles entrées peuvent être ajoutées en utilisant l'&entry-editor;. Le menu Collection Nouvelle entrée ouvre l'&entry-editor; avec une entrée vide pour la compléter. L'&entry-editor; peut également être ouvert en utilisant le menu Paramètres Afficher l'&entry-editor;. Une fois que vous avez entré les valeurs pour une entrée, vous pouvez les inclure à la collection en cliquant sur Enregistrer l'entrée dans la boite de dialogue de l'&entry-editor;, qui reste ouverte dans le cas où vous souhaiteriez ajouter de nouvelles entrées. Une fois que vous avez enregistré une entrée dans la collection, vous pouvez la modifier en cliquant dessus dans la fenêtre principale. Si l'&entry-editor; n'est pas déjà ouvert, vous pouvez double-cliquer sur une entrée pour ouvrir l'éditeur et la modifier.

Si vous souhaitez inclure une image avec une entrée, vous pouvez utiliser le sélecteur de fichiers standard &kde; en cliquant sur le bouton Sélectionner une image... dans l'&entry-editor;, ou vous pouvez déplacer une image depuis le gestionnaire de fichiers ou le navigateur internet dans l'&entry-editor;.

Quand vous sélectionnez une entrée, la &entry-view; affiche une vue mise en forme du contenu de l'entrée. Vous pouvez modifier le modèle utilisé pour afficher l'entrée dans la &config-dialog;.

Les entrées d'une collection sont groupées ensemble lorsqu'elles ont la même valeur dans certains champs, tels que l'auteur ou le réalisateur. Vous pouvez modifier le champ utilisé pour grouper en utilisant le menu déroulant dans la barre d'outils ou dans le menu Configuration Options de regroupement.

Vous pouvez utiliser le &quick-filter; dans la barre d'outils pour limiter rapidement le nombre d'entrées visibles à celles contenant le mot que vous y entrez. Ce filtre est également utile quand vous souhaitez trouver rapidement une entrée. Vous pouvez y entrer le titre ou une autre mot unique qui identifie l'entrée et la &detailed-view; affichera uniquement les entrées correspondant au filtre. La barre d'état indique combien d'entrées existent dans la collection, et combien sont actuellement filtrées.

## Utilisation générale

La fenêtre principale a trois parties distinctes ; chacune affichant des informations sur la collection de manière différente. La partie principale est la &detailed-view; dans la partie supérieure droite ; où les valeurs tous les champs de chaque entrée peuvent être affichées. Dans la partie gauche, la &group-view; peut être utilisée pour afficher les entrées sous forme de groupes dans une arborescence. La &filter-view; permet de ne voir que les entrées répondant à certains critères. La &loan-view; affiche les entrées prêtées. Enfin, la &entry-view; affiche les données d'une entrée mises en forme, ou une vue par icônes d'un groupe d'entrées, dans la partie inférieure droite.

La fenêtre principale de &appname;
La fenêtre principale de &appname;

### &detailed-view;

Tous les champs d'une collection peuvent être affichés dans la &detailed-view; ; bien que les champs de type Paragraphe, Image et Table ne soient probablement pas utiles. Cliquer du bouton droit sur l'en-tête affiche un menu permettant de choisir les champs visibles. Les colonnes peuvent être dimensionnées et réordonnées ; et les paramètres sont conservés d'une session à l'autre.

### &group-view;

La &group-view; rassemble les les entrées dans une arborescence selon un champ permettant le regroupement. Le nombre d'entrées dans chaque groupe peut être affiché à coté de son nom en changeant une option dans la &config-dialog;. Les groupes peuvent être développés en cliquant sur le signe plus, ou en double-cliquant sur le groupe. Développer ou refermer tous les groupes sont des options dans le menu contextuel du clic droit. L'arbre peut être trié, soit par nom de groupe, soit par nombre d'entrées, en cliquant du bouton droit sur un groupe. Un groupe peut également être utilisé en tant que filtre pour la &detailed-view; en cliquant du bouton droit sur le groupe.

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

Si une entrés ne contient pas de valeur pour le champ utilisé pour former les groupes, celle-ci est placées dans le groupe (Vide), qui utilise un répertoire rouge.

### &filter-view;

Si des filtres ont été enregistrés pour la collection, la &filter-view; devient active. Au fur et à mesure que vous ajoutez et modifiez des entrées, celles-ci seront automatiquement vérifiées par les filtres et ajoutées ou enlevées en fonction des résultats. Le filtre peut être modifié en double-cliquant dessus pour ouvrir la &filter-dialog;. Un clic du bouton droit dessus vous permet également de le supprimer complètement.

La &filter-view;
La &filter-view;

### &loan-view;

Une fois que des entrées ont été marquées comme prêtées, la &loan-view; est ajoutée à la fenêtre, pour que les entrées empruntées puissent être suivies. Ceci est fait individuellement pour chaque entrée. Cliquer du bouton droit sur une entrée propose une option pour modifier le prêt avec la &loan-dialog;.

La &loan-view;
La &loan-view;

### &entry-view;

Une représentation mise en forme des valeurs de l'entrée sélectionnée est affichée dans la &entry-view;. Des modèles sont utilisés pour le format d'affichage et les images supplémentaires. Des modèles différents pour chaque type de collection peuvent être spécifiés dans la &config-dialog;. Les modèles par défaut affichent les champs de type &URL; actifs, qui s'ouvrent avec l'association de fichier par défaut de &kde; Lors des exports en &html;, le modèle courant est utilisé pour exporter les fichiers d'entrées individuels.

De plus, lorsque plusieurs entrées sont sélectionnées, une vue par icônes des entrées est affichée, en utilisant le premier champ de type Image de la collection. Les entrées peuvent être sélectionnées dans la &detailed-view;. Un clic droit sur la vue par icônes affiche un menu qui permet de changer les critères de tri des entrées.

### Barre d'état

La barre d'état est utilisée pour indiquer ce que &appname; est en train de faire. Elle contient également le nombre total d'entrées dans la collection ; et si un filtre est utilisé, combien sont visibles.

## Modifier des entrées

L'&entry-editor; est utilisé pour ajouter et modifier des entrées dans la collection. Double-cliquer sur une entrée dans la &group-view; ou la &detailed-view; ouvre l'&entry-editor; avec cette entrée. De nouvelles entrées peuvent être créées par le menu Collection, l'icône de la barre d'outils, ou le bouton dans l'&entry-editor;.

Fermer l'&entry-editor; alors que des changements n'ont pas été enregistrés provoque l'affichage d'un message. Les champs sont regroupés par catégorie et apparaissent suivant l'ordre dans lequel ils sont classés dans la &fields-dialog;. Ils peuvent donc également être réordonnées.

L'&entry-editor;
L'&entry-editor;

Cliquer sur le champ du titre d'une &URL; ouvre le lien en fonction du type de fichier défini dans &kde;. Le bouton sélecteur d'&URL; à côté de l'entrée de texte ouvre la boite de dialogue de fichier &kde; par défaut ; mais le champ n'est pas limité aux fichiers locaux. Tout type d'&URL; peut être entré. Les &URL; relatives ne sont pas gérées pour le moment, la valeur étant interprétée par rapport à l'endroit où se trouve la feuille de style du modèle.

Pour les champs de type Image, le bouton Sélectionner l'image... ouvre la boite de dialogue de sélection d'image &kde;. L'image est enregistrée dans la collection dans son format d'origine, et une version mise à l'échelle est affichée dans l'&entry-editor;. L'image peut être effacée avec le bouton Effacer. Les images effacées sont retirées de la collection.

L'&entry-editor; pour les champs de type Image
L'&entry-editor; pour les champs de type Image

L'éditeur gère également le glisser-déposer. Déplacer une image depuis une fenêtre &konqueror; aura le même effet que de la choisir à l'aide du sélecteur de fichiers. Glisser une image depuis l'éditeur vers une fenêtre &konqueror; enregistrera l'image dans le répertoire.

Par défaut, les images sont enregistrées dans le fichier de données de la collection, conservant ainsi toutes les données au même endroit. Cependant, un trop grand nombre d'images ralentira &appname; et générera des fichiers de taille importante. Cependant, &appname; peut également enregistrer les images séparément, soit dans le répertoire `$`KDEHOME`/share/apps/tellico/data/`, soit dans un répertoire au même endroit que le fichier de données Tellico. Dans ce cas, le chargement et l'enregistrement des fichiers de données est nettement plus rapide ; mais les fichiers de données ne peuvent alors plus être transférés ou sauvegardés sans perdre les images. Des fichiers autonomes (contenant les images) peuvent toujours être créés en utilisant le menu Fichier Exporter Exporter au format Zip....

Les champs de type Tableau sont initialement créés avec 5 lignes ; mais déplacer le curseur jusqu'à la dernière ligne en ajoutera une autre. Dans les tableaux à é colonnes, seule la première est utilisée pour le regroupement ou la mise en forme.

L'&entry-editor; pour les champs de type Tableau
L'&entry-editor; pour les champs de type Tableau

### Editer plusieurs Entrées

Plusieurs entrées peuvent être modifiées en même temps, en les sélectionnant dans la &group-view; ou la &detailed-view;. Si plusieurs entrées sont sélectionnées, les champs contenant la même valeur sont actifs. Dans les cas contraire, ils sont désactivés. Une case à cocher est ajoutée à droite de chaque champ, permettant de contrôler si le champ est actif ou non.

Seuls les champs actifs seront modifiés à la sauvegarde des entrées, ce qui rend la modification de nombreuses entrées plus simple. Par exemple, pour changer le type de medium dans une collection de vidéos, éditez les entrées simultanément, cochez la case pour activer le champ Medium, entrez la valeur DVD, et enregistrez les entrées. Seul le champ Medium a été modifié, préservant les valeurs originales de tous les autres champs.

L'&entry-editor; pour plusieurs entrées
L'&entry-editor; pour plusieurs entrées

### Mettre à jour les données d'une entrée

Les entrées peuvent être automatiquement mises à jour par des requêtes aux sources de données disponibles pour le type de collection en cours. Ceci peut être très utile pour combiner les informations de plusieurs sources. Par exemple, vous pouvez vouloir ajouter un film à votre collection avec les services web Amazon.com, puis mettre à jour l'entrée avec des informations supplémentaires en provenance de IMDb.

Seuls les champs vides sont mis à jour ! Si vous voulez mettre à jour la liste des acteurs d'un film, effacez les données avant de mettre à jour. Pour les scripts externes, un champ mis à jour peut être spécifié dans les options de la source.

La mise à jour d'entrée peut être démarrée via un clic droit pour une entrée, ou en utilisant le menu Collection Mettre à jour l"entrée.

## Editer les champs

La &fields-dialog; vous permet d'ajouter de nouveaux champs à la collection, de modifier ceux existant ou en effacer.

La &fields-dialog; de &appname;
La &fields-dialog; de &appname;

### Liste des champs

Sur le côté gauche de la boîte de dialogue se trouve la liste des champs. Ceux qui ont été modifiés apparaissent en gras et italique. Les boutons sous la liste permettent d'ajouter ou de supprimer des champs, et les flèches de changer leur ordre. L'ordre des champs dans la liste est important, puisqu'il est utilisé par l'&entry-editor; pour leur affichage. Pour chaque catégorie, les champs sont disposés de gauche à droite, en fonction de l'ordre (de haut en bas) dans lequel ils apparaissent dans la liste.

### Propriétés des champs

Un champ est défini par ses titre, type, catégorie, description et éventuellement d'autres valeurs autorisées. Le titre est utilisé partout pour référer au champ dans l'interface utilisateur. L'&entry-editor; l'utilise pour l'affichage de valeurs. La &detailed-view; l'utilise en tant qu'en-tête de colonnes. Les différents types de champs sont détaillés dans la section Types de champs. La description est utilisée en dans une bulle d'information dans l'&entry-editor;, pour fournir des explications complémentaires sur le contenu du champ. De plus pour les champs de type Dépendant, la description est utilisée pour mettre en forme la valeur du champ. Les valeurs possibles pour un champ de type Choix doivent être séparées par des point-virgule.

Les nouveaux champs peuvent être de n'importe quel type ; mais la modification du type de champs existant est limitée à ceux compatibles, tels qu'indiqués dans le tableau suivant :

#### Changements de type de champ autorisés

Type d'origine | Nouveaux types possibles
--- | ---
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
Dependant | Dependant

### Mise en forme des champs

&appname; propose la possibilité de mettre en forme automatiquement la valeur de certains champs. La plis simple mise en forme est la mise en majuscules automatique, qui met en majuscule la première lettre de chaque mot, à l'exception des articles. La mise en forme des titres déplace certains articles du début à la fin du champ. Par exemple "Le Retour du Roi" devient "Retour du Roi, Le". Les articles apparaissant dans les titres sont configurables. Enfin, la mise en forme des noms essaie de décomposer le texte, de manière à afficher le nom de famille en premier. Les différentes particules ou attributs sont configurables. De plus, le groupe spécial Personnes utilise tous les champs mis en forme en tant que noms, même si le paramètre global est désactivé.

Toute mise en forme automatique peut être désactivée en modifiant les options générales dans la &config-dialog;. Généralement, la mise en majuscules est une opération distincte de la mise en forme ; donc un titre peut être automatiquement mis en fome sans activer la mise en majuscules. Tous les champs ne permettent pas la mise en forme automatique.

#### Exemples de mise en forme

Type de mise en forme | Valeur du champ | Majuscules automatiques | Mise en forme automatique | Majuscules et mise en fome 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érales. Si l'auto-complétion est activée, &appname; conserve en mémoire les valeurs de chaque champ et l'&entry-editor; propose de compléter automatiquement les mots, suivant les paramètres standard de &kde;. Tous les champs ne permettent pas l'auto-complétion. &appname; doit également savoir si un champ peut avoir des valeurs multiples ou s'il peut être utilisé pour regrouper les entrées. Un point-virgule est utilisé pour différencier les valeurs multiples lors de l'édition d'une entrée.

Pour des raisons d'efficacité, n'activez pas l'auto-complétion, sauf si vous en avez besoin pour les champs. Plus il y a de champs avec l'auto-complétion activée dans une collection, plus &appname; est lent à charger le fichier.

## Filtrer les entrées

La &filter-dialog; permet de limiter les entrées visibles dans la &detailed-view; à celles respectant une ou plusieurs règles de filtrage. Le filtre peut être utilisé pour trouver les entrées respectant toutes les règles de la boite de dialogue, ou celles en respectant au moins une.

La &filter-dialog; de &appname;
La &filter-dialog; de &appname;

Chaque ligne contient une seule règle de filtrage. Sélectionner un champ à vérifier dans la première boite de la ligne, puis une règle de filtrage dans celle du centre. Les règles permettent de chercher des valeurs contenant un certain mot ou sont exactement identiques. Une expression régulière peut également être utilisée pour filtrer les entrées, auquel cas le bouton Éditer... devient actif pour modifier l'expression. Enfin, le mot ou la chaîne de caractères doit être entré dans la boite de texte.

Jusqu'à huit (8) règles peuvent être utilisées dans le filtre. Les boutons Plus et Moins peuvent être utilisés pour ajouter ou enlever des règles.

Pour trouver les livres de science fiction que vous n'avez pas lu, validez le bouton Vérifier toutes les règles, configurez la première règle sur Genre contenant science fiction, et la seconde sur Read ne contient pas true. Read ne contenant pas true. (Pour les champs de type Case à cocher, la valeur interne est true).

Pour trouver les livres écrits par Bujold et Weber, validez le bouton Vérifie une des règles, configurez la première règle sur Auteur contenant Bujold, et la seconde sur Auteur contenant Weber.

## Generating Reports

&appname; peut générer divers rapports concernant votre collection. La &report-dialog; vérifie les modèles &xslt; dans le répertoire d'installation ainsi que dans `$`KDEHOME`/share/apps/tellico/report-templates/`. Vous pouvez ainsi en créer de nouveaux, qui seront automatiquement inclus sous forme d'options dans la &report-dialog;. Certains rapports complexes peuvent nécessiter un certain temps pour leur génération.

Les modèles installés avec &appname; incluent seulement une liste des titres, la vue en colonne, une vue de groupe, une résumé des groupes et des valeurs les plus présentes dans ces groupes, un rapport de prêts, et un rapport plus complet contenant les images. Sélectionnez le modèle désiré et cliquez sur le bouton Générer. Tout rapport peut également être imprimé ou enregistré dans un fichier &html;.

La &report-dialog; &appname;
La &report-dialog; &appname;

Les entrées incluses dans le rapport seront limitées à celles de la &detailed-view; ; donc si vous avez un filtre activé, la &report-dialog; l'utilisera.

## Gestion des prêts

&appname; gère les prêts d'entrées de la collection. La &loan-dialog; peut être ouverte en utilisant le menu Prêter, ou en cliquant du bouton droit sur une entrée. Plusieurs entrées peuvent être prêtées en une seule opération.

Le nom des personnes empruntant peut être entré directement, ou être extrait du carnet d'adresses par défaut de &kde; en cliquant sur le bouton à côté du champ "Nom". La date du prêt est par défaut celle du jour courant ; mais peut être modifiée. La date de retour dû est optionnelle, et d'autres notes peuvent être ajoutées à propos du prêt.

Si une date de retour dû est entrée, et si &appname; a été compilé avec la gestion de la libkcal, une alarme peut être ajoutée au calendrier par défaut de &kde; en tant qu'item "à faire". &korganizer; peut être utilisé pour voir ces entrées.

Lorsqu'une entrée est prêtée, la valeur du champ Prêté est mise à la valeur true. Si aucun autre champ "Prêté" n'existe dans la collection, celui-ci est ajouté. Ne modifiez pas ce champ manuellement ! Les entrées prêtées peuvent être marquées comme rendus en utilisant le menu ou en cliquant du bouton droit sur une entrée dans la &loan-view;.

La &loan-dialog; &appname;
La &loan-dialog; &appname;

## Astuces générales

Ceci est la liste des astuces contenues dans les "astuces du jour de &appname;.

Si un livre a plus d'un auteur, les noms doivent être séparés par des point-virgule, afin que &appname; puisse les dissocier et les utiliser séparément. Tous les autres champs permettant d'avoir plusieurs valeurs doivent être saisis de la même manière.

Vous pouvez choisir quels champs doivent être affichés dans la vue en liste en cliquant du bouton droit sur l'en-tête des colonnes.

Vous pouvez ajouter ou modifier les champs de la collection avec la &fields-dialog;. Les boutons avec des flèches sous la liste peuvent être utilisés pour changer la position dans la liste, ce qui affecte le positionnement dans l'&entry-editor;.

Si vous souhaitez filtrer selon un champ Case à cocher, la valeur "true" doit être utilisée. Si vous voulez afficher uniquement les films de science fiction que vous n'avez pas lus, par exemple, cochez la case Vérifie tout, configurez la première règle en tant que "Genre" "contient" "Science Fiction" (sans guillemets) et la seconde règle en tant que "Lu" "ne contient pas" "true" (sans guillemets).

Si un caractère non alphabétique est utilisé dans le filtre rapide, le texte est interprété en tant qu'expression régulière. Pour afficher uniquement les livres de Weber ou Bujold par exemple, entrez "weber|bujold" (sans guillemets) dans la boîte de filtre.

Vous pouvez modifier plus d'une entrée à la fois, en gardant appuyée la touche Maj ou Control et en sélectionnant plusieurs entrées.

Vous pouvez convertir une collection de livres en bibliographie, qui peut alors être exportée au format BibTeX ou BibTeXML.

Si plus d'un champ est mis en forme en tant que nom, un group supplémentaire appelé "Personnes" est ajouté à la collection, permettant ainsi aux auteurs et éditeurs d'être affichés ensemble, par exemple.

Vous pouvez modifier l'apparence des données affichées en modifiant le fichier `tellico-printing.xsl`. Le fichier génère du &html; ; et le &css; contenu dans la feuille de style détermine les aspects tels que les polices, marges, etc.

Double-cliquer sur une entrée ouvre l'&entry-editor;.

Vous pouvez ajouter des tags &html; aux champs de type paragraphe pour la mise en forme, tels que <b>bold</b> (gras) ou <i>italic</i> (italique).

Dans la &detailed-view;, vous pouvez presser une lettre au clavier pour aller directement you can press a letter on the keyboard to skip to the next entry that starts with that letter.

Vous pouvez utiliser les champs dépendant pour combiner plusieurs champs dans un seul. Sélectionez le type dépendant pour le champ et entrez une description similaire à "`Value: %{fielda}%{fieldb}`" en remplaçant le contenu de %{...} par le nom de champ approprié. Ceci est utile pour regrouper plusieurs valeurs dans un seul champ ; par exemple pour un meilleur regroupement ou combiner différents champs tout en respectant les critères de tri. Considérez par éxemple un champ numérique suivi par un champ de text avec des entrées 3b et 14a.