Внешний вид и брендинг
Внешний вид инстанса
Суперпользователи задают его в home → Инстанс → Внешний вид:
| Настройка |
Что даёт |
| Имя |
показывается под названием каждой панели вместо домена |
| Акцентный цвет |
основной цвет темы во всех панелях |
| Логотип |
PNG, JPEG, WebP, GIF или SVG до 256 КБ — во всех панелях и на странице входа id |
| Фон |
изображение до 2 МБ за каждой панелью, с размытием от 0 до 60 px; поверхности становятся стеклянными |
| Цвета |
переменные темы панелей (фон, карточки, сайдбар, текст…), каждая #rrggbb |
Внешний вид передаётся вместе с публичным каталогом home (GET /api/v1/catalog), который и так читает каждая
панель, поэтому применяется везде сразу — включая эту документацию, где статья поверх фона ложится на
стеклянную карточку. Письма notify и страницы статуса тоже его используют.
Переключатель сервисов
home → Инстанс → Переключатель задаёт порядок, названия, иконки и видимость сервисов в переключателе
каждой панели и добавляет ваши собственные ссылки (другой сайт документации, вики, дашборд).
White-label сборки
xvii можно собрать под другим именем. Бренд задаётся при сборке:
make BRAND=acme DISPLAY="Acme Cloud"
От него производится всё, что брендируется: имена бинарников и юнитов (acme-node, acme-pages.service),
пути (/etc/acme, /var/lib/acme), префиксы переменных окружения (ACME_PAGES_…), метки Docker (acme.*) и
имя, которое видят люди, с подписью «powered by xvii». Протоколы, пути модулей и имена API остаются от xvii:
брендированная сборка — это всё то же ядро xvii, и её релизы ставятся теми же инструментами. Собирайте все
сервисы и CLI с одним и тем же BRAND.