PX4 Autopilot User Guide PDF导出

• 如何将PX4 User Guide导出为PDF
• • 1. 工具安装
  • • 安装nodejs
    • 安装ebook-conver
    • 安装svgexport
    • 安装gitbook
  • 2.输出PX4 Guide文档
  • • 下载PX4 Guide文档gitbook源文件

如何将PX4 User Guide导出为PDF

PX4的文档是利用gitbook进行编写生成，然后发布到网页上供大家关系。小编目前了解到有2种将PX4文档导出成PDF：第一种才用gitbook2pdf工具，有兴趣的小伙伴可以尝试一下，本人主要介绍第二种；第二种导出方法就是利用gitbook进行导出，本人尝试了一下网页版本的gitbook，发现需要自己将每一个md文件上传到网页上，感觉有点麻烦，于是本人采用的nodejs,gitbook,ebook-conver,svgexport的方法进行导出PDF

1. 工具安装

安装nodejs

下载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.taobao.org

是否安装装成功，可以通过下面方式来验证

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\文件中。再次编译即可。