Jekyll в Windows

Хотя платформа Windows не является официально поддерживаемой, её можно использовать для запуска Jekyll с соответствующими изменениями.

Установка Ruby и Jekyll

Установка через RubyInstaller

Самый простой способ установить Ruby и Jekyll — использовать RubyInstaller для Windows.

RubyInstaller — это автономный установщик для Windows, который включает язык программирования Ruby, среду выполнения, важную документацию и многое другое.

Здесь мы рассматриваем только RubyInstaller-2.4 и более новые версии. Более старые версии требуют ручной установки Devkit.

1. Загрузите и установите версию Ruby+Devkit с сайта загрузки RubyInstaller. Используйте параметры установки по умолчанию.
2. Выполните ridk install шаг на последнем этапе мастера установки. Это необходимо для установки драгоценных камней с нативными расширениями. Дополнительную информацию об этом можно найти в документации RubyInstaller.
3. Откройте новое окно командной строки из меню Пуск, чтобы изменения переменной среды PATH стали эффективными. Установите Jekyll и Bundler с помощью gem install jekyll bundler.
4. Проверьте, правильно ли установлен Jekyll: jekyll -v.

При проверке установки Jekyll может появиться ошибка. Перезагрузите систему и снова выполните jekyll -v. Если ошибка сохраняется, откройте запрос поддержки RubyInstaller.

Всё готово, вы можете использовать Jekyll!

Установка через Bash в Windows 10

Если вы используете Windows 10 версии 1607 или более поздней, ещё один вариант запуска Jekyll — установка Windows Subsystem for Linux.

Необходимо включить Windows Subsystem for Linux.

Убедитесь, что все ваши пакеты и репозитории обновлены. Откройте новое окно командной строки или PowerShell и введите bash.

Теперь ваша консоль должна быть экземпляром Bash. Далее обновите списки репозиториев и пакеты:

sudo apt-get update -y && sudo apt-get upgrade -y

Далее, установите Ruby. Для этого воспользуемся репозиторием от BrightBox, который предоставляет оптимизированные версии Ruby для Ubuntu.

sudo apt-add-repository ppa:brightbox/ruby-ng
sudo apt-get update
sudo apt-get install ruby2.5 ruby2.5-dev build-essential dh-autoreconf

Далее обновите ваши Ruby драгоценные камни:

gem update

Установите Jekyll:

gem install jekyll bundler

Здесь нет sudo.

Проверьте вашу версию Jekyll:

jekyll -v

Всё готово! Вы можете начать использовать Jekyll.

Вы можете убедиться, что управление временем работает должным образом, проверив папку _posts. Вы должны увидеть файл Markdown с текущей датой в имени файла.

Проблемы с учётной записью без прав суперпользователя

Если команда `jekyll new` выводит ошибку "Ваша учётная запись не имеет разрешения на установку в системный RubyGems", см. инструкции "Запуск Jekyll от имени обычного пользователя" в Устранении неполадок.

Bash на Ubuntu в Windows всё ещё находится в разработке, поэтому могут возникнуть проблемы.

Кодировка

Если вы используете кодировку UTF-8, убедитесь, что в ваших файлах нет символов заголовка BOM. В противном случае Jekyll сломается. Это особенно важно, когда вы используете Jekyll в Windows.

Кроме того, возможно, вам потребуется изменить кодовую страницу окна консоли на UTF-8, если при генерации сайта возникнет ошибка Liquid Exception: Incompatible character encoding. Выполните следующее:

chcp 65001

Управление часовыми поясами

Поскольку в Windows нет собственного источника данных zoneinfo, интерпретатор Ruby не понимает часовые пояса IANA. Использование их привело к тому, что переменная среды TZ по умолчанию устанавливалась в UTC/GMT 00:00.

Хотя пользователи Windows могли бы альтернативно определить часовой пояс своего блога, задав ключ для использования формата POSIX определения часовых поясов, это было не так удобно, когда приходилось изменять время, учитывая правила перехода на летнее время.

Теперь Jekyll использует rubygem для внутренней настройки часового пояса на основе установленной базы данных часовых поясов IANA.

Хотя новые блоги, созданные с Jekyll v3.4 и выше, будут иметь следующее, добавленное в Gemfile по умолчанию, существующим сайтам необходимо обновить Gemfile (и установленные драгоценные камни), чтобы включить разработку в Windows:

# Windows does not include zoneinfo files, so bundle the tzinfo-data gem
gem 'tzinfo-data', platforms: [:mingw, :mswin, :x64_mingw, :jruby]

Несовместимость TZInfo 2.0

Версия 2.0 библиотеки TZInfo внесла изменения в способ расчета смещений часовых поясов. Это приведёт к некорректным дате и времени публикаций при построении сайта с Jekyll 3.x в Windows.

Поэтому рекомендуется зафиксировать библиотеку Timezone на версии 1.2 и выше, указав gem 'tzinfo', '~> 1.2' в Gemfile.

Автоматическая перегенерация

Jekyll использует драгоценный камень listen для отслеживания изменений при указании переключателя --watch при построении или обслуживании. Хотя listen имеет встроенную поддержку UNIX-систем, для совместимости с Windows может потребоваться дополнительный драгоценный камень.

Добавьте следующее в Gemfile для вашего сайта, если у вас возникают проблемы с автоматической перегенерацией только в Windows:

gem 'wdm', '~> 0.1.1', :install_if => Gem.win_platform?

Для успешной установки драгоценного камня wdm необходимо использовать версию RubyInstaller с Ruby+Devkit и установить инструменты сборки MSYS2.