评论

通过内置 @mr-hope/vuepress-plugin-comment (opens new window)，vuepress-theme-hope 实现了评论功能。

启用 支持页面配置

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

相关信息

受篇幅限制，完整的评论插件配置，详见 @mr-hope/vuepress-plugin-comment 插件文档 (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 Key 和 Master Key。

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

(opens new window)

按照要求输入 Vercel 项目名称与 GitHub 仓库名称。Vercel 会基于 waline 模板帮助你新建并初始化该仓库。仓库初始化完毕后，需要在 Environment Variables 中配置 LEAN_ID, LEAN_KEY 和 LEAN_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 id 和 client 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 ID 和 APP Key 了。

将对应的 APP ID 和 APP Key 填入， Valine 即配置完成。

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

提示

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