ترجمة لوحة كاملة بقاموس، لا بسمة على كل عنصر
لوحة إدارة فيها عشرات الشاشات ومئات النصوص. لو سلكت الطريق المعتاد لجعلها ثنائية اللغة، لاحتجت أن ألمس كل عنصر على حدة، ومن المؤكد أن أنسى بعضها.
ما فعلته
كتبت قاموسا يمشي على عقد النص في الصفحة ويستبدل ما يعرفه. الأصل عربي، وعند التبديل يحوّل القاموس النص إلى الإنجليزية.
المرور يشمل عقد النص، وسمات placeholder وtitle وaria-label، وعناصر الوقت كذلك.
القواعد الثلاث التي تحكمه
data-en للنص الذي يكتب وقت التشغيل ولا يوجد في القاموس.
data-raw للقيم المخزنة: اسم عميل، نص كتبه بنفسه، رقم طلب. هذه لا تترجم أبدا.
وما عدا ذلك كله يذهب إلى القاموس.
القاعدة التي تمنع أسوأ خطأ
لا تضف إلى القاموس كلمة واحدة شائعة مثل «طلب» أو «عرض» أو «عقد».
السبب أن عميلا قد يكتب كلمة «عرض» داخل رسالته، فيمر القاموس على الرسالة ويترجمها، وعندها تقرأ سجلا يقول غير ما كتب فيه أصلا. صحيح أن data-raw تحمي من هذا، لكن الاعتماد عليها وحدها خطر.
مصيدة كلفتني وقتا
استعملت كائنا عاديا للقاموس. حين وصل المرور إلى كلمة toString وجدها موجودة، لأنها موروثة من سلسلة النماذج، فأعادها كدالة وتحول النص إلى [object Window]. أما كلمة valueOf فأوقفت التبديل كله.
الحل كائن بلا نموذج:
var DICT = Object.create(null);
كيف أتحقق أن الترجمة كاملة
عدّ المفاتيح لا يثبت شيئا. أفتح كل شاشة، أبدل إلى الإنجليزية، وأجمع كل نص عربي بقي ظاهرا.
والمعيار ليس «صفر عربية»، بل صفر عربية في واجهة النظام نفسها. أسماء العملاء ورسائلهم وسجل التدقيق يجب أن تبقى عربية.
يبقى التحقق الحاسم: بدل ثم ارجع، وقارن عقد النص واحدة واحدة. إن عاد كل شيء كما كان، فالتبديل لا يفقد شيئا.