Теми

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 пояснюється, як тут працюють запити на злиття.

Наступні кроки

• Початок роботи →
• Параметри →