fix: 修复文档多处问题 & feat: 新增相关文档推荐功能 #86

Open
wqer wants to merge 92 commits from z2_cc/gitlink_help_center:master into master
First-time contributor

包含帮助中心文档 bug 修复和新功能实现

包含帮助中心文档 bug 修复和新功能实现
wqer added 58 commits 2026-05-13 15:03:35 +08:00
93068dc829 fix: 修复文档多处问题
- 代码提交.md: 复制粘贴错误修复
- 分支管理.md: 错别字修复
- 成员管理.md: 章节标题重复修复
- 提交第一行代码.md: 标题层级修复
- 维基页面管理.md, 模板导入及导出.md: 图片语法修复
- 平台公告.md: 补充空白页面
- 建站工具.md: 统一图片路径
1cee9b1599 feat: 新增相关文档推荐功能及修复版本化文档图片路径
- 新增 RelatedDocuments 组件,在文档底部展示同分类下的相关文档链接
- 通过 Docusaurus theme swizzle 将组件注入到 DocItem/Footer
- 修复 versioned_docs 中建站工具.md 的图片路径

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
e38aaa81d6 更新Dockerfile镜像源并完善.gitignore规则
Dockerfile切换为ustc镜像源,去除多余空格;
.gitignore新增忽略.claude/目录和Office临时文件
272f28e237 feat: 添加文档反馈、回到顶部按钮和公告横幅功能
- 文档底部新增「有帮助/没帮助」反馈区域,localStorage 防重复投票
- 页面右下角新增回到顶部悬浮按钮,滚动超300px淡入,品牌蓝设计
- 顶部新增公告横幅,由 static/announcement.json 驱动,关闭后不再显示
ffeeac639e fix: 清理约 12MB 模板残留图片
- 删除 static/images/ 整个目录(BoxyHQ/Retraced 模板图片约 11.5MB)
- 删除 static/img/ 中的 Docusaurus 模板图片约 524KB
- 删除 reposyncer 目录中重复的 .png 版本文件约 832KB

Closes #142195
1064582310 fix: 移除未使用的依赖
移除 or、react-modal、docusaurus-gtm-plugin、@docusaurus/plugin-client-redirects

Closes #142202
d3859b8022 fix: 修复 intro.md 中个人主页建站卡片链接
将 /个人主页建站/建站流程 改为 /个人主页建站/站点创建流程

Closes #142203
7c850d72a6 fix: 修正 robots.txt 中 sitemap 指向 GitLink 域名
将 sitemap 从 boxyhq.com 改为 help.gitlink.org.cn

Closes #142204
z2_cc added 12 commits 2026-05-13 15:05:07 +08:00
d28b46c86f feat: add build-time doc index generator
Created scripts/generate-doc-index.js that:
- Scans all .md files under docs/
- Extracts titles, breadcrumbs, and URLs
- Strips Markdown syntax and tokenizes content with jieba
- Outputs structured index to static/doc-index.json

Also added static/doc-index.json to .gitignore
391a83a11d fix: fix Chinese token filter regex for BM25 search
\W in regex matches Chinese characters, causing all Chinese tokens
to be filtered out. Replaced with \p{P} (Unicode punctuation) to
correctly preserve Chinese tokens while filtering punctuation.
e724a74f46 feat: add DEEPSEEK_API_KEY to pipeline and include design docs
- Pass DEEPSEEK_API_KEY env var in docker run command
- Add design spec and implementation plan
liuyan688 added 1 commit 2026-05-13 15:07:53 +08:00
liuyan688 added 1 commit 2026-05-13 15:14:06 +08:00
ecc30f5994 feat: 文档反馈增加改进建议输入框
点击"没帮助"后弹出输入框,用户可输入改进建议并提交
z2_cc added 1 commit 2026-05-13 15:28:14 +08:00
e5f7b9e3d9 fix: use env-file for DEEPSEEK_API_KEY in pipeline
Pipeline secret interpolation doesn't work inside string values.
Use --env-file on the server instead.
wqer added 1 commit 2026-05-13 15:30:17 +08:00
3b8f8603a4 feat: 增强相关文档推荐功能,增加分类导航与文档计数
- 新增同分类"上一篇/下一篇"导航,便于顺序阅读
- 显示当前分类名称及文档计数
- 卡片增加编号标识
- 首页等根级页面自动隐藏模块

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
wqer added 1 commit 2026-05-13 15:42:40 +08:00
3f976b15df feat: 增强相关文档为跨分类智能推荐
- 新增关键词提取引擎,从文档标题提取2-gram中文关键词
- 跨分类推荐:在其他分类中搜索主题相关的文档
- 保留同分类上/下一篇导航和文档列表
- 首页自动隐藏模块

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
z2_cc added 1 commit 2026-05-13 15:44:01 +08:00
wqer added 1 commit 2026-05-13 15:48:52 +08:00
78a953da84 cleanup: remove unused prev/next navigation styles and code
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
liuyan688 added 1 commit 2026-05-13 15:56:31 +08:00
liuyan688 added 1 commit 2026-05-13 16:21:54 +08:00
c72985df89 feat: 反馈数据后端化,添加管理统计面板
- 新增 api/feedback/store.js 基于 JSON 文件的反馈数据存储
- 新增 POST /api/feedback 提交接口,GET /api/feedback/stats 和 /recent 管理接口
- DocFeedback 组件提交反馈时同步发送到后端
- 新增 /admin/index.html 管理面板,支持查看统计数据和最近反馈
- Dockerfile 添加数据卷持久化,流水线添加 -v 挂载
wqer added 1 commit 2026-05-13 16:24:49 +08:00
b282d4bd82 feat: add breadcrumb navigation to doc pages
Implement custom breadcrumb component that replaces default Docusaurus
DocBreadcrumbs with one that uses doc ID path segments. Shows hierarchy
like "帮助中心 > 代码库管理 > 仓库创建" and links intermediate
categories to the first doc in each category.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
liuyan688 added 2 commits 2026-05-13 16:32:41 +08:00
z2_cc added 1 commit 2026-05-13 16:38:00 +08:00
wqer added 1 commit 2026-05-13 17:02:40 +08:00
b00f5e189c remove: RelatedDocuments feature deemed redundant with sidebar navigation
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
wqer added 1 commit 2026-05-13 17:51:24 +08:00
4900daa7bc feat: add recent docs browsing history feature
Track recently visited doc pages in localStorage and display them
at the bottom of each doc page for quick re-access.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
wqer added 1 commit 2026-05-13 18:03:46 +08:00
53c3e2f60f refactor: move RecentDocs from footer to sidebar
RecentDocs now appears at the bottom of the sidebar instead of the
page footer, making it more accessible during navigation.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
wqer added 1 commit 2026-05-13 18:10:16 +08:00
1860d1219a refactor: move RecentDocs to top of sidebar for better visibility
RecentDocs section now appears below the logo at the top of the
sidebar, making recent browsing history immediately visible and easy
to click.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
wqer added 1 commit 2026-05-13 18:44:48 +08:00
9075878f88 feat: add share buttons (WeChat QR, QQ, copy link) to doc pages
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
wqer added 1 commit 2026-05-13 18:48:54 +08:00
891c3ebaed simplify: keep only copy-link button in ShareButton
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
wqer added 1 commit 2026-05-13 18:58:35 +08:00
c35ceb7bb5 feat: add '去 GitLink 试试' action button linking docs to platform
Each doc now shows a contextual button linking to the corresponding
GitLink platform page, bridging documentation to real usage.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
wqer added 1 commit 2026-05-13 19:24:46 +08:00
d18c56c27d feat: add bookmark/favorites feature with sidebar list
Remove unused GitLinkAction and ShareButton components.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
z2_cc added 1 commit 2026-05-14 15:48:56 +08:00
This pull request can be merged automatically.
You are not authorized to merge this pull request.
You can also view command line instructions.

Step 1:

From your project repository, check out a new branch and test the changes.
git checkout -b z2_cc-master master
git pull master

Step 2:

Merge the changes and update on Gitea.
git checkout master
git merge --no-ff z2_cc-master
git push origin master
Sign in to join this conversation.
No reviewers
No Label
No Milestone
No project
No Assignees
3 Participants
Notifications
Due Date
The due date is invalid or out of range. Please use the format 'yyyy-mm-dd'.

No due date set.

Dependencies

No dependencies set.

Reference: Gitlink/gitlink_help_center#86
No description provided.