Hexo 的评论系统之 Valine

Posted on | In | |
Words count in article: 819 | Reading time ≈ 3

之前试了试 Disqus 和 Gitalk，出于各方面考虑，最终选择使用 Valine，简洁而美观。

关于 Valine

简介

Valine 诞生于2017年8月7日，是一款基于 Leancloud 的快速、简洁且高效的无后端评论系统。
理论上支持但不限于静态博客，目前已有 Hexo、Jekyll、Typecho、Hugo 等博客程序在使用 Valine。

特性

  • 快速
  • 安全
  • Emoji 😉
  • 无后端实现
  • MarkDown 全语法支持
  • 轻量易用
  • 文章阅读量统计

Valine 配置流程

注册 LeanCloud 账号

LeanCloud 官网

创建应用

然后 LeanCloud -> 应用 -> 设置 -> 应用 Key 中查看 App ID 和 App Key。

配置文件

../themes/next/_config.yml 文件中，查找 Valine，并添加下面代码中的 appid 和 appkey 字段对应内容。

1
2
3
4
5
6
7
8
9
10
11
12
13
# Valine.
# You can get your appid and appkey from https://leancloud.cn
# more info please open https://valine.js.org
valine:
  enable: true
  appid:  # your leancloud application appid
  appkey:  # your leancloud application appkey
  notify: false # mail notifier , https://github.com/xCss/Valine/wiki
  verify: false # Verification code
  placeholder: Just go go # comment box placeholder
  avatar: mm # gravatar style
  guest_info: nick,mail,link # custom comment header
  pageSize: 10 # pagination size

添加 Web 安全域名

为了您的数据安全，请填写 LeanCloud -> 应用 -> 设置 -> 安全中心 中的 Web 安全域名。

Valine 其它配置

Valine 头像设置

目前 Valine 中采用的是 Gravatar 作为评论列表头像，从 v1.1.7 正式版开始支持(自定义配置 avatar 字段)6种头像表现形式：

参数 表现形式 备注
空字符串'' Gravatar 官方图形 Gravatar 官方图形
mm 神秘人(一个灰白头像) 神秘人(一个灰白头像)
identicon 抽象几何图形 抽象几何图形(根据邮箱或昵称生成)
monsterid 小怪物 小怪物
wavatar 用不同面孔和背景组合生成的头像 用不同面孔和背景组合生成的头像(根据邮箱或昵称生成)
retro 八位像素复古头像 八位像素复古头像(根据邮箱或昵称生成)

若 avatar 的值不等于 6 种参数中的一种，则默认为 mm。

Valine 邮件提醒设置

设置 LeanCloud

LeanCloud -> 应用 -> 设置 -> 邮件模板，按下图设置用于重置密码的邮件主题并保存：

Valine 邮件提醒设置

注意：请修改链接为你的博客或网站首页。

1
2
3
4
5
<p>Hi, {{username}}</p>
<p>
你在 {{appname}} 的评论收到了新的回复，请点击查看：
</p>
<p><a href="你的网址首页链接" style="display: inline-block; padding: 10px 20px; border-radius: 4px; background-color: #3090e4; color: #fff; text-decoration: none;">马上查看</a></p>

初始化 Valine

设置Valine的notify为true即可打开邮件提醒。

注意：发送次数过多，可能会暂时被 Leancloud 屏蔽邮件发送功能
注意：由于邮件提醒功能使用的 Leancloud 的密码重置邮件提醒，只能传递昵称、邮箱两个属性，所以邮件提醒链接无法直达指定文章页。请悉知。

注：开启邮件提醒会默认开启验证码选项。

Valine 评论数据管理

LeanCloud -> 应用 -> 存储 -> 数据 -> Comment。

更新历史

  • 18-07-21 update：添加 Valine 头像设置 中的参数和表现示例
  • 18-07-17 update：补充 Valine 的 头像设置 和 邮件提醒设置
  • 18-07-16 first commit：拟定初稿

参考资料

------ END ------
0%