wiki:fr:Documentation/Reference

Version 4 (modified by AmigaPhil, 3 months ago) (diff)

--

Traduction partielle

Autres langues:

Référence

Structure de l'installation

Dans le répertoire du programme YAM se trouvent les répertoires et les fichiers suivants:

  • YAM Le programme lui-même
  • YAM.info L'icône du programme
  • Resources/
    • Themes/ Themes Utilisés par YAM pour son interface graphique
    • Gallery/ Photos des personnes figurant dans le carnet d'adresses
    • Certificates/
    • Spamfilters/
  • Folders
    • incoming/ le répertoire du courrier entrant
    • outgoing/ le répertoire du courrier sortant
    • sent/ le répertoire du courrier envoyé
    • trash/ le répertoire du courrier marqué pour effacement
    • drafts/
    • spam/
  • Rexx/ programmes ARexx pour YAM
  • .config le fichier de configuration
  • .folders une liste des dossiers
  • .addressbook le carnet d'adresses
  • .glossary le glossaire
  • .users une liste des utilisateurs YAM
  • .spamdata les données d'entraînement au spam de YAM
  • .updatestate information pour le méchanisme automatique de mise à jour
  • .signature votre signature personnelle
  • .altsignature1 première signature alternative
  • .altsignature2 seconde signature alternative
  • .taglines votre collection de taglines
  • .autosave?.txt copies de sauvegarde du contenu de l'éditeur
  • .uidl utilisé pour éviter les duplicata
  • .emailcache fichier cache utilisé pour la fonction de cache courrier feature

Stockage des messages

Chaque message est sauvegardé dans un fichier séparé dont le nom est construit en encodant certaines informations à propos du courriel (date, status, etc) avec l'encodage standard Base64. Le nom de fichier résultant est compatible avec n'importe quel système de fichier.

Exemple: QvZgMAAFe4M=.001,RA

QvZgMAAFe4M= Hash de 5 octets encodé en Base64.

Ce hash est basé sur l'info DATE du message.

. (dot) - Séparateur.

001 Valeur séquentielle. incrémentée de 1 si la base du nom de fichier, en incluant cette partie, existe déjà.

, (comma) - Séparateur.

RA Statut du message. Lettres possibles après la virgule:

R - Lu
A - Répondu
M - Marqué
Y -
J -

Chaque dossier contient un fichier ".index" avec les en-têtes de chaque message du répertoire. Il y a aussi un fichier de configuration appelé ".fconfig" qui contient les réglages pour ce dossier en particulier.

Gestion de thèmes

YAM utilise des icônes et des images dans /Themes/default pour son Interface Graphique Utilisateur (GUI). Il y a plusieurs sortes d'icônes:

config/config_#?, config_#?_big

Ces images sont celles que vous voyez quand vous ouvrez les Préférences pour configurer YAM.

folder/folder_#?, folder_#?_new

Ce sont les images utilisées devant les dossiers Reçus, Corbeille, En attente et Envoyés. Celles avec le suffixe "_new" sont utilisées automatiquement chaque fois qu'il y a un nouveau ou un courriel non-lu dans le répertoire.

Les images "folder_fold" et "folder_unfold" sont spéciales: elles sont utilisées comme icônes pour les groupes de dossiers.

Un fichier image ".fimage" dans le dossier surpasse l'image par défaut. C'est aussi la seule méthode supportée pour avoir des images affichées devant les dossiers custyomisés.

icon/check.info, empty.info, new.info, old.info

Icônes qui montrent le statut de la boîte de réception:

check.info YAM vérifie s'il y a de nouveaux courriels
empty.info la boîte mail est vide
new.info la boîte mail a au moins un nouveau message
old.info la boîte mail ne contient que des "vieux" courriels

status/status_#?

Ce sont les icônes statut affichées par YAM pour représenter le statut des messages

L'icône "status_mark", utilisée quand les messages sont marqués, est spéciale: si elle n'est pas présente, YAM marquera les messages en affichant l'expéditeur ou le destinataire en caractères gras.

toolbar/tb_#?, tb_#?_G, tb_#?_S

Ce sont les images utilisées pour construire la barre d'outils des fenêtres Principale, Lecture, Ecriture, et Carnet d'adresses. Celles nommées "tb_#?_G" sont la variété "fantôme", par ex. elles fournissent les images à utiliser lorsque les icônes doivent paraître grisées. "tb_#?_S" sont la variété "sélectionnées", par ex. lorsque vous cliquez sur un bouton.

.theme, logo, preview

.theme contient d'importantes variables textuelles qui sont nécessaire pour que le moteur de thème fonctionne.

Le "logo" est ce que vous voyez lorsque démarrez et quittez YAM, et aussi dans la fenêtre "A propos" de YAM. (Note: Seul le logo par défaut est affiché, qu'importe le thème choisi.)

Le "preview" est une petite prévisualisation qui montre à quoi ressemblera un thème dans Préférences/Apparence

Formats de fichiers divers

Le fichier .addressbook

Ce fichier texte pur (plain text) utilise une structure hiérarchique qui suit ce format général:

    YAB4 - YAM Addressbook                          - Identifiant
    @GROUP alias  ·································
    description                                   ·
    @USER alias     -------------.                ·
    e-mail address               |                ·
    real name                    |                ·
    description                  |                ·
    phone #                      |                ·
    street address               |                ·
    ZIP/City                      > Personne      ·
    country                      |                ·
    PGP ID                       |                ·
    birth date                   |                ·
    portrait                     |                 · GROUPE
    homepage                     |                ·
    default security             |                ·
    @ENDUSER        -------------'                ·
    @LIST alias     >>>>>>>>>>>>>>>>>>>>>>>>>>                 ·
    return address               v                ·
    list name                    v                ·
    description                  v                ·
    member #1                     >> LISTE         ·
    member #2                    ^                ·
    ...                          ^                ·
    member #n                    ^                ·
                                 ^                ·
    @ENDLIST        >>>>>>>>>>>>>>>>>>>>>>>>>>                 ·
    @ENDGROUP     ·································

Groupes, listes et personnes débutent avec @GROUP <alias>, @LIST <alias> et @USER <alias>, et se terminent respectivement avec @ENDGROUP, @ENDLIST et @ENDUSER. Les groupes peuvent inclure des listes, et des listes peuvent inclure des personnes. Listes et personnes peuvent apparaître en dehors des groupes. Les membres d'une liste peuvent être des alias, des adresses, ou une paire valide "Nom réel <adresse>".

Au niveau GUI (interface graphique), un groupe peut être tiré-déposé dans une liste de distribution et vice-versa, pour que tous les destinataires soient ajoutés à la liste. Les boucles récursives sont surveillées et correctement évitées lorsque c'est approprié - par exemple, si un groupe qui contient une liste est tiré-déposé sur cette liste, seul les éléments disponibles dans ce groupe autre que le contenu de cette liste elle-même sont ajoutés à la liste.

Le fichier .emailcache

Ce fichier texte pur contient une liste des x destinataires utilisés qui ne figuraient pas dans le carnet d'adresses, au format "Nom <adresse>" (ou juste "<adresse>" si le nom n'est pas disponible) avec une entrée par ligne.

Les nouvelles entrées sont ajoutées au dessus. Si la limite d'entrées fixée dans la configuration est dépassée, l'entrée la plus ancienne (celle du bas) est effacée.

Si une entrée est dans le cache au moment de l'écriture d'un courriel, elle est déplacée vers le haut -- de cette manière, la prochaine fois, le destinataire le plus récemment utilisé sera suggéré en premier. Les entrées du carnet d'adresses auront toujours une priorité sur celles du cache cependant.

Le fichier .fconfig

Ce fichier texte pur existe dans chaque dossier et stocke les réglages propres à chaque dossier. Voici le format:

YFC1 - YAM Folder Configuration
Name = folder_name
MaxAge = age
Password = password
Type = folder_type
XPKType = type_number
Sort1 = primary_sort
Sort2 = secondary_sort
Stats = Y|N
MLSupport = Y|N
MLFromAddr = MLFrom_address
MLRepToAddr = MLRepTo_address
MLPattern = ML_pattern
MLAddress = ML_address
MLSignature = signature_number

ou

  • Name est le nom du dossier, tel qu'il apparaît dans la liste des dossiers
  • MaxAge est le nombre de jours que les messages du dossier seront conservés avant d'être effacés automatiquement, où 0 désactive cette fonctionalité (see Configuration/Start/Quit )
  • Password est la contre-partie encodée du mot de passe utilisé pour protéger ce dossier, si un mot de passe est donné
  • Type est un nombre indiquant le typr du dossier (la plupart du temps 0 pour les dossier utilisateur - voir la documentation pour la commande FOLDERINFO ?)
  • XPKType se réfère au mode XPK utilisé pour le dossier:

0 = aucun
1 = protection simple (mot de passe)
2 = compressé
3 = compressé avec mot de passe

  • Sort1 se réfère au premier critère de tri utilisé pour le dossier; dans sa forme négative, le tri est inversé:

1 = Date du message
2 = Date de réception
3 = Expéditeur
4 = Destinataire
5 = Sujet
6 = Taille
7 = Statut

  • Sort2 a la même fonction que Sort1, mais est le second critère de tri
  • Stats est soit Y ou N, selon le statut du drapeau "AppIcon stats"
  • MLSupport est soit Y ou N selon le statut du drapeau "Mailing list support"
  • MLFromAddr montre le contenu du champ "From: adresse"
  • MLRepToAddr montre le contenu du champ "Reply-To: adresse"
  • MLPattern montre le contenu du champ "To: pattern"
  • MLAddress montre le contenu du champ "To: adresse"
  • MLSignature se réfère à la signature par défaut à utiliser pour poster des messages à cette liste de distribution:

0 = aucun
1 = signature par défaut, i.e. PROGDIR:.signature
2 = signature alternative #1
3 = signature alternative #2

Le fichier .folders

Ce fichier texte pur utilise une structure hiérarchique dans ce format général:

    YFO1 - YAM Folders                              - Identifiant
    @FOLDER name    ------------------.
    directory                          > Dossier
    @ENDFOLDER      ------------------'
    @GROUP name              ································
    status                                                  ·
    @FOLDER name    ------------------.                     ·
    directory                          > Dossier             ·
    @ENDFOLDER      ------------------'                     ·
    @GROUP name              ······················         ·
    status                                        ·         ·
    @FOLDER name    ------------------.           ·          · GROUPE
    directory                          > Dossier   ·         ·
    @ENDFOLDER      ------------------'            · GROUPE  ·
    @FOLDER name    ------------------.           ·         ·
    directory                          > Dossier   ·         ·
    @ENDFOLDER      ------------------'           ·         ·
    @ENDGROUP                ······················         ·
    @ENDGROUP                ································

où <status> peut être 0 ou 1, ce dernier signifiant que le groupe est déplié, c-à-d. que son contenu est affiché. Les dossiers pouvent loger à l'intérieur ou à l'extérieur de groupes, et les groupes peuvent être imbriqués.

La structure arborescente des dossiers est sauvegardée sur le disque chaque fois que le menu Dossier/Ordre/Enregistrer est appelé.

Le fichier .glossary

Ce fichier contient une liste des définitions créées dans le glossaire en utilisant ce format:

YDI1 - YAM Dictionary
@ENTRY abbréviation
contenu
@ENDENTRY
@ENTRY abbréviation
contenu
@ENDENTRY
...

Le fichier .uidl

If "Avoid duplicates" is enabled in Configuration/New mail , YAM will use the UIDL POP3 command when connecting to your POP3 server to request an Unique ID Listing of the messages in your mail account. The POP3 server is responsible for assigning an unique ID to every message and put it into a "X-UIDL:" header.

If the server doesn't support the UIDL POP3 command, YAM will fall back to the TOP command and try using the "Message-ID:" header instead; if this also fails, an error will be generated.

The Unique ID Listing received from the server is compared against the contents of the "PROGDIR:.uidl" file; if this file doesn't exist yet, it will be created. This is a plain text file with one ID per line using the format <ID>@<POP3 server>, e.g.

9685@…
9686@…
9687@…
9688@…
(k5"!N1!"!RkI"!YT4"!@pop.wanadoo.es
9689@…
9690@…
9691@…
9692@…

Whenever an ID is already found in the "PROGDIR:.uidl" file, the relevant message will be considered a duplicate, and thus it won't be downloaded. New IDs not yet in the "PROGDIR:.uidl" file will be added to it as the corresponding messages are successfully downloaded.

Le fichier .users

This file contains a list of the users that can log in and use YAM. YAM maintains this file by itself, so you shouldn't ever touch it, unless maybe you are moving YAM to another place in your hard disk.

The file uses the following format:

1st line: YUS2 - YAM Users
2nd line: @USER <username>
3rd line: mail directory of this user, e.g. Comm:YAM
4th line: number
5th line: encrypted password, if any
6th line: @ENDUSER

further lines: next user definition, upto 16 maximum.

where "number" is a value defining the status of this user combining the following set of elements:

No Supervisor privileges = 4
Share global address book = 2
Share global glossary = 1

Thus, "3" would mean the user has Supervisor privileges and is sharing the global address book and glossary. This is the default value in a single user setup.

Le fichier log

The log file used by YAM is an ASCII file storing one event per line. Each line is saved in this format:

DD-MMM-YY HH:MM [code] Event description

where code is a two digit number and "Event description" is obviously the event description, possibly localized. Therefore, any computer-assisted software meant to analyze the log file data should refer to the code of the event.

Events out of the 30<->49 range will only be printed if "Log all events" is enabled in the Security options .

List of possible events:

0 - YAM started
1 - Logged in as user 'user_name'
2 - Logged in as 'user_name', using configuration 'config_file' and mail directory 'folder_path'

10 - Wrote new message for 'recipient' about 'subject', including n attachment(s)
11 - Replied message from 'sender' about 'subject'
12 - Forwarded message from 'sender' about 'subject' to 'recipient'
13 - Bounced message from 'sender' about 'subject' to 'recipient'
14 - Edited message from 'sender' to 'recipient' about 'subject'
20 - Deleted n message(s) in folder 'folder'
21 - Deleted message from 'sender' about 'subject' in folder 'folder'
22 - Moved n message(s) from folder 'folder' to 'folder'
23 - Moved message from 'sender' about 'subject' from folder 'folder' to 'folder'
24 - Copied n message(s) from folder 'folder' to 'folder'
25 - Copied message from 'sender' about 'subject' from folder 'folder' to 'folder'
26 - Filtered n message(s) in folder 'folder': n match(es)
30 - Retrieved n message(s) from POP3 account 'user_id@host'
31 - Logged in on POP3 account 'user_id@host': n messages waiting
32 - Retrieved message from 'sender' about 'subject' (n bytes)
40 - Sent n message(s) using SMTP server 'host'
41 - Connected to SMTP server 'host'
42 - Sent message to 'recipient' about 'subject' (n bytes)
50 - Imported n message(s) from file 'filename' into folder 'folder'
51 - Exported n message(s) from folder 'folder' to file 'filename'
60 - Saved configuration file 'config_file'
62 - Saved user configuration
70 - Saved address book 'filename'
71 - Added address book entry 'alias'
80 - Saved attachment 'filename' of message 'mailfile' in folder 'folder'
81 - Cropped attachment(s) of message 'mailfile' in folder 'folder'
82 - Changed subject 'subject' of message 'mailfile' in folder 'folder' to 'subject'
99 - YAM terminated