e3d32ba55d
Le premier déploiement depuis le nouveau dépôt a montré deux inexactitudes de cette page, héritées de sa rédaction initiale : - le logo n'est pas généré au déploiement. Le thème et les pages chargent le logo depuis static.alpinux.org par URL complète ; build-assets.py ne sert qu'à fabriquer les fichiers à y téléverser, et demande Pillow et Chromium, absents du serveur. L'étape correspondante et les prérequis associés sont retirés, le script de déploiement n'a jamais appelé ce script. - le service d'écoute n'est pas injoignable de l'extérieur : Apache proxifie /deploy vers lui. C'est la signature HMAC qui le protège, pas l'isolement. Au passage : procédure manuelle présentée comme un secours et non comme le mode normal, clone par clé de déploiement en lecture seule, et tableau récapitulatif refait autour du fait que publier se résume à git push. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01PcZ7hL9aVvMhRuzxXLT2DG |
||
|---|---|---|
| articles | ||
| code/linux/linux-mint | ||
| docs | ||
| overrides | ||
| scripts | ||
| .gitignore | ||
| mkdocs.yml | ||
| README.md | ||
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.2026ne 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
-dest nécessaire en local : lesite_dirdemkdocs.ymlpointe 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