שפות וימין־לשמאל
הממשק של Gitcito מתורגם. השפה היא הגדרה של Gitcito, לא של מערכת ההפעלה — מפתח על התקנת macOS באנגלית שמעדיף לקרוא יפנית קובע זאת כאן, ומפתח על מערכת בעברית שמעדיף את האפליקציה באנגלית אינו נדרס.
הגדרות ← כללי ← שפה.
מה נשלח באפליקציה
| English | Español | Deutsch | Français |
| Português (Brasil) | Italiano | Nederlands | Polski |
| Türkçe | Русский | Українська | 简体中文 |
| 日本語 | 한국어 | العربية | עברית |
כל שורה בבורר כתובה בשפה של עצמה. מי שמחפש קוריאנית סורק אחרי 한국어, לא אחרי המילה ״קוריאנית״ בשפה שהוא מנסה לעזוב.
על הדגלים
דגל נוקב בשם מדינה; לוקאל נוקב בשם שפה. השניים באמת אינם מתיישרים — ערבית היא שפה רשמית ביותר מעשרים מדינות, ופורטוגזית נמצאת בשתי יבשות. הסמלים עוקבים אחרי אותה מוסכמה שבורר הלוקאלים של כל מערכת הפעלה משתמש בה: האזור הראשי של הלוקאל. הם שם כדי להיות מזוהים במבט אחד, לא כדי לטעון טענה על מי שהשפה שייכת לו.
הם מצוירים כאמנות וקטורית ולא כאמוג׳י בכוונה. Windows לא נשלחת עם אמוג׳י דגלים
בכלל — 🇩🇪 מרונדר שם כתיבה שמכילה את האותיות ״DE״.
ימין־לשמאל
ערבית ועברית משקפות את כל הממשק: סרגל הצד עובר ימינה, פאנלים וסרגלי כלים מתהפכים, וסמלים שמצביעים לאנשהו מצביעים לכיוון השני.
המעבר מיידי ואינו דורש הפעלה מחדש.
מה שבכוונה אינו משוקף
חלק מהתוכן הוא משמאל לימין לא משנה באיזו שפה אתם קוראים. שיקוף שלו היה שגוי באופן פעיל, ולכן אלה נשארים כפי שהם:
| נשאר משמאל לימין | למה |
|---|---|
| גרף הקומיטים | מיקומי המסלולים מחושבים בפיקסלים; מכולה משוקפת הייתה חולקת על הקווים המצוירים |
| דיפים ותוכן קבצים | קוד הוא משמאל לימין, ודיף משוקף הוא בלתי קריא |
| blame ופלט ההתנגשויות | אותה סיבה — הטקסט הוא מקור, לא פרוזה |
| הטרמינל המשולב | הוא מרנדר רשת משלו; הפלט של git הוא משמאל לימין |
| נתיבים, SHA־ים, refs ופקודות | refs/heads/main נקרא לכיוון אחד בלבד |
כל אחד מאלה מבודד, כך שרצף של ערבית בתוכו — שם ענף, הודעת קומיט, שם קובץ — לא יכול לסדר מחדש את הטקסט שסביבו.
המגבלות
כאן נאמר בכנות היכן זה נעצר:
- הודעות קומיט, שמות ענפים ותוכן קבצים לעולם אינם מכוונים מחדש על ידי Gitcito. הם מוצגים כפי שהמחבר שלהם כתב אותם. הודעת קומיט בעברית ברשימה מבודדת לכיוון משמאל לימין מרונדרת כעברית, אבל השורה שסביבה לא מתהפכת כדי להכיל אותה.
- משטחים של צד שלישי שומרים על הכיוון שלהם — הטרמינל הוא xterm, ותצוגות מקדימות של Markdown מרנדרות את המסמך כפי שנכתב.
- שמות קבצים בכיוון מעורב הם קשים. נתיב עם תיקייה בערבית בתוך עץ באנגלית מבודד ולא מסודר מחדש, וזה נכון אבל עדיין יכול להיראות מפתיע בפעם הראשונה.
גם ספר ההדרכה הזה מתורגם
לא רק הכפתורים. כל עמוד שאתם קוראים קיים בכל שפה שמופיעה ברשימה שלמעלה — ההסברים, הטבלאות של מה כל אפשרות עושה, והמקטעים שאומרים מה תכונה מסרבת לעשות. החלפת שפת הממשק מחליפה איתה את ספר ההדרכה, גם באפליקציה וגם באתר.
לתרגום מותר להיות חלקי. אם עמוד עדיין לא תורגם, אתם מקבלים את זה שבאנגלית ולא עמוד חסר, וסרגל הצד שומר על אותה צורה בכל שפה, כך שצילום מסך או הוראה עדיין מתיישרים עם מה שאתם רואים.
באתר, כל עמוד נושא מחליף שפה שמשאיר אתכם בעמוד שקראתם, כי החלפת שפה אינה כמו להתחיל מחדש.
מה מתורגם במכונה, ומה זה עולה. אנגלית וספרדית נכתבו ביד. השאר תורגם על ידי מודל מול מילון מונחים, ואז נבדק בסקריפט: כל עמוד, כל קישור, כל נתיב תמונה, כל בלוק קוד בייט־בייט מול האנגלית. זה תופס מבנה שבור. זה לא תופס משפט שהוא נכון אבל נוקשה. אם עמוד נקרא רע בשפה שלכם, זה באג ששווה לדווח עליו.
הוספת שפה
המילונים הם קובץ אחד לכל לוקאל תחת src/renderer/src/i18n/, וקובץ האנגלית הוא
ההפניה שכל אחד אחר נבדק מולה בבדיקת טיפוסים — מפתח חסר הוא שגיאת קומפילציה, לא
נפילה שקטה חזרה לאנגלית. חבילת הבדיקות גם בודקת שכל {placeholder} שמחרוזת
משבצת שורד את התרגום, כך שמשפט לא יכול לאבד את ה־sha של הקומיט שלו בדרך לשפה
אחרת.
ספר ההדרכה עובד באותה דרך: docs/help/ מחזיק את העמודים באנגלית
ו־docs/help/<locale>/ מחזיק כל תרגום, קובץ אחד לכל עמוד עם אותו שם קובץ.
npm run lint:docs בודק שלכל עמוד מתורגם יש מקור באנגלית, שה־front matter שלו
שלם, ושהקישורים והתמונות שלו נפתרים מתיקייה אחת עמוק יותר.
תרומות מתקבלות בברכה — עמוד בכל פעם זה בסדר גמור, ותיקון תרגום מגושם שימושי בדיוק כמו הוספת אחד חסר.
ראו גם: ערכות נושא ומראה · פרופילים