https://github.com/oncletom/hexo-algolia

Algolia

安装指南 在线预览

  1. 在Hexo站点的根目录安装hexo-algolia插件。

  2. 注册并登录Algolia。 首次登录控制面板(Dashboard)时点击页面上的“创建索引”(Create Index)按钮。 然后，输入”索引名称“(Index name)并点击“创建”(Create)完成索引创建。

    创建索引 - Algolia

    创建索引 - Algolia

  3. 下一步，点击右侧导航栏上的”API密钥“(API Keys)，复制页面上的“应用ID”(Application ID)和“仅限搜索的API Key” (Search-Only API Key)。 打开Hexo站点根目录下的站点配置文件_config.yml，填入上面复制的信息到hexo-algolia插件的配置中。

    image-20200718170526467

    API密钥 - Algolia

    例如，下面的Algolia索引信息：

    1
    2
    3
    4
    5
    Algolia索引信息

    Algolia索引名称: 你一个建的索引名称
    Application ID: 图中第一个
    Search-Only API Key: 图中第二个

  4. 回到Algolia控制面板的”API密钥“(API Keys)页面并切换到“所有API Keys”(All API Keys)标签页。 点击“新建API Key”(New API Key)按钮。 在弹出的“创建API Key”(Create API Key)对话框中，在”索引“(Indices)处选择你在上一步中创建的“索引”(Indices)。 然后，“ACL”项中添加addObject，deleteObject，listIndexes， deleteIndex。 点击“创建”(Create)完成密钥的创建。 复制刚刚创建的API Key，例如727fbd8c998fe419318fa350db6793ca。

    image-20200718170939554

    创建API密钥 - Algolia

    这里太坑了，请选用linux,win 就用git bash

  5. 打开一个Windows命令行(CMD)或Linux/macOS终端并切换当前目录到你的Hexo站点的根目录。 设置环境变量HEXO_ALGOLIA_INDEXING_KEY为上一步中创建的API Key。 hexo-algolia插件上传网站索引时会用到这个变量。

    Windows下：

    1
    2
    3
    4
    Windows命令行(CMD)

    C:\Users\you> cd path/to/your/hexo/site
    C:\Users\you> set HEXO_ALGOLIA_INDEXING_KEY="727fbd8c998fe419318fa350db6793ca"

    Linux/macOS下：

    1
    2
    3
    4
    Linux/macOS终端

    $ cd path/to/your/hexo/site
    $ export HEXO_ALGOLIA_INDEXING_KEY="727fbd8c998fe419318fa350db6793ca"

    然后，运行下面的命令来清理站点并上传网站索引到Algolia：

    1
    2
    3
    4
    Windows命令行(CMD)或Linux/macOS终端

    $ hexo clean
    $ hexo algolia

  6. 最后，在主题配置中设置搜索引擎为Algolia：

    1
    2
    3
    4
    themes/icarus/_config.yml

    search:
        type: algolia