gitbook 入門教程之實用外掛(持續更新)
disqus
評論外掛
discus 是一款整合 評論 的外掛,可以為靜態網站新增動態評論,讓你的網站動起來!
遺憾的是, discus
外掛只有 FQ 才能正常使用,暫時沒找到其他較好的替代方案.
註冊 disqus.com
賬號
gitbook
整合 disqus
外掛中最重要的配置項就是註冊 disqus.com
網站唯一標識.
註冊並繫結域名
如果沒有註冊賬號請先註冊,否則直接登入,當然也支援第三方賬號登入(我使用的是谷歌賬號).
人機驗證時,選出符合條件的全部圖形,直到沒有新的圖形為止,這一點和國內的靜態圖片驗證是不同的!
選擇安裝 disqus
外掛( I want to install Disqus on my site
),接下來會繫結整合網站的域名.
接下來設定網站的相關資訊,其中 網站名稱 ( snodreams1006
)是唯一標示,接下來整合到 gitbook
用的就是這個簡短名稱,而分類和語言按照實際情況選擇即可.
選擇服務型別
disqus
網站提供的服務型別,有基礎班( basic
),加強版( plus
),專業版( pro
)和免費版( free
).
每個版本計劃有不同的收費標準以及相應的服務,可以根據實際情況選擇適合自己的服務型別.
接下來以免費版為例進行有關演示
安裝並配置 disqus
到網站
估計是這些網站提供了預設的整合方式,這裡並沒看到 gitbook
相關的網站,因此選擇最後一個自定義網站.
填寫網站的基本資訊,其中網站縮寫名稱仍然是 snowdreams1006
,網址填寫 https://snowdreams1006.github.io/
,至於其他資訊根據實際情況填寫即可.
至此 disqus.com
網站配置完成,接下來我們配置 gitbook
整合 disqus
外掛.
安裝並配置 disqus
外掛
上一步我們已經獲取到唯一的標識: snowdreams1006
,接下來可以繼續配置 disqus
外掛了.
連結地址 : https://plugins.gitbook.com/p...
啟用外掛配置
在 book.json
中配置 disqus
外掛,根據實際情況修改成自己的縮寫名稱( shortName
).
示例:
{ "plugins": ["disqus"], "pluginsConfig": { "disqus": { "shortName": "snowdreams1006" } } }
安裝 disqus
外掛
示例:
$ gitbook install
測試 disqus
外掛
示例:
$ gitbook serve
正常情況下(FQ), disqus
外掛已經成功整合到 gitbook
網站了,因此推送到實際伺服器上時看到的效果是這樣的.
如果你不具備條件(FQ),那麼你看到的仍然是這樣的.
edit-link
編輯連結外掛
如果希望將網頁原始碼暴露出去並接受公眾的監督校準的話,使用 edit-link外掛 可以直接連結到原始碼檔案.
連結地址 : https://plugins.gitbook.com/p...
啟用外掛配置
在 book.json
中配置 edit-link
外掛,詳細說明請參考 edit-link 外掛 .
示例:
{ "plugins": ["edit-link"], "pluginsConfig": { "edit-link": { "base": "https://github.com/snowdreams1006/snowdreams1006.github.io/blob/master", "label": "編輯本頁" } } }
安裝 edit-link
外掛
示例:
$ gitbook install
測試 edit-link
外掛
如果不能正常跳轉到原始碼檔案,多次試驗後重新更改 edit-link.base
節點內容,重新 gitbook serve
即可正常跳轉原始碼檔案.
示例:
$ gitbook serve
github
外掛
新增 github
圖示連結,方便直接跳轉到 github
指定倉庫.
連結地址 : https://plugins.gitbook.com/p...
啟用外掛配置
在 book.json
中配置 github
外掛,詳細說明請參考 github 外掛 .
示例:
{ "plugins": ["github"], "pluginsConfig": { "github": { "url": "https://github.com/snowdreams1006/snowdreams1006.github.io" } } }
安裝 github
外掛
示例:
$ gitbook install
測試 github
外掛
示例:
$ gitbook serve