输入关键词,开始搜索

↑↓ 选择↵ 打开esc 关闭
沉浸

评论系统

评论系统

Vergil 支持接入第三方评论系统,目前可选 Giscus(基于 GitHub Discussions)和 Artalk(自托管)。

评论默认关闭。没配好评论服务就打开,文章底部会显示报错,所以按下面的步骤配好之后,再打开全站开关。

Giscus(推荐)

Giscus 是一个基于 GitHub Discussions 的评论系统,免费、无广告,适合技术博客。

前置条件

  1. 仓库需要是公开的
  2. 在仓库设置中开启 Discussions 功能

配置步骤

  1. 访问 giscus.app,按指引生成配置代码
  2. 在 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'    }}
  1. 保存后,文章、页面、项目和文档的底部都会显示评论框

读者使用

读者需要登录 GitHub 账号才能评论,评论内容会同步到你的仓库 Discussions 中。

Artalk

Artalk 是一个自托管的评论系统,数据完全由自己掌控。

配置步骤

  1. 部署 Artalk 服务端(参考 Artalk 文档)
  2. 在 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 没有这个字段,会被静默丢弃且不报错。目前只能全站统一开或关。

未知标题
00:00
00:00
播放列表