localize.dev

الوثائق / ترجم / JSON

ترجمة ملفات اللغة JSON

املأ الترجمات المفقودة في ملفات JSON الخاصة بـ i18next، react-intl، vue-i18n، ngx-translate و Transloco، مع عناصر نائبة ورسائل ICU وكل صيغة جمع تحتاجها كل لغة.

كيف يعمل

يقرأ localize-dev translate ملف JSON بلغتك المصدر، ويحدد المفاتيح التي تفتقدها اللغات الأخرى ويكتبها، بترتيب مفاتيح الملف المصدر حتى تختلف الملفات بشكل نظيف. الترجمات الموجودة لديك لا يتم المساس بها.

إنه يعرف اصطلاحات كل مكتبة: i18next {{name}}، والتداخل $t(key) ولواحق الجمع _one / _other، ورسائل ICU الخاصة بـ react-intl و next-intl، وصيغ الجمع | الخاصة بـ vue-i18n، والروابط @:key والحروف {'@'}، و Laravel :name.

قبل وبعد

الناتج الفعلي لـ localize-dev translate --locales pl على الملف الأول. اللغة الإنجليزية لديها صيغتان للجمع. اللغة البولندية لديها أربع، لذا تمت إضافة _few و _many.

locales/en.json
{
  "inbox": {
    "title": "Inbox",
    "welcome": "Welcome back, {{name}}",
    "unread_one": "{{count}} unread message",
    "unread_other": "{{count}} unread messages",
    "empty": "Nothing here yet. <1>Write a message</1>"
  }
}
locales/pl.json · البولندية
{
  "inbox": {
    "title": "Skrzynka odbiorcza",
    "welcome": "Witaj ponownie, {{name}}",
    "unread_one": "{{count}} nieprzeczytana wiadomość",
    "unread_few": "{{count}} nieprzeczytane wiadomości",
    "unread_many": "{{count}} nieprzeczytanych wiadomości",
    "unread_other": "{{count}} nieprzeczytanych wiadomości",
    "empty": "Nic tu jeszcze nie ma. <1>Napisz wiadomość</1>"
  }
}

ما يبقى سليماً

  • العناصر النائبة، تم التحقق منها: يتم رفض الترجمة التي تضيف أو تحذف أو تعيد تسمية عنصر واحد
  • علامات مثل <1>…</1> لـ <Trans>
  • كل صيغة جمع تستخدمها اللغة: _few و _many باللغة البولندية، ستة أشكال باللغة العربية
  • ترتيب المفاتيح والمسافات البادئة للملف المصدر

الأخطاء الشائعة، وكيفية تجنبها

نسخ _one و _other فقط

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

عناصر نائبة تتم ترجمتها

عند طلب ترجمة Welcome back, {{name}}، قد يقوم النموذج أحيانًا بترجمة name أيضًا. يتم إخفاء العناصر النائبة قبل الترجمة وفحصها بعد ذلك. تتم إعادة محاولة الترجمة التي تغيرها، ثم يتم حذفها والإبلاغ عنها، ولا تتم كتابتها أبدًا.

صيغ الجمع داخل جملة أطول

لا يمكن فصل صيغة الجمع أو الاختيار ICU المتداخلة داخل نص آخر بأمان. تتم ترجمة صيغ الجمع والاختيارات على المستوى الأعلى فرعًا تلو الآخر؛ تتم الإبلاغ عن الصيغ المتداخلة حتى تتمكن من ترجمتها يدويًا.

قم بتشغيله

في المجلد الذي يحتوي على ملفات اللغة الخاصة بك. تحصل اللغات التي ليس لها ملف بعد على ملف. يوضح --dry-run ما سيتغير أولاً.

npx localize-dev login

# Preview, then write the missing translations
npx localize-dev translate --dry-run -l es,fr,de
npx localize-dev translate -l es,fr,de

ثم حافظ على اكتماله في CI. هذا لا يحتاج إلى مفتاح API ويفشل عندما تكون اللغة مفقودة الترجمات:

npx localize-dev check --only translations

مجاني لـ 1,000 سلسلة في الشهر. تُحتسب السلسلة مرة واحدة بغض النظر عن عدد اللغات التي تدخل فيها. إنشاء حساب مجاني

أدلة للتطبيقات التي تستخدم هذا التنسيق

عندما لا يزال النص مرمزًا بشكل ثابت في الكود الخاص بك، يقوم localize-dev run بنقله إلى هذا التنسيق أولاً.