如何用gitbook寫書

2021-07-08 09:50:14 字數 2849 閱讀 4860

生成一本小書,它有前言,章節1,章節2,後記。例如:

簡介

第一章:如何造火箭

1. 燃料學

2. 空氣動力學

3. **工程學

第二章:如何**火箭

1. 自動控制原理

2. 二次利用要點

結束

建乙個寫書的目錄,以後所有工作都在這個目錄下搞。例如

/users/raywill/gitbook/first
在電腦上建立整本書的目錄結構,以及檔案結構。

我們可以自己一步步用檔案管理器新建資料夾新建檔案,不過這麼做太累了,gitbook可以幫我們自動生成。我們需要做的是提供乙個叫做summary.md的檔案給gitbook,然後呼叫

gitbook init
就能自動生成目錄結構及每個章節的markdown檔案。

我們先為我們的新書寫summary.md,內容如下:

[簡介](readme.md)

* [第一章:如何造火箭](ch1/build.md)

- [1. 燃料學](ch1/fuel.md)

- [2. 空氣動力學](ch1/air.md)

- [3. **工程學](ch1/enginer.md)

- [小結](ch1/wrapup.md)

* [第二章:如何**火箭](ch2/recycle.md)

- [1. 自動控制原理](ch2/ac.md)

- [2. 二次利用要點](ch2/key.md)

* [結束](end/summary.md)

寫好後,執行

gitbook init
可以看到螢幕輸出如下:

raywill:first raywill$ gitbook init

info: init book at /users/raywill/gitbook/first

info: detect structure from summary (if it exists)

info: create readme.md

info: create ch1/build.md

info: create ch1/fuel.md

info: create ch1/air.md

info: create ch1/enginer.md

info: create ch1/wrapup.md

info: create ch2/recycle.md

info: create ch2/ac.md

info: create ch2/key.md

info: create end/summary.md

info: initialization is finished

done, without error

可見,gitbook按照我們的要求,幫我們生成好了所有檔案。生成的檔案結構如下:

.

├── readme.md

├── summary.md

├── ch1

│ ├── wrapup.md

│ ├── air.md

│ ├── build.md

│ ├── enginer.md

│ └── fuel.md

├── ch2

│ ├── ac.md

│ ├── key.md

│ └── recycle.md

└── end

└── summary.md

每個檔案的第一行就是我們寫的章節標題。

執行如下命令生成pdf格式電子書:

gitbook pdf .
命令由三部分組成:命令(gitbook),生成的格式(pdf),markdown原始檔位置(.,點表示當前目錄)。

命令執行後可以看到如下輸出,表示生成pdf成功。這時候,目錄裡面多了乙個pdf檔案。

raywill:first raywill$ gitbook pdf .

info: loading book configuration....ok

info: load plugin gitbook-plugin-highlight ....ok

info: load plugin gitbook-plugin-search ....ok

info: load plugin gitbook-plugin-sharing ....ok

info: load plugin gitbook-plugin-fontsettings ....ok

info: >> 4 plugins loaded

info: start generation with pdf generator

info: clean pdf generatorok

info: write summary.html

info: start conversion to pdf ....ok

info: generation is finished

info: >> 1 file(s) generated

done, without error

如果希望生成epub或者mobi格式的,分別執行下面的命令即可:

gitbook epub .
gitbook mobi .

如何部署gitbook

環境 部署gitbook的系統 centos linux 64 依賴 以下命令如果not found,須預先安裝.git command not found yum install gitnpm command not found yum install npm 開始 npm install yar...

如何使用gitbook建立文件web頁面

2 進入cmd或powershell裡,進入專案資料夾 然後npm install g gitbook cli 安裝完可檢視版本 gitbook v 3 執行完後,你會看到多了兩個檔案 readme.md 和 summary.md,它們的作用如下 4 用編輯器開啟newbook資料夾 我用的vsco...

如何用軟文推廣

如何用軟文推廣呢?2 作為 魚餌 讓客戶通過付出一些行動,比如幫忙推廣10個ip,或者通過加qq,留下郵箱 手機號等方式,獲得大量的精準潛在客戶資料庫,最大化軟文的效率。高質量軟文製作技巧 寫作軟文前,一定要做好規劃,明確軟文推廣要達到的目的,了解消費者的對產品的各種問題和顧慮,針對性的提出解決方案...