Jekyll в macOS

Поддерживаемые версии macOS

Мы следуем системным требованиям Homebrew для macOS, которые обычно охватывают последние 2 или 3 версии macOS.

На более старых версиях macOS всё может работать, но официально мы их не поддерживаем.

Установка Ruby

Чтобы установить Jekyll в macOS, нужна подходящая среда разработки Ruby. Хотя Ruby предустановлен в macOS, мы не рекомендуем использовать эту версию для установки Jekyll. В этой внешней статье рассматриваются различные причины, по которым не следует использовать системный Ruby.

Вместо этого установите отдельную, более новую версию Ruby с помощью менеджера версий, например asdf, chruby, rbenv или rvm. Менеджеры версий позволяют легко устанавливать несколько версий Ruby и переключаться между ними.

Мы рекомендуем chruby, потому что это самый простой вариант, который с наименьшей вероятностью вызовет проблемы.

Приведённые ниже инструкции взяты из этого подробного внешнего руководства по установке Ruby на Mac. Они лучше всего подойдут, если вы впервые настраиваете инструменты разработки на своём Mac. Если вы уже пытались установить Ruby или Jekyll на Mac либо столкнулись с какими-либо проблемами, прочитайте это руководство.

Шаг 1: Установка Homebrew

Homebrew упрощает установку инструментов разработки на Mac.

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

Шаг 2: Установка chruby и последней версии Ruby с помощью ruby-install

Установите chruby и ruby-install с помощью Homebrew:

brew install chruby ruby-install

Установите последнюю стабильную версию Ruby (поддерживаемую Jekyll):

ruby-install ruby 3.4.1

Это займёт несколько минут. После завершения настройте оболочку, чтобы она автоматически использовала 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.4.1" >> ~/.zshrc # run 'chruby' to see actual version

Если вы используете Bash, замените .zshrc на .bash_profile. Если вы не уверены, прочитайте это внешнее руководство, чтобы определить, какую оболочку вы используете.

Закройте и снова запустите Terminal, затем убедитесь, что всё работает:

ruby -v

Должна отобразиться версия ruby 3.4.1 (2024-12-25 revision 48d4efcb85) или более новая.

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

Установка Jekyll

После установки Ruby с помощью chruby установите последнюю версию гема Jekyll:

gem install jekyll

Устранение неполадок

См. раздел «Устранение неполадок» или обратитесь за помощью на наш форум.