概要:在这篇记录中,我们将集成hexo-butterfly-artitalk插件,为网站添加说说功能。

效果展示:

Artitalk.js

Artitalk.js是一个基于 LeanCloud 实现的可实时发布说说/微语的 js库。

LeanCloud

LeanCloud是一个一站式云端服务。

步骤

安装插件

因为hexo-theme-butterfly也就是我所使用的主题已经集成了Artitalk.js,所以只需按照插件,在进行配置即可为网站添加说说功能。

1
npm install hexo-butterfly-artitalk

添加配置

在Hexo的配置文件或者主題的配置文件中添加

1
2
3
4
5
6
7
8
9
10
# Artitalk
# see https://artitalk.js.org/
artitalk:
enable: true
appId:
appKey:
path:
js:
option:
front_matter:
参数 解释
appId 【必须】LeanCloud 创建应用中的 AppID
appKey 【必须】LeanCloud 创建应用中的 appKey
path 【可选】说说页面的路径,默认artitalk,生成的页面为 artitalk/index.html
js 【可选】更换 Artitalk 的 js CDN(默认为 https://cdn.jsdelivr.net/npm/artitalk
option 【可选】Artitalk 需要的额外配置
front_matter 【可选】Artitalk 页面的 front_matter 配置

创建LeanCloud 应用

  1. 前往 LeanCloud 国际版,注册账号。

  2. 注册完成之后根据 LeanCloud 的提示绑定手机号和邮箱。

  3. 绑定完成之后点击创建应用,应用名称随意,接着在结构化数据中创建 class,命名为 shuoshuo,权限先使用默认的。

  4. 在你新建的应用中找到内建账号下的用户管理。点击添加用户,输入想用的用户名及密码。

  5. 回到结构化数据中,点击 class 下的 shuoshuo。找到权限,在 Class 访问权限中将 add_fields 以及 create 权限设置为指定用户,输入你刚才输入的用户名会自动匹配。为了安全起见,将 deleteupdate 也设置为跟它们一样的权限。

  6. 然后新建一个名为atComment的class,权限什么的使用默认的即可。

  7. 点击 class 下的 _User 添加列,列名称为 img,默认值填上你这个账号想要用的发布说说的头像url,这一项不进行配置,说说头像会显示为默认头像 —— Artitalk 的 logo。

  8. 在最菜单栏中找到设置-> 应用 凭证,记下来 AppIDAppKey ,一会会用。

  9. 最后将 _User 中的权限全部调为指定用户,或者数据创建者,为了保证不被篡改用户数据以达到强制发布说说。

使用artitalk

在你对应的目录下创建index.md,如果是默认配置,也就是在/artitalk目录下创建,然后填充一下内容,记得将appId和appKey改成自己的哦!

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
---
title: 说说
type: artitalk
noDate: 'true'
comments: 'false'
---

<!-- 引用 artitalk -->
<script type="text/javascript" src="https://unpkg.com/artitalk"></script>
<!-- 存放说说的容器 -->
<div id="artitalk_main"></div>
<script>
new Artitalk({
appId: 'vpj0ElXQAUwMBLjqlyTnhWyj-MdYXbMMI', // Your LeanCloud appId
appKey: 'uh9RSiLwHKZSbuWOeJsPEGOU' // Your LeanCloud appKey
})
</script>

结论

这样你就可以获取一个免费的说说页面啦!要注意30天没有API请求的话,你创建的应用会被停用哦,不过再次激活即可恢复,快去发布第一个说说吧!

参考链接