فحص كل ترجمة قبل كتابتها
العناصر النائبة، وعلامات الترميز، وكل صيغة جمع CLDR وبناء جملة ICU: ما يتحقق منه localize.dev في كل ترجمة آلية، وما يحدث لترجمة تفشل.
Stephen Ufort · 3 نوفمبر 2026 · دقيقتان للقراءة

تفشل الترجمة الآلية بطرق غالبًا ما يغفلها المراجع. تتم ترجمة عنصر نائب، لذا يتحول {name} إلى {nombre} ويعرض التطبيق الأقواس. تعود صيغة الجمع بشكلها الذي يحتوي على شكلين للغة تحتاج إلى أربعة. تنزلق قوس شارد في جملة فارسية، وتتعطل مكتبة i18n عند محاولة عرضها.
يتحقق localize.dev من كل ترجمة مقابل مصدرها قبل كتابتها في ملف لغة. يمر هذا المنشور عبر كل فحص، باستخدام حالات من مجموعة الاختبار.
العناصر النائبة: لم تتم إضافة أي منها، ولم يُفقد أي منها
يجب أن يكون كل {placeholder} في المصدر موجودًا في الترجمة، دون تغيير، ولا يمكن للترجمة إضافة واحد غير موجود في المصدر. يبلغ المدقق بالضبط عما حدث خطأ:
translationProblem('Hi {name}', 'Hola', 'es', opts);
// → 'it lost {name}'
translationProblem('Hi {name}', 'Hola {nombre}', 'es', opts);
// → "it has {nombre}, which the source doesn't"هناك استثناء واحد. في رسالة الجمع، قد يحذف شكل one الـ {count}، لأن العديد من اللغات تقول "ملف واحد" ككلمة بدلاً من "1 ملف".
كل صيغة جمع تحتاجها اللغة
اللغة الإنجليزية لديها شكلان للجمع، واحد وعامة. البولندية لديها أربعة، العربية لديها ستة، واليابانية لديها واحد. الأشكال التي تحتاجها اللغة تأتي من Intl.PluralRules، بيانات CLDR المدمجة في JavaScript، لذا فهي ليست قائمة تُحفظ يدويًا أبدًا.
const source = { one: '{count} file', other: '{count} files' };
translationProblem(source, { one: '{count} plik', other: '{count} pliku' }, 'pl', opts);
// → 'no "few", "many" form'
translationProblem(source, { other: '{count}個のファイル' }, 'ja', opts);
// → null (Japanese needs only "other")عندما يكون للمصدر شكل =0 مطابق ("لا توجد ملفات")، فإن كل ترجمة تحتاج إلى واحد أيضًا. يتم رفض صيغة الجمع التي تعود كنص عادي، أو نص عادي يعود كصيغة جمع، باعتبارها الشكل الخاطئ.
علامات الترميز والأقواس الشاردة
يتم إرسال الجمل التي تحتوي على روابط أو نص غامق مع علامات مثل <a>help center</a>. يمكن للترجمة نقل العلامات لتناسب ترتيب كلماتها، ولكن يجب أن تحتفظ بنفس المجموعة. يتم رفض الترجمة التي تحتوي على أقواس غير متطابقة أكثر من مصدرها، مما يلتقط الحالة الفارسية من مجموعة الاختبار قبل أن تضطر أي مكتبة إلى عرضها.
يجب تحليل رسائل ICU
تستخدم تطبيقات Svelte وملفات ARB الخاصة بـ Flutter صيغة رسائل ICU. هناك يجب أيضًا تحليل الترجمة كـ ICU. لدى ICU فخ خاص بها: علامة الاقتباس المفردة تقتبس النص الذي يليها، لذلك في الفرنسية d'{name} ستعرض النص الحرفي {name} بدلاً من القيمة. يضاعف localize.dev علامات الاقتباس المفردة قبل الأقواس قبل أن يتحقق، ثم يتحقق من أن كل عنصر نائب يجب أن يكون في الترجمة لا يزال وسيطًا حقيقيًا.
ماذا يحدث عندما تفشل الترجمة
- يتم إسقاط اللغة الفاشلة لهذا السلسلة، ويتم نسيان الترجمة المخزنة مؤقتًا.
- يتم إرسال السلسلة مرة أخرى مع إضافة السبب إلى سياقها، على سبيل المثال "تم رفض ترجمة سابقة: لقد فقدت {name}".
- إذا فشلت الإجابة الثانية أيضًا، يتم ترك الترجمة. يقوم التشغيل بالإبلاغ عنها، وتسرد طلب السحب تحت "الترجمات التي تم تركها".
لا يتم كتابة أي شيء مكسور. الترجمة المفقودة مرئية: يتراجع التطبيق إلى اللغة المصدر لتلك السلسلة، ويبلغ localize-dev check عن الفجوة حتى يتم ملؤها. يمكن أن يصل المكسور إلى الإنتاج دون أن يلاحظه أحد.
ما لا يمكن للفحوصات إخبارك به
تلتقط هذه الفحوصات الترجمات التي من شأنها كسر تطبيقك. لا يمكنهم معرفة ما إذا كانت الترجمة جيدة. لهذا الغرض، يتيح لك localize.dev تعيين مراجع لكل لغة. تذهب تصحيحاتهم إلى طلب السحب المفتوح وكل تشغيل لاحق، وتحافظ المسرد على مصطلحات المنتج كما هي في كل مكان.