localize.dev

الوثائق / ترجم / Rails YAML

ترجمة ملفات YAML الخاصة بـ Rails

املأ config/locales/<lang>.yml لملفات Rails وقواميس YAML الأخرى، مع الاحتفاظ باستيفاء %{name} وتوسيع خرائط الجمع one/other إلى أشكال كل لغة.

كيف يعمل

يقرأ localize-dev translate config/locales/en.yml، وملفات مثل devise.en.yml بجانبه، ثم يكتب المفاتيح المفقودة في ملف كل لغة تحت مفتاح اللغة الخاص بها. تحصل اللغة التي ليس لديها ملف بعد على واحد: devise.en.yml تحصل على devise.pl.yml.

يتم الاحتفاظ بـ Rails %{name} و %<name>s و i18n-js {{name}} وعناصر نائبة printf. تُعامل خريطة فئات الجمع (one:، other:) كرسالة واحدة وتُكتب بالفئات التي تستخدمها اللغة المستهدفة.

قبل وبعد

الناتج الفعلي لـ localize-dev translate --locales pl على الملف الأول. تحصل خريطة الجمع items على few و many للغة البولندية، وتظل القيم التي تبدأ بـ % مقتبسة.

config/locales/en.yml
en:
  orders:
    title: "Your orders"
    shipped: "Shipped to %{city} on %{date}"
    items:
      one: "%{count} item"
      other: "%{count} items"
config/locales/pl.yml · البولندية
pl:
  orders:
    title: Twoje zamówienia
    shipped: Wysłano do %{city} dnia %{date}
    items:
      one: "%{count} przedmiot"
      few: "%{count} przedmioty"
      many: "%{count} przedmiotów"
      other: "%{count} przedmiotów"

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

  • استيفاء %{name}، يتم التحقق منه بعد الترجمة
  • خرائط الجمع، مع إضافة few: و many: حيث تحتاجها اللغة
  • تداخل الملف المصدر، تحت مفتاح اللغة المستهدفة
  • YAML صالح: القيم مقتبسة حيث يحتاجها YAML

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

خرائط الجمع مع one و other فقط

يختار Rails مفتاح الجمع بقواعد اللغة. إذا كان pl.yml يحتوي فقط على one و other، فإن الأعداد مثل 3 أو 25 ليس لها شكل خاص بها. تتم كتابة كل فئة تستخدمها اللغة.

أسماء الاستيفاء المترجمة

يجب أن يظل %{city} كما هو %{city}، وإلا فإن Rails يثير خطأ استيفاء مفقود في وقت التشغيل. يتم إخفاء العناصر النائبة قبل الترجمة والتحقق منها بعدها.

اقتباس مكسور

القيمة التي تبدأ بـ % أو تحتوي على : تحتاج إلى علامات اقتباس، والترجمة التي تم تحريرها يدويًا تفقدها بسهولة. الملف مكتوب بواسطة مكتبة YAML، لذا فإن الاقتباس يتبع قواعد YAML.

قم بتشغيله

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