# Le guide &appname;

## Introduction

### &appname;

&appname; 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, musique, monnaies, timbres, cartes, jeux vidéo, vins, jeux de plateau et fichiers. De plus, des collections personnalisées peuvent être créées pour tout ce qui peut être collectionné.

#### Ce qu'est &appname;

&appname; garde la trace des entrées dans une collection, et propose un moyen simple d'ajouter des information à chaque entrée. Il propose plusieurs types de champs, et permet un nombre illimité de champs définis par l'utilisateur. Les entrées d'une collection peuvent être regroupées selon n'importe quel champ pour une organisation facile, et les vues personnalisables affichent autant d'informations que vous le souhaitez.

Les entrées prêtées peuvent être suivies, avec une intégration possible à &korganizer;. Les collections peuvent être importées ou exportées depuis et vers plusieurs formats, pour permettre un échange et une publication aisés des données.

#### Ce que &appname; n'est pas

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

Enfin, &appname; est un passe-temps pour l'auteur, et il n'est fait aucune garantie concernant ses fonctionnalités, son utilisabilité ou quoi que ce soit d'autre. &appname; est loin d'être un outil logiciel professionnel. Plus d'informations sont disponibles dans la licence.

### Terminologie

#### Collections

Dans &appname;, le document est une collection. Une seule collection peut exister dans chaque fichier &appname;. Une collection contient un nombre non déterminé de champs et d'entrées. &appname; peut gérer douze types de collections génériques par défaut : livres, entrées bibliographiques, bandes dessinées, vidéos, musique, cartes, pièces de monnaie, timbres, jeux vidéos, vins, jeux de plateau et listes de fichiers. En outre, un type de collection générique vide existe pour tout autre type d'objet collectionnable.

#### Champs de collection

Chaque collection peut avoir un nombre illimité de champs. &appname; gère onze types de champs , permettant une large variété de données différentes. Les champs peuvent être modifiés avec la &fields-dialog; et sont expliqués plus en détails dans la section types de champs.

#### Entrées de collection

Une entrée est un enregistrement de base dans &appname;. Chaque entrée contient une valeur pour chaque champ 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.

&appname; 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 &appname; conserve les images séparées du fichier de données lui-même ; soit dans le répertoire de données de l'application, soit dans un répertoire situé relativement au fichier lui-même. Plus d'informations sont disponibles dans la section concernant la configuration.

&fundamentals-chapter; &details-chapter; &importing-exporting-chapter; &advanced-chapter; &configuration-chapter; &menus-chapter; &hacking-chapter; &faqs-chapter;

## Crédits et Licence

&appname;

Program copyright 2001-2006 &robby; &email;

Documentation copyright 2001-2006 &robby; &email;

This documentation is licensed under the terms of the &GNU; Free Documentation License (GFDL).

The author of this documentation has also granted you permission to use the content under the terms of the FreeBSD Documentation License, if you so choose. If you wish to allow use of your version of this content only under the terms of the FreeBSD Documentation License, and not to allow others to use your version of this file under the terms of the GFDL, indicate your decision by deleting the GFDL notice and and replacing it with the notice and other provisions required by the FreeBSD Documentation License. If you do not delete the GFDL notice above, a recipient may use your version of this file under the terms of either the GFDL or the FreeBSD Documentation License.

## Installation

### Comment obtenir &appname;

La page web de &appname; se trouve à &homepage;. Les mises à jour et les nouvelles informations s'y trouvent.

### Pré-requis

Pour pouvoir utiliser &appname;, vous avez besoin de KDE 3.2.x. &appname; nécessite environ 5 mega-octets de mémoire ; mais cela peut varier en fonction de vos platefome, configuration et essentiellement la taille de votre collection.

&kde; peut être trouvé sur le site web de KDE.

Vous pouvez trouver une liste des dernières modifications sur &homepage;.

### Compilation et installation

Pour compiler et installer &appname; sur votre système, entrez les commandes suivantes à la racine de l'archive décompressée, la troisième devant être effectuée en tant que root si vous souhaitez installer dans un répertoire système :

    % ./configure --enable-final --disable-debug
    % make
    % make install

&appname; utilisant autoconf et automake, vous ne devriez pas avoir de problème pour le compiler. Cependant, si vous deviez rencontrer des problèmes, vous pouvez les rapporter à l'auteur à : &email;.

#### Compiller avec OpenOffice.org

&appname; utilise greffon spécial pour communiquer avec OpenOffice.org, qui n'est pas compilé par défaut. Le kit de développement (SDK), disponible à http://www.openoffice.org/dev_docs/source/sdk/, est nécessaire.

    % ./configure --enable-ooo --with-ooo-dir=/usr/lib/openoffice --with-ooo-sdk-dir=/usr/lib/openoffice/SDK

Vous devez utiliser le chemin correct des bibliothèques et du SDK OpenOffice.org, bien sûr.

De plus, certaines distributions peuvent nécessiter que vous modifiiez le fichier `/etc/ld.so.conf` ou ajoutiez un fichier de configuration dans le répertoire `/etc/ld.so.conf.d`. Vérifiez si le greffon OpenOffice.org fonctionne sans changer la configuration d'abord. Si cela ne fonctionne pas, essayez d'ajouter le chemin le chemin d'OpenOffice.org (le même que celui que vous avez utilisé avec le script `configure`. Si vous avez besoin de plus d'aide, utilisez la liste de discussion de &appname;

&documentation.index;