gitBook

gitBook搭建

1、安装node.js

由于gitBook依赖于node.js,因此首先需要安装node.js,node.js安装下载 https://nodejs.org/en/

cmd命令行安装node.js

npm install -g gitbook-cli

安装gitBook后,就会多出一个gitBook命令

2、安装Typora（很好的支持macOs\windows\Linux的markdown编辑工具）

下载地址：https://typora.io/

3、Git安装

下载地址https://git-scm.com/downloads
安装git可以进行编辑的文件版本管理

4、快速使用

首先需要创建一个文件夹例：myBook，然后cmd切换到myBook文件夹下，执行

gitbook init

进行初始化，文件夹下会看到两个文件

README.md —— 书籍的介绍写在这个文件里
SUMMARY.md —— 书籍的目录结构在这里配置

然后启动Typora对这两个文件进行编辑,首先readme.md中进行前言编写

在summary.md中进行目录编写

* [前言](README.md)
* [第一章](Chapter1/README.md)
  * [第1节：安装node.js](Chapter1/安装node.js.md)
  * [第2节：安装Typora](Chapter1/安装Typora.md)
  * [第3节：安装Git](Chapter1/安装Git.md)
  * [第4节：进行使用](Chapter1/进行使用.md)
* [第二章](Chapter2/README.md)
* [第三章](Chapter3/README.md)
* [第四章](Chapter4/README.md)

让后再次切换到myBook文件夹下，执行

gitbook init

GitBook会查找SUMMARY.md文件中描述的目录以及文件,如果没有则会进行创建。然后我们对每一个文件我们就可以进行编辑了。

5、预览gitBook

通过执行 gitbook serve我们可以通过浏览器来预览gitBook，我们可以通过 http://localhost:4000
来预览书籍

6、构建书籍

可以通过bulid命令可以指定路径 gitbook build [书籍路径] [输出路径]

serve命令指定端口 gitbook serve --port 8008

生成PDF格式的电子书 gitbook pdf ./ ./mybook.pdf

生成epub 格式的电子书 gitbook epub ./ ./mybook.epub

生成mobi格式电子书 gitbook mobi ./ ./mybook.mobi

7、使用Git做版本管理

在 mybook 目录下执行git init 初始化仓库，执行 git remote add 添加远程仓库（你得先在远端建好）。接着就可以 commit，push，pull …

最后

gitBook的安装以及使用就结束了