tags: solution
what
gitbook是什么？
gitbook是用来写电子书的，公开的电子书别人也能看到，私有的电子书需要付费才能写。上面有很多高质量的电子书，比如李笑来的《新生.七年就是一辈子》。
how
使用很简单。
-
首先去它的官网注册一个账号。
注册完毕，登录进去新建一本书。根据需要选择电子书类型，一般选择第一个就好了。
enter description here -
电子书创建完毕后就可以编辑了。
enter description here -
右键点击空白处可以选择添加一个章节或者一篇文章。
enter description here -
点击右下角的问号可以切换到markdown模式。
enter description here GitBook Editor
gitbook有一个编辑器客户端，界面和网页版一样。
OK，你已经可以动手去写自己的电子书了。
==如果你不是一个码农，下面的内容可以不看了。==
gitbook工具以及gitbook平台
gitbook其实有两个概念：一是gitbook工具，可以在本地使用它发布电子书服务；二是gitbook电子书平台，这个平台使用git管理你的文章并用gitbook工具帮你发布服务。两者的关系类似git和github。
gitbook本身也是开源项目，仓库在这里。上面有官方的使用说明文档。
本地使用gitbook工具
如有需要，直接查看官方文档。
照我的做也一样。
- 安装nodejs。直接百度搜索，下载安装之。
- 打开windows的命令行，win10用户直接右键开始菜单选择"Windows PowerShell"。输入
npm install gitbook-cli -g - 在你的电脑磁盘上新建一个文件夹，例如"newbook"。然后创建一个
"README.md"和一个"SUMMARY.md"，这两个文件是必须的。 -
SUMMARY.md里描述了电子的目录结构。修改其内容如下：
# Summary
* [Introduction](README.md)
* [chapter1](c1/README.md)
* [c1.1](c1/c1.1.md)
* [c1.2](c1/c1.2.md)
* [chapter2](c2/README.md)
- 中括号里的是会显示在电子书目录上的名字，小括号里具体对应的文件。==除了前面两个文件，其他文件不需要你创建，执行
gitbook init后自动创建出来。
enter description here - 可以使用
tree命令查看当前电子书结构 。
enter description here - 确认无误后就可以执行
gitbook server启动服务了。服务启动成功后就可以在浏览器里输入http://localhost:4000进行查看。
enter description here - 效果如下：
使用git管理电子书
gitbook平台是以git的形式存放电子书内容的。电子书对应的Edit旁的倒三角，可以获得其git链接。
然后就可以git克隆到本地进行操作了。
gitbook可以绑定到github
这部分的官网文档在这里。
首先，你需要去github新建一个仓库。
然后，进入电子书的SETTING页面，选择GitHub。
如果你没有绑定过github，会先提示你去github安装gitbook的服务。
点击后去gitbub安装gitbook服务。
选择要给gitbook开通权限的仓库（前面已经创建好）。
这个时候再回到gitbook的github绑定界面，就会提示gitbook已经和github同步了。两者任一的改动都会同步到另一个。
看云
看云是国内版的gitbook，由于服务器在国内，网络更好，而且有些操作更方便。因为gitbook一样都是用git管理文章的，所以以后也可以clone下来，不用担心数据在他们平台绑死。
