Template-репозитории

Как устроены recipe-репозитории и когда их стоит кастомизировать.

Template-репозитории — базовый путь запуска Notepub для большинства пользователей.

Официальные template-репозитории

Шаблон блога: https://github.com/cookiespooky/notepub-recipe-blog
Шаблон документации: https://github.com/cookiespooky/notepub-recipe-docs
Шаблон контент-репозитория для режима content_repo: https://github.com/cookiespooky/np-content-template

Что дает template repo

Рабочие config.yaml и rules.yaml.
Стартовую тему в theme/.
Начальный контент в content/.
CI workflow для validate + build + deploy.

Минимальная последовательность кастомизации

Обновите site.base_url.
Замените стартовые контент-файлы.
Обновите брендовые параметры (site.title, site.description, ассеты темы).
Меняйте правила, когда типовая модель уже не покрывает ваши сценарии.

Когда стоит форкать workflow

Если вам нужно:

несколько окружений/стадий деплоя
более строгие валидации в CI
своя политика версий бинарника
деплой не в GitHub

Стратегия обновлений

Контент и правила держите как главный источник истины.
Обновляйте версию notepub в CI постепенно.
Перед rollout всегда запускайте validate.