اللغات

🌐 إضافة لغة جديدة

المساهمة بلغة جديدة عملية مباشرة:

1. 1. انسخ packages/i18n/locales/en.json إلى ملف جديد (مثلاً hi.json للهندية)
2. 2. ترجم القيم فقط — أبقِ جميع المفاتيح بالإنجليزية
3. 3. أضف لغتك إلى SUPPORTED_LOCALES في packages/i18n/src/catalog.ts
4. 4. شغّل npm run build:locales -w @aura-os/i18n
5. 5. اختبر ترجماتك في التطبيق
6. 6. أرسل طلب سحب (PR) بالتغييرات

يستخدم المشروع Weblate للترجمات المجتمعية. يمكنك المساهمة بالترجمات عبر Weblate أو مباشرة عبر PR.

📐 دعم RTL

تستخدم العربية والفارسية تخطيط dir="rtl". يشمل دعم RTL:

• اتجاه التخطيط — تنعكس الواجهة بأكملها أفقياً
• محاذاة النص — يُحاذى النص لليمين
• التنقل — الشريط الجانبي والقوائم تعكس اتجاهها
• الطباعة — خطوط IBM Plex Sans Arabic و Tajawal
• الأيقونات — الأيقونات الاتجاهية تُعكس (الأسهم، الشيفرونات)
• الحركات — حركات الانزلاق تحترم اتجاه RTL

يتضمن نظام التصميم طباعة عربية صحيحة مع استبدال خطوط مدمج للمحتوى ثنائي اللغة.

🔧 مفاتيح الترجمة

تتبع مفاتيح الترجمة هيكلية هرمية:

{
  "common": {
    "save": "حفظ",
    "cancel": "إلغاء",
    "delete": "حذف"
  },
  "dashboard": {
    "title": "لوحة التحكم",
    "welcome": "مرحباً بعودتك، {{name}}",
    "stats": {
      "tasks": "المهام",
      "projects": "المشاريع"
    }
  },
  "errors": {
    "network": "خطأ في الشبكة. يرجى التحقق من الاتصال.",
    "auth": "فشلت المصادقة. يرجى تسجيل الدخول مجدداً."
  }
}

استخدم الترميز النقطي للإشارة للمفاتيح: t('dashboard.stats.tasks'). المتغيرات تُحاط بأقواس معقوفة مزدوجة: {{name}}.

📝 أفضل ممارسات الترجمة

• أبقِ المفاتيح بالإنجليزية — ترجم القيم فقط
• استخدم العناصر النائبة — للمحتوى الديناميكي (مثل {{count}})
• راعِ السياق — بعض الكلمات لها ترجمات مختلفة حسب السياق
• اختبر جيداً — تحقق من فيض النص ومشاكل المحاذاة
• استخدم Weblate — للترجمات المجتمعية والاتساق
• راجع الترجمات الموجودة — تفقد en.json للقائمة الكاملة