اللغات

كيف تعمل العربية والإنجليزية، وكيف تغيّر النصوص، وكيف تضيف لغة ثالثة.

كيف تعمل

لكل صفحة نسختان، واللغة جزء من الرابط: /ar/... و/en/.... العربية هي اللغة الافتراضية، فمن يفتح / ينتقل إلى /ar. يضبط القالب السمتين lang وdir لكل صفحة، فتكون الصفحات العربية من اليمين إلى اليسار والإنجليزية من اليسار إلى اليمين، بما في ذلك اللوحة وهذا التوثيق.

للنصوص نوعان:

  • نصوص الواجهة (الأزرار والعناوين ونصوص الصفحات) في messages/ar.json وmessages/en.json، وللملفين المفاتيح نفسها تمامًا.
  • محتوى المتجر (أسماء المنتجات وأوصافها، والأقسام، والتشكيلات، وطرق التوصيل، واسم المتجر) في قاعدة البيانات، بعمود عربي وآخر إنجليزي لكل حقل (nameAr وnameEn…)، وتعدّلهما اللوحة جنبًا إلى جنب.

تُنسَّق الأسعار والتواريخ والأرقام حسب اللغة بواجهة Intl. تستخدم الصفحات العربية الأرقام اللاتينية (ar-OM-u-nu-latn) لأن أغلب المتسوقين في عُمان يفضّلونها في الأسعار وأرقام الهواتف. لاستخدام الأرقام الهندية غيّر ar-OM-u-nu-latn إلى ar-OM في src/lib/pricing.ts وفي دالة التاريخ في اللوحة.

تفاصيل الاتجاه من اليمين إلى اليسار

  • يعتمد التخطيط على خصائص CSS المنطقية (ms- وme- وstart- وend- وps- وpe-)، فينعكس وحده.
  • الأسهم التي تشير إلى «الأمام» تحمل الصنف flip-rtl.
  • الرموز وأرقام SKU والبريد والهواتف داخل ltr-nums أو dir="ltr"، حتى لا يتبعثر SQ-7KQ2-M9XD أو +968 9123 4567 وسط النص العربي.
  • يوحّد البحث صور الكتابة العربية المختلفة (أ إ آ ← ا، ة ← ه، ى ← ي، مع حذف التشكيل)، فكلمة «عباءه» تجد «عباءة». راجع الدالة normalizeText في src/lib/filters.ts.

تغيير نص

افتح messages/ar.json أو messages/en.json، وابحث عن المفتاح، وغيّر قيمته. صيغ الجمع بتنسيق ICU، مثل:

"products": "{count, plural, =0 {لا توجد منتجات} one {منتج واحد} two {منتجان} few {# منتجات} many {# منتجًا} other {# منتج}}"

للعربية صيغ جمع أكثر من الإنجليزية (zero وone وtwo وfew وmany وother)، والرسائل الموجودة تبيّن طريقة استعمالها.

إضافة لغة

  1. أضف رمز اللغة إلى locales في src/i18n/routing.ts، وإلى نمط المسارات في src/proxy.ts (/(ar|en)/ تصبح /(ar|en|fr)/).
  2. انسخ messages/en.json إلى messages/fr.json وترجمه.
  3. أضف أعمدة المحتوى (nameFr وdescFr…) في prisma/schema.prisma، وشغّل npx prisma db push، وأظهرها في نماذج اللوحة.
  4. حدّث المواضع التي تختار بين nameAr وnameEn (ابحث في الكود عن ? p.nameAr : p.nameEn).
  5. أضف اللغة إلى الدالة isRtl في routing.ts إن كانت تُكتب من اليمين إلى اليسار.