赞
踩
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安装成功以后就可以进行操作了,使用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
命令
首先说明,将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。
效果如下,只能说差强人意,勉强能用吧。
Copyright © 2003-2013 www.wpsshop.cn 版权所有,并保留所有权利。