wiki.alpinux.org — documentation publique MkDocs Material
6f31324595
La migration du 2026-05-03 vers ce dépôt n'a jamais été suivie d'effet : le wiki a continué d'être modifié dans alpinux.site.2026, qui est resté la source du site publié. Ces quatre écarts sont reportés ici : - guides/linux-mint-depuis-windows : « mode UEFI » → « mode BIOS » (1d67692) - alpinux/install-party : refonte du 2026-09-02 (3a8c23d) - articles/20260404_creer_des_raccourcis : article jamais versionné (38f4ec3) - articles/idee-presentations-themes : lien vers l'article ci-dessus + puce en trop La procédure ISPConfig de technique/deploiement-dynamic et docs/assets/, qui n'existent que dans ce dépôt, sont conservées telles quelles. 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é localement et synchronisé sur le serveur par rsync.
Flux de publication
Modifier wiki/ → git add / commit → git push → mkdocs build → rsync vers serveur
# 1. Versionner
git add .
git commit -m "..."
git push # → gitea.alpinux.org:alpinux.cedrica5l/alpinux-wiki
# 2. Construire et déployer
mkdocs build --strict
rsync -rlcz --delete site/ alpinux.org:/var/www/clients/client1/web2/web/wiki-static/
Le
site/généré n'est pas versionné (dans.gitignore). La commande rsync cible directement le DocumentRoot ISPConfig du wiki.
Structure des sources
wiki/
├── 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
Développement local
cd wiki
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) :
mkdocs build --strict
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 rsync
Première synchronisation
ssh alpinux.org "sudo mkdir -p /var/www/clients/client1/web2/web/wiki-static"
mkdocs build --strict
rsync -rlcz --delete site/ alpinux.org:/var/www/clients/client1/web2/web/wiki-static/
Voir aussi
Vue d'ensemble des projets, procédures de déploiement globales et accès :
~/Projects/org.alpinux.owni/README.md