Alpinux cf03c2fcec Mettre la documentation de déploiement à jour pour ce dépôt

Ces pages ont été écrites du temps du monorepo et décrivaient encore un clone de
alpinux.site.2026 avec un sous-dossier wiki/, ainsi qu'un déploiement par rsync
depuis un poste local — alors que le serveur construit le site lui-même, déclenché
par un webhook Gitea.

- contribuer.md, linux-mint-guide.md, l'article Linux Mint : liens et URL raw
  vers alpinux-wiki. L'URL de install.sh redevient valide au passage : elle
  pointait sur code/ à la racine, chemin qui n'existait pas dans le monorepo.
- deploiement-wiki.md : chemins sans le sous-dossier wiki/, script de déploiement
  réel (build en staging), webhook décrit comme le mode normal et non plus comme
  une option, avec la mise en garde qu'il n'écoute que ce dépôt.
- README.md : flux de publication réel, et le -d indispensable au build local
  puisque site_dir vise le DocumentRoot du serveur.

deploiement-dynamic.md mentionne lui aussi un clone du monorepo, mais il concerne
l'application dynamic : à corriger avec son dépôt, pas ici.

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

2026-09-19 21:04:14 +02:00

2.8 KiB

Raw Blame History

wiki.alpinux.org

Documentation, guides et ressources du LUG Alpinux — Savoie. Accessible sur https://wiki.alpinux.org.

Construit avec MkDocs Material. Les sources sont des fichiers Markdown ; le site HTML est généré sur le serveur, à chaque push sur main.

Flux de publication

Modifier  →  git commit  →  git push  →  webhook Gitea  →  git pull + mkdocs build sur le serveur

git add .
git commit -m "..."
git push                        # → gitea.alpinux.org:alpinux.cedrica5l/alpinux-wiki

C'est tout : le push suffit. Le webhook déclenche deploy-wiki.sh sur le serveur, qui construit le site dans un répertoire de staging et ne le met en ligne que si le build a réussi. La procédure complète, et quoi faire quand le webhook ne répond pas, sont décrites dans Déploiement du wiki.

Le webhook est attaché à ce dépôt. Un push dans l'ancien monorepo alpinux.site.2026 ne publie rien.

Structure des sources

.
├── mkdocs.yml          # Configuration MkDocs (nav, thème, plugins)
├── docs/               # Pages Markdown
│   ├── index.md
│   ├── alpinux/        # Présentation, FAQ, événements
│   ├── guides/         # Guides pratiques (Linux Mint, Docker, chiffrement…)
│   ├── presentations/  # Supports de présentations passées
│   ├── technique/      # Documentation technique (déploiement, serveur…)
│   └── communication/
├── overrides/          # Surcharges du thème Material
├── articles/           # Articles longs (hors nav principale)
├── code/               # Exemples de code référencés dans le wiki
└── scripts/            # Scripts utilitaires (build-assets.py)

Les images des articles ne sont pas versionnées : elles sont hébergées sur static.alpinux.org. Le logo PNG est généré depuis le SVG par scripts/build-assets.py.

Développement local

python3 -m venv venv && source venv/bin/activate
pip install mkdocs-material
mkdocs serve
# → http://localhost:8000  (rechargement automatique à chaque modification)

Pour vérifier que le build est propre (liens, structure) avant de pousser :

mkdocs build --strict -d /tmp/wiki-build

Le -d est nécessaire en local : le site_dir de mkdocs.yml pointe vers le DocumentRoot Apache du serveur, pas vers un chemin local.

Déploiement serveur (ISPConfig)

Le wiki est servi statiquement par Apache via ISPConfig :

DocumentRoot : /var/www/clients/client1/web2/web/wiki-static
Let's Encrypt SSL activé
Aucun service à redémarrer après un déploiement

Voir aussi

Vue d'ensemble des projets, procédures de déploiement globales et accès :
~/Projects/org.alpinux.owni/README.md

2.8 KiB Raw Blame History