Documentation

Stack

Outil	MkDocs Material
LXC	106 — 192.168.1.51
Port	8090 (nginx)
URL	https://docs.2h15.fr (local/VPN uniquement)
Source	/opt/docs/docs/
Config	/opt/docs/mkdocs.yml
Site généré	/opt/docs/site/

Modifier une page existante

# Depuis le host Proxmox
pct exec 106 -- nano /opt/docs/docs/<section>/<page>.md

# Puis rebuilder
pct exec 106 -- bash -c 'cd /opt/docs && python3 -m mkdocs build'

Ajouter une nouvelle page

1. Créer le fichier Markdown :

pct exec 106 -- nano /opt/docs/docs/<section>/nouvelle-page.md

2. Déclarer la page dans la navigation (/opt/docs/mkdocs.yml) :

nav:
  - Section:
    - Nouvelle page: section/nouvelle-page.md

3. Rebuilder :

pct exec 106 -- bash -c 'cd /opt/docs && python3 -m mkdocs build'

Structure des fichiers

/opt/docs/
├── mkdocs.yml          # Configuration générale et navigation
└── docs/
    ├── index.md
    ├── documentation.md
    ├── infrastructure/
    │   ├── architecture.md
    │   └── reseau.md
    ├── services/
    │   ├── nginx-proxy-manager.md
    │   ├── crowdsec.md
    │   ├── wireguard.md
    │   ├── dashboard.md
    │   ├── uptime-kuma.md
    │   ├── jellyfin.md
    │   ├── immich.md
    │   ├── immich-swipe.md
    │   ├── homeassistant.md
    │   ├── ntfy.md
    │   ├── pingvin.md
    │   ├── torrents.md
    │   ├── vaultwarden.md
    │   ├── epic-games.md
    │   ├── gighunter.md
    │   ├── dnd.md
    │   ├── blindtest.md
    │   ├── code-server.md
    │   └── reels-vault.md
    ├── projets/
    │   └── app-family.md
    ├── scripts/
    │   └── host-scripts.md
    └── backup/
        └── immich.md

Syntaxe utile

Bloc d'avertissement

!!! warning "Titre"
    Contenu de l'avertissement.

!!! info "Titre"
    Une information.

Bloc de code avec copie

```bash
ma commande
```

Tableau

| Colonne 1 | Colonne 2 |
|-----------|-----------|
| Valeur    | Valeur    |