小白温馨提示：

本文中出现的_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-algolia 或 hexo-algoliasearch. 根据它们的说明文档去做相应的配置

下面用 hexo-algoliasearch 进行演示

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

plaintext
1
npm install hexo-algoliasearch --save

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

plaintext
1
2
plugins:
  - hexo-algoliasearch

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

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，添加以下配置

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

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

plaintext
1
hexo algolia

4. 最终成果

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