Il y avait deux dépôts d'infrastructure et aucune frontière entre eux. La seule distinction défendable — « documentation » d'un côté, « fichiers de configuration » de l'autre — ne tenait plus : infra avait fini par contenir plus de documentation qu'owni, pendant qu'owni décrivait du concret (IP, bases, comptes). Tout vient donc ici : conf/ (vhosts de référence), dns/ (export de zone), services/ (units systemd), scripts/ (sauvegarde) et docs/ (courrier sortant, certificats, sauvegardes, et le déploiement par service). Dans ce sens plutôt que l'inverse parce qu'« owni » nomme la machine, là où « infra » ne dit pas de quoi il s'agit — et c'est le nom que Cédric emploie spontanément, y compris pour le dossier de secrets. Les renvois croisés entre les deux dépôts deviennent des liens internes : un lien vers un dépôt qu'on s'apprête à archiver aurait pourri en silence. Reste une incohérence, signalée plutôt que corrigée à la hâte : docs/admin.md, static.md, wiki.md, dynamic.md et proxy-calendar.md décrivent le déploiement de sites, pas la machine. Ils ont la même place ici que celle que la messagerie n'avait pas — ils devraient rejoindre leurs dépôts. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SFbwnJurBwTs7x7t93ecku
23 lines
462 B
Markdown
23 lines
462 B
Markdown
# wiki.alpinux.org
|
|
|
|
Documentation publique Alpinux — MkDocs Material.
|
|
|
|
## Déploiement
|
|
|
|
```bash
|
|
cd org.alpinux.owni/wiki
|
|
mkdocs build --strict
|
|
rsync -rlcz --delete site/ alpinux.org:/var/www/wiki.alpinux.org/web/
|
|
```
|
|
|
|
## Développement local
|
|
|
|
```bash
|
|
pip install mkdocs-material
|
|
mkdocs serve # http://localhost:8000
|
|
```
|
|
|
|
## Notes
|
|
|
|
- Pas de service systemd — site statique servi directement par Apache
|
|
- Les docs publiques sont dans `wiki/docs/technique/`
|