riscv的大多spec,都託管在了github。並且使用adoc文件格式編寫。adoc文件,是可以轉換爲pdf文件的。
通過工具 asciidoctor PDF 工具,可以將adoc文件,轉換爲pdf文件。該工具的官網介紹如下:
https://asciidoctor.org/docs/asciidoctor-pdf/
首先要先安裝該工具,該工具,需要使用gem命令安裝,如果環境中,沒有gem命令,需要先安裝gem命令。
gem命令,是ruby用來安裝包的工具。因此需要先安裝ruby。安裝ruby,這裏就不介紹了。
使用gem命令安裝asciidoctor pdf工具。
gem install asciidoctor-pdf --pre
安裝完畢後,系統中,就有了asciidoctor-pdf工具。
我們以生成 riscv-p-spec的pdf文檔爲例進行介紹。
首先是clone該版本庫到本地。
git clone https://github.com/riscv/riscv-p-spec.git
執行如下命令,生成pdf
asciidoctor-pdf P-ext-proposal.adoc -o P-ext-proposal.pdf
-o參數指定生成的文件
這樣,我們就完成了將adoc文件,轉換成了pdf文件。