थीम

एक थीम 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 रंगों के रूप में पढ़ी जाती है।
• pywal का colors.json, या pywal के आकार में किसी भी प्रोग्राम की फ़ाइल (wallust का 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. देखें → थीम में इसे चुनें, और दोनों पक्षों को देखें: देखें → हमेशा गहरा चालू और बंद। जाँच करें कि टेक्स्ट पठनीय है और फ़ोकस मार्क दोनों में दिखाई दे रहा है।

वेबसाइट के थीम पेज पर एक प्रॉम्प्ट है जिसे आप एक AI सहायक को दे सकते हैं, जिसमें प्रारूप, हर कुंजी और नियम शामिल हैं, ताकि वह आपके लिए एक विवरण से एक थीम लिख सके।

इसे साझा करें

कुछ ऐसा बनाया है जो दूसरों को पसंद आएगा? एक पुल रिक्वेस्ट खोलें जो इसे crates/app/assets/themes में जोड़ता है, इसके साथ:

• .toml फ़ाइल, और यदि इसमें कोई है तो इसके आइकन का फ़ोल्डर;
• मुख्य विंडो के हल्के और गहरे पक्ष के स्क्रीनशॉट;
• किसी भी आइकन के बगल में एक SOURCES.txt, यह बताते हुए कि उन्हें किसने बनाया और किस लाइसेंस के तहत। आइकन आपके अपने होने चाहिए या ऐसे लाइसेंस के तहत होने चाहिए जो MDM को उन्हें साझा करने की अनुमति देता हो (GPL-3.0), किसी अन्य प्रोग्राम से कभी कॉपी नहीं किए गए हों।

अभी निश्चित नहीं हैं? पहले इसे चर्चाओं में दिखाएँ। CONTRIBUTING.md बताता है कि यहाँ पुल रिक्वेस्ट कैसे काम करती हैं।

अगले चरण

• शुरू करना →
• विकल्प →