מדריך הלוקליזציה הופך פרויקט לרב-לשוני. הוא קורא את המאגר שלכם, מתחיל כל שלב מהנתונים שהוא מוצא, ומסיים במשימה אחת שפותחת את pull request. לעולם לא תצטרכו להקליד קוד שפה או לערוך את JSON; שנו רק את מה שתרצו, ושום דבר לא ישתנה במאגר עד שתבצעו מיזוג.
בעלים ומנהלי מערכת מפעילים את המדריך. התחילו אותו מ- לוקליזציה: בחרו לוקליזציה של פרויקט, או הפעלת המדריך בשורת הפרויקט. עבור פרויקט שכבר רב-לשוני, הגדרות → שינוי שפות פותח את אותו מדריך כדי להציע שינויים.
השלבים
1. סריקה
Coroid קורא את הענף המוגדר כברירת מחדל מבלי להריץ את הקוד שלו. הוא מחפש קטלוגים והשפות שלהם, המסגרות שבשימוש, וטקסטים שעדיין כתובים ישירות בקוד, בחישוב לפי קובץ.
- נמצאו קטלוגים. המדריך שומר עליהם: Coroid מוסיף את הבדיקות שלו ומתרגם את מה שחסר. לכך קוראים אימוץ.
- אין קטלוגים עדיין. Coroid מעביר את הטקסט בקוד שלכם לתוך קטלוגים ומחליף אותו בפקודות חיפוש. לכך קוראים הכנסה.
- כבר הוגדר. לפרויקט כבר יש תצורת Coroid, והמדריך מציע שינויים בה.
2. שפת מקור
השפה שבה נכתב המוצר; כל שפה אחרת מתורגמת ממנה. המדריך מזהה אותה מהקטלוגים שלכם, או משער אותה מהטקסט בקוד. כל שפה יכולה להיות שפת מקור: מוצר בשוודית שמתורגם לאנגלית וגרמנית פועל באותו אופן.
3. שפות
בחרו שפות אחת אחת, או הוסיפו שוק שלם בבת אחת: הנפוצות ביותר, אירופה, המדינות הנורדיות, מזרח אסיה, האמריקות או מימין לשמאל. כל שפה מציגה את שמה, האם היא נכתבת מימין לשמאל, וכמה צורות רבים נדרשות לה.
ניתן להסיק גרסאות אזוריות במקום לתרגם אותן. אנגלית בריטית נגזרת מאנגלית אמריקאית עם איות בריטי, וגרמנית שווייצרית נגזרת מגרמנית עם איות שווייצרי – כך שהן אינן עולות כסף ונשארות תואמות להוריהן.
כל שלב מתחיל ממה שהמאגר כבר מכיל. שנה רק את מה שאתה רוצה; שום דבר לא משתנה עד ש־pull request ימוזג.
- סריקה
- שפת מקור
- שפות
- מחרוזות
- סגנון ומונחים
- איכות ואוטומציה
- סקירה
בחרו שפות אחת-אחת או הוסיפו שוק שלם. ניתן לגזור וריאנטים אזוריים כגון אנגלית בריטית באמצעות כללים במקום תרגום ידני.
- Deutschגרמנית · de · 2 צורות רבים
- Françaisצרפתית · fr · 3 צורות רבים
- 日本語יפנית · ja · 1 צורת רבים
- العربيةערבית · ar · מימין לשמאל · 6 צורות רבים
- British Englishאנגלית (בריטניה) · en-GB · 2 צורות רביםנגזר עם איות בריטי
מדריך ה-Internationalization בשלב השפות שלו: כל שפה עם כיוון הכתיבה והצורות הרבות שלה, אנגלית בריטית שנגזרה מכללים, ושווקים להוספה בבת אחת. נתונים אילוסטרטיביים.
4. מחרוזות
במהלך אימוץ, בחרו את הקטלוגים ש־Coroid שומר על תרגומם; המפתחות והמבנה שלהם נשארים כפי שהם. במהלך הכנסה, בחרו את הקבצים שטקסט שלהם יועבר לקטלוגים על ידי Coroid; הקבצים שתשאירו בחוץ יישארו כפי שהם.
5. סגנון ומונחים
כולם אופציונליים, ונאכפים בכל השפות:
- רשמי או לא רשמי. עבור שפות שמכוונות לקורא בצורה רשמית או לא רשמית, כמו גרמנית Sie ו- du. כברירת מחדל, כל אחד נצמד לטון של הטקסט המקורי.
- מונחים שנשמרים כפי שהם. שמות מוצר, מותג ותכונה שנשארים זהים בכל השפות.
- אודות המוצר. מספר משפטים על המוצר וקהל היעד שלו, שעוזרים לכל תרגום לבחור את המילים הנכונות.
6. איכות ואוטומציה
פועלים כברירת מחדל, וכל אחד מהם ניתן לשינוי מאוחר יותר:
- בדיקת תרגומים בכל שינוי. בדיקת התרגומים בבקרת איכות שולחת שינוי בחזרה כשהיא מזהה מחרוזות חסרות או פגומות.
- תרגום מחרוזות שמומזגו מחוץ ל־Coroid. כאשר מישהו מבצע מיזוג של טקסט חדש ללא Coroid, משימה מתרגמת אותו.
- יישום תיקונים מדי לילה. הצעות מאושרות ממתרגמים מגיעות כמשימה אחת של pull request מדי לילה.
- לאפשר לאנשים שהוזמנו להציע ניסוחים. קוראים ילידים שתזמינו יכולים לתקן תרגומים באתר שלכם. ראו תחזוקת תרגומים עם הצעות.
קובץ התצורה מכיל את ההגדרה האחרונה. Coroid מפעיל את השאר בפעם הבאה שבעלים או מנהל מערכת יפתחו את עמוד הלוקליזציה לאחר מיזוג ה־pull request, ורק פעם אחת: אם תכבו אפשרות מאוחר יותר, היא תישאר כבויה.
7. סקירה
תקציר של הפרויקט, מה תעשה המשימה, שפת המקור, השפות ואילו מהן נגזרות, נפח התרגום, המונחים שנשמרים כפי שהם, ומה יופעל לאחר המיזוג. תרגום נחשב כשימוש במודל, כמו עבודת סוכן אחרת, ומוגבל לפי משימה.
בחרו לוקליזציה. Coroid יוצר משימה אחת עם מפרט וקריטריוני קבלה ומתחיל אותה מיד.
מה תעשה המשימה
- אימוץ הכלי כותב את קובץ ההגדרות בדיוק כפי שהמאסטר שילב אותו, ולאחר מכן מתרגם כל מחרוזת חסרה.
- הצגה ראשונה הכלי מחבר את המסגרת שלך, מעביר את הטקסט של הקבצים הנבחרים לקטלוגים, מוסיף ניתוב שפות, גיבויים ותמיכה בימין-לשמאל, ולאחר מכן מתרגם.
- שינוי הכלי כותב את ההגדרות החדשות ומתקן את התרגומים שנפגעו מהשינוי.
המשימה מסתיימת ב־pull request. לאחר מיזוגו לענף ברירת המחדל, כל השפות יופיעו בלוקליזציה.
פורמטים
Coroid קורא קטלוגים בפורמטים הבאים:
| פורמט | שימוש בו לצורך |
|---|---|
| ICU JSON | קבצי הודעות עם צורות רבות ובחירות של ICU |
| i18next JSON | קטלוגים של i18next ו־react-i18next, כולל סיומות לצורות רבות |
| Vue i18n JSON | הודעות של vue-i18n, כולל הודעות מקושרות וצורות רבות מסוג pipe |
| Rails YAML | config/locales/*.yml, יחד עם %{name} אינטרפולציה ומפתחות לצורות רבות |
| gettext PO | .po קבצים ו־ .pot תבנית, יחד עם Plural-Forms לכל שפה |
| Markdown ו־MDX | דפי תיעוד בתוך תיקיית שפה ( ): טקסט, תיאורי תמונות ושדות Frontmatter נבחרים; הקוד והתגיות נשארים כפי שנכתבוdocs/en/…): טקסט, תיאורי תמונות ושדות Frontmatter נבחרים; הקוד והתגיות נשארים כפי שנכתבו |
| מותאם אישית | כל פורמט אחר, באמצעות פקודת מתאם קטנה במאגר שלך. |
קובץ ההגדרות
המאסטר כותב .coroid/i18n.json. הוא מתאר את המאגר שלך, לכן הוא נמצא בתוך המאגר שלך ומשתנה דרך בקשות משיכה:
{
"version": 1,
"cli": { "version": "1.9.0", "sha256": "…" },
"sourceLocale": "en",
"targetLocales": ["de", "fr", "ja", "ar"],
"derivedLocales": [
{ "locale": "en-GB", "from": "en", "rules": "en-gb-spelling" }
],
"catalogs": [
{
"id": "ui",
"format": "i18next-json",
"source": "messages/{locale}.json"
}
],
"protectedTerms": ["Storefront"],
"localeInstructions": {
"de": "Address the reader informally (du)."
}
}cliהכלי קובע את גרסת המנוע המדויקת ואת סיכום הבדיקה שלה. Coroid מבצע הורדה ובדיקה של אותה גרסה לפני כל ריצה, כך שעדכון לא ישנה את הפלט שלך באופן בלתי צפוי.derivedLocalesהכלי מציג את הגרסאות האזוריות שנוצרו על פי הכללים.protectedTermsו־localeInstructionsמכילים את מה שבחרת תחת סגנון ומונחים.
הקובץ יכול גם להכיל מילון מונחים, הקשר של המוצר, נתיבי תרגום לפי שפה וקישור ההצעות עבור תורמים.
הגדרות → קובץ ההגדרות בתחנת העבודה מציג את הקובץ המדויק בענף ברירת המחדל. כדי לשנות אותו שם, ערוך את ההצעה ובחר הצעת שינוי: Coroid פותח משימה שמיישמת בדיוק את אותו קובץ ומתקן את כל התרגומים שנפגעו מהשינוי. עבור שפות וסגנון, המאסטר הוא הדרך הקלה יותר.