Merge pull request #113 from raifdmueller/feature/link-llms-txt-and-all-anchors

feat: Render all-anchors.adoc in frontend via inlined web version

Author: rdmueller

scripts/generate-llms-txt.js

@@ -246,7 +246,66 @@ function generateLlmsTxt() {
   console.warn(`Generated: website/public/llms.txt (${totalAnchors} anchors, ~${kb} KB)`)
 }
 
+// ─── Generate website/public/docs/all-anchors.adoc (inlined, no includes) ────
+
+/**
+ * Shift AsciiDoc heading levels by offset (e.g. +1 turns = into ==)
+ */
+function shiftHeadings(content, offset) {
+  return content.replace(/^(=+)( .+)$/gm, (_, eq, rest) => '='.repeat(eq.length + offset) + rest)
+}
+
+/**
+ * Strip document-level AsciiDoc attributes (:key: value) used as metadata
+ */
+function stripDocAttrs(content) {
+  return content.replace(/^:[a-z][a-z0-9-]*:.*$/gm, '')
+}
+
+function generateAllAnchorsWebAdoc() {
+  const WEB_DOCS = path.join(ROOT, 'website/public/docs')
+  fs.mkdirSync(WEB_DOCS, { recursive: true })
+
+  const lines = [
+    '= Semantic Anchors — Complete Reference',
+    ':toc:',
+    ':toc-placement: preamble',
+    ':toclevels: 2',
+    '',
+  ]
+
+  const aboutPath = path.join(ROOT, 'docs/about.adoc')
+  if (fs.existsSync(aboutPath)) {
+    const aboutContent = fs.readFileSync(aboutPath, 'utf-8')
+    lines.push(shiftHeadings(stripDocAttrs(aboutContent), 1))
+    lines.push('')
+    lines.push("'''")
+    lines.push('')
+  }
+
+  for (const category of categories) {
+    lines.push(`== ${category.name}`)
+    lines.push('')
+    for (const anchorId of category.anchors) {
+      const filepath = path.join(ROOT, 'docs/anchors', `${anchorId}.adoc`)
+      if (fs.existsSync(filepath)) {
+        const anchorContent = fs.readFileSync(filepath, 'utf-8')
+        lines.push(shiftHeadings(stripDocAttrs(anchorContent), 2))
+        lines.push('')
+      }
+    }
+    lines.push("'''")
+    lines.push('')
+  }
+
+  const output = lines.join('\n')
+  fs.writeFileSync(path.join(WEB_DOCS, 'all-anchors.adoc'), output, 'utf-8')
+  const kb = Math.round(Buffer.byteLength(output, 'utf-8') / 1024)
+  console.warn(`Generated: website/public/docs/all-anchors.adoc (~${kb} KB, inlined)`)
+}
+
 // ─── Main ────────────────────────────────────────────────────────────────────
 
 generateAllAnchorsAdoc()
+generateAllAnchorsWebAdoc()
 generateLlmsTxt()

website/src/components/footer.js

@@ -31,9 +31,7 @@ export function renderFooter(version) {
             >${i18n.t('footer.llmsTxt')}</a>
             <span class="text-gray-300 dark:text-gray-600">|</span>
             <a
-              href="https://github.com/LLM-Coding/Semantic-Anchors/blob/main/docs/all-anchors.adoc"
-              target="_blank"
-              rel="noopener noreferrer"
+              href="#/all-anchors"
               class="text-sm text-[var(--color-text-secondary)] hover:text-[var(--color-text)] transition-colors"
               data-i18n="footer.allAnchors"
             >${i18n.t('footer.allAnchors')}</a>

website/src/main.js

@@ -97,6 +97,7 @@ function initApp() {
   addRoute('/', renderHomePage)
   addRoute('/about', renderAboutPage)
   addRoute('/contributing', renderContributingPage)
+  addRoute('/all-anchors', renderAllAnchorsPage)
 
   const app = document.querySelector('#app')
   if (!app) return
@@ -161,6 +162,15 @@ function renderContributingPage() {
   loadDocContent('CONTRIBUTING.adoc')
 }
 
+function renderAllAnchorsPage() {
+  const pageContent = document.getElementById('page-content')
+  if (!pageContent) return
+
+  pageContent.innerHTML = renderDocPage('Full Reference')
+  updateActiveNavLink()
+  loadDocContent('docs/all-anchors.adoc')
+}
+
 function updateActiveNavLink() {
   const currentRoute = window.location.hash.slice(1) || '/'
   document.querySelectorAll('.nav-link').forEach((link) => {
@@ -282,6 +292,8 @@ function handleLanguageChange() {
     loadDocContent('docs/about.adoc')
   } else if (currentRoute === '/contributing') {
     loadDocContent('CONTRIBUTING.adoc')
+  } else if (currentRoute === '/all-anchors') {
+    loadDocContent('docs/all-anchors.adoc')
   } else if (currentRoute === '/') {
     initCardGridVisualization()
   }