Blog的搭建过程[ep.3| 基于 Algolia 为你的博客添加搜索功能]
前言
本博客的搜索功能由 Algolia 提供支持。自从安装好到今天已经使用了一个星期有余,使用起来感觉还挺不错,而且对于写博客而言使用它的免费服务就够了,白嫖个搜索引擎还是蛮香的~
安装过程
创建目录
首先,就是要前往Algolia官网注册一个账号,用自己的邮箱或者干脆用 GitHub or Google 账号登录:
在 Dashboard 界面,依次点击 ① 处的 search -> ② 处的 Index 创建一个新的 Index ,我这里创建了一个叫 Hexo
的目录。
配置 API Keys
目录创建好就要配置你的专属 API 使你的博客可以使用 Algolia 的搜索服务
回到 Dashboard ,点击 API Keys
你就可以看到下面的界面:
记住它,我们待会儿要用到
修改配置文件
我用的插件是 hexo-algoliasearch ,这里的安装可以参考 hexo-algoliasearch 项目的官方教程
先在博客根目录 Git Bash Here 运行以下命令安装 hexo-algoliasearch :
1 | npm install hexo-algoliasearch --save |
Butterfly 默认支持 Algolia,去 Butterfly 的配置文件里找到 # Algolia search
,修改配置文件:
1 | # Algolia search |
去 Hexo 的配置文件里添加 Algolia 的配置:
1 | # Search |
其中的 appId
字段对应 API Keys 界面①处的 “Application ID”;apiKey
字段对应②处的 “Search-Only API Key”;adminApiKey
对应③处的 “Admin API Key”,把自己的复制粘贴过去,indexName
后面填写上你注册的目录名称(别忘了语法,冒号后面记得添个空格)
如果想把记录添加到 algolia 的目录里,hexo 三连的内容就要稍微改一下了,即:
1 | hexo cl && hexo g && hexo algolia -n && gulp && hexo d |
新加入的 hexo algolia -n
就是在不删除已有索引的基础上添加新的索引到 algolia。
有误之处欢迎反馈!