reader.js 35 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121
  1. let currentCategory = '';
  2. let currentDoc = '';
  3. let docList = [];
  4. let currentMarkdownContent = ''; // 保存当前文档的markdown源码
  5. let isEditMode = false; // 是否处于编辑模式
  6. let savedScrollPosition = 0; // 保存的滚动位置
  7. // DOM 元素缓存
  8. const DOM = {
  9. loading: null,
  10. content: null,
  11. docNav: null,
  12. toc: null,
  13. leftSidebar: null,
  14. rightSidebar: null,
  15. editBtn: null,
  16. editorContainer: null,
  17. markdownEditor: null,
  18. editorDocName: null,
  19. navPrev: null,
  20. navNext: null
  21. };
  22. // 配置 marked
  23. marked.setOptions({
  24. highlight: function(code, lang) {
  25. if (lang && hljs.getLanguage(lang)) {
  26. try {
  27. return hljs.highlight(code, { language: lang }).value;
  28. } catch (err) {
  29. console.error('Highlight error:', err);
  30. }
  31. }
  32. return hljs.highlightAuto(code).value;
  33. },
  34. breaks: true,
  35. gfm: true
  36. });
  37. // 从 URL 获取参数
  38. function getQueryParams() {
  39. const params = new URLSearchParams(window.location.search);
  40. return {
  41. category: params.get('category'),
  42. doc: params.get('doc')
  43. };
  44. }
  45. // 加载文档列表
  46. async function loadDocList() {
  47. const { category } = getQueryParams();
  48. if (!category) {
  49. window.location.href = '/';
  50. return;
  51. }
  52. currentCategory = category;
  53. const categoryNameSpan = document.querySelector('#category-title .category-name');
  54. if (categoryNameSpan) {
  55. categoryNameSpan.textContent = category;
  56. }
  57. try {
  58. const response = await fetch(`/api/category/${encodeURIComponent(category)}`);
  59. if (!response.ok) throw new Error('获取文档列表失败');
  60. const categoryData = await response.json();
  61. docList = categoryData.docs;
  62. renderDocNav(docList);
  63. // 加载第一篇文档(或 URL 指定的文档)
  64. const { doc } = getQueryParams();
  65. const firstDoc = doc || docList[0]?.name;
  66. if (firstDoc) {
  67. loadDocument(firstDoc);
  68. }
  69. } catch (err) {
  70. console.error('Error loading doc list:', err);
  71. showError('加载文档列表失败');
  72. }
  73. }
  74. // 渲染文档导航
  75. function renderDocNav(docs) {
  76. const nav = DOM.docNav || document.getElementById('doc-nav');
  77. if (!DOM.docNav) DOM.docNav = nav;
  78. nav.innerHTML = '';
  79. docs.forEach(doc => {
  80. const item = document.createElement('div');
  81. item.className = `nav-item level-${doc.level}`;
  82. item.dataset.docName = doc.name;
  83. const link = document.createElement('a');
  84. link.href = '#';
  85. link.className = 'nav-link';
  86. link.textContent = doc.name;
  87. item.appendChild(link);
  88. nav.appendChild(item);
  89. });
  90. // 使用事件委托 - 只添加一个监听器
  91. nav.removeEventListener('click', handleNavClick);
  92. nav.addEventListener('click', handleNavClick);
  93. }
  94. // 导航点击处理函数
  95. function handleNavClick(e) {
  96. if (e.target.classList.contains('nav-link')) {
  97. e.preventDefault();
  98. const item = e.target.parentElement;
  99. const docName = item.dataset.docName;
  100. if (docName) {
  101. loadDocument(docName);
  102. updateURL(currentCategory, docName);
  103. // 更新活动状态 - 使用缓存的查询结果
  104. const navItems = DOM.docNav.querySelectorAll('.nav-item');
  105. navItems.forEach(el => el.classList.toggle('active', el === item));
  106. }
  107. }
  108. }
  109. // 加载文档内容
  110. async function loadDocument(docName, scrollToText = null) {
  111. // 使用 DOM 缓存
  112. if (!DOM.loading) DOM.loading = document.getElementById('loading');
  113. if (!DOM.content) DOM.content = document.getElementById('markdown-content');
  114. DOM.loading.style.display = 'flex';
  115. DOM.content.innerHTML = '';
  116. try {
  117. const response = await fetch(`/api/doc/${encodeURIComponent(currentCategory)}/${encodeURIComponent(docName)}`);
  118. if (!response.ok) {
  119. const errorData = await response.json().catch(() => ({}));
  120. throw new Error(errorData.error || `加载失败 (${response.status})`);
  121. }
  122. const data = await response.json();
  123. // 验证数据有效性
  124. if (!data.content || typeof data.content !== 'string') {
  125. throw new Error('文档内容格式错误');
  126. }
  127. currentDoc = docName;
  128. currentMarkdownContent = data.content; // 保存markdown源码
  129. // 渲染 Markdown
  130. const html = marked.parse(data.content);
  131. DOM.content.innerHTML = html;
  132. // 生成 TOC
  133. generateTOC();
  134. // 更新文档导航(上一页/下一页)
  135. updateDocNavigation();
  136. // 更新活动文档 - 使用 toggle 优化
  137. if (DOM.docNav) {
  138. const navItems = DOM.docNav.querySelectorAll('.nav-item');
  139. navItems.forEach(el => el.classList.toggle('active', el.dataset.docName === docName));
  140. }
  141. DOM.loading.style.display = 'none';
  142. // 如果指定了要滚动到的文本,等待渲染完成后滚动
  143. if (scrollToText) {
  144. setTimeout(() => {
  145. scrollToSearchMatch(scrollToText);
  146. }, 100);
  147. }
  148. } catch (err) {
  149. console.error('Error loading document:', err);
  150. DOM.loading.style.display = 'none';
  151. showError(`加载文档失败:${err.message || '请稍后重试'}`);
  152. }
  153. }
  154. // 生成 TOC
  155. function generateTOC() {
  156. // 使用 DOM 缓存
  157. if (!DOM.toc) DOM.toc = document.getElementById('toc');
  158. const headings = DOM.content.querySelectorAll('h1, h2, h3, h4, h5, h6');
  159. DOM.toc.innerHTML = '';
  160. if (headings.length === 0) {
  161. DOM.toc.innerHTML = '<p class="toc-empty">本文档没有标题</p>';
  162. return;
  163. }
  164. // 创建标题 ID 映射
  165. const headingMap = new Map();
  166. headings.forEach((heading, index) => {
  167. // 给标题添加 ID
  168. if (!heading.id) {
  169. heading.id = `heading-${index}`;
  170. }
  171. const level = parseInt(heading.tagName.substring(1));
  172. const link = document.createElement('a');
  173. link.href = `#${heading.id}`;
  174. link.className = `toc-link toc-level-${level}`;
  175. link.textContent = heading.textContent;
  176. headingMap.set(heading.id, heading);
  177. DOM.toc.appendChild(link);
  178. });
  179. // 使用事件委托 - 只添加一个监听器
  180. DOM.toc.removeEventListener('click', handleTocClick);
  181. DOM.toc.addEventListener('click', (e) => handleTocClick(e, headingMap));
  182. // 监听滚动,高亮当前标题
  183. setupScrollSpy(headings);
  184. }
  185. // TOC 点击处理函数
  186. function handleTocClick(e, headingMap) {
  187. if (e.target.classList.contains('toc-link')) {
  188. e.preventDefault();
  189. const headingId = e.target.getAttribute('href').substring(1);
  190. const heading = headingMap.get(headingId);
  191. if (heading) {
  192. heading.scrollIntoView({ behavior: 'smooth', block: 'start' });
  193. // 更新活动状态
  194. const tocLinks = DOM.toc.querySelectorAll('.toc-link');
  195. tocLinks.forEach(el => el.classList.toggle('active', el === e.target));
  196. }
  197. }
  198. }
  199. // 滚动监听
  200. function setupScrollSpy(headings) {
  201. let activeLink = null;
  202. const observer = new IntersectionObserver((entries) => {
  203. entries.forEach(entry => {
  204. if (entry.isIntersecting) {
  205. const id = entry.target.id;
  206. const link = DOM.toc.querySelector(`.toc-link[href="#${id}"]`);
  207. if (link && link !== activeLink) {
  208. // 只在需要时更新,减少 DOM 操作
  209. if (activeLink) activeLink.classList.remove('active');
  210. link.classList.add('active');
  211. activeLink = link;
  212. }
  213. }
  214. });
  215. }, {
  216. rootMargin: '-100px 0px -80% 0px',
  217. threshold: 0
  218. });
  219. headings.forEach(heading => observer.observe(heading));
  220. }
  221. // 更新 URL
  222. function updateURL(category, doc) {
  223. const url = new URL(window.location);
  224. url.searchParams.set('category', category);
  225. url.searchParams.set('doc', doc);
  226. window.history.pushState({}, '', url);
  227. }
  228. // 更新文档导航(上一页/下一页)
  229. function updateDocNavigation() {
  230. // 缓存 DOM 元素
  231. if (!DOM.navPrev) DOM.navPrev = document.getElementById('nav-prev');
  232. if (!DOM.navNext) DOM.navNext = document.getElementById('nav-next');
  233. if (!DOM.navPrev || !DOM.navNext || docList.length === 0) return;
  234. const docNavigation = document.getElementById('doc-navigation');
  235. if (!docNavigation) return;
  236. // 找到当前文档在列表中的索引
  237. const currentIndex = docList.findIndex(doc => doc.name === currentDoc);
  238. if (currentIndex === -1) {
  239. DOM.navPrev.style.display = 'none';
  240. DOM.navNext.style.display = 'none';
  241. docNavigation.className = 'doc-navigation';
  242. return;
  243. }
  244. const hasPrev = currentIndex > 0;
  245. const hasNext = currentIndex < docList.length - 1;
  246. // 处理上一页
  247. if (hasPrev) {
  248. const prevDoc = docList[currentIndex - 1];
  249. DOM.navPrev.style.display = 'flex';
  250. DOM.navPrev.querySelector('.nav-doc-name').textContent = prevDoc.name;
  251. DOM.navPrev.onclick = () => {
  252. loadDocument(prevDoc.name);
  253. updateURL(currentCategory, prevDoc.name);
  254. // 滚动到顶部
  255. const contentArea = document.getElementById('content-area');
  256. if (contentArea) {
  257. contentArea.scrollTo({ top: 0, behavior: 'smooth' });
  258. }
  259. };
  260. } else {
  261. DOM.navPrev.style.display = 'none';
  262. }
  263. // 处理下一页
  264. if (hasNext) {
  265. const nextDoc = docList[currentIndex + 1];
  266. DOM.navNext.style.display = 'flex';
  267. DOM.navNext.querySelector('.nav-doc-name').textContent = nextDoc.name;
  268. DOM.navNext.onclick = () => {
  269. loadDocument(nextDoc.name);
  270. updateURL(currentCategory, nextDoc.name);
  271. // 滚动到顶部
  272. const contentArea = document.getElementById('content-area');
  273. if (contentArea) {
  274. contentArea.scrollTo({ top: 0, behavior: 'smooth' });
  275. }
  276. };
  277. } else {
  278. DOM.navNext.style.display = 'none';
  279. }
  280. // 根据导航按钮状态添加类,用于CSS定位
  281. if (hasPrev && hasNext) {
  282. docNavigation.className = 'doc-navigation has-both';
  283. } else if (hasPrev) {
  284. docNavigation.className = 'doc-navigation has-prev-only';
  285. } else if (hasNext) {
  286. docNavigation.className = 'doc-navigation has-next-only';
  287. } else {
  288. docNavigation.className = 'doc-navigation';
  289. }
  290. }
  291. // 显示错误
  292. function showError(message) {
  293. const content = document.getElementById('markdown-content');
  294. content.innerHTML = `<div class="error-message">${message}</div>`;
  295. }
  296. // 切换侧边栏(移动端)
  297. function setupSidebarToggles() {
  298. const toggleLeft = document.getElementById('toggle-left');
  299. const toggleRight = document.getElementById('toggle-right');
  300. // 使用 DOM 缓存
  301. if (!DOM.leftSidebar) DOM.leftSidebar = document.getElementById('left-sidebar');
  302. if (!DOM.rightSidebar) DOM.rightSidebar = document.getElementById('right-sidebar');
  303. // 移动端/平板初始化:默认折叠侧边栏
  304. if (window.innerWidth <= 768) {
  305. DOM.leftSidebar.classList.add('collapsed');
  306. DOM.rightSidebar.classList.add('collapsed');
  307. } else if (window.innerWidth <= 1024) {
  308. // 平板:只折叠右侧栏
  309. DOM.rightSidebar.classList.add('collapsed');
  310. }
  311. // 监听窗口大小变化
  312. window.addEventListener('resize', () => {
  313. if (window.innerWidth <= 768) {
  314. // 移动端:确保左右侧边栏都折叠
  315. if (!DOM.leftSidebar.classList.contains('collapsed')) {
  316. DOM.leftSidebar.classList.add('collapsed');
  317. }
  318. if (!DOM.rightSidebar.classList.contains('collapsed')) {
  319. DOM.rightSidebar.classList.add('collapsed');
  320. }
  321. } else if (window.innerWidth <= 1024) {
  322. // 平板:只折叠右侧栏,展开左侧栏
  323. DOM.leftSidebar.classList.remove('collapsed');
  324. if (!DOM.rightSidebar.classList.contains('collapsed')) {
  325. DOM.rightSidebar.classList.add('collapsed');
  326. }
  327. } else {
  328. // 桌面端:展开所有侧边栏
  329. DOM.leftSidebar.classList.remove('collapsed');
  330. DOM.rightSidebar.classList.remove('collapsed');
  331. }
  332. });
  333. toggleLeft.onclick = (e) => {
  334. e.stopPropagation();
  335. // 如果右侧栏展开,先隐藏它
  336. if (!DOM.rightSidebar.classList.contains('collapsed')) {
  337. DOM.rightSidebar.classList.add('collapsed');
  338. }
  339. DOM.leftSidebar.classList.toggle('collapsed');
  340. };
  341. toggleRight.onclick = (e) => {
  342. e.stopPropagation();
  343. // 如果左侧栏展开,先隐藏它
  344. if (!DOM.leftSidebar.classList.contains('collapsed')) {
  345. DOM.leftSidebar.classList.add('collapsed');
  346. }
  347. DOM.rightSidebar.classList.toggle('collapsed');
  348. };
  349. // 点击侧边栏外部时隐藏所有已展开的侧边栏(仅在移动端和平板)
  350. document.addEventListener('click', (e) => {
  351. // 仅在移动端和平板上启用此功能
  352. if (window.innerWidth > 1024) return;
  353. const isClickInsideLeftSidebar = DOM.leftSidebar.contains(e.target);
  354. const isClickInsideRightSidebar = DOM.rightSidebar.contains(e.target);
  355. const isToggleButton = e.target.closest('#toggle-left') || e.target.closest('#toggle-right');
  356. // 如果点击的不是侧边栏内部,也不是切换按钮,则隐藏所有展开的侧边栏
  357. if (!isClickInsideLeftSidebar && !isClickInsideRightSidebar && !isToggleButton) {
  358. if (!DOM.leftSidebar.classList.contains('collapsed')) {
  359. DOM.leftSidebar.classList.add('collapsed');
  360. }
  361. if (!DOM.rightSidebar.classList.contains('collapsed')) {
  362. DOM.rightSidebar.classList.add('collapsed');
  363. }
  364. }
  365. });
  366. }
  367. // 搜索功能
  368. function initSearch() {
  369. const searchContainer = document.getElementById('search-container');
  370. const searchToggleBtn = document.getElementById('search-toggle-btn');
  371. const searchInput = document.getElementById('search-input');
  372. const searchBtn = document.getElementById('search-btn');
  373. const searchResults = document.getElementById('search-results');
  374. const closeSearchBoxBtn = document.getElementById('close-search-box');
  375. // 检查元素是否存在
  376. if (!searchContainer || !searchToggleBtn || !searchInput || !searchBtn || !searchResults || !closeSearchBoxBtn) {
  377. console.error('Search elements not found:', {
  378. searchContainer: !!searchContainer,
  379. searchToggleBtn: !!searchToggleBtn,
  380. searchInput: !!searchInput,
  381. searchBtn: !!searchBtn,
  382. searchResults: !!searchResults,
  383. closeSearchBoxBtn: !!closeSearchBoxBtn
  384. });
  385. return;
  386. }
  387. let searchTimeout;
  388. const SEARCH_HISTORY_KEY = 'cjydocs_search_history';
  389. // 保存搜索历史到localStorage
  390. const saveSearchHistory = (query) => {
  391. if (!query || query.trim().length < 2) return;
  392. try {
  393. let history = JSON.parse(localStorage.getItem(SEARCH_HISTORY_KEY) || '{}');
  394. history[currentCategory] = query;
  395. localStorage.setItem(SEARCH_HISTORY_KEY, JSON.stringify(history));
  396. } catch (err) {
  397. console.error('Failed to save search history:', err);
  398. }
  399. };
  400. // 搜索函数
  401. const performSearch = async () => {
  402. const query = searchInput.value.trim();
  403. if (query.length < 2) {
  404. searchResults.style.display = 'none';
  405. return;
  406. }
  407. // 保存搜索历史
  408. saveSearchHistory(query);
  409. try {
  410. const response = await fetch(
  411. `/api/search/${encodeURIComponent(currentCategory)}?q=${encodeURIComponent(query)}&currentDoc=${encodeURIComponent(currentDoc)}`
  412. );
  413. if (!response.ok) {
  414. const errorData = await response.json().catch(() => ({}));
  415. throw new Error(errorData.error || `搜索失败 (${response.status})`);
  416. }
  417. const data = await response.json();
  418. displaySearchResults(data);
  419. searchResults.style.display = 'block';
  420. } catch (err) {
  421. console.error('Search error:', err);
  422. // 向用户显示错误信息
  423. displaySearchError(err.message || '搜索失败,请稍后重试');
  424. }
  425. };
  426. // 加载搜索历史
  427. const loadSearchHistory = () => {
  428. try {
  429. const history = JSON.parse(localStorage.getItem(SEARCH_HISTORY_KEY) || '{}');
  430. const lastQuery = history[currentCategory];
  431. if (lastQuery) {
  432. searchInput.value = lastQuery;
  433. // 自动搜索上次的内容
  434. performSearch();
  435. }
  436. } catch (err) {
  437. console.error('Failed to load search history:', err);
  438. }
  439. };
  440. // 清除其他分类的搜索历史
  441. const clearOtherCategoryHistory = () => {
  442. try {
  443. let history = JSON.parse(localStorage.getItem(SEARCH_HISTORY_KEY) || '{}');
  444. // 只保留当前分类
  445. history = { [currentCategory]: history[currentCategory] || '' };
  446. localStorage.setItem(SEARCH_HISTORY_KEY, JSON.stringify(history));
  447. } catch (err) {
  448. console.error('Failed to clear search history:', err);
  449. }
  450. };
  451. // 切换搜索框显示/隐藏
  452. searchToggleBtn.addEventListener('click', (e) => {
  453. e.stopPropagation();
  454. console.log('Search button clicked');
  455. const isActive = searchContainer.classList.toggle('active');
  456. console.log('Search container active:', isActive);
  457. if (isActive) {
  458. // 加载搜索历史
  459. loadSearchHistory();
  460. // 聚焦到搜索框
  461. setTimeout(() => searchInput.focus(), 100);
  462. } else {
  463. // 隐藏搜索结果
  464. searchResults.style.display = 'none';
  465. }
  466. });
  467. // 输入时实时搜索(防抖) - 500ms 减少 API 调用
  468. searchInput.addEventListener('input', () => {
  469. clearTimeout(searchTimeout);
  470. searchTimeout = setTimeout(performSearch, 500);
  471. });
  472. // 点击搜索按钮
  473. searchBtn.addEventListener('click', performSearch);
  474. // 按回车搜索
  475. searchInput.addEventListener('keypress', (e) => {
  476. if (e.key === 'Enter') {
  477. performSearch();
  478. }
  479. });
  480. // 关闭搜索框按钮
  481. closeSearchBoxBtn.addEventListener('click', (e) => {
  482. e.stopPropagation();
  483. searchContainer.classList.remove('active');
  484. searchResults.style.display = 'none';
  485. });
  486. // 点击搜索结果外部关闭
  487. searchResults.addEventListener('click', (e) => {
  488. // 如果点击的是搜索结果容器本身(即遮罩背景),关闭搜索
  489. if (e.target === searchResults) {
  490. searchResults.style.display = 'none';
  491. }
  492. });
  493. // 点击外部关闭
  494. document.addEventListener('click', (e) => {
  495. const searchToggle = document.getElementById('search-toggle-btn');
  496. if (!searchResults.contains(e.target) &&
  497. !searchInput.contains(e.target) &&
  498. !searchBtn.contains(e.target) &&
  499. !searchContainer.contains(e.target) &&
  500. !searchToggle.contains(e.target)) {
  501. searchResults.style.display = 'none';
  502. }
  503. });
  504. // 初始化时清除其他分类的历史
  505. clearOtherCategoryHistory();
  506. }
  507. // 显示搜索错误
  508. function displaySearchError(message) {
  509. const currentDocSection = document.querySelector('#current-doc-results .results-list');
  510. const otherDocsSection = document.querySelector('#other-docs-results .results-list');
  511. const searchResults = document.getElementById('search-results');
  512. // 清空之前的结果
  513. currentDocSection.innerHTML = '';
  514. otherDocsSection.innerHTML = '';
  515. // 隐藏分组标题
  516. document.getElementById('current-doc-results').style.display = 'none';
  517. document.getElementById('other-docs-results').style.display = 'none';
  518. // 显示错误信息
  519. currentDocSection.innerHTML = `<p class="search-error" style="color: #d73a49; padding: 20px; text-align: center;">${message}</p>`;
  520. document.getElementById('current-doc-results').style.display = 'block';
  521. // 显示搜索结果面板
  522. searchResults.style.display = 'block';
  523. }
  524. // 显示搜索结果
  525. function displaySearchResults(data) {
  526. const currentDocSection = document.querySelector('#current-doc-results .results-list');
  527. const otherDocsSection = document.querySelector('#other-docs-results .results-list');
  528. // 清空之前的结果
  529. currentDocSection.innerHTML = '';
  530. otherDocsSection.innerHTML = '';
  531. // 隐藏/显示分组标题
  532. document.getElementById('current-doc-results').style.display =
  533. data.currentDoc.length > 0 ? 'block' : 'none';
  534. document.getElementById('other-docs-results').style.display =
  535. data.otherDocs.length > 0 ? 'block' : 'none';
  536. // 渲染当前文档结果
  537. if (data.currentDoc.length > 0) {
  538. data.currentDoc.forEach(doc => {
  539. const docResults = createDocResultElement(doc, true);
  540. currentDocSection.appendChild(docResults);
  541. });
  542. } else {
  543. currentDocSection.innerHTML = '<p class="no-results">当前文档无匹配结果</p>';
  544. }
  545. // 渲染其他文档结果
  546. if (data.otherDocs.length > 0) {
  547. data.otherDocs.forEach(doc => {
  548. const docResults = createDocResultElement(doc, false);
  549. otherDocsSection.appendChild(docResults);
  550. });
  551. } else if (data.currentDoc.length === 0) {
  552. otherDocsSection.innerHTML = '<p class="no-results">未找到匹配结果</p>';
  553. }
  554. }
  555. // 创建搜索结果元素
  556. function createDocResultElement(doc, isCurrent) {
  557. const container = document.createElement('div');
  558. container.className = 'search-result-item';
  559. const header = document.createElement('div');
  560. header.className = 'result-header';
  561. header.innerHTML = `
  562. <span class="result-doc-name">${doc.docName}</span>
  563. <span class="result-count">${doc.matchCount} 个匹配</span>
  564. `;
  565. container.appendChild(header);
  566. // 添加匹配片段
  567. doc.matches.forEach(match => {
  568. const matchItem = document.createElement('div');
  569. matchItem.className = 'result-match';
  570. // 高亮搜索词
  571. const highlightedSnippet = highlightSearchTerm(match.snippet, document.getElementById('search-input').value);
  572. matchItem.innerHTML = `
  573. <div class="match-line-number">行 ${match.line}</div>
  574. <div class="match-snippet">${highlightedSnippet}</div>
  575. `;
  576. // 点击跳转
  577. matchItem.onclick = () => {
  578. // 隐藏搜索框和搜索结果
  579. const searchContainer = document.querySelector('.search-container');
  580. const searchResults = document.getElementById('search-results');
  581. searchContainer.classList.remove('active');
  582. searchResults.style.display = 'none';
  583. // 在移动端和平板上关闭所有侧边栏,确保用户能看到跳转后的内容
  584. if (window.innerWidth <= 1024) {
  585. if (DOM.leftSidebar && !DOM.leftSidebar.classList.contains('collapsed')) {
  586. DOM.leftSidebar.classList.add('collapsed');
  587. }
  588. if (DOM.rightSidebar && !DOM.rightSidebar.classList.contains('collapsed')) {
  589. DOM.rightSidebar.classList.add('collapsed');
  590. }
  591. }
  592. if (isCurrent) {
  593. // 当前文档,滚动到对应位置
  594. scrollToSearchMatch(match.fullLine);
  595. } else {
  596. // 其他文档,加载该文档并跳转到具体位置
  597. loadDocument(doc.docName, match.fullLine);
  598. }
  599. };
  600. container.appendChild(matchItem);
  601. });
  602. return container;
  603. }
  604. // 高亮搜索词
  605. function highlightSearchTerm(text, searchTerm) {
  606. const regex = new RegExp(`(${searchTerm})`, 'gi');
  607. return text.replace(regex, '<mark class="search-highlight">$1</mark>');
  608. }
  609. // 滚动到搜索匹配位置
  610. function scrollToSearchMatch(fullLine) {
  611. const content = document.getElementById('markdown-content');
  612. const searchText = fullLine.trim();
  613. if (!searchText) return;
  614. // 使用TreeWalker遍历所有文本节点
  615. const walker = document.createTreeWalker(
  616. content,
  617. NodeFilter.SHOW_TEXT,
  618. null
  619. );
  620. let found = false;
  621. let node;
  622. while (node = walker.nextNode()) {
  623. if (node.textContent.includes(searchText)) {
  624. const parentElement = node.parentElement;
  625. // 滚动到元素
  626. parentElement.scrollIntoView({ behavior: 'smooth', block: 'center' });
  627. // 临时高亮父元素
  628. parentElement.classList.add('temp-highlight');
  629. setTimeout(() => {
  630. parentElement.classList.remove('temp-highlight');
  631. }, 2000);
  632. found = true;
  633. break;
  634. }
  635. }
  636. // 如果没有找到精确匹配,尝试部分匹配
  637. if (!found) {
  638. const elements = content.querySelectorAll('p, li, td, th, h1, h2, h3, h4, h5, h6, blockquote, pre, code');
  639. for (const element of elements) {
  640. const text = element.textContent.trim();
  641. // 尝试匹配至少50%的内容
  642. if (text.length > 10 && searchText.includes(text.substring(0, Math.min(text.length, 50)))) {
  643. element.scrollIntoView({ behavior: 'smooth', block: 'center' });
  644. // 临时高亮
  645. element.classList.add('temp-highlight');
  646. setTimeout(() => {
  647. element.classList.remove('temp-highlight');
  648. }, 2000);
  649. break;
  650. }
  651. }
  652. }
  653. }
  654. // 设置回到顶部按钮
  655. function setupBackToTop() {
  656. const backToTopBtn = document.getElementById('back-to-top');
  657. if (!backToTopBtn) return;
  658. // 初始状态:隐藏按钮
  659. backToTopBtn.classList.add('hidden');
  660. // 点击按钮滚动到顶部
  661. backToTopBtn.addEventListener('click', (e) => {
  662. e.preventDefault();
  663. e.stopPropagation();
  664. // 滚动到顶部
  665. window.scrollTo({
  666. top: 0,
  667. behavior: 'smooth'
  668. });
  669. });
  670. // 监听窗口滚动事件,根据滚动位置控制按钮显示/隐藏
  671. let scrollTimeout;
  672. const handleScroll = () => {
  673. clearTimeout(scrollTimeout);
  674. scrollTimeout = setTimeout(() => {
  675. const scrollTop = window.pageYOffset || document.documentElement.scrollTop;
  676. // 滚动超过 300px 时显示按钮
  677. if (scrollTop > 300) {
  678. backToTopBtn.classList.remove('hidden');
  679. } else {
  680. backToTopBtn.classList.add('hidden');
  681. }
  682. }, 100);
  683. };
  684. window.addEventListener('scroll', handleScroll);
  685. }
  686. // 编辑功能
  687. function setupEditFeature() {
  688. // 缓存DOM元素
  689. if (!DOM.editBtn) DOM.editBtn = document.getElementById('edit-btn');
  690. if (!DOM.editorContainer) DOM.editorContainer = document.getElementById('editor-container');
  691. if (!DOM.markdownEditor) DOM.markdownEditor = document.getElementById('markdown-editor');
  692. if (!DOM.editorDocName) DOM.editorDocName = document.getElementById('editor-doc-name');
  693. const saveBtn = document.getElementById('save-btn');
  694. const cancelBtn = document.getElementById('cancel-edit-btn');
  695. const contentArea = document.getElementById('content-area');
  696. // 编辑按钮点击事件 - 切换编辑/查看模式
  697. DOM.editBtn.addEventListener('click', () => {
  698. if (isEditMode) {
  699. exitEditMode();
  700. } else {
  701. enterEditMode();
  702. }
  703. });
  704. // 取消编辑
  705. cancelBtn.addEventListener('click', () => {
  706. exitEditMode();
  707. });
  708. // 保存按钮
  709. saveBtn.addEventListener('click', async () => {
  710. await saveDocument();
  711. });
  712. }
  713. // 进入编辑模式
  714. function enterEditMode() {
  715. if (!currentDoc || !currentMarkdownContent) {
  716. alert('请先加载一个文档');
  717. return;
  718. }
  719. isEditMode = true;
  720. // 更新编辑按钮状态
  721. DOM.editBtn.classList.add('active');
  722. DOM.editBtn.title = '退出编辑';
  723. // 保存当前滚动位置
  724. const contentArea = document.getElementById('content-area');
  725. savedScrollPosition = contentArea.scrollTop;
  726. // 找到当前视口中心附近的元素
  727. const visibleElement = findVisibleElement();
  728. // 隐藏渲染的内容
  729. if (!DOM.content) DOM.content = document.getElementById('markdown-content');
  730. DOM.content.style.display = 'none';
  731. // 显示编辑器
  732. DOM.editorContainer.style.display = 'flex';
  733. DOM.editorDocName.textContent = `${currentDoc}.md`;
  734. DOM.markdownEditor.value = currentMarkdownContent;
  735. // 定位光标到对应位置
  736. setTimeout(() => {
  737. if (visibleElement) {
  738. positionCursorByElement(visibleElement);
  739. } else {
  740. // 如果找不到元素,使用滚动比例
  741. const scrollRatio = savedScrollPosition / contentArea.scrollHeight;
  742. DOM.markdownEditor.scrollTop = DOM.markdownEditor.scrollHeight * scrollRatio;
  743. }
  744. DOM.markdownEditor.focus();
  745. }, 50);
  746. }
  747. // 找到当前视口中可见的元素
  748. function findVisibleElement() {
  749. const contentArea = document.getElementById('content-area');
  750. const viewportTop = contentArea.scrollTop;
  751. const viewportMiddle = viewportTop + contentArea.clientHeight / 3; // 视口上方1/3处
  752. // 查找所有重要元素(标题、段落等)
  753. const elements = DOM.content.querySelectorAll('h1, h2, h3, h4, h5, h6, p, li, blockquote, pre');
  754. let closestElement = null;
  755. let minDistance = Infinity;
  756. elements.forEach(el => {
  757. const rect = el.getBoundingClientRect();
  758. const elementTop = el.offsetTop;
  759. const distance = Math.abs(elementTop - viewportMiddle);
  760. if (distance < minDistance && elementTop <= viewportMiddle + 200) {
  761. minDistance = distance;
  762. closestElement = el;
  763. }
  764. });
  765. return closestElement;
  766. }
  767. // 根据元素定位光标
  768. function positionCursorByElement(element) {
  769. const elementText = element.textContent.trim();
  770. if (!elementText) {
  771. return;
  772. }
  773. // 获取元素标签类型
  774. const tagName = element.tagName.toLowerCase();
  775. let searchText = elementText;
  776. // 如果是标题,添加markdown标记进行搜索
  777. if (tagName.match(/^h[1-6]$/)) {
  778. const level = parseInt(tagName[1]);
  779. const hashes = '#'.repeat(level);
  780. // 尝试匹配标题行
  781. const lines = currentMarkdownContent.split('\n');
  782. let targetLine = -1;
  783. for (let i = 0; i < lines.length; i++) {
  784. const line = lines[i].trim();
  785. // 匹配 "# 标题" 格式
  786. if (line.startsWith(hashes + ' ') && line.substring(level + 1).trim() === elementText) {
  787. targetLine = i;
  788. break;
  789. }
  790. }
  791. if (targetLine !== -1) {
  792. setEditorCursorToLine(targetLine);
  793. return;
  794. }
  795. }
  796. // 对于其他元素,搜索文本内容
  797. const lines = currentMarkdownContent.split('\n');
  798. for (let i = 0; i < lines.length; i++) {
  799. const line = lines[i].trim();
  800. // 移除markdown标记进行比较
  801. const cleanLine = line.replace(/^[#\-*>]+\s*/, '').trim();
  802. if (cleanLine.includes(elementText.substring(0, Math.min(50, elementText.length)))) {
  803. setEditorCursorToLine(i);
  804. return;
  805. }
  806. }
  807. }
  808. // 设置编辑器光标到指定行
  809. function setEditorCursorToLine(lineNumber) {
  810. const lines = currentMarkdownContent.split('\n');
  811. // 计算目标位置的字符索引
  812. let charPosition = 0;
  813. for (let i = 0; i < lineNumber && i < lines.length; i++) {
  814. charPosition += lines[i].length + 1; // +1 for newline
  815. }
  816. // 设置光标位置
  817. DOM.markdownEditor.setSelectionRange(charPosition, charPosition);
  818. // 滚动到光标位置
  819. const linesBeforeCursor = lineNumber;
  820. const lineHeight = 22; // 大约的行高(px)
  821. const targetScrollTop = linesBeforeCursor * lineHeight - DOM.markdownEditor.clientHeight / 3;
  822. DOM.markdownEditor.scrollTop = Math.max(0, targetScrollTop);
  823. }
  824. // 退出编辑模式
  825. function exitEditMode() {
  826. isEditMode = false;
  827. // 更新编辑按钮状态
  828. DOM.editBtn.classList.remove('active');
  829. DOM.editBtn.title = '编辑文档';
  830. // 隐藏编辑器
  831. DOM.editorContainer.style.display = 'none';
  832. // 显示渲染的内容
  833. DOM.content.style.display = 'block';
  834. // 恢复滚动位置
  835. const contentArea = document.getElementById('content-area');
  836. setTimeout(() => {
  837. contentArea.scrollTop = savedScrollPosition;
  838. }, 0);
  839. }
  840. // 保存文档
  841. async function saveDocument() {
  842. const newContent = DOM.markdownEditor.value;
  843. if (!currentCategory || !currentDoc) {
  844. alert('无法保存:缺少文档信息');
  845. return;
  846. }
  847. // 禁用保存按钮,防止重复点击
  848. const saveBtn = document.getElementById('save-btn');
  849. saveBtn.disabled = true;
  850. saveBtn.textContent = '保存中...';
  851. try {
  852. const response = await fetch(`/api/doc/${encodeURIComponent(currentCategory)}/${encodeURIComponent(currentDoc)}`, {
  853. method: 'PUT',
  854. headers: {
  855. 'Content-Type': 'application/json'
  856. },
  857. body: JSON.stringify({
  858. content: newContent
  859. })
  860. });
  861. if (!response.ok) {
  862. const errorData = await response.json().catch(() => ({}));
  863. throw new Error(errorData.error || `保存失败 (${response.status})`);
  864. }
  865. const result = await response.json();
  866. // 更新本地的markdown内容
  867. currentMarkdownContent = newContent;
  868. // 重新渲染内容
  869. const html = marked.parse(newContent);
  870. DOM.content.innerHTML = html;
  871. // 重新生成TOC
  872. generateTOC();
  873. // 退出编辑模式
  874. exitEditMode();
  875. // 显示成功提示
  876. showSuccessMessage('保存成功!');
  877. } catch (error) {
  878. console.error('Save error:', error);
  879. alert(`保存失败:${error.message || '请稍后重试'}`);
  880. } finally {
  881. // 恢复保存按钮
  882. saveBtn.disabled = false;
  883. saveBtn.textContent = '保存';
  884. }
  885. }
  886. // 显示成功提示
  887. function showSuccessMessage(message) {
  888. const toast = document.createElement('div');
  889. toast.className = 'success-toast';
  890. toast.textContent = message;
  891. toast.style.cssText = `
  892. position: fixed;
  893. top: 20px;
  894. right: 20px;
  895. background: #28a745;
  896. color: white;
  897. padding: 12px 24px;
  898. border-radius: 6px;
  899. box-shadow: 0 4px 12px rgba(0, 0, 0, 0.15);
  900. z-index: 10000;
  901. animation: slideInRight 0.3s ease-out;
  902. `;
  903. document.body.appendChild(toast);
  904. setTimeout(() => {
  905. toast.style.animation = 'slideOutRight 0.3s ease-out';
  906. setTimeout(() => {
  907. document.body.removeChild(toast);
  908. }, 300);
  909. }, 2000);
  910. }
  911. // 初始化
  912. document.addEventListener('DOMContentLoaded', () => {
  913. loadDocList();
  914. setupSidebarToggles();
  915. initSearch();
  916. setupBackToTop();
  917. setupEditFeature();
  918. });
  919. // 处理浏览器后退/前进
  920. window.addEventListener('popstate', () => {
  921. const { doc } = getQueryParams();
  922. if (doc) {
  923. loadDocument(doc);
  924. }
  925. });