Темы

A theme changes how GDM looks and keeps everything where it was: the same windows, menus and buttons in the same places, drawn in other colours, shapes and icons. Each theme has a light and a dark side.

Выбор темы

Откройте Вид → Тема и выберите тему: все окно изменится сразу, перезапускать ничего не нужно. Вид → Поддержка темного режима и Вид → Всегда темная затем выбирают ее светлую или темную сторону, как для классического вида (Темный режим).

The built-in themes are Classic (GDM's own look, the default), Native (your system's accent colour and contrast), High contrast, and the style themes Metro, Adwaita, Breeze, Luna, Aero and Aqua, each with its own control shapes and icons, and on Windows its own title bar. Getting started describes each one; the website's Themes page shows them all, light and dark.

Расположение файлов тем

Theme files you make or download go in GDM's themes folder. View → Theme → Open themes folder opens it (and makes it the first time). It is in GDM's data folder:

В течение двух секунд новый файл появится в Вид → Тема, под встроенными темами, с именем, которое он сам себе присваивает name. После редактирования файла выберите его снова в Вид → Тема, чтобы увидеть изменения.

Тема может быть одним файлом (harbour.toml) или отдельной папкой (harbour/theme.toml), если она содержит значки.

View → Theme → Add a theme file… does it for you: pick a file anywhere, and GDM copies it into the themes folder and uses it at once. A file that isn't a theme stays out, and GDM says why.

Цветовые схемы Base16 и pywal

Цветовые схемы, созданные для других программ, также являются темами, и их не нужно конвертировать:

• Схема Base16, файл .yaml, в котором поставляются схемы Base16 и Base24: как классический макет (scheme: и base00 до base0F вверху), так и новый (name: и блок palette:). Схема Base24 читается как первые 16 цветов.
• Файл colors.json pywal или файл любой программы в формате pywal (шаблон pywal от wallust).

Добавьте его с помощью Вид → Тема → Добавить файл темы… или поместите его в папку тем самостоятельно. Он появится в Вид → Тема под именем схемы (name: или scheme:; схема pywal названа в честь обоев).

pywal itself: once wal has run, View → Theme lists pywal, read straight from where pywal writes its colours: ~/.cache/wal/colors.json (on Windows %USERPROFILE%\.cache\wal\colors.json, where winwal and pywal write it; $PYWAL_CACHE_DIR or $XDG_CACHE_HOME/wal when you set them). Pick it and GDM follows your wallpaper: each time wal writes new colours, GDM takes them within two seconds. It looks only at the file's date and size, every two seconds, and only while pywal is the theme. A copy added with Add a theme file… keeps the colours it had.

A scheme changes colours only, on the classic look: every window, button and menu stays where it was. A dark scheme makes GDM dark and a light one light, whatever View → Always dark says. The scheme's colours go where they mean the same:

Borders and the hover and pressed shades are mixed from these, as for a theme file's [seeds]. Text stays readable: text and secondary text at 4.5:1 or more against every background they sit on (WCAG AA), the accent at 3:1. A scheme short of that has those colours moved a little darker (lighter on a dark scheme) until they pass; GDM's log says which.

Чтобы изменить не только цвета, создайте файл темы, который наследует схему по имени файла и добавляет то, что вам нравится:

name = "Gruvbox, my way"
inherits = "gruvbox-dark-medium"   # gruvbox-dark-medium.yaml, beside it
icons = "accent"

[sizes]
radius = 6

inherits = "pywal"работает так же и также следует wal.

Файл

Тема — это небольшой текстовый файл в формате TOML (или JSON, .json; или цветовая схема, .yaml). Он называет только то, что изменяет; все остальное берется из темы, которую он inherits:

name = "Harbour"
inherits = "classic"
icons = "color"

[seeds.light]
background = "#eef3f6"
surface = "#ffffff"
text = "#11202b"
accent = "#0f6c8c"

[seeds.dark]
background = "#14212a"
surface = "#0e171d"
text = "#e8f0f4"
accent = "#5cc3e6"

[sizes]
radius = 6

[controls]
focus = "ring"

• name — то, что отображается в Вид → Тема; имя файла, если оно не указано.
• inherits — тема, от которой начинается ваша: classic (по умолчанию, если не указана), идентификатор встроенной темы (metro, adwaita, breeze, luna, aero, aqua, high-contrast) или другой файл темы в той же папке, по имени файла без .toml. Файл, который наследует другую тему, может быть унаследован в свою очередь; тема не может наследовать саму себя.
• [seeds] — a handful of colours (background, surface, header, text, accent, selection, error, warning, success) that GDM spreads over every control. [seeds.light] and [seeds.dark] give each side its own.
• [colors] — роли одного цвета (например, window, accent или "segments.done") для обоих режимов; [light] и [dark] только для одного режима. Цвет — это #rrggbb или #rrggbbaa с прозрачностью. Роли, заданные в файле, имеют приоритет над его базовыми цветами.
• [sizes] — радиусы углов, ширина границ, размеры шрифтов и высота строк в пикселях.
• [controls] — форма текстовых полей, флажков, кнопок, индикаторов выполнения, полос прокрутки, маркера фокуса и строки заголовка.
• icons — color, mono (один цвет) или accent.
• contrast = "high" — усиливает каждый край и цвет текста поверх остального.

Every colour role, size and control style, with what it sets, is listed on the website's Themes page (read from GDM's own code, so it never drifts). The built-in themes are written the same way: read them on GitHub.

A key GDM doesn't know, or a value it can't read, is skipped and written to GDM's log (the logs folder beside the themes folder), so a file made for a newer GDM still loads. A file that isn't valid TOML or JSON doesn't load, and the log says why. A file named like a built-in theme (metro.toml) is passed over: give yours a name of its own.

Значки

Тема в собственной папке (harbour/theme.toml) может содержать свои значки в icons/16 и icons/24 (а для изображений PNG — icons/32 и icons/48, используемые на экране с масштабом 150 % и более), каждый из которых назван в соответствии с тем, что он отображает (tb-add-url.svg, cat-music.png…). Файлы SVG и PNG сохраняют свои цвета; файлы -symbolic.svg и -symbolic.png, как их называют GNOME и KDE, принимают цвет текста темы. Значок, которого нет в наборе, отображается так, как его отображает классический вид. Полный список имен находится в themeicons.rs (NEEDS).

Создать тему

1. Вид → Тема → Открыть папку с темами и создайте там новый файл .toml (любой текстовый редактор).
2. Начните с примера выше: измените цвета базовых элементов, затем добавляйте роли и размеры по мере необходимости.
3. Выберите ее в Вид → Тема и посмотрите на обе стороны: Вид → Всегда темная включена и выключена. Убедитесь, что текст читаем, а маркер фокуса виден в обоих режимах.

На странице тем веб-сайта есть подсказка, которую вы можете дать помощнику ИИ, с форматом, каждым ключом и правилами, чтобы он написал тему для вас по описанию.

Поделиться

Создали что-то, что понравится другим? Откройте pull request, который добавит это в crates/app/assets/themes, с:

• файл .toml и его папка с иконками, если таковая имеется;
• скриншоты главного окна в светлом и темном режимах;
• a SOURCES.txt beside any icons, saying who drew them and under which licence. Icons must be your own or under a licence that lets GDM share them (GPL-3.0), never copied from another program.

Не уверены? Сначала обсудите это в дискуссиях. В CONTRIBUTING.md объясняется, как здесь работают запросы на слияние.

Дальнейшие действия

• Начало работы →
• Параметры →