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