评论

Mr.Hope ... 2020-10-13 Feature
  • Comment
  • Feature
大约 4 分钟

通过内置 vuepress-plugin-comment1 (opens new window)vuepress-theme-hope 实现了评论功能。

# 启用 支持页面配置

评论功能默认全局启用,配置项为 comment

相关信息

受篇幅限制,完整的评论插件配置,详见 vuepress-plugin-comment1 插件文档 (opens new window)

# 评论服务

有三个评论插件可以选择: Waline、Vssue 和 Valine。

评论服务的比较

  • Waline 需要后端服务器以及额外的配置,支持页面访问量统计,无需登录账号即可评论。可以使用 Vercel。
  • Vssue 使用代码平台仓库的 issue 面板,需要用户登录或注册相应平台账号。
  • Valine 使用 leancloud,支持页面访问量统计,无需登录账号即可评论

如果你的站点面向大众而非程序员,推荐使用 Waline。

# Waline

# 获取 APP ID 和 APP Key

请先 登录 (opens new window)注册 (opens new window) LeanCloud 国际版, 进入 控制台 (opens new window) 后点击左下角 创建应用 (opens new window)。创建应用后进入该应用,选择左下角的 设置 > 应用Key,然后记下 APP ID,APP KeyMaster Key

之后点击下方按钮,跳转至 Vercel 进行快速部署。

Vercel (opens new window)

按照要求输入 Vercel 项目名称与 GitHub 仓库名称。Vercel 会基于 waline 模板帮助你新建并初始化该仓库。仓库初始化完毕后,需要在 Environment Variables 中配置 LEAN_ID, LEAN_KEYLEAN_MASTER_KEY 三个环境变量。它们的值分别对应上一步在 LeanCloud 中获得的 APP ID, APP KEY, Master Key

设置好环境变量后,点击 Deploy 部署,一两分钟即可部署完成。之后在主题设置中设置 vercel 地址:

Waline 评论的其他配置将在 配置 (opens new window) 中列出。

提示

更多配置与使用,请见 Waline 官方文档 (opens new window)

# Vssue

# 选择你要使用的代码托管平台

Vssue 支持通过 GitHub, Gitlab, Bitbucket 或者 Gitee 的 Issue 系统来为你的静态页面提供评论功能,你可以选择其中之一来使用。

前往 支持的代码托管平台 - 创建 OAuth App (opens new window) 查看详细指引。

完成这一步之后,你将会配置好一个 OAuth App,并得到对应的 client idclient secret,它们将会用于 Vssue 的使用。

  • owner: 对应 repository 的拥有者帐号或者团队
  • repo: 用来存储评论的 repository
  • clientId: OAuth App 的 client id
  • clientSecret: OAuth App 的 client secret (只有在使用某些平台时需要)

# 使用插件

提示

唯一的区别在于,你需要设置 platform 而不是对应的 api 包。

@vssue/vuepress-plugin-vssue 会自动根据你设置的 platform 为你解析对应的 API 包:

  • Platform github - API 包 @vssue/api-github-v3
  • Platform github-v4 - API 包 @vssue/api-github-v4
  • Platform gitlab - API 包 @vssue/api-gitlab-v4
  • Platform bitbucket - API 包 @vssue/api-bitbucket-v2
  • Platform gitee - API 包 @vssue/api-gitee-v5
  • Platform gitea - API 包 @vssue/api-gitea-v1

# Valine

借助 Valine,主题实现了无后端开启阅读量展示与评论功能。

# 获取 APP ID 和 APP Key

请先 登录 (opens new window)注册 (opens new window) LeanCloud, 进入控制台后点击左下角创建应用。

应用创建好以后,进入刚刚创建的应用,选择左下角的 设置 > 应用Key,然后就能看到你的 APP IDAPP Key 了。

将对应的 APP IDAPP Key 填入, Valine 即配置完成。

Valine 评论的其他配置将在 配置 (opens new window) 中列出。

提示

更多配置与使用,请见 Valine 官方文档 (opens new window)

上次编辑于: 2022年6月4日 13:16
贡献者: Mr.Hope , Mr.Hope