# www.alpinux.org

Le site public de l'association — du HTML statique, servi sur `https://alpinux.org` et
`https://www.alpinux.org` : la page d'accueil, la page des mises à jour du wiki, et la
page d'erreur 404.

Elle affiche deux choses qu'elle ne contient pas : l'**agenda**, lu dans le calendrier
public Nextcloud, et les **dernières pages du wiki**, lues dans
[`derniers-articles.json`](https://wiki.alpinux.org/derniers-articles.json) que le wiki
publie à chaque build. Si l'une ou l'autre source est injoignable, la section
correspondante se masque et le reste de la page tient debout. Le **journal des
nouveautés**, lui, vit dans le dépôt : `site/nouveautes.json`.

---

## Je veux…

| Ce que vous voulez faire | Ce que vous faites |
|---|---|
| Modifier l'accueil | Éditer `site/index.html`, pousser sur `main` — la mise en ligne suit |
| Annoncer une nouveauté | Ajouter une entrée en tête de `site/nouveautes.json` (voir plus bas) |
| Voir le rendu avant de pousser | `python3 -m http.server -d site` puis http://localhost:8000 |
| Comprendre pourquoi ça n'est pas en ligne | `tail -20 /var/log/www-deploy.log` sur le serveur |
| Republier sans nouveau commit | `sudo -u abonnelc /opt/www-alpinux/deploy-www.sh` |
| Réinstaller la chaîne de déploiement | `sudo bash deploiement/installer.sh` |
| Reprendre une modification de `deploiement/` | Relancer `installer.sh` : le serveur exécute sa copie dans `/opt/www-alpinux`, pas celle du dépôt |

En local, l'agenda reste vide : `/public-calendars/…` est relayé vers Nextcloud par le
serveur, pas par `http.server`. Les articles du wiki, eux, s'affichent normalement.

---

## Structure

```
alpinux-www/
├── site/                 ce qui part en ligne, tel quel
│   ├── index.html            l'accueil, son style et ses scripts en ligne
│   ├── modifications.html    toutes les pages du wiki, datées
│   ├── 404.html              la page d'erreur
│   ├── commun.css            la charte des deux pages secondaires
│   ├── nouveautes.json       le journal des nouveautés, lu par l'accueil
│   ├── robots.txt
│   └── sitemap.xml
└── deploiement/          la chaîne, versionnée avec le site
    ├── installer.sh          pose tout sur le serveur (root, une fois)
    ├── deploy-www.sh         git pull + rsync vers le DocumentRoot
    ├── webhook.py            service d'écoute, 127.0.0.1:9877
    ├── www-webhook.service   unité systemd
    └── vhost-deploy.conf     le relais Apache, pour trace
```

---

## Annoncer une nouveauté

La section « Nouveautés » de l'accueil est dessinée à partir de `site/nouveautes.json` —
un tableau d'entrées, `url` facultative :

```json
{
  "date": "2026-09-23",
  "titre": "Listes de diffusion",
  "texte": "Une phrase ou deux, à hauteur de visiteur.",
  "url": "https://messagerie.alpinux.org"
}
```

L'ordre du fichier n'a pas d'importance : la page trie sur `date` et n'affiche que les
six entrées les plus récentes. Les plus anciennes restent dans le fichier, comme
mémoire. Une entrée sans `titre` ou sans `date` au format `AAAA-MM-JJ` est ignorée ;
si le fichier disparaît ou devient illisible, la section se masque comme les deux autres.

---

## Les mises à jour du wiki

`site/modifications.html` liste **toutes** les pages de wiki.alpinux.org, de la plus
récemment retouchée à la plus ancienne, avec un filtre par titre ou rubrique. Elle lit
`https://wiki.alpinux.org/toutes-les-pages.json`, que le build du wiki publie à chaque
fois — comme il publie déjà `derniers-articles.json` pour l'accueil.

Si ce fichier manque, la page se rabat sur `derniers-articles.json` et le dit : on
obtient les vingt dernières pages au lieu de toutes, plutôt qu'une page vide. Les deux
sources injoignables, elle affiche un message et renvoie vers le wiki.

Le contenu se change donc **dans le dépôt du wiki**, pas ici : ajouter une page à la
navigation du wiki suffit à la faire apparaître.

---

## La page 404

`site/404.html` reprend la charte du site, annonce clairement l'erreur et propose
l'accueil, le wiki, les mises à jour et les listes de diffusion. Elle porte
`noindex, follow` : une page d'erreur n'a rien à faire dans un moteur de recherche,
mais ses liens restent bons à suivre.

**Elle ne sert à rien sans la directive Apache qui va avec.** Le `.htaccess` du
DocumentRoot — qui vit sur le serveur, pas dans ce dépôt public — doit porter :

```apache
ErrorDocument 404 /404.html
```

et **ne pas** renvoyer les adresses inconnues vers l'accueil. Une règle du type
`RewriteRule . /index.html [L]` produit un « soft 404 » : le visiteur voit l'accueil,
le moteur de recherche enregistre une page valide, et personne ne sait que l'adresse
était fausse.

```bash
# ce qu'on doit lire une fois la directive en place
curl -o /dev/null -w '%{http_code}\n' https://alpinux.org/adresse-qui-nexiste-pas   # 404
```

---

## Ce qui se passe après un push

```
git push  (sur main)
       │
Gitea (origin/main)
       │  webhook  ──▶  https://alpinux.org/deploy  ──▶  service d'écoute (signature vérifiée)
       ▼
deploy-www.sh :  git pull  →  index.html complet ?  →  rsync vers le DocumentRoot
       ▼
https://alpinux.org
```

Compter moins d'une minute. Le garde-fou est modeste mais réel : un `index.html` tronqué
— transfert coupé, conflit mal résolu — ne part pas en ligne.

---

## Les deux pièges à connaître

**Supprimer un fichier ici ne le retire pas du serveur.** Le `rsync` de déploiement est
volontairement sans `--delete` : le DocumentRoot contient aussi des fichiers qui ne sont
pas dans ce dépôt — le `.htaccess` qui relaie `/public-calendars` vers Nextcloud, les
pages d'erreur et les statistiques d'ISPConfig. Un `--delete` les emporterait. Retirer un
fichier en ligne se fait donc à la main, sur le serveur.

**Le serveur n'écrit dans le DocumentRoot que par une ACL.** `web11/web` appartient à
l'utilisateur `web11` ; `installer.sh` pose un `setfacl` pour l'utilisateur du service.
Si ISPConfig réinitialise les droits du site un jour, le déploiement échouera avec une
erreur de permission — relancer `installer.sh` suffit à la remettre.

---

## Historique

Ce dépôt est né le 2026-09-20, par détachement du monorepo `alpinux.site.2026` où la page
vivait sous `home/`. Elle y était **déployée à la main**, et le dépôt avait fini par
diverger : la version en ligne portait quatre mois de modifications faites directement sur
le serveur et jamais revenues dans git. C'est ce qui a motivé le webhook.