GitBook + github高效写书

比较建议直接在github上部署你的框架，然后再导入gitbook。

创建一个新的仓库

image.png

勾选创建一个readme文件，再点击红色框 create new file

image.png

创建一个新文件，名为SUMMARY.md，里面填入：

# Summary
* [前言](README.md)

image.png

提交更改

image.png

创建一本书

首先进入gitbook的官网：https://www.gitbook.com/

image.png

点github登录

登录之后，点左下角

image.png

进入下面的界面，可以创建和管理项目（书本）

image.png

点击左侧红框中的按钮，选择你需要导入的仓库，我们用刚才创建的# python3Scrapy
，耐心等待。

image.png

拉取列表，选择全部即可，进入线面页面，选择需要关联的项目。

image.png

image.png

由于我们是在GitHub提交的文件，第一次应该是GitHub同步过来，于是选择第一个

image.png

image.png

这个页面目前是在同步，等同步完毕后，就可以看到自己的书了。

image.png

可以发现里面就1页，就是我们刚才SUMMARY.md写的内容.

接下来可以更改书本标题。

image.png

增加内容

点击右下角红框进入编辑状态。

image.png

可以增加页面

image.png

也可以直接导入wiki等页面

image.png

这里需要特别注意的是，每次编写文字之后，需要手动你那个点击右下角的绿色勾，才会保存到gitbook

image.png

但是不会自动push到GitHub，需要手动点击一下merge

image.png

然后你会发现在github上也多了一个文件，这就关联起来了。

image.png

我们再看SUMMARY里面多了一个“第一章”的目录结构

image.png

我们双击一下，发现就是markdown的超链接，原来这就是gitbook的内容组织方式，通过超连接把内容和github上文件关联起来。

我们修改一下名字，然后把他缩进一个tab，可以发现目录结构变了，然后名字也变了

通过修改SUMMARY.md你可以轻松的组织你的书

书的框架

一般来说，你的书得有一个README.md和一个SUMMARY.md。
其中SUMMARY.md是最重要的，它代表了整个书的框架，也是我们主要需要修改的地方。

当你考虑好要写一本书，你可以先粗略的想好大概要分几部分，对这几部分弄一个文件夹。然后把对应的markdown文件放进去。

然后push到github上，然后再在gitbook上修改SUMAARY使得新加的文件得以跟gitbook关联

关于地址的获取有个小诀窍，就是点击文件，邮件，有个重命名，这里可以看到文件的完整地址，复制就好。