Τοπικοποίηση

Η Κάρτα Ηλεκτρικής Σκούπας Dreame υποστηρίζει εγγενώς πολλαπλές γλώσσες. Χρησιμοποιεί δυναμικά τα αρχεία γλώσσας που παρέχονται από την ενσωμάτωση backend dreame_vacuum αντί να διατηρεί ξεχωριστά αρχεία τοπικοποίησης.

Η κάρτα ανακτά τις τοπικοποιημένες τιμές κειμένου από την ενότητα entity_component μέσα στο dreame_vacuum αρχεία μετάφρασης ενσωμάτωσης.

Κλειδιά Μετάφρασης

Μέσα στα αρχεία γλώσσας, η κάρτα χρησιμοποιεί κυρίως διάφορες κατηγορίες κλειδιών που ξεκινούν με frontend_ για την εμφάνιση της διεπαφής της:

• frontend_action: Αυτή η ενότητα περιέχει όλο το κείμενο που χρησιμοποιείται στα κουμπιά δράσης στο κύριο πάνελ ελέγχου της κάρτας, όπως Έναρξη, Παύση ή Σταθμός.

• frontend_config: Αυτή η ενότητα περιέχει όλες τις ετικέτες κειμένου, περιγραφές και ρυθμίσεις που χρησιμοποιούνται μέσα στη διεπαφή του οπτικού διαμορφωτή της κάρτας.

• frontend_message: Περιέχει μηνύματα κατάστασης, ειδοποιήσεις, αναφορές σφαλμάτων και προειδοποιήσεις που εμφανίζονται στην κάρτα.

• frontend_title: Καλύπτει τις επικεφαλίδες και τους τίτλους των ενοτήτων που χρησιμοποιούνται μέσα στα μενού της κάρτας, όπως Διαχείριση Χάρτη ή Ρυθμίσεις Καθαρισμού.

• entity: Αυτό το μπλοκ καλύπτει τα domains οντοτήτων του Home Assistant όπως select, sensor, switch, number, time και input. Η κάρτα αντλεί δυναμικά τα ονόματα και τις καταστάσεις αυτών των οντοτήτων, όπως Επίπεδο Αναρρόφησης ή Ήσυχο, απευθείας από την ενσωμάτωση για να διασφαλίζει συνέπεια.

  • Στατιστικά Ειδικά για την Κάρτα: Παρέχει μεταφράσεις για εσωτερικές καταστάσεις που χρησιμοποιούνται αποκλειστικά από το UI της κάρτας και όχι από τις οντότητες του Home Assistant. Αυτό περιλαμβάνει ονόματα δωματίων (παραγόμενα από την οντότητα 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.

Μορφοποίηση Ημερομηνίας, Ώρας και Μονάδας

Εκτός από τις μεταφράσεις κειμένου, η κάρτα προσαρμόζεται αυτόματα στις τοπικές προτιμήσεις μορφοποίησης χωρίς να απαιτείται καμία χειροκίνητη ρύθμιση:

• Γλώσσα & Τοπική Ρύθμιση: Η κάρτα δίνει προτεραιότητα στη γλώσσα που έχει επιλεγεί στο προφίλ του Home Assistant. Εάν δεν έχει οριστεί ρητά καμία γλώσσα εκεί, επιστρέφει αυτόματα στη προεπιλεγμένη γλώσσα του web browser.
• 12/24-ωρη μορφή ώρας: Η κάρτα σέβεται τη μορφή ώρας που έχει διαμορφωθεί στο προφίλ του Home Assistant. Εάν δεν έχει οριστεί, υιοθετεί αυτόματα τη standard μορφή ώρας της περιοχής της συσκευής.
• Πρώτη ημέρα της εβδομάδας: Η κάρτα διαβάζει απευθείας την ρύθμιση της πρώτης ημέρας της εβδομάδας από το Home Assistant. Εάν δεν έχει οριστεί, καθορίζει δυναμικά αν το ημερολόγιο θα ξεκινάει από Κυριακή ή Δευτέρα ανάλογα με την τοπική περιοχή.
• Σύστημα μονάδων: Η κάρτα ελέγχει συνεχώς την παγκόσμια ρύθμιση του Home Assistant. Εάν το σύστημα χρησιμοποιεί το σύστημα μονάδων Imperial, η κάρτα υπολογίζει αυτόματα εκ νέου τις περιοχές και τις αποστάσεις, εμφανίζοντάς τες φυσικά σε πόδια, τετραγωνικά πόδια ή γιάρδες.
• Μεταφράσεις Μονάδων Native: Συνήθεις καταλήξεις μονάδων και συντομογραφίες, όπως μέτρο, χιλιόμετρο, πόδι, γιάρδα, λεπτό και ώρα, δεν απαιτούν καμία χειροκίνητη μετάφραση. Η κάρτα τις μεταφράζει άμεσα χρησιμοποιώντας ενσωματωμένες λειτουργίες του προγράμματος περιήγησης προσαρμοσμένες ειδικά στη δραστήρια γλώσσα.

Διόρθωση ή Βελτίωση Μεταφράσεων

Εάν εντοπιστεί τυπογραφικό λάθος ή λανθασμένη μετάφραση, ή απαιτείται υποστήριξη για νέα γλώσσα, οι συνεισφορές πηγαίνουν στο κύριο dreame_vacuum αποθετήριο ενσωμάτωσης.

Γενίκευση Μετάφρασης

Η επίσημη εφαρμογή χρησιμοποιεί συχνά διαφορετική ορολογία για τα ίδια παραμέτρους σε διάφορες γενιές συσκευών. Οι μεταφράσεις πρέπει να χρησιμοποιούν λογικά, γενικευμένα ονόματα και όχι να αντιγράφουν αυστηρά τη λέξη-λέξη από την ΕΦΑΡΜΟΓΗ. Αυτό αποτρέπει συγκρούσεις μετάφρασης όπου μια διόρθωση προσαρμοσμένη για μια συγκεκριμένη γενιά ενδέχεται να αντικατασταθεί από χρήστες με διαφορετικές γενιές συσκευών.

Η διαδικασία ενημέρωσης περιλαμβάνει τα παρακάτω βήματα:

1. Κάντε Fork το Αποθετήριο: Κάντε fork το αποθετήριο του Dreame Vacuum Home Assistant integration στο GitHub.
2. Βρείτε το Αρχείο Μετάφρασης: Πλοηγηθείτε στον φάκελο custom_components/dreame_vacuum/translations/ στο forked αποθετήριο για να βρείτε το αρχείο μετάφρασης που αντιστοιχεί στον κωδικό γλώσσας, όπως de.json ή it.json.
3. Κάντε τις Αλλαγές: Ενημερώστε το λανθασμένο κείμενο. Τα μπλοκ frontend_action, frontend_config, frontend_message και frontend_title διαχειρίζονται το κείμενο που σχετίζεται με το UI. Το μπλοκ entity διαχειρίζεται τα ονόματα των αισθητήρων, τις επιλογές επιλογής και τις καταστάσεις τους.
4. Υποβάλετε Pull Request: Ανοίξτε ένα Pull Request στο κύριο αποθετήριο. Αφού το Pull Request εξεταστεί και συγχωνευθεί σε μια νέα έκδοση της ενσωμάτωσης, η κάρτα Dreame Vacuum εντοπίζει αυτόματα τις ενημερωμένες μεταφράσεις.