Jekyll на macOS

Установка инструментов командной строки

Для установки инструментов командной строки для компиляции нативных расширений откройте терминал и выполните:

xcode-select --install

Установка Ruby

Jekyll требует Ruby v2.4.0 или выше. macOS Catalina 10.15 поставляется с Ruby 2.6.3. Проверьте версию Ruby, используя ruby -v.

Если вы используете предыдущую версию macOS, вам потребуется установить более новую версию Ruby.

С помощью Homebrew

Чтобы запустить последнюю версию Ruby, необходимо установить её через Homebrew.

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

# Install Ruby
brew install ruby

Добавьте путь к brew ruby в вашу конфигурацию оболочки:

# If you're using Zsh
echo 'export PATH="/usr/local/opt/ruby/bin:$PATH"' >> ~/.zshrc

# If you're using Bash
echo 'export PATH="/usr/local/opt/ruby/bin:$PATH"' >> ~/.bash_profile

# Unsure which shell you are using? Type
echo $SHELL

Перезапустите терминал и проверьте вашу настройку Ruby:

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

ruby -v
ruby 2.7.2p137 (2020-10-01 revision 5445e04352)

Теперь вы используете текущую стабильную версию Ruby!

С помощью rbenv

Часто используется rbenv для управления несколькими версиями Ruby. Это очень полезно, когда вам нужно иметь возможность запускать определенную версию Ruby для проекта.

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

# Install rbenv and ruby-build
brew install rbenv

# Set up rbenv integration with your shell
rbenv init

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

Перезапустите терминал, чтобы применить изменения. Далее, вы можете установить нужную вам версию Ruby. Давайте установим последнюю стабильную версию:

rbenv install 2.7.2
rbenv global 2.7.2
ruby -v
ruby 2.7.2p137 (2020-10-01 revision 5445e04352)

Всё готово! Обратитесь к ссылкам на команды rbenv, чтобы узнать, как использовать различные версии Ruby в своих проектах.

Установка Jekyll

После установки Ruby установите Jekyll и Bundler.

Локальная установка

Установите gem'ы bundler и jekyll:

gem install --user-install bundler jekyll

Получите вашу версию Ruby:

ruby -v
ruby 2.7.2p137 (2020-10-01 revision 5445e04352)

Добавьте в свой файл путей следующее, заменив X.X на первые две цифры вашей версии Ruby:

# If you're using Zsh
echo 'export PATH="$HOME/.gem/ruby/X.X.0/bin:$PATH"' >> ~/.zshrc

# If you're using Bash
echo 'export PATH="$HOME/.gem/ruby/X.X.0/bin:$PATH"' >> ~/.bash_profile

# Unsure which shell you are using? Type
echo $SHELL

Проверьте, что GEM PATHS: указывает на ваш домашний каталог:

gem env

Каждый раз, когда вы обновляете Ruby до версии, в которой меняются первые две цифры, обновите ваш путь, чтобы он соответствовал.

Глобальная установка

Мы рекомендуем не устанавливать Ruby gems глобально, чтобы избежать проблем с правами доступа к файлам, и использовать sudo.

На Mojave (10.14)

Из-за защитных функций SIP в Mojave выполните:

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

Перед Mojave (<10.14)

Выполните:

sudo gem install bundler jekyll

Отладка

См. Отладка или задайте вопрос на нашем форуме.