How GitBook(1)

记得第一眼看到GitBook时就知道它和我想做的在某些部分上相似，当然我们的技术远远没有他们强，不过这只限于技术，而非理念。

在GitBook，你可以通过三种方式创建自己的开源Markdown电子书项目，并把电子书生成静态网站，或者PDF，ePub，Mobi。

方法一：注册GitBook用户并在线写书，书可以push到你的Github仓库，或者直接在GitBook上阅读和发布，当然也可以下载成PDF等格式，不再赘述。

---

方法二：下载GitBook-editor。这只是一个桌面编辑器，跟方法一没什么区别，所以也没太多可说的。

---

方法三：通过GitBook命令行构建自己的电子书。这是今天的主要话题，要这样做有几个原因：

• 希望电子书发布在自己的网站上
• 不喜欢GitBook提供的MarkDown编辑器
• 希望对静态(书)网站做一些动态扩展，比如中文搜索、行内点评等

以下介绍步骤(windows平台)：

(1)cmd

(2)创建文件夹并进入：md gitbook && gitbook。

(3)全局模式安装GitBook：npm i -g gitbook-cli。

(4)初始化电子书框架：gitbook init 此操作会在gitbook目录下构建两个文件 README.md 和 SUMMARY.md。

README.md是此书的卷首语，SUMMARY.md是章节列表

(4)修改SUMMARY.md内容为正确的章节列表，Markdown工具自选。内容类似如下，不解释。

* [简介](README.md)

* [第一章](chapter1/README.md)

 - [第一节](chapter1/section1.md)

 - [第二节](chapter1/section2.md)

* [第二章](chapter2/README.md)

 - [第一节](chapter2/section1.md)

 - [第二节](chapter2/section2.md)

- [第三节](chapter2/section2.md)

(5)再次 gitbook init 此时会根据SUMMARY.md生成chapter1这些章节文件夹。

(6)开始在各章节里用Markdown语法完成你的文章吧。

(7)编译静态网站：gitbook build 此操作会在gitbook文件夹下生成_book这个文件夹，这就是一个静态网站，你可以copy到任何服务器中，比如apache。然后http://localhost/……

(8)如果你安装有node，gitbook serve 可以很方便地搭建一个node服务器。

D:\gitbook>gitbook serve
Live reload server started on port: 35729
Press CTRL+C to quit ...

info: loading book configuration....OK
info: load plugin gitbook-plugin-search-pro ....OK
info: load plugin gitbook-plugin-highlight ....OK
info: load plugin gitbook-plugin-sharing ....OK
info: load plugin gitbook-plugin-fontsettings ....OK
info: load plugin gitbook-plugin-livereload ....OK
info: >> 5 plugins loaded
info: start generation with website generator
info: clean website generatorOK
info: generation is finished

Starting server ...
Serving book on http://localhost:4000

静态服务器的搭建到此为止，不过我们还有很多事情要做，前方有无数的坑等着我们，比如生成pdf、ePub、Mobi；又比如我们想加入一些插件，方便我们更好阅读电子书；再比如说，我们需要加入行内点评系统，看看漂亮的medium 。

下次见。