Open Lore Network
Roadmap
P-009ShippedCaptured retroactively

Cross-reference plugin (remark-journal-refs)

A small unified.js / remark plugin that walks markdown text nodes and rewrites bare cross-reference tokens — Entry NNN, B-NNN, G-NNN, and (after Entry 016) P-NNN — into internal links. RSC-safe: takes pre-built slug maps, does no I/O.

Milestone
Pre-roadmap
Posted credit value
6credits
Founder credits accrued
6of 6
Owner
Creator
Related
Entry 017

Captured retroactively. This project shipped before the roadmap surface existed. The credit value is a post-hoc estimate per the methodology in Entry 017 and is subject to revision under G-038's calibration mechanism. The Phase 1–4 surface used the plugin without the P-NNN extension; the P-NNN extension shipped as part of P-001.

What shipped

  • src/lib/remark-journal-refs.ts exporting the remarkJournalRefs plugin and the JournalRefMaps type.
  • Pattern recognition for Entry 010, Entries 011, 012 (plural form), B-004, G-025, and P-001.
  • Skip-list: existing links, link references, code spans, and headings are not rewritten — titles stay text, in-prose tokens become links.
  • Deterministic, no-IO design so it's safe to run inside React Server Components: the caller passes pre-built id-to-slug maps from the loaders.

Why this is its own project

Every reading surface in OLN runs through this plugin. It's what makes "Entry 010" become a link in any context — Journal entries, Register entries, Roadmap project bodies, future comments. Naming it as its own project keeps the dependency visible: when a new corpus comes online, this plugin is the touchpoint.

Your read on this

Anonymous reactions are accepted; signing in lets you change yours.