用github写开源书籍

用github写开源书籍

gitbook

http://blog.csdn.net/hk2291976/article/details/51173850

用github写书籍

创建一个新的仓库

创建新文件，SUMMARY.md

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

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

• 1
• 2

• 1
• 2

创建一本书

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

点红色部分，用github登录

登录之后，点+NewBook(或在右上角+NEW，页面稍有改版)

这个页面目前是在同步，等同步完毕后，就可以看到自己的书了（不是什么原因这里会一直是这个界面不会跳转，但其实收到了通知邮件已经创建好了，打开主页刷新就可以看到）。

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

增加内容

我们退回上一步，点edit

可以看到如下界面

我们点开

可以同步显示编辑后的效果，预览效果。

现在我们就可以完成我们的书的录入了，在目录区点击右键，可以新建一个内容页

然后点击一下，会提示创建一个文件

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

我们再看SUMMARY里面多了一个“第一页”

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

我们修改一下名字，然后把他缩进一个tab，保存看看有什么变化

可以发现目录结构变了，然后名字也变了

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

书的框架

一般来说，你的书得有一个README.md和一个SUMMARY.md。 

其中SUMMARY.md是最重要的，它代表了整个书的框架，也是我们主要需要修改的地方。

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

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

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

最后，可以在自己的书的主页点击read看看效果

Github绑定域名

原理和博客绑定域名是一样的

链接：http://blog.csdn.net/lan842632/article/details/52846689

个人学习笔记，不当之处还请指正。
----------不定期更新------------