wiki:fr:Documentation/Reference

Version 7 (modified by AmigaPhil, 7 months ago) (diff)

--

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

Si "Eviter les duplicata" est activé dans Configuration/Nouveau courrier , YAM utilisera la commande POP3 UIDL quand il se connectera à votre serveur POP3 pour demander une Unique ID Liste des messages de votre compte. Le serveur POP3 est responsable de l'attribution d'un ID unique pour chaque message et l'indique dans un en-tête "X-UIDL:".

Si le serveur ne supporte pas la commande UIDL, YAM recourera à la commande TOP et essayera d'utiliser l'en-tête "Message-ID:" à la place; si ceci échoue aussi, une erreur sera générée.

La liste des ID unique reçue du serveur est comparée avec le contenu du fichier "PROGDIR:.uidl"; si ce fichier n'existe pas, il sera créé. C'est un fichier texte pur avec un ID par ligne utilisant e format <ID>@<POP3 server>, par exemple:

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

Si un ID est déjà trouvé dans le fichier "PROGDIR:.uidl", le message correspondant sera considéré comme un duplicata, et donc ne sera pas téléchargé. Les nouveaux IDs qui ne sont pas dans le fichier "PROGDIR:.uidl" seront ajouté dès que les messages correspondant seront téléchargés avec succès.

Le fichier .users

Ce fichier est une liste des utilisateurs qui peuvent se connecter et utiliser YAM. YAM maintient ce fichier lui-même, vous ne devriez donc pas y toucher, sauf si peut-être vous déplacez YAM ailleurs sur votre disque dur.

Le fichier utilise ce format:

1st ligne: YUS2 - YAM Users
2nd ligne: @USER <nom d'utilisateur>
3rd ligne: répertoir mail de cet utilisateur, ex.: Comm:YAM
4th ligne: nombre
5th ligne: mot de passe encrypté, s'il y en a un
6th ligne: @ENDUSER

autres lignes: prochaines définition d'utilisateurs, jusqu'à un maximum de 16.

où "nombre" est une valeur du statut de cet utilisateur combiné avec un jeu d'éléments suivants:

Pas de privilèges Superviseur = 4
Partage du carnet d'adresses global = 2
Partage du glossaire global = 1

Ainsi, "3" voudrait dire que l'utilisateur a les privilèges de Superviseur et qu'il partage le carnet d'adresses global et le glossaire. C'est la valeur par défaut pour une configuration d'un seul utilisateur.

Le fichier journal (log)

Le fichier journal utilisé par YAM est un fichier ASCII qui stocke un évênement par ligne. Chaque ligne est enregistrée dans ce format:

JJ-MMM-AA HH:MM [code] description de l'évênement

code est un nombre de deux chiffres et "Evênement" est évidemment la description de l'évênement, éventuellement localisée. Dès lors, tous logiciel d'analyse du fichier journal devrait se référer au code de l'évênement.

Les évênements hors de la rangée 30<->49 ne seront enregistrés que si "Journaliser tous les évênements" est activé dans les Options de sécurité .

Liste des évênements possibles:

0 - YAM démarré
1 - Connecté en tant qu'utilisateur 'nom_utilisateur'
2 - Connecté en tant que 'nom_utilisateur', utilisant la configuration 'fichier_config' et le répertoire mail 'chemin_dossier'

10 - Ecrit un nouveau message pour 'destinataire' à propos de 'sujet', incluant x pièce(s) jointe(s)
11 - Réponse au message de 'expéditeur' à propos de 'sujet'
12 - Retransmission du message de 'expéditeur' à propos de 'sujet' à 'destinataire'
13 - Redirection du message de 'expéditeur' à propos de 'sujet' à 'destinataire'
14 - Edition du message de 'expéditeur' à 'destinataire' à propos de 'sujet'
20 - Effacement de x message(s) dans le dossier 'dossier'
21 - Effacement du message de 'expéditeur' à propos de 'sujet' dans le dossier 'dossier'
22 - Déplacement de x message(s) du dossier 'dossier' vers 'dossier'
23 - Déplacement du message de 'expéditeur' à propos de 'sujet' du dossier 'dossier' vers 'dossier'
24 - Copie de x message(s) du dossier 'dossier' vers 'dossier'
25 - Copie du message de 'expéditeur' à propos de 'sujet' du dossier 'dossier' vers 'dossier'
26 - Filtrage de x message(s) dans le dossier 'dossier': x correspondance(s)
30 - Extraction de x message(s) du compte POP3 'id_utilisateur@hôte'
31 - Connecté au compte POP3 'id_utilisateur@hôte': x messages en attente
32 - Extraction du message de 'expéditeur' à propos de 'sujet' (x octets)
40 - Envoi de x message(s) en utilisant le serveur SMTP 'hôte'
41 - Connexion au serveur SMTP 'hôte'
42 - Envoi du message à 'destinataire' à propos de 'sujet' (x octets)
50 - Importation de x message(s) du fichier 'nomdefichier' dans le dossier 'dossier'
51 - Exportation de x message(s) du dossier 'dossier' vers le fichier 'nomdefichier'
60 - Sauvegarde du fichier de configuration 'fichier_config'
62 - Sauvegarde de la configuration utilisateur
70 - Sauvegarde du carnet d'adresses 'nomdefichier'
71 - Ajout de l'entrée 'alias' au carnet d'adresses
80 - Sauvegarde de la pièce jointe 'nomdefichier' du message 'fichiermail' dans le dossier 'dossier'
81 - Suppression du(des) pièce(s) jointe(s) du message 'fichiermail' dans le dossier 'dossier'
82 - Changement du sujet 'sujet' du message 'fichiermail' dans le dossier 'dossier' en 'sujet'
99 - YAM terminé