Шпаргалка по Jekyll на GitHub Pages

Краткий справочник по использованию Jekyll с GitHub Pages: структура каталогов, настройка, frontmatter, теги Liquid и локальное тестирование перед публикацией.

Составлено Cheat Sheets · Опубликовано24 октября 2026 г.

Быстрая шпаргалка по настройке и публикации статических сайтов на базе Jekyll в GitHub Pages.

Структура каталогов

.
├── _config.yml       # Конфигурация сайта
├── _includes/        # Переиспользуемые фрагменты шаблонов
├── _layouts/         # Базовые макеты страниц
├── _posts/           # Статьи блога (YYYY-MM-DD-title.md)
├── _sass/            # Фрагменты стилей SASS / SCSS
├── assets/           # Изображения, скомпилированные стили, JS
└── index.md          # Содержимое главной страницы

Конфигурация (`_config.yml`)

title: My Documentation
description: Quick reference cheatsheets
baseurl: "/my-repo"
url: "https://username.github.io"

# Зависимости GitHub Pages
plugins:
  - jekyll-feed
  - jekyll-seo-tag
  - jekyll-sitemap

markdown: kramdown
theme: minima

Заголовок Frontmatter

---
layout: post
title: "Getting Started with Jekyll"
date: 2026-10-25 12:00:00 +0000
categories: [development, tools]
tags: [jekyll, static-site]
---

Помощники шаблонов Liquid

Вывод и переменные

{{ site.title }}
{{ page.title }}
{{ content }}

Условия и циклы

{% if page.comments %}
  {% include comments.html %}
{% endif %}

<ul>
  {% for post in site.posts limit:5 %}
    <li><a href="{{ post.url | relative_url }}">{{ post.title }}</a></li>
  {% endfor %}
</ul>

Локальное тестирование

# Установка зависимостей
bundle install

# Запуск локального сервера разработки с live reload
bundle exec jekyll serve --livereload