# Manuel de KBiff

## Introduction

### Caractéristiques

KBiff est un utilitaire de notification d'arrivée de courrier pour le projet KDE. Il a plusieurs avantages sur bon nombre de ses concurrents :

- Configuration entièrement par interface graphique. Il n'y a plus de paramètres de ligne de commande à retenir (ou plutôt, certains restent disponibles en option pour faciliter la vie de certains), et plus de fichiers de configuration étranges. Tous les réglages de KBiff peuvent être faits depuis un simple dialogue de paramétrage.

- Gestion de session. KBiff redémarre avec la configuration telle qu'elle était au moment où vous en êtes sorti.

- Placement dans la barre de tâches ("docking"). KBiff peut être placé dans la barre de tâches très facilement. C'est pratique quand vous gérez plusieurs boîtes aux lettres et que vous n'avez plus de place nulle part ailleurs.

- GIFs animés. Vous pouvez utiliser des images GIFs animées comme icônes.

- Sons. Kbiff a une option pour jouer des fichiers .wav quand du courrier arrive.

- POP3, IMAP4, Maildir, MBOX. KBiff supporte les principaux formats de boîtes aux lettres!

- Boîtes aux lettres multiples. KBiff peut gérer plusieurs boîtes aux lettre depuis une même instance du programme.

- Autres. KBiff a des tonnes d'autres options.

Si vous avez des commentaires ou des demandes de nouvelles fonctionnalités, ne vous gènez pas pour me contacter par courrier.

Kurt Granroth

granroth@kde.org

### Améliorations prévues

Il y a certaines caractéristiques que soit je prévois d'ajouter soit au sujet desquelles je m'interroge. Dans le désordre :

- Rajouter des points d'entrée CORBA. Eventuellement implémenter un modèle client/serveur également.

- Gérer les forums de discussion NNTP ? J'attends que quelqu'un me le demande.

## Installation

### Comment se procurer KBiff ?

La version la plus récente en formats source et binaire se trouve toujours sur le site de KBiff, à l'adresse http://www.granroth.org/kbiff. KBiff fait également à présent partie du paquetage réseau "kdenetwork" et donc la version en cours de développement se trouve toujours dans le référentiel CVS de KDE.

### Configuration nécessaire

Pour compiler avec succès KBiff, vous avez besoin au moins de la version 1.0 de KDE. Toutes les librairies nécessaires se trouvent sur ftp://ftp.kde.org/pub/kde.

### Compilation et Installation

Il est très facile de compiler KBiff avec ce qui suit :

    % ./configure
    % make
    % make install

Ca devrait suffire ! En cas de problèmes, veuillez les signaler à l' auteur

## Utilisation de KBiff

Pratiquement toutes les caractéristiques de KBiff peuvent être changées depuis le dialogue de configuration. Les quelques paramètres que KBiff a en ligne de commande sont là essentiellement par souci de commodité, parce que c'est là qu'elles sont utiles.

### Le profil d'utilisation

KBiff est centré autour d'un profil d'utilisation. Un profil est simplement un regroupement d'une ou plusieurs boîtes aux lettres que KBiff va surveiller. Par exemple, il y a toujours un profil par défaut appelé "Inbox" (ou autrement si vous le renommez). Ce profil ne contient qu'une boîte aux lettres, d'ordinaire du type "/var/mail/username". Il pourrait tout aussi bien contenir plusieurs boîtes aux lettres. Chaque instance de KBiff (c'est-à-dire, chaque icône visible) correspond à un profil.

### Les paramètres de ligne de commande

KBiff supporte trois paramètres en ligne de commande. Il s'agit de : profile, debug et secure.

    -profile <nom_du_profil> Sauter le dialogue de
    configuration et démarrer
    			KBiff directement avec le profil passé en argument,
    			par exemple 'kbiff -profile Inbox'
    -debug                  Passer en mode de débogage bavard. A utiliser uniquement
    dans le cas de
    			problèmes avec KBiff
    -secure                 Désactiver le dialogue de configuration. Utile quand
    vous voulez que KBiff tourne
    			mais lorsque vous ne voulez pas que d'autres le modifient.

## Le dialogue de configuration

Le dialogue de configuration gère tous les aspects de la configuration de KBiff. Par conséquent, les paramètres de ligne de commande ne sont presque jamais nécessaires.

### Nom du profil d'utilisation

La partie supérieure du dialogue contient une liste déroulante et trois boutons. La liste déroulante contient les noms de tous les "profils". Un profil d'utilisation est un ensemble de réglages de configuration de boîte aux lettres. Les trois boutons sont intitulés Nouveau, Renommer et Supprimer. Ces boutons ne modifient que les profils, ils ne touchent pas aux boîtes aux lettres elles-mêmes. Quand KBiff est lancé pour la première fois, il n'y a qu'un profil, qui est créé automatiquement. Il s'agit du profil "Inbox" qui surveille la boîte aux lettres système.

### Onglets de configuration

Il y a quatre onglets d'options. Ils permettent de régler un grand nombre d'options relatives au profil courant. Le profil courant est celui qui est affiché dans la liste déroulante. Il n'y a pas de réglages globaux.

#### Général

Les options générales pour chaque profil sont accessibles via cet onglet. On y trouve cinq champs :

##### Intervalle

Ce réglage contrôle combien de temps KBiff attend avant de revérifier la boîte aux lettre. La durée indiquée est en secondes. KBiff attend par défaut 60 secondes (une minute).

Pour savoir quelle durée choisir, il peut être judicieux d'analyser la fréquence à laquelle votre courrier arrive. Si, par exemple, `fetchmail` télécharge le courrier arrivé toutes les cinq minutes, il est inutile de régler la durée sur une valeur inférieure. De la même façon, si vous utilisez la fonctionnalité POP3 ou IMAP4 de KBiff, vous aurez sans doute intérêt à utilisée un intervalle plus espacé. Si vous règlez cette durée sur moind de 60 secondes, vous obtiendrez des résultats décevants si votre connexion réseau est lente.

##### Client de courrier

Ce champ spécifie la commande à exécuter quand vous cliquez sur KBiff avec le bouton gauche de la souris. Bien qu'il s'agisse en général d'un client de courrier, ce n'est pas indispensable. Cela peut être n'importe quelle commande ayant sa propre fenêtre X. Par exemple, si mettre `elm` dans ce champ ne fonctionnera pas, par contre mettre `konsole -e elm` marchera. La valeur par défaut est `kmail -check`

##### Placer sur le tableau de bord

Permet de déterminer si KBiff démarre placé dans le tableau de bord ou non quand l'utilisateur sort du dialogue de configuration. Notez qu'il est possible de basculer dans ou hors du tableau de bord indépendemment de cette option. Elle ne contrôle que l'état initial, et est cochée par défaut.

##### Utiliser la gestion de session

Permet d'activer ou de désactiver la gestion de session KDE. Cette case ne doit être dévalidée que dans de rares cas. Le cas le plus courant où l'on désactive la gestion de session est celui où un utilisateur utilise simultanément KDE sur plusieurs ordinateurs différents. Dans ce cas, il serait sans doute souhaitable de désactiver la gestion de session et d'utiliser l'option de ligne de commande `-profile` à la place.

Dans tous les autres cas, la gestion de session devrait probablement être laissée active.

##### Icônes

KBiff utilise trois icônes pour représenter les trois états : Pas de courrier, Anciens message et Nouveau message. Les icônes proposées sont les "grandes" icônes. Pour en choisir de nouvelles, cliquez sur les boutons et un dialogue de chargement d'icône apparaîtra. Notez que bien que KBiff supporte les images GIF animées, elles n'apparaîtront pas animées ici.

#### Nouveau message

Cet onglet regroupe les options qui traitent de ce qui se passe lorsque du courrier arrive.

##### Exécuter la commande

Il s'agit d'une commande de ligne de commandes qui sera exécutée lorsque du courrier arrive. Un exemple typique serait `play newmail.au`. Cela aurait pour conséquence de faire jouer le son contenu dans le fichier `newmail.au` chaque fois que du courrier arrive. Par défaut, cette option est dévalidée.

##### Lire un fichier son

Cela indique un son à jouer lorsque du courrier arrive. Dans cette version, seuls des fichiers au format .wav peuvent être joués. Indiquez simplement le chemin vers le fichier à jouer. Par défaut, cette option est dévalidée.

##### Bip système

Si cette option est activée, KBiff bipera chaque fois que du courrier arrive. Il s'agit probablement de l'option la moins envahissante, bien que toujours active, de prévenir l'utilisateur de l'arrivée de courrier. Par défaut, cette option est validée.

##### Notifier

Si cette option est activée, KBiff affichera une fenêtre à chaque fois que du courrier arrive. Le message d'avertissement affichera aussi bien la boîte aux lettres concernée que le nombre de messages arrivés. Cette option est déconseillée pour les boîtes aux lettres qui recoivent beaucoup de courrier.

#### Boîte aux lettres

Cet onglet regroupe les options concernant les boîtes aux lettres réelles elles-mêmes.

Toutes les options de cet onglet concernent UNE SEULE boîte aux lettres. Par conséquent, si vous avez trois boîtes aux lettres dans ce profil utilisateur, chaque boîte aux lettres aura ses propres réglages dans cet onglet. Par contre, tous les réglages des autres onglets s'appliquent à l'ensemble du profil utilisateur. Par exemple, si vous avez l'option "Notifier" active dans l'onglet "Nouveau message", alors KBiff vous enverra un message d'avertissement quand du courrier arrive dans l'une quelconque des boîtes aux lettres de ce profil utilisateur.

##### Liste de boîtes aux lettres

La liste déroulante à gauche de l'onglet contient la liste des boîtes aux lettres que le profil courant gère. Dans la plupart des cas, il n'y en aura qu'une (la boîte aux lettres "par défaut"). Néanmoins, vous pouvez gérer autant de boîtes aux lettres par "profil" qu'il vous plaira.

Il y a deux boutons sous la liste déroulante. Le bouton avec une boîte aux lettres dessinée dessus sert à créer une nouvelle boîte aux lettres. Le bouton avec une croix sert à en détruire une. Si vous désirez renommer une boîte aux lettres, vous devez détruire la vieille boîte aux lettres et en créer une nouvelle avec des propriétés identiques.

##### Protocole

Ce champ détermine le protocole utilisé par la boîte aux lettres couramment sélectionnée. Il y a 4 (et demi) protocoles - mbox (Unix style), maildir (Qmail), POP3, et IMAP4. Le protocole 'fichier' peut être utilisé pour gérer tout fichier local car il n'utilise que les dates de dernière lecture et de dernière modification pour déterminer l'état du fichier.

##### Boîte aux lettres

Ce champ n'est pas actif avec le protocole POP3. Dans tous les autres cas, mettez le chemin d'accès à votre boîte aux lettres ici. Dans le cas du protocole mbox, il s'agit d'un fichier. Dans le cas de maildiri et de IMAP4, il s'agira d'un répertoire.

##### Serveur

Ce champ n'est actif que pour les protocoles IMAP4 et POP3.

##### Utilisateur

Ce champ n'est actif que pour les protocoles IMAP4 et POP3.

##### Mot de passe

Ce champ n'est actif que pour les protocoles IMAP4 et POP3.

##### Stocker le mot de passe

Cette case à cocher permet de conserver le mot de passe entre deux sessions.

KBiff ne crypte pas le mot de passe quand il est enregistré ! Il le brouille un petit peu, mais quiconque possède le code source (ou un peu de patience) pourrait le faire apparaître en clair en un instant. Si vous êtes sur un réseau non sécurisé, il est fortement recommandé que l'option "stocker le mot de passe" soit dévalidée.

##### Avancé

Ce bouton permet d'afficher un dialogue concernant les caractéristiques avancées.

###### URL de la boîte aux lettres

KBiff gère en interne les boîtes aux lettres comme des URLs. Si vous savez ce que vous faites, vous pouvez modifier directement l'URL ici. La modification de cette option est déconseillée à moins que vous ne soyez familier avec le code de l'application.

###### Port

Mettez ici le port servant à joindre votre serveur de courrier. Par défaut, il s'agira du port 110 pour POP3 et 143 pour IMAP4.

###### PREAUTH

Si vous ne savez pas ce que ça veut dire, alors vous n'avez sans doute pas besoin de l'utiliser. En gros, ça permet de vérifier si du courrier est arrivé sans qu'IMAP4 ne procède à une identification (login).

###### Laisser actif

Quand cette case est cochée en mode POP3 ou IMAP4, cela permettra de laisser la connexion "active". C'est-à-dire que KBiff se connectera une fois et restera connecté. Cette option n'est pas recommandée si votre serveur POP3 ou IMAP4 utilise des verrous. Si des verrous sont en place et si KBiff ne se déconnecte pas alors votre client de courrier ne sera pas capable d'accéder à votre compte de courrier.

#### A propos

Cet onglet présente des informations au sujet de KBiff.

##### A propos de KBiff

On trouve ici des informations sur la version de KBiff utilisée. Il y a également des informations permettant de contacter l'auteur.

Notez que l'adresse mél est un hyperlien. En cliquant dessus, votre client de courrier est supposé se lancer afin d'envoyer un message à l'auteur. Malheureusement, il n'y a actuellement aucun moyen d'effectuer cette opération automatiquement. Néanmoins, il y a une amorce de code derrière. Pour envoyer du courrier en utilisant cet hyperlien, KBiff regarde la variable d'environnement `MAILER`. S'il la trouve, il utilisera son contenu pour savoir quel programme de courrier utiliser.

Par example, si `MAILER` est réglé ainsi : `% setenv MAILER "konsole -e mutt"` alors KBiff utilisera `konsole -e mutt` comme client de courrier par défaut.

## Le menu contextuel

Le menu contextuel est activé à chaque fois que l'on clique sur le bouton droit de la souris dans la partie consacrée à l'icône de KBiff.

### (Dés)arrimer

Cette option place ou retire KBiff du tableau de bord. Cette option ne fonctionne qu'avec des gestionnaires de fenêtres complètement compatibles avec KDE comme KWM. L'état par défaut est défini via le dialogue de configuration.

### Configuration

Cette option affiche le dialogue de configuration. Voir la section consacrée au dialogue de configuration pour plus de détails.

### Aide

Cette option lance l'aide en ligne (ceci).

### Vérifier maintenant

Cette option force KBiff à vérifier immédiatement si du courrier est arrivé, sans tenir compte du délai entre deux vérifications. Cette option vérifie toutes les boîtes aux lettres d'un profil donné.

### Lire le courrier maintenant

Cette option force KBiff à faire comme si toutes les boîtes aux lettres du profil courant étaient "lues". Celà présente de l'intérêt surtout lorsque vous avez du courrier sur un serveur distant (pop3 ou imap4) et que vous n'avez pas envie de le télécharger sur le champ.

### Arrêter/démarrer

Cette option arrête ou démarre KBiff.

## Questions, réponses et astuces

### Y-a-t'il d'autres utilitaires "biff" compatibles avec KDE ?

Oui. J'en connais au moins deux. Chaque "biff" a ses propres avantages. KOrn était le premier. Sa qualité principale est de pouvoir gérer plusieurs boîtes aux lettres avec une seule instance de programme et de montrer le nombre de messages dans chacune d'entre elles. Si vous avez beaucoup de boîtes aux lettres et que vous ne recherchez pas de jolies icônes, alors KOrn est probablement un meilleur choix que KBiff. L'autre "biff" est KNewMail. KnewMail cherche à imiter l'utilitaire NewMail de Windows. Il vérifie la présence de courrier POP3 et affiche le sujet de chaque message.

### Quelle est encore la différence entre un "profil" et une boîte aux lettres ?

Un "profil" est un groupe d'une ou plusieurs boîtes aux lettres qu'une instance de KBiff gère. Un exemple de profil est "Inbox". Une "boîte aux lettres" est une entité physique qui peut être géré par KBiff. Un exemple de boîte aux lettres est "/usr/var/username".

### Puis-je utiliser mes propres images ?

Réponse rapide: choisissez-les dans le menu de configuration. Reponse plus approfondie: KBiff recherche ses icônes dans le chemin des icônes de KDE. En ce moment, elles sont dans

    kdedir()/share/apps/kbiff/toolbar
    kdedir()/share/toolbar
    kdedir()/share/icons
    kdedir()/share/apps/kbiff/pics
    $HOME/.kde/share/apps/kbiff/toolbar
    $HOME/.kde/share/toolbar
    $HOME/.kde/share/icons
    $HOME/.kde/share/apps/kbiff/pics

Où "kdedir()" est habituellement "/opt/kde" et où $HOME est votre répertoire personnel. Si vous placez vos images dans l'un de ces répertoires (le dernier de la liste étant celui qu'on recommande), alors KBiff ne devrait pas avoir de problèmes à les trouver et à les utiliser

Si vous projetez de placer KBiff dans le table de bord, vous devriez avoir une version de votre image de taille inférieure ou égale à 22x22. Le nom de la petite image devrait être le nom de la grande image précédé par "mini-". Ainsi si vous voulez utiliser l'image par défaut "oldmail.xpm" pour le courrier lu mais si vous voulez utiliser votre propre petite image "dessin_sympa.xpm" pour quand KBiff est placé dans le tableau de bord, voud devrez renommer votre image en "mini-oldmail.xpm". Si vous ne procédez pas ainsi, KBiff utilisera la grande version, même dans le tableau de bord.

Notez que KBiff détermine sa taille par rapport à l'image du courrier lu. Ainsi si votre image pour le courrier lu a une taille de 100x100, mais si toutes les autres images font 32x32... et bien, KBiff aura une drôle d'allure à chaque fois que du courrier arrive.

### Comment fais-je pour utiliser elm (ou mutt ou PINE) avec KBiff ?

Vous avez essayé de taper "elm" dans la zone de saisie du client de courrier, n'est-ce pas? Patatras! 'elm', 'mutt' et 'PINE' ont tous besoin d'un terminal pour tourner et KBiff n'en fournit pas. L'auteur utilise le terminal suivant comme client de courrier : `konsole -vt_geometry 80x35 -caption Mail -no_scrollbar -e mutt &`

Si vous utilisez un client de courrier graphique comme KMail ou Netscape, alors vous n'avez besoin que de mettre son nom dans la zone de saisie. Aucun terminal n'est nécessaire.

### Pourquoi est-ce que KBiff ne joue pas mon fichier audio newmail.au ?

KBiff utilise la classe KAudio pour jouer des sons quand du courrier arrive. Actuellement, cette classe ne supporte que des fichiers .wav. Si vous désirez jouer un fichier .au quand du courrier arrive, essayez de vous procurer le paquetage SOX et mettez 'play newmail.au' (ou simplement 'cat newmail.au > /dev/audio') dans l'option Lancer la commande.

### Est-ce que KBiff fonctionne sans gestion de session ?

Oui. La gestion de session est activée par défaut, mais vous pouvez la désactiver dans le dialogue de configuration. Vous pouvez toujours avoir KBiff qui se lance au démarrage de KDE en mettant KDE dans le dossier Ouverture au démarrage avec l'option '-profile".

### En cliquant sur votre adresse mél dans "A propos" il ne se passe rien !

Il serait très agréable de passer l'URL 'mailto:granroth@kde.org' à kfm pour la traiter... malheureusement, ce n'est pas encore implémenté. J'ai toutefois codé un bout de gestion pour celà. Réglez simplement la variable d'environnement MAILER en lui donnant le nom de votre lecteur de courrier et le lien devrait fonctionner.

    par exemple
    % setenv MAILER konsole -e mutt

Notez que ceci présente l'avantage que si 'mailto:' est lié correctement alors kfm utilisera lui aussi votre lecteur de courrier.

### Quand j'utilise KBiff pour gérer ma boîte aux lettres, tous les autres utilitaires 'biff' cessent de fonctionner. Que se passe-t'il ?

Ceci est un résultat du code de comptage des messages dans KBiff. Afin que KBiff sache combien de nouveaux messages sont dans une boîte aux lettres de type mbox, il doit l'ouvrir afin de la lire. Quand il procède ainsi, tous les autres utilitaires 'biff' (y compris celui inclus d'office dans le shell) considéreront que vous êtes en train de lire votre courrier et annonceront qu'il s'agit de courrier déjà lu.

Il y a trois façons de contourner ce problème :

1. N'utilisez pas KBiff.

2. Utilisez le protocole 'fichier" plutôt que le protocole 'mbox' (notez que vous ne saurez alors plus combien de méls sont arrivés)

3. Convertissez toutes vos boîtes aux lettres 'mbox' au format 'maildir'

### Comment puis-je utiliser Netscape Mail avec KBiff?

Vous avez essayé 'netscape -mail', n'est-ce pas ? Vous vous êtes alors aperçu que cela a eu pour effet que Netscape se plaint d'un fichier verrou s'il est déjà lancé, n'est-ce pas ? Et bien, voici un contournement proposé par l'utilisateur de KBiff Steven Boger (sboger@marcus-online.net) Créez un script pour le shell ainsi : `#!/bin/sh`

    if [ -L "$HOME/.netscape/lock" ];
    then
    netscape -remote
     'xfeDoCommand(openInbox)'
    else
    netscape -mail &
    fi

### KBiff tronque le "/" initial en mode IMAP. Est-ce une bogue ?

Non, c'est voulu ! Il est extrèmement rare d'utiliser un chemin absolu avec IMAP. Pratiquement toutes les boîtes aux lettres sont accesibles soit à partir du répertoire de base de l'utilisateur, soit à partir d'un nom symbolique comme "inbox".

Si vous essayez de lire `/var/spool/mail/username`, essayez d'entrer `inbox` comme nom de boîte aux lettres.

### J'ai une idée pour ajouter une fonctionnalité géniale. Que dois-je faire ?

D'abord lire le fichier TODO qui accompagne les sources et qui est sur le site internet. Si votre fonctionalité est là, soyez patients. Si elle n'est pas là, ça ne coute rien de demander: écrivez moi !