Node-page navigation model: blog → related → Wikipedia
Date: 2026-08-28 Project: astro-starter-template (second-brain)
Decision
Present each node as a blog article that keeps connecting like Wikipedia.
Source: site/app/ (copied to dist/ at build; dist/ is git-ignored).
Node page anatomy (in order)
- Article header: kind/status/level badges (kicker), title with status glyph, tag row.
- Body (the note) as lead prose.
- Open questions.
- “Path to master” (prerequisite route).
- Links from this note — outgoing
edgeswithrelchips (NEW; was missing entirely). Wikipedia’s outbound links. - Related — blog-style related grid: proximity score = +2 per shared tag, +1 same section, excludes nodes already directly linked (edge or backlink), top 6, card = glyph + title + kind + 110-char excerpt. Only NEW connections are offered.
- Backlinks (“what links here”).
- Used by projects.
- Footer nav: prev / next within the node’s own track (section reading order)
- “in track →” link. Sidebar highlights the node’s section on node pages.
Gotchas
- Sidebar
activewas never set on node pages before — node views now callrenderSidebar(section). curriculum.place[slug].prev/nextis a GLOBAL reading order; for track-local prev/next compute fromsection.nodesarray instead (sectionNav helper).- Related cards must exclude direct neighbors or they duplicate the link lists.
- Smoke test the SPA headless: stub
document.querySelector/window/localStorage/fetch(real JSON), importdist/app/main.js, set#/node/x— catches template runtime errors in <1s.