hexo-search-use-Algolia

 

步驟如下

一、申請 Algolia 帳號

 

 

 

 

二、進入 Algolia dashboard 設定

進入 dashboard,它會要求你 「Create Index」

那就創一個 index name 吧,名稱應該可以隨意。

新增完之後,請先知道你有 Application ID、Search-Only API Key、Admin API Key。

 

三、Hexo Config

於設定 site root directory 裡的 _config.yml,請新增如下參數,

並將 Application ID、Search-Only API Key、Admin API Key 填入,

而 indexName,就是你之前所創的 index name。

# algolia
algolia:
  appId: "" ## applicationID
  applicationID: "" ## applicationID
  apiKey: "" ## Search-Only API Key
  adminApiKey: "" ## Admin API Key
  chunkSize: 5000
  indexName: "my-hexo-blog"
  fields:
    - content:strip:truncate,0,500
    - excerpt:strip
    - gallery
    - permalink
    - photos
    - slug
    - tags
    - title

注意,appId 就是等於 applicationID,差異的是,

appId 是 algolia 在用的,而 applicationID 是 hexo-algoliasearch 套件在用的(之後會提到),

缺一不可。

 

四、Next Config

於 theme root directory 裡的 _config.yml,找到如下項目,並修改如下

algolia_search:
  enable: true
  hits:
    per_page: 10
  labels:
    input_placeholder: 搜尋文章 & 內容
    hits_empty: "找不到您輸入的關鍵字: ${query}"
    hits_stats: "找到了 ${hits} 筆結果,花了 ${time} ms"

注意,如之前已開啟其他 search 套件,請記得 disable 他。

 

五、Algolia Module

於 site root directory 下安裝 hexo-algoliasearch 套件,請執行如下指令

$ npm install hexo-algoliasearch --save

 

使用 hexo-algoliasearch 套件來上傳索引到 algolia,請依序打下列指令

$ npx hexo clean

$ npx hexo generate

$ npx hexo algolia

如果成功的話,則不會有什麼錯誤訊息發生

 

最後記得再把你的 blog 再次部署上去,即可

$ npx hexo deploy

 

參考資料:

LouisBarranqueiro/hexo-algoliasearch

將 Hexo NexT 改成 Algolia 搜尋

[實作] 讓 Google 能搜尋到自己的 Hexo Blog