Linting 3

merge-requests/22/merge
glevy 2025-06-28 19:43:24 +02:00 committed by bleizi
parent d6bb04c6da
commit 653e7b8e23
1 changed files with 28 additions and 19 deletions

View File

@ -119,22 +119,28 @@ et ont accès aux variables définies dans mail_all.
* `Prénom` : Le prénom du destinataire, ou la chaîne vide. * `Prénom` : Le prénom du destinataire, ou la chaîne vide.
* `Nom` : Le nom du destinataire, ou la chaîne vide. * `Nom` : Le nom du destinataire, ou la chaîne vide.
* `To` : L'email du destinatire. * `To` : L'email du destinatire.
* `mailer` : L'user agent. * `mailer` : L'user agent.
Par défaut il vaut "Un MA du Crans a personalisé ce message Par défaut il vaut "Un MA du Crans a
à la main pour toi" personalisé ce message à la main pour toi"
* Toute autre variable que tu aurais envie de définir. * Toute autre variable que tu aurais envie de définir.
Voici un peu plus de détails Voici un peu plus de détails
sur ce dossier de templates. sur ce dossier de templates.
* A priori, `X-mailer` n'est pas à modifier et devrait juste * A priori, `X-mailer` n'est pas à modifier
contenir un fichier `fr` contenant `{{mailer}}`. et devrait juste
contenir un fichier `fr` contenant `{{mailer}}`.
* De même, `To` ne devrait pas être modifié et contient `{{To}}`. * De même, `To` ne devrait pas être modifié et contient `{{To}}`.
* `From` contient le champ from du mail à envoyer. Tu peux mettre ce que tu veux. * `From` contient le champ from du mail à envoyer. Tu peux mettre ce que tu veux.
* `Subject/fr` est comme son nom l'indique le fichier définissant le sujet du mail. Il est aussi personnalisable à l'aide de variables, comme tous les autres fichiers Jinja. * `Subject/fr` est comme son nom l'indique le fichier définissant le sujet du mail.
* `body` est le dossier le plus important. C'est lui le coeur du mail. Il est aussi personnalisable à l'aide de variables,
Il contient deux fichiers `en` et `fr`, qui vont chacun former une version du mail comme tous les autres fichiers Jinja.
(en anglais, et en français respectivement). * `body` est le dossier le plus important
C'est lui le coeur du mail. Il contient
deux fichiers `en` et `fr`, qui
vont chacun former une version du mail
(en anglais, et en français respectivement).
Il n'est pas obligatoire d'avoir un mail en anglais, Il n'est pas obligatoire d'avoir un mail en anglais,
il suffit tout simplement de ne pas mettre le fichier `en`. il suffit tout simplement de ne pas mettre le fichier `en`.
Ce sont là aussi des template Jinja, personalisables Ce sont là aussi des template Jinja, personalisables
@ -147,20 +153,23 @@ de la tenue de l'assemblée générale,
crée un dossier `AGO_2026` avec l'architecture précédente, dans le dossier `template`. crée un dossier `AGO_2026` avec l'architecture précédente, dans le dossier `template`.
Puis lance le script avec les options suivantes. Puis lance le script avec les options suivantes.
``` ```bash
./mail_all.py -s 'bureau@crans.org' -A -t AGO_2020 -p ./mail_all.py -s 'bureau@crans.org' -A -t AGO_2020 -p
``` ```
* L'option `-s` permet de préciser une adresse qui va * L'option `-s` permet de préciser une adresse qui va
recevoir les bounces. recevoir les bounces.
Tu veux ici une mailing list privée, Tu veux ici une mailing list privée,
comme `respbats` (par défaut) ou `bureau`. comme `respbats` (par défaut) ou `bureau`.
* L'option `-A` permet de dire que je veux envoyer ce mail à tous les adhérents. * L'option `-A` permet de dire que je veux
* L'option `-t` est pour préciser le template du mail. envoyer ce mail à tous les adhérents.
* L'option `-p` me permet de faire une prévisualisation * L'option `-t` est pour préciser le
et de simuler l'envoi des mails. template du mail.
Cette option est de toute façon nécessaire * L'option `-p` me permet de faire une
(sauf si tu forces l'envoi du mail). prévisualisation
et de simuler l'envoi des mails.
Cette option est de toute façon nécessaire
(sauf si tu forces l'envoi du mail).
:warning: :warning:
Les consignes sont répétées pour une bonne raison. Les consignes sont répétées pour une bonne raison.
@ -178,7 +187,7 @@ Une fois que le mail est satisfaisant et que tu as bien vérifié
la liste des destinataires concernés la liste des destinataires concernés
(tous ceux que tu visais, seulement eux), tu peux utiliser l'option `--doit`. (tous ceux que tu visais, seulement eux), tu peux utiliser l'option `--doit`.
``` ```bash
./mail_all.py -s 'bureau@crans.org' -A -t AGO_2020 --doit ./mail_all.py -s 'bureau@crans.org' -A -t AGO_2020 --doit
``` ```