स्थानीयकरण

ड्रीम वैक्यूम कार्ड मूल रूप से कई भाषाओं का समर्थन करता है। यह अलग-अलग स्थानीयकरण फ़ाइलों को बनाए रखने के बजाय बैकएंड dreame_vacuum एकीकरण द्वारा प्रदान की गई भाषा फ़ाइलों का गतिशील रूप से उपयोग करता है।

कार्ड स्थानीयकृत पाठ मानों को dreame_vacuum एकीकरण अनुवाद फ़ाइलें में entity_component अनुभाग से प्राप्त करता है।

अनुवाद कुंजी

भाषा फ़ाइलों के भीतर, कार्ड मुख्य रूप से कई कुंजी श्रेणियों का उपयोग करता है जो frontend_ से शुरू होती हैं ताकि इसका इंटरफ़ेस प्रदर्शित किया जा सके:

• frontend_action: यह अनुभाग कार्ड के मुख्य नियंत्रण पैनल पर क्रिया बटन में उपयोग किए जाने वाले सभी पाठ को शामिल करता है, जैसे स्टार्ट, पॉज, या डॉक।

• frontend_config: यह अनुभाग दृश्य कार्ड कॉन्फ़िगरेटर UI के भीतर उपयोग किए जाने वाले सभी पाठ लेबल, विवरण और सेटिंग्स को शामिल करता है।

• frontend_message: इसमें कार्ड पर प्रदर्शित स्थिति संदेश, अलर्ट, त्रुटि रिपोर्ट और चेतावनियाँ शामिल हैं।

• frontend_title: कार्ड के मेनू में प्रयुक्त शीर्षक और अनुभाग शीर्षकों को कवर करता है, जैसे मैप मैनेजमेंट या क्लीनिंग सेटिंग्स।

• entity: यह ब्लॉक होम असिस्टेंट एंटिटी डोमेन जैसे select, sensor, switch, number, time और input को कवर करता है। कार्ड डायनामिक रूप से इन एंटिटीज़ के नाम और स्थिति जैसे सक्शन लेवल या शांत को सीधे इंटीग्रेशन से खींचता है ताकि स्थिरता सुनिश्चित हो सके।

  • कार्ड-विशिष्ट स्थिति: कार्ड के UI द्वारा विशेष रूप से उपयोग की जाने वाली आंतरिक स्थितियों के लिए अनुवाद प्रदान करता है, न कि होम असिस्टेंट एंटिटीज़ के लिए। इसमें कमरे के नाम शामिल हैं (जो segment_name एंटिटी से प्राप्त होते हैं), साथ ही विशिष्ट पहचानकर्ता जैसे task_type, edit_type, map_type, object_type, furniture_type, obstacle_type, obstacle_reason, task_end_type, task_interrupt_reason, startup_method, cleanup_method और recovery_map_type।

दिनांक, समय और यूनिट फ़ॉर्मेटिंग

टेक्स्ट अनुवाद के अलावा, कार्ड स्थानीय फॉर्मेटिंग प्राथमिकताओं के अनुकूल स्वतः अनुकूलित हो जाता है, बिना किसी मैनुअल कॉन्फ़िगरेशन की आवश्यकता के:

• भाषा और लोकेल: कार्ड होम असिस्टेंट प्रोफ़ाइल में चयनित भाषा को प्राथमिकता देता है। यदि वहां कोई भाषा स्पष्ट रूप से सेट नहीं है, तो यह स्वतः वेब ब्राउज़र की डिफ़ॉल्ट भाषा पर वापस चला जाता है।
• 12/24-घंटे का समय प्रारूप: कार्ड होम असिस्टेंट प्रोफ़ाइल में कॉन्फ़िगर किए गए समय प्रारूप का पालन करता है। यदि निर्दिष्ट नहीं है, तो यह स्वचालित रूप से डिवाइस के क्षेत्र का मानक समय प्रारूप अपनाता है।
• सप्ताह का पहला दिन: कार्ड सीधे होम असिस्टेंट से सप्ताह के पहले दिन की सेटिंग पढ़ता है। यदि परिभाषित नहीं है, तो यह स्थानीय क्षेत्र के आधार पर यह गतिशील रूप से निर्धारित करता है कि कैलेंडर रविवार या सोमवार से शुरू होना चाहिए।
• इकाई प्रणाली: कार्ड होम असिस्टेंट के वैश्विक कॉन्फ़िगरेशन की निरंतर जांच करता है। यदि सिस्टम इंपीरियल इकाई प्रणाली का उपयोग करता है, तो कार्ड क्षेत्रों और दूरी को स्वचालित रूप से पुनः गणना करता है, और उन्हें फीट, वर्ग फीट, या गज में स्वाभाविक रूप से प्रदर्शित करता है।
• स्थानीय यूनिट अनुवाद: सामान्य यूनिट उपसर्ग और संक्षिप्त रूप, जैसे कि मीटर, किलोमीटर, फुट, यार्ड, मिनट और घंटा, को किसी मैनुअल अनुवाद की आवश्यकता नहीं है। कार्ड इन्हें वास्तविक समय में अनुवादित करता है, इसका उपयोग करने वाले ब्राउज़र की अंतर्निहित सुविधाओं के माध्यम से, जो सक्रिय भाषा के लिए विशेष रूप से तैयार की गई हैं।

translations को ठीक करें या सुधारें

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

अनुवाद सामान्यीकरण

आधिकारिक ऐप अक्सर विभिन्न डिवाइस पीढ़ियों के लिए समान पैरामीटर के लिए अलग-अलग शब्दावली का उपयोग करता है। अनुवादों में तर्कसंगत, सामान्यीकृत नामों का प्रयोग करना चाहिए बजाय इसके कि ऐप से बिल्कुल वही शब्दावली नकल की जाए। इससे अनुवाद संघर्षों से बचा जा सकता है, जहां किसी विशेष पीढ़ी के लिए किए गए सुधार को विभिन्न डिवाइस पीढ़ियों वाले उपयोगकर्ताओं द्वारा ओवरराइट कर दिया जाता है।

अपडेट प्रक्रिया में निम्नलिखित चरण शामिल हैं:

1. भंडार को फोर्क करें: GitHub पर Dreame Vacuum Home Assistant एकीकरण भंडार को फोर्क करना।
2. अनुवाद फ़ाइल खोजें: फोर्क किए गए भंडार में custom_components/dreame_vacuum/translations/ निर्देशिका पर नेविगेट करना ताकि भाषा कोड से मेल खाने वाली अनुवाद फ़ाइल मिल सके, जैसे कि de.json या it.json।
3. परिवर्तन करें: गलत टेक्स्ट को अपडेट करना। frontend_action, frontend_config, frontend_message, और frontend_title खंड UI-संबंधित टेक्स्ट को प्रबंधित करते हैं। entity खंड सेंसर नाम, चयन विकल्प, और उनकी स्थितियों को प्रबंधित करता है।
4. एक पुल रिक्वेस्ट सबमिट करें: मुख्य भंडार में पुल रिक्वेस्ट खोलना। जब पुल रिक्वेस्ट की समीक्षा की जाती है और इसे एक नए एकीकरण रिलीज़ में मर्ज किया जाता है, तो Dreame Vacuum Card स्वचालित रूप से अपडेट किए गए अनुवादों को ले लेता है।