使用Git/Github和Markdown编写精美图书

本内容主要是对Gitbook进行介绍,以及如何创建一个在线Gitbook项目,组织成一本在线图书,分享给更多需要阅读到的人。

我大至在两年前接触到Markdown,之前对于文件的编辑,多使用Word之类的工具,后而使用过Sphinx文本格式。记得最初在接触所谓文本文件的时候,觉得这没什么意思,哪有Word之类的这么直接,输入文字、设定字号、字体、样式,再调整段落,然后就完事了。但当自己开始使用Markdown之类的文本之后,就真的能好好的在电脑面前书写内容了,而且是一次编写,便可以输出N种想要的格式,更重要的时,可以支持像Git这类的版本管理工具,然后再不用担心由于修改错误而回不到修改前的内容了。

之前的使用,多限于编写一个独立的Markdown文件,生成网页格式或是PDF,当然也可以直接放到Github上,在线也能看到渲染之后的样式。如何组织一个以Markdown语法编写的小书,可以直接生成HTML格式的静态网页,也可以生成PDF之类的独立的文件呢?于是我找到了刚开发出来还不久的Gitbook。

GitBook 是一个基于 Node.js 的命令行工具,可使用 Github/Git 和 Markdown 来制作精美的电子书。

于是我参照已有的Gitbook项目及官方的指导说明,自己创建了一个Github项目,并将生成的静态HTML放到了Github Pages上,这是网站的效果截图:

你可以在这里访问到这个项目:

http://gitbook-zh.wanqingwong.com/

支持格式

GitBook支持输出多种文档格式,如:

  • 静态站点:GitBook默认输出该种格式,生成的静态站点可直接托管搭载Github Pages服务上;
  • PDF:需要安装gitbook-pdf依赖;
  • eBook:需要安装ebook-convert
  • 单HTML网页:支持将内容输出为单页的HTML,不过一般用在将电子书格式转换为PDF或eBook的中间过程;
  • JSON:一般用于电子书的调试或元数据提取。

Gitbook项目地址

如何创建一个Gitbook在线图书

上面的《Gitbook使用入门》较为详细的说明了创建一个Gitbook的流程及操作方式,你可以参照所提供的方式进行设置、编写及发布。

如何学习本微课

如果你也希望使用这些工具来做一本电子书,那么欢迎你加入到我们的微课学习中来。学习本微课,你需要准备以下技能:

Markdown语法:

JoinWEE有不少学友们开发的Markdown教程,你可以先阅读一下,当然,最后的学习,还是你开始使用Markdown书写内容:

Git/Github使用

使用这类工具可以对你的Markdown文件进行版本管理,同时也能在网络上进行协作编写,你可以先阅读一下这些内容:

大致明白了Markdown和Git/Github之后,你就可以开始使用Gitbook开始你的图书编写之旅了!你可以开始参照我们为你准备的《Gitbook使用入门》编写自己的图书:

http://gitbook-zh.wanqingwong.com/

当然如果你只是想自己读起来方便,或是只想分享给少数的几位朋友,那么你也可以不必发布到网络上去,编写内容,然后生成HTML或是PDF或是eBook之后,直接邮给你给你的朋友就行了。

参与微课研修

你可参与我们的微课研修中来,我们根据本微课的内容情况,进行研修学习,欢迎随时关注这个微课页面,查看研修进度:

认识Gitbook:

Markdown使用:

  • 状态:待开放

如何交流与分享学习成果

你可以在本微课的讨论组中进行交流,或是将你的作品分享到讨论组里。

最后

诚然,发布这个过程可能会有些复杂,但我想对于喜欢文字,乐于分享的朋友来说,这根本算不上什么。Gitbook也只是众多图书组织方式中的一种,而我自己刚好就喜欢这个,因为他能与Github/Github Pages配合起来使用,你可以通过网络分享给所有有这类需求的人,这是件很酷的事。


最新讨论

+发言
主题 发言人 条数 时间
在Gitbook上写了第一本电子书 Oliver Ding 0条回应 2015-03-13 05:27
《 使用Git/Github和Markdown编写精美图书 》第 1 期研修 wwq0327 2条回应 2014-05-18 15:36

线下活动

暂无线下微聚

研修列表 我要创建

Oliver Ding的研修 |05/22~06/20 ~ 第 1 期

组织人:Oliver Ding
人数: 召集了 0 人 / 需要召集 3

wwq0327的研修 |05/19~05/21 ~ 第 1 期

组织人:wwq0327
人数: 召集了 4 人 / 需要召集 5

学习本微课学友们

安隐

来自北京

必晴

来自深圳

Rainvoo

来自上海

Oliver Ding

来自休斯顿

wwq0327

爱生活,珍惜可贵的生命,期望着以某着自己尚未知的方式延续这生命。喜欢平淡生活,为人但求无愧于心。爱自由,喜欢一种无拘无束的生存状态。相信知识可启迪心智,倡导每个人都应该做终身学习者。

学友

微课目录