Jekyll on macOS

コマンドラインツールのインストール

最初に、ネイティブエクステンションをコンパイルできるようにするために、コマンドラインツールをインストールします。ターミナルを開いて、実行します。

xcode-select --install

Rubyのインストール

Install Ruby

JekyllはRuby > 2.4.0が必須です。 macOS Mojave 10.14には、ruby 2.3.xのみ付属していますので、新しいバージョンのRubyをインストールする必要があります。

With Homebrew

最新のRubyバージョンを実行するには、Homebrewを通じてインストールする必要があります。

# Install Homebrew
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

brew install ruby

brew Rubyパスをshell configに追加してください。

export PATH=/usr/local/opt/ruby/bin:$PATH

ターミナルを再起動し、Rubyのセットアップの更新を確認します。

which ruby
# /usr/local/opt/ruby/bin/ruby

ruby -v
ruby 2.6.3p62 (2019-04-16 revision 67580)

現在の安定版Rubyを実行できるようになりました。

With rbenv

複数のRubyバージョンを管理するために、rbenvを使用することもあります。これは、プロジェクトで特定のRubyバージョンを実行する必要がある場合には、とても便利です。

# Install Homebrew
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

# Install rbenv and ruby-build
brew install rbenv

# Setup rbenv integration to your shell
rbenv init

# Check your install
curl -fsSL https://github.com/rbenv/rbenv-installer/raw/master/bin/rbenv-doctor | bash

変更を有効にするために、ターミナルを再起動します。これで、選択したRubyバージョンをインストールできます。最新の安定版Rubyを使ってみましょう。

rbenv install 2.6.3
rbenv global 2.6.3
ruby -v
ruby 2.6.3p62 (2019-04-16 revision 67580)

以上です。rbenv command referencesを読んで、プロジェクトでの異なるRubyバージョンの使い方を学んでください。

Jekyllのインストール

後は、BundlerとJekyllをインストールするだけです。

ローカルインストール

gem install --user-install bundler jekyll

それからRubyのバージョンを取得します。

ruby -v
ruby 2.6.3p62 (2019-04-16 revision 67580)

それから、パスファイルに以下を追加します。X.Xには、あなたのRubyバージョンの最初の2桁を入れてください。

export PATH=$HOME/.gem/ruby/X.X.0/bin:$PATH

gemパスがホームディレクトリを指していることを確認するには、次のコマンドを実行します。

gem env

GEM PATHS:がホームディレクトリを指していることを確認してください。

最初の2桁が異なるRubyバージョンに更新する度に、パスもあわせて更新する必要があります。

グローバルインストール

ファイルのパーミッションの問題を解決し、sudoを使用するためにRuby Gemsをグローバル環境にインストールすることを、強く推奨します。

Mojave(10.14)の場合

MojaveのSIPプロテクションのため、以下を実行しなければなりません。

sudo gem install bundler
sudo gem install -n /usr/local/bin/ jekyll

Mojave以前(<10.14)

次を実行するだけです。

sudo gem install bundler jekyll

問題が発生しましたか?

トラブルシューティングページを確認したり、フォーラムで助けを求めてください。