wiki.alpinux.org — documentation publique MkDocs Material

Find a file

Alpinux 2e90eaf2af README : le dépôt vit désormais dans ~/Projects/alpinux.wiki Il était rangé sous ~/Projects/org.alpinux.owni/wiki, à côté des applications Flask de l'association, alors qu'il n'a rien à partager avec elles : dépôt distinct, déploiement autonome, contributeurs différents. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01PcZ7hL9aVvMhRuzxXLT2DG		2026-09-19 22:11:43 +02:00
articles	Mettre la documentation de déploiement à jour pour ce dépôt	2026-09-19 21:04:14 +02:00
code/linux/linux-mint	initial commit — migration depuis monorepo alpinux.site.2026	2026-05-03 17:48:11 +02:00
docs	Corriger ce que la bascule a révélé sur le déploiement	2026-09-19 21:38:11 +02:00
overrides	initial commit — migration depuis monorepo alpinux.site.2026	2026-05-03 17:48:11 +02:00
scripts	initial commit — migration depuis monorepo alpinux.site.2026	2026-05-03 17:48:11 +02:00
.gitignore	initial commit — migration depuis monorepo alpinux.site.2026	2026-05-03 17:48:11 +02:00
mkdocs.yml	Faire pointer « Contribuer sur Gitea » vers ce dépôt	2026-09-19 20:25:52 +02:00
README.md	README : le dépôt vit désormais dans ~/Projects/alpinux.wiki	2026-09-19 22:11:43 +02:00

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.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

Ce dépôt se suffit à lui-même : ~/Projects/alpinux.wiki, rien à cloner à côté.

Pour les autres projets de l'association (les applications Flask, le CDN, l'infra) et leurs procédures de déploiement : ~/Projects/org.alpinux.owni/README.md.