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
