Merge remote-tracking branch 'origin/doc-derniers-articles'

La branche accueil-derniers-articles portait cette section, mais aussi une
seconde version du hook — or celui de main fait déjà le travail, et tourne.
Garder les deux aurait fait un conflit pour rien.

Un paragraphe est corrigé au passage : il annonçait que le hook faisait foi
sur le .htaccess et qu'il fallait y ajouter ses règles. Celui de main ajoute
son bloc à la suite d'un .htaccess existant au lieu de le remplacer ; les
règles durables se placent donc dans docs/.htaccess, que MkDocs recopie.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_014SsLBE8w2R235EG5an6Knb

docs/alpinux/donnees-personnelles.md

@@ -70,10 +70,13 @@ occupe l'association. Il part du serveur de l'association.
 
 **Qui la reçoit.** Les adhérents, et toute personne qui a demandé à la recevoir. Une
 inscription à une install party ne vous y abonne pas : il faut l'avoir demandé. Pour
-la recevoir sans être adhérent, écrivez à **secretaire@alpinux.org**.
+la recevoir sans être adhérent, abonnez-vous vous-même sur
+**[messagerie.alpinux.org](https://messagerie.alpinux.org)** — la marche à suivre est
+décrite dans [S'abonner et se désabonner](messagerie-abonnement.md#inscription).
 
-**Comment s'en aller.** Chaque envoi porte un lien de désinscription. Un clic suffit,
-il n'y a rien à justifier, et le retrait est immédiat. Vous continuerez à recevoir les
+**Comment s'en aller.** Chaque envoi porte un lien de désinscription, en pied de page
+et dans ses en-têtes. Un clic suffit, il n'y a rien à justifier, et le retrait est
+immédiat. Vous continuerez à recevoir les
 messages liés à vos inscriptions en cours — ce sont deux choses distinctes.
 
 ---

docs/alpinux/messagerie-abonnement.md

@@ -0,0 +1,129 @@
+---
+description: Comment s'abonner à une liste de diffusion d'Alpinux, confirmer son adresse, se désabonner, et lire les messages déjà envoyés.
+---
+
+# ✉️ S'abonner et se désabonner
+
+Ce guide s'adresse à toute personne qui veut **recevoir les annonces de
+l'association**, ou cesser de les recevoir. Aucun compte n'est nécessaire.
+
+**En une phrase :** vous vous abonnez et vous vous désabonnez vous-même, personne ne
+peut le faire à votre place, et rien ne part vers une adresse qui ne l'a pas
+demandé.
+
+---
+
+## S'abonner { #inscription }
+
+Rendez-vous sur la page d'accueil de la messagerie de l'association.
+
+<!-- capture : page d'accueil publique, formulaire d'inscription vide -->
+
+Indiquez votre adresse de courriel, choisissez la liste qui vous intéresse, puis
+**Continuer**.
+
+L'écran suivant affiche un **code** — de la forme `ALPX-7K3M9Q` — et vous demande de
+faire une chose, une seule :
+
+!!! tip "Envoyez-nous un message depuis l'adresse que vous venez de saisir"
+    Destinataire : **messagerie@alpinux.org**
+    Objet : **le code affiché**, recopié tel quel
+    Corps du message : ce que vous voulez, il n'est pas lu
+
+<!-- capture : écran du code, avec le code et l'heure limite -->
+
+Un bouton **Ouvrir mon logiciel de messagerie** prépare le message pour vous. Il ne
+l'envoie pas : c'est à vous de le faire.
+
+Vous avez **trente minutes**. Passé ce délai, le code ne vaut plus rien et la demande
+s'efface d'elle-même — sans aucune conséquence, vous pouvez recommencer.
+
+Dans la minute qui suit votre envoi, vous recevez une réponse qui confirme
+l'inscription, rappelle la liste, et porte déjà le lien pour partir.
+
+<!-- capture : le message de confirmation reçu, adresse du destinataire masquée -->
+
+### Pourquoi est-ce à moi d'écrire ?
+
+D'habitude, un site vous envoie un courriel de confirmation. Ici, c'est l'inverse.
+Trois raisons.
+
+- **Rien ne part vers une adresse non vérifiée.** Écrire à des adresses non
+  confirmées est ce qui abîme le plus la réputation d'un expéditeur — et quand elle
+  est abîmée, ce sont les messages de toute l'association qui finissent en
+  indésirable, chez tout le monde.
+- **Inscrire l'adresse de quelqu'un d'autre ne lui envoie rien.** La demande reste en
+  attente puis s'efface. Personne ne peut vous abonner à votre insu, ni se servir de
+  ce formulaire pour vous faire parvenir un message.
+- **Un message venu de votre boîte prouve mieux que vous la possédez** qu'un clic sur
+  un lien : certains antivirus d'entreprise cliquent les liens tout seuls.
+
+La contrepartie, c'est une manipulation à faire. Elle est assumée.
+
+### Je me suis déjà abonné, ou désabonné, par le passé
+
+Le parcours est le même. C'est d'ailleurs **le seul moyen de revenir** : l'association
+ne réinscrit jamais personne de sa propre initiative.
+
+### Je n'ai pas reçu la confirmation
+
+Trois choses à vérifier, dans cet ordre :
+
+1. **Avez-vous écrit depuis l'adresse que vous aviez saisie ?** Le code ne vaut que
+   présenté depuis celle-ci. Un message envoyé depuis une autre boîte est refusé.
+2. **Les trente minutes sont-elles passées ?** Recommencez, c'est sans conséquence.
+3. **Le code était-il bien dans l'objet ?** Il est aussi reconnu dans le corps du
+   message, mais l'objet est le plus sûr.
+
+---
+
+## Se désabonner { #desabonnement }
+
+**Chaque message reçu porte un lien de désabonnement**, à deux endroits : en pied de
+page, et dans les en-têtes techniques du message.
+
+C'est ce second emplacement qui fait apparaître un bouton **Se désabonner** en haut
+du message dans les logiciels modernes — Gmail, Outlook, Thunderbird, Apple Mail. Un
+clic suffit.
+
+<!-- capture : un message reçu, bouton « Se désabonner » du client de messagerie -->
+
+La page qui s'ouvre vous laisse choisir :
+
+- quitter **cette liste seulement** ;
+- ou quitter **toutes les listes** de l'association d'un coup.
+
+<!-- capture : page de désabonnement, adresse masquée -->
+
+Aucune justification n'est demandée. Le retrait est immédiat, et il n'y a personne à
+qui écrire.
+
+!!! note "Vous n'avez plus aucun message sous la main ?"
+    Reprenez simplement le parcours d'inscription : il vous renverra un message, qui
+    portera le lien.
+
+---
+
+## Lire ce qui a déjà été envoyé { #archives }
+
+Les listes ouvertes au public ont des **archives** consultables sans compte. C'est
+utile avant de s'abonner, pour voir à quoi on s'engage.
+
+<!-- capture : index des archives, liste des envois par date -->
+
+Seuls y figurent les messages **réellement envoyés** : ni les brouillons, ni les
+envois annulés.
+
+!!! info "Aucune adresse de courriel n'apparaît dans les archives"
+    Les adresses citées dans le corps d'un message — signature, contact d'un
+    événement, adresse d'un partenaire — y sont remplacées par `[adresse masquée]`.
+    Leurs titulaires n'ont pas consenti à une publication sur le web, où un robot les
+    ramasserait pour en faire du spam.
+
+---
+
+## Voir aussi
+
+- [Vos données, vos adresses, nos envois](donnees-personnelles.md)
+- [Écrire et recevoir des messages](messagerie-membre.md) — la messagerie entre
+  membres, qui est autre chose que les listes.

docs/alpinux/messagerie-gestionnaire.md

@@ -0,0 +1,296 @@
+---
+description: Guide du gestionnaire de listes Alpinux — créer une liste, préparer et envoyer un message, gérer les abonnés, comprendre les adresses désactivées et surveiller la réputation d'envoi.
+---
+
+# 📣 Gérer une liste de diffusion
+
+Ce guide s'adresse aux personnes qui **écrivent à toute une liste** : le bureau, et
+les administrateurs de l'outil.
+
+**En une phrase :** vous rédigez un brouillon, vous le mettez en file d'envoi, et un
+automate le distribue en lissant le débit pendant que vous faites autre chose.
+
+!!! warning "N'envoyez plus de message en copie cachée depuis votre logiciel de messagerie"
+    Les deux méthodes ne se coordonnent pas : l'outil ne saurait rien de ce qui est
+    parti par l'autre chemin, ni des rebonds que cela aurait provoqués. Et c'est
+    précisément ce mode d'envoi qui saturait le serveur — au-delà d'un certain
+    nombre de messages par heure, il refuse les suivants et une partie de l'envoi
+    est perdue sans que personne le voie.
+
+---
+
+## Envoyer un message à une liste { #envoyer }
+
+### 1. Rédiger
+
+Menu **Listes → Campagnes**, puis **Nouvelle campagne**.
+
+<!-- capture : formulaire de rédaction, aperçu à côté -->
+
+Choisissez la liste destinataire, écrivez l'objet et le corps.
+
+Le corps s'écrit en **Markdown** — la même syntaxe que ce wiki, voir
+[Écrire en Markdown](../contribuer/markdown.md). Un aperçu s'affiche à côté ; le
+bouton **Enregistrer et actualiser l'aperçu** le rafraîchit.
+
+Trois variables sont remplacées à l'envoi, pour chaque destinataire :
+
+| Variable | Remplacée par |
+|---|---|
+| `{{nom}}` | le nom de l'abonné, s'il est connu |
+| `{{email}}` | son adresse |
+| `{{desabonnement}}` | le lien de désabonnement qui lui est propre |
+
+**Enregistrer le brouillon** vous permet de revenir plus tard : rien ne part tant que
+vous n'avez rien demandé.
+
+!!! danger "Le lien de désabonnement n'est pas optionnel"
+    Si vous ne placez pas `{{desabonnement}}` vous-même, un lien est ajouté
+    automatiquement en pied de message. Ce comportement ne se désactive pas : un
+    envoi de masse sans lien de désabonnement est signalé comme spam, et c'est
+    ensuite toute l'association qui n'arrive plus à écrire à personne.
+
+### 2. Vérifier avant d'envoyer
+
+Relisez l'aperçu. C'est le dernier moment confortable : une fois la file remplie, ce
+qui est parti est parti.
+
+Deux choses valent le coup d'œil :
+
+- **les liens** — un lien faux dans un message envoyé à toute la liste ne se
+  rattrape pas ;
+- **le nombre de destinataires**, affiché sur la fiche de la liste.
+
+### 3. Envoyer
+
+Bouton **Mettre en file d'envoi…**. Une confirmation vous est demandée, avec le
+nombre de destinataires.
+
+<!-- capture : écran de confirmation avant mise en file -->
+
+L'envoi se fait ensuite tout seul, une minute sur l'autre, **sous un plafond horaire**
+fixé pour ne pas saturer le serveur. Une liste de quelques centaines de personnes
+part en une heure environ.
+
+Vous pouvez fermer la page : l'envoi continue.
+
+### 4. Suivre
+
+La fiche de la campagne affiche la progression : envoyés, en attente, échecs.
+
+<!-- capture : fiche de campagne en cours d'envoi, barre de progression -->
+
+Si le compteur semble figé, c'est probablement le plafond horaire : l'envoi reprend
+de lui-même à l'heure suivante.
+
+### Arrêter, recommencer
+
+- **Annuler les envois restants…** abandonne ce qui n'est pas encore parti. Ce qui
+  est déjà distribué ne revient pas.
+- **Dupliquer en brouillon** recrée une copie modifiable d'un envoi passé — pratique
+  pour une lettre dont la structure ne change pas d'un mois sur l'autre.
+
+---
+
+## Créer une liste { #creer }
+
+Menu **Listes → Listes de diffusion**, puis le formulaire de création.
+
+<!-- capture : formulaire de création d'une liste -->
+
+Seuls **le nom** et **la description** sont demandés. Le reste est automatique :
+
+- l'**identifiant technique** se déduit du nom ;
+- l'**expéditeur** est celui de l'association, suivi du nom de l'auteur à
+  l'envoi — « Alpinux (de la part de Prénom Nom) » ;
+- les **réponses** reviennent à l'adresse d'expédition, qui est relevée.
+
+Rien de cela ne se règle liste par liste : l'association écrit sous une seule
+identité. Multiplier les expéditeurs éparpille la réputation du domaine autant que
+cela désoriente les destinataires.
+
+!!! note "Le nom d'une liste n'est pas modifiable après création"
+    Relisez-le avant de valider.
+
+---
+
+## Gérer les abonnés { #abonnes }
+
+Menu **Listes → Listes de diffusion**, puis la liste voulue.
+
+<!-- capture : fiche de liste, compteurs et tableau des abonnés, adresses masquées -->
+
+Quatre compteurs résument l'état : destinataires joignables, inscrits au total,
+désabonnés, adresses mortes.
+
+### Les adresses sont masquées
+
+Elles s'affichent sous la forme `c••••••e@exemple.fr`. Le domaine reste lisible — il
+suffit au diagnostic — sans étaler à l'écran un carnet d'adresses exploitable.
+
+Un lien **Afficher les adresses en clair** lève le masque quand c'est nécessaire.
+
+### Ajouter des abonnés
+
+Deux moyens, dans le volet **Ajouter des abonnés** :
+
+- **coller une liste d'adresses**, une par ligne. Les formes `nom@exemple.fr`,
+  `nom@exemple.fr;Prénom Nom` et `Prénom Nom <nom@exemple.fr>` sont acceptées ;
+- **importer depuis Dolibarr** les adhérents à jour de cotisation.
+
+!!! danger "Un import ne réactive jamais une adresse partie"
+    Désabonnée, morte, ou ayant signalé un spam : l'outil refuse de la remettre en
+    service, même si elle figure dans le fichier importé. Seule la personne
+    concernée peut revenir, par le parcours d'inscription.
+
+    Réinscrire quelqu'un qui est parti est le meilleur moyen de se faire signaler
+    comme spam — et cette fois définitivement.
+
+---
+
+## Ouvrir une liste au public { #publique }
+
+*Réservé aux administrateurs.*
+
+Sur la fiche de la liste, cochez **Liste publique** et enregistrez.
+
+<!-- capture : case « Liste publique » cochée -->
+
+Trois conséquences, à peser avant de cocher :
+
+- n'importe qui peut **demander à s'abonner** depuis la page d'accueil ;
+- les envois passés deviennent **lisibles publiquement** dans les archives ;
+- le **nom et la description** de la liste sont visibles de tout visiteur.
+
+Ce dernier point n'est pas anodin pour une liste interne. Le geste est enregistré
+dans le journal de l'outil.
+
+### Les demandes en attente
+
+Quand une liste est publique, la fiche affiche les **demandes d'inscription en
+attente de confirmation**, avec leur heure d'expiration.
+
+<!-- capture : tableau des demandes en attente, adresses masquées -->
+
+Ces adresses **ne sont pas inscrites** et ne le seront que si leurs titulaires
+confirment depuis leur propre boîte. Il n'y a rien à faire : celles qui restent
+s'effacent seules.
+
+---
+
+## Les adresses désactivées { #desactivees }
+
+Menu **Listes → Adresses désactivées**.
+
+L'écran comporte deux tableaux, et la différence entre les deux est importante.
+
+### Rejets définitifs et plaintes
+
+Ces adresses ont été retirées de **toutes** les listes : le serveur d'en face a
+répondu que la boîte n'existait pas, ou la personne nous a signalés comme spam.
+
+<!-- capture : tableau des rejets définitifs, adresses masquées -->
+
+La colonne de droite affiche **le texte exact du refus**, extrait du rapport reçu —
+« utilisateur inconnu », « boîte pleine », le nom d'une liste noire. Le rapport
+complet est dépliable si vous voulez tout lire.
+
+Continuer à écrire à ces adresses abîmerait la réputation du serveur pour tous les
+autres envois. C'est pourquoi l'outil les écarte sans demander.
+
+### Blocages d'opérateur
+
+**Ces adresses-là sont conservées**, et c'est délibéré.
+
+Le message a été refusé non pas parce que la boîte a disparu, mais parce qu'un
+opérateur refuse *notre* serveur — un grand fournisseur de messagerie qui nous a mis
+sur une liste d'attente, ou un serveur qui interroge une liste noire.
+
+<!-- capture : tableau des blocages d'opérateur -->
+
+La distinction est vitale. Une part notable des abonnés d'une association tient ses
+adresses chez deux ou trois grands fournisseurs : les traiter comme mortes parce que
+l'un d'eux nous bloque un jour ferait perdre d'un coup une fraction de la liste, en
+silence, pour une faute qui n'est pas la leur.
+
+Quand cette section se remplit, ce n'est donc pas un problème d'abonnés mais de
+réputation d'envoi. Le délistage se demande auprès de l'opérateur concerné.
+
+---
+
+## Surveiller la réputation d'envoi { #postmaster }
+
+*Réservé aux administrateurs.* Menu **Configuration → Postmaster**.
+
+Les grands opérateurs de messagerie envoient chaque jour un rapport disant **quelles
+adresses IP ont émis du courrier au nom du domaine de l'association**, et si ces
+envois étaient correctement signés. L'outil les dépouille tout seul.
+
+<!-- capture : tableau de bord postmaster, colonnes IP / messages / alignés -->
+
+Deux lectures valent le détour :
+
+- **une adresse IP inconnue dans la liste** : quelqu'un émet en notre nom. Usurpation,
+  ou service de l'association qu'on avait oublié ;
+- **une adresse IP connue mais jamais alignée** : elle émet sans être autorisée par
+  nos enregistrements, et ses messages tombent en indésirable chez tout le monde.
+
+Le second tableau liste le courrier reçu à l'adresse *postmaster* que l'automate n'a
+pas su traiter — avis d'opérateur, signalement — et qui attend une lecture humaine.
+Le bouton **Marquer comme lu** le retire de la liste une fois traité.
+
+---
+
+## Attribuer les rôles { #droits }
+
+*Réservé aux administrateurs.* Menu **Configuration → Droits**.
+
+<!-- capture : écran des droits, noms anonymisés -->
+
+Trois rôles indépendants, cumulables :
+
+| Rôle | Donne accès à |
+|---|---|
+| Rédacteur | la section **Listes** : campagnes et abonnés |
+| Administrateur | les listes publiques, les imports, **Droits** et **Postmaster** |
+| Messagerie interne | la section **Messagerie** |
+
+Un administrateur ne peut pas se retirer lui-même l'administration : l'outil refuse
+de se retrouver sans personne pour le gérer. Demandez-le à un autre administrateur.
+
+---
+
+## Questions fréquentes
+
+??? question "Mon envoi semble arrêté à mi-parcours"
+    C'est le plafond horaire. L'envoi reprend de lui-même à l'heure suivante, et la
+    fiche de la campagne affiche ce qui reste en attente.
+
+??? question "Une adresse apparaît comme désactivée alors qu'elle fonctionne"
+    Regardez dans quel tableau elle se trouve. Dans **Blocages d'opérateur**, elle
+    n'est pas désactivée et il n'y a rien à faire de ce côté. Dans **Rejets
+    définitifs**, lisez le texte du refus : il dit précisément ce que le serveur
+    distant a répondu.
+
+??? question "Quelqu'un veut revenir après s'être désabonné"
+    Il doit refaire le parcours d'inscription lui-même. Ne le réinscrivez pas à la
+    main : l'outil l'interdit, et pour de bonnes raisons.
+
+??? question "Puis-je renvoyer exactement le même message plus tard ?"
+    Oui, **Dupliquer en brouillon** sur la campagne passée. Vérifiez les dates et les
+    liens avant de renvoyer : ce qui était vrai il y a un mois ne l'est plus
+    forcément.
+
+??? question "Comment savoir qui a ouvert le message ?"
+    On ne le sait pas, et c'est voulu. Les messages ne contiennent ni image de suivi
+    ni lien piégé. Ce que l'on sait, c'est ce qui a été **remis** et ce qui a
+    **rebondi**.
+
+---
+
+## Voir aussi
+
+- [S'abonner et se désabonner](messagerie-abonnement.md) — ce que voient les
+  personnes à qui vous écrivez.
+- [Vos données, vos adresses, nos envois](donnees-personnelles.md)
+- [Écrire en Markdown](../contribuer/markdown.md)

docs/alpinux/messagerie-membre.md

@@ -0,0 +1,120 @@
+---
+description: La messagerie interne d'Alpinux — écrire à un autre membre sans connaître son adresse, lire ses messages, régler ses avis par courriel.
+---
+
+# 💬 Écrire et recevoir des messages
+
+Ce guide s'adresse aux **membres** de l'association qui veulent s'écrire entre eux.
+
+C'est autre chose que les listes de diffusion : ici, personne ne diffuse à tout le
+monde. On écrit à une personne, et elle seule.
+
+**En une phrase :** vous écrivez à quelqu'un sans connaître son adresse, et il vous
+répond sans connaître la vôtre.
+
+!!! info "Il faut être connecté"
+    La messagerie interne demande le **compte de l'association**, le même que pour
+    le portail. Le rôle correspondant est attribué par un administrateur.
+
+---
+
+## Lire mes messages { #boite }
+
+Menu **Messagerie → Mes messages**.
+
+<!-- capture : boîte de réception, noms des correspondants anonymisés -->
+
+Le nombre de messages non lus apparaît à côté du mot **Messagerie** dans le menu :
+vous le voyez donc depuis n'importe quel écran, sans avoir à aller voir.
+
+Un message s'ouvre d'un clic sur son objet. Il est marqué lu à ce moment-là.
+
+---
+
+## Écrire à quelqu'un { #ecrire }
+
+Menu **Messagerie → Écrire**.
+
+<!-- capture : formulaire d'écriture, annuaire déroulé, noms anonymisés -->
+
+Choisissez le destinataire dans la liste proposée : c'est l'annuaire des membres.
+**Vous n'avez pas besoin de son adresse** — vous ne la verrez pas, et il ne verra pas
+la vôtre.
+
+Écrivez l'objet et le message, puis envoyez.
+
+### Ce que reçoit votre destinataire
+
+Un **avis** par courriel, qui dit qu'un message l'attend, de la part de qui, et sur
+quel sujet. **Le texte du message n'est pas recopié dans cet avis** : il faut se
+connecter pour le lire.
+
+C'est volontaire. Un avis qui recopierait le message rendrait la messagerie interne
+inutile — autant s'écrire directement.
+
+---
+
+## Régler mes avis par courriel { #avis }
+
+Menu **Configuration → Mon profil**.
+
+<!-- capture : préférences, adresse de l'utilisateur masquée -->
+
+Vous y choisissez :
+
+- **si** vous voulez être prévenu par courriel quand un message arrive ;
+- **à quelle adresse** ces avis doivent partir.
+
+### Le résumé quotidien
+
+Si des messages restent non lus, un **résumé** part une fois par jour — et seulement
+les jours où quelque chose est arrivé. Il dit qui vous a écrit et sur quels sujets.
+
+Ni le corps des messages, ni les adresses des auteurs n'y figurent.
+
+Il se coupe depuis le même écran que les avis.
+
+---
+
+## Emporter mes messages { #export }
+
+Menu **Messagerie → Copie de mes messages**.
+
+Vous téléchargez l'ensemble de vos messages — reçus et envoyés — dans une archive.
+Chaque message y est au format standard des courriels, lisible par n'importe quel
+logiciel de messagerie.
+
+C'est ce qu'il faut utiliser pour garder une trace hors de l'outil, ou pour exercer
+votre droit d'accès à vos données.
+
+---
+
+## Questions fréquentes
+
+??? question "Mon correspondant verra-t-il mon adresse ?"
+    Non. Les messages ne circulent pas par courriel entre vous : ils restent dans
+    l'outil. Seuls les **avis** partent par courriel, et chacun part vers l'adresse
+    de son propre destinataire.
+
+??? question "Puis-je répondre depuis mon logiciel de messagerie ?"
+    Non. L'avis est une notification, pas le message. Il faut se connecter pour lire
+    et répondre — c'est la contrepartie de ne pas divulguer les adresses.
+
+??? question "Je ne reçois plus d'avis"
+    Vérifiez d'abord **Configuration → Mon profil** : les avis y sont peut-être
+    coupés. S'ils sont actifs et que rien n'arrive, c'est probablement que votre
+    adresse a rebondi ; l'outil suspend alors les avis pour ne pas s'acharner.
+    Signalez-le à un administrateur, qui le verra dans ses écrans.
+
+??? question "Puis-je écrire à quelqu'un qui n'est pas dans l'annuaire ?"
+    Non. L'annuaire ne contient que les membres à qui un rôle a été attribué. Pour
+    écrire à quelqu'un d'autre, il faut son adresse et un logiciel de messagerie
+    ordinaire.
+
+---
+
+## Voir aussi
+
+- [S'abonner et se désabonner](messagerie-abonnement.md) — les listes de diffusion,
+  qui sont autre chose.
+- [Vos données, vos adresses, nos envois](donnees-personnelles.md)

docs/alpinux/messagerie.md

@@ -0,0 +1,50 @@
+---
+description: La messagerie d'Alpinux — trois guides selon que vous voulez vous abonner, écrire aux membres, ou gérer une liste de diffusion.
+---
+
+# 📬 La messagerie d'Alpinux
+
+La messagerie de l'association sert à deux choses qu'il ne faut pas confondre :
+
+- **les listes de diffusion**, par lesquelles le bureau écrit à tout le monde ;
+- **la messagerie interne**, par laquelle les membres s'écrivent entre eux sans se
+  communiquer leurs adresses.
+
+Selon ce que vous voulez faire, la suite n'est pas la même.
+
+---
+
+## Je veux…
+
+| Ce que vous voulez faire | Le guide qu'il vous faut |
+|---|---|
+| Recevoir les annonces de l'association, ou arrêter de les recevoir | [S'abonner et se désabonner](messagerie-abonnement.md) |
+| Lire ce qui a déjà été envoyé | [S'abonner et se désabonner](messagerie-abonnement.md#archives) |
+| Écrire à un autre membre, ou lire mes messages | [Écrire et recevoir des messages](messagerie-membre.md) |
+| Envoyer un message à toute une liste | [Gérer une liste de diffusion](messagerie-gestionnaire.md) |
+| Ajouter des abonnés, ouvrir une liste au public | [Gérer une liste de diffusion](messagerie-gestionnaire.md) |
+| Comprendre pourquoi une adresse ne reçoit plus rien | [Gérer une liste de diffusion](messagerie-gestionnaire.md#desactivees) |
+
+---
+
+## Qui peut quoi
+
+L'accès aux écrans dépend d'un rôle, attribué par un administrateur dans
+**Configuration → Droits**.
+
+| Vous êtes… | Vous voyez… |
+|---|---|
+| Une personne sans compte | l'inscription et les archives des listes publiques |
+| Membre | la section **Messagerie** |
+| Rédacteur | la section **Listes** |
+| Administrateur | tout, plus **Configuration → Droits** et **Configuration → Postmaster** |
+
+Une même personne peut cumuler les trois.
+
+---
+
+## Voir aussi
+
+- [Vos données, vos adresses, nos envois](donnees-personnelles.md) — ce que
+  l'association recueille, combien de temps elle le garde, et ce que vous pouvez
+  exiger.

docs/technique/deploiement-wiki.md

@@ -181,6 +181,49 @@ Une exécution réussie encadre le build par une ligne `Deploy started` et une l
 
 ---
 
+## Ce que le build publie pour la page d'accueil
+
+Chaque build écrit, à la racine du site, un fichier **`derniers-articles.json`** : les
+vingt dernières pages créées ou modifiées, avec leur titre, leur adresse et la date du
+commit qui a touché leur contenu. C'est ce fichier que lit la page d'accueil
+d'alpinux.org pour afficher « Le wiki, fraîchement mis à jour ».
+
+Il est produit par le hook `hooks/derniers_articles.py`, déclaré dans `mkdocs.yml`.
+Trois choses à savoir :
+
+- **Un déplacement n'est pas une mise à jour.** Les dates viennent de `git log` avec
+  suivi des renommages : déplacer `guides/truc.md` ne fait pas remonter l'article en
+  tête de liste, seule une modification de son texte le fait.
+- **Seules les pages de la navigation sont annoncées.** Une page absente de `nav` —
+  typiquement la redirection laissée derrière un article déplacé — n'apparaît jamais
+  dans la liste.
+- **Le hook n'échoue jamais.** Sans historique git, il n'écrit rien et le build
+  continue ; l'accueil d'alpinux.org masque alors simplement sa section wiki. Ses
+  messages sont pour cela de niveau *info* et jamais *warning* : le déploiement
+  construit avec `--strict`, où un seul avertissement suffit à interrompre le build,
+  et donc la publication.
+
+Le même hook pose l'en-tête `Access-Control-Allow-Origin` sur ce seul fichier, au
+moyen d'un `.htaccess` déposé à la racine du site construit. Sans lui, le navigateur
+refuserait à alpinux.org le droit de lire une réponse venue de wiki.alpinux.org.
+
+!!! warning "Deux conditions"
+    **Le clone doit avoir son historique.** Un clone `--depth 1` ne porte qu'un
+    commit : toutes les pages sembleraient modifiées le même jour. Le hook le détecte
+    et le signale dans le journal du build, sans rien casser.
+
+    **Un `.htaccess` posé à la main sur le serveur est effacé au déploiement suivant**,
+    puisque le staging est recopié avec `rsync --delete`. Pour ajouter des règles
+    Apache durables, placez-les dans `docs/.htaccess` : MkDocs le recopie dans le site
+    construit, et le hook **ajoute** son bloc à la suite au lieu de le remplacer.
+
+```bash
+# vérifier ce que le dernier build a publié
+curl -s https://wiki.alpinux.org/derniers-articles.json | head -20
+```
+
+---
+
 ## En cas d'erreur de build
 
 Si `mkdocs build` échoue, le site en ligne **n'est pas modifié** — l'ancien contenu reste en place. Lisez le message d'erreur : il indique généralement le fichier et la ligne problématiques.
@@ -212,4 +255,5 @@ Ouvrez [http://localhost:8000](http://localhost:8000) — MkDocs recharge automa
 | Vérifier le build avant de pousser | `mkdocs build --strict -d /tmp/wiki-build` |
 | Déployer à la main (webhook en panne) | `deploy-wiki.sh`, sur le serveur |
 | Voir le journal des déploiements | `tail -20 /var/log/wiki-deploy.log` |
+| Vérifier la liste envoyée à l'accueil | `curl -s https://wiki.alpinux.org/derniers-articles.json` |
 | Régénérer les fichiers du logo (poste local) | `python3 scripts/build-assets.py` |

mkdocs.yml

@@ -89,6 +89,11 @@ nav:
       - J'organise une install party: alpinux/installparty-organisateur.md
     - Présentations passées: alpinux/presentations.md
     - Événements & RDV: alpinux/evenements.md
+    - Messagerie et listes:
+      - alpinux/messagerie.md
+      - S'abonner et se désabonner: alpinux/messagerie-abonnement.md
+      - Écrire et recevoir des messages: alpinux/messagerie-membre.md
+      - Gérer une liste de diffusion: alpinux/messagerie-gestionnaire.md
     - Vos données, vos adresses, nos envois: alpinux/donnees-personnelles.md
   - Présentations:
     - presentations/libreoffice.md