最簡潔好用的文件構建工具Gitbook的使用
阿新 • • 發佈:2018-12-18
GitBook 是一個基於 Node.js 的命令列工具,可使用 Github/Git 和 Markdown 來製作精美的電子書,目前gitbook可以支援生成靜態html和pdf文件
安裝使用
首先你需要安裝node.js的環境,然後便可以使用npm腳手架工具下載安裝gitbook工具
npm install gitbook-cli -g
或者使用cnpm淘寶的映象源
cnpm install gitbook-cli -g
安裝成功後,新建一個資料夾,此處為了方便演示,我們新建mybook資料夾
接著開始初始化gitbook專案
gitbook init
初始化成功後,可以看到目錄中生成了兩個檔案
其中SUMMARY.md是目錄文件,我們使用notepad++或者記事本開啟
此時,gitbook預設生成了一個標題叫Introduction的目錄,對應的文件是README.md。在這裡為了達到演示效果,新建一個文件
取名字叫content_01,然後使用記事本或notepad++開啟編輯
同時編輯SUMMARY.md檔案,新增如下內容
儲存後,在命令提示符中輸入
gitbook serve
在瀏覽器中開啟此地址,即可看到生成的文件
選擇“第一章”標題,檢視一下生成的文件內容
是不是很到玩呢?哈哈,如果有的小夥伴問二級目錄該怎麼生成呢?很簡單,只需要在目錄前加一個空格即可
執行效果如下:
最後,如果想生成html,放在伺服器上執行,怎麼辦?
gitbook build
此時,專案目錄下會生成_book資料夾,此資料夾中就是我們想要的html檔案
開啟_book資料夾
當然,此時若直接開啟index.html檔案是無法直接執行的,我們需要給它一個web環境,可以在本地啟動一個tomcat也可以啟動一個IIS,直接將_book資料夾中的內容丟進去即可