Skip to main content

Частые вопросы

Для визуального редактора — нет. Для адресных изменений достаточно основ CSS из этого руководства; JavaScript писать не нужно.
Да: 20 цветов палитры, свечение и дополнительные цвета статусов настраиваются визуально.
Да, по имени установленной гарнитуры или файлом через редактор. Некоторые редакторы кода используют собственную гарнитуру.
Да, штатный фон поддерживает оба вида. Через CSS можно использовать изображения для подходящих свойств/иконок. Для переноса локального медиа нужен сам ресурс, удобнее архив темы.
Да. Выберите светлый режим и согласуйте весь набор поверхностей и текста; не ограничивайтесь одним фоном.
Да, с контекстом data-page или собственным маркером компонента. Портальные окна выбирайте отдельно.
Да, но фиксированные размеры, масштаб текста и позиционирование могут сломать размещение. Начните с локальных правок и проверьте минимум окна.
Они используют другой токен, собственный цвет/inline-стиль либо другой документ/canvas. Смотрите Computed и структуру.
Условия отображения, вложенность и внутренние узлы библиотек могут меняться. Публичные ID/data-адреса защищены контрактом API v1; проверка test:theme-api обнаруживает их удаление. Сравните также каскад и контекст страницы.
Да: экспортировать CSS с папкой ресурсов или локальный .xntheme; облачный перенос тоже остаётся доступен. Официальная публичная площадка тем этим кодом не подтверждена.
Выберите Core. В редакторе доступен отдельный сброс к тёмной базе, который нужно сохранить.
Пройдите список проверок качества, сохраните, перезапустите и проверьте фокус, диалоги, загрузку и ошибки.
Только после адаптации. Чужие .button и .card не создают соответствующие элементы в Xneon Launcher; проверьте URL, лицензии ресурсов и реальные адреса.
Новые действия, IPC, вкладки, данные, алгоритмы запуска и отрисовка содержимого 3D-превью. Обычная тема не меняет эту логику.
Экспортируйте .xntheme на карточке темы и импортируйте архив в настройках другого лаунчера.

Обмен темами и шаблон публикации

Текст CSS

Для обмена отдельными правилами скопируйте их из встроенного редактора. Для переноса всей темы используйте архив .xntheme.

Локальный архив и облачный перенос

На карточке своей темы нажмите «Экспорт .xntheme». Для установки на другом устройстве нажмите «Импорт .xntheme» и выберите архив. Он сохраняется как отдельная тема с новым ID, записывается в локальную папку и сразу выбирается. Это отличается от облачного импорта, после которого тему выбирают отдельно. Архив переносит также CSS статей и зависимости вложенных локальных таблиц стилей. В текущей реализации вход в перенос находится в «Облако»: подключите поддерживаемое хранилище, откройте загрузку, выберите вкладку «Темы», затем нужную свою тему. Лаунчер создаёт .xntheme в папке themes провайдера. Подписи могут быть «Выбрать»/«Загрузить» в зависимости от этапа UI. Этот путь можно использовать наряду с прямым локальным экспортом. Для восстановления откройте «Облако → Темы» и действие импорта у .xntheme. Тема добавляется в «Мои темы» с новым ID, не перезаписывая существующую. После импорта выберите её в настройках: обработчик импорта не выбирает её автоматически. Архив содержит theme.json формата xneon-theme, версия 1, и локальные assets/<hash>.<ext>. В него входят структурированные настройки, CSS и обнаруженные локальные ресурсы xnl-theme. Внешние HTTP-ресурсы остаются ссылками и не скачиваются автоматически. Относительные ресурсы файловой темы предварительно материализуются в управляемые ссылки; вложенные CSS и их ресурсы включаются в архив. Ограничения обработчика: манифест до 1 МиБ, один медиафайл до 128 МиБ, общий лимит медиа/архива 512 МиБ, не более 1024 записей. Проверяются имена, контрольные суммы и наличие упомянутых локальных ресурсов. Удаление темы из «Моих тем» не является удалением облачного архива; облачные файлы управляются отдельно.

Шаблон описания

Скопируйте этот Markdown и заполните поля. Это шаблон публикации, не манифест импорта.

Источники и проверка документации

Исследованы импорты CSS, все собственные CSS-файлы renderer и заставка, JSX в src/ и components/, модель/парсер/реестр/редактор/превью тем, слой медиа и шрифтов, протокол локальных файлов, облачная упаковка и восстановление, настройки BrowserWindow и DevTools. В справочник вошли оболочка, главная, сборки и содержимое, каталоги, серверы и файлы, аккаунты, скины/Laby, логи, статистика, облако, настройки, onboarding, AI и общие контролы/диалоги. Дополнительные ключевые источники: Статические справочники воспроизводятся из корня репозитория командой:
Она перезаписывает только docs/CSS_REFERENCE.md, docs/THEME_VARIABLES.md и временную инвентаризацию .tmp/themeguide/inventory.json. Для работы нужны зависимости репозитория. При изменении числа записей обновите также числа в этом руководстве. Строки обычных CSS-правил подтверждают объявление, а не обязательное использование: например, старый .log-line может не совпадать с текущей разметкой страницы логов. Временная заставка и библиотечные Root/Portal отдельно помечены. Основная проверка темы и её парсера:
Для проверки всего приложения в своей рабочей копии:
Иллюстрированное обновление от 25 октября 2026 года проверено отдельно:
  • Созданы и визуально просмотрены все 9 PNG из настоящих компонентов в изолированном Electron.
  • Все 40 CSS-примеров разобраны PostCSS без синтаксических ошибок.
  • Проверены файловые ссылки Markdown, включая все изображения: отсутствующих файлов нет.
  • Сценарий воспроизведения иллюстраций: node scripts/generate-theme-guide-images.mjs; профиль и сборка находятся в .tmp/theme-guide-images/.
Следующий список сохранён из предыдущей редакции документации от 24 октября. Эти прогоны не повторялись при добавлении иллюстраций:
  • pnpm run build — успешно, включая renderer, проверку TypeScript и Electron main.
  • pnpm run test:themes — все 64 проверки прошли, включая порядок импортов и независимость файлов дубликатов.
  • pnpm run test:theme-files — 19 проверок файловой библиотеки, ресурсов, IPC и наблюдателя.
  • pnpm run test:theme-integration — 18 проверок: импорт/экспорт через React-интерфейс, внешняя правка, изменения из main, токены поверхностей и радиусов, общий CSS внутри настоящего webview.
  • pnpm run test:themes:cloud — 10 проверок переноса и восстановления архивов.
  • pnpm run test:agent — 91 проверка помощника, включая изменение тем через настройки.
  • pnpm run test:theme-api — контроль сохранности публичных адресов API v1.
  • Все 40 CSS-примеров разобраны PostCSS и приняты CSSStyleSheet в Electron.
  • Локальные ссылки, явные якоря оглавления, переменные и ID примеров сверены с файлами и инвентаризацией.
  • В изолированном скрытом окне Electron с отдельным временным профилем проверены цвета Midnight, радиусы кнопки и карточки, disabled, сохранение правила фокуса в CSSOM, повторный разбор/сериализация, отключение CSS и очистка при выборе Core. Использовались настоящие src/index.css и функции модели темы с небольшим тестовым DOM. Совокупно этот прогон содержит 55 проверок, включая принятие 40 примеров.
Полный интерактивный обход всех страниц настоящего лаунчера не выполнен. Наличие маркера в исходниках не гарантирует его доступность при любых данных. Наведение, клавиатурный фокус в активном окне, все варианты WebGL-превью и производительность на больших списках требуют ручного прохода из раздела «Проверка качества»; принятие правила фокуса в CSSOM не заменяет эту проверку. Файловая библиотека, стили статьи, токены и API селекторов добавлены вместе с обновлением этого руководства.