Jekyll で asciidoctor-diagram を使う

Jekyll で Asciidoc を使えるようにしたのですが、Asciidoc 内でダイアグラムを使うためには以下の設定が必要です。

Asciidoctor Diagram の有効化

Gemfile に以下を追加します。

group :jekyll_plugins do
  gem 'asciidoctor-diagram'
  gem 'asciidoctor-diagram-plantuml'
end

以下のページには記述がありませんでしたが、私の環境では asciidoctor-diagram-plantuml も必要でした。

https://github.com/asciidoctor/jekyll-asciidoc?tab=readme-ov-file#enabling-asciidoctor-diagram

生成された画像の保存

Jekyll に、ビルドプロセスの途中で Asciidoctor Diagram が出力した画像ファイルを削除しないよう指示するために、 _plugins/jekyll-ext.rb を作成し、以下を記述します。

class Jekyll::Cleaner
    def cleanup!; end
end

詳細は以下をご参照ください。

https://github.com/asciidoctor/jekyll-asciidoc?tab=readme-ov-file#preserving-generated-images

参考 URL

Hugo で構築されています。
テーマ StackJimmy によって設計されています。