GitBook的使用方式，快速建立網頁文檔

環境需求：node npm 得裝好

-----------------------------------

我一開始不知道得先裝gitbook-cli

先執行了 npm install gitbook -g

而後執行 gitbook -V   報了個錯：

You need to install "gitbook-cli" to have access to the gitbook command anywhere on your system.
If you've installed this package globally, you need to uninstall it.
>> Run "npm uninstall -g gitbook" then "npm install -g gitbook-cli"

而後我沒npm uninstall -g gitbook 

就直接npm install -g gitbook-cli

結果執行：gitbook -V  始終顯示在安裝gitbook

以後uninstall 也卸載不了，只好去npm的目錄下，把gitbook和gitbook-cli在npm的目錄文件裏刪了，最後從新先執行：npm install -g gitbook-cli

而後執行：gitbook -V，就自動開始安裝gitbook了

而後再執行： gitbook  -V，這時候顯示以下，安裝成功！

--------------------------------這時候能夠開始建立寫網頁文檔模板了------------------------------------

新建一個你要寫網頁文檔的文件夾

在當前文件夾下啓動cmd執行：gitbook init

建立成功，這時候咱們能夠看見文件夾下出現了兩個文件README.md 和 SUMMARY.md 

 

README.md 是說明文檔，而 SUMMARY.md 其實就是書的章節目錄

接下來，咱們執行：gitbook serve ，而後在瀏覽器地址欄中輸入 http://localhost:4000 即可預覽書籍。

瀏覽器顯示：

這時候咱們能夠看見在gitbook文件夾中生成一個 _book 文件夾, 裏面的內容即爲生成的 html 文件

 

當咱們不想開啓服務器，能夠執行：gitbook build

這時候咱們就能夠直接本地打開_book文件夾下的index.html

 

SUMMARY.md

這個文件主要決定 GitBook 的章節目錄，它經過 Markdown 中的列表語法來表示文件的父子關係，以下：

對應的目錄就是下面這樣

 

 是否是很簡單啊