GitBook 是一个基于 Node.js 的命令行工具,可使用 Github/Git 和 Markdown 来制作精美的电子书。Gitbook 也可用于markdown 格式的文档管理,因为是纯文本的,所以方便版本管理。总来来说gitbook主要有三个方面的用处。1.生成项目的说明文档文版。2.将文档集中起来生成pdf格式文档汇总。3.生成epub或mobi格式的电子书(是我用gitbook的原因)。
GitBook 是一个基于 Node 开发的命令行工具。因此需要您自行配置 Node 和 npm 环境。如果你已经安装好这些环境之后,GitBook 的安装只需要一步就能完成!
gitbookcli 安装:
$ npm install -g gitbook-cli
$ npm install gitbook
2
1
$ npm install -g gitbook-cli
2
$ npm install gitbook
常用的命令:
gitbook init //初始化目录文件
gitbook help //列出gitbook所有的命令
gitbook --help //输出gitbook-cli的帮助信息
gitbook build //生成静态网页
gitbook serve //生成静态网页并运行服务器
//生成文档和电子书
gitbook pdf: 生成 PDF 文件
gitbook epub: 生成 epub 文件
gitbook mobi: 生成 mobi 文件
9
1
gitbook init //初始化目录文件
2
gitbook help //列出gitbook所有的命令
3
gitbook --help //输出gitbook-cli的帮助信息
4
gitbook build //生成静态网页
5
gitbook serve //生成静态网页并运行服务器
6
//生成文档和电子书
7
gitbook pdf: 生成 PDF 文件
8
gitbook epub: 生成 epub 文件
9
gitbook mobi: 生成 mobi 文件
生成epub和mobi 格式的电子书
首先 npm 安装 ebook-convert 插件
npm install ebook-convert
1
1
npm install ebook-convert
其次是 安装生成电子书的工具 calibre ,
calibre 下载地址:
安装成功后要重启命令行,gitbook epub/mobi 才会生效。我是在这一步卡了很长时间,安装成功后就是不起作用,重启后才生效。
gitbook插件
在book.json 中加入插件,然后再 执行命令 gitbook install
"plugins": [
"prism",
"autocover"
],
"pluginsConfig": {
"prism": {
"css": [
"prismjs/themes/prism-solarizedlight.css"
]
},
"autocover": {
"font": {
"size": null,
"family": "Impact",
"color": "#FFF"
},
"size": {
"w": 1800,
"h": 2360
},
"background": {
"color": "#09F"
}
}
}
25
1
"plugins": [
2
"prism",
3
"autocover"
4
],
5
"pluginsConfig": {
6
"prism": {
7
"css": [
8
"prismjs/themes/prism-solarizedlight.css"
9
]
10
},
11
"autocover": {
12
"font": {
13
"size": null,
14
"family": "Impact",
15
"color": "#FFF"
16
},
17
"size": {
18
"w": 1800,
19
"h": 2360
20
},
21
"background": {
22
"color": "#09F"
23
}
24
}
25
}