Jekyll で Asciidoc を使用する

markdown だけでなく asciidoc も使えたら便利なので。 以下の記事で作成した環境に対して asciidoc を使えるようにします。 - https://kuttsun.blogspot.com/2024/09/jekyll-docker.html 調べたところ以下のプラグインを使えば出来そうだったので、これを使ってみます。 - https://github.com/asciidoctor/jekyll-asciidoc ## Gemfile の変更 ドキュメントの通りに、`Gemfile` に以下を追加します。 ``` group :jekyll_plugins do gem 'jekyll-asciidoc' end ``` `_config.yml` に以下を追加します。 ``` plugins: - jekyll-asciidoc ``` 尚、`jekyll-asciidoc` は他のプラグインより先に記述する必要があるそうです。 詳細は以下を参照してください。 - https://github.com/asciidoctor/jekyll-asciidoc?tab=readme-ov-file#plugin-ordering これで、`_post` フォルダ内に asciidoc で書いたドキュメントを追加すれば OK です。 ファイル名は Jekyll の決まりとして、`YYYY-MM-DD-title.adoc` のように日付が入っている必要があります。 - https://jekyllrb-ja.github.io/docs/posts/ 以下、サンプル通りに記事を作成してみました。 ``` = Sample Page :page-layout: post :page-permalink: /sample/ :url-asciidoctor: https://asciidoctor.org This is a sample page composed in AsciiDoc. Jekyll converts it to HTML using {url-asciidoctor}[Asciidoctor]. [source,ruby] puts "Hello, World!" ``` ただし、`layuout` は `post` に変更しています。 レイアウトについては以下。 - https://qiita.com/a999/items/6c29ce072c19448ea579 これできちんと表示されることを確認しました。 ## include ディレクティブを使用するときの相対パス asciidoc では `include` ディレクティブを使用して他の asciidoc ファイルを読み込むことができますが、このままやっても上手く描画されませんでした。 同様の内容が issue に挙がっていました。 - https://github.com/asciidoctor/jekyll-asciidoc/issues/182 ベースディレクトリの設定がデフォルトではプロジェクトルートになっているので、ソースディレクトリとなるように設定すれば良さそうです。 - https://github.com/asciidoctor/jekyll-asciidoc?tab=readme-ov-file#specifying-the-base-directory `_config.yml` に以下を追記すれば上手くいきました。 ```yml asciidoctor: base_dir: :docdir safe: unsafe ``` ## 参考 URL - https://github.com/asciidoctor/jekyll-asciidoc - https://qiita.com/a999/items/6c29ce072c19448ea579 - https://github.com/asciidoctor/jekyll-asciidoc/issues/182