如何用gitbook写书
2015-11-27 11:13
309 查看
假设你
已经知道如何编写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 finished Done, 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) generated Done, without error
如果希望生成epub或者mobi格式的,分别执行下面的命令即可:
gitbook epub .
gitbook mobi .
完结
有任何疑问欢迎留言。相关文章推荐
- sql 连接字符串大全
- 关于crontab定时任务执行失败发送报错邮件的问题
- Android 主页面顶部栏的通知Notification ,可以自定义通知消息栏的风格,并且点击通知栏进人本程序。
- 微信支付开发流程(1/2)
- 刚装完archlinux后ifconfig无法使用
- Ucloud数据方舟内测报告
- vim使用
- java区分添加和修改方法
- 判断微信客户端是安卓还是IOS
- 《从零开始学Swift》学习笔记(Day 41)——类的继承
- 南通大学教务学生管理系统用户体验
- 使用DPM还原exchange 2013已删除邮箱数据
- solr解决访问安全
- 记忆
- 如何设计一个 iOS 控件?(iOS 控件完全解析)
- [ActionScript 3.0] Away3D 官网实例
- 浅谈缓存的处理
- 安卓系统虚拟机原理 -- 初试DVM创建
- wamp 2.4开启xDebug
- logback配置