Skip to content

Latest commit

 

History

History
63 lines (52 loc) · 2.38 KB

zh-TW.md

File metadata and controls

63 lines (52 loc) · 2.38 KB

hexo-tag-fb-comments

正體中文(zh-TW)| English (en-US)

Facebook comments plugin for Hexo!

需求

  • Hexo 5 或更新的版本

使用方式

安裝套件

如果你使用 npm:

npm i hexo-tag-fb-comments

如果你使用 yarn:

yarn add hexo-tag-fb-comments

其他的請自行依照所使用的套件管理器指令安裝。

設定

設定檔

請在專案根目錄的 _config.yml 中加入下列設定:

fb_comments:
  enabled: true

至少要這樣,FB 留言外掛才會啟用。但個人推薦再加入 app_id 才可以統一管理留言。完整可設定的範例如下:

fb_comments:
  enabled: true  # 是否開啟 FB 留言外掛
  to: post  # 有 post、page 或 default(全部)等,詳細選項請參考 hexo injector
  app_id:   # FB 應用程式編號
  lang: zh_TW  # 語言
  num_posts: 5  # 顯示幾則留言
  order_by: reverse-time  # 留言排序依據,有 time 和 reverse-time
  colorscheme: light  # 介面風格,有 light 和 dark 可選
  width: 100%  # 寬度

各參數對應的臉書設定細節請參考:https://developers.facebook.com/docs/plugins/comments/

文章或頁面

請在想顯示 FB 留言外掛的地方,放上下面這個標籤:

{% fb_comments %}

如果嫌每次都要加麻煩的話,可以在鷹架(scaffolds)中直接修改產生文章的模板,以後產生指定 layout 的 md 時就會自動附在裏頭。

和其他外掛的不同

多數外掛都會要你修改主題檔案,但如果你使用的主題語言不是很多人使用的 EJS 或是和各路教學文不同,那就 GG 了;或是採用 HEXO 5 新方法──npm 安裝主題,那也 GG 了,根本不可能去修改 node_modules 的主題(更何況有些還是自動部署上去才安裝套件的)在某天發現一些 Hexo API,靈機一動之下想出了不用改動模板就能鑲嵌(發音同「千」別再念錯了!!)FB 留言板的方式,也幸運的實作出來,希望電腦前的你會喜歡。

特別感謝

感謝以下偉大的前人,才有今天這個套件的誕生:

LICENSE

MIT License