אינטגרציית 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 קוראת את רמת הגישה הגבוהה מביניהן. מה שמפריד בין שתי העמודות הוא התפקיד, וזה נובע ממה שכל הגדרה עושה: הגדרה אוטומטית מנהלת עבורכם webhook של פרויקט, ש־GitLab שומרת עבור Maintainer, בעוד שהגדרה ידנית רק קוראת את המאגר ומבצעת push לענף, כך ש־Developer מספיק.
שמרו את הטוקן בבטחה והוסיפו אותו ל־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 (יצירת MR) כדי לבצע push לתרגומים המעודכנים אל המאגר שלכם.
תנו ל־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 חוסכת זמן פיתוח ומאיצה שחרורי גרסאות על ידי ניטור המאגר שלכם ועדכון קובצי תרגום ככל שאתם מבצעים 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, ומציעה את אותם תהליכי עבודה אוטומטיים ללוקליזציה ופיצ'רים עבור כל פלטפורמה.