macOS での Jekyll

サポートされている macOS バージョン

Ventura (macOS 13)
Monterey (macOS 12)
Big Sur (macOS 11)

それより古いバージョンの macOS でも動作する可能性がありますが、公式にはサポートしていません。

Ruby のインストール

macOS に Jekyll をインストールするには、適切な Ruby 開発環境が必要です。macOS には Ruby がプリインストールされていますが、Jekyll のインストールにはそのバージョンを使用することはお勧めしません。この外部記事では、システムの Ruby を使用して Mac に gem をインストールすべきではない理由を説明しています。

代わりに、asdf、chruby、rbenv、または rvm などのバージョンマネージャーを使用して、別途新しいバージョンの Ruby をインストールする必要があります。バージョンマネージャーを使用すると、複数のバージョンの Ruby を簡単にインストールして切り替えることができます。

最もシンプルで問題が発生する可能性が低いことから、chruby をお勧めします。

以下の手順は、Mac に Ruby をインストールするための詳細な外部ガイドからの抜粋です。Mac に開発ツールを初めて設定する場合に最適です。既に Mac に Ruby または Jekyll のインストールを試みたことがある場合、または問題が発生した場合は、このガイドをお読みください。

ステップ 1：Homebrew のインストール

Homebrew を使用すると、Mac に開発ツールを簡単にインストールできます。

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

ステップ 2：chruby と ruby-install を使用した最新の Ruby のインストール

Homebrew を使用して chruby と ruby-install をインストールします

brew install chruby ruby-install xz

最新の安定版 Ruby（Jekyll でサポートされているバージョン）をインストールします

ruby-install ruby 3.1.3

これは数分かかります。完了したら、シェルを構成して chruby を自動的に使用します

echo "source $(brew --prefix)/opt/chruby/share/chruby/chruby.sh" >> ~/.zshrc
echo "source $(brew --prefix)/opt/chruby/share/chruby/auto.sh" >> ~/.zshrc
echo "chruby ruby-3.1.3" >> ~/.zshrc # run 'chruby' to see actual version

Bash を使用している場合は、.zshrc を .bash_profile に置き換えます。よくわからない場合は、どのシェルを使用しているかを確認するための外部ガイドをお読みください。

ターミナルを終了して再起動し、すべてが機能していることを確認します

ruby -v

ruby 3.1.3p185 (2022-11-24 revision 1a6b16756e) またはそれ以降のバージョンが表示されます。

次に、chruby を使用した Ruby バージョンの設定と切り替えに関する重要な注意事項については、同じ外部ガイドをお読みください。

Jekyll のインストール

chruby を使用して Ruby をインストールした後、最新の Jekyll gem をインストールします

gem install jekyll

トラブルシューティング

トラブルシューティングを参照するか、フォーラムでヘルプをリクエストしてください。