אינטגרציית 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 באחסון עצמי. בהתאם לשלב שבו אתם נמצאים בתהליך העבודה שלכם, יש שתי דרכים להתחיל:
- בעת יצירת פרויקט חדש ב־PTC, בחרו באפשרות אינטגרציית Git באשף ההגדרה.
- כדי להעביר פרויקט קיים מהעלאת קבצים ידנית לתהליך עבודה רציף מבוסס Git, עברו אל הגדרות → Merge Requests ולחצו על Add Git Integration.
בשני המקרים, תראו מסך שבו תוכלו להזין את כתובת ה־URL לפרויקט שלכם בתוך המאגר. PTC תזהה אוטומטית שאתם משתמשים ב־GitLab.
אימות מול GitLab
כדי לחבר את המאגר שלכם, תוכלו להשתמש בטוקן גישה (מומלץ) או להתחבר באמצעות OAuth. PTC תומכת גם בטוקני גישה של פרויקט וגם בטוקני גישה של קבוצה.
PTC דורשת גישת webhook כדי לזהות שינויים במאגר שלכם. בעת שימוש בטוקן גישה, התפקיד וה־scopes שאתם צריכים תלויים באופן שבו תרצו להגדיר את ה־webhook:
| הגדרת webhook אוטומטית | הגדרת webhook ידנית | |
|---|---|---|
| איך זה עובד | PTC יוצרת ומגדירה את ה־webhook ב־GitLab עבורכם במהלך תהליך האינטגרציה. | PTC מספקת לכם Callback URL ו־Secret Token. אתם יוצרים webhook בהגדרות ה־GitLab שלכם באמצעות הפרטים האלה, עם אירועי Push ואירועי merge request כטריגרים. |
| יצירת הטוקן | בפרויקט שלכם, עברו אל Settings → Access Tokens. תנו לטוקן שם, תיאור אופציונלי, והגדירו תאריך תפוגה (מומלץ מטעמי אבטחה). | בקבוצה שלכם, עברו אל Settings → Access Tokens. תנו לטוקן שם, תיאור אופציונלי, והגדירו תאריך תפוגה (מומלץ מטעמי אבטחה). |
| תפקיד נדרש | Maintainer | Developer (או שווה ערך) |
| Scopes | api → מאפשר ל־PTC לקרוא מהמאגר ולבצע אליו push |
read_repository + write_repository |
שמרו את הטוקן במקום בטוח והוסיפו אותו ל־PTC. היא תאמת את ההרשאות שלכם ותאפשר לכם לבחור לאילו ענפים וקובצי משאבים לעשות מעקב.
הגישה נשארת מוגבלת לקבצים ש־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 כדי לבצע push לתרגומים המעודכנים אל המאגר שלכם.
מתן גישה ל־PTC לקובצי משאבים חדשים עם הוספתם
אם אתם מוסיפים קובצי משאבים חדשים למאגר שלכם לאחר האינטגרציה הראשונית, תוכלו לבקש מ־PTC לחפש אותם.
- עברו אל הגדרות → Monitored Files (קבצים במעקב) ולחצו על Rescan your repository. PTC תסרוק את המאגר שלכם ותציג כל קובץ חדש שהתגלה כטיוטה (draft).
- לחצו על סמל ה־+ ליד קובץ כדי לכלול אותו לתרגום, ולאחר מכן לחצו על Save with translation לאישור.
כדי לדלג לחלוטין על הסקירה הידנית, סמנו את תיבת הסימון Automatically include new translation files. מנקודה זו ואילך, PTC תאסוף ותנטר אוטומטית כל קובץ משאבים חדש שהיא תמצא, מבלי לדרוש מכם לאשר אותו.
כדי להתאים הגדרות אחרות כמו ענפים ושפות במעקב, נווטו בין הלשוניות Branch Management (ניהול ענפים), Monitored Files, ו־Languages (שפות).
למה לבצע לוקליזציה לפרויקטים ב־GitLab עם PTC
תרגום קבצים אוטומטי
PTC מזהה ומתרגמת אוטומטית את קובצי המשאבים שלכם, ומעבירה תרגומים באמצעות merge requests. אתם שומרים על שליטה מלאה על ידי שימוש בתהליך העבודה של GitLab שאתם כבר מכירים וסומכים עליו — וללא צורך ביצירת סקריפט כלשהו.
פחות עבודה ידנית
PTC חוסכת זמן פיתוח ומאיצה שחרור גרסאות על ידי ניטור המאגר שלכם ועדכון קובצי התרגום בזמן שאתם מבצעים push לשינויים.
דיוק תרגום משופר
PTC מונעת את הסיכון לטעויות אנוש כמו מפתחות (keys) שגויים או תרגומים מיושנים. אתם מקבלים תרגומים מדויקים מאוד ונאמנים למותג.
לוקליזציה שעומדת בקצב של פיתוח תוכנה ומובייל
PTC מיועדת לצוותי תוכנה שבונים מוצרי תוכנה ואפליקציות מובייל ורוצים שהלוקליזציה תעמוד בקצב הפיתוח. ברגע שאתם מחברים את מאגר GitLab שלכם, PTC מזהה אוטומטית מחרוזות חדשות ומעודכנות ומעבירה תרגומים בחזרה באמצעות merge request, ללא צורך בהעברה ידנית (handoff).
ישנה תמיכה מלאה בפורמטים נפוצים בפרויקטים של תוכנה ומובייל — כמו קובצי PO וקובצי JSON. למידע נוסף על האופן שבו PTC משתלבת בתהליכי עבודה אלה, ראו את עמודי הלוקליזציה לתוכנה והלוקליזציה לאפליקציות מובייל שלנו.
חיבור ל־GitLab ללא עלות נוספת
אין תשלום נוסף על חיבור ל־GitLab. במקום מודל מנויים, PTC משתמשת בתמחור Pay-As-You-Go פשוט: אתם מחויבים רק על המילים שאתם מתרגמים, ו־500 המילים הראשונות בכל חודש הן בחינם. פרטים מלאים נמצאים בעמוד התמחור של PTC.
פועלת גם עם GitHub ו־Bitbucket
בנוסף ל־GitLab, ל־PTC יש אינטגרציה עם GitHub ו־Bitbucket, והיא מציעה את אותם תהליכי עבודה של לוקליזציה אוטומטית ואותם פיצ'רים עבור כל פלטפורמה.