Lingo.dev + .json5 (JSON5)

واجهة سطر أوامر Lingo.dev تترجم ملفات JSON5 المحلية مع دعم كامل لبناء جملة JSON5 بما في ذلك التعليقات، والمفاتيح غير المقتبسة، والفواصل الزائدة، والاقتباسات المفردة. تحافظ واجهة سطر الأوامر على تنسيق JSON5 وبناء الجملة الصديق للمطورين مع الحفاظ على توافق الإطار ومعالجة المحتوى المعدل فقط لكفاءة التكلفة.

الإعداد السريع

قم بإنشاء ملف تكوين i18n.json:

{
  "locale": {
    "source": "en",
    "targets": ["es", "fr", "de"]
  },
  "buckets": {
    "json5": {
      "include": ["locales/[locale].json5"]
    }
  }
}

تذكير: [locale] هو عنصر نائب يجب أن يبقى في التكوين حرفيًا، حيث يتم استبداله باللغة الفعلية أثناء تشغيل واجهة سطر الأوامر.

ترجمة كل شيء

npx lingo.dev@latest i18n

تعالج تلقائيًا ميزات بناء جملة JSON5، وتحافظ على التعليقات والتنسيق، وتحدث المحتوى المتغير فقط.

دعم بناء جملة JSON5

يوسع JSON5 نطاق JSON ببناء جملة صديق للمطورين:

{
  // التعليقات مدعومة
  title: "Hello, world!", // تعليقات السطر تعمل
  description: 'Single quotes allowed',
  unquoted: 'keys work without quotes',
  trailing: 'comma is ok',
  
  /* تعليقات الكتلة
     مدعومة أيضًا */
  multiline: "This is a \
long string that \
spans multiple lines",
  
  // أرقام سداسية عشرية
  hex_value: 0xDEADBEEF,
  positive: +123,
  
  nested: {
    key: 'value',
  }, // الفاصلة الزائدة مسموح بها
}

الحفاظ الذكي على البنية

يحافظ على بناء جملة JSON5 واتفاقيات الإطار:

{
  nav: {
    home: "Home",
    about: {
      team: "Our Team"
    }
  },
  items: {
    one: "{{count}} item",
    other: "{{count}} items"
  },
  // التكوين يبقى سليمًا
  version: 0x010203
}

التكوين المتقدم

استبعاد الملفات

"json5": {
  "include": ["locales/[locale]/*.json5"],
  "exclude": ["locales/[locale]/config.json5"]
}

قفل المفاتيح التقنية

"json5": {
  "lockedKeys": ["app/version", "settings/apiKey"]
}

استخدم الشرطة المائلة للأمام (/) لمسارات المفاتيح المتداخلة أو النجمة (*) لمطابقة مسارات مفاتيح متعددة.

JSON5 مقابل JSON

توفر JSON5 تجربة مطور محسنة مع الحفاظ على التوافق الكامل مع JSON:

• التعليقات: وثّق ترجماتك باستخدام تعليقات مضمنة وكتلية
• المفاتيح غير المقتبسة: بناء جملة أنظف بدون علامات اقتباس حول أسماء الخصائص
• الفواصل النهائية: تحرير أسهل واختلافات في التحكم بالإصدارات
• علامات الاقتباس المفردة: مرونة في اقتباس السلاسل النصية
• السلاسل النصية متعددة الأسطر: قابلية قراءة أفضل للنصوص الطويلة
• تنسيقات الأرقام: السداسي عشري، والعلامات الموجبة، والمزيد

جميع ملفات JSON صالحة كملفات JSON5، مما يجعل الترحيل سلسًا.