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 && /usr/local/bin/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 && /usr/local/bin/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
    │   ├── wireguard.md
    │   ├── dashboard.md
    │   ├── uptime-kuma.md
    │   ├── plex.md
    │   ├── immich.md
    │   ├── homeassistant.md
    │   ├── ntfy.md
    │   ├── pingvin.md
    │   ├── torrents.md
    │   └── vaultwarden.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    |