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 中的列表語法來表示文件的父子關係,如下:

對應的目錄就是下面這樣

 

 是不是很簡單啊

 

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章