我最近接触到gitbook,发现它支持markdown和git,恰好把我以前在github上的笔记能够生成一本书,因而我就开始着手捣鼓gitbook,一下午的时间就弄的差很少了,说明这个东西仍是挺容易的,能够看看个人书:
《LeetBook(LeetCode详解)》。git
比较建议直接在github上部署你的框架,而后再导入gitbook。github
建立过程不须要我细讲了把,若是不知道,看看github入门markdown
建立一个新文件,名为SUMMARY.md,里面填入:框架
# Summary * [前言](README.md)
首先进入gitbook的官网:https://www.gitbook.com/.net
点红色部分,用github登陆code
登陆以后,点+NewBookblog
点到github,点击Link to your Github部署
受权完毕而后再点到这个页面get
选择你须要导入的仓库,咱们用刚才建立的testbook,而后标题能够本身取,下面的地址只能填英文,而后点建立同步
这个页面目前是在同步,等同步完毕后,就能够看到本身的书了。
能够点击read
能够发现里面就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看看效果