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') }; } // 加载文档列表 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; 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.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) { // 使用 DOM 缓存 if (!DOM.loading) DOM.loading = document.getElementById('loading'); if (!DOM.content) DOM.content = document.getElementById('markdown-content'); DOM.loading.style.display = 'flex'; DOM.content.innerHTML = ''; try { const response = await fetch(`/api/doc/${encodeURIComponent(currentCategory)}/${encodeURIComponent(docName)}`); if (!response.ok) { const errorData = await response.json().catch(() => ({})); throw new Error(errorData.error || `加载失败 (${response.status})`); } 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; // 处理图片路径,将相对路径转换为正确的URL DOM.content.querySelectorAll('img').forEach(img => { const src = img.getAttribute('src'); // 如果是相对路径(不以 http/https 开头) if (src && !src.startsWith('http://') && !src.startsWith('https://') && !src.startsWith('/')) { // 使用新的API路径,避免中文路径问题 const newSrc = `/api/image/${encodeURIComponent(currentCategory)}/${src}`; img.setAttribute('src', newSrc); // 添加错误处理 img.onerror = function() { console.error('Failed to load image:', newSrc); // 显示占位图片或错误提示 this.alt = `图片加载失败: ${src}`; this.classList.add('img-error'); }; } }); // 手动为所有代码块添加 hljs 类并确保高亮(修复 marked 高亮可能失败的问题) DOM.content.querySelectorAll('pre code').forEach((block) => { // 如果代码块没有 hljs 类,添加它 if (!block.classList.contains('hljs')) { block.classList.add('hljs'); } // 如果没有高亮的标记(没有 span 元素),尝试重新高亮 if (!block.querySelector('span')) { const lang = block.className.match(/language-(\w+)/)?.[1]; if (lang && hljs.getLanguage(lang)) { try { const highlighted = hljs.highlight(block.textContent, { language: lang }); block.innerHTML = highlighted.value; block.classList.add('hljs', `language-${lang}`); } catch (err) { console.error('Error re-highlighting:', err); } } else { // 尝试自动检测 try { const highlighted = hljs.highlightAuto(block.textContent); block.innerHTML = highlighted.value; block.classList.add('hljs'); if (highlighted.language) { block.classList.add(`language-${highlighted.language}`); } } catch (err) { console.error('Error auto-highlighting:', err); } } } }); // 为所有代码块添加复制按钮 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() { // 使用 DOM 缓存 if (!DOM.toc) DOM.toc = document.getElementById('toc'); // 确保 DOM.content 也被正确缓存 if (!DOM.content) DOM.content = document.getElementById('markdown-content'); // 先清空旧的TOC内容和事件监听器 DOM.toc.innerHTML = ''; DOM.toc.removeEventListener('click', handleTocClick); 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'; button.querySelector('.nav-doc-name').textContent = doc.name; 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) { const errorData = await response.json().catch(() => ({})); throw new Error(errorData.error || `搜索失败 (${response.status})`); } 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', () => { clearTimeout(searchTimeout); searchTimeout = setTimeout(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) { 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 = data.currentDoc.length > 0 ? 'block' : 'none'; DOM.otherDocResults.style.display = data.otherDocs.length > 0 ? 'block' : 'none'; // 渲染当前文档结果 if (data.currentDoc.length > 0) { data.currentDoc.forEach(doc => { const docResults = createDocResultElement(doc, true); currentDocSection.appendChild(docResults); }); } else { currentDocSection.innerHTML = '当前文档无匹配结果
'; } // 渲染其他文档结果 if (data.otherDocs.length > 0) { data.otherDocs.forEach(doc => { const docResults = createDocResultElement(doc, false); otherDocsSection.appendChild(docResults); }); } else if (data.currentDoc.length === 0) { otherDocsSection.innerHTML = '未找到匹配结果
'; } } // 创建搜索结果元素 function createDocResultElement(doc, isCurrent) { const container = document.createElement('div'); container.className = 'search-result-item'; const header = document.createElement('div'); header.className = 'result-header'; header.innerHTML = ` ${doc.docName} ${doc.matchCount} 个匹配 `; container.appendChild(header); // 添加匹配片段 doc.matches.forEach(match => { const matchItem = document.createElement('div'); matchItem.className = 'result-match'; // 高亮搜索词 const highlightedSnippet = highlightSearchTerm(match.snippet, DOM.searchInput ? DOM.searchInput.value : ''); matchItem.innerHTML = `