Linting, encore

merge-requests/18/head
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
de mailing-lists, listes de diffusion en bon français, accessible
[ici](https://lists.crans.org/postorius/lists/).
Actuellement (juin 2025),
le service est propulsé par Mailman 3 et l'interface d'administration
[ici](https://lists.crans.org/postorius/lists/).
Actuellement (juin 2025),
le service est propulsé par Mailman 3 et l'interface d'administration
utilise, au choix, Postorius ou Hyperkitty. tourne sous NixOS 24.11
## Filtre anti-bots
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
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
en cas d'échec de connexion.
## Comptes
Mailman dispose de ses propres comptes et il n'est pas nécessaire
de disposer d'un compte Crans pour utiliser le service.
Il est en revanche possible d'utiliser un compte Crans pour
Mailman dispose de ses propres comptes et il n'est pas nécessaire
de disposer d'un compte Crans pour utiliser le service.
Il est en revanche possible d'utiliser un compte Crans pour
contrôler un compte Mailman, à travers une OAuth.
Toute personne, même non adhérente au Crans ou extérieure à
l'ENS peut créer un compte sur Mailman. À un compte Mailman,
Toute personne, même non adhérente au Crans ou extérieure à
l'ENS peut créer un compte sur Mailman. À un compte Mailman,
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.
## Droits sur les listes
Les nounous peuvent créer de nouvelles listes, sur demande
d'adhérents ou de clubs. Il est demandé aux requérants
d'envoyer leur demande sur l'adresse des nounous
Les nounous peuvent créer de nouvelles listes, sur demande
d'adhérents ou de clubs. Il est demandé aux requérants
d'envoyer leur demande sur l'adresse des nounous
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 :
- abonner ou désabonner des adresses mail,
- changer les critères de modération automatique,
- modérer les messages.
Le rôle des modérateurs est de filtrer les messages mis
en attente de distribution (envoi par un non abonné,
Le rôle des modérateurs est de filtrer les messages mis
en attente de distribution (envoi par un non abonné,
message trop volumineux, les critères varient).
## Messages automatiques et modération
Lorsqu'un message envoyé à une liste est mis en attente
d'être modéré, un email est automatiquement envoyé aux
modérateurs de la liste. Cet email automatique admet
une forme par défaut (qui vient avec l'installation de Mailman),
mais il est possible de modifier le format pour le rendre
plus lisible et accessible à des novices,
Lorsqu'un message envoyé à une liste est mis en attente
d'être modéré, un email est automatiquement envoyé aux
modérateurs de la liste. Cet email automatique admet
une forme par défaut (qui vient avec l'installation de Mailman),
mais il est possible de modifier le format pour le rendre
plus lisible et accessible à des novices,
qui ne savent pas nécessairement quoi faire.
Un événement déclencheur (abonnement, désabonnement,
message en modération, bounce score qui augmente, etc)
a son propre mail automatique, dont le template
peut être modifié. Chacun de ces templates a trois
Un événement déclencheur (abonnement, désabonnement,
message en modération, bounce score qui augmente, etc)
a son propre mail automatique, dont le template
peut être modifié. Chacun de ces templates a trois
scopes qui sont appliqués avec une priorité décroissante :
- liste (ex : nom_de_votre_liste@lists.crans.org)
- domaine (ex : lists.crans.org)
- site (l'installation courante de Mailman).
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.
(Et de toute façon, on a essayé de trouver où poser le template
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.
(Et de toute façon, on a essayé de trouver où poser le template
et on a pas trouvé.)
Un template doit
- ê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))
- ê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))
- 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.
Un template global pour les messages de modération au
niveau de Mailman a été placé sur la VM Mailman dans
`/var/lib/mailman3/templates/sites/fr` et nommé,
comme le veut la convention, `list:admin:action:post.txt`.
Ce message est particulièrement important,
Un template global pour les messages de modération au
niveau de Mailman a été placé sur la VM Mailman dans
`/var/lib/mailman3/templates/sites/fr` et nommé,
comme le veut la convention, `list:admin:action:post.txt`.
Ce message est particulièrement important,
compte tenu du nombre de débutants utilisant le service chaque année.
Un template de footer pourrait être inclus,
dans `list:member:regular:footer.txt`
Un template de footer pourrait être inclus
dans `list:member:regular:footer.txt`
avec un lien permettant de se désabonner.