Nœud 2.201 · CONCEPTNote technique08 MIN DE LECTURE
Publié : 6 nov. 2026

Comment ce site a été construit

Pourquoi un jardin, ce que contient la pile, et comment les notes sont censées grandir

Résumé

Colophon au stade Concept pour ce jardin Astro bilingue. Choix de pile, étiquettes de maturité empruntées à la pratique d'agence (concept / schéma / construit = semis / bourgeon / persistant), et pourquoi les notes se relient au lieu d'être publiées une fois puis de se taire.

Comment ce site a été construit

Contexte

Si vous êtes ici, c’est que vous voulez voir sous le capot. Tant mieux. Cette note s’adresse à quiconque s’intéresse à la façon dont ce site-ci est assemblé, à son comportement, et à ce qui le fait tourner.

J’ai passé des années à mêler la gestion des connaissances personnelles (PKM) et les Tools for Thought (TfT) à mon flux de travail, et je voulais un lieu public pour penser à voix haute, partager des expériences et relier les idées au fil de leurs connexions. Les blogs ordinaires ne sont pas faits pour ça. Ils offrent un fil antéchronologique : on publie une idée, elle descend dans l’archive, et elle y reste. Moi, je veux garder mes notes liées et vivantes. Alors quand j’ai construit ce site il y a un mois (octobre 2026), j’ai réuni mon bagage technique, mon expertise en design et mon habitude de suivre les digressions, et j’en ai fait un .

Les idées, ici, sont faites pour se polliniser. C’est un espace de travail vivant pour des projets personnels et des fragments de ce qui retient mon attention. À l’heure où j’écris, je me concentre sur :

  • Analyse spatiale et réseaux urbains : notes de terrain, recherche sur la topologie des rues, et flux Python avec OSMnx, en route vers une application monopage pour l’analyse des réseaux urbains.
  • Répétition espacée et systèmes de langue : un moteur d’apprentissage bidirectionnel entre Astro et Anki (AnkiConnect plus une synchronisation TypeScript locale) qui suit mes progrès d’apprenante avancée en français, à côté de prototypes pour une plateforme LMS sur mesure.
  • Systèmes de design et bases visuelles : flux de contenu headless, motifs Astro réutilisables, et bibliothèques de références visuelles, comme une base de précédents architecturaux filtrable qui soutient le rappel actif et la mémorisation.

Les notes sont faites pour grandir. Elles restent publiées le temps de mûrir, en se reliant latéralement (sœurs) et vers le haut (parents).

Pour l’instant, cette note est un , ou dans le langage de mon parcours d’architecte, un Concept. Elle présente le site et le raisonnement qui le sous-tend : ce qui est installé, comment les notes sont numérotées, quels jetons tiennent le système visuel, et où vivent les scripts lourds. Chorégraphier Astro tire de cette construction quelques motifs de code qui méritent d’être dépliés pour eux-mêmes. Les stades plus avancés Schéma et Construit de ce viendront plus tard, une fois que j’aurai trouvé une façon efficace de faire passer une note d’un stade au suivant. Ce sera un processus brouillon, et c’est voulu. C’est un atelier en activité.

Pile technique

Pile et exécution

L’arbre des dépendances est volontairement simple. Je suis partie du modèle minimal Astro et j’ai gardé le runtime léger, pour mettre mon énergie dans la chorégraphie de la mise en page, les transitions de page et la structure du contenu.

Pas de React. Pas de Vue. Pas d’îlots Svelte. Pas d’authentification ni de couche d’API.

Les sources vivent dans Git. À la construction, Astro compile ces composants directement en HTML statique, et Netlify prend le relais. TypeScript type les composants et les utilitaires. Le frontmatter, lui, est policé à la construction par le schéma Zod ci-dessous, pour que je ne dérive pas tranquillement de mon propre modèle à chaque nouvelle note.

Voici la liste des dépendances centrales :

  • Cadre (Astro 7.3) : génération de site statique, portée des composants, routage, et cycle de vie des view transitions. Il n’envoie aucun JavaScript par défaut, sauf si j’ouvre explicitement une balise <script>.
  • Style (Tailwind CSS 4.3) : chargé via @tailwindcss/vite, à côté de src/styles/global.css. Il tient les grilles et les espacements utilitaires, pendant que des variables CSS portent le vrai thème de marque.
  • Mouvement (GSAP 3.15 + ScrollTrigger) : le moteur de timeline derrière les balayages de page, les révélations liées au défilement, et la chorégraphie SVG ou DOM plus complexe.
  • Défilement lisse (Lenis 1.3) : normalise l’inertie du défilement et tourne sur le ticker de , pour que défilement et animation restent synchrones.
  • Environnement de construction (Node >= 22.12) : le runtime local qui compile tout avant l’envoi.

Quatre outils plus le runtime Node, et deux seulement, et , arrivent jusqu’au navigateur. Le reste, c’est du balisage propre et les API natives du navigateur.

Internationalisation

Le site est bilingue, et conçu pour en accueillir davantage. Chaque route structurelle et chaque chaîne d’interface existe en anglais et en français, sans API de traduction externe ni remplacement de texte côté client.

  • Locales : anglais (en) et français (fr).
  • Routage : géré nativement via le routage i18n d’Astro, sous les préfixes /en/... et /fr/....
  • Parité de contenu : des collections Markdown parallèles. Deux jardins qui poussent côte à côte, tenus synchronisés.
  • Bascule de langue : vous garde sur le même nœud ou le même contexte de page quand vous changez de langue, au lieu de vous renvoyer à l’index racine.

Contenu et modèle du jardin

Un dont le frontmatter n’est pas validé se dégrade vite en tas de billets. Chaque fichier Markdown est donc validé à la construction par les Astro Content Collections et un schéma Zod strict, dans content.config.ts.

Un champ obligatoire manque ? La construction échoue. Une étiquette de statut est mal écrite ? La construction échoue.

Chaque note est un Node à l’intérieur d’un Cluster plus large, et porte un nodeId précis comme 1.1 ou 2.2 pour suivre sa lignée. On peut toujours remonter d’un petit extrait technique vers un sujet de recherche plus large. Au lancement, deux clusters principaux ancrent le jardin :

  • Cluster 01 (Mobilité de Bangkok et topologie des rues) : notes de terrain, techniques et de recherche de mon voyage à Bangkok en 2026, rattachées à un projet plus ancien d’analyse spatiale des réseaux de rues, de 2018.
  • Cluster 02 (Architecture du et ) : notes de design, de construction et de processus sur le site lui-même, ancrées par cette note-ci et associées à Chorégraphier Astro, la pièce compagnon qui déplie ses motifs de code.

Pour suivre l’évolution des idées, j’ai reporté les états habituels d’un sur les phases d’agence d’architecture que j’utilise depuis des années dans la conception de bâtiments commerciaux :

Statut Équivalent d’agence Analogue du jardin Ce que ça veut dire vraiment
01 // CONCEPT Table de travail Journaux bruts, inventaires de pile, premiers tests spatiaux, premières coupes.
02 // SCHEMATIC Systèmes coordonnés Bourgeon Jetons structurés, bibliothèques de code essayées, schémas validés.
03 // BUILT Exposition Persistant Essais de synthèse et études complètes qui rassemblent les notes en amont.

Le travail inachevé fait partie de l’architecture, ici. C’est pourquoi l’état de lancement d’une note est entièrement découplé de sa maturité. Dans le schéma, un Node est soit live (publié et lisible maintenant), soit ghost (une ébauche non liée pour une note que je prévois). Les gardent le graphe de connaissances visuel honnête : ils laissent voir la forme d’un argument avant que j’en aie écrit toutes les parties.

Jetons de design

Je traite la couche visuelle comme une fiche de spécification éditoriale fusionnée avec un document d’interface net. Fort contraste. Tons de papier chauds. Accents techniques francs.

  • Crème (#F7F5F0) : le sol principal et le plan de la page. Plus doux pour les yeux que le blanc pur, sur une longue lecture.
  • Encre (#1C1F1E) : texte courant, bordures de structure et filets de grille.
  • Rose de marque (#E04343) : utilisé avec parcimonie. C’est une seule épingle rouge sur une table à dessin, pour signaler les états actifs ou les métadonnées.
  • Vert (#00674F) : le signal sémantique secondaire pour les statuts et les mots-clés.
  • Typographie : cinq polices. Public Sans pour le corps et la lecture longue. Plus Jakarta Sans pour les titres de document. Bodoni pour les plaques murales et les échos. Bricolage Grotesque pour le chrome et les métadonnées. Azeret Mono pour le code uniquement.

Chaque mouvement sur le site tourne sur un petit jeu d’accélérations cubiques personnalisées. Je cartographierai les courbes et les durées dans une note ultérieure.

Comportement client et registre de complexité

Une liste de quatre dépendances garde node_modules léger, mais la complexité est toujours là. Elle s’est juste déplacée dans la chorégraphie de la mise en page et dans des scripts client sur mesure.

Voici comment ça se présente dans le navigateur :

  • Coque du site et routage : le ClientRouter d’Astro dans BaseLayout tient deux modes de transition : un balayage plein écran pour la navigation de premier niveau, et une transition en volets pour la lecture des articles. Des groupes de transition nommés retiennent l’en-tête, la scène de gauche et le volet d’article, pour que l’écran ne flashe jamais en blanc entre deux clics.
  • Scènes de défilement (accueil / À propos / CV) : , ScrollTrigger et partagent un même ticker. L’inertie du défilement et la lecture des timelines restent verrouillées ensemble.
  • Interface interactive (en-tête, pied de page, accordéon de maturité, cartes mémoire) : de simples balises <script>, portées par leur composant Astro parent. Pas de runtime de framework par-dessus.
  • Barrière d’accessibilité : quand le système d’exploitation demande prefers-reduced-motion, le montage partagé des scènes de défilement saute et les timelines et laisse ces pages statiques.
Axe Ce qui reste simple Ce qui porte le poids
Cadre Astro + Tailwind 4 + + Rien, volontairement.
Systèmes du site Pas de base de données, d’authentification ni de CMS externe Schémas de contenu Zod stricts, routage bilingue, View Transitions, jetons typographiques CSS partagés.
Scripts et mouvement Petits utilitaires DOM (extraits vers le nœud 2.1, Chorégraphier Astro) Chorégraphie lourde, sur mesure, au niveau de la page, dans index.astro, l’index du journal et [slug].astro.

Le serveur livre du HTML statique, tout simple. Le vrai travail, c’est la chorégraphie : gérer les cycles de vie des view transitions, coordonner l’accordéon de maturité en CSS sur la scène d’article, et garder les séquences déclenchées par le défilement interruptibles si quelqu’un clique un lien au milieu d’une animation. Le construire a bien plus ressemblé au montage d’un film de présentation dans Premiere Pro, ou au placement de clés dans After Effects, qu’au développement React habituel. C’est une affaire de rythme, de continuité, et de savoir exactement sur quelle image couper.

Synthèse

En tant que note Concept, ce sert deux objectifs : (1) de la documentation et (2) une carte pour s’orienter. Il explique ce qui fait tourner le site, comment le graphe de connaissances est structuré, et pourquoi je laisse les notes inachevées à découvert.

Je tiens à la façon dont les idées se relient, et je veux montrer l’échafaudage. Les notes doivent se pointer les unes les autres. Les premières pensées peuvent rester publiques pendant qu’elles s’affinent. Ma formation d’architecte apparaît ici non pas comme une métaphore décorative du jardin, mais comme une habitude opérationnelle : on ne saute pas aux documents d’exécution avant d’avoir clarifié le concept et les systèmes du schéma.

Prochaines étapes

Voici ce qui est sur la table à dessin, à mesure que cette note grandit.

Vers le schéma (02)

  1. Scène d’article : comment la mise en page scindée, les transitions de page et l’accordéon de maturité s’emboîtent.
  2. Schéma de contenu : une traversée du modèle Zod, des identifiants de nœud et des clusters jusqu’aux .
  3. Registre du mouvement : les séquences , ScrollTrigger et sur l’accueil, À propos et le CV, y compris les replis prefers-reduced-motion.

Vers le construit (03)

  1. d’exposition : un essai final avec schémas, vérifications bilingues et données de performance en conditions réelles.

Journal des versions

  • 06 nov. 2026 - Publication (v1.0) qui explique la pile, le modèle du jardin, les jetons, le comportement client, le registre de complexité et l’échelle de maturité.