A rebuild of the Gatsby blog (jamstackBlog) as a minimal, single-theme
Astro + Starlight site,
following the same specifications as the English blog's rebuild
(../eng_blogv2/PROMPT-BIBLE.md).
| Piece | Version |
|---|---|
| Node | v26.13.1 (LTS "Lithium") via nvm — pinned by .nvmrc (26) |
| Astro | 7.4.x |
| @astrojs/starlight | 0.43.x |
| graphql | ^17 (ports the old Gatsby createPages query) |
| @astrojs/rss | 4.0.x |
nvm use # reads .nvmrc -> Node 26
npm ci # install from lockfile
npm run dev # dev server
npm run build # static build -> dist/ (125 pages)
npm run preview # serve dist/- 153 legacy posts copied from the old site (
../jamstackBlog/src/pages/posts), served as pages via a GraphQL layer (src/lib/graphql.ts) that mirrors the oldgatsby-node.jsquery:allPosts(filter: { is_archived: false }, sort: DESC)— 66 archived posts are excluded everywhere (listings, tag pages, single pages, RSS), leaving 87 published posts. - Home page
/= 10 latest posts as full-width cards (unchanged design) + pagination at/page/2..N. - All other listing pages —
/page/N,/posts/(+/posts/page/N) and/tag/<slug>/(+/tag/<slug>/page/N) — show posts in a 3-per-row grid (2 columns ≤1024px, 1 column ≤640px) of compact cards, 30 posts per page (3× the home page). Home keeps 10;/page/2starts right after it, so no post appears twice. - Post pages
/posts/<slug>/— image on top, full content width, before the title. Slugs come from the old site's accent-strippingslugify(src/lib/slugify.ts). - Tags:
/tags/index +/tag/<slug>/filtered listings (clickable pills), date-DESC. - RSS 2.0 at
/rss.xml("Blogue de SocraticDev",language: fr), with autodiscovery link in<head>. - OpenGraph / Twitter Cards on every page (per-post
og:image, excerpt as description,article:published_time,twitter:card=summary_large_image,twitter:site=@socraticDevBlog), default social image/images/cropped_solid_blue.png. - Google Analytics GA4
G-T3GZJ5L7TV(same ID as the old site,anonymize_ip: true). - Dark theme by default, no "auto" option (custom
ThemeProvider/ThemeSelectoverrides). - No side panels (sidebar + "On this page" TOC removed).
- French UI (
defaultLocale: fr,<html lang="fr">), dates formatted in French. - Teal theme matching the cloud logo (
#02a2c6accent), header = cloud banner logo (replacesTitle), favicon = turquoise head (public/favicon.svg). - Custom 404 (French) with a crying kitten and a "Retour vers la page d'accueil" button.
- Header links: RSS feed + English site (
https://en.socratic.dev). Footer: the old header's nav (à propos,sujets abordés,avis,rss,english) + GitHub / Mastodon / X logos. - Static pages
/about/(with the PGP key) and/avis/, ported from the old site.
/ · /page/2..4 · /posts/ + /posts/page/2..3 · /posts/<slug>/ (87) · /tags/ ·
/tag/<slug>/ (26, + /tag/croissance/page/2) · /about/ · /avis/ · /404.html ·
/rss.xml · /images/* · /favicon.svg
site: 'https://socratic.dev', titleblogue de socraticDev,defaultLocale: 'fr'logo:src/assets/banner.svg,replacesTitle: true+customCsssizinghead: favicon links, RSS autodiscovery,twitter:site, GA4 gtag pairsocial: RSS + English sitecomponentsoverrides:ThemeProvider,ThemeSelect,Footer
- Posts live in
src/content/posts/*.md; add a file and rebuild — pages, listings, tags, pagination and RSS all update automatically through the GraphQL layer. Image references in frontmatter are root-absolute (image: /images/foo.jpg). - In the static build
/rss.xmlis served astext/xmlby extension (accepted by all readers); for strictapplication/rss+xmlin production, add a host_headersrule.