GitBook入门(用github作出第一本书)——超详细配图说明

我最近接触到gitbook,发现它支持markdown和git,恰好把我以前在github上的笔记能够生成一本书,因而我就开始着手捣鼓gitbook,一下午的时间就弄的差很少了,说明这个东西仍是挺容易的,能够看看个人书:
《LeetBook(LeetCode详解)》git

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

建立一个新的仓库

Alt text

建立过程不须要我细讲了把,若是不知道,看看github入门markdown

Alt text

建立一个新文件,名为SUMMARY.md,里面填入:框架

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

建立一本书

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

Alt text

点红色部分,用github登陆code

登陆以后,点+NewBookblog

Alt text

点到github,点击Link to your Github部署

Alt text

受权完毕而后再点到这个页面get

Alt text

选择你须要导入的仓库,咱们用刚才建立的testbook,而后标题能够本身取,下面的地址只能填英文,而后点建立同步

Alt text

这个页面目前是在同步,等同步完毕后,就能够看到本身的书了。

Alt text

能够点击read

Alt text

能够发现里面就1页,就是咱们刚才SUMMARY.md写的内容

Alt text

增长内容

咱们退回上一步,点edit

Alt text

能够看到以下界面

Alt text

咱们点开Alt text

能够同步显示编辑后的效果

Alt text

如今咱们就能够完成咱们的书的录入了,在目录区点击右键,能够新建一个内容页

Alt text

而后点击一下,会提示建立一个文件

Alt text

而后你会发如今github上也多了一个文件,这就关联起来了。

Alt text

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

Alt text

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

Alt text

咱们修改一下名字,而后把他缩进一个tab,保存看看有什么变化

Alt text

能够发现目录结构变了,而后名字也变了

Alt text

经过修改SUMMARY.md你能够轻松的组织你的书

书的框架

通常来讲,你的书得有一个README.md和一个SUMMARY.md。
其中SUMMARY.md是最重要的,它表明了整个书的框架,也是咱们主要须要修改的地方。

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

Alt text

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

Alt text

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

Alt text

最后,能够在本身的书的主页点击read看看效果

Alt text

相关文章
相关标签/搜索