如何將adoc文件轉換爲pdf文件

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文件。

                                                                          

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章