אינטגרציית GitLab עם PTC
חברו את GitLab ל־PTC עבור לוקליזציה מתמשכת. קבלו תרגומים שמועברים באמצעות merge requests אוטומטיות בכל פעם שהקוד שלכם משתנה.
כיצד לבצע אינטגרציה של GitLab עם PTC
PTC מתחברת למאגר GitLab שלכם ושומרת על קובצי המשאבים שלכם מתורגמים תוך כדי עבודה. דחפו שינויים לקוד שלכם ו־PTC תזהה אותם אוטומטית, תתרגם את המחרוזות המעודכנות ותפתח merge request.
אינטגרציית GitLab היא תכונת Pro. היא הופכת לזמינה כאשר אתם מפעילים את Pay-As-You-Go.
חברו את מאגר GitLab שלכם
PTC תומכת הן במאגרי GitLab.com והן במאגרי GitLab באחסון עצמי. בהתאם לשלב שבו אתם נמצאים בתהליך העבודה שלכם, ישנן שתי דרכים להתחיל:
- בעת יצירת פרויקט חדש ב־PTC, בחרו ב־Git Integration (אינטגרציית 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 וטוקן סודי. עליכם ליצור webhook בהגדרות ה־GitLab שלכם באמצעות פרטים אלו, עם Push events ו־Merge request events כטריגרים. |
| יצירת הטוקן | עברו אל Settings → Access Tokens בפרויקט או בקבוצה שלכם. תנו לטוקן שם, תיאור אופציונלי, והגדירו תאריך תפוגה (מומלץ מטעמי אבטחה). | עברו אל Settings → Access Tokens בפרויקט או בקבוצה שלכם. תנו לטוקן שם, תיאור אופציונלי, והגדירו תאריך תפוגה (מומלץ מטעמי אבטחה). |
| תפקיד נדרש | Maintainer | Developer (או שווה ערך) |
| Scopes | api → מאפשר ל־PTC לקרוא מהמאגר ולדחוף אליו |
read_repository + write_repository |
טוקן פרויקט וטוקן קבוצה עובדים שניהם בכל אחת מהעמודות — PTC קוראת את רמת הגישה הגבוהה מביניהן. מה שמפריד בין שתי העמודות הוא התפקיד, וזה נובע ממה שכל הגדרה מבצעת: הגדרה אוטומטית מנהלת webhook של פרויקט עבורכם, ש־GitLab שומרת עבור Maintainer, בעוד שהגדרה ידנית רק קוראת את המאגר ודוחפת ענף, ולכן Developer מספיק.
שמרו את הטוקן בצורה מאובטחת והוסיפו אותו ל־PTC. היא תאמת את ההרשאות שלכם ותאפשר לכם לבחור אילו ענפים וקובצי משאבים לנטר.
הגישה נשארת מוגבלת לקבצים ש־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 (יצירת MR) כדי לדחוף את התרגומים המעודכנים למאגר שלכם.
העניקו ל־PTC גישה לקובצי משאבים חדשים ככל שאתם מוסיפים אותם
אם תוסיפו קובצי משאבים חדשים למאגר שלכם לאחר האינטגרציה הראשונית, תוכלו לבקש מ־PTC לבדוק אם הם קיימים.
- עברו אל הגדרות → 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, ומציעה את אותם תהליכי עבודה של לוקליזציה אוטומטית ותכונות עבור כל פלטפורמה.