使用gitbook写电子书

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
• 效果如下：

enter description here

使用git管理电子书

gitbook平台是以git的形式存放电子书内容的。电子书对应的Edit旁的倒三角，可以获得其git链接。

enter description here

然后就可以git克隆到本地进行操作了。

gitbook可以绑定到github

这部分的官网文档在这里。

首先，你需要去github新建一个仓库。

然后，进入电子书的SETTING页面，选择GitHub。

enter description here

如果你没有绑定过github，会先提示你去github安装gitbook的服务。

enter description here

点击后去gitbub安装gitbook服务。

enter description here

选择要给gitbook开通权限的仓库（前面已经创建好）。

enter description here

这个时候再回到gitbook的github绑定界面，就会提示gitbook已经和github同步了。两者任一的改动都会同步到另一个。

enter description here

看云

看云是国内版的gitbook，由于服务器在国内，网络更好，而且有些操作更方便。因为gitbook一样都是用git管理文章的，所以以后也可以clone下来，不用担心数据在他们平台绑死。