# Détails de &appname;

## Types de champs

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.

### Texte simple

Le type de champ de base est appelé Texte Simple. Aucune restrictions ne s'applique aux valeurs, et l'élément d'édition est une simple ligne. Ce type convient aux champs destinés à ne pas contenir de long texte, tels que l' auteur ou le genre d'un livre.

### Nombre

Le type Nombre est identique au Texte simple, mais le contenu est restreint aux valeurs numériques. Les entrées seront triées par ordre numérique croissant si l'on clique sur l'en-tête d'un champ de type Nombre. La ligne d'éditions classique est utilisée, avec des flèches pour augmenter ou diminuer la valeur. Aucune mise en forme n'est appliquée.

### &URL;

Le type &URL; permet d'inclure un lien vers un autre document, en utilisant l'association au type de fichier de &kde; pour l'ouvrir. Aucune vérification n'est effectuée sur le contenu d'un champ &URL; ; mais les liens non valides ne sont pas ouverts. L'élément de saisie est une ligne d'édition avec un bouton pour ouvrir la boîte de dialogue standard d'ouverture de fichier ; mais tout type d'&URL; peut être utilisé. Les &URL; relatives sont interprétées par rapport au chemin du fichier de données, une fois qu'il a été enregistré.

Dans l'&entry-editor;, le texte devient un lien ; alors que dans la &entry-view;, un hyperlien classique est utilisé. Ce type de champ convient pour lier à des fichiers PDF pour des entrées bibliographiques ou des critiques de film par exemple. Aucune mise en forme n'est appliquée.

Des &URL; relatives peuvent également être utilisées. Elles sont interprétées par rapport au chemin du fichier de données &appname;. Dans l'&entry-editor;, la ligne d'édition permet l'auto-complétion pour les fichiers locaux. Si vous souhaitez que l"&URL; fournie par le sélecteur de fichiers &kde; soit interprétée de façon relative par rapport au fichier &appname;, ajoutez une propriété étendue pour le champ &URL; avec comme valeurs relative : true.

### Paragraphe

Pour les textes plus longs, le type Paragrapheoffre une zone d'édition plus importante, dans sa propre catégorie. Un champ de type Paragraphe ne peut être à multiples values, ni mis en forme automatiquement. Il ne peut pas être utilisé pour le regroupement. Les résumée, introductions et critiques devraient être saisies dans ce type de champ.

### Choix

Quand un champ doit être limité à quelques valeurs pré-sélectionnées, un champ de type Choix est utilisé. Les valeurs possibles sont présentées dans une liste déroulante. Évidement, le principe des valeurs multiples ne s'applique pas à ce type de champ. Les champs tels que le type de bibliographie ou de notation sont de type Choix.

Des point-virgules doivent être utilisés pour séparer les valeurs possibles.

### Case à cocher

Pour les champs prenant seulement comme valeurs oui ou non, le type Case à cocher est disponible. Par défaut, la case n'est pas cochée. Le champ n'est bien entendu pas mis en forme et est limité à une seule valeur. En interne, les valeurs sont enregistrées en tant que `true` et `false`. Les champs "offert" et "prêté" sont de ce type.

### Date

Un champ de type Date peut inclure jour, mois et année. La date est affichée au format AAAA-MM-JJ, qui permet de les trier facilement. Le sélecteur de date &kde; peut être utilisé pour choisir la date à la souris, ou celle)ci peut être entrée à la main. Les trois champs jour, mois et année peuvent être vide. Il n'est bien sûr pas possible d'avoir des valeurs multiples.

### Tableau

Les champs de type Tableau contienent une ou plusieurs colonnes de valeurs. Dans l'&entry-editor;, le champ se présente comme un tableur avec des lignes numérotées. Lorsque la dernière ligne est sélectionnée, une ligne supplémentaire est ajoutée. L'auto-complétion n'est pas disponible. Ce champ est utile pour la liste des chapitres d'un livre, des scènes d'un livre ou des titres d'un album. Les champs de type Tableau sont toujours dans leur propre catégorie.

Le nombre de colonnes, un maximum de dix, est défini en ajoutant une propriété à la définition du champ avec le nom columns. Il est possible de leur attribuer un titre en cliquant du bouton droit sur l'en-tête, ou en ajoutant une propriété au champ de type column1, etc.

Lors de l'utilisation de l'&entry-editor; pour les champs de type Tableau, les lignes peuvent être réordonnées en les déplaçant avec la souris tout en maintenant le bouton &Ctrl;. Un menu est également disponible en cliquant du bouton droit sur le tableau, qui permet d'insérer ou supprimer des lignes.

### Image

Un champ de type Image contient une image, dans un format reconnu par &kde;, tel que PNG ou JPEG. L'image peut être enregistrée dans le fichier de données &appname; lui-même ou dans le répertoire de données de l'application. Le sélecteur de fichiers &kde; est utilisé, donc vous pouvez utiliser une &URL; ou un fichier local. Les images peuvent également être glissée depuis un gestionnaire de fichiers ou un navigateur.

### Note

Les champs de type Note affichent un nombre d'étoiles représentant la note numérique d'une entrée. Par défaut, la note maximale est cinq. Le minimum et le maximum peuvent être configurées dans la &fields-dialog;, en ajoutant les propriétés minimum et maximum.

### Dépendant

Le dernier type de champ est le type Dépendant, que vous n'utiliserez probablement pas souvent. Il est utilisé pour combiner les valeurs d'autres champs en utilisant les valeurs des descriptions de champs. Par exemple, si un champ de type Dépendant a comme description `%{title} %{year}`, la valeur de ce champ sera le titre suivi de l'année. Ce type de champ est principalement pour le titre dans les collections de monnaies, timbres, cartes et vins. Le nom interne ou le titre de champ peut être utilisé dans la description pour la mise en forme.

## Types de collections

&appname; gère onwe types de collections par défaut : livres, entrées bibliographiques, bandes dessinées, vidéos, musique, jeux vidéo, cartes, monnaie, timbres, vins; jeux de plateau et catalogues de fichiers. De plus, un modèle de collection générique est disponible pour tout autre type d'objet à collectionner. Les collections sont uniquement présentes pour inclure un jeu de champs, vous pouvez en ajouter, modifier et effacer pour l'adapter à vos besoins. La seule obligation est qu'une collection doit toujours avoir un champ Titre, pour que la &group-view; puisse fonctionner correctement. Pour certains types de collections, il s'agit seulement d'un champ Dépendant combinant les valeurs d'autres champs.

Il n'y a pas de différence fonctionnelle entre les types de collections. Vous pourriez créer une collection personnalisée pour vos livres aussi facilement qu'en utilisant la collection de livres par défaut. Cependant, &appname; choisit les icônes en en fonction du type de collection et certaines fonctionnalités peuvent être spécifiques à certaines collections ; donc si vous le pouvez, il est recommandé d'utiliser les types par défaut. Par exemple, si vous souhaitez créer une collection de vins mais n'aimez pas les champs par défaut, créez une collection par défaut et modifiez les champs. De cette façon, &appname; sait qu'il s'agit d'une collection de vins.

### Collections de livres

Les collections de livres ont 26 champs par défaut. Titre, Sous-titre, Auteur, Reliure, Date d'achat, Prix d'achat, Éditeur, Édition, Année du copyright, Année de publication, ISBN#, LCCN#, Pages, Langue, Genre, Mots clef, Série, Numéro, État, Signé, Lu, Offert, Prêté, Note, Couverture, et Commentaires.

Le champ ISBN# est spécial, les numéros ISBN étant automatiquement mis en forme et leur chiffre de vérification calculé. &appname; reconnaît un champ ISBN si son nom interne est isbn. Si vous l'effacez ou souhaitez l'ajouter à un autre type de collection, créez un champ avec comme titre ISBN, appliquez la modification, puis donnez-lui le titre désiré. &appname; crée le nom interne en fonction du titre initial ; mais ne le met pas à jour en cas de changement.

### Bibliographies

Les Bibliographies ont 22 champs par défaut. Titre, Type d'entrée, Auteur, Clef BibTeX, Titre du livre, Éditeur, Organisation, Publié par, Adresse, Édition, Pages, Année, Journal, Mois, Numéro, Publié, Chapitre, Série, Volume, Référence croisée, et Notes.

Bien que les collections bibliographiques ne soient pas spécifiquement liées à BibTeX, les champs par défaut sont ceux habituellement trouvés dans BibTeX. Lors de l'export au format 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 supplémentaire et souhaitez le voir exporté vers BibTeX, assurez-vous qu'il dispose bien de la propriété étendue bibtex.

&appname; dispose de certaines fonctions spécifiques aux bibliographies. Des macros BibTeX peuvent être ajoutées, modifiées ou effacées depuis &appname; ; et l'export au format BibTeX vous donne la possibilité d'appliques les macros. Les citations BibTeX peuvent être transmises à une application externe telle que LyX ou Kile, à l'aide de ce qu'on appelle des lyxpipe.

Les collections de livres peuvent être converties en bibliographies. Les champs liés à BibTeX sont alors ajoutés, et les propriétés étendues configurées. Cette fonctionnalité existe principalement pour convertir les anciennes collections, avant que le type "bibliographie" soit séparé de celui "collection de livres.

### Collections de bandes dessinées

Les collections de bandes dessinées ont 22 champs par défaut. Titre, Sous-titre, Auteur, Artiste, Collection, Numéro, Éditeur, Édition, Année de publication, Pages, Pays, Langue, Genre, Mots clef, État, Date d'achat, Prix d'achat, Signé, Offert, Prêté, Couverture, et Commentaires.

### Collections de vidéos

Les collections de vidéos ont 30 champs par défaut. Titre, Support, Année de production, Certification, Genre, Région, Nationalité, Format, Acteurs, Réalisateur, Producteur, Auteur, Compositeur, Studio, Langues disponibles, Langues des sous-titres, Plages audio, Durée, Format, Écran large, Couleurs, Version du réalisateur, Trame, Note personnelle, Date d'achat, Prix d'achat, Offert, Prêté, Jaquette, et Commentaires.

Le champ Acteurs est un table à deux colonnes, avec en principe le nom de l'acteur dans la première colonne et son rôle dans la seconde. La Durée est supposée être en minutes ; mais vous pouvez bien entendu changer cela.

### Collections musicales

Les collections musicales ont 15 champs par défaut. Titre, Support, Artiste, Label, Année, Genre, Pistes, Note, Date d'achat, Prix d'achat, Offert, Prêté, Mots clef, Jaquette, et Commentaires.

### Collections de jeux

Les collections de jeux vidéos ont 16 champs par défaut. Titre, Plateforme, Genre, Année de parution, Éditeur, Développeur, ESRB Rating, Description, Note personnelle, Terminé, Date d'achat, Prix d'achat, Offert, Prêté, Couverture, et Commentaires.

### Collections de cartes

Les collections de cartes ont 17 champs par défaut. Titre, Joueur, Équipe, Marque, Numéro de carte, Année, Séries, Type de carte, Date d'achat, Prix d'achat, Lieu, Offert, Mots clef, Quantité, Image recto, Image verso, et Commentaires.

### Collections de monnaie

Les collections de monnaie ont 16 champs par défaut. Titre, Type, Dénomination, Année, Mint Mark, Pays, Coin Set, Grade, Grading Service, Purchase Date, Purchase Price, Location, Offert, Obverse, Reverse, et Commentaires.

### Collections de timbres

Les collections de timbres ont 1_ champs par défaut. Titre, Description, Dénomination, Pays, Année d'emission, Couleur, Scott#, Grade, Annulé, Hinged, Centrage, Gommé, Date d'achat, Prix d'achat, Lieu, Offert, Image, et Commentaires.

### Collections de vins

Les collections de vins ont 15 champs par défaut. Titre, Producteur, Appellation, Variété, Type, Pays, Date d'achat, Prix d'achat, Lieu, Quantité, Bu par, Note, Offert, Étiquette, et Commentaires.

### Collections de jeux plateau

Les collections de jeux de plateau ont 15 champs par défaut. Titre, Genre, Mécanisme, Année de parution, Éditeur, Créateur, Nombre de joueurs, Description, Note personnelle, Date d'achat, Prix d'achat, Offert, Prêté, Couverture, et Commentaires.

### Catalogues de fichiers

Les catalogues de fichiers ont 13 champs par défaut. Nom, URL, Description, Volume, Type mime, Taille, Permissions, Propriétaire, Groupe, Date de création, Date de modification, Autres informations, et Icône,

### Collections personnalisées

Les collections personnalisées ont un champ par défaut, le Titre. Elle sont prévues pour pouvoir être utilisées lorsque aucun type par défaut ne convient.