Hexo-Fluid 主题添加 Waline 评论系统

在Fluid官网可以看到。Fluid默认支持了很多评论系统,国内用的比较多的还是Waline,但我并没有发现在Fluid主体下添加Walined之类的文章,所以这里也记录一下操作路程以及踩的一些坑

我之前是用valine的,但无奈太难用了,也不支持通知,所以就换成Waline。其实Waline官方文档搭建配置写的十分详细,本文档也是参考Waline来写的,只是添加了我本人的补充,请耐心观看。

LeanCloud 设置 (数据库)

  1. 登录或 注册 LeanCloud 国际版 并进入控制台。建议是注意国际版,不要用国内版本。注意mac使用safari浏览器访问leancloud国际版可能会上不去或者提示403,这个很坑爹,换Chrome就好了。
  2. 点击左上角 创建应用 并起一个你喜欢的名字 (请选择免费的开发版):
    创建应用
  3. 进入应用,选择左下角的 设置 > 应用 Key。你可以看到你的 APP ID,APP Key 和 Master Key。请记录它们,以便后续使用。
    ID 和 Key

Vercel 部署 (服务端)

Vercel

  1. 点击上方按钮,跳转至 Vercel 进行 Server 端部署。
    注
    如果你未登录的话,Vercel 会让你注册或登录,请使用 GitHub 账户进行快捷登录。
  2. 输入一个你喜欢的 Vercel 项目名称并点击 Create 继续。(建议手动添加一个项目,这样会在你的仓库里新增一个库)
    创建项目
  3. 此时 Vercel 会基于 Waline 模板帮助你新建并初始化仓库,仓库名为你之前输入的项目名。
    deploy
    一两分钟后,满屏的烟花会庆祝你部署成功。此时点击 Go to Dashboard 可以跳转到应用的控制台。
    deploy
  4. 点击顶部的 Settings - Environment Variables 进入环境变量配置页,并配置三个环境变量 LEAN_ID, LEAN_KEY 和 LEAN_MASTER_KEY 。它们的值分别对应上一步在 LeanCloud 中获得的 APP ID, APP KEY, Master Key。
    设置环境变量
    这里需要注意的是:环境变量里填写的NAME为LEAN_ID、LEAN_KEY、LEAN_MASTER_KEY这些,不要直接把leancloud里的名字和值填进去 ,否则会报500的错!!!这点巨坑!!
    Lean Cloud Vercel Environment
    AppID LEAN_ID
    AppKey LEAN_KEY
    MasterKey LEAN_MASTER_KEY
    注意:如果你使用 LeanCloud 国内版,请额外配置 LEAN_SERVER 环境变量,值为你绑定好的域名。
  5. 环境变量配置完成之后点击顶部的 Deployments 点击顶部最新的一次部署右侧的 Redeploy 按钮进行重新部署。该步骤是为了让刚才设置的环境变量生效。
    redeploy
    1. 此时会跳转到 Overview 界面开始部署,等待片刻后 STATUS 会变成 Ready。此时请点击 Visit ,即可跳转到部署好的网站地址,此地址即为你的服务端地址,服务端地址也就serverURL,在Fluid的配置文件中,有2个地方需要用到它。注意:每次部署后的地址是不一样的 ,以最后一次的地址为主。服务器地址的格式是:commentxxxx-xxxxxxx.vercel.app
      redeploy success

绑定域名(可选,略,见官网)

HTML 引入 (客户端)

官网只介绍了Waline标签,但没有告诉我们具体在哪里引入,所以不太友好。这种第三方的JS、HTML在Fluid官网也有介绍,所以直接在Fluid主题配置引入,也就是博客根目录/themes/fluid/_config.yml。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
custom_js: 'https://unpkg.com/
@waline/client
@v2/dist/waline.js'
custom_css: 'https://unpkg.com/
@waline/client
@v2/dist/waline.css'
custom_html: '
<div id="waline">
</div>
<script>
Waline.init({
el:
"#waline"
,
serverURL:
"https://comment-xxxxx-xxxx.vercel.app/"
,
});
</script>
'

image-20220810174800349
再配置comment插件的地方

到这里就OK了,部署之后就可以正常运行了。然后访问 <serverURL>/ui/register 进行注册,就可以管理评论了。(部署到github后需要等几分钟再查看)


Hexo-Fluid 主题添加 Waline 评论系统
https://zhouyinglin.top/2022/08/10/Hexo-Fluid 主题添加 Waline 评论系统/
作者
小周
发布于
2022年8月10日
许可协议