Тема

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

XSLT-шаблони

Конфігураційний ключ document.transformer вказує на головний шаблон, main.xslt, розташований у site/modules/main/transformers/. Він підключає шаблони ядра для модулів share і user, а потім власні шаблони сайту:

  • energine.xslt — сторінка: посилання-пропуск; шапка з назвою сайту, головним меню, перемикачем мов і посиланням для входу; 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 та системні шрифти шрифт: системні або власні файли, ніколи не сторонні адреси

Темна схема перевизначає кольори всередині @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/, і кожна сторінка отримує їхню карту імпорту: ім'я модуля — це шлях без .js, а адреса містить час останньої зміни файлу. Власні скрипти сайту розміщуються в site/modules/main/scripts/, який прив'язаний до web/scripts/main/. Новий скрипт потрапляє до карти імпорту після виконання php index.php setup linker; він має належати користувачу сайту. Компоненти вказують свої скрипти у конфігураціях (<javascript><behavior name="…"/>), а порожній шаблон match="/" mode="scripts" у document.xslt — це місце для власних скриптів.

Візуальний редактор — Jodit, що постачається разом із ядром.