Теми

Тема змінює вигляд MDM, зберігаючи все на своїх місцях: ті самі вікна, меню та кнопки, але з іншими кольорами, формами та іконками. Кожна тема має світлу та темну сторони.

Вибрати тему

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

Вбудовані теми: Класична (власний вигляд MDM, за замовчуванням), Власна (акцентний колір та контрастність вашої системи), Висока контрастність, а також стильові теми Метро, Adwaita, Breeze, Luna, Aero та Aqua, кожна зі своїми формами елементів керування та іконками, а на Windows — власною панеллю заголовка. Початок роботи описує кожну з них; сторінка Тем на вебсайті показує їх усі, світлі та темні.

Де зберігаються файли тем

Файли тем, які ви створюєте або завантажуєте, зберігаються в папці тем MDM. Вигляд → Тема → Відкрити папку тем відкриває її (і створює вперше). Вона знаходиться в папці даних MDM:

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

Тема може бути одним файлом (harbour.toml) або власною папкою (harbour/theme.toml), якщо вона містить іконки.

Команда Вигляд → Тема → Додати файл теми… зробить це за вас: виберіть файл будь-де, і MDM скопіює його до папки з темами та одразу застосує. Файл, який не є темою, не буде додано, і MDM пояснить чому.

Кольорові схеми Base16 та pywal

Кольорові схеми, створені для інших програм, також є темами, і їх не потрібно конвертувати:

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

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

Сам pywal: після запуску wal, Вигляд → Тема відобразить pywal, що зчитується безпосередньо з місця, куди pywal записує свої кольори: ~/.cache/wal/colors.json (у Windows %USERPROFILE%\.cache\wal\colors.json, куди його записують winwal та pywal; $PYWAL_CACHE_DIR або $XDG_CACHE_HOME/wal, якщо ви їх встановили). Виберіть його, і MDM буде слідувати за вашими шпалерами: щоразу, коли wal записує нові кольори, MDM застосовує їх протягом двох секунд. Він перевіряє лише дату та розмір файлу кожні дві секунди, і лише тоді, коли pywal є темою. Копія, додана за допомогою Додати файл теми…, зберігає кольори, які вона мала.

Схема змінює лише кольори у класичному вигляді: кожне вікно, кнопка та меню залишаються на своїх місцях. Темна схема робить MDM темним, а світла — світлим, незалежно від налаштування Вигляд → Завжди темна тема. Кольори схеми застосовуються там, де вони мають однакове значення:

Межі, а також відтінки при наведенні та натисканні змішуються з цих кольорів, як для файлу теми [seeds]. Текст залишається читабельним: текст і додатковий текст мають контрастність 4.5:1 або більше до кожного фону, на якому вони розташовані (WCAG AA), акцент — 3:1. Якщо схема не відповідає цим вимогам, ці кольори трохи затемнюються (освітлюються на темній схемі), доки вони не пройдуть перевірку; журнал MDM вказує, які саме.

Щоб змінити більше, ніж кольори, створіть файл теми, який успадковує схему за її іменем файлу та додає те, що вам подобається:

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] — кілька кольорів (background, surface, header, text, accent, selection, error, warning, success), які MDM поширює на кожен елемент керування. [seeds.light] та [seeds.dark] надають кожній стороні свій власний.
• [colors] — ролі одного кольору (такі як window, accent або "segments.done") з обох сторін; [light] та [dark] лише з одного боку. Колір — це #rrggbb, або #rrggbbaa з прозорістю. Ролі, встановлені файлом, переважають над його початковими значеннями.
• [sizes] — радіуси кутів, ширина рамок, розміри шрифтів та висота рядків у пікселях.
• [controls] — форма текстових полів, прапорців, кнопок, індикаторів прогресу, смуг прокрутки, маркера фокусу та панелі заголовка.
• icons — color, mono (один колір) або accent.
• contrast = "high" — посилює кожен край та колір тексту поверх решти.

Кожна роль кольору, розмір та стиль елементів керування, з тим, що вони встановлюють, перераховані на сторінці Тем вебсайту (читаються з власного коду MDM, тому ніколи не відхиляються). Вбудовані теми написані так само: прочитайте їх на GitHub.

Ключ, який MDM не знає, або значення, яке він не може прочитати, пропускається та записується до журналу MDM (папка logs поруч із папкою тем), тому файл, створений для новішої версії MDM, все одно завантажується. Файл, який не є дійсним TOML або JSON, не завантажується, і журнал вказує причину. Файл, названий як вбудована тема (metro.toml), пропускається: дайте своєму файлу власну назву.

Іконки

Тема у власній папці (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 та його папку з іконками, якщо вона є;
• знімки головного вікна у світлому та темному режимах;
• значок SOURCES.txt поруч із будь-якими іншими значками, із зазначенням автора та ліцензії. Значки мають бути вашими власними або під ліцензією, що дозволяє MDM ділитися ними (GPL-3.0), ніколи не копіюватися з іншої програми.

Ще не впевнені? Спершу покажіть це в обговореннях. У файлі CONTRIBUTING.md пояснюється, як тут працюють запити на злиття.

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

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