Files
flexly-cms/design/examples/site-studio/README.md
T
phelex 0d171915d7 Add Site Studio themes and Theme Manager
Support categorized fragments, theme presets, block widths, and server-backed theme editing with onboarding and preview.

Include Site Studio, design sources, specification and verification reports; remove the legacy studio-site example.
2026-11-13 14:04:49 +03:00

6.2 KiB

Site Studio — пример file-first сайта для Site Engine

Это полный файловый seed студии автоматизации, который собирает воедино демонстрационные страницы, блоки, записи и настройки из HTML-превью Site Engine. Все данные и контакты вымышлены. Это не production-сайт и не подтверждение работы FastAPI или BuildService.

Каталоги

  • site.yaml — сайт, маршруты, фичи и ссылка на тему; theme.yaml — пресет + overrides, кастомные цвета и опциональные градиенты. Отдельный файл темы предложен в ADR-007 (решение ещё требует утверждения).
  • pages/**/*.md — ручные страницы с YAML front matter, regions.main, стабильными ID блоков и Markdown body.
  • collections/*.yaml — схемы пяти типов записей. content/<collection>/*.md — записи (8 шт.); courses и posts специально выключены и не содержат записей.
  • display/*.yaml — правила сборки страниц из Entry, layouts/*/layout.yaml и layout.html.j2 — регионы и fixed header/footer.
  • fragments/<категория>/<id>/ — по одному fragment.yaml, template.html.j2, preview.yaml для каждого фрагмента.
  • menus/, data/, forms/, redirects.yaml — навигация, общие данные, схемы форм, редиректы.
  • assets/ — собственные локальные абстрактные иллюстрации-заглушки (не реальные фотографии), метаданные, CSS и JavaScript сайта.
  • tools/render_preview.py — вспомогательный мини-рендерер для просмотра файлов в браузере; не заменяет production engine и не моделирует ReleaseService.
  • preview-dist/ — статические HTML-страницы, уже собранные мини-рендерером для просмотра без backend.

Подробное сопоставление экранов и файлов — SOURCE_MAP.md.

Что совпадает с демо

Главная: Hero «Автоматизируем бизнес с помощью AI», services_list, преимущества, этапы, CTA. Есть «Услуги», «О компании», «Контакты», «Заявка», «Политика», «Спасибо», списки кейсов и сценариев. Записи services/bots, services/ai, services/automation, scenarios/legal, scenarios/real-estate, scenarios/services, cases/ai-reception, cases/booking отражают имена и содержимое редактора Content. form_contact соответствует настройкам форм Stage 6.

Нормализация прототипа: в разных HTML-модулях встречаются пути media/*.webp и assets/*.webp, ID layouts/standard vs layouts/default, разные mock-наборы и несколько независимых localStorage. Здесь все источники сведены в одну файловую модель с каноническим каталогом assets/. Поэтому отдельные имена/пути отличаются от локальных моков, а существующие HTML-редакторы ещё не читают эти файлы напрямую. Это произойдёт только после подключения сервисного слоя.

content/cases/booking.md — преднамеренный черновик с отсутствующим assets/missing-cover.webp, для проверки UI-валидации. Он не включается в live preview. Настоящий релиз должен блокировать публикацию битых ссылок, если такая запись входит в кандидат.

Локальный просмотр

Открой preview-dist/index.html двойным нажатием — относительные ссылки на страницы и ассеты работают без запуска сервера. При изменении YAML/Markdown можно пересобрать demo-preview командой:

python tools/render_preview.py

Зависимости мини-рендерера: PyYAML, Jinja2, mistune, Pillow нужен только для повторной генерации графических ассетов из сценария сборки. Сам preview-dist/ полностью автономен и не требует Python.

Безопасность

Никаких alert(), confirm() или prompt(); формы в preview не отправляют данные. Пароли, API-токены, заявки, реальный контактный адрес или личные данные в примере отсутствуют. site.example и studio.example — демонстрационные значения. UI-статусы published не означают, что релиз действительно публиковался сервером.

Container modes (новое)

theme.yaml задаёт глобальный режим boxed | fluid | full, max_width, отступы для desktop/tablet/mobile. Пример главной pages/index.md: Hero full background + boxed text, services_list fluid section + fluid content, CTA full + boxed. Все остальные фрагменты наследуют настройки, если не переопределено layout блока. preview-dist пересобирается через python tools/render_preview.py. Админка Theme Manager и оба Конструктора показывают те же варианты в рамках mock.