Макеты и композиция
Эта часть описывает, как задать целую страницу так, чтобы её можно было хранить, проверять, собирать на сервере и в браузере, редактировать мышью и публиковать без риска показать посетителю половину результата.
Для этого во Framework есть макет — проверяемое JSON-описание страницы.
Всё, что связано с макетами, в коде называется композицией
(SF.Composition, схемы simai.composition.*).
Recipe имеет статус experimental (словарь жизненного цикла манифестов):
стандарт опубликован, его применение во внешних проектах ещё не принято.
Сквозной пример части — статья с двумя вариантами шапки. Один Recipe содержит общий шаблон страницы, место для шапки и место для текста. Настройка выбирает краткую или расширенную шапку, текст статьи приходит из проекта, а Framework собирает из этого один готовый Document и превращает его в HTML.
Как читать: главы Что такое макет и зачем он–Слоты и порядок нужны всем, кто собирает страницы. Главы Шаблоны, вставки и варианты–Содержимое и данные — тем, кто подключает макеты к продукту и данным. Глава Редактор страниц — тем, кто строит редактор страниц. Глава Справочные темы собирает справочные темы, Примеры — разбор примеров.
Связь с другими частями
Эта глава перечисляет, где в руководстве описано то, на что опираются макеты.
- Компоненты, которые становятся типами макета, — Что такое компонент; Smart-компоненты, составные компоненты, маршруты и порты хоста — Составные компоненты и Связь с приложением: порты хоста и намерения.
- Страница рабочего интерфейса из фрагментов и смена области содержимого без полной загрузки — Фрагменты интерфейса и Навигация по областям страницы.
- Утилиты раскладки, которыми оформлен полученный HTML, — Раскладка.
- Закрепление выпуска и обновление — Версии: как закрепить выпуск и Как обновить проект.
- Стандарт Composition Recipe среди других стандартов — Recipe (
simai.composition-recipe); проверки и работа с ИИ — Как Framework проверяет себя и Работа с ИИ.