Linting, encore

merge-requests/22/merge
glevy 2025-06-08 14:40:24 +02:00
parent b3131b66fc
commit 500d295d10
1 changed files with 38 additions and 39 deletions

View File

@ -2,88 +2,87 @@
En plus des comptes mails individuels, le Crans propose un service En plus des comptes mails individuels, le Crans propose un service
de mailing-lists, listes de diffusion en bon français, accessible de mailing-lists, listes de diffusion en bon français, accessible
[ici](https://lists.crans.org/postorius/lists/). [ici](https://lists.crans.org/postorius/lists/).
Actuellement (juin 2025), Actuellement (juin 2025),
le service est propulsé par Mailman 3 et l'interface d'administration le service est propulsé par Mailman 3 et l'interface d'administration
utilise, au choix, Postorius ou Hyperkitty. tourne sous NixOS 24.11 utilise, au choix, Postorius ou Hyperkitty. tourne sous NixOS 24.11
## Filtre anti-bots ## Filtre anti-bots
Une fenêtre pop-up doit apparaître lorsque l'on se rend sur l'URL ci-dessus. Une fenêtre pop-up doit apparaître lorsque l'on se rend sur l'URL ci-dessus.
L'identifiant et le mot de passe sont simples pour un humain et donnés L'identifiant et le mot de passe sont simples pour un humain et donnés
en cas d'échec de connexion. en cas d'échec de connexion.
## Comptes ## Comptes
Mailman dispose de ses propres comptes et il n'est pas nécessaire Mailman dispose de ses propres comptes et il n'est pas nécessaire
de disposer d'un compte Crans pour utiliser le service. de disposer d'un compte Crans pour utiliser le service.
Il est en revanche possible d'utiliser un compte Crans pour Il est en revanche possible d'utiliser un compte Crans pour
contrôler un compte Mailman, à travers une OAuth. contrôler un compte Mailman, à travers une OAuth.
Toute personne, même non adhérente au Crans ou extérieure à Toute personne, même non adhérente au Crans ou extérieure à
l'ENS peut créer un compte sur Mailman. À un compte Mailman, l'ENS peut créer un compte sur Mailman. À un compte Mailman,
on peut associer plusieurs adresses mail, selon ses besoins. on peut associer plusieurs adresses mail, selon ses besoins.
Enfin, pour être simplement abonné à une liste, il n'y a Enfin, pour être simplement abonné à une liste, il n'y a
aucune condition particulière à remplir. aucune condition particulière à remplir.
## Droits sur les listes ## Droits sur les listes
Les nounous peuvent créer de nouvelles listes, sur demande Les nounous peuvent créer de nouvelles listes, sur demande
d'adhérents ou de clubs. Il est demandé aux requérants d'adhérents ou de clubs. Il est demandé aux requérants
d'envoyer leur demande sur l'adresse des nounous d'envoyer leur demande sur l'adresse des nounous
pour garder une trace. pour garder une trace.
Chaque liste a ses abonnés, ses propriétaires et ses modérateurs. Chaque liste a ses abonnés, ses propriétaires et ses modérateurs.
Les propriétaires peuvent : Les propriétaires peuvent :
- abonner ou désabonner des adresses mail, - abonner ou désabonner des adresses mail,
- changer les critères de modération automatique, - changer les critères de modération automatique,
- modérer les messages. - modérer les messages.
Le rôle des modérateurs est de filtrer les messages mis Le rôle des modérateurs est de filtrer les messages mis
en attente de distribution (envoi par un non abonné, en attente de distribution (envoi par un non abonné,
message trop volumineux, les critères varient). message trop volumineux, les critères varient).
## Messages automatiques et modération ## Messages automatiques et modération
Lorsqu'un message envoyé à une liste est mis en attente Lorsqu'un message envoyé à une liste est mis en attente
d'être modéré, un email est automatiquement envoyé aux d'être modéré, un email est automatiquement envoyé aux
modérateurs de la liste. Cet email automatique admet modérateurs de la liste. Cet email automatique admet
une forme par défaut (qui vient avec l'installation de Mailman), une forme par défaut (qui vient avec l'installation de Mailman),
mais il est possible de modifier le format pour le rendre mais il est possible de modifier le format pour le rendre
plus lisible et accessible à des novices, plus lisible et accessible à des novices,
qui ne savent pas nécessairement quoi faire. qui ne savent pas nécessairement quoi faire.
Un événement déclencheur (abonnement, désabonnement, Un événement déclencheur (abonnement, désabonnement,
message en modération, bounce score qui augmente, etc) message en modération, bounce score qui augmente, etc)
a son propre mail automatique, dont le template a son propre mail automatique, dont le template
peut être modifié. Chacun de ces templates a trois peut être modifié. Chacun de ces templates a trois
scopes qui sont appliqués avec une priorité décroissante : scopes qui sont appliqués avec une priorité décroissante :
- liste (ex : nom_de_votre_liste@lists.crans.org) - liste (ex : nom_de_votre_liste@lists.crans.org)
- domaine (ex : lists.crans.org) - domaine (ex : lists.crans.org)
- site (l'installation courante de Mailman). - site (l'installation courante de Mailman).
De fait, le niveau intermédiaire n'a pas d'intérêt pour le Crans, De fait, le niveau intermédiaire n'a pas d'intérêt pour le Crans,
puisqu'on ne gère qu'un seul domaine. puisqu'on ne gère qu'un seul domaine.
(Et de toute façon, on a essayé de trouver où poser le template (Et de toute façon, on a essayé de trouver où poser le template
et on a pas trouvé.) et on a pas trouvé.)
Un template doit Un template doit
- être nommé en suivant une syntaxe précise - être nommé en suivant une syntaxe précise (cf la [doc officielle](https://docs.mailman3.org/projects/mailman/en/latest/src/mailman/rest/docs/templates.html))
(cf la [doc officielle](https://docs.mailman3.org/projects/mailman/en/latest/src/mailman/rest/docs/templates.html))
- utiliser les mêmes noms de variables que Mailman, codées en dur, - utiliser les mêmes noms de variables que Mailman, codées en dur,
- être placé dans le bon dossier, avec le bon nom, sinon il ne sera pas lu. - être placé dans le bon dossier, avec le bon nom, sinon il ne sera pas lu.
Un template global pour les messages de modération au Un template global pour les messages de modération au
niveau de Mailman a été placé sur la VM Mailman dans niveau de Mailman a été placé sur la VM Mailman dans
`/var/lib/mailman3/templates/sites/fr` et nommé, `/var/lib/mailman3/templates/sites/fr` et nommé,
comme le veut la convention, `list:admin:action:post.txt`. comme le veut la convention, `list:admin:action:post.txt`.
Ce message est particulièrement important, Ce message est particulièrement important,
compte tenu du nombre de débutants utilisant le service chaque année. compte tenu du nombre de débutants utilisant le service chaque année.
Un template de footer pourrait être inclus, Un template de footer pourrait être inclus
dans `list:member:regular:footer.txt` dans `list:member:regular:footer.txt`
avec un lien permettant de se désabonner. avec un lien permettant de se désabonner.