- Главная
- Документация
- Тема
Тема
Внешний вид сайта находится в 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, поставляемый в составе ядра.