前言

最近又去看了一下Yun主题的文档,发现是有搜索引擎的支持的,在几个搜索引擎的方案中我选择了Algolia

配置环境?

因为我个人从ArchLinux回到了Windows,所以没有了原生的Linux环境,不方便操作,索性上CloudIDE了(我用的CloudStudio而不是Github Codespaces或goorm ide的原因是因为我不想被延迟搞到高血压

注册并配置Algolia

无论如何,我们必须要先注册并配置好Algolia,否则我们的网站将没有Algolia的使用权限,即使开启了对Algolia的支持,也只是一片空白

Algolia官网

按道理来说只要填好邮箱和密码,然后再验证一下邮箱就可以注册完成

新建Indices

在左侧栏的Products有个Search,我们点进去

一打开就是Indices了,我们点击Create Index

这样就可以了

API Key

进到Algolia的管理应用程序

点API Keys

这里就可以看到我们的appID和apiKey了

不过这里我们只需要Admin API Key,因为它自带的API Key基本上是不能用的,所以接下来我们要新建一个API Key出来

新建API Key

点击All API Keys,然后New API Key

Description也就是简介,这里看你自己喜欢怎么填

Indices中的Index name这个就是我们刚刚新建的

ACL这里,我们把addObjectdeleteObject加上去

这样,你就得到了一个新的API Key了

复制好appID和API Key以及Admin API Key备用

安装

各类主题的安装方法各不相同,我这里以我自己用的Yun主题为例子

通过npm安装模块

您需要先安装 hexo-algolia 或 hexo-algoliasearch,并根据它们的说明文档进行相应的配置。

因为各种原因我推荐你使用hexo-algolia,所以我们就直接npm install hexo-algolia --save即可

这里要注意一下,hexo-algolia和hexo-algoliasearch两者不可兼得,如果你不小心两个都装了就用npm remove其中一个解决问题!

修改Hexo的配置文件

_config.yml加上这一段:

algolia:
  applicationID: "" #AppID
  apiKey: "" #刚刚新建的API Key
  adminApiKey: "" #Admin API Key
  indexName: "" #这个就是Indices填的
  chunkSize: 5000

这里要注意一下,这个大小写一定要对,不然没办法正常使用

修改Yun的配置文件

如果你还在使用旧版的Yun,那么你的配置文件应该是在source/_data/yun.yml

但是新版Yun已经更换了依赖,配置文件改放到Hexo根目录/_config.yun.yml

不过这不是重点,配置文件格式没有变化,是可以通用的,所以影响不大

我们就直接在配置文件加上这一段即可

algolia_search:
  enable: true
  hits:
    per_page: 10 # the number of search results per page

上传数据至Algolia

运行以下命令

export HEXO_ALGOLIA_INDEXING_KEY= #刚刚新建的API Key
hexo algolia

这样理论来说Algolia就会新增索引了

结尾

最后,本次教程到这里就结束了,如果你跟着本教程一步一步走还是有问题欢迎在底下评论区告诉我,我会在一周内答复你

参考资料

本文参考了以下资料进行写作

https://yun.yunyoujun.cn/guide/third-party-support.html#algolia

https://blog.csdn.net/qq_35479468/article/details/107335663