gitbook組織管理書寫

一、git

強大的版本管理工做，也適合對書寫內容的更新管理。

二、markdown

git管理文本，因此書寫要從docx格式轉變成markdown.

而typora是一個比較好用markdown書寫工具，還提供的markdown轉docx等功能。

三、gitbook

是組織文本結構的。還能夠預覽、製做電子書。

 

gitbook使用過程：

一、安裝，全局安裝

npm install -g gitbook-cli

二、開始，文檔組織

gitbook init

在對應目錄下，執行該命令，回生成README.md 和 SUMMARY.md

• 最重要的就是SUMMARY.md，書籍的目錄結構在這裏配置。
• 文件格式md，markdown文件。

三、編輯文檔結構

編輯 SUMMARY.md 文件，markdown連接的形式。例如：

* [前言](README.md)
* [第一章](Chapter1/README.md)
  * [第1節：衣](Chapter1/衣.md)
  * [第2節：食](Chapter1/食.md)
  * [第3節：住](Chapter1/住.md)
  * [第4節：行](Chapter1/行.md)
* [第二章](Chapter2/README.md)
* [第三章](Chapter3/README.md)
* [第四章](Chapter4/README.md)

注意的連接

再次執行gitbook init命令，會更新文檔結構，生成對應的目錄和文件。

四、使用markdown工具書寫文檔

Typora 是所見即所得（實時渲染）的 Markdown 編輯器: https://typora.io/

五、預覽文本

gitbook serve
gitbook serve --port 2333 

 執行該命令進行預覽。

gitbook會對 Markdown 格式的文檔進行轉換，默認轉換爲 html 格式，生成文檔在 _book目錄下。

最後提示 「Serving book on http://localhost:4000」，打開瀏覽器查看。

六、自定義轉換。

gitbook build [書籍路徑] [輸出路徑]
gitbook pdf ./ ./mybook.pdf
gitbook epub ./ ./mybook.epub

七、git版本管理

文本格式，能夠對這個目錄用git管理版本。