hexo系列-使用waline配置评论系统

发表于 分类于 阅读次数： 3 Waline：

前言–几句废话

Hexo是一款基于Node.js的静态博客生成器，因其高效和易用性受到广泛欢迎。waline是一个新兴的轻量级评论系统，支持多种数据库和部署方式，适合在Hexo上使用。本文将详细介绍如何在Hexo中配置waline评论系统，以实现用户评论功能。

当前的系统就是使用waline配置的评论系统，把这篇文章拉到最后，你就能看到配置后的成品啦。评论一下试试吧~

前期准备

1. 安装Hexo

确保你已经安装了Hexo和Git。如果未安装，请先进行安装：

1
npm install -g hexo-cli

2. 创建或进入你的Hexo项目

1
2
hexo init myblog
cd myblog

3. 安装依赖插件

我们将使用hexo-next主题作为示例，并安装必要的插件：

1
npm install hexo-theme-next --save

4. 注册Waline账户

前往Waline官网注册一个账号，获取AppID、AppKey和MasterKey，这些信息稍后会用到。

配置Waline服务端

1. 选择数据库和服务端

Waline支持多种数据库和服务端部署方式，这里我们使用Vercel来部署服务端，并选择LeanCloud国际版作为数据库。

2. 注册LeanCloud国际版

访问LeanCloud国际版，完成注册并创建一个应用。

3. 配置环境变量

在你的Vercel项目中，添加以下环境变量：

  • LEAN_ID: 你的LeanCloud AppID
  • LEAN_KEY: 你的LeanCloud AppKey
  • LEAN_MASTER_KEY: 你的LeanCloud MasterKey

4. 一键部署到Vercel

点击Vercel上的“Deploy with Vercel”按钮，登录后选择新建项目，完成后点击“Redeploy”进行重新部署。

配置Waline客户端

1. 安装Waline客户端插件

在你的Hexo项目根目录执行：

1
npm install @waline/hexo-next --save

2. 修改配置文件

编辑themes/next/_config.yml文件，添加以下内容：

1
2
3
4
5
6
7
8
9
10
11
12
13
# Waline Configuration
waline:
  enable: true #是否开启Waline评论
  serverURL: https://your-server-url.vercel.app #替换为你的Vercel地址
  placeholder: 请文明评论呀 #评论框的默认文字
  avatar: mm #头像风格
  meta: [nick, mail, link] #自定义评论框上面的三个输入框的内容
  pageSize: 10 #评论数量多少时显示分页
  lang: zh-cn #语言可选值: en, zh-cn
  visitor: false #文章阅读统计
  comment_count: true #如果为false，评论数量只会在当前评论页面显示，主页不显示
  requiredFields: [] #设置用户评论时必填的信息，例如[nick,mail]: [nick]
  libUrl: //unpkg.com/@waline/client/dist/waline.min.js #自定义库CDN地址

3. 更新并部署Hexo

1
2
3
hexo clean
hexo generate
hexo deploy

总结与注意事项

  • 确保你在LeanCloud国际版中正确配置了环境变量，否则会导致Waline无法正常工作。
  • 如果遇到SSL证书问题，建议使用带有公网IP的服务器，或者使用Vercel提供的免费域名绑定服务。
  • 定期检查Waline的后台管理界面，对评论进行管理，确保社区环境的健康。