Coroid يترجم منتجك بنفس المحرك الذي يستخدمه لترجمة لغاته الثلاث عشرة. تظل فهارس الترجمة ملفاتً في مستودعك، وكل تغيير عليها يصل كمهمة عادية وpull request، ولا يتم إرسال سوى السلاسل النصية الجديدة أو المتغيرة أو التالفة إلى النموذج.
توجد عمليات الترجمة تحت ضبط الجودة ← الترجمات. تعرض القائمة كل مشروع، وما إذا كانت عمليات الترجمة مُعدّة، وأحدث عملية مسح. افتح مشروعًا للوصول إلى واجهة العمل الخاصة به.
- واجهة المتجر
- موقع المستندات
- تطبيق الهاتف المحمول
| الإقليم | غير متوفرة | قديم |
|---|---|---|
| de | 0 | 2 |
| fr | 14 | 0 |
| ja | 14 | 1 |
| ar | 14 | 0 |
- الترجماتمراقبة جودة المهام وطلبات السحب· سلاسل النصوص المعدلة فقطمنشور
- مراجعة الترجماتمجدولة· كل صفحة كتالوج وإقليممسودة
مراقبة الجودة ← ترجمات لمشروع واحد: آخر فحص ترجمة لكل إقليم، بالإضافة إلى ضوابط الترجمات ومراجعة الترجمات. بيانات توضيحية.
ما يحتاجه مستودعك
Coroid يقرأ فهارس الترجمة بهذه الصيغ:
| الصيغة | استخدمها لـ |
|---|---|
| ICU JSON | ملفات الرسائل التي تحتوي على صيغ جمع واختيار من نوع ICU |
| i18next JSON | فهارس i18next وreact-i18next، بما في ذلك لاحقات الجمع |
| Vue i18n JSON | رسائل vue-i18n، بما في ذلك الرسائل المرتبطة وصيغ الجمع بالأنابيب |
| Rails YAML | config/locales/*.yml، مع %{name} عمليات الاستبدال ومفاتيح الجمع |
| gettext PO | .po ملفات وقالب .pot ، مع Plural-Forms لكل لغة |
| Markdown وMDX | صفحات الوثائق ضمن مجلد اللغة (docs/en/…): النصوص، وصف الصور، والحقول المحددة في البيانات الوصفية؛ بينما يبقى الكود والترميز كما هو. |
| مخصص | أي صيغة أخرى، عبر أمر محول صغير في مستودعك. |
ربما لا تحتاج إلى عمليات ترجمة بعد. إذا لم يكن لمشروعك نظام i18n، يمكن لـ Coroid أن يُدخله.
قم بالإعداد
الـ إعداد علبة توضح ثلاث خطوات.
- اكتشف. Coroid يُعدّ مهمة اكتشاف. يقوم بتشغيل محرك الترجمة المحدد ضد مستودعك، ويسجل البنية التحتية، وفهارس الترجمة، واللغة المصدر، وأي شيء غير مؤكد.
- اختر. اختر اعتماد نظام i18n الحالي للحفاظ على إطار العمل وفهارس الترجمة، وإضافة عمليات التحقق ومحرك الاختلافات الخاص بـ Coroid. اختر تفعيل دعم الترجمة متعددة اللغات لدمج Coroid مع إطار العمل الخاص بك، واستخراج النصوص الممثلة له، وإضافة توجيهات اللغات والنسخ الاحتياطية ودعم الاتجاه من اليمين إلى اليسار.
- إنشاء. يقوم Coroid بإنشاء مهمة الإعداد مع مواصفات ومعايير قبول، وتنتهي بـ pull request تقوم بمراجعتها مثل أي مهمة أخرى.
- واجهة المتجر
- موقع المستندات
- تطبيق الهاتف المحمول
- الكشف
- 2الاختيار
- 3الإنشاء
احتفظ بإطار العمل والكتالوجات الحالية، وأضف فحوصات الترجمة ومحرك الفروق الخاص بـ Coroid.
ربط إطار العمل، استخراج السلاسل النصية الممثلة، ثم إضافة توجيه الإقليم وسلوكيات الاستبدال والاتجاه من اليمين إلى اليسار.
- الإقليم المصدر
- en
- الأقاليم المستهدفة
- de, fr, ja, ar
علامة التبويب «الإعداد» بعد الكشف: اعتماد نظام i18n الحالي أو تطبيقه، مع تحديد الإقليم المصدر والهدف. بيانات توضيحية.
يصبح الإعداد جاهزًا بمجرد دمج ذلك pull request في الفرع الافتراضي الذي يُزامنه Coroid؛ وحتى ذلك الحين، لا يعتمد أي شيء آخر في واجهة العمل عليه.
ملف المستودع
يقوم الإعداد بكتابة .coroid/i18n.json. يصف هذا الملف مستودعك، لذا يظل داخل مستودعك ويتم تحديثه عبر طلبات سحب الكود:
{
"version": 1,
"cli": { "version": "1.7.0", "sha256": "…" },
"sourceLocale": "en",
"targetLocales": ["de", "fr", "ja", "ar"],
"catalogs": [
{
"id": "ui",
"format": "i18next-json",
"source": "messages/{locale}.json"
}
],
"localeTier": { "ja": "escalation" }
}cliيحدد نسخة المحرك بدقة وchecksum الخاص بها؛ يقوم Coroid بتنزيل تلك النسخة والتحقق منها قبل كل تشغيل، لضمان عدم تغيير النتائج بشكل مفاجئ عند تحديث المحرك.sourceLocaleيمكن أن تكون أي لغة؛ فالنص المصدر باللغة السويدية المترجم إلى الإنجليزية والألمانية يعمل بنفس الطريقة.localeTierيطلب مسار الترجمة الأقوى للغة معينة؛ حيث تختار أنت المستوى المناسب، وليس نموذج الذكاء الاصطناعي.
يمكن أن يحتوي الملف أيضًا على قاموس مصطلحات، ومصطلحات محمية، وسياق المنتج، وتعليمات خاصة بكل لغة.
لتغييره، قم بتحرير الاقتراح في علامة التبويب إعدادات واختر اقتراح تغيير. يفتح Coroid مهمة تطبق ذلك الملف بالضبط وتصحح أي ترجمات تتأثر بالتغيير.
تحتوي نفس علامة التبويب على الإعدادات الخاصة بـ Coroid وليس بمستودعك: المواقع التي يسمح لها بفتح أداة اقتراح الترجمات، وما إذا كانت الاقتراحات تخضع للمراجعة تلقائيًا، وحد الإنفاق على الترجمات للمشروع.
تفقد كل تغيير
تصبح الترجمات جزءًا من عملية التحقق عبر عمليتي ضبط جودة. أضفها من علامة التبويب نظرة عامة علامة التبويب.
- الترجمات يعمل على اختبار جودة المهام وطلبات سحب الكود؛ حيث يتحقق فقط من النصوص التي تأثرت بالتغيير.
- تدقيق الترجمة يعمل وفق جدول زمني؛ حيث يتحقق من كل فهرس ولغة، ويمكن أن يشمل اختبارًا في المتصفح لصفحات اللغة المعنية، للتأكد من تخطيط الاتجاه من اليمين إلى اليسار، وعدم تجاوز النص للحدود، وعدم ترك نص غير مترجم على الصفحة.
إضافة عنصر تحكم تُعد مسودة سياسة؛ قم بمراجعتها ونشرها تحت سياسات الجودة لتفعيلها.
كل مشكلة تتحول إلى نتيجة بها رمز مشكلة:
| الرمز | المعنى | يُمنع القبول بشكل افتراضي |
|---|---|---|
missing | النص لا يحتوي على ترجمة | نعم |
invalid_syntax | الترجمة غير صالحة للتحليل، مثل وجود أخطاء في تنسيق ICU | نعم |
placeholder_mismatch | تختلف العناصر النائبة عن النص الأصلي | نعم |
plural_categories | هناك صيغة جمع غير متوفرة للمنطقة اللغوية. | نعم |
stale | تغير المصدر بعد ترجمة النص. | لا |
يمكنك تحديد أكواد الحظر في إعدادات عنصر التحكم. تقوم قواعد القاموس والطول والمصطلحات المحظورة بإبلاغ أكوادها الخاصة عند تهيئة ملفك لها.
missingui · checkout.total · frغير مترجمstaleui · nav.deals · deتغير المصدر بعد الترجمةplaceholder_mismatchui · cart.items · jaالعناصر النائبة تختلف عن المصدرplural_categoriesui · cart.count · arتنسيقات الجمع غير متوفرة لهذا الإقليم
نتائج مراقبة الجودة من فحص الترجمات، كل مشكلة تحمل رمزًا خاصًا بها. بيانات توضيحية.
عندما يعيق أحد نتائج البحث عن الترجمة تنفيذ مهمة ما، يقوم وكيل المطور بإصلاحه بنفس الطريقة في كل مرة: حيث يفتح جلسة ترجمة للمهمة ويشغّل المحرك على السلاسل النصية المتغيرة. كما أنه لا يقوم أبدًا بتحرير فهارس الهدف يدويًا.
نموذج المترجم
للترجمة دورها الخاص في ملفات تعريف AI، مترجم، إلى جانب دور المهندس المعماري، والمطور، وخبير ضمان الجودة، والمراجع. بشكل افتراضي، يستخدم هذا الدور نموذج Hy-MT2 للترجمة، مع GPT-6 Luna كخيار احتياطي إذا سمحت سياسة مؤسستك بذلك. يمكن تغيير هذا التعيين في ملف تعريف AI مثل أي دور آخر.
كما يقوم المحرك بتجميع السلاسل النصية حسب الحجم، ويتحقق من صحة كل رد مقابل العناصر النائبة وقواعد الجمع في لغتك، ثم يعيد محاولة معالجة السلسلة أو يحيلها للتصعيد في حال فشلها.
التكاليف
تتوفر خاصية الترجمة في جميع الخطط. تمر طلبات الترجمة عبر بوابة الترجمة الخاصة بـ Coroid وتُحسب تكاليف استخدامها كاستهلاك للنماذج لصالح مؤسستك، تمامًا مثل عمليات تشغيل الوكلاء. تُحتسب مهام الإعداد ضمن ساعات تشغيل الوكلاء المخصصة لخطتك مثل أي مهمة أخرى.
باستخدام مسار المترجم الافتراضي، تبلغ تكلفة الترجمة حوالي سنتين لكل 1,000 سلسلة نصية لكل لغة. وعند قياسنا، بلغت تكلفة ترجمة كتالوج مكون من 2,000 سلسلة نصية إلى عشر لغات حوالي 0.33 دولار أمريكي.
- فقط التغييرات هي التي تكلف مالًا. يحتفظ المحرك بذاكرة تخزين مؤقت مفتاحها هو النص الأصلي، لذا لا يتم إرسال السلاسل النصية غير المتغيرة مرة أخرى.
- لكل مهمة حد ترجمة محدد. تتوقف الجلسة عند بلوغ حد الإنفاق المحدد للمهمة، والذي يبلغ دولارًا أمريكيًا بشكل افتراضي. ويمكن لمشروع ما تحديد حد أقل من ذلك تحت الإعدادات ← الوصول والإنفاق.
- لا تتم عمليات الفحص عبر نماذج الذكاء الاصطناعي. يقوم عنصر التحكم في الترجمات ووحدة التدقيق بقراءة فهارسك؛ فهما لا يقومان بالترجمة.
الترجمة خارج بيئة Coroid
المحرك عبارة عن أداة سطر أوامر، coroid-i18n. يمكن لبيئة التكامل المستمر الخاصة بك تشغيل نفس الإصدار المحدد باستخدام مفتاح OpenRouter خاص بها. أما داخل Coroid، فتستخدم المهام دائمًا بوابة الترجمة، لذا يظل الإنفاق والحدود في مكان واحد.