Тема

Внешний вид сайта находится в site/modules/main/: представления XSLT преобразуют XML-документ каждой страницы в HTML, а единая таблица стилей, собранная с помощью Tailwind CSS, отвечает за его оформление. Тема работает на экранах от 320 px до широкоформатных мониторов, поддерживает светлую и тёмную темы, а также версию для печати, и ничего не загружает со сторонних адресов.

Представления XSLT

Параметр конфигурации document.transformer указывает главное представление — main.xslt в site/modules/main/transformers/. Оно подключает представления ядра для модулей share и user, а затем собственные представления сайта:

  • energine.xslt — страница: ссылка для быстрого перехода к содержимому (skip link); шапка с названием сайта, главным меню, переключателем языков и ссылкой для входа; тег main с хлебными крошками и контентом; боковая колонка, если в шаблоне контента есть контейнер aside; текст подвала.
  • sections.xslt — восемь секций шаблонов страниц.
  • ui.xslt — именованные шаблоны для кнопок (ui-button с вариантами primary, plain и link), сообщений (ui-alert, ok или error) и заголовков секций, а также общие списки классов, такие как UI_CONTAINER для ширины страницы.

Представления написаны на XSLT 1.0 с функциями EXSLT dyn. Шаблон сайта переопределяет шаблон ядра с помощью более высокого priority. Тег <head> формируется в document.xslt ядра.

XSLT экранирует вывод по умолчанию. Везде, где тема выводит пользовательский HTML без экранирования, директива disable-output-escaping сопровождается комментарием d-o-e: <reason>; тест репозитория tests/xslt-escaping.php завершится ошибкой, если комментарий отсутствует.

Таблицы стилей

Браузеры загружают один файл — stylesheets/main/main.css. Он собирается из site/modules/main/stylesheets/tailwind.css (Tailwind CSS v4) и хранится в репозитории, поэтому сайт работает без инструментов сборки: Tailwind требуется только для изменения темы. Файл tailwind.css импортирует theme.css, где объявлены переменные темы:

Переменная Светлая Назначение
--bg, --bg-soft #ffffff, #f4f5f7 фон страницы и мягкий фон
--fg, --muted #1d2128, #5d6573 текст и второстепенный текст
--border #d9dde3 разделители и рамки
--accent, --accent-fg #1f5fae, #ffffff основной цвет и текст на нём
--danger, --danger-bg, --ok-bg, --field-bg #b3261e, #fdecea, #e8f4ea, #ffffff ошибки, успешные действия, поля форм
--radius .5rem радиус скругления
--wrap 72rem ширина страницы
--font system-ui and system fonts шрифт: системные шрифты или собственные файлы, без сторонних адресов

Тёмная цветовая схема переопределяет цвета внутри @media (prefers-color-scheme: dark) и следует системным настройкам посетителя. Изменяйте значения, сохраняя имена; поддерживайте контрастность текста и кнопок на уровне не менее 4.5:1 в обеих схемах. tailwind.css сопоставляет переменные с токенами Tailwind, такими как bg-primary и text-muted, и извлекает классы из XSLT сайта. Стили для печати задают белый фон, чёрный текст и ссылки, а также скрывают меню, служебные панели и кнопки форм.

Пересборка после изменений:

bash ../private/energine/tools/get-tailwind.sh   # once per machine: Tailwind CSS v4 standalone, checked by its checksum
php index.php setup css

setup css собирает main.css и admin.css панели управления; тест репозитория tests/css-build.sh завершится ошибкой, если любой из них отличается от свежей сборки своего исходника. Стили панели управления отделены: они загружаются только для администраторов.

JavaScript

Скрипты представляют собой чистые ES-модули без шага сборки. Команда setup linker создает символические ссылки на каждый скрипт в web/scripts/, а каждая страница получает их карту импорта (import map): имя модуля — это путь без .js, а адрес содержит время изменения файла. Собственные скрипты сайта помещаются в site/modules/main/scripts/, на который указывает ссылка из web/scripts/main/. Новый скрипт попадает в карту импорта после выполнения php index.php setup linker; владельцем файла должен быть пользователь сайта. Компоненты указывают свои скрипты в конфигурационных файлах (<javascript><behavior name="…"/>), а пустой шаблон match="/" mode="scripts" в document.xslt служит местом для подключения собственных скриптов.

В качестве визуального редактора используется Jodit, поставляемый в составе ядра.