1. 程式人生 > >最簡潔好用的文件構建工具Gitbook的使用

最簡潔好用的文件構建工具Gitbook的使用

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資料夾中的內容丟進去即可