adocファイルをpdfファイルに変換する方法

874 ワード

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ファイルに変換することができます.