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
參考資料: