Yerelleştirme

Dreame Vacuum Kartı yerel olarak birden fazla dili destekler. Ayrı yerelleştirme dosyaları tutmak yerine, arka uç dreame_vacuum entegrasyonu tarafından sağlanan dil dosyalarını dinamik olarak kullanır.

Kart, lokalize edilmiş metin değerlerini dreame_vacuum entegrasyon çeviri dosyaları içindeki entity_component bölümünden alır.

Çeviri Anahtarları

Dil dosyaları içinde, kart arayüzünü görüntülemek için öncelikle frontend_ ile başlayan birkaç anahtar kategorisini kullanır:

• frontend_action: Bu bölüm, kartın ana kontrol panelindeki işlem düğmelerinde kullanılan tüm metinleri içerir, örneğin Başlat, Duraklat veya İstasyona Git.

• frontend_config: Bu bölüm, görsel kart yapılandırıcı arayüzünde kullanılan tüm metin etiketlerini, açıklamaları ve ayarları içerir.

• frontend_message: Kart üzerinde görüntülenen durum mesajları, uyarılar, hata raporları ve bildirimleri içerir.

• frontend_title: Kartın menülerinde kullanılan başlıkları ve bölüm başlıklarını kapsar, örneğin Harita Yönetimi veya Temizlik Ayarları.

• entity: Bu blok, select, sensor, switch, number, time ve input gibi Home Assistant varlık alanlarını kapsar. Kart, bu varlıkların adlarını ve durumlarını, örneğin Emiş Seviyesi veya Sessiz, entegrasyondan doğrudan dinamik olarak çeker ve tutarlılığı sağlar.

  • Kart’a Özel Durumlar: Yalnızca kartın kullanıcı arayüzü tarafından kullanılan dahili durumlar için çeviriler sağlar, Home Assistant varlıkları için değil. Bu, segment_name varlığından türetilen oda adlarının yanı sıra task_type, edit_type, map_type, object_type, furniture_type, obstacle_type, obstacle_reason, task_end_type, task_interrupt_reason, startup_method, cleanup_method ve recovery_map_type gibi özel tanımlayıcıları içerir.

Tarih, Saat ve Birim Biçimlendirme

Metin çevirilerine ek olarak, kart herhangi bir manuel yapılandırma gerektirmeden yerel formatlama tercihlerini otomatik olarak uygular:

• Dil ve Yerel Ayarlar: Kart, Home Assistant profilinde seçili olan dili öncelikli olarak kullanır. Eğer orada açıkça bir dil belirtilmemişse, otomatik olarak web tarayıcısının varsayılan diline döner.
• 12/24 Saat Formatı: Kart, Home Assistant profilinde yapılandırılmış saat formatına uyar. Belirtilmemişse, cihazın bölgesinin standart saat formatını otomatik olarak benimser.
• Haftanın İlk Günü: Kart, haftanın ilk günü ayarını doğrudan Home Assistant'tan okur. Tanımlanmamışsa, takvimin yerel bölgeye göre Pazar mı yoksa Pazartesi mi başlayacağını dinamik olarak belirler.
• Birim Sistemi: Kart, Home Assistant global yapılandırmasını sürekli olarak kontrol eder. Sistem İmperyal birim sistemini kullanıyorsa, kart alanları ve mesafeleri otomatik olarak yeniden hesaplar ve bunları feet, kare feet veya yard olarak native şekilde görüntüler.
• Yerel Birim Tercümeleri: metre, kilometre, fit, yarda, dakika ve saat gibi yaygın birim son ekleri ve kısaltmalar herhangi bir manuel çeviri gerektirmez. Kart, bunları aktif dil için özel olarak tasarlanmış yerleşik tarayıcı özelliklerini kullanarak anında çevirir.

Çevirileri Düzelt veya İyileştir

Eğer bir yazım hatası veya yanlış çeviri tespit edilirse veya yeni bir dil desteği gerekiyorsa, katkılar ana dreame_vacuum entegrasyon deposuna yapılır.

Çeviri Genellemesi

Resmi uygulama, farklı cihaz nesilleri arasında aynı parametreler için sık sık farklı terminoloji kullanır. Çeviriler, uygulamadaki ifadeyi birebir kopyalamaktan ziyade mantıklı ve genelleştirilmiş isimler kullanmalıdır. Bu, belirli bir nesil için yapılmış bir düzeltmenin farklı cihaz nesillerine sahip kullanıcılar tarafından üzerine yazılmasını önler.

Güncelleme süreci aşağıdaki adımları içerir:

1. Depoyu Forklayın: GitHub'da Dreame Vacuum Home Assistant entegrasyon deposunu forklamak.
2. Çeviri Dosyasını Bulun: Forklanan depoda, custom_components/dreame_vacuum/translations/ dizinine giderek de.json veya it.json gibi dil koduna uygun çeviri dosyasını bulmak.
3. Değişiklikleri Yapın: Yanlış metni güncellemek. frontend_action, frontend_config, frontend_message ve frontend_title blokları kullanıcı arayüzü ile ilgili metinleri yönetir. entity bloğu ise sensör isimleri, seçme seçenekleri ve bunların durumlarını yönetir.
4. Pull Request Gönderin: Ana depoya bir Pull Request açmak. Pull Request incelendikten ve entegrasyonun yeni bir sürümüne dahil edildikten sonra, Dreame Vacuum Card güncellenmiş çevirileri otomatik olarak alır.