پوسته‌ها

پوسته ظاهر 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 والاست).

آن را با نما → پوسته → افزودن فایل پوسته… اضافه کنید، یا خودتان آن را در پوشه پوسته‌ها قرار دهید. این پوسته در نما → پوسته با نام طرح (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. آن را در نما ← پوسته انتخاب کنید و به هر دو طرف نگاه کنید: نما ← همیشه تیره روشن و خاموش. بررسی کنید که متن خوانا باشد و نشانگر فوکوس در هر دو حالت قابل مشاهده باشد.

صفحه پوسته‌ها وب‌سایت یک دستورالعمل دارد که می‌توانید به یک دستیار هوش مصنوعی بدهید، با فرمت، هر کلید و قوانین، تا یک پوسته را از روی یک توصیف برای شما بنویسد.

آن را به اشتراک بگذارید

چیزی ساخته‌اید که دیگران دوست دارند؟ یک درخواست پول باز کنید که آن را به crates/app/assets/themes اضافه می‌کند، با:

• فایل .toml، و پوشه آیکون‌های آن اگر داشته باشد؛
• تصاویر صفحه اصلی در حالت روشن و تاریک آن؛
• یک SOURCES.txt کنار هر آیکون، که نام طراح و مجوز آن را ذکر کند. آیکون‌ها باید متعلق به خودتان باشند یا تحت مجوزی باشند که MDM اجازه اشتراک‌گذاری آن‌ها را داشته باشد (GPL-3.0)، و هرگز از برنامه دیگری کپی نشده باشند.

هنوز مطمئن نیستید؟ ابتدا آن را در گفتگوها مطرح کنید. CONTRIBUTING.md نحوه کار درخواست‌های پول را در اینجا توضیح می‌دهد.

مراحل بعدی

• شروع به کار →
• گزینه‌ها →