
                               TkRat mini-HOWTO

Dave Whitinger, dave@linuxtoday.com
Version franaise : Philippe Martin, feloy@wanadoo.fr

   v1.2, 15 Septembre 1999
     _________________________________________________________________

   _Voici le TkRat mini-HOWTO. Ce document est destin  quiconque
   voudrait utiliser Linux pour envoyer et recevoir des messages
   lectroniques par l'Internet. _
     _________________________________________________________________

1. Introduction

   Ce document est maintenu par Dave Whitinger ( dave@linuxtoday.com).
   Merci de me contacter pour toutes questions ou ides relatives  cet
   HOWTO.

   Ce document va tenter de dcrire comment :

    1. Installer le programme de messagerie TkRat,
    2. Rcuprer ses messages chez un Fournisseur de Services Internet
       (_FSI_),
    3. Lire, stocker et envoyer des messages,
    4. Trier ses messages dans diffrents classeurs.

   Ce document suppose que vous utilisez Linux avec le systme X Window,
   avez dj tabli une connexion avec votre Fournisseur de Services
   Internet, et avez un compte POP chez ce fournisseur.

   Responsabilits : Toutes responsabilits habituelles s'appliquent.
   L'auteur ne peut en aucun cas tre tenu responsable d'une (mauvaise)
   utilisation des informations donnes ici. Ce document ne tente en
   aucun cas de faire autorit. L'auteur a volontairement cr ce
   document sparment de toute entit avec laquelle il pourrait tre
   impliqu. En lisant ce document, vous acceptez de ne crer  l'auteur
   ni ennuis ni griefs. :)

2. Installer TkRat

   Je voudrais souligner qu'il existe un grand nombre d'excellents
   programmes de messagerie disponibles sous Linux. C'est toujours une
   question de got personnel que de choisir lequel utiliser.

   Cela dit, je dois vous avouer que j'utilise un programme appel TkRat
   depuis plus de deux ans maintenant -- et je l'adore. C'est un
   programme avec une interface graphique qui a toutes les
   caractristiques que vous attendez d'un programme de messagerie de
   qualit : il est simple d'apprentissage, il est puissant, et il est
   libre. Pour ces raisons, cet HOWTO ne traitera que de TkRat.

   La premire chose  faire est de rcuprer TkRat. Vous pouvez soit
   obtenir les sources que vous compilerez, soit obtenir les excutables.

   Voici quelques URL pour le logiciel :

     * ftp://ftp.md.chalmers.se/pub/tkrat/tkrat-2.0b3.tar.gz
       (Tlchargement via ftp)
     * http://www.dtek.chalmers.se/~maf/ratatosk/tkrat-2.0b3.tar.gz
       (Tlchargement via http)
     * http://www.dtek.chalmers.se/~maf/ratatosk/download.html (Page de
       tlchargement - vrifiez la dernire version !)

   Lorsque vous avez tlcharg l'archive, vous tes prt  l'installer
   sur votre systme.

   Pour installer les sources tar.gz, utilisez les commandes :
     _________________________________________________________________

          tar -zcvpf tkrat-2.0b3.tar.gz
          cd tkrat-2.0b3
          ./configure
          make
          make install
     _________________________________________________________________

   Si quelque chose choue, consultez les fichiers INSTALL et README se
   trouvant dans le rpertoire tkrat-2.0b3. Notez que vous aurez besoin
   d'une version de tcl suprieure  8.1 pour compiler. Vous pouvez
   obtenir la dernire version de tcl depuis scriptics.com.

   Bravo - TkRat devrait tre install sur votre systme maintenant.

3. Rcuprer vos messages

   Afin de lire vos messages, le mieux est gnralement d'utiliser le
   programme appel fetchmail. Les instructions suivantes sont rputes
   marcher parfaitement pour la version 2.2 de fetchmail -- bien qu'elles
   doivent tre applicables  d'autres versions.

   (Note : fetchmail est trs certainement dj install sur votre
   systme, celui-ci tant inclus dans toutes les distributions Linux que
   je connaisse - si tel n'est pas le cas, prire de me le faire savoir
   !)

   Excutez les tapes suivantes :
     _________________________________________________________________

          echo "server pop.fr protocol pop3 username dave password xxxxx" > ~/.
fetchmailrc
     _________________________________________________________________

   (N'oubliez pas de remplacer _pop.fr_ par le nom du serveur POP de
   votre FSI. Remplacez _dave_ par votre identifiant de messagerie et
   _xxxxx_ par votre mot de passe associ.)

    partir de maintenant, chaque fois que vous voulez voir si vous avez
   des messages, tapez juste fetchmail sur la ligne de commande.
   fetchmail va partir rcuprer tous vos messages et les stocker dans
   votre classeur de messages local.

4. Configurer TkRat

   Depuis la ligne de commande, tapez tkrat suivi d'_Entre_.
   Cliquez sur Create.
   Lisez le message qu'il vous prsente, puis cliquez sur Continue.

    ce point, vous tes amen au programme principal de TkRat. La
   premire chose  faire est de l'adapter  votre systme local.

    1. Allez dans le menu Admin, et choisissez Preferences,
    2. Cliquez sur Sending,
    3. Entrez votre adresse lectronique dans le champ Default Reply-To,
    4. Entrez votre adresse lectronique, suivie de votre nom entre
       parenthses dans le champ Use from address, par exemple
       dave@linuxtoday.com (Dave Whitinger)
    5. Entrez votre nom de domaine dans le champ Domain. Si votre adresse
       lectronique est utilisateur@xyz.fr, entrez xyz.fr
    6. Cliquez sur Apply,
    7. Cliquez sur Method,
    8. Pour Send Via, slectionnez SMTP,
    9. Dans le champ SMTP host, entrez l'adresse du serveur SMTP de votre
       FSI (ils devraient tre capable de vous fournir cette
       information),
   10. Cliquez sur Apply, puis sur Dismiss.

5. Utiliser TkRat

   Au dmarrage de TkRat, vous noterez que vous tes dans un classeur
   appel INBOX. Utilisez fetchmail pour rcuprer vos messages. Si vous
   en avez, ils apparatront dans le classeur INBOX.

   TkRat a une interface intuitive. La moiti suprieure de l'cran
   montre la liste des messages que vous avez reus (chaque ligne tant
   un message diffrent). La moiti infrieure montre le contenu du
   message slectionn.

   Vous pouvez lire un message en cliquant simplement sur ce message dans
   la liste.

   Lorsque vous avez fini de lire un message, vous pouvez aller voir un
   autre message, rpondre  ce message, crire un nouveau message, ou
   dplacer ce message vers un autre classeur.

   Les Folders sont un moyen de stocker vos messages lectroniques dans
   diffrents _classeurs_. Ainsi, vous pouvez conserver plusieurs
   classeurs, chacun contenant les messages sur un certain sujet.

   Excutez les instructions suivantes pour crer des classeurs :
    1. Choisissez le menu Admin, puis New/Edit Folders
    2. Vous voyez une bote avec un classeur INBOX. Cliquez (avec le
       bouton gauche) sur cette bote.
    3. Il vous est alors prsent un menu, slectionnez-y New File
       Folder.
    4. Il vous sera prsent une bote de dialogue vous demandant des
       informations.
    5. Dans le premier champ, entrez un nom pour le classeur.
    6. Dans le second, entrez le nom de fichier qui sera utilis pour y
       stocker les messages.
       Un petit conseil : utilisez quelque chose comme
       /home/utilisateur/mail/nom_du_classeur. Par exemple, si le premier
       champ est _Personnel_, le second serait quelque chose comme
       home/dave/mail/personnel (en supposant que votre nom d'utilisateur
       soit _dave_.)
    7. Cliquez sur OK. Vous noterez que votre nouveau classeur apparat
       maintenant dans la liste des classeurs. Allez alors dans Window,
       puis Close.

   Vous pouvez maintenant dplacer vos messages vers le nouveau classeur
   - et basculer vers ce classeur en slectionnant son nom sous le menu
   Folders.

   Envoyer des messages est aussi simple. Cliquez sur Compose, tapez
   l'adresse lectronique du destinataire, le sujet, puis le message.

   Lorsque vous avez termin, cliquez sur Send.

6. Tri automatique des messages dans les classeurs

   Si vous tes comme moi, vous recevez prs de 3500 messages par jour.
   Chaque fois que vous allez chercher vos messages (Note : _fetch mail
   en anglais_), vous devez parcourir tous vos messages pour trouver ceux
   qui vous intressent.

   Ce n'est plus un problme, grce  Procmail.

   Procmail fonctionne ainsi :

   Procmail examine chaque message au moment o il est rcupr, et
   excute une srie de tches fondes sur certaines rgles que vous lui
   avez spcifies.

   Disons, par exemple, que je reoive 200 messages par jour d'une
   certaine liste (prenons ici la liste _linux-machin_). Plutt que de
   voir tous ces messages partir directement dans mon classeur INBOX, je
   prfre qu'ils soient automatiquement filtrs et dirigs dans un
   classeur appel _liste-machin_.

   La premire chose  faire est de prendre quelques exemples de messages
   provenant de cette liste et d'en examiner les enttes.

   Je commence  discerner un motif rptitif. Chaque message provenant
   de cette liste contient une ligne disant :

          Sender: owner-linux-machin@bidule.chouette.fr

   Je peux maintenant dire  procmail de placer chaque message contenant
   cette ligne dans un certain classeur.

   Je peux le prciser  procmail  travers un fichier .procmailrc.

   Je vais utiliser mon diteur de texte prfr pour crer un fichier
   texte dans mon rpertoire racine, appel .procmailrc.

   Ce fichier ressemblera  :
     _________________________________________________________________

          LOGFILE=$HOME/.pmlog
          MAILDIR=$HOME/mail
          VERBOSE

          # liste linux-machin
          :0 Hw
          * ^.*[Ss]ender: owner-linux-machin@bidule.chouette.fr
          liste-machin

          # S'il arrive ici, l'envoyer dans mon classeur 'nouveaux'
          :0 Hw
          nouveaux

     _________________________________________________________________

   Examinez la ligne [Ss]ender. Vous noterez que cette ligne est ce que
   tous les messages provenant de cette liste ont en commun.

   Cette section dit  procmail de placer les messages arrivant avec une
   entte comme celle-ci dans le classeur _liste-machin_.

   La section suivante dit que si le message ne correspond  aucune rgle
   prcdente, alors il faut le placer dans le classeur _nouveaux_.

   Maintenant, disons que je veuille que les messages de la part de mon
   ami _EJ_ aillent dans un classeur nomm _EJ_.

   Il suffit de rajouter une section  mon fichier .procmailrc :
     _________________________________________________________________

          LOGFILE=$HOME/.pmlog
          MAILDIR=$HOME/mail
          VERBOSE

          # liste linux-machin
          :0 Hw
          * ^.*[Ss]ender: owner-linux-machin@bidule.chouette.fr
          liste-machin

          # Message de E.J. !
          :0 Hw
          * ^.*[Ff]rom: ej@monpote.fr
          ej

          # S'il arrive ici, l'envoyer dans mon classeur 'nouveaux'
          :0 Hw
          nouveaux
     _________________________________________________________________

   Remarquez la nouvelle section pour _EJ_. Lorsqu'un message y arrive
   avec son adresse dans le champ From, il sera automatiquement plac
   dans mon classeur ej.

   Maintenant, disons qu'il y ait un boiteux par-l qui tienne 
   m'crire. Je ne veux pas entendre parler de lui, mais il insiste.
   Encore une fois - procmail  la rescousse.

   Disons alors que ne ne veuille recevoir aucun message de _Bill Gates_.
   Je peux dfinir un expditeur dont tous les messages seront effacs.
   Voyez alors mon nouveau .procmailrc :
     _________________________________________________________________


          LOGFILE=$HOME/.pmlog
          MAILDIR=$HOME/mail
          VERBOSE

          # Provient-il de Bill Gates?  Si oui, A LA POUBELLE !!!
          :0 Hw
          * ^.*[Ff]rom: bgates@microsoft.com
          /dev/null

          # liste linux-machin
          :0 Hw
          * ^.*[Ss]ender: owner-linux-machin@bidule.chouette.fr
          liste-machin

          # Message de EJ !
          :0 Hw
          * ^.*[Ff]rom: ej@monpote.fr
          ej

          # S'il arrive ici, l'envoyer dans mon classeur 'nouveaux'
          :0 Hw
          nouveaux
     _________________________________________________________________

   Maintenant, j'ai un fichier .procmailrc plutt bien. Examinons ce que
   procmail va faire de chaque message qu'il reoit.

   Premirement, il regarde si ce message provient de
   _bgates@microsoft.com_. Si oui, il l'efface et c'est fait.

   Si le message est pass  travers la premire vrification, procmail
   regarde s'il contient _owner-linux-machin@bidule.chouette.fr_ dans
   l'entte. Si oui, il le dpose dans le classeur liste-machin, et
   voil.

   Si le message est aussi pass  travers celle-l, il regarde s'il
   provient d'_EJ_. Si oui, il le place dans le classeur ej.

   Maintenant, si le message est pass  travers tous ces tests, alors il
   le place dans le classeur nouveaux.

   Une fois ces classeurs mis en place et procmail filtrant correctement
   vos messages, vous pouvez aller dans TkRat, Admin - New/Edit Folder et
   crer les classeurs pour chaque fichier. Ils seront placs dans
   /home/utilisateur/mail/nom_classeur

7. Copyright

   Ce HOWTO est Copyright 1998, 1999 par Dave Whitinger, et c'est un
   document libre. Vous pouvez le redistribuer et/ou le modifier sous les
   termes de la GPL (GNU General Public License) publie par la FSF (Free
   Software Foundation) ; soit la version 2 de la Licence, soit une
   version ultrieure.

8. Remerciements

   Je remercie tout particulirement Martin Forsse'n
   (_maf@dtek.chalmers.se_) pour avoir cr l'_agent utilisateur de
   messagerie_ TkRat.

   Je remercie galement le _North Texas Linux User's Group_ (Dallas,
   Texas), pour qui j'ai  l'origine crit ce document dbut 1998.
   Aujourd'hui aucun remerciement ne va plus  aucun groupe
   d'utilisateurs, car je vis dans les montagnes de l'Est du Tennessee,
   o je pense tre le seul utilisateur de Linux (ou mme utilisateur
   d'un ordinateur)  50 miles  la ronde.

   Notez aussi : Nic Bernstein a fait bifurquer le code de TkRat pour
   crer un agent de messagerie appel Postilion. Il semble tre un
   excellent agent de messagerie avec un grand nombre de nouvelles
   fonctionnalits qui ne sont pas dans TkRat, mais, nammoins, je
   continue  utiliser TkRat.
