# 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`