two/docs
GnomeZworc 615cca2aca
f-41: docs: résultats du lab, ordre FRR/agent, forwarding #41
Signed-off-by: GnomeZworc <nicolas.boufidjeline@g3e.fr>
2026-10-11 23:41:53 +02:00
..
architecture f-41: api, vpc: champ l3vni des VPC #41 2026-10-11 20:05:20 +02:00
concepts f-41: docs: résultats du lab, ordre FRR/agent, forwarding #41 2026-10-11 23:41:53 +02:00
demarrage f-46: doc: document the dhcp backend and its switch procedure #46 2026-09-09 22:38:27 +02:00
deploiement f-41: docs: résultats du lab, ordre FRR/agent, forwarding #41 2026-10-11 23:41:53 +02:00
developpement f-41: docs: résultats du lab, ordre FRR/agent, forwarding #41 2026-10-11 23:41:53 +02:00
exploitation f-41: watchdog: sessions BGP, L3VNI et routes exportées des VPC routés #41 2026-10-11 20:42:01 +02:00
schemas f-50: docs: adresses 192.168.14.0/24 du route reflector et de la passerelle sur le schéma #50 2026-10-05 20:15:49 +02:00
versions f-46: doc: document the dhcp backend and its switch procedure #46 2026-09-09 22:38:27 +02:00
conf.py ci: build and publish the documentation to the pages branch 2026-09-10 22:09:34 +02:00
index.rst f-50: lab: cycle de vie du serveur de lab Scaleway #50 2026-10-05 20:15:45 +02:00
README.md docs: premiere creation de documentation 2026-08-26 23:41:50 +02:00
requirements.txt docs: premiere creation de documentation 2026-08-26 23:41:50 +02:00

Documentation two

Construction locale, avec rechargement automatique :

TMPDIR=$(mktemp -d)
python3 -m venv "${TMPDIR}/venv"
source "${TMPDIR}/venv/bin/activate"
pip install --upgrade pip
pip install -r requirements.txt
sphinx-autobuild . "${TMPDIR}/build"

Construction simple :

sphinx-build -b html . _build/html

La référence de l'API est générée depuis ../api/agent.yaml : c'est la source unique du contrat, la documentation ne la recopie pas.

Schémas

Les schémas simples sont en mermaid, directement dans les pages. Les schémas travaillés sont des SVG dans schemas/, en deux variantes :

schemas/<nom>.svg        thème clair   → .. figure:: /schemas/<nom>.svg  :class: only-light
schemas/<nom>-dark.svg   thème sombre  → .. figure:: /schemas/<nom>-dark.svg :class: only-dark

schemas/ est dans exclude_patterns : Sphinx n'y cherche pas de pages, mais copie les fichiers référencés par une directive figure ou image.

Un export draw.io se dépose tel quel sous ce nom. Exporter en SVG éditable (« Include a copy of my diagram ») pour pouvoir rouvrir le fichier dans draw.io ensuite.