אינטגרציה בין GitLab ל־PTC
חברו את GitLab ל־PTC לצורך תרגום רציף. קבלו תרגומים באמצעות merge requests אוטומטיים בכל פעם שהקוד שלכם משתנה.
איך לחבר את GitLab ל־PTC
PTC מתחבר למאגר ה־GitLab שלכם ושומר על קובצי המשאבים שלכם מתורגמים תוך כדי עבודה. בצעו Push לשינויים בקוד ו־PTC יזהה אותם אוטומטית, יתרגם את המחרוזות המעודכנות ויפתח merge request.
אינטגרציה עם GitLab היא תכונת Pro. היא הופכת לזמינה ברגע שמפעילים את מודל Pay-As-You-Go.
חיבור מאגר ה־GitLab שלכם
PTC תומך הן ב־GitLab.com והן במאגרי GitLab בניהול עצמי (self-hosted). בהתאם לשלב שבו אתם נמצאים בתהליך העבודה, ישנן שתי דרכים להתחיל:
- בעת יצירת פרויקט חדש ב־PTC, בחרו ב־Git Integration באשף ההגדרה.
- כדי להעביר פרויקט קיים מהעלאת קבצים ידנית לתהליך עבודה רציף מבוסס Git, עברו אל Settings ← Merge Requests ולחצו על Add Git Integration.
בשני המקרים, תראו מסך שבו תוכלו להזין את כתובת ה־URL של הפרויקט שלכם בתוך המאגר. PTC יזהה אוטומטית שאתם משתמשים ב־GitLab.
אימות מול GitLab
כדי לחבר את המאגר שלכם, תוכלו להשתמש בטוקן גישה (מומלץ) או להתחבר באמצעות OAuth. PTC תומך הן בטוקני גישה ברמת הפרויקט (project access tokens) והן בטוקני גישה ברמת הקבוצה (group access tokens).
PTC זקוק לגישת webhook כדי לזהות שינויים במאגר שלכם. כשמשתמשים בטוקן גישה, התפקיד וההרשאות (scopes) הדרושים תלויים באופן שבו תרצו להגדיר את ה־webhook:
| הגדרת webhook אוטומטית | הגדרת webhook ידנית | |
|---|---|---|
| איך זה עובד | PTC יוצר ומגדיר את ה־webhook ב־GitLab עבורכם במהלך תהליך האינטגרציה. | PTC מספק לכם Callback URL ו־Secret Token. אתם יוצרים webhook בהגדרות ה־GitLab שלכם באמצעות הפרטים האלו, עם Push events ו־Merge request events כטריגרים. |
| יצירת הטוקן | בפרויקט שלכם, עברו אל Settings ← Access Tokens. תנו שם לטוקן, הוסיפו תיאור אופציונלי והגדירו expiry date (מומלץ מטעמי אבטחה). | בתוך הקבוצה (group) שלכם, עברו אל Settings ← Access Tokens. תנו שם לטוקן, הוסיפו תיאור אופציונלי והגדירו expiry date (מומלץ מטעמי אבטחה). |
| תפקיד נדרש | Maintainer | Developer (או מקביל לו) |
| הרשאות (Scopes) | api ← מאפשר ל־PTC לקרוא מהמאגר ולבצע אליו Push |
read_repository + write_repository |
שמרו את הטוקן במקום מאובטח והוסיפו אותו ל־PTC. המערכת תאמת את ההרשאות שלכם ותאפשר לכם לבחור אילו ענפים (branches) וקובצי משאבים לנטר.
הגישה נשארת מוגבלת לקבצים ש־PTC מתרגם
PTC משתמש בגישת קריאה כדי לזהות שינויים בקובצי המשאבים שלכם ובגישת כתיבה כדי לספק תרגומים באמצעות merge requests. PTC מקיים אינטראקציה רק עם הקבצים שהוא מנהל לצורך תרגום ואינו מבצע שינויים באף חלק אחר במאגר שלכם.
Webhooks שומרים על סנכרון התרגומים באופן אוטומטי
באמצעות Webhooks, PTC מקבל התראה כשאתם מבצעים Push לשינויים במאגר שלכם, כך שהוא יכול לתרגם מחדש מחרוזות שהושפעו מכך באופן אוטומטי. ללא גישת webhook, PTC לא יוכל לנטר את הענפים שלכם לצורך עדכונים.
תרגום הפרויקט שלכם עם PTC
לאחר שמאגר ה־GitLab שלכם מחובר, המשיכו בשלבי ההגדרה כדי לספק הקשר על האפליקציה או התוכנה שלכם ובחרו את שפות היעד.
לאחר מכן, PTC יתרגם את קובצי המשאבים בענף ה־GitLab המחובר. אם המאגר שלכם כבר מכיל קובצי תרגום, PTC יכול לזהות אותם ולהשתמש בהם מחדש.
סקירת ה־Merge Request עם התרגומים
PTC מתרגם תוך דקות ושולח merge request עם תרגומים ישירות למאגר ה־GitLab שלכם. כשתהיו מוכנים, פשוט בצעו merge — אין צורך בפעולה נוספת.
מאותו רגע, בכל פעם שתבצעו Push לשינויים בקוד, PTC יזהה אותם וישלח merge requests חדשים עם תרגומים מעודכנים, מה שישמור על התוכנה שלכם מתורגמת במלואה לאורך זמן.
יצירת Merge Requests חדשים באופן ידני
בנוסף לעדכונים האוטומטיים, תוכלו ליצור merge request חדש בכל עת כדי לסנכרן תרגומים שערכתם או תרגמתם מחדש.
כדי לעשות זאת, עברו ללשונית Translations. מכאן תוכלו לסקור טקסט מתורגם שחורג ממגבלת האורך ולערוך אותו ידנית או לתת ל־PTC ליצור גרסה קצרה יותר. לאחר שתסיימו, לחצו על Generate MR כדי לשלוח את התרגומים המעודכנים למאגר שלכם.
מתן גישה ל־PTC לקובצי משאבים חדשים עם הוספתם
אם תוסיפו קובצי משאבים חדשים למאגר שלכם לאחר האינטגרציה הראשונית, תוכלו לבקש מ־PTC לבדוק אם קיימים קבצים כאלו.
- עברו אל Settings ← Monitored Files ולחצו על Rescan your repository. PTC יסרוק את המאגר שלכם ויציג קבצים חדשים שהתגלו כטיוטות.
- לחצו על סמל ה־+ ליד קובץ כדי לכלול אותו בתרגום, ולאחר מכן לחצו על Save with translation כדי לאשר.
כדי לדלג על הסקירה הידנית לחלוטין, סמנו את תיבת הסימון Automatically include new translation files. מאותו רגע, PTC יזהה וינטר אוטומטית כל קובץ משאבים חדש שימצא, מבלי שתצטרכו לאשר אותו.
כדי להתאים הגדרות אחרות כמו ענפים מנוטרים ושפות, עברו בין הלשוניות Branch Management, Monitored Files ו־Languages.
למה כדאי לתרגם פרויקטים ב־GitLab עם PTC
תרגום קבצים אוטומטי
PTC מזהה ומתרגם אוטומטית את קובצי המשאבים שלכם, ומספק את התרגומים באמצעות merge requests. אתם שומרים על שליטה על ידי שימוש בתהליך העבודה של GitLab שאתם כבר מכירים וסומכים עליו — וללא צורך בכתיבת סקריפטים כלשהם.
פחות עבודה ידנית
PTC חוסך זמן פיתוח ומאיץ את ההפצות על ידי ניטור המאגר שלכם ועדכון קובצי התרגום בכל פעם שאתם מבצעים Push לשינויים.
דיוק תרגומי משופר
PTC מבטל את הסיכון לטעויות אנוש כמו מפתחות שלא במקומם או תרגומים לא מעודכנים. אתם מקבלים תרגומים מדויקים מאוד התואמים את טון המותג שלכם.
הלוקליזציה עומדת בקצב של פיתוח התוכנה והמובייל
PTC תוכנן עבור צוותים שבונים מוצרי תוכנה ואפליקציות מובייל ורוצים שהלוקליזציה תעמוד בקצב הפיתוח. ברגע שתחברו את מאגר ה־GitLab שלכם, PTC יזהה אוטומטית מחרוזות חדשות ומעודכנות ויספק את התרגומים בחזרה דרך merge request, ללא צורך בהעברה ידנית.
פורמטים נפוצים בפרויקטים של תוכנה ומובייל — כמו קובצי PO וקובצי JSON — נתמכים במלואם. למידע נוסף על האופן שבו PTC משתלב בתהליכי עבודה אלו, עיינו בדפי הלוקליזציה לתוכנה ולוקליזציה לאפליקציות מובייל שלנו.
חיבור GitLab ללא עלות נוספת
אין תשלום נוסף על חיבור GitLab. במקום מודל של דמי מנוי, PTC משתמש בתמחור Pay-As-You-Go פשוט: אתם מחויבים רק על המילים שתרגמתם, ו־500 המילים הראשונות בכל חודש הן בחינם. פרטים מלאים נמצאים בדף התמחור של PTC.
עובד גם עם GitHub ו־Bitbucket
בנוסף ל־GitLab, PTC מתממשק עם GitHub ו־Bitbucket, ומציע את אותם תהליכי עבודה ותכונות של לוקליזציה אוטומטית עבור כל אחת מהפלטפורמות.