אינטגרציה בין 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 (מומלץ מטעמי אבטחה). | בקבוצה שלכם, עברו אל Settings → Access Tokens. תנו שם לטוקן, תיאור אופציונלי, והגדירו expiry date (מומלץ מטעמי אבטחה). |
| תפקיד נדרש | Maintainer | Developer (או מקביל לו) |
| הרשאות (Scopes) | api ← מאפשר ל־PTC לקרוא מהמאגר ולדחוף אליו שינויים |
read_repository + write_repository |
שמרו את הטוקן במקום מאובטח והוסיפו אותו ל־PTC. המערכת תאמת את ההרשאות שלכם ותאפשר לכם לבחור אילו ענפים (branches) וקובצי משאבים לנטר.
הגישה נשארת מוגבלת לקבצים ש־PTC מתרגם
PTC משתמש בהרשאת קריאה כדי לזהות שינויים בקובצי המשאבים שלכם ובהרשאת כתיבה כדי להגיש תרגומים באמצעות merge requests. PTC מקיים אינטראקציה רק עם הקבצים שהוא מנהל לצורך תרגום ואינו מבצע שינויים בשום חלק אחר במאגר שלכם.
Webhooks שומרים על סנכרון התרגומים באופן אוטומטי
באמצעות Webhooks, PTC מקבל התראה כשאתם דוחפים שינויים למאגר שלכם, כך שהוא יכול לתרגם מחדש מחרוזות שהושפעו מכך באופן אוטומטי. ללא גישת webhook, PTC לא יוכל לנטר את הענפים שלכם לצורך עדכונים.
תרגום הפרויקט שלכם עם PTC
ברגע שמאגר ה־GitLab שלכם מחובר, המשיכו בשלבי ההגדרה כדי לספק הקשר על האפליקציה או התוכנה שלכם ובחרו את שפות היעד.
לאחר מכן, PTC יתרגם את קובצי המשאבים בענף ה־GitLab המחובר. אם המאגר שלכם כבר מכיל קובצי תרגום, PTC יכול לזהות אותם ולהשתמש בהם מחדש.
סקירת ה־merge request עם התרגומים
PTC מתרגם תוך דקות ושולח merge request עם תרגומים ישירות למאגר ה־GitLab שלכם. כשתהיו מוכנים, פשוט בצעו merge — אין צורך בשום פעולה נוספת.
מאותו רגע, ככל שתדחפו שינויים לקוד שלכם, 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 חוסך זמן פיתוח ומאיץ גרסאות על ידי ניטור המאגר שלכם ועדכון קובצי התרגום בזמן שאתם דוחפים שינויים.
דיוק תרגום משופר
PTC מבטל את הסיכון לטעויות אנוש כמו מפתחות שלא במקומם או תרגומים לא מעודכנים. אתם מקבלים תרגומים מדויקים מאוד התואמים את טון המותג שלכם.
הלוקליזציה עומדת בקצב של פיתוח תוכנה ואפליקציות לנייד
PTC תוכנן עבור צוותים הבונים מוצרי תוכנה ואפליקציות לנייד שרוצים שהלוקליזציה תעמוד בקצב הפיתוח. ברגע שתחברו את מאגר ה־GitLab שלכם, PTC יזהה אוטומטית מחרוזות חדשות ומעודכנות ויגיש את התרגומים בחזרה דרך merge request, ללא צורך בהעברה ידנית.
פורמטים נפוצים בפרויקטים של תוכנה ומובייל — כמו קובצי PO וקובצי JSON — נתמכים באופן מלא. למידע נוסף על האופן שבו PTC משתלב בתהליכי עבודה אלו, עיינו בדפי הלוקליזציה לתוכנה והלוקליזציה לאפליקציות לנייד שלנו.
חיבור GitLab ללא עלות נוספת
אין תשלום נוסף על חיבור GitLab. במקום מודל של דמי מנוי, PTC משתמש בתמחור Pay-As-You-Go פשוט: אתם מחויבים רק על המילים שאתם מתרגמים, ו־500 המילים הראשונות בכל חודש הן בחינם. פרטים מלאים נמצאים בדף התמחור של PTC.
עובד גם עם GitHub וגם עם Bitbucket
בנוסף ל־GitLab, PTC מתממשק עם GitHub ועם Bitbucket, ומציע את אותם תהליכי עבודה ותכונות של לוקליזציה אוטומטית עבור כל אחת מהפלטפורמות.