gitbook writing organization and management

1、git

Powerful version management, but also for updating the management of written content.

2、markdown

git manage text, so the transition from writing docx format to markdown.

And typora is a relatively easy to use markdown writing instruments, markdown also provides turn docx functions.

3、gitbook

Organizational structure of the text. You can also preview, making e-books.

 

gitbook use:

1, the installation, the global installed

npm install -g gitbook-cli

2, start, document organization

gitbook heat

In the corresponding directory, execute the command, and return generating README.md SUMMARY.md

• The most important thing is SUMMARY.md, the directory structure of the books configured here.
• File format md, markdown files.

3, edit the document structure

SUMMARY.md edit documents, forms markdown link. E.g:

* [Preface] (README.md) 
* [Chapter] (Chapter1 / README.md) 
  * [Section 1: Yi] (Chapter1 / clothing .md) 
  * [Section 2: Food] (Chapter1 / food. MD) 
  * [section 3: live] (Chapter1 / stay .md) 
  * [section 4: OK] (Chapter1 / line .md) 
* [Chapter] (Chapter2 / README.md) 
* [Chapter III ] (Chapter3 / README.md) 
* [Chapter] (Chapter4 / README.md)

Note links

Execution gitbook init command again, it will update the document structure, generate the corresponding directories and files.

4, using markdown tool written document

Typora is WYSIWYG (real-time rendering) of Markdown editor:  https://typora.io/

5, the preview text

gitbook serve
gitbook serve --port 2333 

 Execute the command preview.

gitbook will Markdown document format conversion, convert html format by default, generate documents in _book directory.

A final note "the Serving Book ON  HTTP: // localhost: 4000 ", open the browser view.

6, custom conversion.

gitbook build [Books path] [Output Path] 
gitbook PDF. / ./ mybook.pdf 
gitbook EPUB. / ./mybook.epub

7, git version control

Text format, you can use git manage versions of the directory.