Hexo博客安装Algolia全局搜索
小白温馨提示:
本文中出现的_config.yml
指的是博客框架Hexo的默认配置文件,而_config.butterfly.yml
指的是博客主题的配置文件,这个是开始之前必须搞清楚的,不然容易发生报错。
1. 创建 Alogolia Index
登录Algolia官网,没有账号可以用邮箱直接注册一个,或者使用Github登录(各位都是折腾hexo的友人了,不会还没有github吧)
然后进入 Dashboard,选择新建一个 Index,这里创建了一个名为blog的Index
这个Index会存储你的文章索引,将会用于全局搜索
2. 配置 API Key
跟着需要配置API Keys到我们自己的 hexo 博客中来,这样子hexo 博客的数据就可以通过 API 发送给Aloglia
点击右侧进入Setting,再点击进入API Keys
我们要用到Application ID 、Search-Only API Key、Admin API KEY信息
3.Hexo Algolia获取站点数据
你需要安装 hexo-algolia 或 hexo-algoliasearch. 根据它们的说明文档去做相应的配置
下面用 hexo-algoliasearch 进行演示
1.首先安装 hexohexo-algoliasearch
在博客根目录运行一下命令
1 | npm install hexo-algoliasearch --save |
如果博客没能自动读取插件,可在_config.yml
中添加
1 | plugins: |
2.接着需要修改 hexo 根目录下的 _config.yml
,进行以下配置:
1 | algolia: |
注意缩进!!!
applicationID 就是网页中的 Applicaiton ID
apiKey 就是网页中的 Search-Only API Key
indexName 就是我们前面创建的Index名称
代码块里的必填,如果你使用 hexo-algoliasearch,请记得配置 fields 参数的 title, permalink 和 content
最后配置_config.butterfly.yml
,添加以下配置
1 | # Algolia search |
3.上传索引
在博客根目录运行以下命令:
1 | hexo algolia |
4.最终成果
运行Hexo三件套,重新部署博客,点击搜索即可使用