创建新的仓库
创建新文件,名为SUMMARY.md,里面填入:
# Summary
* [前言](README.md)
创建一本书
首先进入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看看效果
绑定域名
原理和博客绑定域名是一样的
- 1· 在你的项目下新建一个CNAME文件,注意没有后缀名。在里面添加你的域名,如我的就是** leolan.top**,然后推送CNAME文件到远程仓库。(方法二是直接在pages页上找到域名绑定设置,最好同时绑定如:leolan.top和www.leolan.top,少绑一个,没绑的那个打不开)
- 2· 到域名服务商那里增加你的CNAME记录。添加两条记录,@和www的主机记录,记录类型为CNAME,记录值为
username.github.io.
,重要的是 io 后面还有一个原点(看官方帮助文档Coding的就不用加点),切记。
过几分钟,刷新网页,就能直接用域名访问了,因为是在项目内建的CNAME文件,所以域名直接指向此项目文件夹,其他项目可以用其他域名设定。
参考:GitBook入门(用github做出第一本书)
http://blog.csdn.net/hk2291976/article/details/51173850
评论区