Шаблоны и Vue
Каркас сайта, язык шаблонов Vue-HTML на сервере и Vue 3 как остров интерактивности поверх готового HTML.

Скин: каркас, шапка и подвал
Скин — внешний вид сайта вокруг блоков: шапка, подвал, каркас страницы, меню и стили. Файлы вёрстки имеют расширение .sehtml — это обычный HTML с «дырками» вида {{ … }}, которые заполняет ядро.
www/templates/
pages/base.sehtml каркас: весь документ от <!doctype> до </html>
pages/default.sehtml страница по умолчанию: {{ extends:base }} и свои слоты
partials/header.sehtml шапка: логотип, меню, телефон
partials/footer.sehtml подвал
menus/menu.tpl.html вёрстка меню целикомТри папки — три роли: pages/ — документ целиком (ядро берёт его по полю «Шаблон» страницы), partials/ — куски вёрстки, которые вы вставляете сами через {{ partial:header }}, menus/ — вёрстка меню, которую ядро подставляет на {{ menu:имя }}.
Стилям и скриптам в templates/ места нет — их дом frontend/styles и frontend/scripts. Собранный результат уезжает в public/skin — там лежат готовые файлы, а не исходники.
Ссылки на картинки и шрифты в SCSS можно писать как удобно — сборка сама переведёт их на итоговый путь с content-hash. Единственное исключение — одинаковые имена файлов в разных папках: такую ссылку сборка оставит как написана.
Vue-HTML на сервере и Vue 3 в браузере
В шаблонах модулей и меню работает Vue-HTML — язык, нарочно похожий на Vue, но выполняемый на сервере. Никакого Vue в браузере для этого не нужно.
{{ title }}— вставить значение;{{ raw:text }}— вставить готовый HTML как есть;v-if,v-else-if,v-else— условия;v-for="rec in records"— повтор по списку;:атрибут="выражение"— значение атрибута из выражения;<ns:Name />— подключить компонент из_components/ns/name.tpl.html.
В выражениях доступны сравнения, логические операторы, арифметика, склейка строк и тернарный оператор. А вот методов у значений, стрелочных функций, шаблонных строк и дат в языке нет: если нужного не хватает, значение готовится на стороне модуля и приходит в шаблон готовым.
Одна особенность, которая экономит время: ложны только null, false, 0 и пустая строка; строка "0", пустой список и пустой объект — истинны.
Где работает полный язык
Циклы и :bind-атрибуты имеют смысл в шаблонах модулей и меню. В каркасах страниц (.sehtml) работает подстановка токенов и ветвление v-if.
Vue 3 — остров поверх готового HTML
Там, где нужна настоящая интерактивность — корзина, фильтры каталога, вкладки с подгрузкой — подключается Vue 3. Исходники острова живут в папке frontend/ рядом с модулем (обычные .vue-компоненты), собираются vite и подключаются в module.compose.json.
Принцип один: сначала сервер отдаёт осмысленную разметку, а Vue гидрирует её поверх — страница целиком на Vue не строится. Без JavaScript блок остаётся читаемым. Стартовые данные и все видимые подписи приходят острову с сервера отдельным JSON, поэтому тексты не попадают в бандл и локализация остаётся на сервере.

Справочник Vue-HTML
Vue-HTML — серверный язык шаблонов модулей и меню. Он поддерживает безопасные подстановки, условия, циклы, вычисляемые атрибуты, небольшой набор функций и серверные компоненты. В браузер уходит уже готовый HTML.
<article v-for="item in records" :class="{ 'is-active': item.active == '1' }">
<h3>{{ item.title }}</h3>
<a :href="item.url">Подробнее</a>
</article>Это не полный JavaScript: методов объектов, стрелочных функций, ?., DOM и сетевых запросов в шаблоне нет. Неподдерживаемая форма обычно даёт пустое значение, поэтому диагностика шаблонов обязательна.
Открыть полный справочник по Vue-HTML: подключение файлов, данные, весь синтаксис, компоненты, три законченных примера, Vue 3 и поиск ошибок.
Компоненты и безопасный вывод
Повторяющуюся разметку модуля удобно вынести в серверный компонент. Компоненты модуля лежат в templates/_components/<имя-модуля>/ и вызываются с пространством имён:
<product_grid:Card
v-for="item in records"
:title="item.title"
:url="item.url"
/>
Так карточка остаётся частью серверного рендера: она получает свойства, может использовать условия и вложенные компоненты, а браузер сразу видит итоговый HTML. Общие компоненты можно применять в нескольких модулях, локальные принадлежат одному типу блока.
Экранирование
Обычная вставка {{ value }} экранирует специальные символы и подходит для пользовательского текста. {{ raw:value }} и v-html вставляют разметку без экранирования, поэтому их используют только для HTML из доверенного редактора или системного источника. Данные формы, URL-параметры и внешний ответ нельзя выводить как raw без очистки.
Граница с браузерным кодом
Vue-HTML создаёт разметку на сервере. Небольшой браузерный сценарий добавляет поведение, а Vue 3 нужен только сложному интерактивному состоянию. Хороший модуль сохраняет заголовки, текст, ссылки и основной список в исходном HTML, даже если интерактивная часть ещё не загрузилась.
Практические способы расширения собраны на странице JavaScript и расширение платформы.

Каркас страницы: рабочий пример
Базовый каркас содержит весь HTML-документ. Ядро не прячет шапку документа снаружи шаблона: разработчик видит порядок SEO-токенов, стилей, содержимого и сценариев.
<!doctype html>
<html lang="{{ head:lang }}">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
{{ head:title_tag }}
{{ head:meta }}
{{ head:styles }}
{{ head:page_head }}
</head>
<body class="page">
{{ partial:header }}
<main>
<h1>{{ pagevar:title }}</h1>
{{ content:0 }}
</main>
{{ partial:footer }}
{{ footer_scripts }}
</body>
</html>
Дочерний шаблон может состоять из одной строки {{ extends:base }}. Если странице нужна другая структура, она заменяет именованный слот через fill, а остальные части наследует.
Каждый контейнер content:N выводят один раз. Повтор токена повторит и все разделы контейнера. Меню подключается по имени, частичный шаблон по имени файла, а стили и JavaScript остаются в frontend/, а не внутри templates/.
Все шаги документации
Шаг 5 из 11 — Шаблоны и Vue-HTML