Algolia 是一个搜索引擎服务端口,它为 Hexo 提供了搜索功能。配置 Algolia 是所有需要配置的插件中最简单的一部分。

AI search that understands your users
Enterprises and developers use Algolia's AI search infrastructure to understand users and show them what they're looking for

# 注册 Algolia 账户

https://www.algolia.com/users/sign_in

# 新建索引

https://www.algolia.com/explorer#?index=getstarted_actors

新建索引

# 查看 API Keys

https://dashboard.algolia.com/account/api-keys/

查看API Keys

需要用到的信息有:

  • Application ID
  • Search-Only API Key
  • Admin API Key

# 编辑根目录 _config.yml

打开站点根目录的 _config.yml ,找到 algolia 。修改各参数:

  • appId - 填写为 Application ID
  • apiKey - 填写为 Search-Only API Key
  • adminApiKey - 填写为 Admin API Key
  • indexName - 填写为新建索引名称 (我的是 hexo )

编辑根目录_config.yml

# 设置环境变量

在你的 rc 文件中为 Algolia 指定环境变量。

.bashrc
1
2
export HEXO_ALGOLIA_INDEXING_KEY=43e558ddb34e527169506593c80c7b9d
export PATH=$PATH:$GOROOT/bin:$GOPATH/bin:$MYSQL_HOME/bin:$MAVEN_HOME/bin:$CATALINA_HOME/bin:$CALIBRE_HOME:$JAVA_HOME/bin:$HEXO_ALGOLIA_INDEXING_KEY

根据你的 bash 类型,应用更改。这一般是 source ~/.bashsource ~/.zsh 等。

# 安装 hexo-algolia 扩展

安装`hexo-algolia`扩展
1
sudo npm install --save hexo-algolia

# 搜集数据

搜集数据
1
sudo hexo algolia

# 编辑主题目录 _config.yml

per_page 表示每页显示的条数。

_config.yml
1
2
3
4
algolia_search:
enable: true
hits:
per_page: 6

编辑主题目录_config.yml

# 部署 Hexo

部署Hexo
1
2
3
4
sudo hexo algolia
sudo hexo clean
sudo hexo g
sudo hexo d

建议执行命令 echo "alias b='cd ~/blog && sudo hexo algolia && sudo hexo cl && sudo hexo g && sudo hexo d'" >> ~/.bashrc ,这样只需要键入 b 即可部署 Hexo。

# 查看结果

查看结果

如果搜索功能正常,那么配置没有问题。