Hello, World : comment fonctionne ce site

Bienvenue dans ce journal de bord. Ce premier article fait aussi office de documentation : tout ce que vous lisez est généré à partir d'un fichier .mdx qui vit dans le dépôt git du site.

La stack

Sous le capot, tout le site est volontairement ennuyeux :

• Next.js 14 (App Router) — la page bio, ce blog et ~/tools ne sont que des routes
• MDX — les articles sont des fichiers Markdown dans content/posts/, analysés avec gray-matter
• shiki — coloration syntaxique avec un thème vert terminal personnalisé
• Vercel — git push → en ligne en ~30 secondes

Pas de CMS, pas de base de données. Publier un article, c'est :

git add content/posts/new-post.mdx
git commit -m "Post: something worth reading"
git push   # Vercel fait le reste

Pourquoi MDX

Le Markdown pur couvre 95 % des besoins d'écriture, mais MDX permet à un article d'intégrer de vrais composants React quand c'est utile — démos interactives, encadrés personnalisés, peut-être même le compagnon pixélisé de la page d'accueil.

export function Greeting({ name }: { name: string }) {
  const hour = new Date().getHours()
  const salute = hour < 7 ? 'zzz...' : `hello, ${name}`
  return <span className="glow">{salute}</span>
}

La règle de ce blog : si un diagramme ou une démo explique les choses mieux qu'un texte, autant livrer la démo directement dans l'article.

La suite

• ~/tools va devenir un ensemble de petits utilitaires — à commencer par un outil de révision d'articles académiques
• Flux RSS, filtre par tags, peut-être une recherche — quand il y aura assez d'articles pour en avoir besoin

Et voilà. exit 0.