brunoandClaude Sonnet 4.5
c8aabd4fcc
- 更新 VitePress 配置中的 socialLinks - 更新中文首页的 GitHub 链接 - 更新英文首页的 GitHub 链接 - 修正 git clone 命令和 Issues 链接 正确的仓库地址：https://github.com/BrunoGao/ljwx-docs Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
3.5 KiB
3.5 KiB
✅ Giscus 评论系统配置完成！
🎉 配置信息
- GitHub 仓库：BrunoGao/ljwx-docs
- Repo ID：R_kgDOQ_ockw
- 分类：Announcements
- Category ID：DIC_kwDOQ_ock84C1Uqp
- 状态：✅ 已配置并推送到仓库
🧪 测试评论系统
方法 1：本地测试
-
访问本地开发服务器：
http://localhost:5555 -
点击任意文档页面（例如：快速开始、指南等）
- 注意：首页不显示评论，需要访问文档页面
-
滚动到页面底部，您应该看到 Giscus 评论框
-
如果看到评论框，说明配置成功！🎉
方法 2：远程测试
从局域网内其他设备访问：
http://192.168.1.83:5555
预期效果
浅色模式：
- 白色背景的评论框
- 蓝色主题色按钮
深色模式：
- 深色背景的评论框
- 自动切换主题
多语言：
- 中文页面显示中文界面
- 英文页面显示英文界面
📝 发表评论测试
- 点击评论框中的 Sign in with GitHub
- 授权 Giscus 访问您的 GitHub 账号
- 输入测试评论，例如："测试评论系统 ✅"
- 点击 Comment 发表
评论会自动保存到：
https://github.com/BrunoGao/ljwx-docs/discussions
🔍 验证评论存储
访问您的 GitHub Discussions：
https://github.com/BrunoGao/ljwx-docs/discussions
您应该能看到：
- Announcements 分类下有新的讨论
- 讨论标题对应文档页面的路径
- 评论内容显示在讨论中
🎨 评论框特性
✅ 自动主题切换：跟随 VitePress 深色模式 ✅ 多语言支持：中英文自动切换 ✅ 响应式设计：完美适配移动端 ✅ Markdown 支持：评论支持 Markdown 格式 ✅ 表情反应：支持点赞、点踩等反应 ✅ 实时更新：评论实时同步
🚫 禁用特定页面的评论
如果某个页面不想显示评论，在 Markdown 文件顶部添加：
---
comment: false
---
📊 评论管理
所有评论都存储在 GitHub Discussions 中，您可以：
- 编辑评论
- 删除评论
- 锁定讨论
- 标记为已解决
- 导出评论数据
🔗 相关链接
- GitHub 仓库：https://github.com/BrunoGao/ljwx-docs
- Discussions：https://github.com/BrunoGao/ljwx-docs/discussions
- Giscus 设置：https://giscus.app/zh-CN
❓ 故障排查
问题 1：看不到评论框
可能原因：
- 访问的是首页（首页不显示评论）
- 浏览器缓存问题
解决方法：
- 访问文档页面（不是首页）
- 清除浏览器缓存并刷新
- 检查浏览器控制台是否有错误
问题 2：评论框显示错误
可能原因：
- GitHub Discussions 未启用
- Giscus App 未安装
解决方法：
- 访问 https://github.com/BrunoGao/ljwx-docs/settings
- 确认 Discussions 已启用
- 访问 https://github.com/apps/giscus 确认已安装
问题 3：无法登录评论
可能原因：
- 未登录 GitHub
- 浏览器阻止弹窗
解决方法：
- 先登录 GitHub
- 允许浏览器弹窗
- 重新点击 "Sign in with GitHub"
🎯 下一步
评论系统已完全配置完成！您可以：
- ✅ 测试评论功能
- ✅ 邀请团队成员测试
- ✅ 自定义评论框样式（编辑 GiscusComment.vue）
- ✅ 配置评论通知（GitHub Settings → Notifications）
配置完成时间：2026-01-23 配置文件：docs/.vitepress/theme/components/GiscusComment.vue 提交记录：a02a198