基於 GitBook 搭建個人部落格
為什麼這篇博文 會被 無情 移除首頁 ？？？？
基於 GitBook 搭建個人部落格
1.為什麼要寫部落格？
本人之前也在部落格園寫了一些，後面怕寫的一些文章是錯的，誤導他人，因此中斷了繼續寫。
繼續寫部落格的原因如下
- 只為記錄自己學習、思考、總結的過程
- 提高自己將事情講清楚的能力
- 積累更多的知識，在需要使用的時候方便查找。 好記性不如爛筆頭_
2.為什麼選擇使用 GitBook 來搭建？
1.正如上面所述，GitBook 更加方便管理且支援搜索，可以在有想要記錄的時候，打開編輯器記錄下，然後合適的時間分享（發布）下
2.GitBook 可以自己管理文章，想寫什麼想發什麼看自己心情，不用考慮平台限制等因素
3.GitBook 是有md靜態文件渲染出來的，基礎文件可遷移性強。
3.搭建方式
3.1 GitBook 線上直接搭建
線上網址搭建地址 傳送門 具體搭建教程可網上自行搜索，這裡就不做過多記錄。原因如下：
- 中國網路環境問題，導致 GitBook 網站經常打不開，需要使用代理才能訪問。
- 修改提交後，更新顯示有時間延遲。
3.2 由基於Node.js的命令工具開發
本人推薦使用這種方式，方便管理，配合自己的程式碼管理工具。簡直不要太完美。
涉及到的工具：Node.js ,gitbook-cli，編譯器 VS Code,Typora
Typora 下載地址：//typora.io/
3.2.1 安裝 GitBook 工具
-
打開
CMD終端，輸入npm install gitbook-cli -g命令進行全局安裝 -
安裝完成後，輸入
gitbook --version來查看是否安裝成功 第一次使用，cli 會自動安裝gitbook,安裝時間視網路環境而定，請耐心等待 -
若要卸載，就執行
npm uninstall gitbook-cli -g來刪除
由於我這裡已經安裝了，安裝完成可用以下命令查看。
3.2.2 新建項目(書)
首先需要創建項目跟文件夾，步驟如下：
mkdir BookRecord
cd BookRecord
gitbook init
gitbook init 命令是用於初始化項目的，會創建 README.md 和 SUMMARY.md 兩個項目必須的文件
-
README.md 是項目介紹文件，在運行後會固定展示在目錄頭部，tips:可以通過某種手動進行隱藏
-
SUMMARY.md 是項目的目錄菜單
若 SUMMARY.md 中目錄對應文件，則在執行gitbook init 時會自動創建。
3.2.3 本地啟動調式
本地啟動命令gitbook serve
執行該命令，會生成 _book 文件夾，這個文件夾是最終需要發布的文件夾。請自行在管理工具中忽略。
運行啟動後，可直接訪問ttp://localhost:4000,打開的第一個頁面,將是README.md頁面。
3.2.4 打包發布
執行gitbook build命令即可打包，打包後，在根目錄有一個 _book 文件夾，
將該文件夾發布至 Nginx 或者 存儲雲 或 Tomcat 都可以。
4. GitBook 配置文件說明
如果想要對項目做單獨的項目配置和使用其它插件，就需要使用配置文件進行配置。
在項目根目錄創建book.json文件，文件內容如下：
{
"author": "Levy",
"description": "This is record sharing by Levy.",
"extension": null,
"generator": "site",
"isbn": "",
"links": {
"sharing": {
"all": null,
"facebook": null,
"google": null,
"twitter": null,
"weibo": null
},
"sidebar": {
"Google": "//www.google.com"
}
},
"output": null,
"pdf": {
"fontSize": 12,
"footerTemplate": null,
"headerTemplate": null,
"margin": {
"bottom": 36,
"left": 62,
"right": 62,
"top": 36
},
"pageNumbers": true,
"paperSize": "a4"
},
"plugins": [],
"pluginsConfig": {
},
"language": "zh-hans",
"title": "Levy",
"variables": {},
"styles": {
"website": "assets/styles/website.css"
}
}
更多參數配置請參考：//github.com/GitbookIO/gitbook/blob/master/docs/config.md
插件配置查看另一篇文章 插件配置
