Gitbook官网 https://github.com/GitbookIO/gitbook
1、 首先安装nodejs环境,windows、linux各有不同方法;我的Linux下是用apt安装nodejs,但apt安装的一般是比较老的版本,需要再更新到新版本。 https://blog.csdn.net/well2049/article/details/79138045
2、安装Gitbook https://www.jianshu.com/p/421cc442f06c
3、安装生成SUMMARY.MD的插件 ,gitbook-plugin-summary可以把md.json中的中文名也映射到位,除了根目录,还是得自己去修改,十分尴尬了。
gitbook-summary,中文名无法映射。
https://github.com/julianxhokaxhiu/gitbook-plugin-summary
https://github.com/imfly/gitbook-summary
我这里主要用gitbook-plugin-summary,它是作为gitbook插件存在的,所以需要在book.json里配置
{
"plugins": ["summary"]
}
配置完了别忘了Install一下!跑个命令 gitbook install
就会自动加载安装这个插件了。
但是安装完后运行gitbook pdf
有个bug,它确实成功生成SUMMARY.md文件,但是生成的pdf却是空的。
这里可以先运行gitbook build
,生成SUMMARY.md文件,再运行gitbook pdf
生成正确的pdf。
4、要转pdf还需要下载calibre库,官网 https://calibre-ebook.com/download
在Linux下需要安装 GLIBC_2.18和libstdc++.so,这里走了很多弯路去下载更新这两个库,实际上只要跑下面命令就ok了。
在Ubuntu下安装carlibre还是比较简单的 参照 https://connectwww.com/how-to-install-calibre-on-ubuntu/60653/
sudo apt-get install calibre
直接一行搞定,不需要去管其他需要的库。
网友评论