AI خزنة
الشرق الأوسط والذكاء الاصطناعي العربي

بناء تطبيقات عربية من اليمين إلى اليسار بأدوات الذكاء الاصطناعي

ما تخطئ فيه أدوات الذكاء الاصطناعي مع العربية، والقواعد التي تجعلها تصيب في كل مرة

ATAI Khazna Team6 دقيقة قراءة

تطلب من أداة البرمجة بالذكاء الاصطناعي أن «تضيف العربية»، فتترجم النصوص وربما تقلب اتجاه الصفحة. ثم تبدأ المشكلات: سهم الرجوع يشير إلى الجهة الخطأ، والهوامش في غير موضعها، ورقم الهاتف يظهر مبعثرا داخل الجملة، والبحث عن اسم لا يجد شيئا لأن المستخدم كتب الألف دون همزة.

تعلمت هذه الأدوات في الغالب من كود إنجليزي يكتب من اليسار إلى اليمين، ولذلك فهذا سلوكها الافتراضي. وهي قادرة على بناء واجهات عربية ممتازة، لكن بشرط أن تعطيها القواعد بوضوح. يتناول هذا الدليل ما تخطئ فيه عادة، وكيف تضع الحلول في ملف قواعد المشروع لتطبق في كل مرة، لا حين تتذكر أن تطلبها فحسب.

ابدأ بالسمتين dir وlang

اضبط السمتين معا على العنصر الجذري: <html lang="ar" dir="rtl">. ولكل منهما وظيفة مختلفة؛ فالسمة dir تحدد الاتجاه الأساسي للنص، والسمة lang تخبر المتصفحات وقارئات الشاشة ومحركات البحث بلغة المحتوى، وتساعد في اختيار الخط. وتوضح وثائق MDN أن lang لا تحدد الاتجاه، وتوصي باستخدام السمة dir بدلا من خاصية direction في CSS، لأن الاتجاه صفة للمحتوى لا للتنسيق.

ومن الأخطاء الشائعة أن يحاكي الذكاء الاصطناعي الاتجاه من اليمين إلى اليسار باستخدام flex-direction: row-reverse أو float: right موزعة في أنحاء الكود، فينهار التصميم لحظة العودة إلى الإنجليزية. وفي التطبيق ثنائي اللغة ينبغي أن يغير مفتاح اللغة السمتين lang وdir في العنصر الجذري فقط، دون أن يحتاج أي جزء آخر من التخطيط إلى معرفة ذلك.

أما المحتوى الذي لا يمكن توقع اتجاهه، كمنشورات المستخدمين، فاستخدم معه dir="auto"، وهي القيمة التي توصي بها MDN لمدخلات المستخدمين والبيانات الخارجية.

استخدم الخصائص المنطقية في CSS

الخصائص المادية مثل margin-left وpadding-right تبقى في الجهة نفسها أيا كانت اللغة. أما الخصائص المنطقية فتتبع اتجاه القراءة؛ فالخاصية margin-inline-start هي الهامش الأيسر في الإنجليزية والهامش الأيمن في العربية. وعلى المنوال نفسه تعمل padding-inline-end وinset-inline-start وtext-align: start. وإن كنت تستخدم Tailwind فإن الأدوات المنطقية مثل ms-4 وme-8 تؤدي عمل ml-4 وmr-8 مع انقلاب صحيح بحسب الاتجاه.

بالخصائص المنطقية يخدم ملف تنسيق واحد اللغتين. ومن دونها سيظل الذكاء الاصطناعي يكتب استثناءات [dir="rtl"]، ويصبح كل مكون جديد خطأ جديدا.

اعكس ما يدل على الاتجاه فقط

الأيقونات التي تدل على حركة أو تسلسل ينبغي أن تنعكس في العربية: أسهم الرجوع والتقدم، والأسهم الصغيرة في القوائم ومسارات التنقل، وأزرار «التالي»، ومؤشرات التقدم. أما الأيقونات التي تمثل أشياء حقيقية فلا تنعكس: الشعارات، والساعة، والهاتف، وعدسة البحث. ومن الأعراف الشائعة كذلك إبقاء زر تشغيل الوسائط على حاله. اطلب من الذكاء الاصطناعي أن يميز الأيقونات الاتجاهية بصنف خاص ويعكسها وحدها، مثلا عبر transform: scaleX(-1) تحت [dir="rtl"]، بدلا من قلب كل صورة.

النصوص المختلطة بين العربية والإنجليزية

الواجهات العربية مليئة بالإنجليزية: أسماء المنتجات، وعناوين البريد، ورموز الطلبات، وأسماء المستخدمين. وخوارزمية الاتجاه الثنائي في المتصفح تتعامل مع ذلك في الغالب، لكن النص الذي يدرج أثناء التشغيل قد يعيد ترتيب الجملة من حوله. وتصف MDN العنصر <bdi> بأنه يعزل النص عما يحيط به، وهذا تحديدا ما تحتاجه حين تدرج اسما لا تعرف اتجاهه. اكتب <bdi>{userName}</bdi> لا المتغير مجردا.

وأرقام الهواتف وحقول البريد والرموز والروابط يحسن أن تبقى من اليسار إلى اليمين حتى في الصفحة العربية، فأعط هذه الحقول وقيمها السمة dir="ltr".

خطوط تدعم العربية

كثير من الخطوط التي تختارها أدوات الذكاء الاصطناعي افتراضيا لا تحتوي على حروف عربية، فيلجأ المتصفح إلى خط النظام الذي لا ينسجم مع تصميمك. اختر عائلة صممت للعربية، مثل Noto Sans Arabic أو IBM Plex Sans Arabic أو Cairo أو Tajawal، وحملها للنصوص العربية باستخدام المحدد :lang(ar). والعربية تحتاج عادة إلى ارتفاع سطر أكبر قليلا من الإنجليزية. ولا تطبق letter-spacing على النص العربي، لأن الحروف متصلة والتباعد يقطع اتصالها، وتجنب كذلك الخط المائل المصطنع.

الأرقام قرار يخص المنتج

يمكن كتابة العربية بالأرقام اللاتينية (1، 2، 3) أو بالأرقام الهندية المستخدمة في المشرق العربي. وكثير من المنتجات الخليجية تعتمد الأرقام اللاتينية، وبعضها يفضل الهندية. لا خطأ في أي منهما، لكن لا بد أن تختار أنت، لا أن يختار الذكاء الاصطناعي نيابة عنك. ومكتبات التنسيق تتخذ قرارها الخاص بحسب الإعدادات المحلية؛ ففي تجربتنا على Node.js 22 أخرجت Intl.NumberFormat('ar-KW') الأرقام الهندية، بينما أخرجت 'ar-u-nu-latn' الأرقام اللاتينية. والامتداد -u-nu-، الموثق في MDN، يتيح لك تحديد نظام الترقيم صراحة. دون قرارك في ملف القواعد، واجعل الذكاء الاصطناعي يمرره في كل موضع.

التواريخ

حدد ثلاثة أمور: التقويم (ميلادي أو هجري أو كلاهما)، وترتيب اليوم والشهر والسنة، وهل تظهر أسماء الأشهر أم أرقامها. ثم التزم بصيغة واحدة في التطبيق كله. وتدعم Intl.DateTimeFormat الخيار calendar، ومن قيمه islamic-umalqura. وقد تحتوي التواريخ العربية المنسقة على علامات اتجاه غير مرئية، فلا تحول نصا منسقا إلى تاريخ أبدا؛ خزن التواريخ بصيغة ISO ونسقها للعرض فقط.

تمدد النص والمحتوى الحقيقي

قد تكون التسميات العربية أطول من نظيرتها الإنجليزية أو أقصر، والخط العربي يحتاج إلى مساحة عمودية أكبر. وأول ما ينكسر هو الأزرار ذات العرض الثابت، والتبويبات المحصورة في سطر واحد، والبطاقات التي تقتطع النص. اطلب من الذكاء الاصطناعي تجنب العرض الثابت في حاويات النصوص، واختبر كل شاشة بمحتوى عربي حقيقي لا بنص تجريبي.

بحث يفهم العربية

يكتب المستخدمون الكلمة نفسها بطرق مختلفة. لذا وحد صيغة النص المخزن ونص البحث كليهما: وحد صور الألف (أ، إ، آ إلى ا)، وعامل التاء المربوطة (ة) معاملة الهاء (ه)، والألف المقصورة (ى) معاملة الياء (ي)، واحذف التشكيل وحرف التطويل. وفي JavaScript قد يكون ذلك بهذه البساطة:

text.replace(/[\u064B-\u0652\u0670\u0640]/g, '').replace(/[\u0622\u0623\u0625]/g, '\u0627').replace(/\u0629/g, '\u0647').replace(/\u0649/g, '\u064A')

خزن في قاعدة البيانات نسخة موحدة من الحقول القابلة للبحث ليبقى الاستعلام سريعا، واحتفظ بالنص الأصلي للعرض.

ضع القواعد في ملف القواعد

كل ما سبق يضيع إن نسيه الذكاء الاصطناعي في الجلسة التالية. أضف قسما خاصا بالعربية إلى CLAUDE.md أو AGENTS.md أو ملف .cursor/rules، ويشرح دليلنا عن كتابة ملف القواعد في CLAUDE.md وكيرسر مكانه وطريقته. وهذه نقطة بداية:

  • الصفحات العربية تستخدم lang="ar" dir="rtl" في العنصر الجذري، وتبديل اللغة يغير هاتين السمتين فقط.
  • استخدم الخصائص المنطقية في CSS حصرا، ولا تستخدم margin-left أو padding-right أو left أو right في التخطيط.
  • لا تعكس إلا الأيقونات المميزة بأنها اتجاهية.
  • أحط نص المستخدم المدرج بالعنصر <bdi>، وحقول الهاتف والبريد والرموز تكون dir="ltr".
  • الخط العربي: [اختيارك]، ولا تباعد بين الحروف العربية.
  • الأرقام: [لاتينية أو هندية]، تحدد صراحة في كل منسق للأرقام والتواريخ.
  • التواريخ: [صيغتك وتقويمك]، وهي واحدة في كل مكان.
  • البحث يوحد صور الألف والتاء المربوطة والألف المقصورة ويحذف التشكيل والتطويل في النص المخزن ونص البحث معا.

قائمة فحص سريعة

  • العنصر الجذري يحمل lang وdir الصحيحتين في اللغتين.
  • لا خصائص مادية لليسار أو اليمين في كود التخطيط.
  • الأسهم تشير إلى الجهة الصحيحة، والشعارات غير معكوسة.
  • الأسماء والبريد وأرقام الهواتف تظهر سليمة داخل الجمل العربية.
  • الخط العربي يحمل، والحروف تبقى متصلة.
  • الأرقام والتواريخ تتبع قرارا واحدا موثقا.
  • الأزرار والتبويبات تتحمل التسميات العربية الطويلة.
  • البحث بالهمزة أو بدونها يعيد النتائج نفسها.

الخطوة التالية: إن كنت جديدا على البناء بهذه الأدوات فابدأ بدليل تطبيقك الأول مع كلود كود، ثم استعن بـقسم البرمجة بالذكاء الاصطناعي لتخطط لتطبيقك العربي وتبنيه وتطلقه بأمان.

الأسئلة الشائعة

هل تكفي خاصية direction: rtl في CSS لصفحة عربية؟
لا. توصي MDN بالسمة dir على العنصر html لأن الاتجاه صفة للمحتوى. واقرنها بالسمة lang="ar"، واستخدم الخصائص المنطقية في CSS ليتبع التخطيط الاتجاه تلقائيا.
هل يستخدم تطبيقي العربي الأرقام اللاتينية أم الهندية؟
هذا قرار يخص المنتج. كثير من المنتجات الخليجية تعتمد الأرقام اللاتينية، وبعضها يفضل الهندية. اختر أحدهما، ودونه في ملف القواعد، وحدد نظام الترقيم صراحة في كل منسق.
لماذا لا يجد البحث أحيانا اسما عربيا موجودا؟
لأن المستخدمين يكتبون الكلمة نفسها بصور مختلفة، كالألف بهمزة أو بدونها، أو التاء المربوطة هاء. وحد صيغة النص المخزن ونص البحث معا لتتطابق هذه الصور.
كيف أمنع الذكاء الاصطناعي من تكرار أخطاء الاتجاه؟
ضع قواعد العربية في الملف الذي تقرؤه أداتك في كل جلسة، مثل CLAUDE.md أو AGENTS.md أو .cursor/rules. فالسطور القصيرة المحددة أنجع من التعليمات العامة.
arabicrtlvibe codinglocalisationrules file