Skip to main content

Настройка сайта GitHub Pages с помощью Jekyll

Для дальнейшей настройки сайта GitHub Pages можно использовать Jekyll — популярный генератор статических сайтов.

Кто может использовать эту функцию?

GitHub Pages доступен в общедоступных репозиториях с GitHub Free и GitHub Free для организаций, а также в общедоступных и частных репозиториях с GitHub Pro, GitHub Team, GitHub Enterprise Cloudи GitHub Enterprise Server. Дополнительные сведения см. в разделе "Планы GitHub".

GitHub Pages теперь использует GitHub Actions для выполнения сборки Jekyll. При использовании ветви в качестве источника сборки GitHub Actions необходимо включить в репозитории, если вы хотите использовать встроенный рабочий процесс Jekyll. Кроме того, если GitHub Actions недоступен или отключен, добавление .nojekyll файла в корень исходной ветви будет обойти процесс сборки Jekyll и развернуть содержимое напрямую. Дополнительные сведения о включении GitHub Actionsсм. в разделе "Управление параметрами GitHub Actions для репозитория".

Сведения о GitHub Pages и Jekyll

Jekyll — это генератор статических сайтов со встроенной поддержкой GitHub Pages.

Создание сайта GitHub Pages с помощью Jekyll

Вы можете использовать Jekyll, чтобы создать сайт GitHub Pages в новом или существующем репозитории.

Локальное тестирование сайта GitHub Pages с помощью Jekyll

Вы можете создать сайт GitHub Pages локально для предварительного просмотра и тестирования изменений сайта.

Добавление содержимого на сайт GitHub Pages с помощью Jekyll

Можно добавить новую страницу или сделать публикацию на сайте Jekyll в GitHub Pages.

Настройка обработчика Markdown для сайта GitHub Pages с помощью Jekyll

Вы можете выбрать обработчик Markdown, чтобы определить способ отрисовки Markdown на сайте GitHub Pages.

Добавление темы на сайт GitHub Pages с помощью Jekyll

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

Сведения об ошибках сборки Jekyll для сайтов GitHub Pages

Если Jekyll обнаруживает ошибку при создании сайта GitHub Pages локально или на GitHub Enterprise Cloud, вы получите сообщение об ошибке, содержащее дополнительные сведения.

Устранение ошибок сборки Jekyll для сайтов GitHub Pages

Сообщения об ошибках в сборке Jekyll можно использовать для устранения неполадок в работе GitHub Pages.