ترجمة ملف JSON للتدويل (i18n) مع بقاء كل مفتاح ومتغير وصيغة جمع سليمة
ارفع ملف en.json (أو عدة ملفات مساحات أسماء) واحصل على es.json بالمفاتيح المتداخلة نفسها وبالترتيب نفسه والمسافات البادئة نفسها. تُترجم القيم فقط، ويجري التحقق من كل {name} و{{count}} وصيغة جمع ICU في كل سلسلة. أول السلاسل النصية مجاني بدون تسجيل، وتكلفة المهمة كاملة، حتى 5,000 سلسلة نصية، هي $5 دفعة واحدة.
- لا تُترجم المفاتيح ولا بنية التداخل، وتبقى المصفوفات والأرقام والقيم المنطقية كما هي
- التحقق من العناصر النائبة: {name}، {{count}}، %s، :attribute، $t(key)، @:key
- تحافظ صيغ الجمع في ICU على بنيتها، وتحصل على الفئات التي تحتاجها اللغة الهدف
- Flutter ARB: يبقى @metadata ويُستخدم كسياق، ويُحدَّث @@locale
- يُسمّى الملف باسم اللغة: يصبح en.json هو es.json، ويصبح app_en.arb هو app_es.arb
{
"home.greeting": "Good morning, {name}Buenos días, {name}",
"home.nearby": "{count, plural, =0 {No trails near you yet} one {# trail near you} other {# trails near you}}{count, plural, =0 {Aún no hay rutas cerca de ti} one {# ruta cerca de ti} other {# rutas cerca de ti}}",
"trail.offline_done": "<b>{name}</b> is saved on this phone. You can use the map without a signal.<b>{name}</b> está guardado en este teléfono. Puedes usar el mapa sin señal.",
"trail.share_text": "I just finished {trail} with Trailbook! {km} km and {meters} m up. 🥾¡Acabo de terminar {trail} con Trailbook! {km} km y {meters} m de subida. 🥾",
"saved.empty": "You have not saved any trails yet.\nTap the heart on a trail to keep it here.Aún no has guardado ninguna ruta.\nToca el corazón en una ruta para guardarla aquí."
}
الأصفر: العناصر النائبة وصيغة الجمع في ICU، تُفحص في كل نص. الأزرق المخضر: الوسوم ورموز الهروب والرموز التعبيرية، تبقى كما كُتبت.
المفاتيح نفسها. العناصر النائبة نفسها. لغة جديدة.
تتغير القيم فقط. يعود الملف بالتداخل والترتيب نفسيهما باسم es.json، وأي نص يفقد عنصرًا نائبًا يُعاد طلبه قبل أن يصل إلى إصدار مشروعك.
تطبيق تجريبي صُنع لهذه الصفحة؛ النصوص الإسبانية مخرجات حقيقية من الأداة، من ملف يضم 85 نصًا.
ما الذي يُترجم وما الذي لا يُترجم
تُرسل كل قيمة نصية للترجمة مع مفتاحها الكامل كسياق، فقد تأتي الترجمة مختلفة بين "settings.save" و"cart.save". أما المفاتيح فلا تُرسل أبدًا. وتبقى كما هي القيم التي ليست نصًا، مثل عنوان URL أو عنوان بريد إلكتروني أو قيمة مكوّنة من عناصر نائبة فقط مثل "{count}".
تُستبدل وسوم النص المنسّق التي تستخدمها react-intl والمكتبات المشابهة، مثل <b>{name}</b> أو <link>Undo</link>، بعلامات قبل الترجمة ثم تُعاد إلى مكانها بعدها. ويجب أن تبقى أيضًا تسلسلات \n الحرفية والرموز التعبيرية؛ فإذا فقدت سلسلة شيئًا منها تُعاد ترجمتها، وإذا فشلت مرتين يبقى النص الإنجليزي في مكانه ويُدرج المفتاح في قائمة تصلك.
صيغ الجمع
تُترجم رسالة ICU مثل {count, plural, one {# trail} other {# trails}} كسلسلة واحدة. يُبلَّغ المترجم بفئات الجمع التي تستخدمها اللغة الهدف، مثل one وfew وmany وother في الروسية أو البولندية، ويُتحقق من أن النتيجة تحتفظ باسم المتغير وكلمة الجمع المفتاحية. أما ملفات i18next التي تستخدم مفاتيح منفصلة مثل trail_one وtrail_other فتُترجم مفتاحًا مفتاحًا؛ ولا تُضاف المفاتيح الناقصة في اللغة الهدف (trail_few وtrail_many).
تجد طريقة عمل الأداة وتكلفتها وكيفية التعامل مع ملفاتك في صفحة ترجمة ملفات التوطين؛ وأسعار كل الأدوات في صفحة الأسعار.
آخر تحديث:
أسئلة وأجوبة
هل سيحتفظ الملف الناتج بتنسيقي؟
نعم. تُنسخ من ملفك المسافات البادئة (مسافتان أو أربع مسافات أو علامات جدولة)، وترتيب المفاتيح، والمسافة بعد النقطتين، وسطر جديد في النهاية. ويبقى الملف المضغوط في سطر واحد.
هل يمكنني رفع عدة ملفات مساحات أسماء دفعة واحدة؟
نعم، حتى 20 ملفًا في مهمة واحدة، مثل common.json وcart.json وerrors.json. وتُنزَّل معًا في ملف ZIP واحد.
ماذا عن السلاسل التي لا ينبغي ترجمتها؟
اكتب أسماء المنتجات والعلامات التجارية تحت "Never translate"؛ ويُتحقق من أن كل سلسلة تحتوي على أحدها تحتفظ به. أما القيم التي تتكوّن من عنوان URL أو بريد إلكتروني أو عناصر نائبة فقط فتُتخطى تلقائيًا.
كم التكلفة؟
أول السلاسل النصية مجانية. المهمة كاملة، حتى 5,000 سلسلة نصية، بسعر $5 دفعة واحدة. باقة غير محدود تغطي ما يصل إلى 15,000 سلسلة نصية في كل مهمة. المهام الصغيرة استثناء: المهمة التي تصل إلى 300 سلسلة نصية مجانية بالكامل، بما في ذلك التنزيلات.