cf03c2fcec
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
88 lines
2.8 KiB
Markdown
88 lines
2.8 KiB
Markdown
# 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
|
|
```
|
|
|
|
```bash
|
|
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](docs/technique/deploiement-wiki.md).
|
|
|
|
> 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
|
|
|
|
```bash
|
|
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 :
|
|
|
|
```bash
|
|
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`
|