gitbook教程

gitbook的用途

配合使用 GitBook + Typora + Git

安裝

npm install -g gitbook-cli
複製代碼

使用

gitbook init
複製代碼

生成文件

README.md —— 書籍的介紹寫在這個文件裏
SUMMARY.md —— 書籍的目錄結構在這裏配置
複製代碼

.md文件用Typora來編輯，能夠打開當前文件夾

demo

編輯SUMMARY.md文件，內容修改成：

# 目錄

* [前言](README.md)
* [第一章](Chapter1/README.md)
  * [第1節：衣](Chapter1/衣.md)
  * [第2節：食](Chapter1/食.md)
  * [第3節：住](Chapter1/住.md)
* [第二章](Chapter2/README.md)
複製代碼

保存後在命令行再次執行

gitbook init
複製代碼

它會根據SUMMARY.md的索引自動生成目錄

預覽

gitbook serve
複製代碼

執行命令後會對 Markdown 格式的文檔進行轉換，默認轉換爲 html 格式，最後提示 「Serving book on http://localhost:4000」。打開瀏覽器：

你也能夠指定端口

gitbook serve --port 9999
複製代碼

輸出

默認快出路徑爲_book

gitbook build
或 gitbook build [書籍路徑] [輸出路徑]
複製代碼

如輸出到docs文件夾

gitbook build . docs
複製代碼

生成其餘格式電子書（如.pdf）

pdf格式：gitbook pdf ./ ./mybook.pdf
epub格式：gitbook epub ./ ./mybook.epub
mobi格式：gitbook mobi ./ ./mybook.mobi
複製代碼

若是是要導出PDF，ePub或者mobi格式的電子書時，須要安裝Calibre電子書閱讀/管理器和命令行工具，否則可能會報錯「EbookError: Error during ebook generation: 'ebook-convert'」。