let currentCategory = ''; let currentDoc = ''; let docList = []; let currentMarkdownContent = ''; // 保存当前文档的markdown源码 let isEditMode = false; // 是否处于编辑模式 let savedScrollPosition = 0; // 保存的滚动位置 let currentScrollObserver = null; // 保存当前的滚动监听器 // DOM 元素缓存 const DOM = { loading: null, content: null, docNav: null, toc: null, leftSidebar: null, rightSidebar: null, editBtn: null, editorContainer: null, markdownEditor: null, editorDocName: null, navPrev: null, navNext: null, contentArea: null, searchContainer: null, searchToggleBtn: null, searchInput: null, searchBtn: null, searchResults: null, closeSearchBoxBtn: null, saveBtn: null, cancelBtn: null, backToTopBtn: null, docNavigation: null, toggleLeft: null, toggleRight: null, categoryNameSpan: null, currentDocResults: null, otherDocResults: null }; // 配置 marked marked.setOptions({ highlight: function(code, lang) { if (lang && hljs.getLanguage(lang)) { try { const result = hljs.highlight(code, { language: lang }); return result.value; } catch (err) { console.error('Highlight error:', err); } } // 自动检测语言 const autoResult = hljs.highlightAuto(code); return autoResult.value; }, breaks: true, gfm: true }); // 从 URL 获取参数 function getQueryParams() { const params = new URLSearchParams(window.location.search); return { category: params.get('category'), doc: params.get('doc') }; } // 根据文档路径获取展示名称(仅保留最后一段) function getDocDisplayName(docName) { if (!docName || typeof docName !== 'string') { return ''; } const segments = docName.split(/[\\\/]/); const name = segments.pop(); return name || docName; } // ========== 工具函数 ========== // URL 编码路径(支持子目录) function encodeDocPath(docName) { return docName.split('/').map(part => encodeURIComponent(part)).join('/'); } // API 错误处理 async function handleApiError(response, defaultMessage) { const errorData = await response.json().catch(() => ({})); throw new Error(errorData.error || `${defaultMessage} (${response.status})`); } // 确保 DOM 元素已缓存 function ensureDOM(key, id) { if (!DOM[key]) DOM[key] = document.getElementById(id); return DOM[key]; } // 通用防抖函数 function debounce(func, wait) { let timeout; return function executedFunction(...args) { clearTimeout(timeout); timeout = setTimeout(() => func.apply(this, args), wait); }; } // 高亮代码块 function highlightCodeBlock(block) { block.classList.add('hljs'); // 如果已经高亮过了,跳过 if (block.querySelector('span')) return; const lang = block.className.match(/language-(\w+)/)?.[1]; try { const highlighted = (lang && hljs.getLanguage(lang)) ? hljs.highlight(block.textContent, { language: lang }) : hljs.highlightAuto(block.textContent); block.innerHTML = highlighted.value; if (highlighted.language) { block.classList.add(`language-${highlighted.language}`); } } catch (err) { console.error('Error highlighting code:', err); } } // 加载文档列表 async function loadDocList() { const { category } = getQueryParams(); if (!category) { window.location.href = '/'; return; } currentCategory = category; if (!DOM.categoryNameSpan) DOM.categoryNameSpan = document.querySelector('#category-title .category-name'); if (DOM.categoryNameSpan) { DOM.categoryNameSpan.textContent = category; } try { const response = await fetch(`/api/category/${encodeURIComponent(category)}`); if (!response.ok) throw new Error('获取文档列表失败'); const categoryData = await response.json(); docList = categoryData.docs.map(doc => ({ ...doc, displayName: getDocDisplayName(doc.name) })); renderDocNav(docList); // 加载第一篇文档(或 URL 指定的文档) const { doc } = getQueryParams(); const firstDoc = doc || docList[0]?.name; if (firstDoc) { loadDocument(firstDoc); } } catch (err) { console.error('Error loading doc list:', err); showError('加载文档列表失败'); } } // 渲染文档导航 function renderDocNav(docs) { const nav = DOM.docNav || document.getElementById('doc-nav'); if (!DOM.docNav) DOM.docNav = nav; nav.innerHTML = ''; docs.forEach(doc => { const item = document.createElement('div'); item.className = `nav-item level-${doc.level}`; item.dataset.docName = doc.name; const link = document.createElement('a'); link.href = '#'; link.className = 'nav-link'; link.textContent = doc.displayName || getDocDisplayName(doc.name); link.title = doc.name; item.appendChild(link); nav.appendChild(item); }); // 使用事件委托 - 只添加一个监听器 nav.removeEventListener('click', handleNavClick); nav.addEventListener('click', handleNavClick); } // 导航点击处理函数 function handleNavClick(e) { if (e.target.classList.contains('nav-link')) { e.preventDefault(); const item = e.target.parentElement; const docName = item.dataset.docName; if (docName) { loadDocument(docName); updateURL(currentCategory, docName); // 更新活动状态 - 使用缓存的查询结果 const navItems = DOM.docNav.querySelectorAll('.nav-item'); navItems.forEach(el => el.classList.toggle('active', el === item)); } } } // 加载文档内容 async function loadDocument(docName, scrollToText = null) { ensureDOM('loading', 'loading'); ensureDOM('content', 'markdown-content'); DOM.loading.style.display = 'flex'; DOM.content.innerHTML = ''; try { const encodedDocName = encodeDocPath(docName); const response = await fetch(`/api/doc/${encodeURIComponent(currentCategory)}/${encodedDocName}`); if (!response.ok) { await handleApiError(response, '加载失败'); } const data = await response.json(); // 验证数据有效性 if (!data.content || typeof data.content !== 'string') { throw new Error('文档内容格式错误'); } currentDoc = docName; currentMarkdownContent = data.content; // 保存markdown源码 // 渲染 Markdown const html = marked.parse(data.content); DOM.content.innerHTML = html; // 处理图片路径(将相对路径转换为API路径) DOM.content.querySelectorAll('img').forEach(img => { const src = img.getAttribute('src'); if (src && !src.match(/^https?:\/\//)) { img.setAttribute('data-original-src', src); img.src = `/api/image/${encodeURIComponent(currentCategory)}/${src}`; } }); // 代码块高亮 DOM.content.querySelectorAll('pre code').forEach(highlightCodeBlock); // 为所有代码块添加复制按钮 addCopyButtonsToCodeBlocks(); // 生成 TOC generateTOC(); // 更新文档导航(上一页/下一页) updateDocNavigation(); // 更新活动文档 - 使用 toggle 优化 if (DOM.docNav) { const navItems = DOM.docNav.querySelectorAll('.nav-item'); navItems.forEach(el => el.classList.toggle('active', el.dataset.docName === docName)); } DOM.loading.style.display = 'none'; // 如果指定了要滚动到的文本,等待渲染完成后滚动 if (scrollToText) { setTimeout(() => { scrollToSearchMatch(scrollToText); }, 100); } } catch (err) { console.error('Error loading document:', err); DOM.loading.style.display = 'none'; showError(`加载文档失败:${err.message || '请稍后重试'}`); } } // 生成 TOC function generateTOC() { ensureDOM('toc', 'toc'); ensureDOM('content', 'markdown-content'); // 先清空旧的TOC内容 DOM.toc.innerHTML = ''; const headings = DOM.content.querySelectorAll('h1, h2, h3, h4, h5, h6'); if (headings.length === 0) { DOM.toc.innerHTML = '
本文档没有标题
'; return; } // 创建标题 ID 映射 const headingMap = new Map(); headings.forEach((heading, index) => { // 给标题添加 ID if (!heading.id) { heading.id = `heading-${index}`; } const level = parseInt(heading.tagName.substring(1)); const link = document.createElement('a'); link.href = `#${heading.id}`; link.className = `toc-link toc-level-${level}`; link.textContent = heading.textContent; headingMap.set(heading.id, heading); DOM.toc.appendChild(link); }); // 使用事件委托 - 只添加一个监听器 DOM.toc.removeEventListener('click', handleTocClick); DOM.toc.addEventListener('click', (e) => handleTocClick(e, headingMap)); // 监听滚动,高亮当前标题 setupScrollSpy(headings); } // TOC 点击处理函数 function handleTocClick(e, headingMap) { if (e.target.classList.contains('toc-link')) { e.preventDefault(); const headingId = e.target.getAttribute('href').substring(1); const heading = headingMap.get(headingId); if (heading) { heading.scrollIntoView({ behavior: 'smooth', block: 'start' }); // 更新活动状态 const tocLinks = DOM.toc.querySelectorAll('.toc-link'); tocLinks.forEach(el => el.classList.toggle('active', el === e.target)); } } } // 滚动监听 function setupScrollSpy(headings) { // 清理之前的 observer if (currentScrollObserver) { currentScrollObserver.disconnect(); currentScrollObserver = null; } // 如果没有标题,直接返回 if (!headings || headings.length === 0) { return; } let activeLink = null; const observer = new IntersectionObserver((entries) => { entries.forEach(entry => { if (entry.isIntersecting) { const id = entry.target.id; const link = DOM.toc.querySelector(`.toc-link[href="#${id}"]`); if (link && link !== activeLink) { // 只在需要时更新,减少 DOM 操作 if (activeLink) activeLink.classList.remove('active'); link.classList.add('active'); activeLink = link; } } }); }, { rootMargin: '-100px 0px -80% 0px', threshold: 0 }); headings.forEach(heading => observer.observe(heading)); // 保存当前的 observer 以便后续清理 currentScrollObserver = observer; } // 更新 URL function updateURL(category, doc) { const url = new URL(window.location); url.searchParams.set('category', category); url.searchParams.set('doc', doc); window.history.pushState({}, '', url); } // 更新文档导航(上一页/下一页) function updateDocNavigation() { // 缓存 DOM 元素 if (!DOM.navPrev) DOM.navPrev = document.getElementById('nav-prev'); if (!DOM.navNext) DOM.navNext = document.getElementById('nav-next'); if (!DOM.navPrev || !DOM.navNext || docList.length === 0) return; if (!DOM.docNavigation) DOM.docNavigation = document.getElementById('doc-navigation'); if (!DOM.docNavigation) return; // 找到当前文档在列表中的索引 const currentIndex = docList.findIndex(doc => doc.name === currentDoc); if (currentIndex === -1) { DOM.navPrev.style.display = 'none'; DOM.navNext.style.display = 'none'; DOM.docNavigation.className = 'doc-navigation'; return; } const hasPrev = currentIndex > 0; const hasNext = currentIndex < docList.length - 1; // 辅助函数:设置导航按钮 const setupNavButton = (button, doc) => { if (doc) { button.style.display = 'flex'; const displayName = doc.displayName || getDocDisplayName(doc.name); button.querySelector('.nav-doc-name').textContent = displayName; button.onclick = () => { loadDocument(doc.name); updateURL(currentCategory, doc.name); // 滚动到顶部 if (!DOM.contentArea) DOM.contentArea = document.getElementById('content-area'); if (DOM.contentArea) { DOM.contentArea.scrollTo({ top: 0, behavior: 'smooth' }); } }; } else { button.style.display = 'none'; } }; // 设置上一页和下一页按钮 setupNavButton(DOM.navPrev, hasPrev ? docList[currentIndex - 1] : null); setupNavButton(DOM.navNext, hasNext ? docList[currentIndex + 1] : null); // 根据导航按钮状态添加类,用于CSS定位 if (hasPrev && hasNext) { DOM.docNavigation.className = 'doc-navigation has-both'; } else if (hasPrev) { DOM.docNavigation.className = 'doc-navigation has-prev-only'; } else if (hasNext) { DOM.docNavigation.className = 'doc-navigation has-next-only'; } else { DOM.docNavigation.className = 'doc-navigation'; } } // 显示错误 function showError(message) { if (!DOM.content) DOM.content = document.getElementById('markdown-content'); if (DOM.content) { DOM.content.innerHTML = ``; } } // 切换侧边栏(移动端) function setupSidebarToggles() { if (!DOM.toggleLeft) DOM.toggleLeft = document.getElementById('toggle-left'); if (!DOM.toggleRight) DOM.toggleRight = document.getElementById('toggle-right'); const toggleLeft = DOM.toggleLeft; const toggleRight = DOM.toggleRight; // 使用 DOM 缓存 if (!DOM.leftSidebar) DOM.leftSidebar = document.getElementById('left-sidebar'); if (!DOM.rightSidebar) DOM.rightSidebar = document.getElementById('right-sidebar'); // 移动端/平板初始化:默认折叠侧边栏 if (window.innerWidth <= 768) { DOM.leftSidebar.classList.add('collapsed'); DOM.rightSidebar.classList.add('collapsed'); } else if (window.innerWidth <= 1024) { // 平板:只折叠右侧栏 DOM.rightSidebar.classList.add('collapsed'); } // 监听窗口大小变化 window.addEventListener('resize', () => { if (window.innerWidth <= 768) { // 移动端:确保左右侧边栏都折叠 if (!DOM.leftSidebar.classList.contains('collapsed')) { DOM.leftSidebar.classList.add('collapsed'); } if (!DOM.rightSidebar.classList.contains('collapsed')) { DOM.rightSidebar.classList.add('collapsed'); } } else if (window.innerWidth <= 1024) { // 平板:只折叠右侧栏,展开左侧栏 DOM.leftSidebar.classList.remove('collapsed'); if (!DOM.rightSidebar.classList.contains('collapsed')) { DOM.rightSidebar.classList.add('collapsed'); } } else { // 桌面端:展开所有侧边栏 DOM.leftSidebar.classList.remove('collapsed'); DOM.rightSidebar.classList.remove('collapsed'); } }); toggleLeft.onclick = (e) => { e.stopPropagation(); // 如果右侧栏展开,先隐藏它 if (!DOM.rightSidebar.classList.contains('collapsed')) { DOM.rightSidebar.classList.add('collapsed'); } DOM.leftSidebar.classList.toggle('collapsed'); }; toggleRight.onclick = (e) => { e.stopPropagation(); // 如果左侧栏展开,先隐藏它 if (!DOM.leftSidebar.classList.contains('collapsed')) { DOM.leftSidebar.classList.add('collapsed'); } DOM.rightSidebar.classList.toggle('collapsed'); }; // 点击侧边栏外部时隐藏所有已展开的侧边栏(仅在移动端和平板) document.addEventListener('click', (e) => { // 仅在移动端和平板上启用此功能 if (window.innerWidth > 1024) return; const isClickInsideLeftSidebar = DOM.leftSidebar.contains(e.target); const isClickInsideRightSidebar = DOM.rightSidebar.contains(e.target); const isToggleButton = e.target.closest('#toggle-left') || e.target.closest('#toggle-right'); // 如果点击的不是侧边栏内部,也不是切换按钮,则隐藏所有展开的侧边栏 if (!isClickInsideLeftSidebar && !isClickInsideRightSidebar && !isToggleButton) { if (!DOM.leftSidebar.classList.contains('collapsed')) { DOM.leftSidebar.classList.add('collapsed'); } if (!DOM.rightSidebar.classList.contains('collapsed')) { DOM.rightSidebar.classList.add('collapsed'); } } }); } // 搜索功能 function initSearch() { // 初始化搜索相关的DOM缓存 if (!DOM.searchContainer) DOM.searchContainer = document.getElementById('search-container'); if (!DOM.searchToggleBtn) DOM.searchToggleBtn = document.getElementById('search-toggle-btn'); if (!DOM.searchInput) DOM.searchInput = document.getElementById('search-input'); if (!DOM.searchBtn) DOM.searchBtn = document.getElementById('search-btn'); if (!DOM.searchResults) DOM.searchResults = document.getElementById('search-results'); if (!DOM.closeSearchBoxBtn) DOM.closeSearchBoxBtn = document.getElementById('close-search-box'); // 检查元素是否存在 if (!DOM.searchContainer || !DOM.searchToggleBtn || !DOM.searchInput || !DOM.searchBtn || !DOM.searchResults || !DOM.closeSearchBoxBtn) { console.error('Search elements not found:', { searchContainer: !!DOM.searchContainer, searchToggleBtn: !!DOM.searchToggleBtn, searchInput: !!DOM.searchInput, searchBtn: !!DOM.searchBtn, searchResults: !!DOM.searchResults, closeSearchBoxBtn: !!DOM.closeSearchBoxBtn }); return; } const searchContainer = DOM.searchContainer; const searchToggleBtn = DOM.searchToggleBtn; const searchInput = DOM.searchInput; const searchBtn = DOM.searchBtn; const searchResults = DOM.searchResults; const closeSearchBoxBtn = DOM.closeSearchBoxBtn; let searchTimeout; const SEARCH_HISTORY_KEY = 'cjydocs_search_history'; // 保存搜索历史到localStorage const saveSearchHistory = (query) => { if (!query || query.trim().length < 2) return; try { let history = JSON.parse(localStorage.getItem(SEARCH_HISTORY_KEY) || '{}'); history[currentCategory] = query; localStorage.setItem(SEARCH_HISTORY_KEY, JSON.stringify(history)); } catch (err) { console.error('Failed to save search history:', err); } }; // 搜索函数 const performSearch = async () => { const query = searchInput.value.trim(); if (query.length < 2) { searchResults.style.display = 'none'; return; } // 保存搜索历史 saveSearchHistory(query); try { const response = await fetch( `/api/search/${encodeURIComponent(currentCategory)}?q=${encodeURIComponent(query)}¤tDoc=${encodeURIComponent(currentDoc)}` ); if (!response.ok) { await handleApiError(response, '搜索失败'); } const data = await response.json(); displaySearchResults(data); searchResults.style.display = 'block'; } catch (err) { console.error('Search error:', err); displaySearchError(err.message || '搜索失败,请稍后重试'); } }; // 加载搜索历史 const loadSearchHistory = () => { try { const history = JSON.parse(localStorage.getItem(SEARCH_HISTORY_KEY) || '{}'); const lastQuery = history[currentCategory]; if (lastQuery) { searchInput.value = lastQuery; // 自动搜索上次的内容 performSearch(); } } catch (err) { console.error('Failed to load search history:', err); } }; // 清除其他分类的搜索历史 const clearOtherCategoryHistory = () => { try { let history = JSON.parse(localStorage.getItem(SEARCH_HISTORY_KEY) || '{}'); // 只保留当前分类 history = { [currentCategory]: history[currentCategory] || '' }; localStorage.setItem(SEARCH_HISTORY_KEY, JSON.stringify(history)); } catch (err) { console.error('Failed to clear search history:', err); } }; // 切换搜索框显示/隐藏 searchToggleBtn.addEventListener('click', (e) => { e.stopPropagation(); const isActive = searchContainer.classList.toggle('active'); if (isActive) { // 加载搜索历史 loadSearchHistory(); // 聚焦到搜索框 setTimeout(() => searchInput.focus(), 100); } else { // 隐藏搜索结果 searchResults.style.display = 'none'; } }); // 输入时实时搜索(防抖) - 500ms 减少 API 调用 searchInput.addEventListener('input', debounce(performSearch, 500)); // 点击搜索按钮 searchBtn.addEventListener('click', performSearch); // 按回车搜索 searchInput.addEventListener('keypress', (e) => { if (e.key === 'Enter') { performSearch(); } }); // 关闭搜索框按钮 closeSearchBoxBtn.addEventListener('click', (e) => { e.stopPropagation(); searchContainer.classList.remove('active'); searchResults.style.display = 'none'; }); // 点击搜索结果外部关闭 searchResults.addEventListener('click', (e) => { // 如果点击的是搜索结果容器本身(即遮罩背景),关闭搜索 if (e.target === searchResults) { searchResults.style.display = 'none'; } }); // 点击外部关闭 document.addEventListener('click', (e) => { if (!searchResults.contains(e.target) && !searchInput.contains(e.target) && !searchBtn.contains(e.target) && !searchContainer.contains(e.target) && !searchToggleBtn.contains(e.target)) { searchResults.style.display = 'none'; } }); // 初始化时清除其他分类的历史 clearOtherCategoryHistory(); } // 显示搜索错误 function displaySearchError(message) { if (!DOM.currentDocResults) DOM.currentDocResults = document.getElementById('current-doc-results'); if (!DOM.otherDocResults) DOM.otherDocResults = document.getElementById('other-docs-results'); const currentDocSection = DOM.currentDocResults ? DOM.currentDocResults.querySelector('.results-list') : null; const otherDocsSection = DOM.otherDocResults ? DOM.otherDocResults.querySelector('.results-list') : null; // 清空之前的结果 currentDocSection.innerHTML = ''; otherDocsSection.innerHTML = ''; // 隐藏分组标题 DOM.currentDocResults.style.display = 'none'; DOM.otherDocResults.style.display = 'none'; // 显示错误信息 if (currentDocSection) { currentDocSection.innerHTML = `${message}
`; } DOM.currentDocResults.style.display = 'block'; // 显示搜索结果面板 if (DOM.searchResults) { DOM.searchResults.style.display = 'block'; } } // 显示搜索结果 function displaySearchResults(data) { // 获取搜索结果内容容器 const searchResultsContent = document.querySelector('.search-results-content'); // 检查是否完全没有结果 const hasNoResults = data.currentDoc.length === 0 && data.otherDocs.length === 0; if (hasNoResults) { // 完全没有搜索结果时,显示友好的空状态 // 先清空内容区 searchResultsContent.innerHTML = ''; // 创建空状态容器 const emptyState = document.createElement('div'); emptyState.className = 'empty-search-state'; emptyState.innerHTML = `试试其他关键词,或者检查拼写是否正确
`; searchResultsContent.appendChild(emptyState); return; } // 有搜索结果时,需要恢复正常的DOM结构 // 先检查是否需要重建结构(从空状态恢复) let currentDocResults = document.getElementById('current-doc-results'); let otherDocResults = document.getElementById('other-docs-results'); // 如果结构不存在(被空状态替换了),重新创建 if (!currentDocResults || !otherDocResults) { searchResultsContent.innerHTML = `