jekyll-org プラグインの導入
Jekyll で org-mode の書式を使う方法は検索すると先人が既に開拓してくれていた。 プラグインの jekyll-org (link) と使うとか、自前のスクリプトで HTML に変換してから jekyll を実行するとか。 このサイトはまず jekyll-org を使うことにした。
ただ、ruby 3.0.1 + jekyll 4.2.0 の環境だと gem で配布されている jekyll-org はうまく動いてくれなかった。 GitHub の Issue にもなっている。(link) なので、次のコマンドで GitHub にあるコードをローカルのリポジトリに取り込んだ。
mkdir imported_plugins
git submodule add https://github.com/eggcaker/jekyll-org.git imported_plugins/jekyll-org
mkdir _plugins/
cd _plugins/
ln -s ./imported_plugins/jekyll-org/lib/jekyll-org.rb .
ln -s ./imported_plugins/jekyll-org/lib/jekyll-org .
プラグインを置くディレクトリは imported_plugins/
と _plugins/
の 2 つに分けている。
jekyll がプラグインを読みにいく _plugins/
の配下に全てのコードを置いてしまうとテストコードまで実行しようとしてエラーが出るのでこのようにした。