Un site fait de fichiers texte, qui refuse toute page hors règles
Mes projets sont réunis sur un site où chaque fiche est un simple fichier texte, et qui refuse de se publier si une page enfreint mes règles d'écriture.
- Avant
- Une fiche ajoutée vite, une date au jour, une règle oubliée : je relisais tout à la main.
- Maintenant
- Chaque page est contrôlée avant mise en ligne ; une critique par IA a fait passer la note de 5 à 8 sur 10.
Utile si vous gérez un site qui grossit et ne voulez pas relire chaque page à la main.
# stack
En 3 étapes
- J'écris une fiche dans un fichier texte, avec un en-tête strict.
- Un programme dessine son schéma, le site se construit, puis un contrôle relit chaque page.
- Si une règle tombe, la mise en ligne est bloquée ; sinon Cloudflare (l'hébergeur) publie le site.
A · De la fiche au site
01
Moi
j'écris les fiches et les règles
écrit : Les fiches
02fait maison
Le générateur
dessine chaque schéma
lit : Les fiches
avecPython
03
La compilation
pages, plan du site, llms.txt
lit : Les fiches
AstroTypeScriptJSON-LD
04fait maison
Le contrôle
bloque toute page hors règles
avecNode.js
B · Puis le site vit
05
Le site
publie le site contrôlé
Cloudflare Pages
06
Un visiteur
s'inscrit ou écrit
07
Le mail
anti-robot d'abord, un seul mail
Cloudflare TurnstileBrevo
Les données
Les fiches
un fichier texte par projet
écrit par 01 · lu par 02, 03
À côté
Les critiques
3 tours en navigateur
Claude CodePlaywright
Une règle qui revient deux fois devient un contrôle.
- fait maison
- outil du marché
- une personne
- les données
Pourquoi je l'ai fait
Mes projets étaient éparpillés : GitHub, YouTube, Notion, le Blog, le site des apps. Rien ne montrait l’ensemble, ni comment chaque outil marche, et mon ancien accueil sur Notion n’était pas très beau. Et un site vitrine se dégrade vite : une fiche ajoutée en vitesse, une date au jour, une adresse mail en clair, une règle d’écriture oubliée. Le site devait pouvoir grossir sans que je relise chaque page à la main.
Ce que ça fait, concrètement
Le site range mes projets par activité. Chaque projet a sa fiche : le problème, ce que ça fait, comment ça marche, et un schéma « qui fait quoi ». Les pages par techno, le plan du site, les données structurées et le plan lisible par les IA (llms.txt) se fabriquent seuls à partir des fiches. En novembre 2026, le site compte une soixantaine de fiches, chacune avec son schéma.
Les templates Notion se récupèrent contre une adresse : une inscription, puis un mail livre le lien d’une page qui n’est liée nulle part sur le site. Le contact passe par un formulaire, sans adresse affichée.
Comment ça marche, en détail
Fabrication : Un générateur de schémas d'environ 1 400 lignes, des tests des formulaires
Chaque projet est un fichier Markdown avec un en-tête strict : titre, activité, état, une preuve de 70 signes au plus, une stack de 10 technos au plus. Un champ inconnu ou mal écrit, une rubrique hors de la liste : la compilation échoue. Ajouter un projet, c’est poser un dossier.
Astro produit ensuite un site statique (des pages préparées d’avance), puis un script relit chaque page produite et bloque le déploiement si une règle tombe. Cloudflare Pages héberge le site.
Le générateur de schémas : un seul script Python d’environ 1 400 lignes pour deux SVG par fiche
Il lit un fichier JSON par fiche et produit deux SVG (des images vectorielles) : un large, un pour téléphone. Il n’a aucune dépendance pour dessiner. Chaque schéma se lit de la même façon : qui agit, ce qui entre, l’outil, la partie que j’ai écrite moi-même, ce qui sort. Il ne rétrécit jamais un texte : il refuse et dit quoi raccourcir. Il compte les étapes et les pièces faites maison, que le site affiche tels quels, et refuse un SVG retouché à la main.
Les règles que la compilation fait respecter : noms, dates, majuscules, titres, liens, plan du site, tirets
Le script de contrôle bloque le déploiement si :
- Un nom que je tiens hors du site apparaît, ou une adresse mail en clair ;
- Une date est écrite au jour, alors que je veux le mois et l’année ;
- Le nom de mon Blog perd sa majuscule, ou une puce commence par une minuscule ;
- La page des templates est citée ailleurs, ou perd ses protections contre l’indexation ;
- Une page n’a pas exactement un titre principal, ou manque de description, d’adresse canonique, d’image de partage ou de données structurées lisibles ;
- Un lien interne mène nulle part, ou le plan du site ne liste pas exactement les pages publiques ;
- Un tiret cadratin traîne dans le texte.
Les deux fonctions côté serveur : inscription et contact, avec Turnstile puis Brevo
L’inscription et le contact passent par deux fonctions : l’anti-robot de Cloudflare (Turnstile) d’abord, puis Brevo envoie un seul mail. Le formulaire de contact n’écrit rien au visiteur et ne crée aucun contact : il ne peut pas servir de relais. Des tests simulent Brevo et Turnstile. Le script anti-robot ne se charge que quand un formulaire approche de l’écran.
La relecture par des critiques : trois tours en vrai navigateur, de 5 à 8 sur 10
Avant la mise en ligne, Claude Code a mené trois tours de critique en vrai navigateur, sur ordinateur et sur téléphone, avec un test de débordement sur chaque page. Au bilan de la première version, la note était passée de 5 à 8 sur 10, et chaque rapport finissait par ce que je devais trancher moi-même.
Les pièces : moi, les fichiers, Astro, le générateur, le contrôle, Cloudflare, Brevo, Claude Code
- Moi : j’écris les règles, je tranche, je valide les textes.
- Les fichiers de chaque projet : une fiche en Markdown, un schéma en JSON.
- Astro : compile le site statique, les pages par techno et le plan du site.
- Le contrôle d’après compilation : relit chaque page et bloque le déploiement si une règle tombe.
- Cloudflare : héberge le site, lance les deux fonctions, filtre les robots.
- Brevo : envoie le mail des templates et transmet les messages du formulaire.
- Claude Code : écrit le code, les fiches et les critiques, sous ces contrôles.
Le rôle de chaque pièce
Les 7 étapes du schéma, une par une
- Moi J'écris les règles, je tranche et je valide les textes.
- Le générateurPythonfait maison Lit un fichier JSON par fiche et dessine le schéma. Il refuse un texte trop long au lieu de le rétrécir.
- La compilationAstro · TypeScript · JSON-LD Compile le site statique, les pages par techno, le plan du site, les données structurées et le plan lisible par les IA.
- Le contrôleNode.jsfait maison Relit chaque page produite : dates, majuscule du Blog, liens, titres, descriptions. Une règle tombe, le déploiement s'arrête.
- Le siteCloudflare Pages Héberge le site statique et lance les deux fonctions (inscription, contact).
- Un visiteur Il prend un template Notion contre une adresse, ou passe par le formulaire de contact.
- Le mailCloudflare Turnstile · Brevo Cloudflare Turnstile filtre les robots, puis Brevo envoie un seul mail. Le formulaire de contact ne crée aucun contact.
# mémoires
- Les fiches Un en-tête strict : un champ inconnu, et la compilation échoue.
# à côté
- Les critiquesClaude Code · Playwright Trois tours de critique, sur ordinateur et téléphone.
Ce que vous pouvez reprendre chez vous
Le dépôt, je le garde fermé : il contient l’adresse de la page des templates. Pour un site à vous : un en-tête strict par fiche, un générateur unique pour tous les schémas, et un contrôle après compilation qui transforme chaque règle d’écriture en refus de publier. C’est la même idée que les garde-fous de Claude Code, appliquée à un site.
Ce que j'en retiens
Les dates au jour, la majuscule du Blog, les puces en minuscule : des défauts qui reviennent d’une page à l’autre. J’ai demandé à Claude de capitaliser : qu’on ne corrige pas les mêmes choses à chaque fois. Maintenant, c’est la compilation qui les refuse, et je n’ai plus à relire chaque page pour ces points-là.
Images
-
Le haut d'une fiche : chapô, état et preuve, stack, bouton vers le code, puis le schéma « qui fait quoi » dessiné par le générateur à partir du JSON de la fiche, avec son compteur d'étapes et de pièces faites maison.