小白温馨提示:

本文中出现的_config.yml指的是博客框架Hexo的默认配置文件,而_config.butterfly.yml指的是博客主题的配置文件,这个是开始之前必须搞清楚的,不然容易发生报错。

1. 创建 Alogolia Index

登录Algolia官网,没有账号可以用邮箱直接注册一个,或者使用Github登录(各位都是折腾hexo的友人了,不会还没有github吧)
pic1
然后进入 Dashboard,选择新建一个 Index,这里创建了一个名为blog的Index
这个Index会存储你的文章索引,将会用于全局搜索
pic2

2. 配置 API Key

跟着需要配置API Keys到我们自己的 hexo 博客中来,这样子hexo 博客的数据就可以通过 API 发送给Aloglia
点击右侧进入Setting,再点击进入API Keys
pic3
我们要用到Application ID 、Search-Only API Key、Admin API KEY信息
pic4

3.Hexo Algolia获取站点数据

你需要安装 hexo-algoliahexo-algoliasearch. 根据它们的说明文档去做相应的配置

下面用 hexo-algoliasearch 进行演示

1.首先安装 hexohexo-algoliasearch
在博客根目录运行一下命令

1
npm install hexo-algoliasearch --save

如果博客没能自动读取插件,可在_config.yml中添加

1
2
plugins:
- hexo-algoliasearch

2.接着需要修改 hexo 根目录下的 _config.yml,进行以下配置:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
algolia:
appId: "Z7A3XW4R2I"
apiKey: "12db1ad54372045549ef465881c17e743"
adminApiKey: "40321c7c207e7f73b63a19aa24c4761b"
chunkSize: 5000
indexName: "blog"
fields:
- content:strip:truncate,0,500
- excerpt:strip
- gallery
- permalink
- photos
- slug
- tags
- title

注意缩进!!!
applicationID 就是网页中的 Applicaiton ID
apiKey 就是网页中的 Search-Only API Key
indexName 就是我们前面创建的Index名称
pic5
代码块里的必填,如果你使用 hexo-algoliasearch,请记得配置 fields 参数的 title, permalink 和 content

最后配置_config.butterfly.yml,添加以下配置

1
2
3
4
5
# Algolia search
algolia_search:
enable: true
hits:
per_page: 6

3.上传索引
在博客根目录运行以下命令:

1
hexo algolia

4.最终成果

运行Hexo三件套,重新部署博客,点击搜索即可使用
pic6