172 lines
7.2 KiB
JavaScript
172 lines
7.2 KiB
JavaScript
/* ═══════════ 文档页逻辑（docs.html） ═══════════
|
||
hash 路由（#01-quick-start 可直链某篇）+ fetch content/*.md + marked 前端渲染。
|
||
文档为站点自有的可信 markdown，无需注入消毒。
|
||
多语言：与主页同一 localStorage（astrion_site_locale）；英文版在 content/en/ 同文件名，
|
||
缺失时回退中文；目录末尾附语言切换按钮（桌面端目录底部 / 移动端 chips 条尾部）。 */
|
||
(function () {
|
||
'use strict';
|
||
|
||
/* 文档页自己掌控滚动：禁用浏览器滚动恢复。否则刷新时浏览器恢复到上次滚动位置，
|
||
若上次停在 topbar 高度附近，fixed 顶栏会遮住 h1 上半截（实测实踩）；
|
||
切篇/刷新统一回顶，行为可预期。 */
|
||
if ('scrollRestoration' in history) history.scrollRestoration = 'manual';
|
||
|
||
/* 目录标题与 md 一级标题语义一致（08/09 目录用简称，正文原标题保留）；
|
||
titleEn 为英文目录标题 */
|
||
var DOCS = [
|
||
{ id: '01-quick-start', title: '快速上手', titleEn: 'Quick Start', file: '01-quick-start.md' },
|
||
{ id: '02-core-concepts', title: '核心概念', titleEn: 'Core Concepts', file: '02-core-concepts.md' },
|
||
{ id: '03-conversations', title: '对话', titleEn: 'Conversations', file: '03-conversations.md' },
|
||
{ id: '04-input-context', title: '输入与上下文', titleEn: 'Input & Context', file: '04-input-context.md' },
|
||
{ id: '05-execution-security', title: '执行与安全', titleEn: 'Execution & Security', file: '05-execution-security.md' },
|
||
{ id: '06-conversation-assets', title: '对话资产管理', titleEn: 'Conversation Assets', file: '06-conversation-assets.md' },
|
||
{ id: '07-agent-capabilities', title: '智能体能力', titleEn: 'Agent Capabilities', file: '07-agent-capabilities.md' },
|
||
{ id: '08-quick-dock', title: '快捷窗口', titleEn: 'Quick Dock', file: '08-quick-dock.md' },
|
||
{ id: '09-settings', title: '个人空间设置', titleEn: 'Personal Space Settings', file: '09-settings.md' },
|
||
{ id: '10-cli', title: 'CLI（开发中）', titleEn: 'CLI (In Development)', file: '10-cli.md' }
|
||
];
|
||
|
||
var DICT = window.SITE_I18N || {};
|
||
var navEl = document.getElementById('docsNav');
|
||
var contentEl = document.getElementById('docsContent');
|
||
var currentId = null;
|
||
var loadSeq = 0; /* 防快速切换时旧响应覆盖新内容 */
|
||
|
||
/* 与主页 site.js 同款检测：localStorage 优先 → 浏览器语言（zh 开头中文，否则英文） */
|
||
function detectLocale() {
|
||
try {
|
||
var stored = localStorage.getItem('astrion_site_locale');
|
||
if (stored === 'zh-CN' || stored === 'en-US') return stored;
|
||
} catch (e) {}
|
||
var nav = (navigator.language || '').toLowerCase();
|
||
return nav.indexOf('zh') === 0 ? 'zh-CN' : 'en-US';
|
||
}
|
||
var locale = detectLocale();
|
||
|
||
function tr(key) {
|
||
var d = DICT[locale] || {};
|
||
return d[key] != null ? d[key] : key;
|
||
}
|
||
|
||
/* 顶栏/侧栏等静态 [data-i18n] / [data-i18n-aria] 文案替换 + 页面 title */
|
||
function applyStaticI18n() {
|
||
var d = DICT[locale];
|
||
if (!d) return;
|
||
document.documentElement.setAttribute('lang', locale);
|
||
var i, k, nodes;
|
||
nodes = document.querySelectorAll('[data-i18n]');
|
||
for (i = 0; i < nodes.length; i++) {
|
||
k = nodes[i].getAttribute('data-i18n');
|
||
if (d[k] != null) nodes[i].textContent = d[k];
|
||
}
|
||
nodes = document.querySelectorAll('[data-i18n-aria]');
|
||
for (i = 0; i < nodes.length; i++) {
|
||
k = nodes[i].getAttribute('data-i18n-aria');
|
||
if (d[k] != null) nodes[i].setAttribute('aria-label', d[k]);
|
||
}
|
||
document.title = tr('docs.pageTitle');
|
||
}
|
||
|
||
/* 建左侧目录（末尾附语言切换按钮；切语言时整体重建） */
|
||
function buildNav() {
|
||
navEl.innerHTML = '';
|
||
DOCS.forEach(function (doc) {
|
||
var a = document.createElement('a');
|
||
a.href = '#' + doc.id;
|
||
a.textContent = locale === 'en-US' ? doc.titleEn : doc.title;
|
||
a.dataset.docId = doc.id;
|
||
navEl.appendChild(a);
|
||
});
|
||
var langBtn = document.createElement('button');
|
||
langBtn.type = 'button';
|
||
langBtn.className = 'docs-lang-toggle';
|
||
langBtn.textContent = locale === 'zh-CN' ? 'English' : '中文';
|
||
langBtn.setAttribute('aria-label', locale === 'zh-CN' ? 'Switch to English' : '切换为中文');
|
||
langBtn.addEventListener('click', function () {
|
||
locale = locale === 'zh-CN' ? 'en-US' : 'zh-CN';
|
||
try { localStorage.setItem('astrion_site_locale', locale); } catch (e) {}
|
||
applyStaticI18n();
|
||
buildNav();
|
||
renderNav();
|
||
if (currentId) loadDoc(currentId);
|
||
});
|
||
navEl.appendChild(langBtn);
|
||
}
|
||
|
||
function docById(id) {
|
||
for (var i = 0; i < DOCS.length; i++) if (DOCS[i].id === id) return DOCS[i];
|
||
return null;
|
||
}
|
||
|
||
/* hash → doc id；不匹配时：尚未加载过 → 默认第一篇；已加载 → 返回 null 忽略
|
||
（可能是渲染内容里的锚点 hash，不应触发切篇） */
|
||
function docIdFromHash() {
|
||
var h = (location.hash || '').replace(/^#\/?/, '');
|
||
if (docById(h)) return h;
|
||
return currentId === null ? DOCS[0].id : null;
|
||
}
|
||
|
||
function renderNav() {
|
||
var links = navEl.querySelectorAll('a');
|
||
for (var i = 0; i < links.length; i++) {
|
||
links[i].classList.toggle('active', links[i].dataset.docId === currentId);
|
||
}
|
||
}
|
||
|
||
function postProcess() {
|
||
/* 外部链接新标签打开；内容区内的站外相对链接（如指向主仓库文件）在官网无意义，原样保留 */
|
||
var links = contentEl.querySelectorAll('a[href^="http"]');
|
||
for (var i = 0; i < links.length; i++) {
|
||
links[i].setAttribute('target', '_blank');
|
||
links[i].setAttribute('rel', 'noopener');
|
||
}
|
||
}
|
||
|
||
function loadDoc(id) {
|
||
var doc = docById(id);
|
||
if (!doc) return;
|
||
currentId = id;
|
||
renderNav();
|
||
var seq = ++loadSeq;
|
||
contentEl.innerHTML = '<p class="docs-loading">' + tr('docs.loading') + '</p>';
|
||
var path = (locale === 'en-US' ? 'content/en/' : 'content/') + doc.file;
|
||
fetch(path)
|
||
.then(function (res) {
|
||
if (!res.ok && locale === 'en-US') {
|
||
/* 英文版缺失时回退中文（保底：单篇未翻译不至于空白） */
|
||
return fetch('content/' + doc.file).then(function (r2) {
|
||
if (!r2.ok) throw new Error('HTTP ' + r2.status);
|
||
return r2.text();
|
||
});
|
||
}
|
||
if (!res.ok) throw new Error('HTTP ' + res.status);
|
||
return res.text();
|
||
})
|
||
.then(function (md) {
|
||
if (seq !== loadSeq) return; /* 期间已切到别的篇目 */
|
||
contentEl.innerHTML = marked.parse(md);
|
||
postProcess();
|
||
window.scrollTo(0, 0);
|
||
})
|
||
.catch(function (err) {
|
||
if (seq !== loadSeq) return;
|
||
contentEl.innerHTML = '<p class="docs-error">' +
|
||
tr('docs.loadFailedTpl').replace('{err}', String(err)) + '</p>';
|
||
});
|
||
}
|
||
|
||
window.addEventListener('hashchange', function () {
|
||
var id = docIdFromHash();
|
||
if (id && id !== currentId) loadDoc(id);
|
||
});
|
||
|
||
applyStaticI18n();
|
||
buildNav();
|
||
var first = docIdFromHash();
|
||
if (location.hash !== '#' + first) {
|
||
/* 把默认篇目写进地址栏，刷新/分享行为一致 */
|
||
history.replaceState(null, '', '#' + first);
|
||
}
|
||
loadDoc(first);
|
||
})();
|