@z29k/notabene 0.1.0 → 0.1.1

package/README.md

@@ -10,7 +10,7 @@ the product.**
 
 > *nota bene* — the margin mark that means "note this." A comment.
 
-**MIT** · Node ≥ 18.20 · MDX **and** CommonMark/GFM · dev-local, zero backend ·
+**MIT** · Node ≥ 22.12 · MDX **and** CommonMark/GFM · dev-local, zero backend ·
 _pre-1.0, dogfooded on a real multi-service platform._
 
 ---

package/package.json

@@ -1,9 +1,19 @@
 {
   "name": "@z29k/notabene",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Navigable docs renderer + human↔agent review loop. Comment your docs like Google Docs; an agent reads .notabene/, applies the feedback, and journals it.",
   "type": "module",
   "license": "MIT",
+  "author": "z29k",
+  "homepage": "https://github.com/z29k/notabene#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/z29k/notabene.git",
+    "directory": "packages/renderer"
+  },
+  "bugs": {
+    "url": "https://github.com/z29k/notabene/issues"
+  },
   "publishConfig": {
     "access": "public"
   },
@@ -28,6 +38,6 @@
   },
   "keywords": ["docs", "documentation", "review", "comments", "mdx", "markdown", "astro", "ai", "agent"],
   "engines": {
-    "node": ">=18.20.8"
+    "node": ">=22.12.0"
   }
 }

package/src/components/Comments.astro

@@ -1,12 +1,16 @@
 ---
-// Commentaires type Google Docs.
-//  - Ancrés (sélection) → marge droite (#cmt-rail, fourni par DocLayout) + surlignage.
-//  - Globaux (page)     → section discussion EN BAS de la page (rendue ici).
-// Bouton flottant + popover en position:fixed (coords viewport). Persistance /api/comments.
+// Google-Docs-style comments.
+//  - Anchored (selection) → right rail (#cmt-rail, provided by DocLayout) + highlight.
+//  - Page-wide            → discussion section at the BOTTOM of the page (rendered here).
+// Floating button + popover in position:fixed (viewport coords). Persisted via /api/comments.
+import { locale } from "../config.mjs";
+import { t } from "../i18n.mjs";
+
 interface Props {
   page?: string;
   space?: string;
 }
+const m = t(locale);
 const { page, space } = Astro.props;
 ---
 
@@ -14,25 +18,25 @@ const { page, space } = Astro.props;
   page && (
     <section id="cmt-page" class="cmt-page" data-page={page} data-space={space}>
       <header class="cmt-page-head">
-        <h2>Discussion</h2>
+        <h2>{m.discussion}</h2>
         <span id="cmt-count" class="cmt-count" />
       </header>
       <form id="cmt-composer" class="cmt-composer">
-        <textarea id="cmt-input" rows="3" placeholder="Commentaire sur cette page…" />
-        <button type="submit">Commenter la page</button>
+        <textarea id="cmt-input" rows="3" placeholder={m.pageCommentPlaceholder} />
+        <button type="submit">{m.commentPage}</button>
       </form>
       <div id="cmt-page-list" class="cmt-list" />
     </section>
 
     <button id="cmt-float" class="cmt-float" hidden type="button">
-      💬 Commenter
+      {m.floatComment}
     </button>
     <div id="cmt-pop" class="cmt-pop" hidden>
       <div id="cmt-pop-quote" class="cmt-pop-quote" />
-      <textarea id="cmt-pop-input" rows="3" placeholder="Commentaire sur la sélection…" />
+      <textarea id="cmt-pop-input" rows="3" placeholder={m.selectionPlaceholder} />
       <div class="cmt-pop-actions">
-        <button type="button" id="cmt-pop-cancel">Annuler</button>
-        <button type="button" id="cmt-pop-save">Commenter</button>
+        <button type="button" id="cmt-pop-cancel">{m.cancel}</button>
+        <button type="button" id="cmt-pop-save">{m.comment}</button>
       </div>
     </div>
 
@@ -51,8 +55,11 @@ const { page, space } = Astro.props;
     const NB_ROOTS: { key: string }[] = JSON.parse(
       document.getElementById("notabene-roots")?.textContent || "[]",
     );
+    const M: Record<string, string> = JSON.parse(
+      document.getElementById("notabene-i18n")?.textContent || "{}",
+    );
     const page = pageSection.dataset.page!;
-    // data-space est toujours posé par la route [space] ; fallback = 1er espace.
+    // data-space is always set by the [space] route; fallback = first space.
     const space = pageSection.dataset.space || NB_ROOTS[0]?.key || "";
     const railEl = document.getElementById("cmt-rail");
     const pageListEl = document.getElementById("cmt-page-list")!;
@@ -171,30 +178,30 @@ const { page, space } = Astro.props;
           ${
             c.scope === "selection"
               ? `<span class="cmt-quote${orphan ? " orphan" : ""}" data-jump="${c.id}">${orphan ? "⚠ " : ""}“${esc((c.anchor?.quote || "").slice(0, 70))}”</span>`
-              : `<span class="cmt-scope">📄 page</span>`
+              : `<span class="cmt-scope">${M.scopePage}</span>`
           }
-          ${c.hold ? '<span class="cmt-hold-badge">⏸ en attente</span>' : ""}
+          ${c.hold ? `<span class="cmt-hold-badge">${M.onHold}</span>` : ""}
         </div>
         <div class="cmt-body"><b>${esc(head.author)}</b> ${esc(head.body)}</div>
         ${replies.map((r) => `<div class="cmt-reply"><b>${esc(r.author)}</b> ${esc(r.body)}</div>`).join("")}
         ${c.resolution?.note ? `<div class="cmt-resolution">✔ ${esc(c.resolution.note)}</div>` : ""}
         <div class="cmt-actions">
           <span class="cmt-ts">${fmt(head.ts)}</span>
-          ${c.status === "open" && c.thread.length === 1 ? `<button data-act="edit" data-id="${c.id}" title="Éditer" aria-label="Éditer">${ICONS.edit}</button>` : ""}
+          ${c.status === "open" && c.thread.length === 1 ? `<button data-act="edit" data-id="${c.id}" title="${M.tEdit}" aria-label="${M.tEdit}">${ICONS.edit}</button>` : ""}
           ${
             c.status === "resolved"
-              ? `<button data-act="reopen" data-id="${c.id}" title="Rouvrir" aria-label="Rouvrir">${ICONS.reopen}</button>`
-              : `<button data-act="resolve" data-id="${c.id}" title="Résoudre" aria-label="Résoudre">${ICONS.check}</button>`
+              ? `<button data-act="reopen" data-id="${c.id}" title="${M.tReopen}" aria-label="${M.tReopen}">${ICONS.reopen}</button>`
+              : `<button data-act="resolve" data-id="${c.id}" title="${M.tResolve}" aria-label="${M.tResolve}">${ICONS.check}</button>`
           }
-          <button data-act="${c.hold ? "unhold" : "hold"}" data-id="${c.id}" title="${c.hold ? "Réactiver" : "Mettre en attente"}" aria-label="${c.hold ? "Réactiver" : "Mettre en attente"}">${c.hold ? ICONS.play : ICONS.pause}</button>
-          <button data-act="reply" data-id="${c.id}" title="Répondre" aria-label="Répondre">${ICONS.reply}</button>
-          <button data-act="delete" data-id="${c.id}" class="danger" title="Supprimer" aria-label="Supprimer">${ICONS.trash}</button>
+          <button data-act="${c.hold ? "unhold" : "hold"}" data-id="${c.id}" title="${c.hold ? M.tUnhold : M.tHold}" aria-label="${c.hold ? M.tUnhold : M.tHold}">${c.hold ? ICONS.play : ICONS.pause}</button>
+          <button data-act="reply" data-id="${c.id}" title="${M.tReply}" aria-label="${M.tReply}">${ICONS.reply}</button>
+          <button data-act="delete" data-id="${c.id}" class="danger" title="${M.tDelete}" aria-label="${M.tDelete}">${ICONS.trash}</button>
         </div>
         <form class="cmt-reply-form" data-id="${c.id}" hidden>
-          <textarea rows="2" placeholder="Réponse…"></textarea><button type="submit">Envoyer</button>
+          <textarea rows="2" placeholder="${M.replyPlaceholder}"></textarea><button type="submit">${M.send}</button>
         </form>
         <form class="cmt-edit-form" data-id="${c.id}" hidden>
-          <textarea rows="2">${esc(head.body)}</textarea><button type="submit">Enregistrer</button>
+          <textarea rows="2">${esc(head.body)}</textarea><button type="submit">${M.save}</button>
         </form>
       </article>`;
     }
@@ -203,30 +210,30 @@ const { page, space } = Astro.props;
       const anchored = comments.filter((c) => c.scope === "selection");
       const pageWide = comments.filter((c) => c.scope === "page");
       const openCount = comments.filter((c) => c.status !== "resolved").length;
-      countEl.textContent = openCount ? `${openCount} ouverts` : `${comments.length}`;
+      countEl.textContent = openCount ? `${openCount} ${M.openSuffix}` : `${comments.length}`;
 
-      // marge droite : commentaires ancrés
+      // right rail: anchored comments
       if (railEl) {
         const shown = anchored.filter((c) =>
           railFilter === "all" ? true : railFilter === "resolved" ? c.status === "resolved" : c.status !== "resolved",
         );
         railEl.innerHTML = `<div class="cmt-rail-head">
-            <span class="cmt-rail-title">Annotations</span>
+            <span class="cmt-rail-title">${M.annotations}</span>
             <span class="cmt-rail-count">${anchored.length}</span>
           </div>
           <div class="cmt-filter" id="cmt-filter">
-            <button data-f="open"${railFilter === "open" ? ' class="active"' : ""}>Ouverts</button>
-            <button data-f="resolved"${railFilter === "resolved" ? ' class="active"' : ""}>Résolus</button>
-            <button data-f="all"${railFilter === "all" ? ' class="active"' : ""}>Tous</button>
+            <button data-f="open"${railFilter === "open" ? ' class="active"' : ""}>${M.filterOpen}</button>
+            <button data-f="resolved"${railFilter === "resolved" ? ' class="active"' : ""}>${M.filterResolved}</button>
+            <button data-f="all"${railFilter === "all" ? ' class="active"' : ""}>${M.filterAll}</button>
           </div>
           <div class="cmt-list">${
-            shown.length ? shown.map(card).join("") : `<p class="cmt-empty">Sélectionne du texte pour annoter.</p>`
+            shown.length ? shown.map(card).join("") : `<p class="cmt-empty">${M.selectToAnnotate}</p>`
           }</div>`;
       }
-      // bas de page : commentaires de page
+      // page bottom: page-wide comments
       pageListEl.innerHTML = pageWide.length
         ? pageWide.map(card).join("")
-        : `<p class="cmt-empty">Aucun commentaire de page.</p>`;
+        : `<p class="cmt-empty">${M.noPageComments}</p>`;
       applyHighlights();
     }
 
@@ -236,7 +243,7 @@ const { page, space } = Astro.props;
       renderView();
     }
 
-    // ── clic sur texte surligné → popover de lecture au niveau du texte ──────
+    // ── click on highlighted text → reading popover at the text ─────────────
     function pointAt(x: number, y: number): { node: Node; offset: number } | null {
       const d = document as any;
       if (d.caretRangeFromPoint) {
@@ -329,8 +336,8 @@ const { page, space } = Astro.props;
         pop.hidden = true;
         if (!window.getSelection()?.toString().trim()) floatBtn.hidden = true;
       }
-      // Ferme le popover de lecture sauf clic dedans ou re-clic dans le contenu
-      // (le handler de clic du contenu le rouvrira si on tape sur du surligné).
+      // Close the reading popover unless the click is inside it or back in the
+      // content (the content click handler reopens it when hitting a highlight).
       if (!t.closest("#cmt-view") && !article!.contains(t)) {
         viewIds = [];
         viewEl.hidden = true;
@@ -421,7 +428,7 @@ const { page, space } = Astro.props;
       region.addEventListener("click", onActionClick);
       region.addEventListener("submit", onFormSubmit);
     }
-    // filtre (rail) — délégué car re-rendu
+    // rail filter — delegated because re-rendered
     railEl?.addEventListener("click", (e) => {
       const b = (e.target as HTMLElement).closest("#cmt-filter button");
       if (!b) return;
@@ -429,7 +436,7 @@ const { page, space } = Astro.props;
       render();
     });
 
-    // Focus d'un commentaire ciblé depuis la page globale (?c=<id>).
+    // Focus a comment targeted from the global page (?c=<id>).
     function focusFromUrl() {
       const cid = new URLSearchParams(location.search).get("c");
       if (!cid) return;

package/src/components/NavTree.astro

@@ -9,9 +9,8 @@ interface Props {
 
 const { nodes, current } = Astro.props;
 
-// Un groupe est ouvert s'il contient (à n'importe quelle profondeur) la page
-// courante. Marche pour les groupes-dossiers ET les sous-groupes éditoriaux
-// synthétiques (cf. nav.config), qui n'ont pas de préfixe de chemin réel.
+// A group is open if it contains (at any depth) the current page. Works for
+// folder groups and synthetic editorial subgroups alike.
 function containsCurrent(node: NavNode, target: string): boolean {
   if (node.type === "leaf") return node.href === target;
   return node.children.some((child) => containsCurrent(child, target));

package/src/components/Sidebar.astro

@@ -1,22 +1,24 @@
 ---
 import { buildNav, type Space } from "../lib/nav";
 import NavTree from "./NavTree.astro";
-import { roots } from "../config.mjs";
+import { locale, roots } from "../config.mjs";
+import { t } from "../i18n.mjs";
 
 interface Props {
   current?: string;
   activeSpace?: Space;
 }
 
+const m = t(locale);
 const { current = "", activeSpace } = Astro.props;
-// Un arbre de nav par espace déclaré dans notabene.config (plus le duo figé).
+// One nav tree per space declared in notabene.config (no fixed duo).
 const spaces = await Promise.all(
   roots.map(async (root) => ({ root, nodes: await buildNav(root.key) })),
 );
 ---
 
 <div class="nav-filter">
-  <input id="nav-filter" type="search" placeholder="Filter…" autocomplete="off" />
+  <input id="nav-filter" type="search" placeholder={m.sidebarFilter} autocomplete="off" />
 </div>
 
 <nav class="nav">
@@ -27,7 +29,7 @@ const spaces = await Promise.all(
           <span class="space-name">{root.label}</span>
           <span class="space-sub">{root.subLabel}</span>
         </summary>
-        <p class="space-link"><a href={`/${root.key}`}>Overview →</a></p>
+        <p class="space-link"><a href={`/${root.key}`}>{m.sidebarOverview}</a></p>
         <NavTree nodes={nodes} current={current} />
       </details>
     ))
@@ -35,8 +37,8 @@ const spaces = await Promise.all(
 </nav>
 
 <script>
-  // Filtre client-side : masque les feuilles dont le titre ne matche pas, et
-  // déplie tous les groupes pendant la recherche.
+  // Client-side filter: hide leaves whose title doesn't match, and expand all
+  // groups while searching.
   const input = document.getElementById("nav-filter") as HTMLInputElement | null;
   if (input) {
     input.addEventListener("input", () => {

package/src/components/SpaceIndex.astro

@@ -1,16 +1,18 @@
 ---
 import type { NavNode, NavLeaf, Space } from "../lib/nav";
-import { roots } from "../config.mjs";
+import { locale, roots } from "../config.mjs";
+import { t } from "../i18n.mjs";
 
 interface Props {
   nodes: NavNode[];
   space: Space;
 }
 
+const m = t(locale);
 const { nodes, space } = Astro.props;
 const root = roots.find((r) => r.key === space);
 const label = root?.label ?? space;
-const blurb = root?.description || `Documentation sourced from ${root?.subLabel ?? space}.`;
+const blurb = root?.description || `${root?.subLabel ?? space}`;
 ---
 
 <h1>{label}</h1>
@@ -31,7 +33,7 @@ const blurb = root?.description || `Documentation sourced from ${root?.subLabel
                 </li>
               ))}
           </ul>
-          {n.children.some((c) => c.type === "group") && <p class="more">+ subsections…</p>}
+          {n.children.some((c) => c.type === "group") && <p class="more">{m.subsections}</p>}
         </section>
       ) : (
         <section class="card card-leaf">

package/src/components/Toc.astro

@@ -1,4 +1,7 @@
 ---
+import { locale } from "../config.mjs";
+import { t } from "../i18n.mjs";
+
 interface Heading {
   depth: number;
   slug: string;
@@ -9,14 +12,15 @@ interface Props {
   headings: Heading[];
 }
 
+const m = t(locale);
 const { headings } = Astro.props;
 const items = headings.filter((h) => h.depth >= 2 && h.depth <= 3);
 ---
 
 {
   items.length > 0 && (
-    <nav class="toc-inner" aria-label="Sur cette page">
-      <p class="toc-title">On this page</p>
+    <nav class="toc-inner" aria-label={m.tocTitle}>
+      <p class="toc-title">{m.tocTitle}</p>
       <ul>
         {items.map((h) => (
           <li class:list={[`d${h.depth}`]}>

package/src/content.config.ts

@@ -2,10 +2,10 @@ import { defineCollection } from "astro:content";
 import { glob } from "astro/loaders";
 import { roots } from "./config.mjs";
 
-// Contenu sourcé HORS de l'app (outil de vue par-dessus la doc du repo) : une
-// collection par espace déclaré dans notabene.config.mjs (`roots[]`). Le nom de
-// collection = la `key` de l'espace ; le `base` du glob = son dossier, résolu
-// contre la racine du repo (cf. src/config.mjs). Le glob inclut déjà `.mdx`.
+// Content sourced OUTSIDE the app (a viewer over the repo's docs): one collection
+// per space declared in notabene.config.mjs (`roots[]`). The collection name = the
+// space `key`; the glob `base` = its folder, resolved against the repo root
+// (cf. src/config.mjs). Extensions come from `format` (.md/.mdx or .md/.markdown).
 const collections: Record<string, ReturnType<typeof defineCollection>> = {};
 for (const root of roots) {
   collections[root.key] = defineCollection({

package/src/i18n.mjs

@@ -0,0 +1,145 @@
+// UI string catalog. The renderer is English-first (OSS); `locale` in
+// notabene.config selects the catalog (default "en"). Server components import
+// `t(locale)`; client scripts read the same object injected as JSON by DocLayout
+// (`#notabene-i18n`). Values are plain strings only (must be JSON-serializable).
+//
+// Add a language by adding a top-level key; missing keys fall back to English.
+const MESSAGES = {
+  en: {
+    navComments: "Comments",
+    navJournal: "Journal",
+    searchPlaceholder: "Search all docs…",
+    searchNoResults: "No results",
+    tocTitle: "On this page",
+    sidebarFilter: "Filter…",
+    sidebarOverview: "Overview →",
+    subsections: "+ subsections…",
+
+    discussion: "Discussion",
+    pageCommentPlaceholder: "Comment on this page…",
+    commentPage: "Comment on page",
+    floatComment: "💬 Comment",
+    selectionPlaceholder: "Comment on the selection…",
+    cancel: "Cancel",
+    comment: "Comment",
+
+    annotations: "Annotations",
+    filterOpen: "Open",
+    filterResolved: "Resolved",
+    filterAll: "All",
+    selectToAnnotate: "Select text to annotate.",
+    noPageComments: "No page comments.",
+    scopePage: "📄 page",
+    onHold: "⏸ on hold",
+    replyPlaceholder: "Reply…",
+    send: "Send",
+    save: "Save",
+    openSuffix: "open",
+
+    tEdit: "Edit",
+    tResolve: "Resolve",
+    tReopen: "Reopen",
+    tHold: "Put on hold",
+    tUnhold: "Reactivate",
+    tReply: "Reply",
+    tDelete: "Delete",
+
+    allCommentsTitle: "All comments",
+    allCommentsLede:
+      "Aggregated view of the whole doc, with filters. Click a page → opens the comment in place.",
+    searchCommentsPlaceholder: "Search (text, page, quote)…",
+    stActive: "Active",
+    stOpen: "Open",
+    stResolved: "Resolved",
+    stAll: "All statuses",
+    spAll: "All spaces",
+    holdAll: "Hold: all",
+    holdActive: "Not on hold",
+    holdOnly: "On hold",
+    loading: "Loading…",
+    repliesSuffix: "repl.",
+    noCommentsFilters: "No comments for these filters.",
+
+    journalTitle: "Journal",
+    journalHeading: "Change journal",
+    journalLede:
+      "History of review passes: what changed in the docs, and why (linked to the comments that triggered it).",
+    journalEmpty:
+      "No pass recorded yet. When the agent processes comments, an entry is added here.",
+    journalComments: "comments:",
+
+    homeDocumentation: "documentation",
+    homeLede: "Sourced live from the repo.",
+  },
+  fr: {
+    navComments: "Commentaires",
+    navJournal: "Journal",
+    searchPlaceholder: "Rechercher dans la doc…",
+    searchNoResults: "Aucun résultat",
+    tocTitle: "Sur cette page",
+    sidebarFilter: "Filtrer…",
+    sidebarOverview: "Aperçu →",
+    subsections: "+ sous-sections…",
+
+    discussion: "Discussion",
+    pageCommentPlaceholder: "Commentaire sur cette page…",
+    commentPage: "Commenter la page",
+    floatComment: "💬 Commenter",
+    selectionPlaceholder: "Commentaire sur la sélection…",
+    cancel: "Annuler",
+    comment: "Commenter",
+
+    annotations: "Annotations",
+    filterOpen: "Ouverts",
+    filterResolved: "Résolus",
+    filterAll: "Tous",
+    selectToAnnotate: "Sélectionne du texte pour annoter.",
+    noPageComments: "Aucun commentaire de page.",
+    scopePage: "📄 page",
+    onHold: "⏸ en attente",
+    replyPlaceholder: "Réponse…",
+    send: "Envoyer",
+    save: "Enregistrer",
+    openSuffix: "ouverts",
+
+    tEdit: "Éditer",
+    tResolve: "Résoudre",
+    tReopen: "Rouvrir",
+    tHold: "Mettre en attente",
+    tUnhold: "Réactiver",
+    tReply: "Répondre",
+    tDelete: "Supprimer",
+
+    allCommentsTitle: "Tous les commentaires",
+    allCommentsLede:
+      "Vue agrégée de toute la doc, avec filtres. Clic sur une page → ouvre le commentaire à son emplacement.",
+    searchCommentsPlaceholder: "Rechercher (texte, page, citation)…",
+    stActive: "Actifs",
+    stOpen: "Open",
+    stResolved: "Résolus",
+    stAll: "Tous statuts",
+    spAll: "Tous espaces",
+    holdAll: "Attente : tous",
+    holdActive: "Hors attente",
+    holdOnly: "En attente",
+    loading: "Chargement…",
+    repliesSuffix: "rép.",
+    noCommentsFilters: "Aucun commentaire pour ces filtres.",
+
+    journalTitle: "Journal",
+    journalHeading: "Journal des modifications",
+    journalLede:
+      "Historique des passes de revue : ce qui a changé dans la doc, et pourquoi (lié aux commentaires qui l'ont déclenché).",
+    journalEmpty:
+      "Aucune passe enregistrée. Quand l'agent traite des commentaires, une entrée est ajoutée ici.",
+    journalComments: "commentaires :",
+
+    homeDocumentation: "documentation",
+    homeLede: "Sourcé en direct depuis le repo.",
+  },
+};
+
+/** Message catalog for a locale (falls back to English for unknown locales/keys). */
+export function t(locale) {
+  return { ...MESSAGES.en, ...(MESSAGES[locale] ?? {}) };
+}

package/src/layouts/DocLayout.astro

@@ -5,6 +5,9 @@ import Toc from "../components/Toc.astro";
 import Comments from "../components/Comments.astro";
 import type { Space } from "../lib/nav";
 import { clientRoots, locale, siteName, tagline } from "../config.mjs";
+import { t } from "../i18n.mjs";
+
+const m = t(locale);
 
 interface Heading {
   depth: number;
@@ -37,16 +40,17 @@ const { title, current = "", space, page, headings = [], breadcrumb = [] } = Ast
     <meta name="viewport" content="width=device-width, initial-scale=1" />
     <title>{title} · {siteName}</title>
     <script type="application/json" id="notabene-roots" set:html={JSON.stringify(clientRoots)} />
+    <script type="application/json" id="notabene-i18n" set:html={JSON.stringify(m)} />
   </head>
   <body>
     <header class="topbar">
       <a href="/" class="brand">{siteName} <span>· {tagline}</span></a>
       <div class="search">
-        <input id="search-input" type="search" placeholder="Search all docs…" autocomplete="off" />
+        <input id="search-input" type="search" placeholder={m.searchPlaceholder} autocomplete="off" />
         <div id="search-results" class="search-results" hidden></div>
       </div>
-      <a href="/comments" class="topbar-link">Commentaires</a>
-      <a href="/journal" class="topbar-link">Journal</a>
+      <a href="/comments" class="topbar-link">{m.navComments}</a>
+      <a href="/journal" class="topbar-link">{m.navJournal}</a>
     </header>
 
     <div class="shell">
@@ -80,7 +84,7 @@ const { title, current = "", space, page, headings = [], breadcrumb = [] } = Ast
     </div>
 
     <script>
-      // Recherche client-side : index JSON (titre + headings + extrait), scoré.
+      // Client-side search: JSON index (title + headings + excerpt), scored.
       const input = document.getElementById("search-input") as HTMLInputElement | null;
       const box = document.getElementById("search-results");
 
@@ -95,6 +99,9 @@ const { title, current = "", space, page, headings = [], breadcrumb = [] } = Ast
       const ROOTS: { key: string; label: string; path: string }[] = JSON.parse(
         document.getElementById("notabene-roots")?.textContent || "[]",
       );
+      const M: Record<string, string> = JSON.parse(
+        document.getElementById("notabene-i18n")?.textContent || "{}",
+      );
       const spaceLabel = (key: string): string =>
         ROOTS.find((r) => r.key === key)?.label ?? key;
 
@@ -139,7 +146,7 @@ const { title, current = "", space, page, headings = [], breadcrumb = [] } = Ast
                     `<a href="${doc.href}"><span class="r-space ${doc.space}">${esc(spaceLabel(doc.space))}</span><span class="r-title">${esc(doc.title)}</span></a>`,
                 )
                 .join("")
-            : `<div class="r-empty">No results</div>`;
+            : `<div class="r-empty">${M.searchNoResults}</div>`;
           box.hidden = false;
         });
 

package/src/lib/comment-types.ts

@@ -1,22 +1,21 @@
-// Types partagés client ⇄ serveur pour les commentaires (pas d'I/O ici).
+// Shared client ⇄ server types for comments (no I/O here).
 //
-// ⚠️ CONTRAT DE DONNÉES (`.notabene` = API publique). Le store est committé en git
-// et lu par l'agent → sa forme ne peut plus être cassée en douce. Versionné par un
-// sidecar `<store>/meta.json` (`{ "schemaVersion": <n> }`, cf. SCHEMA_VERSION).
-// Toute évolution de forme = bump `schemaVersion` + migrateur, jamais de mutation
-// silencieuse. Cf. docs/plans/docs-review-oss.mdx §9.
+// ⚠️ DATA CONTRACT (`.notabene` = public API). The store is committed to git and
+// read by the agent → its shape can't be broken silently. Versioned by a sidecar
+// `<store>/meta.json` (`{ "schemaVersion": <n> }`, cf. SCHEMA_VERSION). Any shape
+// change bumps `schemaVersion` + a migrator, never a silent mutation.
 
-/** Version du schéma du store (sidecar `<store>/meta.json`). */
+/** Store schema version (sidecar `<store>/meta.json`). */
 export const SCHEMA_VERSION = 1;
 
 export interface CommentAnchor {
-  /** Texte exact sélectionné (W3C TextQuoteSelector). */
+  /** Exact selected text (W3C TextQuoteSelector). */
   quote: string;
-  /** ~32-40 chars de contexte avant/après (désambiguïse les quotes répétées et
-   *  ancre le ré-ancrage rendu→source — load-bearing, ne pas retirer). */
+  /** ~32-40 chars of context before/after (disambiguates repeated quotes and
+   *  anchors the rendered→source re-anchoring — load-bearing, don't remove). */
   prefix: string;
   suffix: string;
-  /** Heading le plus proche au-dessus de la sélection (repère lisible). */
+  /** Nearest heading above the selection (readable landmark). */
   section: string | null;
 }
 
@@ -27,26 +26,26 @@ export interface CommentReply {
 }
 
 export type CommentStatus = "open" | "addressed" | "resolved";
-/** Clé d'un espace (root de notabene.config) — chaîne libre, plus le duo figé. */
+/** A space key (notabene.config root) — free string, no fixed duo. */
 export type CommentSpace = string;
 export type CommentScope = "selection" | "page";
 
 export interface Comment {
   id: string;
-  /** Espace = `key` du root de notabene.config (ex. reference, workbench). */
+  /** Space = the `key` of a notabene.config root (e.g. reference, workbench). */
   space: CommentSpace;
-  /** Chemin logique repo-relatif de la page (= data-page), ex. docs/architecture/billing. */
+  /** Logical repo-relative page path (= data-page), e.g. docs/architecture/billing. */
   page: string;
   scope: CommentScope;
-  /** null pour un commentaire global de page. */
+  /** null for a page-wide comment. */
   anchor: CommentAnchor | null;
   thread: CommentReply[];
   status: CommentStatus;
-  /** « En attente » : travail en cours côté utilisateur — l'agent IGNORE ces
-   *  commentaires lors d'une passe « prends en compte » (jusqu'à réactivation). */
+  /** "On hold": work in progress on the user's side — the agent IGNORES these
+   *  comments during an "address the comments" pass (until reactivated). */
   hold: boolean;
-  /** Rempli par l'agent quand il traite le commentaire. `journalEntryId` lie la
-   *  résolution à l'entrée de `journal.json` qui la décrit (cf. JournalEntry.id). */
+  /** Filled by the agent when it processes the comment. `journalEntryId` links the
+   *  resolution to the `journal.json` entry describing it (cf. JournalEntry.id). */
   resolution: { note: string; journalEntryId?: string } | null;
   createdAt: string;
   updatedAt: string;

package/src/lib/comments.ts

@@ -1,18 +1,18 @@
-// Store de commentaires (serveur, dev-only). Un fichier JSON par page sous
-// `<store>/<page>.json` (committé en git, lisible par l'agent). Le chemin du store
-// vient de notabene.config (`store`, cf. src/config.mjs) — jamais en dur. Le glob
-// de contenu exclut le store → il n'est jamais interprété comme du contenu.
+// Comment store (server, dev-only). One JSON file per page at `<store>/<page>.json`
+// (committed to git, readable by the agent). The store path comes from
+// notabene.config (`store`, cf. src/config.mjs) — never hardcoded. The content glob
+// excludes the store → it's never interpreted as content.
 import fs from "node:fs/promises";
 import path from "node:path";
 import { storeAbs } from "../config.mjs";
 import type { Comment, CommentAnchor, CommentScope, CommentSpace, CommentStatus } from "./comment-types";
 
 const STORE_ROOT = storeAbs;
-// Fichiers réservés du store (jamais des pages de commentaires).
+// Reserved store files (never comment pages).
 const RESERVED = new Set(["journal.json", "meta.json"]);
 
 function fileFor(page: string): string {
-  // Anti-traversal : pas de `..`, pas de slash initial.
+  // Anti-traversal: no `..`, no leading slash.
   const safe = page.replace(/\\/g, "/").replace(/\.\.+/g, "").replace(/^\/+/, "");
   return path.join(STORE_ROOT, `${safe}.json`);
 }
@@ -43,7 +43,7 @@ export async function listComments(page: string): Promise<Comment[]> {
   return read(page);
 }
 
-/** Tous les commentaires, toutes pages (pour la page globale /comments). */
+/** All comments, all pages (for the global /comments view). */
 export async function listAllComments(): Promise<Comment[]> {
   const out: Comment[] = [];
   async function walk(dir: string) {
@@ -56,12 +56,12 @@ export async function listAllComments(): Promise<Comment[]> {
     for (const e of entries) {
       const full = path.join(dir, e.name);
       if (e.isDirectory()) await walk(full);
-      // Fichiers réservés (journal/meta) au niveau racine du store → ignorés.
+      // Reserved files (journal/meta) at the store root → skipped.
       else if (e.name.endsWith(".json") && !(dir === STORE_ROOT && RESERVED.has(e.name))) {
         try {
           out.push(...(JSON.parse(await fs.readFile(full, "utf8")) as Comment[]));
         } catch {
-          /* ignore fichier illisible */
+          /* ignore unreadable file */
         }
       }
     }
@@ -86,7 +86,7 @@ export async function createComment(input: {
     page: input.page,
     scope: input.scope,
     anchor: input.scope === "selection" ? input.anchor : null,
-    thread: [{ author: input.author || "quentin", body: input.body, ts: now }],
+    thread: [{ author: input.author || "you", body: input.body, ts: now }],
     status: "open",
     hold: false,
     resolution: null,
@@ -112,8 +112,8 @@ export async function patchComment(
   const comments = await read(page);
   const c = comments.find((x) => x.id === id);
   if (!c) return null;
-  // Édition du message original : autorisée UNIQUEMENT si pas encore traité
-  // (status open) ET sans réponse (thread = 1). Enforcement serveur.
+  // Editing the original message: allowed ONLY if not yet processed (status open)
+  // AND has no reply (thread = 1). Server-side enforcement.
   if (patch.edit?.body && c.status === "open" && c.thread.length === 1) {
     c.thread[0].body = patch.edit.body;
   }
@@ -122,7 +122,7 @@ export async function patchComment(
   if (patch.resolution !== undefined) c.resolution = patch.resolution;
   if (patch.reply?.body) {
     c.thread.push({
-      author: patch.reply.author || "quentin",
+      author: patch.reply.author || "you",
       body: patch.reply.body,
       ts: new Date().toISOString(),
     });

package/src/lib/icons.ts

@@ -1,6 +1,6 @@
-// Icônes inline (Lucide, MIT) sous forme de chaînes SVG — les cartes de
-// commentaires sont rendues en JS (innerHTML), donc pas de composant Astro ici.
-// Monochromes (stroke = currentColor) → héritent de la couleur du bouton.
+// Inline icons (Lucide, MIT) as SVG strings — comment cards are rendered in JS
+// (innerHTML), so no Astro component here. Monochrome (stroke = currentColor) →
+// they inherit the button's color.
 const svg = (inner: string) =>
   `<svg viewBox="0 0 24 24" width="15" height="15" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">${inner}</svg>`;
 

package/src/lib/journal.ts

@@ -1,21 +1,20 @@
-// Journal des modifications de la doc (serveur, lecture seule côté site).
-// Écrit par l'agent lors d'une passe de revue (édition directe de
-// `<store>/journal.json`), affiché par la page /journal. Chemin du store dérivé
-// de notabene.config (cf. src/config.mjs) — jamais en dur.
+// Doc change journal (server, read-only from the site). Written by the agent during
+// a review pass (direct edit of `<store>/journal.json`), displayed by the /journal
+// page. Store path derived from notabene.config (cf. src/config.mjs) — never hardcoded.
 import fs from "node:fs/promises";
 import path from "node:path";
 import { storeAbs } from "../config.mjs";
 
 export interface JournalChange {
-  /** Chemin logique de la page modifiée (= data-page), ex. docs/architecture/billing. */
+  /** Logical path of the changed page (= data-page), e.g. docs/architecture/billing. */
   page: string;
-  /** Commentaires traités par cette modification (ids). */
+  /** Comments addressed by this change (ids). */
   commentIds: string[];
-  /** Ce qui a changé. */
+  /** What changed. */
   what: string;
-  /** Pourquoi (issu du commentaire). */
+  /** Why (from the comment). */
   why: string;
-  /** Référence optionnelle (sha de commit, etc.). */
+  /** Optional reference (commit sha, etc.). */
   ref?: string;
 }
 
@@ -24,7 +23,7 @@ export interface JournalEntry {
   /** ISO date (YYYY-MM-DD). */
   date: string;
   title: string;
-  /** Résumé prose de la passe. */
+  /** Prose summary of the pass. */
   summary: string;
   changes: JournalChange[];
 }

package/src/lib/nav.ts

@@ -1,8 +1,7 @@
 import { getCollection } from "astro:content";
 import { locale } from "../config.mjs";
 
-// Un espace = la `key` d'un root de notabene.config (plus le duo figé
-// reference/workbench). Chaîne libre.
+// A space = the `key` of a notabene.config root (no fixed duo). Free string.
 export type Space = string;
 
 export interface NavLeaf {
@@ -22,7 +21,8 @@ export interface NavGroup {
 
 export type NavNode = NavLeaf | NavGroup;
 
-// Mots à rendre en capitales (acronymes), et petits mots gardés en minuscule.
+// Words to uppercase (acronyms), and small words kept lowercase. The small-word
+// set is intentionally EN + FR so path segments in either language title-case well.
 const ACRONYMS = new Set([
   "api", "iam", "dns", "ip", "ips", "url", "ssl", "tls", "ocr", "qr", "mac", "http",
   "https", "sse", "ws", "id", "ttl", "ssrf", "mx", "smtp", "dnsbl", "dbl", "dnswl",
@@ -37,7 +37,7 @@ const SMALL_WORDS = new Set([
 
 export function humanize(seg: string): string {
   const words = seg
-    .replace(/([a-z0-9])([A-Z])/g, "$1 $2") // sépare le camelCase (ex. ipAddress)
+    .replace(/([a-z0-9])([A-Z])/g, "$1 $2") // split camelCase (e.g. ipAddress)
     .split(/[-_\s]+/)
     .filter(Boolean);
   return words
@@ -51,8 +51,8 @@ export function humanize(seg: string): string {
 }
 
 /**
- * Libellé COURT de navigation = nom de fichier humanisé. Le H1 (souvent verbeux,
- * pensé pour une lecture standalone) sert au titre de la page, pas à la sidebar.
+ * SHORT nav label = humanized file name. The H1 (often verbose, written for
+ * standalone reading) is used for the page title, not the sidebar.
  */
 export function navLabel(id: string): string {
   const seg = id.split("/").pop() ?? id;
@@ -60,7 +60,7 @@ export function navLabel(id: string): string {
   return humanize(seg);
 }
 
-/** Titre de page = premier H1 (descriptif), sinon le libellé de nav. */
+/** Page title = first H1 (descriptive), else the nav label. */
 export function pageTitle(body: string | undefined, id: string): string {
   const m = body?.match(/^#\s+(.+?)\s*$/m);
   if (m) return m[1].replace(/[*_`]/g, "").trim();
@@ -68,17 +68,17 @@ export function pageTitle(body: string | undefined, id: string): string {
 }
 
 async function entriesOf(space: Space) {
-  // Nom de collection = key de l'espace (cf. content.config.ts). Dynamique.
+  // Collection name = the space key (cf. content.config.ts). Dynamic.
   return getCollection(space as never);
 }
 
-/** Construit l'arbre de navigation d'un espace à partir des ids slash-séparés. */
+/** Builds a space's navigation tree from the slash-separated ids. */
 export async function buildNav(space: Space): Promise<NavNode[]> {
   const entries = await entriesOf(space);
   const rootChildren: NavNode[] = [];
 
   for (const entry of entries) {
-    // README/index RACINE = page d'accueil de l'espace, pas une feuille de nav.
+    // ROOT README/index = the space home page, not a nav leaf.
     if (/^(readme|index)$/i.test(entry.id)) continue;
     const parts = entry.id.split("/");
     let children = rootChildren;
@@ -114,7 +114,7 @@ export async function buildNav(space: Space): Promise<NavNode[]> {
 }
 
 function rank(node: NavNode): number {
-  // README / index en tête, puis les groupes, puis les autres pages.
+  // README / index first, then groups, then other pages.
   if (node.type === "leaf" && /^(readme|index)$/i.test(node.segment)) return 0;
   if (node.type === "group") return 1;
   return 2;

package/src/pages/[space]/[...slug].astro

@@ -13,7 +13,7 @@ export async function getStaticPaths() {
         params: { space: root.key, slug: entry.id },
         props: { spaceKey: root.key, entry },
       }));
-      // Page d'accueil de l'espace (slug vide → /<key>).
+      // Space home page (empty slug → /<key>).
       return [...docs, { params: { space: root.key, slug: undefined }, props: { spaceKey: root.key, entry: undefined } }];
     }),
   );
@@ -42,7 +42,7 @@ if (entry) {
   for (let i = 0; i < parts.length - 1; i++) breadcrumb.push({ label: humanize(parts[i]) });
   breadcrumb.push({ label: title });
 } else {
-  // Accueil d'espace : on rend le README/index racine s'il existe, sinon des cartes.
+  // Space home: render the root README/index if present, else index cards.
   const all = await getCollection(spaceKey as never);
   const readme = all.find((e: { id: string }) => /^(readme|index)$/i.test(e.id));
   if (readme) {

package/src/pages/api/comments.ts

@@ -1,7 +1,7 @@
 import type { APIRoute } from "astro";
 import { createComment, listAllComments, listComments, patchComment, removeComment } from "../../lib/comments";
 
-// On-demand (lecture/écriture de fichiers) — pas de prerender.
+// On-demand (reads/writes files) — no prerender.
 export const prerender = false;
 
 const json = (data: unknown, status = 200) =>
@@ -10,9 +10,9 @@ const json = (data: unknown, status = 200) =>
     headers: { "content-type": "application/json; charset=utf-8" },
   });
 
-// GARDE-FOU (§3) : la voie d'écriture (elle modifie le git du repo) n'existe qu'en
-// `astro dev`. En build/preview (PROD), les mutations sont refusées — l'écriture
-// ne fait pas partie de l'artefact déployable. Override explicite : NOTABENE_ALLOW_WRITE=1.
+// SAFETY (§3): the write path (it modifies the repo's git) only exists under
+// `astro dev`. In build/preview (PROD), mutations are refused — writing is not part
+// of the deployable artifact. Explicit override: NOTABENE_ALLOW_WRITE=1.
 const WRITABLE = import.meta.env.DEV || process.env.NOTABENE_ALLOW_WRITE === "1";
 const denyIfReadOnly = () =>
   WRITABLE ? null : json({ error: "read-only: write API disabled outside dev" }, 403);

package/src/pages/comments.astro

@@ -1,33 +1,36 @@
 ---
 import DocLayout from "../layouts/DocLayout.astro";
-import { roots } from "../config.mjs";
+import { locale, roots } from "../config.mjs";
+import { t } from "../i18n.mjs";
+
+const m = t(locale);
 ---
 
-<DocLayout title="Tous les commentaires">
-  <h1>Tous les commentaires</h1>
-  <p class="lede">Vue agrégée de toute la doc, avec filtres. Clic sur une page → ouvre le commentaire à son emplacement.</p>
+<DocLayout title={m.allCommentsTitle}>
+  <h1>{m.allCommentsTitle}</h1>
+  <p class="lede">{m.allCommentsLede}</p>
 
   <div class="caf-filters">
-    <input id="caf-search" type="search" placeholder="Rechercher (texte, page, citation)…" />
+    <input id="caf-search" type="search" placeholder={m.searchCommentsPlaceholder} />
     <select id="caf-status">
-      <option value="active">Actifs</option>
-      <option value="open">Open</option>
-      <option value="resolved">Résolus</option>
-      <option value="all">Tous statuts</option>
+      <option value="active">{m.stActive}</option>
+      <option value="open">{m.stOpen}</option>
+      <option value="resolved">{m.stResolved}</option>
+      <option value="all">{m.stAll}</option>
     </select>
     <select id="caf-space">
-      <option value="all">Tous espaces</option>
+      <option value="all">{m.spAll}</option>
       {roots.map((r) => <option value={r.key}>{r.label}</option>)}
     </select>
     <select id="caf-hold">
-      <option value="all">Attente : tous</option>
-      <option value="active">Hors attente</option>
-      <option value="hold">En attente</option>
+      <option value="all">{m.holdAll}</option>
+      <option value="active">{m.holdActive}</option>
+      <option value="hold">{m.holdOnly}</option>
     </select>
     <span id="caf-count" class="cmt-count"></span>
   </div>
 
-  <div id="caf-list" class="caf-list"><p class="cmt-empty">Chargement…</p></div>
+  <div id="caf-list" class="caf-list"><p class="cmt-empty">{m.loading}</p></div>
 </DocLayout>
 
 <script>
@@ -44,6 +47,9 @@ import { roots } from "../config.mjs";
   const ROOTS: { key: string; label: string; path: string }[] = JSON.parse(
     document.getElementById("notabene-roots")?.textContent || "[]",
   );
+  const M: Record<string, string> = JSON.parse(
+    document.getElementById("notabene-i18n")?.textContent || "{}",
+  );
   const spaceLabel = (key: string): string => ROOTS.find((r) => r.key === key)?.label ?? key;
 
   const listEl = document.getElementById("caf-list")!;
@@ -63,7 +69,7 @@ import { roots } from "../config.mjs";
       body: body ? JSON.stringify(body) : undefined,
     }).then((r) => r.json());
   const fmt = (s: string) => s.slice(0, 16).replace("T", " ");
-  // Root le plus spécifique (path le plus long) d'abord — cf. config.routeForPage.
+  // Most specific root (longest path) first — cf. config.routeForPage.
   const ROUTE_ROOTS = [...ROOTS].sort((a, b) => b.path.length - a.path.length);
   function routeFor(page: string): string {
     for (const r of ROUTE_ROOTS) {
@@ -104,22 +110,22 @@ import { roots } from "../config.mjs";
                 <span class="cmt-dot ${c.status}"></span>
                 <a class="caf-page" href="${routeFor(c.page)}?c=${c.id}">${esc(c.page)}</a>
                 <span class="r-space ${c.space}">${esc(spaceLabel(c.space))}</span>
-                ${c.scope === "selection" ? `<span class="caf-quote">“${esc((c.anchor?.quote || "").slice(0, 60))}”</span>` : `<span class="cmt-scope">📄 page</span>`}
-                ${c.hold ? '<span class="cmt-hold-badge">⏸ en attente</span>' : ""}
-                ${c.thread.length > 1 ? `<span class="caf-replies">${c.thread.length - 1} rép.</span>` : ""}
+                ${c.scope === "selection" ? `<span class="caf-quote">“${esc((c.anchor?.quote || "").slice(0, 60))}”</span>` : `<span class="cmt-scope">${M.scopePage}</span>`}
+                ${c.hold ? `<span class="cmt-hold-badge">${M.onHold}</span>` : ""}
+                ${c.thread.length > 1 ? `<span class="caf-replies">${c.thread.length - 1} ${M.repliesSuffix}</span>` : ""}
               </div>
               <div class="caf-body"><b>${esc(head.author)}</b> ${esc(head.body)}</div>
               ${c.resolution?.note ? `<div class="cmt-resolution">✔ ${esc(c.resolution.note)}</div>` : ""}
               <div class="caf-actions">
                 <span class="cmt-ts">${fmt(c.updatedAt)}</span>
-                ${c.status === "resolved" ? `<button data-act="reopen" title="Rouvrir" aria-label="Rouvrir">${ICONS.reopen}</button>` : `<button data-act="resolve" title="Résoudre" aria-label="Résoudre">${ICONS.check}</button>`}
-                <button data-act="${c.hold ? "unhold" : "hold"}" title="${c.hold ? "Réactiver" : "Mettre en attente"}" aria-label="${c.hold ? "Réactiver" : "Mettre en attente"}">${c.hold ? ICONS.play : ICONS.pause}</button>
-                <button data-act="delete" class="danger" title="Supprimer" aria-label="Supprimer">${ICONS.trash}</button>
+                ${c.status === "resolved" ? `<button data-act="reopen" title="${M.tReopen}" aria-label="${M.tReopen}">${ICONS.reopen}</button>` : `<button data-act="resolve" title="${M.tResolve}" aria-label="${M.tResolve}">${ICONS.check}</button>`}
+                <button data-act="${c.hold ? "unhold" : "hold"}" title="${c.hold ? M.tUnhold : M.tHold}" aria-label="${c.hold ? M.tUnhold : M.tHold}">${c.hold ? ICONS.play : ICONS.pause}</button>
+                <button data-act="delete" class="danger" title="${M.tDelete}" aria-label="${M.tDelete}">${ICONS.trash}</button>
               </div>
             </article>`;
           })
           .join("")
-      : `<p class="cmt-empty">Aucun commentaire pour ces filtres.</p>`;
+      : `<p class="cmt-empty">${M.noCommentsFilters}</p>`;
   }
 
   async function load() {

package/src/pages/index.astro

@@ -1,13 +1,14 @@
 ---
 import DocLayout from "../layouts/DocLayout.astro";
-import { roots, siteName } from "../config.mjs";
+import { locale, roots, siteName } from "../config.mjs";
+import { t } from "../i18n.mjs";
+
+const m = t(locale);
 ---
 
 <DocLayout title="Home">
-  <h1>{siteName} documentation</h1>
-  <p class="lede">
-    {roots.length} space{roots.length > 1 ? "s" : ""}, sourced live from the repo.
-  </p>
+  <h1>{siteName} {m.homeDocumentation}</h1>
+  <p class="lede">{m.homeLede}</p>
 
   <div class="home-cards">
     {

package/src/pages/journal.astro

@@ -2,23 +2,20 @@
 export const prerender = false;
 import DocLayout from "../layouts/DocLayout.astro";
 import { readJournal } from "../lib/journal";
-import { routeForPage as routeFor } from "../config.mjs";
+import { locale, routeForPage as routeFor } from "../config.mjs";
+import { t } from "../i18n.mjs";
 
-const entries = (await readJournal()).slice().reverse(); // plus récent en premier
+const m = t(locale);
+const entries = (await readJournal()).slice().reverse(); // most recent first
 ---
 
-<DocLayout title="Journal">
-  <h1>Journal des modifications</h1>
-  <p class="lede">
-    Historique des passes de revue : ce qui a changé dans la doc, et <strong>pourquoi</strong>
-    (lié aux commentaires qui l'ont déclenché).
-  </p>
+<DocLayout title={m.journalTitle}>
+  <h1>{m.journalHeading}</h1>
+  <p class="lede">{m.journalLede}</p>
 
   {
     entries.length === 0 ? (
-      <p class="cmt-empty">
-        Aucune passe enregistrée. Quand Claude traite des commentaires, une entrée est ajoutée ici.
-      </p>
+      <p class="cmt-empty">{m.journalEmpty}</p>
     ) : (
       <div class="journal">
         {entries.map((e) => (
@@ -37,7 +34,7 @@ const entries = (await readJournal()).slice().reverse(); // plus récent en prem
                   <span class="journal-what"> — {c.what}</span>
                   <div class="journal-why">{c.why}</div>
                   {c.commentIds.length > 0 && (
-                    <div class="journal-cids">commentaires : {c.commentIds.join(", ")}</div>
+                    <div class="journal-cids">{m.journalComments} {c.commentIds.join(", ")}</div>
                   )}
                 </li>
               ))}

package/src/remark/rewrite-links.mjs

@@ -1,15 +1,14 @@
 import path from "node:path";
 
-// Réécrit les liens RELATIFS vers des fichiers .md/.mdx (entre docs) en routes du
-// site. Sans ça, les liens inter-doc (`[x](../foo.md)`) pointent vers des fichiers
-// et donnent des 404 dans le site.
+// Rewrites RELATIVE links to .md/.mdx files (between docs) into site routes.
+// Without this, inter-doc links (`[x](../foo.md)`) point at files and 404 in the site.
 //
 //   <root.path>/**  → /<root.key>/<slug>
 //
-// Générique : la table de correspondance vient des `roots[]` de notabene.config
-// (cf. src/config.mjs), pas de chemins en dur. Les liens externes (http…, mailto),
-// absolus (/…), ancres (#…) et non-.md sont laissés intacts. Les cibles .md HORS
-// des espaces déclarés sont laissées telles quelles.
+// Generic: the mapping comes from notabene.config `roots[]` (cf. src/config.mjs),
+// no hardcoded paths. External links (http…, mailto), absolute (/…), anchors (#…)
+// and non-.md targets are left intact. .md targets OUTSIDE the declared spaces are
+// left as-is.
 
 function slug(rel) {
   return rel.replace(/\\/g, "/").replace(/\.mdx?$/i, "");
@@ -23,11 +22,11 @@ function visit(node, fn) {
 }
 
 /**
- * @param {{ key: string, abs: string }[]} roots — espaces normalisés (config.mjs).
+ * @param {{ key: string, abs: string }[]} roots — normalized spaces (config.mjs).
  */
 export function remarkRewriteLinks(roots) {
-  // Root le plus spécifique (chemin absolu le plus long) d'abord : un espace
-  // imbriqué (docs/plans) doit gagner sur son parent (docs).
+  // Most specific root (longest absolute path) first: a nested space (docs/plans)
+  // must win over its parent (docs).
   const ordered = [...roots].sort((a, b) => b.abs.length - a.abs.length);
 
   function toRoute(abs) {

package/src/styles/global.css

@@ -1,4 +1,4 @@
-/* Documentation interne Apophis — thème lisible, clair/sombre auto. */
+/* notabene renderer — readable theme, auto light/dark. */
 
 :root {
   --bg: #ffffff;
@@ -43,8 +43,8 @@
   box-sizing: border-box;
 }
 
-/* L'attribut `hidden` doit toujours l'emporter sur les `display` des composants
-   (popover commentaires, formulaires de réponse repliés, etc.). */
+/* The `hidden` attribute must always win over component `display` values
+   (comment popovers, collapsed reply forms, etc.). */
 [hidden] {
   display: none !important;
 }
@@ -762,7 +762,7 @@ a:hover {
   box-shadow: 0 2px 8px rgba(0, 0, 0, 0.25);
 }
 
-/* Discussion (commentaires de page) — en bas de la page, aligné sur la prose. */
+/* Discussion (page-wide comments) — at the bottom of the page, aligned with prose. */
 .cmt-page {
   max-width: var(--content-max);
   margin: 3rem auto 0;
@@ -785,7 +785,7 @@ a:hover {
   max-width: 640px;
 }
 
-/* Marge droite — annotations ancrées. */
+/* Right rail — anchored annotations. */
 .cmt-rail {
   margin-top: 1.5rem;
   border-top: 1px solid var(--border);
@@ -809,7 +809,7 @@ a:hover {
   color: var(--text-faint);
 }
 
-/* Popover de création sur sélection. */
+/* Creation popover on selection. */
 .cmt-pop {
   position: fixed;
   z-index: 70;
@@ -863,7 +863,7 @@ a:hover {
   border-color: var(--accent);
 }
 
-/* Popover de LECTURE (clic sur texte surligné) — affiche le(s) commentaire(s). */
+/* READING popover (click on highlighted text) — shows the comment(s). */
 .cmt-view {
   position: fixed;
   z-index: 70;