Wallbash और dcol

अवलोकन

यह दस्तावेज़ HyDE थीमिंग के लिए उपयोग किए जाने वाले रंग कॉन्फ़िगरेशन की व्याख्या प्रदान करता है। इसमें प्राथमिक रंग, टेक्स्ट रंग और एक्सेंट रंग शामिल हैं। प्रत्येक रंग को हेक्साडेसिमल या RGBA फ़ॉर्मेट में निर्दिष्ट किया जा सकता है।

रंग पहचानकर्ता

डिफ़ॉल्ट रूप से, वॉलपेपर कैशिंग के दौरान, यह प्रत्येक प्राथमिक रंग के लिए 4 प्राथमिक रंग, 4 टेक्स्ट रंग और 9 एक्सेंट रंग उत्पन्न करता है।

dcol_mode: यह पहचानकर्ता निर्धारित करता है कि थीम डार्क मोड में है या लाइट मोड में।
dcol_pryX: ये प्राथमिक रंग हैं, जहाँ X 1 से 4 तक होता है।
dcol_txtX: ये प्राथमिक रंगों के उलटे रंग होते हैं, जो टेक्स्ट के लिए उपयोग होते हैं, जहाँ X 1 से 4 तक होता है।
dcol_XaxY: ये प्रत्येक प्राथमिक रंग के एक्सेंट रंग हैं, जहाँ X 1 से 4 तक और Y 1 से 9 तक होता है।
_rgba: यह प्रत्यय (suffix) दर्शाता है कि रंग RGBA फ़ॉर्मेट में है। यदि यह प्रत्यय नहीं है, तो रंग हेक्साडेसिमल फ़ॉर्मेट में होता है।
_rgb: यह प्रत्यय दर्शाता है कि रंग RGB फ़ॉर्मेट में है।

उपयोग

कैश रंग कॉन्फ़िगरेशन का उपयोग करने के लिए:

प्रीफ़िक्स dcol_ को wallbash_ से बदलें ताकि Wallbash स्क्रिप्ट मानों को पार्स (parse) कर सके और बदल सके।
wallbash_ प्रीफ़िक्स को प्रमुख रंग मान (dominant color value) के लिए एक प्लेसहोल्डर के रूप में समझें।
रंग पहचानकर्ता को कोणीय कोष्ठक (<...>) में लपेटें ताकि यह इंगित किया जा सके कि इसे संबंधित मान से बदला जाएगा, उदाहरण के लिए <wallbash_pry1>।
इस उदाहरण का उपयोग टेम्पलेट के रूप में करें।

यह आपको कॉन्फ़िगरेशन के लिए एक टेम्पलेट बनाने की अनुमति देता है, जो प्रमुख रंग या वॉलपेपर का उपयोग करता है, और Wallbash स्क्रिप्ट इसे आपके लिए परिवर्तित कर देती है।

`*.dcol` टेम्पलेट बनाना

एक टेम्पलेट के लिए तीन भाग आवश्यक हैं:

लक्ष्य फ़ाइल (Target file)
स्क्रिप्ट/कमांड (वैकल्पिक)
सामग्री (Contents)

मूल प्रारूप:

target|command
contents

लक्ष्य फ़ाइल

अपने टेम्पलेट को संरचित करें और लक्ष्य कॉन्फ़िगरेशन स्थान निर्धारित करें। यह हो सकता है:

${cacheDir}/wallbash जिसमें स्क्रिप्ट के माध्यम से पोस्ट-प्रोसेसिंग होती है।
अपेक्षित पथ, उदाहरण के लिए kitty.conf के पास Kitty के लिए, जिसे include theme.conf से स्रोत (source) किया जाता है।

डायनामिक डायरेक्टरी के लिए पर्यावरण चर (environment variables) का उपयोग करें:

${confDir} = $XDG_CONFIG_HOME या $HOME/.config/
${cacheDir}/wallbash = HYDE_CACHE_DIR/wallbash = $HOME/.cache/hyde

वैकल्पिक स्क्रिप्ट/कमांड

लक्ष्य फ़ाइल में सामग्री भरने के बाद, आप पोस्ट-प्रोसेसिंग के लिए मनमाने कमांड या स्क्रिप्ट चला सकते हैं। Wallbash के स्क्रिप्ट डायरेक्टरी में जाने के लिए WALLBASH_SCRIPTS वेरिएबल का उपयोग करें, उदाहरण के लिए WALLBASH_SCRIPTS/your_script.sh।

सामग्री

यह फ़ाइल की सामग्री है, जिसमें Wallbash प्लेसहोल्डर शामिल हो सकते हैं, जैसे <wallbash_pry1>।

~/.config/hyde/wallbash/* डायरेक्टरी में तीन मुख्य डायरेक्टरीज़ होती हैं:

always

./wallbash/always/ में टेम्पलेट निम्नलिखित पर निष्पादित होते हैं:

थीम स्विच के दौरान
वॉलपेपर स्विच के दौरान
मोड स्विच के दौरान

अधिक जानकारी के लिए यहाँ देखें।

theme

./wallbash/theme/ में टेम्पलेट निम्नलिखित पर निष्पादित होते हैं:

थीम स्विच के दौरान
मोड स्विच के दौरान