- Головна
- Документація
- Тема
Тема
Вигляд сайту зберігається в 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, що постачається разом із ядром.