graph

docs/index.md

@@ -51,7 +51,7 @@ I use this library of documents as a quick reference to find technical answers,
 
 ### AI
 
-[ai](/docs/ai/ai.md)
+[ai](ai/ai.md)
 
 ### Computers
 

docusaurus.config.js

@@ -135,6 +135,7 @@ export default {
         {to: 'about/',activeBasePath: 'til',label: 'About',position: 'left'},
         {to: 'ai', label: 'AI',position: 'left'},
         {to: 'docs/',activeBasePath: 'docs',label: 'Docs',position: 'left'},
+        {to: 'graph',activeBasePath: 'graph',label: 'Graph',position: 'left'},
         {to: 'lists/',activeBasePath: 'lists',label: 'Lists',position: 'left'},
         {to: 'notes/',activeBasePath: 'notes',label: 'Notes',position: 'left'},
         {to: 'posts/',activeBasePath: 'posts',label: 'Posts',position: 'left'}, 

notes/house/house.md

@@ -8,6 +8,7 @@
 | [build](build.md)
 | [fireplaces](fire.md)
 | [helene](helene.md)
+| [kitchen](kitchen.md)
 | [studio](studio.md)
 | [helene repairs](helene-repairs.md)
 | [helene ins](helene-ins-sum.md)

scripts/build-graph.mjs

@@ -33,12 +33,9 @@ const DOC_SECTIONS = [
   { dir: 'lists', base: '/lists', group: 'lists' },
 ];
 const BLOG_SECTIONS = [{ dir: 'posts', base: '/posts', group: 'posts' }];
-const PAGES = [
-  { route: '/', label: 'Home', group: 'page' },
-  { route: '/ai', label: 'AI Assistant', group: 'page' },
-  { route: '/help', label: 'Help', group: 'page' },
-  { route: '/map', label: 'Map', group: 'page' },
-  { route: '/about', label: 'About', group: 'page' },
+const PAGES_DIR = 'src/pages';                                 // about.md, ai.mdx, map.md, …
+const MANUAL_NODES = [                                          // routes with no .md in src/pages
+  { route: '/graph', label: 'Graph', group: 'page' },          // graph.jsx
   { route: '/posts', label: 'Posts (blog index)', group: 'page' },
 ];
 
@@ -113,7 +110,7 @@ const addNode = (route, label, group, partial = false) => {
   if (!nodes.has(route)) nodes.set(route, partial ? { id: route, label, group, partial: true } : { id: route, label, group });
   if (!byLc.has(route.toLowerCase())) byLc.set(route.toLowerCase(), route);
 };
-PAGES.forEach((p) => addNode(p.route, p.label, p.group));
+MANUAL_NODES.forEach((p) => addNode(p.route, p.label, p.group));
 
 let skipped = 0, noSlug = 0;
 
@@ -158,6 +155,16 @@ for (const { dir, base, group } of BLOG_SECTIONS) {
   }
 }
 
+// standalone pages (src/pages/*.md|mdx) — parse their bodies so About/Map/AI/Home connect
+for (const file of walk(join(ROOT, PAGES_DIR))) {
+  const name = basename(file).replace(/\.mdx?$/, '');
+  if (name.startsWith('_')) continue;
+  const { data, body } = parseFrontmatter(readFileSync(file, 'utf8'));
+  const route = name === 'index' ? '/' : `/${name}`;
+  addNode(route, titleOf(data, body, name), 'page');
+  files.push({ base: '', rel: name, route, body }); // base '' → relative links resolve from site root
+}
+
 // ---------- link resolution ----------
 const matchRoute = (r) => (r == null ? null : nodes.has(r) ? r : byLc.get(r.toLowerCase()) || null);
 
@@ -193,12 +200,14 @@ const links = [];
 const unresolved = new Map();
 const LINK_RE = /\]\(([^)\s]+)(?:\s+"[^"]*")?\)/g;
 const HREF_RE = /href=["']([^"']+)["']/g;
+const CLICK_RE = /^\s*click\s+\S+\s+"([^"]+)"/gm;             // mermaid: click NODE "url" (map.md)
 
 for (const { base, rel, route, body } of files) {
   const targets = new Set();
   let m;
   while ((m = LINK_RE.exec(body))) targets.add(m[1]);
   while ((m = HREF_RE.exec(body))) targets.add(m[1]);
+  while ((m = CLICK_RE.exec(body))) targets.add(m[1]);
   for (const t of targets) {
     const dest = resolveLink(t, base, rel);
     if (!dest) {

src/pages/graph.jsx

@@ -8,9 +8,7 @@ export default function GraphPage() {
       <main style={{padding: '1rem 1.25rem 0'}}>
         <h1 style={{marginBottom: '0.25rem'}}>Graph</h1>
         <p style={{marginBottom: '0.75rem', maxWidth: 820}}>
-          How the pages here link to one another — docs, notes, lists, and posts. Unlike the
-          file-based view, this resolves the absolute route links too, so the posts' outgoing
-          links to docs/notes/lists show up as edges. Rebuilt with <code>npm run graph</code>.
+          How the pages here link to one another — rebuilt with <code>npm run graph</code>.
         </p>
         <KnowledgeGraph />
       </main>

src/pages/map.md

@@ -8,7 +8,111 @@ hide_table_of_contents: true
 
 # Map
 
-A clickable version of the top level — nodes link out to each section (the full picture is in the mindmap below).
+```mermaid
+%%{
+  init: {
+    'theme':'forest'
+  }
+}%%
+mindmap
+  root)DAW.com 💻(
+    About 📕
+      Ancestors
+      Bio
+      CV
+    )DW.com 📘 (
+    )Desk 📑(
+      Bookmarks
+      Categories
+      Posts
+      Reader
+      Tags
+    )Code 💻(
+      Activity
+      Commits
+      Repos 💾
+        Branches
+        Commits
+        Issues
+        Releases
+      Wikis
+    )Contact 📥(
+      Chat
+      Chess
+      Contract
+      Guestbook
+      Inquiry
+      Invoice
+      Email List
+      Pay
+      Support
+    Search 🔎
+    Sitemap
+      Analytics
+      Privacy
+    )Studio 🖥️(
+      Art
+      Audio
+      Design
+      Projects
+      Photo
+      Radio
+      Video
+      Web
+    )TIL 📖(
+      AI
+      Docs 📓
+        Computers
+        Data
+        Database
+        Editors
+        Frameworks
+        Language
+        SaaS
+        Server
+        Hosted
+        Shell
+        Software
+        Versioning
+      Ideas
+      Notes 🗒️
+        art
+        dogs
+        garden
+        house
+        personal
+        work
+      Lists ✅
+        Now ⌚️
+          Learning
+          Listening
+          Playing
+          Reading
+          Watching
+        Next
+        Todo
+        Groceries
+        Shopping
+        Art
+        Lit
+        Motion
+        Music
+        Visual
+        Concepts
+        Design
+        Feeds
+        Lists
+        Places
+        People
+        Things
+        Trivia
+        Tweets
+        Quotes
+        Words
+      Posts
+```
+
+A clickable version of the top level — nodes link out to each section
 
 ```mermaid
 flowchart LR
@@ -182,106 +286,3 @@ flowchart LR
   click LS_WORDS "https://davidawindham.com/til/lists/words" _blank
 ```
 
-```mermaid
-%%{
-  init: {
-    'theme':'forest'
-  }
-}%%
-mindmap
-  root)DAW.com 💻(
-    About 📕
-      Ancestors
-      Bio
-      CV
-    )DW.com 📘 (
-    )Desk 📑(
-      Bookmarks
-      Categories
-      Posts
-      Reader
-      Tags
-    )Code 💻(
-      Activity
-      Commits
-      Repos 💾
-        Branches
-        Commits
-        Issues
-        Releases
-      Wikis
-    )Contact 📥(
-      Chat
-      Chess
-      Contract
-      Guestbook
-      Inquiry
-      Invoice
-      Email List
-      Pay
-      Support
-    Search 🔎
-    Sitemap
-      Analytics
-      Privacy
-    )Studio 🖥️(
-      Art
-      Audio
-      Design
-      Projects
-      Photo
-      Radio
-      Video
-      Web
-    )TIL 📖(
-      AI
-      Docs 📓
-        Computers
-        Data
-        Database
-        Editors
-        Frameworks
-        Language
-        SaaS
-        Server
-        Hosted
-        Shell
-        Software
-        Versioning
-      Ideas
-      Notes 🗒️
-        art
-        dogs
-        garden
-        house
-        personal
-        work
-      Lists ✅
-        Now ⌚️
-          Learning
-          Listening
-          Playing
-          Reading
-          Watching
-        Next
-        Todo
-        Groceries
-        Shopping
-        Art
-        Lit
-        Motion
-        Music
-        Visual
-        Concepts
-        Design
-        Feeds
-        Lists
-        Places
-        People
-        Things
-        Trivia
-        Tweets
-        Quotes
-        Words
-      Posts
-```