प्रतीक चिह्न

सभी प्रतीक चिह्न को विज़ुअलाइज़ेशन के विभिन्न स्थानों पर उपयोग किया जा सकता है। इस प्रकार, इनको एक चर या पाठ के रूप में परिभाषित करने की संभावना होती है।

विज़ुअलाइज़ेशन पर एक प्रतीक चिह्न को प्रदर्शित करने के लिए, इसे टैग [icon:SYMBOLPFAD] का उपयोग करके सीधे पाठ में घोषित किया जाता है। प्रतीक चिह्न पथ को दाईं क्लिक या CTRL+C के साथ प्रतीक चिह्न लाइब्रेरी से कॉपी किया जा सकता है। यदि संभव हो तो, केवल Material Symbols का चयन करना चाहिए, ताकि विज़ुअलाइज़ेशन की शैली समान रहे।

प्रतीक चिह्न लाइब्रेरी

सभी उपलब्ध प्रतीक चिह्न को विज़ुअलाइज़ेशन प्रतीक चिह्न कॉन्टेक्स्ट मेनू के तहत बुलाया और खोजा जा सकता है। यह भी संभव है कि आप लाइब्रेरी में अपनी खुद की प्रतीक चिह्न सेट इम्पोर्ट करें। प्रक्रिया नीचे वर्णित है।

टिप्पणियाँ: प्रतीक चिह्न सूची पर प्रदर्शित नाम प्रतीक चिह्न पथ के साथ समान नहीं होता है। यदि पथ में कोई प्रतीक चिह्न सेट निर्दिष्ट नहीं किया गया है, तो स्वचालिक रूप से Glyphicons सेट का उपयोग किया जाता है।

प्रतीक चिह्न लाइब्रेरी में फ़िल्टर भी टैग्स के लिए खोज करता है। यदि यह व्यवहार अनिच्छुक है, तो फ़िल्टर को = से शुरू करके केवल नामों में खोज करने के लिए उपयोग किया जा सकता है।

प्रतीक चिह्न सेट Material Symbols (डिफ़ॉल्ट)

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

प्रतीक चिह्न स्वचालिक रूप से गोल होते हैं, जब टॉगल बटन रेडियस 16 पिक्सेल से बड़ा या बराबर होता है। यदि रेडियस 0px के बराबर है, तो तेज़ प्रतीक चिह्न का उपयोग किया जाता है। एडिटर में हमेशा सामान्य प्रतीक चिह्न का उपयोग किया जाता है।

टिप्पणी: यह सिफारिश की जाती है कि "Material Symbols" प्रतीक चिह्न सेट का उपयोग करें, ताकि विज़ुअलाइज़ेशन को एकरूप बनाया जा सके।

प्रतीक चिह्न सेट Material Animated

Material Symbols के कुछ चुने हुए प्रतीक चिह्नों को मानों को प्रदर्शित करने के लिए एनिमेट किया गया है। इन प्रतीक चिह्नों में केवल प्रतीक चिह्न का एक एनिमेशन है संरचना। चयन करने पर और अधिक चरों को अनलॉक किया जाता है।

प्रतीक चिह्न सेट Philips Hue

Philips Hue के प्रतीक चिह्नों का स्वतंत्र रूप से उपयोग किया जा सकता है, जब Hue इंटरफ़ेस का उपयोग किया जाता है। इसके अलावा, Home Assistant HASS के समुदाय द्वारा एक अतिरिक्त Hue प्रतीक चिह्न सेट है। इस अध्याय के अंत में और अधिक जानकारी मिल सकती है।

प्रतीक चिह्न सेट मौसम

यह प्रतीक चिह्न सेट विज़ुअलाइज़ेशन पर मौसम प्रतीक चिह्न प्रदर्शित करता है। इनका समर्थन विभिन्न इंटरफ़ेस द्वारा सीमलेस रूप से किया जाता है। नीचे दिए गए अध्याय मौसम-आइकन्स देखें।

प्रतीक चिह्न सेट Legacy (पुराना)

Legacy प्रतीक चिह्न सेट में पुराने विज़ुअलाइज़ेशन के सभी प्रतीक चिह्न शामिल हैं। नए इंटरफ़ेस की प्रदर्शनी शैली समान रहती है। इन प्रतीक चिह्नों का उपयोग नहीं करना चाहिए, क्योंकि उनका प्रदर्शन नए इंटरफ़ेस के लिए अनुकूलित नहीं किया गया है।

विभिन्न पुराने प्रतीक चिह्न अभी भी एनिमेटेड हैं:

  • legacy/door
  • legacy/door_2
  • legacy/lock
  • legacy/shutter
  • legacy/shutter_blinds
  • legacy/window
  • legacy/window_tilt

छिपे हुए प्रतीक चिह्न

विज़ुअलाइज़ेशन के लिए छिपे हुए प्रतीक चिह्न भी हैं। इनका विवरण नीचे के अध्यायों में दिया गया है।

प्रतीक चिह्न को बुलाने के लिए केवल एक URL प्रीफ़िक्स आवश्यक है।

अपने खुद के प्रतीक चिह्न सेट

यह संभव है कि आप अपनी प्रतीक चिह्न सेट को परियोजना में इम्पोर्ट करें। हर प्रतीक चिह्न सेट को एक ZIP फ़ाइल के रूप में तैयार किया जाना चाहिए। कुछ उदाहरण डेटा यहां से डाउनलोड किए जा सकते हैं:

प्रो टिप: सफल इम्पोर्ट के बाद, आप प्रतीक चिह्न सेट को .antobj के रूप में एक्सपोर्ट कर सकते हैं, ताकि इम्पोर्ट सरल हो। इसके लिए दाईं क्लिक करके एक प्रतीक चिह्न सेट पर एक्सपोर्ट का चयन करें।

निम्नलिखित नियमों में एक प्रतीक चिह्न सेट की संरचना और आवश्यकताओं को परिभाषित किया गया है। कृपया इनका ध्यान से अध्ययन करें और इनका पालन करें।

नियम

  • प्रीफ़िक्स
    • केवल _, a–z और 0–9 शामिल हो सकते हैं।
    • बड़े अक्षर स्वचालिक रूप से छोटे अक्षरों में बदल जाते हैं।
    • रिज़र्व्ड नाम जैसे sys, src या doc अमान्य हैं।
    • एक अक्षर (a–z) से शुरू होना चाहिए। केवल संख्याएँ अनुमत नहीं हैं।
    • पिछले अंडरस्कोर (_) हटाए जाते हैं।
    • कम से कम 3 वर्ण लंबा होना चाहिए।
    • दोहराए गए अंडरस्कोर (__) को एकल में कम किया जाता है।
  • प्रतीक चिह्न नाम
    • स्वचालिक रूप से छोटे अक्षरों में बदल जाते हैं।
    • अनुमत वर्ण हैं -, _, a–z और 0–9
    • लंबे नाम और प्रीफ़िक्स से बचना चाहिए।
    • एक प्रीफ़िक्स अनूठा होना चाहिए और केवल एक बार उपयोग किया जाना चाहिए।
    • अगर एक प्रतीक चिह्न का नाम और प्रीफ़िक्स एक सिस्टम प्रतीक चिह्न के साथ समान है, तो यह इसे बदल सकता है।
  • फाइल सीमाएँ
    • साफ़ करने के बाद अधिकतम फ़ाइल आकार: 10 kB. बड़े फ़ाइलों को अस्वीकार कर दिया जाता है।
    • SVG फ़ाइलों को साफ़ करना चाहिए:
      • लाइन ब्रेक स्वचालिक रूप से हटाए जाते हैं।
      • निम्न तत्व हटाए जाते हैं: <title>, <desc>, <script>, <image>, <style>, <foreignObject>
      • निम्न अट्रिब्यूट हटाए जाते हैं: style, fill, stroke, color, stop-color, flood-color, lighting-color
      • इनबेडेड स्क्रिप्ट्स, इमेजेस, CSS या बाहरी रिसोर्स के साथ आइकन्स को अस्वीकार कर दिया जाता है।
      • अगर स्टाइल्स रंगों या स्टाइल ब्लॉक्स शामिल करते हैं, तो इम्पोर्ट भी अस्वीकार किया जा सकता है।
  • SVG हेडर आवश्यकताएँ
    • सहित होना चाहिए: viewBox, width और height. अगर संभव हो तो, गायब मान स्वचालिक रूप से पूरे किए जाते हैं।
    • निम्न नैमस्पेस सहित होना चाहिए: xmlns="http://www.w3.org/2000/svg". अगर यह गायब या गलत है, तो इसे स्वचालिक रूप से पूरा किया जाता है।
    • आइकन का नाम डाइमेंशन्स के साथ बिल्कुल मिलना चाहिए, अन्यथा आइकन को अस्वीकार कर दिया जाता है।
    • डाइमेंशन्स वर्गाकार होने चाहिए (चौड़ाई = ऊंचाई)। डिफ़ॉल्ट: 24px
    • विरोधाभासी स्टाइल्स या अनुपयुक्त डाइमेंशन्स से बचना चाहिए।
  • सामान्य
    • खराब बनाए गए आइकन्स प्रदर्शन को महत्वपूर्ण रूप से धीमा कर सकते हैं या गलत भी हो सकते हैं।
    • प्रतीक चिह्नों के कॉपीराइट पर विशेष ध्यान दें।
    • सभी वेक्टर्स तीन डेसीमल स्थानों तक गोल किए जाते हैं।

संरचना

  • फ़ाइल iconset.ini प्रतीक चिह्न सेट को पहचानने के लिए अनिवार्य है।
    • यह ZIP फ़ाइल की रूट डायरेक्टरी या एक सबडायरेक्टरी में हो सकता है।
    • इसको छोटे अक्षरों में होना चाहिए (iconset.ini)।
    • प्रतीक चिह्न फ़ाइल नाम स्वयं केस-सेंसिटिव नहीं होते हैं।
  • इम्पोर्ट स्वचालिक रूप से SVG फ़ाइलों की खोज नहीं करता है।
    • iconset.ini में आइकन फ़ोल्डर को स्पष्ट रूप से परिभाषित करना चाहिए (icons/)।
    • ZIP फ़ाइल टेम्प्लेट में एक फ़ोल्डर icons/ परिभाषित किया गया है।
  • सबडायरेक्टरी
    • परिभाषित फ़ोल्डर (icons/) में सबडायरेक्टरी श्रेणियों के रूप में कार्य करती हैं।
    • प्रतीक चिह्न नाम सभी श्रेणियों के माध्यम से अनूठे होने चाहिए।
    • प्रतीक चिह्न फ़ोल्डर में नाम नियम:
      • न्यूनतम: केवल डाइमेंशन और फ़ाइल एक्सटेंशन (उदाहरण के लिए 24.svg)।
      • वैरिएंट जैसे filled24.svg या round_filled_24.svg वैध हैं।
      • एक से अधिक संख्याओं वाले फ़ाइल नाम (उदाहरण के लिए 24_48.svg) अमान्य हैं।
      • स्टाइल वैरिएंट पहचाने जाते हैं द्वारा:
        • फिल्ड: filled या fill शामिल होना चाहिए।
        • राउंड: round शामिल होना चाहिए।
        • शार्प: sharp शामिल होना चाहिए।
        • राउंड और शार्प को एक साथ नहीं मिलाया जा सकता है।
      • अगर कई नियम लागू होते हैं, तो अंतिम पहचाने गए फ़ाइल का उपयोग किया जाता है (चयन यादृच्छिक लग सकता है)।
  • अधिक नियम
    • गहरे सबडायरेक्टरी की खोज नहीं की जाती है (इनका उपयोग बैकअप या मूल के लिए किया जा सकता है)।
    • .svg के बिना फ़ाइलों को अनदेखा किया जाता है।
    • एक प्रतीक चिह्न फ़ोल्डर में एक फ़ाइल tags.txt हो सकती है, ताकि खोज के लिए अतिरिक्त टैग जोड़े जा सकें।
      • टैग्स को ,, ; या लाइन ब्रेक द्वारा अलग किया जा सकता है।

विशेष प्रतीक चिह्न सेट

ऐसे भी कई विशेष प्रतीक चिह्न सेट हैं जिन्हें अपने खुद के प्रतीक चिह्न सेट की तरह इम्पोर्ट किया जा सकता है, लेकिन इनको ऊपर दिए गए निर्देशों के अनुसार कॉन्फ़िगर नहीं करना होगा।

Hass Hue Icons

इनमें से एक है Gibhub पेज hass-hue-icons. यह Home Assistant HASS के समुदाय का एक अतिरिक्त Hue प्रतीक चिह्न सेट है और केवल गैर-व्यावसायिक परियोजनाओं के लिए उपयोग किया जा सकता है, क्योंकि यह Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International लाइसेंस के तहत आता है। इसलिए इस प्रतीक चिह्न सेट को Antcas Control के साथ प्रदान नहीं किया जाता है। हालांकि, ZIP फ़ाइल hass-hue-icons-main.zip का उपयोग करके इन प्रतीक चिह्नों को किसी भी समय एक नए प्रतीक चिह्न सेट के रूप में परियोजना में इम्पोर्ट किया जा सकता है। कृपया इस बात का ध्यान रखें कि Github वेबसाइट पर परियोजना के लाइसेंस शर्तों का पालन करें।

स्रोत: https://github.com/arallsopp/hass-hue-icons.

Pictogrammers द्वारा Material Design Icons

एक और है Pictogrammers का। इसके लिए mdi-###.json फ़ाइल को एक ZIP फ़ाइल में पैक किया जाना चाहिए और इम्पोर्ट किया जाना चाहिए। फ़ाइल ब्राउज़र के डेवलपर कंसोल में ढूंढी जा सकती है और डाउनलोड की जा सकती है। Outline प्रतीक चिह्नों को फिल्ड प्रतीक चिह्नों के साथ मिलाने का प्रयास किया जाता है। लाइब्रेरी Material Symbols के साथ लगभग समान है। हालांकि, कई समुदाय विस्तार हैं। अगर आप अन्य प्रतीक चिह्न सेटों को लाइब्रेरी में एकीकृत करना चाहते हैं, तो कृपया हमसे संपर्क करें।

स्रोत: https://pictogrammers.com/library/mdi/

उप पृष्ठ