gitbook write a book, the basic knowledge you should know

Gitbook is tool to write a book, which support the simple language markdown.

We can write it offline.

• first step to install gitbook

npm install gitbook-cli -g

• create a fold to put the book

mkdir book1
cd book1

• init a gitbook

gitbook init

• edit the summary.md file

• create the book

gitbook build

• check the book

gitbook serve

When you update the summary, you can add the md file in the folder and modify the corresponding summary file. Then, you can update the file.

off course you can generate other format:

gitbook pdf ./ ./mybook.pdf
gitbook epub ./ ./mybook.epub
gitbook mobi ./ ./mybook.mobi

Before the command, you need to install the calibre software, and put the calibre as the user path. Ohterwise, you will get a ebook-convert error.

EbookError: Error during ebook generation: 'ebook-convert' is not recognized as an internal or external command, operable program or batch file.

Reference:

• windows 系统 GitBook生成PDF、epub报错Error during ebook generation: 'ebook-convert' 乱码_山岚突起，际会风云-CSDN博客
  https://blog.csdn.net/zhouvip666/article/details/90709591
• https://github.com/GitbookIO/gitbook
• https://docs.gitbook.com/editing-content/markdown