获取Algolia API key

注册登陆

使用 GitHub 或者 Google 账户直接登录,也可以注册一个新账户。新用户14天内拥有所有功能(包括收费类别的)。之后若未续费会自动降级为免费账户,免费账户总共有10,000 条记录,每月有 100,000 的可以操作数。
注意:第14天降级为免费用户需要再次进去手动更换plan,否则功能会失效不可用。

新建Indices

登录后左侧菜单点击 Indices -> new -> index -> Index name
名字自己起,这个名字在后面的配置中要用到
点击 create 就创建成功了
左侧菜单点击 API Keys 查看自己的 Application IDSearch-Only API Key 并记录下来
点击上方 All API Keys
然后点击下面小铅笔进行配置
划到最下面,在ACL选项卡中添加search addObject deleteObject browse
然后点击 update应用更改

Hexo主题配置

启用Algolia

主题配置文件themes/主题名/_config.yml

1
2
3
4
algolia_search:
enable: true
hits:
per_page: 10

声明Algolia参数

Hexo主配置文件增加

1
2
3
4
5
algolia:
applicationID: '你的applicationID'
apiKey: '你的Search-Only API key'
indexName: '你的indexName'
chunkSize: 5000

安装Hexo Algolia扩展

1
npm install hexo-algolia --save

由于Algolia运行的时候是读取环境变量来读取key,所以需要在环境变量中设置HEXO_ALGOLIA_INDEXING_KEY

1
2
3
//bash
export HEXO_ALGOLIA_INDEXING_KEY=你的Search-Only API key
//Windows和Mac自行解决

查看环境变量

1
2
3
//bash
export | grep ALGOLIA
//Windows和Mac自行解决

我的使用环境是Deepin,但是在Deepin中设置环境变量后关闭终端重新打开会重置环境变量,以下为解决方案

1
2
3
4
5
6
vim ~/.bash_profile
//添加以下字段
export HEXO_ALGOLIA_INDEXING_KEY=你的Search-Only API key
//保存并退出
:wq
//这样每次终端运行的时候都会加载变量了

每次更新完Hexo内容需要同步记录

1
2
3
hexo algolia
//简写
hexo a