评论系统
评论系统
Vergil 支持接入第三方评论系统,目前可选 Giscus(基于 GitHub Discussions)和 Artalk(自托管)。
评论默认关闭。没配好评论服务就打开,文章底部会显示报错,所以按下面的步骤配好之后,再打开全站开关。
Giscus(推荐)
Giscus 是一个基于 GitHub Discussions 的评论系统,免费、无广告,适合技术博客。
前置条件
- 仓库需要是公开的
- 在仓库设置中开启 Discussions 功能
配置步骤
- 访问 giscus.app,按指引生成配置代码
- 在
src/data/config/features.ts中填写:
TypeScript
comments: { enabled: true, provider: 'giscus', giscus: { repo: '你的用户名/你的仓库名', repoId: '仓库ID', category: 'Announcements', categoryId: '分类ID', mapping: 'pathname', reactionsEnabled: true, theme: 'preferred_color_scheme' }}- 保存后,文章、页面、项目和文档的底部都会显示评论框
读者使用
读者需要登录 GitHub 账号才能评论,评论内容会同步到你的仓库 Discussions 中。
Artalk
Artalk 是一个自托管的评论系统,数据完全由自己掌控。
配置步骤
- 部署 Artalk 服务端(参考 Artalk 文档)
- 在
src/data/config/features.ts中填写:
TypeScript
comments: { enabled: true, provider: 'artalk', artalk: { server: 'https://your-artalk-server.com', site: '你的网站名称' }}开启评论
评论是全站开关,默认是 false。配好评论服务后,在 src/data/config/features.ts 中改成 true:
TypeScript
comments: { enabled: true, provider: 'giscus', // 或 'artalk' // ... 具体配置}不支持单篇开关
文章 frontmatter 里写 commentsEnabled 是无效的,blog 的 schema 没有这个字段,会被静默丢弃且不报错。目前只能全站统一开或关。