gitbook的下載和使用

 

GitBook 准備工作

安裝 Node.js

GitBook 是一個基於 Node.js 的命令行工具，下載安裝 Node.js，安裝完成之后，你可以使用下面的命令來檢驗是否安裝成功。

$ node -v
v7.7.1

安裝 GitBook

輸入下面的命令來安裝 GitBook。

$ npm install gitbook-cli -g

安裝完成之后，你可以使用下面的命令來檢驗是否安裝成功。

$ gitbook -V
CLI version: 2.3.2
GitBook version: 3.2.3

GitBook 准備工作做好之后，我們進入一個你要寫書的目錄，輸入如下命令。

$ gitbook init
warn: no summary file in this book
info: create README.md
info: create SUMMARY.md
info: initialization is finished

可以看到他會創建 README.md 和 SUMMARY.md 這兩個文件，README.md 應該不陌生，就是說明文檔，而 SUMMARY.md 其實就是書的章節目錄，其默認內容如下所示：

# Summary

* [Introduction](README.md)

接下來，我們輸入 $ gitbook serve 命令，然后在瀏覽器地址欄中輸入 http://localhost:4000 便可預覽書籍。

 

運行如下命令后會在書籍的文件夾中生成一個 _book 文件夾, 里面的內容即為生成的 html 文件，我們可以使用下面命令來生成網頁而不開啟服務器。

gitbook build

增加目錄結構：修改：SUMMARY.md

# Summary

* [Introduction](README.md)
* [Part I](part1/README.md)
    * [Writing is nice](part1/writing.md)
    * [GitBook is nice](part1/gitbook.md)
* [Part II](part2/README.md)
    * [We love feedback](part2/feedback_please.md)
    * [Better tools for authors](part2/better_tools.md)

GitBook 基本的目錄結構如下所示：

├── book.json
├── README.md
├── SUMMARY.md
├── chapter-1/
|   ├── README.md
|   └── something.md
└── chapter-2/
    ├── README.md
    └── something.md

可以下載Typora來編寫.md文件

https://www.typora.io/