前言

本博客的搜索功能由 Algolia 提供支持。自从安装好到今天已经使用了一个星期有余,使用起来感觉还挺不错,而且对于写博客而言使用它的免费服务就够了,白嫖个搜索引擎还是蛮香的~

安装过程

创建目录

首先,就是要前往Algolia官网注册一个账号,用自己的邮箱或者干脆用 GitHub or Google 账号登录:

在 Dashboard 界面,依次点击 ① 处的 search -> ② 处的 Index 创建一个新的 Index ,我这里创建了一个叫 Hexo 的目录。

配置 API Keys

目录创建好就要配置你的专属 API 使你的博客可以使用 Algolia 的搜索服务

回到 Dashboard ,点击 API Keys

你就可以看到下面的界面:

记住它,我们待会儿要用到

修改配置文件

我用的插件是 hexo-algoliasearch ,这里的安装可以参考 hexo-algoliasearch 项目的官方教程

先在博客根目录 Git Bash Here 运行以下命令安装 hexo-algoliasearch :

1
npm install hexo-algoliasearch --save

Butterfly 默认支持 Algolia,去 Butterfly 的配置文件里找到 # Algolia search ,修改配置文件:

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

去 Hexo 的配置文件里添加 Algolia 的配置:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
# Search
algolia:
appId: "N900YYPCFS"
apiKey: "398db4aaaaaaaaaaaaaaaaaaaaaaaaa"
adminApiKey: "sa1a3aaaaaaaaaaaaaaaaaaaaaaaaaaa"
chunkSize: 5000
indexName: "Hexo"
fields:
- content:strip:truncate,0,500
- tags
- permalink
- excerpt:strip
- title
- categories

其中的 appId 字段对应 API Keys 界面①处的 “Application ID”;apiKey 字段对应②处的 “Search-Only API Key”;adminApiKey 对应③处的 “Admin API Key”,把自己的复制粘贴过去,indexName 后面填写上你注册的目录名称(别忘了语法,冒号后面记得添个空格)

如果想把记录添加到 algolia 的目录里,hexo 三连的内容就要稍微改一下了,即:

1
hexo cl && hexo g && hexo algolia -n && gulp && hexo d

新加入的 hexo algolia -n 就是在不删除已有索引的基础上添加新的索引到 algolia。

有误之处欢迎反馈!