بومی‌سازی

این افزونه ترجمه‌ها را برای تمام نام‌ها و وضعیت‌های موجودیت تولید شده از طریق سیستم ترجمه استاندارد Home Assistant ارائه می‌دهد و در custom_components/dreame_vacuum/translations/*.json ذخیره می‌شود. این فایل‌ها همچنین به عنوان فرهنگ لغت پایه‌ای که رابط‌های کاربری پایین‌دست برای متن رابط خود استفاده می‌کنند، عمل می‌کنند.

اصلاح یا بهبود ترجمه‌ها

اگر اشتباه نگارشی یا ترجمه نادرستی شناسایی شود، یا نیاز به پشتیبانی از زبان جدیدی باشد، مشارکت‌ها به این مخزن ارسال می‌شوند.

تعمیم ترجمه‌ها

اپ رسمی اغلب از اصطلاحات متفاوت برای پارامترهای یکسان در نسل‌های مختلف دستگاه استفاده می‌کند. ترجمه‌ها باید از نام‌های منطقی و کلی استفاده کنند و نه صرفاً کپی کردن کلمات دقیق از اپ. این کار از بروز تعارض در ترجمه جلوگیری می‌کند، جایی که اصلاحی که برای یک نسل خاص طراحی شده است، توسط کاربران با نسل‌های دیگر دستگاه بازنویسی می‌شود.

فرآیند به‌روزرسانی شامل مراحل زیر است:

1. شاخه‌گیری از مخزن: شاخه‌گیری از مخزن یکپارچه‌سازی Dreame Vacuum Home Assistant در گیت‌هاب.
2. پیدا کردن فایل ترجمه: رفتن به مسیر custom_components/dreame_vacuum/translations/ در مخزن شاخه‌گیری‌شده برای پیدا کردن فایل ترجمه مطابق با کد زبان، مانند de.json یا it.json.
3. انجام تغییرات: به‌روزرسانی متن نادرست. بلوک config متن جریان پیکربندی و جریان گزینه‌ها را مدیریت می‌کند. بلوک entity نام موجودیت‌ها، گزینه‌های انتخابی و وضعیت‌های آن‌ها را مدیریت می‌کند.
4. ارسال یک درخواست Pull: باز کردن یک درخواست Pull برای شاخه dev. پس از بررسی و ادغام درخواست Pull در یک نسخه جدید، Home Assistant به‌طور خودکار ترجمه‌های به‌روزرسانی‌شده را دریافت می‌کند.

ترجمه‌های رابط کاربری

کلیدهای ترجمه مخصوص frontend و برچسب‌های عملیاتی مشترک در entity_component فایل‌های زبان نگهداری می‌شوند. برای اطلاعات دقیق درباره نحوه ساختاردهی ترجمه‌های frontend و نحوه استفاده آن‌ها توسط مؤلفه‌های UI پایین‌دستی، به مستندات ترجمه کارت Dreame Vacuum مراجعه کنید.