軽量マークアップ言語 AsciiDoc で書かれたテキストを HTML や PDF などに変換するために、Asciidoctor というコンバーターをインストールします。
Ruby がインストールされていれば、以下のコマンドでインストールできます。
gem install asciidoctor
インストールが成功すれば、以下のコマンドで確認することができます。
asciidoctor --version
インストールができない場合はこちらを参考にしてみてください。
Asciidoctor 拡張
Asciidoctor の拡張として、Asciidoctor PDF や Asciidoctor Diagram があります。 これらも以下のコマンドでインストールできます。
gem install --pre asciidoctor-pdf
gem install asciidoctor-pdf-cjk
gem install asciidoctor-diagram
asciidoctor-pdf はまだ正式版がないようなので、--pre をつけてインストールします。 asciidoctor-pdf-cjk は日本語を使用する場合の表示を正しくするために必要です。
シンタックスハイライト
コードをシンタックスハイライトするためのプラグインもインストールします。 いろいろな種類がありますが、ここでは coderay をインストールします。
gem install coderay