תרגום Plot Device

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

תרגום האפליקציה

1. מעתיקים את packages/i18n/src/messages/en.json לקובץ <code>.json (למשל fr.json).
2. מתרגמים כל הודעה. את $1, ‏$2 ו־{{PLURAL:…}} משאירים כמו שהם: האפליקציה ממלאת אותם.
3. מוסיפים את השפה לקטלוגים ב־packages/i18n/src/translator.ts. בדיקה אוטומטית מוודאת שכל הודעה תורגמה.

תרגום האתר

1. מוסיפים את השפה ל־locales ב־apps/site/astro.config.ts, עם dir: 'rtl' אם היא נכתבת מימין לשמאל, ול־LANGUAGES ב־apps/site/src/site.ts.
2. מתרגמים את דפי המדריך לתוך apps/site/src/content/docs/<code>/docs/, עם אותם שמות קבצים כמו ב־docs/. דפים שעוד לא תורגמו מציגים את האנגלית עם הודעה, כך שאפשר להתקדם דף אחרי דף.
3. בכל דף מתורגם, ב־frontmatter, קובעים sourceHash לפי הערך של הדף האנגלי בדוח שלמטה. כשהדף האנגלי ישתנה, הדוח יציין שהתרגום צריך עדכון.
4. מעתיקים את apps/site/src/i18n/en.json לקובץ <code>.json ומתרגמים את הדפים של האתר עצמו (העמוד הראשי, התמיכה ודף השפות). הקובץ qqq.json, שלידו, מסביר מהי כל הודעה ואיפה היא מופיעה.
5. מוסיפים את השפה ל־LANGUAGES ב־apps/site/screenshots/screens.shots.ts, כדי שצילומי המסך באתר יראו את האפליקציה בשפה הזו.

שמות הכפתורים במדריך מגיעים מהאפליקציה, דרך <Ui k="…" />, כך שהם מופיעים בשפה החדשה ברגע שהאפליקציה מדברת אותה.

דוחות תרגום

pnpm site:translations

מונה, לכל שפה, את הדפים שעוד לא תורגמו, את אלה שהאנגלית שלהם השתנתה מאז, ואת הודעות האתר שעוד לא תורגמו.