תיעוד

תרגם את הפרויקט שלך

הגדירו תרגומים לפרויקט, עדכנו אותם באופן שוטף באמצעות בקרת איכות, ודעו מה עלותם.

Coroid מתרגם את המוצר שלכם באותו מנוע שבו הוא משתמש לתרגום לשלושה-עשר שפות משלו. הקטלוגים שלכם נשארים קבצים במאגר שלכם. כל שינוי בהם מגיע כמשימה רגילה ו־pull request, ורק המחרוזות החדשות, המשונות או הפגומות נשלחות למודל.

התרגומים נמצאים תחת בקרת איכות → תרגומים. הרשימה מציגה כל פרויקט, האם התרגומים מעוצבים בו, ואת הסריקה האחרונה. פתחו פרויקט כדי לגשת לסביבת העבודה שלו.

דף חנות
מוגדר · שפת מקור: en · 4 שפות יעד
סקירההגדרותתצורהתורמיםהצעותאוטומציות
סריקה אחרונהצפייה בממצאיםצפייה בריצה
שפהחסרלא מעודכן
de02
fr140
ja141
ar140
  • תרגומיםבדיקת משימות ובקשות משיכה · רק מחרוזות משתנותפורסם
  • ביקורת תרגוםבהתאם ללוח זמנים · כל קטלוג ודף שפהטיוטה

בקרת איכות → תרגומים לפרויקט אחד: בדיקת התרגום האחרונה לפי שפה, וכן בקרות תרגום וביקורת תרגום. נתונים להמחשה.

מה נדרש מהמאגר שלכם?

Coroid קורא קטלוגים בפורמטים הבאים:

פורמטלשימוש ב
ICU JSONקבצי הודעות עם צורות רבות ובחירות של ICU
i18next JSONקטלוגים של i18next ו־react-i18next, כולל סיומות רבות
Vue i18n JSONהודעות vue-i18n, כולל הודעות מקושרות וצורות רבות מסוג pipe
Rails YAMLconfig/locales/*.yml, יחד עם %{name} הכנסה ומפתחות רבים
gettext PO.po קבצים ו־ .pot תבנית, יחד עם Plural-Forms לכל שפה
Markdown ו־MDXדפי תיעוד בתוך תיקיית שפה (docs/en/…): טקסט, תיאורי תמונות ושדות Frontmatter נבחרים; הקוד והעיצוב נשארים כפי שהם.
מותאם אישיתכל פורמט אחר, באמצעות פקודת מתאם קטנה במאגר שלכם.

אינכם זקוקים לתרגומים כרגע. אם בפרויקט שלכם אין i18n, Coroid יכול להגדיר אותו.

הגדירו

ה־ הגדרה הכרטיסיה מדריכה אתכם בשלושה שלבים.

  1. זהוּת. Coroid מכין משימת גילוי. הוא מריץ את מנוע התרגום המוגדר נגד המאגר שלכם ורושם את המערכת, את הקטלוגים, איזו שפה היא המקורית, וכל דבר שאינו ברור לו.
  2. בחירה. בחרו לאמץ i18n קיים כדי לשמור על המסגרת ועל הקטלוגים שלכם ולהוסיף את הבדיקות והמנוע של Coroid. בחרו הכנסת תמיכה ב-i18n כדי ש־Coroid יחבר את המסגרת שלכם, יפיק מחרוזות מייצגות ויוסיף ניתוב שפות, מנגנוני גיבוי ותמיכה בכתיבה מימין לשמאל.
  3. יצירה. Coroid יוצר את משימת ההגדרה עם תיאור טכני וקריטריוני קבלה. התוצאה היא pull request שאותו ניתן לסקור כמו כל משימה אחרת.
דף חנות
עדיין לא הוגדר · תהליך הקמה בתהליך
סקירההגדרותתצורהתורמיםהצעותאוטומציות
  1. זיהוי
  2. 2בחירה
  3. 3יצירה
זוהה: Next.js עם next-intl · 3 קטלוגי JSON · שפת מקור: en
אימוץ מערכת i18n קיימת

שמור על המסגרת והקטלוגים הקיימים, והוסף בדיקות תרגום ומנוע דלתא של Coroid.

הטמעת מערכת i18n

חבר את המסגרת, חלץ מחרוזות מייצגות, והוסף ניתוב שפות, גיבויים והתנהגות RTL.

שפת מקור
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 הקובץ מציין את גרסת המנוע המדויקת ואת סיכום הבדיקה שלה. Coroid יוריד ויאמת את הגרסה הזו לפני כל ריצה, כך שעדכון לא ישנה את הפלט באופן בלתי צפוי.
  • sourceLocale ניתן להשתמש בכל שפה. תרגום של מקור בשוודית לאנגלית ולגרמנית פועל באותו אופן.
  • localeTier המערכת מבקשת לקבוע את רמת התרגום הגבוהה יותר עבור שפה מסוימת. אתם בוחרים את הרמה, לא את המודל.

הקובץ יכול גם לכלול מילון מונחים, ביטויים מוגנים, הקשרי מוצר והוראות ייחודיות לכל שפה.

כדי לשנותו, ערכו את ההצעה ב־ תצורה כרטיסייה ובחרו הצעת שינוי. Coroid יפתח משימה שתיישם בדיוק את הקובץ הזה ותתקן את כל התרגומים שנפגעו מהשינוי.

בכרטיסייה זו נמצאות גם ההגדרות השייכות ל־Coroid ולא למאגר שלכם: אילו אתרים רשאים לפתוח את מבחר ההצעות, האם ההצעות נבדקות כברירת מחדל, ומגבלת ההוצאות על תרגום של הפרויקט.

בדוקו כל שינוי

התרגומים הופכים לחלק מתהליך האימות באמצעות שתי בקרות איכות. ניתן להוסיפם מ־ תצוגה כללית כרטיסייה.

  • תרגומים פועל על בדיקת QA של משימות ועל בקשות למשיכת קוד. הוא בודק רק את המחרוזות שנגע בהן השינוי.
  • ביקורת תרגום פועל לפי לוח זמנים. הוא בודק כל קטלוג ושפה, ויכול לכלול גם בדיקת דפדפן של דפי השפה, כדי לוודא ניווט מימין לשמאל, מניעת חריגות ווידוא שאין טקסט שלא תורגם בדף.

הוספת בקרה יוצרת טיוטת מדיניות. סקרו אותה ופרסמו אותה תחת מדיניות איכות כדי להפעילה.

כל בעיה הופכת לממצא עם קוד בעיה:

קודמשמעותחוסם כברירת מחדל
missingהמחרוזת אינה מתורגמתכן
invalid_syntaxהתרגום אינו תקין, למשל כשה־ICU שבורכן
placeholder_mismatchהתחליפים שונים מהמקורכן
plural_categoriesצורת הרבים הדרושה לאזור זה חסרהכן
staleהמקור השתנה לאחר תרגום המחרוזתלא

אתם בוחרים אילו קודים ייחסמו בהגדרות הבקרה. מילון מונחים, כללי אורך ומונחים אסורים מדווחים על הקודים שלהם כאשר הקובץ שלכם מגדיר אותם.

בקרת איכות
ממצאים מהפעלות האחרונות, המסוננים לפי בדיקת תרגומים.
מדיניותממצאים4ריצות
  • 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 דולר במדידה שלנו.

  • רק שינויים גורמים לחיוב. המנוע שומר מטמון המבוסס על הטקסט המקורי, כך שמחרוזות שלא השתנו לעולם לא נשלחות שוב.
  • לכל משימה יש מגבלת תרגום. מושבת העבודה נעצרת ברגע שמגיעה למגבלת ההוצאה של המשימה, שעומדת על 1 דולר כברירת מחדל. ניתן להגדיר מגבלה נמוכה יותר עבור פרויקט בתוך תצורה → גישה והוצאות.
  • בדיקות אינן מבצעות קריאות מודל. בקרת התרגומים והאודיט קוראים את הקטלוגים שלכם; הם אינם מתרגמים.

תרגום מחוץ ל-Coroid

המנוע הוא כלי שורת פקודה, coroid-i18n. ה-CI שלכם יכול להריץ את אותה גרסה קבועה עם מפתח OpenRouter משלו. בתוך Coroid, משימות תמיד משתמשות בשער התרגום, כך שההוצאות והמגבלות נשארות במקום אחד.