التدويل (i18n)

لماذا يهم

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

وبالنسبة إلى المختبِر، تحدد معرفة التدويل إلى أين يذهب التقرير. فالتسمية الإنجليزية العادية في الواجهة العربية ليست خطأ ترجمة يُحال إلى المترجم، بل عيب في الكود، ولا يوجد لها مفتاح نص أصلاً.

عملان مختلفان: مرة في الكود، ثم لكل إعداد محلي

قدّم دليل اختبار التوطين المصطلحات، أما ما يهم تصميم الاختبار فهو مكان العمل. التدويل يُنجز مرة واحدة، في الكود، على يد المطورين: إنه خاصية في المنتج. والتوطين يُنجز لكل إعداد محلي على حدة، في المحتوى، على يد المترجمين والخبراء المحليين: نصوص مترجمة وصيغ محلية ونصوص قانونية ووسائل دفع. وبعض الفرق تسمّي الاثنين معاً العولمة (g11n).

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

• سؤال التدويل: هل يقبل المنتج أي إعداد محلي؟ اختبره قبل وجود الترجمة، بإعداد زائف وبيانات يونيكود واتجاه من اليمين إلى اليسار وصيغ غير افتراضية.
• سؤال التوطين: هل هذا الإعداد المحلي صحيح؟ اختبره بعد وجود الترجمة، بالنصوص الحقيقية والصيغ الحقيقية ومتحدث أصلي.
• إعداد محلي لا لغة فقط: ar يختار النص العربي؛ وar-SA يضيف المنطقة التي تحدد الصيغ والعملة والتقويم الافتراضي. ووسوم اللغات تتبع RFC 5646.

النصوص المستخرجة وبيانات الإعداد المحلي

استخراج النص (Externalising) يعني نقله من الكود إلى ملف موارد تحت مفتاح: يطلب الكود checkout.total ويعيد وقت التشغيل نص الإعداد المحلي الحالي. وكل جملة رسالة واحدة بمعاملات مسماة، لا شظايا تُلصق ببعضها، لأن ترتيب الكلمات والمطابقة يختلفان بين اللغات. أما الأعداد فتستخدم فئات الجمع: قواعد CLDR من يونيكود تعطي الإنجليزية فئتين والهندية فئتين والعربية ست فئات، فتحمل الرسالة صيغة لكل فئة ويختارها المنسِّق؛ وفي صيغة ICU MessageFormat أدناه يحلّ العدد محلّ #.

وبيانات الإعداد المحلي (Locale data) هي كل ما يعرفه وقت التشغيل عن إعداد محلي مما ليس ترجمة: أنماط التاريخ والأرقام، وأشكال الأرقام، ورموز العملات ومواضعها، والتقويم، وأول أيام الأسبوع، وقواعد الجمع، وترتيب الفرز. ومصدرها في معظم المنصات CLDR، وتصل إلى الكود عبر واجهات واعية بالإعداد المحلي مثل كائنات Intl في ECMAScript (المعيار ECMA-402). والكود المدوَّل لا يكتب نمطاً مثل DD/MM/YYYY أبداً؛ بل يمرّر وسم الإعداد المحلي للمستخدم إلى الواجهة ويعرض ما تعيده. وتتغير بيانات CLDR مع إصداراتها الجديدة، لذا يأخذ الاختبار الصيغة المتوقعة من منسِّق المنصة نفسها لا من قيمة نُسخت مرة واحدة من موقع ما.

• المفاتيح الناقصة: قارن كل ملف إعداد محلي بملف المصدر؛ فالمفتاح الموجود في en.json والغائب عن ar.json يعود إلى الإنجليزية أو يُظهر المفتاح الخام.
• المعاملات: يجب أن تبقى {name} و{amount} كما هي بعد الترجمة؛ فالمعامل المترجَم يظهر بأقواسه المعقوصة كما هو أو يعطّل المنسِّق، والمعامل المحذوف يُسقط القيمة بصمت.

en.json
  "checkout.total":    "Total: {amount}"
  "checkout.nights":   "{count, plural, one {# night} other {# nights}}"
  "checkout.greeting": "Welcome back, {name}"

ar.json  (المفاتيح نفسها؛ وتحمل العربية فئات الجمع الست كلها)
  "checkout.total":    "الإجمالي: {amount}"
  "checkout.nights":   "{count, plural, zero {لا ليالي} one {ليلة واحدة} two {ليلتان}
                         few {# ليالٍ} many {# ليلة} other {# ليلة}}"
  "checkout.greeting": "أهلاً بعودتك يا {name}"

ما يفحصه المختبِر
  لكل نص ظاهر مفتاح                    -> لا شيء مكتوب في القالب
  {amount} يصل منسّقاً مسبقاً           -> من واجهة الإعداد المحلي لا من الرسالة
  {count} يصيب كل فئة جمع              -> 0 و1 و2 و3 و11 و100 للعربية

جرّبها: مقارنة JSON

مثال تطبيقي: شاشة دفع بإعداد محلي زائف

التوطين الزائف (Pseudo-localization) يولّد إعداداً محلياً وهمياً من النصوص المصدرية: تُضاف إلى الحروف علامات (Accents)، وتطول كل رسالة وتُحاط بأقواس، ويمكن اختيارياً قلب الاتجاه الأساسي ليصبح من اليمين إلى اليسار. يظل الفريق قادراً على قراءة الشاشة، وأي نص في الواجهة لم يتحوّل لم يُستخرج أصلاً. ولا حاجة إلى مترجم، فيمكن تشغيله في التكامل المستمر مع كل بناء. ويوفّر Android مثلاً الإعدادين الزائفين en-XA (حروف بعلامات ونص أطول) وar-XB (من اليمين إلى اليسار).

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

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

English                   Pseudo-locale                  ما يراه المختبِر
------------------------  -----------------------------  --------------------------------
Checkout                  [Çĥéçķöüţ ····]                سليم: مستخرج
Book now                  Book now                       مكتوب في القالب
You have 2 guests         [Ýöü ĥàṽé] 2 [ĝüéšţš]          ثلاث قطع: دمج
Total: SAR 1,250.00       Total: SAR 1,250.00            مكتوب في الكود: لا مفتاح له
Room type                 [?ööm ?ý?é ····]               علامات استفهام: مسار ليس UTF-8
Cancel booking            [Çàñçéļ ḃööķí                  مقتطع: زر بعرض ثابت
Welcome back, Ahmed       [Ŵéļçömé ḃàçķ, Ahmed ····]     سليم: بقي {name} كما هو

جرّبها: مولّد بيانات اختبار متعددة اللغات

عيوب التدويل الشائعة وأين تقع

تقع معظم عيوب التدويل في فئات قليلة. لكل فئة عرَض، ومكان في الكود، وطريقة قليلة الكلفة لكشفها؛ ومعرفة الفئة تتيح لك الإبلاغ عن السبب لا عن العرَض فقط.

• نصوص مكتوبة في الكود في رسائل التحقق من المدخلات وأخطاء الواجهة البرمجية والبريد والتسميات ونصوص الصور. للكشف عنها: الإعداد الزائف ثم العربية، مع قراءة كل رسالة بما فيها الرسائل التي لا تظهر إلا عند خطأ.
• الدمج والجمع بشرط if: "You have " + n + " items" وcount === 1 ? "night" : "nights". العرَض: شظايا بين أقواس، و«2 ليلة» بدلاً من «ليلتان». للكشف عنه: الأعداد 0 و1 و2 و3 و11 و100.
• الصيغ الثابتة: قوالب DD/MM/YYYY، ورموز عملة موضوعة يدوياً، وفاصلة عشرية مكتوبة في الكود. العرَض: الصيغة نفسها في كل إعداد محلي. للكشف عنها: ar-SA وhi-IN مع المقارنة بمنسِّق المنصة نفسها.
• اتجاه فيزيائي في التخطيط: margin-left وtext-align: left بدلاً من الخصائص المنطقية التي تتبع اتجاه النص (margin-inline-start وtext-align: start) والسمة dir. العرَض: صفحة عربية يبقى تخطيطها إنجليزياً. للكشف عنه: الإعداد الزائف من اليمين إلى اليسار.
• مسارات غير يونيكود: عمود أو واجهة برمجية أو تصدير بترميز قديم بدلاً من يونيكود، أو حد طول يُحسب بالبايتات. العرَض: علامات استفهام، أو نص مشوّه (Mojibake)، أو حقل من 100 حرف يرفض 60 حرفاً عربياً (120 بايت في UTF-8). للكشف عنها: مجموعات بيانات يونيكود في كل حقل، ثم افحص القيمة المخزنة.
• الإعداد المحلي يضيع في الطريق: الواجهة عربية لكن البريد أو إيصال PDF أو الرسالة القصيرة بالإنجليزية. للكشف عنه: أكمل مساراً بالعربية وافتح كل مخرج ليس شاشة.

جرّبها: مولّد مجموعات بيانات Unicode جرّبها: عدّاد طول السلاسل النصية جرّبها: مولّد بيانات الاختبار العربية جرّبها: مولّد بيانات الاختبار الهندية

أسئلة شائعة

المراجع

• Internationalization (i18n) ActivityW3Cمقالات W3C ودروسها وفحوصها في التدويل لبناء محتوى ويب متعدد اللغات واختباره.
• RFC 5646: Tags for Identifying LanguagesIETF · 2009وسوم اللغات BCP 47 (ar وar-SA وhi-IN وen-GB) — المعرّفات المستخدمة في سمة lang وترويسة Accept-Language وإعدادات اللغة.
• Unicode CLDR ProjectUnicode Consortiumمستودع بيانات اللغات والمناطق المشترك: بيانات صيغ التاريخ والوقت والأرقام والعملات وقواعد الجمع التي تعتمدها معظم المنصات.
• ECMAScript Internationalization API Specification (ECMA-402)Ecma International (TC39)مواصفة واجهة Intl في JavaScript — التنسيق الواعي باللغة والمنطقة للتواريخ والأرقام والعملات والقوائم وقواعد الجمع في المتصفح.