環境需求: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 中的列表語法來表示文件的父子關係,如下:
對應的目錄就是下面這樣
是不是很簡單啊