kogral/docs/book/toc.js

71 lines
12 KiB
JavaScript
Raw Permalink Normal View History

2026-01-23 16:11:07 +00:00
// Populate the sidebar
//
// This is a script, and not included directly in the page, to control the total size of the book.
// The TOC contains an entry for each page, so if each page includes a copy of the TOC,
// the total size of the page becomes O(n**2).
class MDBookSidebarScrollbox extends HTMLElement {
constructor() {
super();
}
connectedCallback() {
this.innerHTML = '<ol class="chapter"><li class="chapter-item expanded affix "><a href="index.html">Introduction</a></li><li class="chapter-item expanded affix "><li class="part-title">Project Definition</li><li class="chapter-item expanded "><a href="kogral/what-is-kogral.html"><strong aria-hidden="true">1.</strong> What is KOGRAL?</a></li><li class="chapter-item expanded "><a href="kogral/core-concepts.html"><strong aria-hidden="true">2.</strong> Core Concepts</a></li><li class="chapter-item expanded "><a href="kogral/why-kogral.html"><strong aria-hidden="true">3.</strong> Why KOGRAL?</a></li><li class="chapter-item expanded "><a href="kogral/design-philosophy.html"><strong aria-hidden="true">4.</strong> Design Philosophy</a></li><li class="chapter-item expanded affix "><li class="part-title">Guides</li><li class="chapter-item expanded "><a href="guides/installation.html"><strong aria-hidden="true">5.</strong> Installation</a></li><li class="chapter-item expanded "><a href="guides/quickstart.html"><strong aria-hidden="true">6.</strong> Quick Start</a></li><li class="chapter-item expanded "><a href="guides/daily-workflows.html"><strong aria-hidden="true">7.</strong> Daily Workflows</a></li><li class="chapter-item expanded "><a href="guides/use-cases.html"><strong aria-hidden="true">8.</strong> Use Cases</a></li><li class="chapter-item expanded "><a href="guides/best-practices.html"><strong aria-hidden="true">9.</strong> Best Practices</a></li><li class="chapter-item expanded affix "><li class="part-title">Architecture</li><li class="chapter-item expanded "><a href="architecture/overview.html"><strong aria-hidden="true">10.</strong> System Overview</a></li><li class="chapter-item expanded "><a href="architecture/graph-model.html"><strong aria-hidden="true">11.</strong> Graph Model</a></li><li class="chapter-item expanded "><a href="architecture/config-driven.html"><strong aria-hidden="true">12.</strong> Config-Driven Design</a></li><li class="chapter-item expanded "><a href="architecture/storage-architecture.html"><strong aria-hidden="true">13.</strong> Storage Architecture</a></li><li class="chapter-item expanded "><a href="architecture/logseq-blocks-design.html"><strong aria-hidden="true">14.</strong> Logseq Blocks Design</a></li><li class="chapter-item expanded "><a href="architecture/adrs/001-nickel-vs-toml.html"><strong aria-hidden="true">15.</strong> ADR-001: Nickel vs TOML for Configuration</a></li><li class="chapter-item expanded "><a href="architecture/adrs/002-fastembed-ai-providers.html"><strong aria-hidden="true">16.</strong> ADR-002: FastEmbed via AI Providers</a></li><li class="chapter-item expanded "><a href="architecture/adrs/003-hybrid-storage.html"><strong aria-hidden="true">17.</strong> ADR-003: Hybrid Storage Strategy</a></li><li class="chapter-item expanded "><a href="architecture/adrs/004-logseq-blocks-support.html"><strong aria-hidden="true">18.</strong> ADR-004: Logseq Blocks Support</a></li><li class="chapter-item expanded "><a href="architecture/adrs/005-mcp-protocol.html"><strong aria-hidden="true">19.</strong> ADR-005: MCP Protocol for AI Integration</a></li><li class="chapter-item expanded affix "><li class="part-title">Setup</li><li class="chapter-item expanded "><a href="setup/prerequisites.html"><strong aria-hidden="true">20.</strong> Prerequisites</a></li><li class="chapter-item expanded "><a href="setup/installation.html"><strong aria-hidden="true">21.</strong> Installation Methods</a></li><li class="chapter-item expanded "><a href="setup/project-init.html"><strong aria-hidden="true">22.</strong> Project Initialization</a></li><li class="chapter-item expanded "><a href="setup/environment.html"><strong aria-hidden="true">23.</strong> Environment Configuration</a></li><li class="chapter-item expanded "><a href="setup/verification.html"><strong aria-hidden="true">24.</strong> Verification</a></li><li class="chapter-item expanded affix "><li class="part-title">Configuration</li><li class="chapter-item expanded "><a href="config/overview.html"><strong aria-hidden="true">25.</strong>
// Set the current, active page, and reveal it if it's hidden
let current_page = document.location.href.toString().split("#")[0].split("?")[0];
if (current_page.endsWith("/")) {
current_page += "index.html";
}
var links = Array.prototype.slice.call(this.querySelectorAll("a"));
var l = links.length;
for (var i = 0; i < l; ++i) {
var link = links[i];
var href = link.getAttribute("href");
if (href && !href.startsWith("#") && !/^(?:[a-z+]+:)?\/\//.test(href)) {
link.href = path_to_root + href;
}
// The "index" page is supposed to alias the first chapter in the book.
if (link.href === current_page || (i === 0 && path_to_root === "" && current_page.endsWith("/index.html"))) {
link.classList.add("active");
var parent = link.parentElement;
if (parent && parent.classList.contains("chapter-item")) {
parent.classList.add("expanded");
}
while (parent) {
if (parent.tagName === "LI" && parent.previousElementSibling) {
if (parent.previousElementSibling.classList.contains("chapter-item")) {
parent.previousElementSibling.classList.add("expanded");
}
}
parent = parent.parentElement;
}
}
}
// Track and set sidebar scroll position
this.addEventListener('click', function(e) {
if (e.target.tagName === 'A') {
sessionStorage.setItem('sidebar-scroll', this.scrollTop);
}
}, { passive: true });
var sidebarScrollTop = sessionStorage.getItem('sidebar-scroll');
sessionStorage.removeItem('sidebar-scroll');
if (sidebarScrollTop) {
// preserve sidebar scroll position when navigating via links within sidebar
this.scrollTop = sidebarScrollTop;
} else {
// scroll sidebar to current active section when navigating via "next/previous chapter" buttons
var activeSection = document.querySelector('#sidebar .active');
if (activeSection) {
activeSection.scrollIntoView({ block: 'center' });
}
}
// Toggle buttons
var sidebarAnchorToggles = document.querySelectorAll('#sidebar a.toggle');
function toggleSection(ev) {
ev.currentTarget.parentElement.classList.toggle('expanded');
}
Array.from(sidebarAnchorToggles).forEach(function (el) {
el.addEventListener('click', toggleSection);
});
}
}
window.customElements.define("mdbook-sidebar-scrollbox", MDBookSidebarScrollbox);