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

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

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

创建一个新的仓库

Alt text
Alt text

创建过程不需要我细讲了把,如果不知道,看看github入门

Alt text
Alt text

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

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

创建一本书

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

Alt text
Alt text

点红色部分,用github登录

登录之后,点+NewBook

Alt text
Alt text

点到github,点击Link to your Github

Alt text
Alt text

授权完毕然后再点到这个页面

Alt text
Alt text

选择你需要导入的仓库,我们用刚才创建的testbook,然后标题可以自己取,下面的地址只能填英文,然后点创建

Alt text
Alt text

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

Alt text
Alt text

可以点击read

Alt text
Alt text

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

Alt text
Alt text

增加内容

我们退回上一步,点edit

Alt text
Alt text

可以看到如下界面

Alt text
Alt text

我们点开
Alt text
Alt text

可以同步显示编辑后的效果

Alt text
Alt text

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

Alt text
Alt text

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

Alt text
Alt text

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

Alt text
Alt text

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

Alt text
Alt text

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

Alt text
Alt text

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

Alt text
Alt text

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

Alt text
Alt text

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

书的框架

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

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

Alt text
Alt text

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

Alt text
Alt text

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

Alt text
Alt text

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

Alt text
Alt text
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 199,711评论 5 468
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 83,932评论 2 376
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 146,770评论 0 330
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 53,799评论 1 271
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 62,697评论 5 359
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,069评论 1 276
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,535评论 3 390
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,200评论 0 254
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,353评论 1 294
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,290评论 2 317
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,331评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,020评论 3 315
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,610评论 3 303
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,694评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,927评论 1 255
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,330评论 2 346
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 41,904评论 2 341

推荐阅读更多精彩内容