О демо-сайте

Это exampleSite темы: демонстрация и одновременно её документация. Всё содержимое — гайды о самой теме, и каждый описанный механизм работает прямо на той странице, которая его описывает.

#Что это

Демо-сайт живой темы для учебных гайдов. Здесь нет выдуманных статей: рубрика «Приёмы» — руководство пользователя темы, «Устройство» — разбор её внутренностей, «Справочник» — полигон компонентов и справка по управлению. Расхождение текста с поведением страницы считается багом.

#Из чего собран

Hugo (обычный бинарь, не extended) плюс Pagefind для полнотекстового поиска — два standalone-инструмента, без Node. Полная сборка:

сборка демо

hugo && pagefind --site public

Раздел «Песочница» — авторский раздел этого сайта, в теме от него нет ни следа: живой пример того, как темой пользуются, не форкая её.

#Где тема

Пути ниже — плейсхолдеры exampleSite; в своём сайте подставь реальные адреса:

репозиторий темы — github.com/user/theme;
документация — каталог docs/ темы: authoring.md (как писать гайды), customizing.md (кастомизация без форка), i18n.md (как добавить язык), params.md (реестр параметров);
лента этого демо — /ru/index.xml, управление читалкой — в «Горячих клавишах».