470 lines
15 KiB
JavaScript
470 lines
15 KiB
JavaScript
|
/**
|
|||
|
|
* app.js — Main logic for sunvpy static documentation site.
|
|||
|
|
* Handles routing, markdown rendering, navigation, TOC, and theme.
|
|||
|
|
*/
|
|||
|
|
(function () {
|
|||
|
|
"use strict";
|
|||
|
|
|
|||
|
|
// --- State ---
|
|||
|
|
let navData = null;
|
|||
|
|
let flatPages = []; // ordered array of all slugs
|
|||
|
|
let currentPage = null;
|
|||
|
|
let isDark = false;
|
|||
|
|
let mermaidInitialized = false;
|
|||
|
|
|
|||
|
|
// --- DOM refs ---
|
|||
|
|
const sidebarNav = document.getElementById("sidebarNav");
|
|||
|
|
const article = document.getElementById("article");
|
|||
|
|
const pageNav = document.getElementById("pageNav");
|
|||
|
|
const tocNav = document.getElementById("tocNav");
|
|||
|
|
const contentEl = document.getElementById("content");
|
|||
|
|
|
|||
|
|
// --- Init ---
|
|||
|
|
async function init() {
|
|||
|
|
// Theme
|
|||
|
|
const saved = localStorage.getItem("sunvpy-theme");
|
|||
|
|
if (saved === "dark" || (!saved && window.matchMedia("(prefers-color-scheme: dark)").matches)) {
|
|||
|
|
setTheme(true, false);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// Load nav
|
|||
|
|
try {
|
|||
|
|
const resp = await fetch("data/nav.json");
|
|||
|
|
navData = await resp.json();
|
|||
|
|
} catch (e) {
|
|||
|
|
article.innerHTML = '<div class="loading">无法加载导航数据。请通过 HTTP 服务器访问（如 python -m http.server）。</div>';
|
|||
|
|
return;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// Build flat page list
|
|||
|
|
flatPages = [];
|
|||
|
|
navData.sections.forEach(function (section) {
|
|||
|
|
if (section.pages) {
|
|||
|
|
section.pages.forEach(function (p) { flatPages.push(p.slug); });
|
|||
|
|
}
|
|||
|
|
if (section.groups) {
|
|||
|
|
section.groups.forEach(function (group) {
|
|||
|
|
group.pages.forEach(function (p) { flatPages.push(p.slug); });
|
|||
|
|
});
|
|||
|
|
}
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
// Build sidebar
|
|||
|
|
renderSidebar();
|
|||
|
|
|
|||
|
|
// Route
|
|||
|
|
handleRoute();
|
|||
|
|
window.addEventListener("hashchange", handleRoute);
|
|||
|
|
|
|||
|
|
// Theme toggle buttons
|
|||
|
|
document.getElementById("themeToggle").addEventListener("click", function () { setTheme(!isDark, true); });
|
|||
|
|
document.getElementById("themeToggleMobile").addEventListener("click", function () { setTheme(!isDark, true); });
|
|||
|
|
|
|||
|
|
// Mobile sidebar
|
|||
|
|
document.getElementById("hamburger").addEventListener("click", toggleMobileSidebar);
|
|||
|
|
document.getElementById("sidebarBackdrop").addEventListener("click", closeMobileSidebar);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// --- Theme ---
|
|||
|
|
function setTheme(dark, save) {
|
|||
|
|
isDark = dark;
|
|||
|
|
document.documentElement.setAttribute("data-theme", dark ? "dark" : "light");
|
|||
|
|
|
|||
|
|
const lightSheet = document.getElementById("hljs-light-theme");
|
|||
|
|
const darkSheet = document.getElementById("hljs-dark-theme");
|
|||
|
|
lightSheet.disabled = dark;
|
|||
|
|
darkSheet.disabled = !dark;
|
|||
|
|
|
|||
|
|
if (save) localStorage.setItem("sunvpy-theme", dark ? "dark" : "light");
|
|||
|
|
|
|||
|
|
// Re-render mermaid if already initialized
|
|||
|
|
if (mermaidInitialized && currentPage) {
|
|||
|
|
rerenderMermaid();
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// --- Sidebar ---
|
|||
|
|
function renderSidebar() {
|
|||
|
|
var html = "";
|
|||
|
|
navData.sections.forEach(function (section) {
|
|||
|
|
var isActive = currentPage && isSectionActive(section);
|
|||
|
|
html += '<div class="nav-section' + (isActive ? "" : " collapsed") + '" data-section="' + section.id + '">';
|
|||
|
|
html += '<div class="nav-section-header" onclick="toggleSection(this)">';
|
|||
|
|
html += '<svg class="chevron" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><polyline points="6 9 12 15 18 9"></polyline></svg>';
|
|||
|
|
html += escHtml(section.title);
|
|||
|
|
html += "</div>";
|
|||
|
|
html += '<div class="nav-section-body">';
|
|||
|
|
|
|||
|
|
if (section.pages) {
|
|||
|
|
section.pages.forEach(function (page) {
|
|||
|
|
html += renderPageLink(page);
|
|||
|
|
});
|
|||
|
|
}
|
|||
|
|
if (section.groups) {
|
|||
|
|
section.groups.forEach(function (group) {
|
|||
|
|
html += '<div class="nav-group">';
|
|||
|
|
html += '<div class="nav-group-label">' + escHtml(group.title) + "</div>";
|
|||
|
|
group.pages.forEach(function (page) {
|
|||
|
|
html += renderPageLink(page);
|
|||
|
|
});
|
|||
|
|
html += "</div>";
|
|||
|
|
});
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
html += "</div></div>";
|
|||
|
|
});
|
|||
|
|
sidebarNav.innerHTML = html;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
function renderPageLink(page) {
|
|||
|
|
var active = currentPage === page.slug ? " active" : "";
|
|||
|
|
var levelClass = page.level ? page.level.toLowerCase() : "";
|
|||
|
|
var badge = page.level ? ' <span class="level-badge ' + levelClass + '">' + escHtml(page.level.charAt(0)) + "</span>" : "";
|
|||
|
|
return '<a class="nav-page' + active + '" href="#' + page.slug + '">' + escHtml(page.title) + badge + "</a>";
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
function isSectionActive(section) {
|
|||
|
|
if (!currentPage) return false;
|
|||
|
|
if (section.pages) {
|
|||
|
|
for (var i = 0; i < section.pages.length; i++) {
|
|||
|
|
if (section.pages[i].slug === currentPage) return true;
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
if (section.groups) {
|
|||
|
|
for (var g = 0; g < section.groups.length; g++) {
|
|||
|
|
for (var j = 0; j < section.groups[g].pages.length; j++) {
|
|||
|
|
if (section.groups[g].pages[j].slug === currentPage) return true;
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
return false;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// Expose toggleSection globally for onclick
|
|||
|
|
window.toggleSection = function (header) {
|
|||
|
|
header.parentElement.classList.toggle("collapsed");
|
|||
|
|
};
|
|||
|
|
|
|||
|
|
// --- Routing ---
|
|||
|
|
function handleRoute() {
|
|||
|
|
var hash = window.location.hash.slice(1) || flatPages[0];
|
|||
|
|
if (!hash || hash === currentPage) return;
|
|||
|
|
loadPage(hash);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// --- Load & Render Page ---
|
|||
|
|
async function loadPage(slug) {
|
|||
|
|
currentPage = slug;
|
|||
|
|
|
|||
|
|
// Update sidebar active state
|
|||
|
|
renderSidebar();
|
|||
|
|
|
|||
|
|
// Scroll content to top
|
|||
|
|
contentEl.scrollTop = 0;
|
|||
|
|
|
|||
|
|
// Show loading
|
|||
|
|
article.innerHTML = '<div class="loading">加载中...</div>';
|
|||
|
|
tocNav.innerHTML = "";
|
|||
|
|
pageNav.innerHTML = "";
|
|||
|
|
|
|||
|
|
// Fetch markdown
|
|||
|
|
var md;
|
|||
|
|
try {
|
|||
|
|
var resp = await fetch("content/" + slug + ".md");
|
|||
|
|
if (!resp.ok) throw new Error(resp.status);
|
|||
|
|
md = await resp.text();
|
|||
|
|
} catch (e) {
|
|||
|
|
article.innerHTML = '<div class="loading">无法加载页面: ' + escHtml(slug) + "</div>";
|
|||
|
|
return;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// Pre-process: transform cross-doc links
|
|||
|
|
md = md.replace(/\]\((\d+-[\w-]+)\)/g, function (match, linkSlug) {
|
|||
|
|
// Only transform if it matches a known page slug
|
|||
|
|
if (flatPages.indexOf(linkSlug) !== -1) {
|
|||
|
|
return "](#" + linkSlug + ")";
|
|||
|
|
}
|
|||
|
|
return match;
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
// Configure marked
|
|||
|
|
var renderer = new marked.Renderer();
|
|||
|
|
|
|||
|
|
// Custom paragraph handler for "Sources:" lines
|
|||
|
|
renderer.paragraph = function (obj) {
|
|||
|
|
var text = typeof obj === "object" ? obj.text : obj;
|
|||
|
|
if (text && (text.indexOf("Sources:") === 0 || text.indexOf("Sources: [") === 0)) {
|
|||
|
|
return '<div class="source-ref">' + text + "</div>";
|
|||
|
|
}
|
|||
|
|
return "<p>" + text + "</p>";
|
|||
|
|
};
|
|||
|
|
|
|||
|
|
// Add IDs to headings
|
|||
|
|
var headingIndex = {};
|
|||
|
|
renderer.heading = function (text, depth) {
|
|||
|
|
// marked v15 passes heading data as object or text+depth
|
|||
|
|
var headingText = typeof text === "object" ? text.text : text;
|
|||
|
|
var headingDepth = typeof text === "object" ? text.depth : depth;
|
|||
|
|
var raw = headingText.replace(/<[^>]+>/g, "");
|
|||
|
|
var baseId = raw.toLowerCase()
|
|||
|
|
.replace(/[^\w\u4e00-\u9fff]+/g, "-")
|
|||
|
|
.replace(/^-|-$/g, "");
|
|||
|
|
if (!baseId) baseId = "heading";
|
|||
|
|
if (headingIndex[baseId] !== undefined) {
|
|||
|
|
headingIndex[baseId]++;
|
|||
|
|
baseId = baseId + "-" + headingIndex[baseId];
|
|||
|
|
} else {
|
|||
|
|
headingIndex[baseId] = 0;
|
|||
|
|
}
|
|||
|
|
return '<h' + headingDepth + ' id="' + escAttr(baseId) + '">' + headingText + "</h" + headingDepth + ">";
|
|||
|
|
};
|
|||
|
|
|
|||
|
|
// Code block handler
|
|||
|
|
renderer.code = function (obj) {
|
|||
|
|
var code, lang;
|
|||
|
|
if (typeof obj === "object") {
|
|||
|
|
code = obj.text;
|
|||
|
|
lang = obj.lang || "";
|
|||
|
|
} else {
|
|||
|
|
code = obj;
|
|||
|
|
lang = "";
|
|||
|
|
}
|
|||
|
|
if (lang === "mermaid") {
|
|||
|
|
return '<div class="mermaid-wrapper"><div class="mermaid" data-mermaid-source="' + escAttr(code) + '">' + escHtml(code) + "</div></div>";
|
|||
|
|
}
|
|||
|
|
var highlighted = "";
|
|||
|
|
try {
|
|||
|
|
if (lang && hljs.getLanguage(lang)) {
|
|||
|
|
highlighted = hljs.highlight(code, { language: lang }).value;
|
|||
|
|
} else {
|
|||
|
|
highlighted = hljs.highlightAuto(code).value;
|
|||
|
|
}
|
|||
|
|
} catch (e) {
|
|||
|
|
highlighted = escHtml(code);
|
|||
|
|
}
|
|||
|
|
var langLabel = lang ? '<span class="code-lang">' + escHtml(lang) + "</span>" : "";
|
|||
|
|
return "<pre>" + langLabel + '<code class="hljs language-' + escAttr(lang) + '">' + highlighted + "</code><button class=\"copy-btn\" onclick=\"copyCode(this)\">复制</button></pre>";
|
|||
|
|
};
|
|||
|
|
|
|||
|
|
marked.use({
|
|||
|
|
renderer: renderer,
|
|||
|
|
gfm: true,
|
|||
|
|
breaks: false,
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
// Render
|
|||
|
|
var html;
|
|||
|
|
try {
|
|||
|
|
html = marked.parse(md);
|
|||
|
|
} catch (e) {
|
|||
|
|
console.error("Markdown render error:", e);
|
|||
|
|
article.innerHTML = '<div class="loading">渲染出错: ' + escHtml(String(e)) + '</div>';
|
|||
|
|
return;
|
|||
|
|
}
|
|||
|
|
article.innerHTML = html;
|
|||
|
|
|
|||
|
|
// Add page title from nav data
|
|||
|
|
var pageInfo = findPageInfo(slug);
|
|||
|
|
if (pageInfo) {
|
|||
|
|
var titleDiv = document.createElement("div");
|
|||
|
|
titleDiv.className = "page-title";
|
|||
|
|
titleDiv.innerHTML = "<h1>" + escHtml(pageInfo.title) + "</h1>";
|
|||
|
|
if (pageInfo.section) {
|
|||
|
|
titleDiv.innerHTML += '<div class="page-meta">' + escHtml(pageInfo.section);
|
|||
|
|
if (pageInfo.level) titleDiv.innerHTML += ' · <span class="level-badge ' + pageInfo.level.toLowerCase() + '">' + escHtml(pageInfo.level) + "</span>";
|
|||
|
|
titleDiv.innerHTML += "</div>";
|
|||
|
|
}
|
|||
|
|
article.insertBefore(titleDiv, article.firstChild);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// Render mermaid diagrams
|
|||
|
|
await renderMermaid();
|
|||
|
|
|
|||
|
|
// Build TOC
|
|||
|
|
buildTOC();
|
|||
|
|
|
|||
|
|
// Prev/Next navigation
|
|||
|
|
renderPageNav();
|
|||
|
|
|
|||
|
|
// Update document title
|
|||
|
|
document.title = (pageInfo ? pageInfo.title + " — " : "") + "sunvpy 文档";
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// --- Mermaid ---
|
|||
|
|
async function renderMermaid() {
|
|||
|
|
var mermaidDivs = article.querySelectorAll(".mermaid");
|
|||
|
|
if (mermaidDivs.length === 0) return;
|
|||
|
|
|
|||
|
|
if (!mermaidInitialized) {
|
|||
|
|
mermaid.initialize({
|
|||
|
|
startOnLoad: false,
|
|||
|
|
theme: isDark ? "dark" : "default",
|
|||
|
|
securityLevel: "loose",
|
|||
|
|
maxTextSize: 90000,
|
|||
|
|
});
|
|||
|
|
mermaidInitialized = true;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
try {
|
|||
|
|
await mermaid.run({ nodes: mermaidDivs, suppressErrors: true });
|
|||
|
|
} catch (e) {
|
|||
|
|
console.warn("Mermaid render error:", e);
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
async function rerenderMermaid() {
|
|||
|
|
var wrappers = article.querySelectorAll(".mermaid-wrapper");
|
|||
|
|
wrappers.forEach(function (wrapper) {
|
|||
|
|
var div = wrapper.querySelector(".mermaid");
|
|||
|
|
if (!div) return;
|
|||
|
|
var source = div.getAttribute("data-mermaid-source");
|
|||
|
|
if (source) {
|
|||
|
|
div.removeAttribute("data-processed");
|
|||
|
|
div.innerHTML = escHtml(source);
|
|||
|
|
}
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
mermaid.initialize({
|
|||
|
|
startOnLoad: false,
|
|||
|
|
theme: isDark ? "dark" : "default",
|
|||
|
|
securityLevel: "loose",
|
|||
|
|
maxTextSize: 90000,
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
try {
|
|||
|
|
await mermaid.run({ nodes: article.querySelectorAll(".mermaid"), suppressErrors: true });
|
|||
|
|
} catch (e) {
|
|||
|
|
console.warn("Mermaid re-render error:", e);
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// --- TOC ---
|
|||
|
|
function buildTOC() {
|
|||
|
|
var headings = article.querySelectorAll("h2, h3");
|
|||
|
|
if (headings.length === 0) {
|
|||
|
|
tocNav.innerHTML = '<div style="color:var(--text-muted);font-size:0.82rem">无目录</div>';
|
|||
|
|
return;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
var html = "<ul>";
|
|||
|
|
headings.forEach(function (h) {
|
|||
|
|
var cls = h.tagName === "H3" ? "toc-h3" : "";
|
|||
|
|
html += '<li><a class="' + cls + '" href="#' + escAttr(h.id) + '">' + escHtml(h.textContent) + "</a></li>";
|
|||
|
|
});
|
|||
|
|
html += "</ul>";
|
|||
|
|
tocNav.innerHTML = html;
|
|||
|
|
|
|||
|
|
// Scroll spy
|
|||
|
|
setupScrollSpy(headings);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
function setupScrollSpy(headings) {
|
|||
|
|
var links = tocNav.querySelectorAll("a");
|
|||
|
|
|
|||
|
|
contentEl.removeEventListener("scroll", scrollSpyHandler);
|
|||
|
|
contentEl.addEventListener("scroll", scrollSpyHandler);
|
|||
|
|
|
|||
|
|
function scrollSpyHandler() {
|
|||
|
|
var scrollTop = contentEl.scrollTop;
|
|||
|
|
var activeIdx = 0;
|
|||
|
|
for (var i = headings.length - 1; i >= 0; i--) {
|
|||
|
|
if (headings[i].offsetTop - 100 <= scrollTop) {
|
|||
|
|
activeIdx = i;
|
|||
|
|
break;
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
links.forEach(function (link, idx) {
|
|||
|
|
link.classList.toggle("active", idx === activeIdx);
|
|||
|
|
});
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// --- Prev/Next ---
|
|||
|
|
function renderPageNav() {
|
|||
|
|
var idx = flatPages.indexOf(currentPage);
|
|||
|
|
if (idx === -1) { pageNav.innerHTML = ""; return; }
|
|||
|
|
|
|||
|
|
var html = "";
|
|||
|
|
if (idx > 0) {
|
|||
|
|
var prevInfo = findPageInfo(flatPages[idx - 1]);
|
|||
|
|
html += '<a class="page-nav-btn prev" href="#' + flatPages[idx - 1] + '">';
|
|||
|
|
html += '<span class="label">上一节</span>';
|
|||
|
|
html += '<span class="title">' + escHtml(prevInfo ? prevInfo.title : flatPages[idx - 1]) + "</span>";
|
|||
|
|
html += "</a>";
|
|||
|
|
} else {
|
|||
|
|
html += "<div></div>";
|
|||
|
|
}
|
|||
|
|
if (idx < flatPages.length - 1) {
|
|||
|
|
var nextInfo = findPageInfo(flatPages[idx + 1]);
|
|||
|
|
html += '<a class="page-nav-btn next" href="#' + flatPages[idx + 1] + '">';
|
|||
|
|
html += '<span class="label">下一节</span>';
|
|||
|
|
html += '<span class="title">' + escHtml(nextInfo ? nextInfo.title : flatPages[idx + 1]) + "</span>";
|
|||
|
|
html += "</a>";
|
|||
|
|
}
|
|||
|
|
pageNav.innerHTML = html;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// --- Helpers ---
|
|||
|
|
function findPageInfo(slug) {
|
|||
|
|
for (var s = 0; s < navData.sections.length; s++) {
|
|||
|
|
var section = navData.sections[s];
|
|||
|
|
if (section.pages) {
|
|||
|
|
for (var i = 0; i < section.pages.length; i++) {
|
|||
|
|
if (section.pages[i].slug === slug) {
|
|||
|
|
return Object.assign({}, section.pages[i], { section: section.title });
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
if (section.groups) {
|
|||
|
|
for (var g = 0; g < section.groups.length; g++) {
|
|||
|
|
for (var j = 0; j < section.groups[g].pages.length; j++) {
|
|||
|
|
if (section.groups[g].pages[j].slug === slug) {
|
|||
|
|
return Object.assign({}, section.groups[g].pages[j], { section: section.title });
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
return null;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
function escHtml(s) {
|
|||
|
|
if (!s) return "";
|
|||
|
|
return String(s).replace(/&/g, "&").replace(/</g, "<").replace(/>/g, ">").replace(/"/g, """);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
function escAttr(s) {
|
|||
|
|
return escHtml(s);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// Copy code to clipboard
|
|||
|
|
window.copyCode = function (btn) {
|
|||
|
|
var code = btn.parentElement.querySelector("code");
|
|||
|
|
var text = code.textContent;
|
|||
|
|
navigator.clipboard.writeText(text).then(function () {
|
|||
|
|
btn.textContent = "已复制";
|
|||
|
|
setTimeout(function () { btn.textContent = "复制"; }, 1500);
|
|||
|
|
});
|
|||
|
|
};
|
|||
|
|
|
|||
|
|
// --- Mobile sidebar ---
|
|||
|
|
function toggleMobileSidebar() {
|
|||
|
|
document.getElementById("sidebar").classList.toggle("open");
|
|||
|
|
document.getElementById("sidebarBackdrop").classList.toggle("open");
|
|||
|
|
}
|
|||
|
|
function closeMobileSidebar() {
|
|||
|
|
document.getElementById("sidebar").classList.remove("open");
|
|||
|
|
document.getElementById("sidebarBackdrop").classList.remove("open");
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// Close mobile sidebar on nav
|
|||
|
|
document.addEventListener("click", function (e) {
|
|||
|
|
if (e.target.classList.contains("nav-page")) {
|
|||
|
|
closeMobileSidebar();
|
|||
|
|
}
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
// --- Start ---
|
|||
|
|
init();
|
|||
|
|
})();
|