Hexo博客安装Algolia全局搜索

485 字
2 分钟
Hexo博客安装Algolia全局搜索

小白温馨提示:#

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

1. 创建 Alogolia Index#

登录Algolia官网,没有账号可以用邮箱直接注册一个,或者使用Github登录(各位都是折腾hexo的友人了,不会还没有github吧)

pic1
pic1
然后进入 Dashboard,选择新建一个 Index,这里创建了一个名为blog的Index 这个Index会存储你的文章索引,将会用于全局搜索
pic2
pic2

2. 配置 API Key#

跟着需要配置API Keys到我们自己的 hexo 博客中来,这样子hexo 博客的数据就可以通过 API 发送给Aloglia 点击右侧进入Setting,再点击进入API Keys

pic3
pic3
我们要用到Application ID 、Search-Only API Key、Admin API KEY信息
pic4
pic4

3.Hexo Algolia获取站点数据#

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

下面用 hexo-algoliasearch 进行演示#

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

npm install hexo-algoliasearch --save

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

plugins:
- hexo-algoliasearch

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

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
pic5
代码块里的必填,如果你使用 hexo-algoliasearch,请记得配置 fields 参数的 title, permalink 和 content

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

# Algolia search
algolia_search:
enable: true
hits:
per_page: 6

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

hexo algolia

4.最终成果#

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

pic6
pic6

支持与分享

如果这篇文章对你有帮助,欢迎分享给更多人或打赏支持!

打赏
Hexo博客安装Algolia全局搜索
https://blog.smatrix.top/posts/hexo-blog-algolia-global-search/
作者
Kayin.
发布于
2023-04-05
许可协议
CC BY-NC-SA 4.0

评论区