hexo butterfly 主题 添加 algolia 搜索

之前一直无法成功注册登录 algolia 一直用的 hexo 本地搜索，搜索结果不准确，algolia 有一定的免费额度，对于小网站来说还是挺友好的，接入也很方便。（无法注册成功登录的原因我注释在了最后）

安装

插件地址在：https://github.com/LouisBarranqueiro/hexo-algoliasearch

npm install hexo-algoliasearch --save

注册 Algolia 并获取配置

https://www.algolia.com/

https://blog.linkinstars.com/blog/blog-hexo-butterfly-algolia-1.png

https://blog.linkinstars.com/blog/blog-hexo-butterfly-algolia-2.png

配置

修改博客根目录的配置文件 _config.yml

algolia:
  appId: "Z7A3XW4R2I"
  apiKey: "12db1ad54372045549ef465881c17e743"
  adminApiKey: "40321c7c207e7f73b63a19aa24c4761b"
  chunkSize: 5000
  indexName: "my-hexo-blog"
  fields:
    - content:strip:truncate,0,500
    - excerpt:strip
    - gallery
    - permalink
    - photos
    - slug
    - tags
    - title

修改主题目录下的配置文件 themes/butterfly/_config.yml

algolia_search:
  enable: true
  hits:
    per_page: 10
  labels:
    input_placeholder: Search for Posts
    hits_empty: "我们没有找到任何搜索结果: ${query}"
    hits_stats: "找到${hits}条结果（用时${time} ms）"

命令

hexo algolia

其他命令照常就可以

注意事项

虽然有很多博客已经写过如何添加这个插件，如何使用，但是我在实际过程中还是遇到了很多奇怪的问题

账号无法正常登录

为什么我一直拖到现在才添加 Algolia 搜索呢？很大一部分原因就是因为我的账号没法正常登录 Algolia。

一开始我是用 foxmail 邮箱去注册的，但是注册成功之后一直无法登录，我以为是墙的问题，但是后来发现并不是。

直到最近我更换了 gmail 的邮箱，发现一下就可以了。（不知道是不是白嫖的人太多了，导致 Algolia 封锁了一些特殊邮箱的行为）

搜索没有内容

当我一开始安装配置完成之后，我发现 Algolia 上面没有上传我的内容，也就无法搜索到。原因其实很简单，但很容易被忽略：

就是你需要先执行一次 hexo clean 清除一次缓存，然后再进行 hexo algolia hexo g 操作就可以了