安装Gitbook
1.首先安装node,查看版本
node -v
# v12.16.1
2.安装gitbook,查看版本
npm install gitbook-cli -g
# 查看版本
gitbook -V
CLI version: 2.3.2
GitBook version: 3.2.3
Gitbook基本操作
gitbook安装成功以后就可以进行操作了,使用Typora就可以。
1.初始化一本书
# 执行init命令会在当前目录下创建README.md和SUMMARY.md文件
$> gitbook init
warn: no summary file in this book
info: create README.md
info: create SUMMARY.md
info: initialization is finished
README.md是说明文档,而 SUMMARY.md 其实就是书的章节目录,其默认内容如下所示:
# Summary
* [Introduction](README.md)
2.启动gitbook,然后在浏览器地址栏中输入 http://localhost:4000
便可预览书籍
gitbook serve
3.生成网页而不开启服务器,可以使用gitbook build
命令
导出pdf
首先说明,将gitbook导出为pdf的可选方式本身就不多,这是我觉得还比较好的其中一种。但是缺点也非常明显。导出到pdf是黑白的,不支持代码高亮,还markdown的高亮语法。我认为多少有些不可接受,但是苦于没有其他方式,所以还是用了这一种。
此种方式需要基于Python或者docker,由于我对Python比较熟悉,所以选用了前者,后者尝试了一下有报错,解决不了。
1.安装Python
2.手动安装安装weasyprint
依赖,见官网。在安装Python依赖的时候可能会出现版本冲突的情况,这时候查看错误日志,比如aaa
依赖冲突了,可以使用pip install aaa
单独再安装一次一般就成功了。
3.克隆此github仓库到本地
4.解压克隆的代码后进入此代码根目录,执行pip install -r requirements.txt
安装所需依赖
5.执行python gitbook.py {url}
导出pdf。比如gitbook本地启动url为http://localhost:4000/second.html
,启动gitbook以后,执行python gitbook.py http://localhost:4000/
即可导出对应pdf。
效果如下,只能说差强人意,勉强能用吧。