PX4的文档是利用gitbook进行编写生成,然后发布到网页上供大家关系。小编目前了解到有2种将PX4文档导出成PDF:第一种才用gitbook2pdf工具,有兴趣的小伙伴可以尝试一下,本人主要介绍第二种;第二种导出方法就是利用gitbook进行导出,本人尝试了一下网页版本的gitbook,发现需要自己将每一个md文件上传到网页上,感觉有点麻烦,于是本人采用的nodejs,gitbook,ebook-conver,svgexport的方法进行导出PDF
下载nodejs,这里我选择v12.22.0 64位安装,高版本好像安装后续包容易出错。下载后直接安装,除路径外其他默认安装即可,默认安装就可以不用手动添加见node添加到用户环境了。
win10安装nodejs后,打开cmd终端输入下述命令即可查看安装的nodejs版本:
node -v
# v12.22.0
此安装需要下载exe安装包,下载v5.40.0 64位安装程序,然后默认安装即可,安装路径可修改。
svgexport安装可以直接通过npm进行安装,打开cmd终端输入以下内容进行安装:
npm install svgexport -g
安装过程如果太慢或出错,可以切换一下源试一下:
npm config set registry https://registry.npm.taobao.org
是否安装装成功,可以通过下面方式来验证
npm config get registry
gitbook安装直接通过npm进行安装,打开cmd终端输入以下内容进行安装:
npm install gitbook-cli -g
注:安装过程如果太慢或出错,可以切换一下源试一下。
检查gitbook版本:
gitbook -V
# CLI version: 2.3.2
# GitBook version: 3.2.3
如果提示Installing GitBook 3.2.3
,安装过程很久只需等待安装完即可。如果在安装过程中出现npm/node_modules/graceful-fs/polyfills.js:287 if (cb) cb.apply(this, arguments)
问题,需要注释文件install_path\nodejs\node_modules\npm\node_modules\graceful-fs\polyfills.js
文件中的下例代码即可。
// fs.stat = statFix(fs.stat)
// fs.fstat = statFix(fs.fstat)
// fs.lstat = statFix(fs.lstat)
下载链接PX4 User Guide,可以通过git下载:
git clone https://github.com/PX4/PX4-user_guide.git
然后cd
到PX4-user_guide-master\zh
路径(生成中文pdf),输入命令即可:
gitbook pdf
过程中出现一下问题:
联系客服