如何將PX4 User Guide導(dǎo)出為PDF

PX4的文檔是利用gitbook進(jìn)行編寫生成,，然后發(fā)布到網(wǎng)頁上供大家關(guān)系,。小編目前了解到有2種將PX4文檔導(dǎo)出成PDF：第一種才用gitbook2pdf工具，有興趣的小伙伴可以嘗試一下,，本人主要介紹第二種,；第二種導(dǎo)出方法就是利用gitbook進(jìn)行導(dǎo)出,，本人嘗試了一下網(wǎng)頁版本的gitbook，發(fā)現(xiàn)需要自己將每一個md文件上傳到網(wǎng)頁上,，感覺有點(diǎn)麻煩,，于是本人采用的nodejs,gitbook,ebook-conver,svgexport的方法進(jìn)行導(dǎo)出PDF

1. 工具安裝

安裝nodejs

下載nodejs，這里我選擇v12.22.0 64位安裝,，高版本好像安裝后續(xù)包容易出錯,。下載后直接安裝，除路徑外其他默認(rèn)安裝即可,默認(rèn)安裝就可以不用手動添加見node添加到用戶環(huán)境了,。
win10安裝nodejs后,，打開cmd終端輸入下述命令即可查看安裝的nodejs版本：

node -v
# v12.22.0

安裝ebook-conver

此安裝需要下載exe安裝包，下載v5.40.0 64位安裝程序,，然后默認(rèn)安裝即可,，安裝路徑可修改。

安裝svgexport

svgexport安裝可以直接通過npm進(jìn)行安裝,，打開cmd終端輸入以下內(nèi)容進(jìn)行安裝：

npm install svgexport -g

安裝過程如果太慢或出錯,，可以切換一下源試一下：

npm config set registry https://registry.npm.

是否安裝裝成功，可以通過下面方式來驗證

npm config get registry

安裝gitbook

gitbook安裝直接通過npm進(jìn)行安裝,，打開cmd終端輸入以下內(nèi)容進(jìn)行安裝：

npm install gitbook-cli -g

注：安裝過程如果太慢或出錯,，可以切換一下源試一下。
檢查gitbook版本：

gitbook -V
# CLI version: 2.3.2
# GitBook version: 3.2.3

如果提示Installing GitBook 3.2.3,，安裝過程很久只需等待安裝完即可,。如果在安裝過程中出現(xiàn)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

過程中出現(xiàn)一下問題：

則需要將PX4-user_guide-master中的assets文件復(fù)制到C:\Users\AppData\Local\Temp\文件中,。再次編譯即可,。