two/docs
GnomeZworc e8c45c74b3
f-87: deploy: vxlan-public sur br-public, --public_vni (1), lab au VNI 1 #87
bootstrap_kvm.sh crée vxlan-public (VTEP = IPv4 du bridge principal,
nolearning) esclave du bridge public, recréé si le VNI ou le VTEP change.
Lab : bordures au VNI 1 (MAC 02:01:00:00:00:01) ; build.sh copie
bootstrap_kvm.sh, que hypervisor.sh appelle après la release 0.2.0.

Signed-off-by: GnomeZworc <nicolas.boufidjeline@g3e.fr>
2026-10-25 23:31:25 +01:00
..
_static ci: docs: liens du menu de version relatifs à switcher.json 2026-10-25 11:29:38 +01:00
architecture f-79: doc: section times, suppressions en cascade, notes 0.3.0 #79 2026-10-25 19:28:28 +01:00
concepts f-79: doc: section times, suppressions en cascade, notes 0.3.0 #79 2026-10-25 19:28:28 +01:00
demarrage f-79: doc: section times, suppressions en cascade, notes 0.3.0 #79 2026-10-25 19:28:28 +01:00
deploiement f-80: doc: image, network-config réappliqué à chaque démarrage par l'événement boot-legacy de cloud-init #80 2026-10-24 16:43:06 +02:00
developpement f-87: deploy: vxlan-public sur br-public, --public_vni (1), lab au VNI 1 #87 2026-10-25 23:31:25 +01:00
exploitation f-79: doc: section times, suppressions en cascade, notes 0.3.0 #79 2026-10-25 19:28:28 +01:00
schemas f-80: doc: commandes, chemins et codes alignés sur le code, répertoire uefi, route reflectors, schémas régénérés #80 2026-10-24 16:43:05 +02:00
versions 0.2.0: release 2026-10-24 20:38:41 +02:00
conf.py 0.2.0: release 2026-10-24 20:38:41 +02:00
index.rst 0.2.0: release 2026-10-24 20:38:41 +02:00
README.md f-80: doc: commandes, chemins et codes alignés sur le code, répertoire uefi, route reflectors, schémas régénérés #80 2026-10-24 16:43:05 +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, avec les mêmes options que la CI (avertissements bloquants) :

sphinx-build -b html -W --keep-going . _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.

Les schémas d'architecture (architecture-ensemble et architecture-cluster) sont générés : ne pas éditer leurs SVG, modifier schemas/gen_ensemble.py ou schemas/gen_cluster.py (même style, le second réutilise les fonctions du premier), puis régénérer les deux variantes :

python3 -B schemas/gen_ensemble.py schemas
python3 -B schemas/gen_cluster.py schemas

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.