السمات

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. اخترها في عرض ← السمة، وانظر إلى كلا الجانبين: عرض ← داكن دائما تشغيل وإيقاف. تحقق من أن النص قابل للقراءة وعلامة التركيز مرئية في كليهما.

تحتوي صفحة السمات على الموقع على موجه يمكنك إعطاؤه لمساعد الذكاء الاصطناعي، مع التنسيق، وكل مفتاح والقواعد، لكتابة سمة لك من وصف.

شاركها

هل صنعت شيئا قد يعجب الآخرين؟ افتح طلب سحب يضيفه إلى 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 كيفية عمل طلبات السحب هنا.

الخطوات التالية

• البدء →
• الخيارات →