دعم تنسيق الرسائل للتعريب

[Discourse]

إرشادات للمترجمين

في ديسكورس (Discourse)، تنتهي جميع سلاسل تنسيق الرسائل (Message Format strings) بمفتاح ينتهي بـ “_MF”. يحتوي محرر Crowdin على معاينة تسمح لك بتجربة قيم مختلفة، وهو أمر مفيد جدًا للتحقق من ترجماتك.

هام: تحتاج إلى تعديل صيغ الجمع لترجمتك إذا كانت لغتك تستخدم صيغًا أخرى غير “one” (واحد) و “other” (أخرى). يمكنك إضافة أو إزالة الصيغ داخل كتلة { FOO, plural, ... } لجعلها تعمل مع لغاتك. ستظهر لك المعاينة في محرر Crowdin رسالة “خطأ في بناء الجملة” (Syntax error) عندما تكون هناك مشكلة في ترجمتك.

صيغ الجمع المتاحة هي:

• zero (صفر)
• one (واحد)
• two (اثنان)
• few (قليل)
• many (كثير)
• other (أخرى — صيغة الجمع العامة — وتستخدم أيضًا للغات التي لا يوجد فيها تمييز بين صيغتي المفرد والجمع)

قد ترى أحيانًا كتلة فارغة =0 {} في سلسلة المصدر الإنجليزية، مما يعني أن المتغير لا يمكن أن تكون قيمته 0.

إرشادات للمطورين

سلاسل تنسيق الرسائل متاحة حاليًا فقط للترجمات من جانب العميل. وهي مفيدة إذا كانت سلسلتك تحتوي على أكثر من رقم واحد أو العديد من المتغيرات التي قد تؤدي إلى عدد كبير من التباديل.

• يجب أن تنتهي مفاتيح سلاسل تنسيق الرسائل بـ “_MF”

• استخدم التنسيق التالي للأرقام (سيتم استبدال # بالرقم):

  { variable_name, plural,
      one: {# نص المفرد}
    other: {# نص الجمع}
  }
  

• استخدم التنسيق التالي للاختيارات:

  { variable_name, select,
    foo: {هذا هو foo}
    bar: {هذا هو bar}
    baz: {هذا هو baz}
  }
  

• هذه هي كيفية استخدامها في جافاسكريبت (JavaScript):

  I18n.messageFormat("key_MF", {
    variable1: "foo",
    variable2: 42,
  });
  

• توصية: إذا أمكن، استخدم الوسائط المعقدة كهيكل خارجي للرسالة، واكتب جملًا كاملة في رسائلها الفرعية. إذا كان لديك اختيارات (select) وصيغ جمع (plural) متداخلة، فضع وسائط الاختيار (مع مجموعاتها الثابتة من الخيارات) في الخارج وقم بتضمين وسائط الجمع (من المحتمل واحدة كحد أقصى) في الداخل. انظر Formatting Messages | ICU Documentation

• اجعلها مقروءة – انظر الأمثلة الموجودة في client.en.yml

  سيئ

  There {currentTopics, plural, one {is <strong>#</strong> topic} other {are <strong>#</strong> topics}}. Visitors need more to read and reply to – we recommend at least { requiredTopics, plural, one {<strong>#</strong> topic} other {<strong>#</strong> topics}}. Only staff can see this message.
  

  جيد

  There { currentTopics, plural,
      one {is <strong>#</strong> topic}
    other {are <strong>#</strong> topics}
  }. Visitors need more to read and reply to – we recommend at least { requiredTopics, plural,
      one {<strong>#</strong> topic}
    other {<strong>#</strong> topics}
  }. Only staff can see this message.
  

الأدوات والمعلومات الإضافية

• Online ICU Message Editor يسمح لك باختبار سلسلة تنسيق الرسائل في حال وجود مشكلة في محرر Crowdin. يرجى تعطيل خيار “Parse simple xml/html tags”، وإلا فقد ترى رسالة خطأ.

• ICU Message Format for Translators

---

يتم التحكم في إصدار هذه الوثيقة - اقترح تغييرات على github.