Windows11 + WSL で AsciiDoc をビルドする環境をつくる

Windows11 の WSL (Ubuntu) で asciidoc コンテンツを HTML, PDF に変換する環境をつくる備忘録。

asciidoc で書いたコンテンツを HTML, PDFに変換できるように asciidoctor, asciidoctor-pdf コマンドをインストールします。

ただし、 それらは gem 経由で入れるので、gem コマンドが使えるように先にしておきます。

$ sudo apt install rubygems

あとは、各コマンド用ツール入れるだけです。 コードのハイライト用に rouge https://github.com/rouge-ruby/rouge を使うので、それも入れました。

$ sudo gem install asciidoctor
$ sudo gem install asciidoctor-pdf
$ sudo gem install rouge

これだけです。

epub生成用の asciidoctor-epub3 コマンドのインストールはこれ。

$ sudo NOKOGIRI_USE_SYSTEM_LIBRARIES=1 gem install asciidoctor-epub3

詳細はこちら: https://docs.asciidoctor.org/epub3-converter/latest/