Jekyll в Windows

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

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

Установка с помощью RubyInstaller

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

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

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

1. Скачайте и установите версию Ruby+Devkit с сайта RubyInstaller Downloads. Используйте параметры установки по умолчанию.
2. Запустите шаг ridk install на последнем этапе работы мастера установки. Это необходимо для установки гемов с нативными расширениями. Дополнительную информацию можно найти в документации RubyInstaller. В списке параметров выберите MSYS2 and MINGW development toolchain.
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 для Linux.

Необходимо включить подсистему Windows для 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 Jekyll не сможет обработать файл, начинающийся с символов, представляющих собой маркер порядка байтов (BOM). Поэтому удалите эту последовательность байтов, если она находится в начале файла.

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

chcp 65001

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

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

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

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

В файлы Gemfile новых блогов, созданных с помощью Jekyll версии 3.4 и выше, по умолчанию добавляется указанная ниже настройка. Чтобы разрабатывать существующие сайты в Windows, необходимо обновить их Gemfile (и установленные гемы):

# Windows and JRuby does not include zoneinfo files, so bundle the tzinfo-data gem
# and associated library.
platforms :mingw, :x64_mingw, :mswin, :jruby do
  gem "tzinfo", ">= 1", "< 3"
  gem "tzinfo-data"
end

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

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

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

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

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