# Utiliser &appname;

## Premiers pas

Par défaut, &appname; 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

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.

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

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

La Vue par filtre
La Vue par filtre

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

La Vue des prêts
La Vue 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 &appname;. 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

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.

L'éditeur d'entrée
L'éditeur d'entrée

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.

L'éditeur d'entrée pour les champs Image
L'éditeur d'entrée pour les champs Image

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.

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 &appname; significativement et augmenter la taille du fichier de données. Pour cela, &appname; 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.

L'éditeur d'entrée pour les champs Tableau
L'éditeur d'entrée pour les champs Tableau

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

L'éditeur d'entrée pour plusieurs entrées
L'éditeur d'entrée pour plusieurs 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

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.

La boîte de dialogue de &appname; pour les Champs de la collection
La boîte de dialogue de &appname; pour les Champs de la collection

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

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

&appname; 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.

#### 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é, &appname; 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. &appname; 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 &appname; mettra de temps à charger le fichier.

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

La boîte de dialogue du filtre avancé de &appname;
La boîte de dialogue du filtre avancé de &appname;

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

&appname; 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 &appname; 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;.

La boîte de dialogue Rapport de &appname;
La boîte de dialogue Rapport de &appname;

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

&appname; 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 &appname; 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.

La Fenêtre des prêts de &appname;
La Fenêtre des prêts de &appname;

## Astuces générales

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

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.

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.

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.

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

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.

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.

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

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.

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

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

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

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

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, &pex; 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.