docs: ajouter README (flux publication, structure, MkDocs, déploiement)
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
parent
7ce689a966
commit
042d92ea0b
1 changed files with 84 additions and 0 deletions
84
README.md
Normal file
84
README.md
Normal file
|
|
@ -0,0 +1,84 @@
|
||||||
|
# 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
|
||||||
|
```
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 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
|
||||||
|
|
||||||
|
```bash
|
||||||
|
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) :
|
||||||
|
|
||||||
|
```bash
|
||||||
|
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
|
||||||
|
|
||||||
|
```bash
|
||||||
|
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/
|
||||||
|
```
|
||||||
Loading…
Reference in a new issue