Le CMS · 1

L'arborescence
et ses règles

Chaque dossier porte une responsabilité unique et n'empiète pas sur les autres. C'est ce qui permet de régénérer entièrement le site à tout moment sans rien perdre — et donc de traiter le HTML produit comme un produit jetable.

Fichiers source

JSON décrivant le site

Modules du noyau

4 140 lignes de Python

Pages produites

HTML + sitemap + 404

Une archive

543 Ko

contre 84 Mo d'images

§1

L'arborescence complète

Quatre dossiers portent chacun une responsabilité unique, et aucun ne déborde sur les autres : site/ ne contient aucun programme, noyau/ ne contient aucun contenu, dist/ n'est jamais édité à la main.

Cette règle n'est pas une convention de rangement. C'est ce qui permet de régénérer entièrement dist/ à tout moment sans rien perdre — et donc de traiter le HTML comme un produit jetable.

Les sources alimentent le convertisseur, qui produit les pages. La flèche ne va que dans un sens.

CMS3/
│
├── site/                      LES SOURCES — tout ce qui décrit le site
│   ├── textes/
│   │   ├── txt_fr.json        1 568 textes, à plat, une clé par texte
│   │   └── txt_de.json        les mêmes clés, en allemand
│   ├── structure/
│   │   ├── accueil.json       l'architecture du document, sans un seul mot
│   │   └── …                  13 pages, une par fichier
│   ├── design/
│   │   └── design.json        couleurs, tailles, espacements — 29 jetons
│   ├── medias/
│   │   └── mediatheque.json   37 images : jeton, alt, variantes, usages
│   ├── langues/
│   │   └── catalogue.json     27 langues : endonyme, drapeau, sens
│   └── donnees/
│       ├── site.json          domaine, navigation, pied de page
│       └── annexes.json       contenu de la page 404
│
├── noyau/                     LE CONVERTISSEUR — aucun contenu ici
│   ├── sources.py             chargement et vérification des sources
│   ├── jetons.py              le vocabulaire fermé des valeurs
│   ├── document.py            l'arbre, et le calcul des niveaux de titre
│   ├── composants.py          l'infrastructure des composants
│   ├── vocabulaire.py         LES 25 COMPOSANTS — c'est le langage
│   ├── images.py              la balise responsive
│   ├── convertisseur.py       JSON → HTML, et l'ordre du <head>
│   ├── contraste.py           calcul WCAG — pas déclaration
│   ├── navigateurs.py         les règles par moteur, exécutables
│   ├── budgets.py             poids des pages, nombre de nœuds DOM
│   ├── annexes.py             sitemap, robots.txt, 404, JavaScript
│   ├── archives.py            historique du site
│   ├── compiler.py            l'orchestration des 10 étapes
│   ├── reset.css              le socle
│   └── style.css              les composants
│
├── outils/
│   ├── valider.py             vérifier un brouillon SANS compiler
│   ├── generer_docs.py        engendre docs/ DEPUIS le code
│   └── construire_mediatheque.py
│
├── docs/                      POUR UN AGENT IA
│   ├── LANGAGE.md             la spécification, à lire
│   ├── langage.json           la même, exécutable — un agent valide contre
│   └── EXTENSION.md           protocole d'ajout d'un jeton ou composant
│
├── tests/
│   ├── controle.py            9 familles de règles sur le HTML produit
│   └── audit.py               comparaison mesurée avec l'ancien site
│
├── documentation/             CE SITE — explicatif, hors production
│
├── archives/                  une version par fichier, 10 conservées
├── dist/                      LE SITE PRODUIT — jamais modifié à la main
└── verifier.sh                valide → compile → contrôle → audite

La règle du sens unique. Rien ne remonte jamais de dist/ vers site/. Si une page produite est fausse, on corrige la source ou le convertisseur — jamais le HTML. C'est ce qui garantit qu'une recompilation ne réintroduit pas un défaut corrigé.

§2

site/ — chaque fichier, un par un

25 fichiers, 756 Ko. Ensemble, ils contiennent la totalité de ce qui distingue ce site d'un autre : ses mots, son architecture, son apparence, ses images.

Le tableau ci-dessous est lu dans le dépôt à chaque construction — tailles et compteurs compris. Une arborescence recopiée à la main finit toujours par décrire un dépôt qui n'existe plus.

Fichier

Mesure

Ce qu'il contient

site/

25 fichiers · 756 Ko

Tout ce qui distingue ce site d'un autre. Remplacer ce dossier produit un site entièrement différent, sans toucher une ligne du convertisseur.

textes/

3 langues

Les mots. Structure plate : une clé, une chaîne. Les fichiers ont rigoureusement les mêmes clés, dans le même ordre — c'est ce que le moteur vérifie avant de compiler une langue.

textes/txt_de.json

177 Ko · 1681 textes

traduction

textes/txt_en.json

169 Ko · 1681 textes

traduction

textes/txt_fr.json

175 Ko · 1681 textes

langue maîtresse

structure/

13 pages · 283 blocs

L'architecture des documents. Aucun mot : uniquement des références @clé. C'est ce qui rend une même structure compilable dans les trois langues.

structure/accueil.json

12 Ko · 29 blocs

structure/annuaire-associations-kaina.json

43 Ko · 11 blocs

noindex, absente des menus et du sitemap

structure/kaina.json

7 Ko · 36 blocs

structure/partenaires.json

41 Ko · 10 blocs

64 fiches d'associations

structure/pass-decouverte.json

8 Ko · 21 blocs

structure/pass-experience.json

10 Ko · 24 blocs

structure/pass-prive.json

9 Ko · 24 blocs

structure/temoignage-camille.json

6 Ko · 23 blocs