PX4 Autopilot User Guide PDF导出
如何将PX4 User Guide导出为PDF
PX4的文档是利用gitbook进行编写生成，然后发布到网页上供大家关系。小编目前了解到有2种将PX4文档导出成PDF：第一种才用gitbook2pdf工具，有兴趣的小伙伴可以尝试一下，本人主要介绍第二种；第二种导出方法就是利用gitbook进行导出，本人尝试了一下网页版本的gitbook，发现需要自己将每一个md文件上传到网页上，感觉有点麻烦，于是本人采用的nodejs,gitbook,ebook-conver,svgexport的方法进行导出PDF
1. 工具安装
下载nodejs，这里我选择v12.22.0 64位安装，高版本好像安装后续包容易出错。下载后直接安装，除路径外其他默认安装即可,默认安装就可以不用手动添加见node添加到用户环境了。
win10安装nodejs后，打开cmd终端输入下述命令即可查看安装的nodejs版本：
node -v
# v12.22.0
安装ebook-conver
此安装需要下载exe安装包，下载v5.40.0 64位安装程序，然后默认安装即可，安装路径可修改。
安装svgexport
svgexport安装可以直接通过npm进行安装，打开cmd终端输入以下内容进行安装：
npm install svgexport -g
安装过程如果太慢或出错，可以切换一下源试一下：
npm config set registry https://registry.npm.
是否安装装成功，可以通过下面方式来验证
npm config get registry
安装gitbook
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)
2.输出PX4 Guide文档
下载PX4 Guide文档gitbook源文件
下载链接PX4 User Guide，可以通过git下载：
git clone https://github.com/PX4/PX4-user_guide.git
然后cd到PX4-user_guide-master\zh路径（生成中文pdf），输入命令即可：
gitbook pdf
过程中出现一下问题：
则需要将PX4-user_guide-master中的assets文件复制到C:\Users\AppData\Local\Temp\文件中。再次编译即可。
|
