Skip to main content

قوانین ترجمه

متن‌های قابل نمایش به کاربر نباید مستقیم در code، template یا component پراکنده شوند.

اصول

  • متن UI از فایل translation خوانده شود
  • کلید translation باید stable و domain محور باشد
  • پیام validation باید قابل ترجمه باشد
  • متن error نباید اطلاعات فنی حساس داشته باشد

نام‌گذاری کلیدها

کلیدها باید ساختارمند باشند:

users.fields.email
users.messages.created
users.errors.activation_failed

موارد ممنوع

  • hardcode کردن متن فارسی یا انگلیسی در چند نقطه
  • استفاده از متن فنی برای کاربر نهایی
  • تغییر کلید translation بدون بررسی مصرف‌کننده‌ها