假设你

已经知道如何编写Markdown
已经安装好gitbook软件

目标

生成一本小书，它有前言，章节1，章节2，后记。例如：

简介
第一章：如何造火箭1. 燃料学2. 空气动力学3. 总装工程学
第二章：如何回收火箭1. 自动控制原理2. 二次利用要点
结束

准备工作

建一个写书的目录，以后所有工作都在这个目录下搞。例如

/Users/raywill/gitbook/first

开干！生成书籍框架

在电脑上建立整本书的目录结构，以及文件结构。

我们可以自己一步步用文件管理器新建文件夹，新建文件，不过这么做太累了，gitbook可以帮我们自动生成。我们需要做的是提供一个叫做SUMMARY.md的文件给gitbook，然后调用

gitbook init

就能自动生成目录结构及每个章节的markdown文件。

我们先为我们的新书写SUMMARY.md，内容如下：

[简介](README.md)
* [第一章：如何造火箭](ch1/build.md)- [1. 燃料学](ch1/fuel.md)- [2. 空气动力学](ch1/air.md)- [3. 总装工程学](ch1/enginer.md)- [小结](ch1/WRAPUP.md)
* [第二章：如何回收火箭](ch2/recycle.md)- [1. 自动控制原理](ch2/ac.md)- [2. 二次利用要点](ch2/key.md)
* [结束](end/SUMMARY.md)

写好后，执行

gitbook init

可以看到屏幕输出如下：

raywill:first raywill$ gitbook init
info: init book at /Users/raywill/gitbook/first
info: detect structure from SUMMARY (if it exists)
info: create README.md
info: create ch1/build.md
info: create ch1/fuel.md
info: create ch1/air.md
info: create ch1/enginer.md
info: create ch1/WRAPUP.md
info: create ch2/recycle.md
info: create ch2/ac.md
info: create ch2/key.md
info: create end/SUMMARY.md
info: initialization is finishedDone, without error

可见，gitbook按照我们的要求，帮我们生成好了所有文件。生成的文件结构如下：

.
├── README.md
├── SUMMARY.md
├── ch1
│   ├── WRAPUP.md
│   ├── air.md
│   ├── build.md
│   ├── enginer.md
│   └── fuel.md
├── ch2
│   ├── ac.md
│   ├── key.md
│   └── recycle.md
└── end└── SUMMARY.md

每个文件的第一行就是我们写的章节标题。

写书

这个时候，按照markdown的格式逐个填充内容到文件即可。至于用什么编辑器写Markdown文件，随你了。本地的，在线的，都成。

生成电子书

执行如下命令生成pdf格式电子书：

gitbook pdf .

命令由三部分组成：命令（gitbook），生成的格式（pdf），markdown源文件位置（.，点表示当前目录）。

命令运行后可以看到如下输出，表示生成pdf成功。这时候，目录里面多了一个pdf文件。

raywill:first raywill$ gitbook pdf .
info: loading book configuration....OK
info: load plugin gitbook-plugin-highlight ....OK
info: load plugin gitbook-plugin-search ....OK
info: load plugin gitbook-plugin-sharing ....OK
info: load plugin gitbook-plugin-fontsettings ....OK
info: >> 4 plugins loaded
info: start generation with pdf generator
info: clean pdf generatorOK
info: write SUMMARY.html
info: start conversion to pdf ....OK
info: generation is finished
info: >> 1 file(s) generatedDone, without error

如果希望生成epub或者mobi格式的，分别执行下面的命令即可：

gitbook epub .

gitbook mobi .

完结

有任何疑问欢迎留言。

如何用gitbook写书相关推荐

如何用gitbook写文档并存到github上
2019独角兽企业重金招聘Python工程师标准>>> 1. 安装npm,从网站下载node.js源代码 https://nodejs.org/#download 解压 ./con ...
如何用Gitbook制作电子书？
Gitbook可以用来制作成在线电子书,这样方便互联网上的人都能看到你的作品.如何制作电子书呢? 1.登录 Github 登录GithHub,点击 Code 按钮,然后将项目下载下来,下载后的文件减 ...
[教程]使用gitbook写书
文章目录 gitbook网站利用github page GitBook插件资料总结 gitbook网站 gitbook 是基于github的markdown语法的在线文档编辑工具在Github ...
如何用word写书_如何用vba在word中添加打勾的方框？
最近在做word vba项目,遇到个需求,需要根据条件判断批量输出打√的方框和不打√的方框,类似如下图所示: 本来以为是个很容易的事情,没想到阻碍不小. 首先,我们先看看如何在word文档中手动输入带 ...
如何用word写书_如何将100页PPT转换成Word？1键轻松搞定，看完你还用复制黏贴吗...
我们平常使用的office软件,就是一个强大的格式转换器!今天就和大家分享一下PPT中的多种格式转换方法,一起学习学习~ 一.PPT常用转换格式 1.PPT转Word 我们经常使用的PPT就自带转Wo ...
总结了一下如何使用gitbook生成本地静态HTML电子书
总结一下如何用gitbook生成静态html电子书: 1.安装node.js: sudo apt-get install nodejs 2.查看一下node.js是否安装成功 nodejs -v 3. ...
分享五年码农生涯历程经验及2018总结 | 掘金年度征文
生涯回顾掘金的码友们好,我叫shinn_lancelot(名字不大好,但是用习惯了就不想改了),是一名喜欢ACG的低学历的码农.大学期间虽然学的软件专业,但是除了大一之外都没有认真学习(算是三分钟热 ...
简单实用 | 用Gitbook做笔记 / 写书过程全记录
用Gitbook写随笔 1. 准备 2. 开始写书 2.1 创建书籍 2.2 撰写书籍 2.2.1 生成目录 2.2.2 写你所想 2.3 构建书籍 2.4 预览书籍 2.5 生成书籍 3 发布书籍 ...
gitbook结合github写书及发布到gitbook上
本案例发布的书可以点击这里看效果程序员一般喜欢用markdown语法写文档,一般我们使用的markdown工具有 1.window系统下: mdcharm 2.mac系统下:MacDown 虽然使用 ...

如何用gitbook写书

假设你

目标

准备工作

开干！生成书籍框架

写书

生成电子书

完结

如何用gitbook写书相关推荐

最新文章

热门文章