localize.dev

الوثائق / ترجم / Extension messages.json

ترجمة ملفات extension messages.json

ترجم ملف _locales/en/messages.json لextensions كروم وإيدج وفايرفوكس إلى كل لغة، مع الحفاظ على رموز $PLACEHOLDER$ واستخدام الوصفات كنصّ سياق.

كيف يعمل

localize-dev translate يقرأ _locales/en/messages.json، يرسل لكل رسالة description مع استخدامها كنصّ سياق، ويكتب _locales/es/messages.json, _locales/pt_BR/messages.json وما إلى ذلك، باستخدام أسماء اللغات مع الفاصلة السفلى التي تستخدمها الإضافات.

يتم الحفاظ على رموز $COUNT$ المسماة و$1 الموضعية، ويتم نسخ كتلة placeholders لكل رسالة إلى كل لغة، لأن ملف كل لغة يعلن عن نفسه.

قبل وبعد

الناتج الفعلي لـ localize-dev translate --locales es على الملف الأول. يبقى اسم الامتداد كما هو مكتوب، ويأتي كتلة placeholders مع الرسالة المترجمة.

_locales/en/messages.json
{
  "extName": { "message": "Tab Tidy", "description": "Extension name in the Chrome Web Store" },
  "popupTitle": { "message": "Tidy your tabs" },
  "closedTabs": {
    "message": "Closed $COUNT$ tabs in $WINDOW$",
    "description": "Shown after the user tidies a window",
    "placeholders": {
      "count": { "content": "$1", "example": "12" },
      "window": { "content": "$2", "example": "Work" }
    }
  }
}
_locales/es/messages.json · الإسبانية
{
  "extName": {
    "message": "Tab Tidy"
  },
  "popupTitle": {
    "message": "Organiza tus pestañas"
  },
  "closedTabs": {
    "message": "Cerradas $COUNT$ pestañas en $WINDOW$",
    "placeholders": {
      "count": {
        "content": "$1",
        "example": "12"
      },
      "window": {
        "content": "$2",
        "example": "Work"
      }
    }
  }
}

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

  • رموز $NAME$ و $1، تم التحقق منها
  • كتلة placeholders من كل رسالة تحتوي على واحدة
  • مجلدات اللغة ذات الشرطة السفلية (pt_BR, zh_CN)
  • مسافة التداخل في ملف المصدر

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

الترجمات بدون عناصر الحجز الخاصة بها

يتم ملء $COUNT$ من placeholders المعلن في ملف اللغة نفسه. بدونها، لا يمكن للمتصفح ملؤها، لذا يتم نسخ الكتلة مع كل ترجمة.

مجلدات اللغة ذات الشرط المربوط

تستخدم الإضافات pt_BR، وليس pt-BR، لأسماء المجلدات. يتم إنشاء اللغات الجديدة بالتهجئة التي تتوقعها الإضافات.

قوائم المتجر

الاسم والوصف في messages.json هو ما يعرضه متجر Chrome Web Store بكل لغة. امنحهم description بحيث تبقى أسماء العلامات التجارية كما هي ويكون الملخص مناسبًا للمتجر.

قم بتشغيله

في المجلد الذي يحتوي على ملفات اللغة الخاصة بك. تحصل اللغات التي ليس لها ملف بعد على ملف. يوضح --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 سلسلة في الشهر. تُحتسب السلسلة مرة واحدة بغض النظر عن عدد اللغات التي تدخل فيها. إنشاء حساب مجاني