یک پنجره، به سلیقه‌ی شما

پوسته‌ی خود را بسازید

یک پوسته یک فایل متنی کوچک است، در قالب TOML (یا JSON). فقط آنچه را که تغییر می‌دهد نام می‌برد؛ هر چیز دیگری از پوسته‌ای که بر اساس آن ساخته شده است می‌آید. نیازی به ساخت MDM یا دانستن برنامه‌نویسی ندارید.

1. آن را بسازید

   با چند رنگ شروع کنید، سپس به تدریج رنگ‌های بیشتری اضافه کنید:

   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"

   • inheritsپوسته‌ای است که پوسته‌ی شما از آن شروع می‌شود: classic (پیش‌فرض)، high-contrast، metro، adwaita، breeze، luna، aero، aqua، یا یک فایل پوسته‌ی دیگر در همان پوشه.
   • [seeds]تعدادی رنگ (background، surface، header، text، accent، selection، error، warning، success) هستند که MDM آن‌ها را روی هر کنترل پخش می‌کند. [seeds.light] و [seeds.dark] به هر حالت رنگ خاص خود را می‌دهند.
   • [colors]نقش‌های تک‌رنگ را در هر دو حالت تنظیم می‌کند، [light] و [dark] فقط در یک حالت: #rrggbb، یا #rrggbbaa با شفافیت.
   • [sizes]شعاع گوشه‌ها، عرض حاشیه‌ها، اندازه‌ی فونت و ارتفاع ردیف‌ها، بر حسب پیکسل هستند. [controls] شکل جعبه‌های متن، چک‌باکس‌ها، دکمه‌ها، نوارهای پیشرفت، نوارهای اسکرول، نشانگر فوکوس و نوار عنوان را انتخاب می‌کند.
   • iconsبه صورت color، mono یا accent است. یک پوسته در پوشه خودش (my-theme/theme.toml) می‌تواند آیکون‌هایش را در icons/16 و icons/24 بیاورد که هر کدام بر اساس چیزی که نشان می‌دهند نام‌گذاری شده‌اند (tb-add-url.svg، cat-music.png)؛ آیکون‌های -symbolic رنگ متن پوسته را می‌گیرند.
   • contrast = "high"هر لبه و رنگ متن را در بالا تقویت می‌کند.

   کلیدی که MDM نمی‌شناسد، یا مقداری که نمی‌تواند بخواند، نادیده گرفته شده و در گزارش MDM (پوشه logs در کنار پوشه پوسته‌ها) نوشته می‌شود تا فایلی که برای MDM جدیدتر ساخته شده، همچنان بارگیری شود. پوسته‌های داخلی نیز به همین شیوه نوشته شده‌اند: آن‌ها را در GitHub بخوانید.

   هر نقش رنگ (156)

   کلید	چه چیزی را رنگ می‌کند
   window	Windows' and dialogs' background
   text	متن و گلیف‌ها
   text.disabled	متن غیرفعال، تنها رنگ خاکستری هر کنترل و برچسب خاکستری‌شده
   text.muted	متن ثانویه: یادداشت‌ها، اندازه‌ها، نسخه‌ها
   link	متنی که چیزی را باز می‌کند
   error	متن خطا
   error.strong	پیام یک بررسی ناموفق در گزینه‌ها (تست‌های اتصال، مرورگر و کمک‌کننده)
   warning	متن هشدار
   success	متن موفقیت (یک جمع کنترلی منطبق)
   reach.near	سرور یک بارگیری نزدیک به زمان رفت و برگشت آن (زیر 60 میلی‌ثانیه)، در ویژگی‌ها
   reach.medium	سروری با زمان رفت و برگشت متوسط (60 تا 150 میلی‌ثانیه)
   reach.far	سروری دور با زمان رفت و برگشت آن (بیش از 150 میلی‌ثانیه)
   flag.edge	لبه نازک اطراف پرچم یک کشور
   accent	رنگ برجسته: خطوط فوکوس، کنترل‌های باز و پیش‌فرض، فیلترها، فوکوس پیوندها
   focus.ring	مستطیل نقطه‌چین فوکوس صفحه‌کلید
   selection	پرکننده یک انتخاب: ردیف‌ها، یک روز انتخاب‌شده، متن انتخاب‌شده
   selection.text	متن روی انتخاب
   selection.muted	متن ثانویه روی انتخاب
   selection.inactive	یک ردیف انتخاب‌شده در فهرستی بدون فوکوس
   selection.focus	خط‌چین نقطه‌چین ردیف فوکوس‌شده روی یک ردیف انتخاب‌شده
   group.line	قاب یک کادر گروه
   etch.shadow	خط سایه یک جداکننده حکاکی‌شده
   etch.light	خط برجسته یک جداکننده حکاکی‌شده
   tab.page	بدنه یک صفحه تب
   tab	زبانه انتخاب‌نشده و سایه صفحه
   tab.hot	زبانه زیر نشانگر
   chevron	پیکان کشویی یا جعبه چرخان
   chevron.disabled	پیکان خاکستری‌شده
   subtle.hot	بخشی بدون ظاهر خاص (پیکان، سربرگ ستون) زیر نشانگر
   subtle.pressed	چنین بخشی که فشرده یا باز شده است
   highlight.hot	روز یا پیکان تقویم زیر نشانگر، هدف رها کردن
   highlight.pressed	روز یا پیکان تقویم فشرده‌شده
   field	درون جعبه متن یا فهرست
   field.border	حاشیه جعبه متن
   field.bottom	خط پایینی جعبه متن در حالت تایپ
   field.disabled	درون جعبه متن خاکستری‌شده
   field.disabled.border	حاشیه جعبه متن خاکستری‌شده
   field.readonly	درون جعبه متن فقط خواندنی
   field.readonly.border	حاشیه جعبه متن فقط خواندنی
   combo.chevron	علامت پیکان کشویی
   combo.arrow.hot	ناحیه پیکان کشویی قابل ویرایش زیر نشانگر
   combo.arrow.pressed	ناحیه پیکان کشویی قابل ویرایش فشرده یا باز شده
   button	ظاهر دکمه
   button.hot	ظاهر دکمه زیر نشانگر
   button.pressed	ظاهر دکمه فشرده‌شده
   button.border	حاشیه دکمه
   button.bottom	لبه پایینی دکمه
   button.text	متن دکمه
   button.text.pressed	متن دکمه فشرده‌شده
   button.default.border	حاشیه دکمه پیش‌فرض
   button.default.bottom	لبه پایینی دکمه پیش‌فرض
   button.disabled	ظاهر دکمه خاکستری‌شده
   button.disabled.border	حاشیه دکمه خاکستری‌شده
   button.accent	ظاهر دکمه برجسته
   button.accent.hot	روی دکمه برجسته زیر نشانگر
   button.accent.pressed	روی دکمه برجسته فشرده‌شده
   button.accent.bottom	لبه پایینی دکمه برجسته
   button.accent.text	متن دکمه برجسته
   button.accent.text.pressed	متن دکمه برجسته فشرده‌شده
   button.glow	درخشش داخل دکمه زیر نشانگر، در صورت وجود (Luna؛ شفاف: هیچ)
   gloss	درخشش براق که بخش‌های بالایی دکمه‌ها، کادرها، نوارها و نوارهای عنوان به آن می‌رسند (Luna، Aero، Aqua)
   check	داخل کادر یا دکمه رادیویی انتخاب‌نشده
   check.hot	داخل آن زیر نشانگر
   check.pressed	داخل آن فشرده‌شده
   check.border	حاشیه کادر یا دکمه رادیویی انتخاب‌نشده
   check.border.hot	حاشیه آن زیر نشانگر
   check.border.pressed	حاشیه آن فشرده‌شده
   check.border.disabled	حاشیه کادر انتخاب‌نشده خاکستری‌شده
   check.on	برجسته کادر یا دکمه رادیویی انتخاب‌شده
   check.on.hot	برجسته انتخاب‌شده زیر نشانگر
   check.on.pressed	برجسته انتخاب‌شده فشرده‌شده
   check.on.disabled	پرکننده کادر انتخاب‌شده خاکستری‌شده
   check.mark	علامت تیک یا نقطه روی برجسته انتخاب‌شده
   progress.track	مسیر نوار پیشرفت
   progress.bar	پرکننده نوار پیشرفت
   meter.track	مسیر یک متر (بخش انجام‌شده بارگیری)
   meter.edge	لبه یک متر
   meter.fill	پرکننده یک متر
   list	پس‌زمینه فهرست بارگیری
   list.frame	خط بیرونی فهرست، جدول یا کادر
   grid	خطوط شبکه بین ردیف‌های فهرست در گفتگوها
   list.grid	خطوط شبکه فهرست بارگیری
   header	سربرگ‌های ستون هر فهرست و جدول
   header.line	خط پایینی سربرگ در فهرست‌های گفتگوها
   header.sep	جداکننده‌های بین عنوان ستون‌ها
   table.line	جداکننده‌های جدول‌های «دریافت‌کننده پیوند» و «افزودن تورنت»
   header.sorted	عنوان ستون مرتب‌شده
   header.sort-arrow	علامت مرتب‌سازی
   row.pressed	یک ردیف فشرده‌شده در فهرست
   chip.web	چیپ «وب» در فهرست بارگیری
   chip.torrent	چیپ «تورنت» در فهرست بارگیری
   chip.text	متن روی چیپ
   list.drag-ghost	یک عنوان ستون در حال کشیده‌شدن
   list.marquee	نوار لاستیکی انتخاب ردیف‌ها
   list.marquee.border	لبه نوار لاستیکی
   scroll.track	مسیر نوار پیمایش
   scroll.corner	محل تلاقی دو نوار پیمایش
   scroll.thumb	دسته و فلش‌های نوار پیمایش
   scroll.thumb.hot	دسته یا فلش زیر اشاره‌گر
   scroll.thumb.pressed	دسته یا فلش فشرده‌شده یا در حال کشیده‌شدن
   menubar	نوار منو
   menubar.bottom	آخرین ردیف نوار منو
   menubar.line	خط زیر نوار منو
   menubar.hot	عنوان منو زیر اشاره‌گر
   menubar.open	عنوان منوی بازشده
   menu	پس‌زمینه منو
   menu.item	یک آیتم منو
   menu.hot	یک آیتم منو زیر اشاره‌گر
   menu.border	قاب منو و پنجره بازشو
   menu.sep	جداکننده‌های منو
   menu.text	متن منو
   menu.glyph	نقطه‌ها، علامت‌های تیک و فلش‌های زیرمنو
   menu.text.disabled	یک آیتم منوی خاکستری‌شده
   toolbar.line	خط بالای نوار ابزار
   toolbar.line.light	هایلایت زیر آن
   toolbar.hot	دکمه نوار ابزار زیر نشانگر
   toolbar.hot.faint	بخش دیگر یک دکمه تقسیم‌شده در حالی که یک بخش زیر نشانگر است
   toolbar.pressed	دکمه نوار ابزار فشرده‌شده
   toolbar.hot.edge	لبه دکمه فعال نوار ابزار
   toolbar.hot.border	حاشیه دکمه فعال نوار ابزار (شفاف: هیچ‌کدام)
   toolbar.split.shadow	سایه جداکننده دکمه تقسیم‌شده در حالت عادی
   toolbar.split.light	هایلایت جداکننده
   toolbar.text.disabled	برچسب خاکستری‌شده نوار ابزار
   toolbar.arrow	پیکان دکمه کشویی
   icon.disabled	جوهر (شروع) آیکون خاکستری‌شده
   icon.disabled.end	جوهر (پایان) آیکون خاکستری‌شده
   tree	پس‌زمینه درخت دسته‌بندی‌ها
   tree.lines	رابط‌های نقطه‌چین درخت
   tree.expander	علامت‌های پیکانی درخت، در جایی که طرح آن‌ها را رسم می‌کند
   tree.frame	قاب پنل دسته‌بندی‌ها
   progress.status	مقدار وضعیت در پنجره پیشرفت
   progress.label.disabled	برچسب خاکستری‌شده در پنجره پیشرفت
   segments.border	قاب نوار قطعات
   segments.corner	پیکسل‌های گوشه نوار قطعات
   pieces.have	یک قطعه تورنت که در اینجا موجود است
   pieces.partial	مربعی که نشان‌دهنده قطعاتی است که بخشی از آن‌ها در اینجا موجود است
   pieces.missing	قطعه‌ای که هنوز در اینجا موجود نیست
   caption	نوار عنوان که MDM خودش آن را رسم می‌کند
   caption.text	عنوان و گلیف‌های آن
   caption.text.inactive	عنوان و گلیف‌های آن در حالی که پنجره فعال نیست، و عنوان و گلیف‌های دکمه خاکستری‌شده
   caption.hot	دکمه عنوان زیر نشانگر (یک رنگ‌مایه روی نوار)
   caption.pressed	دکمه عنوان فشرده‌شده (یک رنگ‌مایه روی نوار)
   caption.button	دکمه عنوان در حالت عادی، در جایی که سبک آن را نشان می‌دهد (یک رنگ‌مایه روی نوار؛ شفاف: هیچ‌کدام)
   caption.close	بستن زیر نشانگر
   caption.close.text	نماد بستن زیر اشاره‌گر
   caption.inactive	نوار عنوان ترسیم‌شده توسط MDM، وقتی پنجره فعال نیست (شفاف: مانند حالت فعال)
   drop-target.edge	لبه ناحیه رهاسازی در حالت عادی
   egui.panel	پس‌زمینه پنل egui
   egui.window	پس‌زمینه راهنماها
   egui.window.border	حاشیه راهنماها
   egui.text	متن راهنماها
   egui.selection.text	رنگ متن انتخاب‌شده در کادرهای egui
   egui.extreme	تیره‌ترین (یا روشن‌ترین) پس‌زمینه egui
   egui.faint	پس‌زمینه محو egui
   egui.widget	ابزارک‌های egui در حالت عادی
   egui.widget.border	حاشیه آن‌ها (شفاف: بدون حاشیه)

   همه اندازه‌ها (26)

   کلید	چه چیزی را تنظیم می‌کند
   radius	شعاع گوشه دکمه‌ها، کادرهای متنی و منوهای کشویی
   radius.button	شعاع گوشه یک دکمه فشاری براق (Luna، Aero؛ Aqua در انتها گرد است)
   radius.part	شعاع گوشه یک بخش رنگی (ناحیه فلش، دکمه چرخشی)
   radius.check	شعاع گوشه یک چک‌باکس
   radius.flyout	شعاع گوشه یک پنجره بازشو در یک پنجره (تقویم، کادر فیلتر)
   radius.menu-item	شعاع گوشه یک آیتم منو زیر اشاره‌گر
   radius.egui	شعاع گوشه ابزارک‌های خود egui
   radius.popup	شعاع گوشه راهنماها
   border	عرض حاشیه یک کنترل
   focus-line	ارتفاع خط برجسته یک کادر متنی متمرکز
   chevron.width	ضخامت خط فلش منوی کشویی
   font.dialog	متن گفتگو (Tahoma در گفتگوهای IDM)
   font.dialog.bold	عنوان صفحات گزینه‌ها
   font.title	عنوان اصلی یک پنجره (Tahoma Bold): افزونه مرورگر، کمک‌کننده‌ها
   font.code	کد ورود برای تایپ در صفحه یک سرویس
   font.ui	متن منوها و پنجره اصلی (Segoe UI)
   font.ui.bold	عنوان‌های برجسته در پنجره اصلی
   font.small	متن کوچک egui
   font.body	متن اصلی egui: راهنماها، کادرهای چندخطی
   font.heading	عنوان‌های egui
   list.row	ارتفاع یک ردیف در فهرست بارگیری‌ها
   list.header	ارتفاع سربرگ ستون‌های فهرست بارگیری
   tooltip.width	محل شکستن خط متن راهنما
   tooltip.margin-x	فاصله داخلی چپ و راست یک راهنما
   tooltip.margin-top	فاصله داخلی بالای یک راهنما
   tooltip.margin-bottom	فاصله داخلی پایین یک راهنما

   همه سبک‌های کنترل (7)

   کلید	سبک‌های آن
   field-focus	خط، حاشیه، حلقه
   check	فلوئنت، مربع، ادوایتا، بریز، لونا، آئرو، آکوا
   button	فلوئنت، بریز، لونا، آئرو، آکوا
   progress	خط، نوار، بلوک، براق
   scroll	روکش، کلاسیک
   caption	سیستم، مترو، ادوایتا، بریز، لونا، آئرو، آکوا
   focus	نقطه‌چین، حلقه، قاب

   یا بگذارید یک دستیار هوش مصنوعی آن را بنویسد

   این دستور را در دستیار هوش مصنوعی خود کپی کنید و در پایان آن، ظاهری را که می‌خواهید توصیف کنید. این کار به دستیار قالب، کلیدها و قوانین را می‌دهد: متن خوانا و فوکوس قابل مشاهده در هر دو طرف، و هیچ چیز کپی شده از آثار هنری دیگران. قبل از به اشتراک گذاشتن نتیجه، هر دو طرف را خودتان بررسی کنید.

   You are making a theme file for Mister Download Manager (MDM), a free, open-source download manager. Write one TOML file, named after the theme in lower case with dashes (for example harbour.toml). Reply with the file only, in one code block, then one line on how to install it.
   
   THE FORMAT
   A theme names only what it changes; everything else comes from the theme it inherits.
   - name = "Display name"
   - inherits = "classic" (the default), "high-contrast", "metro", "adwaita", "breeze", "luna", "aero" or "aqua"
   - icons = "color" | "mono" | "accent"
   - contrast = "high" (optional: strengthens every edge and text colour)
   - [seeds] a few colours MDM spreads over every control: background, surface, header, text, accent, selection, error, warning, success. Use [seeds.light] and [seeds.dark] to give each side its own.
   - [colors] single colour roles for both sides; [light] and [dark] for one side only. Role names are dotted and must be quoted when they contain a dot, e.g. "button.hot" = "#e5f1fb". Useful roles: window, text, text.muted, link, accent, focus.ring, selection, selection.text, field, field.border, button, button.hot, button.pressed, button.border, button.text, check.on, check.mark, progress.bar, list, header, menubar, menu, menu.hot, menu.text, toolbar.hot, tree, caption, caption.text, scroll.thumb, gloss (the shine glossy parts blend toward), button.glow. "segments.done" takes one colour or a list of 13 (top to bottom).
   - [sizes] in pixels, 0 to 400: radius, radius.button, radius.check, radius.menu-item, radius.popup, border, focus-line, list.row, list.header, font.ui, font.dialog.
   - [controls] shapes: field-focus = line | border | ring; check = fluent | square | adwaita | breeze | luna | aero | aqua; button = fluent | breeze | luna | aero | aqua; progress = line | bar | blocks | gloss; scroll = overlay | classic; focus = dotted | ring | frame; caption = system | metro | adwaita | breeze | luna | aero | aqua.
   - Colours are "#rrggbb" or "#rrggbbaa". Unknown keys are skipped, so only use the names above.
   
   THE RULES
   1. Make both a light and a dark side: give [seeds.light] and [seeds.dark] (or [light] and [dark]) their own colours, and check each side on its own.
   2. Text must be easy to read: at least 4.5:1 contrast for text against its background (text on window and field, button.text on button, menu.text on menu, selection.text on selection, caption.text on caption), in both sides.
   3. The keyboard focus must be easy to see: accent and focus.ring at least 3:1 against what they sit on.
   4. Disabled text stays readable but clearly dimmer than normal text.
   5. Clean room: no artwork, icons, logos, fonts or text copied from any other program or company. If the theme needs icons, describe original ones to draw, never copy existing ones, and note their source and licence in a SOURCES.txt.
   6. Keep the layout: a theme changes colours, sizes and control shapes only.
   
   After the file, list each text and background pair you checked with its contrast ratio, for both sides.
   
   THE LOOK I WANT:

2. آن را امتحان کنید، بدون ساخت MDM

   فایل را در پوشه پوسته‌های MDM قرار دهید. نما → پوسته → باز کردن پوشه پوسته‌ها آن را باز می‌کند و برای اولین بار آن را می‌سازد. این پوشه در پوشه داده‌های MDM قرار دارد:

   Windows

   %APPDATA%\misterdownloadmanager\themes

   Linux

   ~/.local/share/misterdownloadmanager/themes

   macOS

   ~/Library/Application Support/misterdownloadmanager/themes

   نسخه قابل حمل

   data\themesکنار برنامه

   ظرف دو ثانیه در نما → پوسته، زیر پوسته‌های داخلی، با name که خودش می‌دهد، نمایش داده می‌شود. آن را انتخاب کنید و کل پنجره بلافاصله تغییر می‌کند. پس از ویرایش فایل، دوباره آن را در نما → پوسته انتخاب کنید تا تغییر را ببینید. نما → پشتیبانی از حالت تاریک و همیشه تیره بین حالت روشن و تاریک آن جابجا می‌شوند.

   نما → پوسته → افزودن فایل پوسته… این کار را برای شما انجام می‌دهد: فایل را از هر جایی انتخاب کنید، MDM آن را در پوشه پوسته‌ها کپی کرده و بلافاصله از آن استفاده می‌کند.

   آیا از قبل طرح Base16 یا pywal دارید؟

   این خودش یک پوسته است. یک طرح Base16 یا Base24 (.yaml) یا colors.json pywal، که به همین روش اضافه شده باشد، فقط رنگ‌های MDM را تغییر می‌دهد: پس‌زمینه‌های طرح پشت فهرست و پنجره‌ها، متن آن که خوانا نگه داشته شده (4.5:1 یا بیشتر)، آبی آن روی فوکوس، انتخاب و نوار پیشرفت. پس از اجرای wal، نما → پوسته، pywal را که از ~/.cache/wal/colors.json خوانده شده است، فهرست می‌کند (%USERPROFILE%\.cache\wal\colors.jsonدر Windows)، و MDM رنگ‌های هر تصویر زمینه جدید را ظرف دو ثانیه دنبال می‌کند. راهنما نشان می‌دهد که هر رنگ کجا قرار می‌گیرد.

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

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

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

   هنوز مطمئن نیستید؟ ابتدا آن را در بحث‌ها مطرح کنید. راهنمای مشارکت نحوه کار درخواست‌های پول (pull requests) را در اینجا توضیح می‌دهد.