前言
最近又去看了一下Yun主题的文档,发现是有搜索引擎的支持的,在几个搜索引擎的方案中我选择了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这里,我们把addObject和deleteObject加上去
这样,你就得到了一个新的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
搬运申明
本文作者:Lanta
本文链接:https://lanta.bangumi.cyou/2022/03/12/hexo-install-algolia/
版权声明:本博客所有文章除特别声明外,均默认采用 CC BY-NC-ND 4.0 许可协议。
若您想及时得到回复提醒,建议跳转 Twikoo 评论。