【butterfly】使用Algolia搜索

安装hexo-algolia插件

1	npm install hexo-algolia --save

创建 Alogolia Index

首先登陆进入 Algolia 官网，我们可以使用GitHub或Google帐号登录；

依次点击左侧Search图标 –> Configure –> Index；

新建一个名为hexo的Index索引；

Index(索引)也就是搜索引擎中的数据库，我们所有的搜索相关信息都存在里面。

配置 API Key

接下来需要配置Algolia的API Keys到我们自己的hexo站点中，关联两者，使得Algolia能够搜集我们hexo站点的数据通过API发送给Aloglia；

依次点击左侧Overview图标 –> API Keys；

记住Your API Keys下的Application ID和Search-Only API Key，在配置_config.yml用；

修改[you_blog]根目录下的_config.yml，添加以下代码：

# Algolia API配置
algolia:
  applicationID: #上一步API Keys界面的Application ID值
  apiKey: #上一步API Keys界面的Search-Only API Key值
  indexName: hexo #创建的索引名称

新建 App Key

还需要创建一个新建App Key用来配置环境变量；

依次点击左侧Overview –> API Keys –> All API Keys –> 右侧New API Key；

填好后点击Create完成创建；

参数	解释
Description	描述（用于分辨创建的`key`用途）
Indices	选择刚刚创建的名为`hexo`的索引
Validity	有效期；`0`表示不过期
Max API calls/IP/hour	每小时允许从`IP`地址进行的最大`API`调用次数，`0` 表示无限制
Max hits/query	最大命中/查询数
HTTP Referers	有权使用该密钥的网站列表，空表示所有引用者都将授权
ACL	此密钥的权限列表，选择`search`、`browse`、`addObject`、`deleteObject`、`deleteIndex`、`listIndexes`、`usage`

配置环境变量

在[you_blog]根目录下右键选择git bash执行以下命令：

1	export HEXO_ALGOLIA_INDEXING_KEY="上一步新创建的APIKEY"

修改主题配置文件

在_config.butterfly.yml中搜索algolia_search并修改:

# Algolia search(Algolia搜索)
algolia_search:
  enable: true
  hits:
    per_page: 6
  labels:
    input_placeholder: Search for Posts
    hits_empty: "没有找到任何搜索结果: ${query}"
    hits_stats: "找到约${hits }条结果( 用时${time }ms)"