שלבו לוקליזציה בצינור ה־CI/CD שלכם בעזרת ה־API של PTC
למדו כיצד לשלב את ה־API של PTC בצינור ה־CI/CD שלכם כדי לספק תרגומים מבוססי בינה מלאכותית באיכות אנושית כחלק מתהליך ה־build שלכם.
מאובטח מטבעו — אין צורך בגישת קריאה או כתיבה למאגר.- תואם לכל מערכת CI/CD, כולל תצורות מוכנות מראש.
- גישה מבוקרת באמצעות טוקני API ייעודיים לפרויקט.
- תרגומים באיכות אנושית שמוכנים תוך דקות, ישירות ב־build שלכם.
כיצד עובד השילוב עם CI/CD
לפני שתגדירו את PTC עם מערכת ה־CI שלכם, הנה שלושת העקרונות שעומדים מאחורי ה־API וה־CLI של PTC:
1. קובצי משאבים מקושרים לענף
כל קובץ שאתם שולחים ל־PTC מקושר לשם של ענף (לדוגמה main, feature/new-checkout). הדבר שומר על הפרדה בין התרגומים, כך שתרגומים מתכונות שונות לא דורסים זה את זה.
כאשר אתם משתמשים בתצורות ה־CI/CD המוכנות מראש, המיפוי הזה מתבצע באופן אוטומטי.
2. התרגומים מעובדים באופן אסינכרוני
PTC אינה מחזירה תרגומים באופן מיידי. במקום זאת, היא:
- מעלה את הקבצים המעודכנים
- מזהה רק את המחרוזות החדשות או אלו ששונו
- מתרגמת את המחרוזות
- מכינה את הקבצים המתורגמים להורדה
3. סקריפט CLI אחד עובד בכל מקום
במקום לקרוא ל־API בעצמכם, השתמשו ב־PTC CLI:
סקריפט אחד מנהל את כל התהליך (העלאה → תשאול → הורדה). ה־CLI פועל על Linux ו־macOS, ועובד עם GitHub Actions, GitLab, Bitbucket, או כל פלטפורמת CI/CD אחרת.
זרימת תהליך כללית: הגדרת ה־API של PTC בצינור ה־CI/CD שלכם
1התחילו תקופת ניסיון.
קבלו גישה מלאה לכל התכונות ותרגמו עד 20,000 מילים לכל שתי שפות שתבחרו.
2צרו פרויקט חדש.
כאשר תבחרו כיצד להשתמש ב־PTC, בחרו ב־API integration (שילוב API). במהלך ההגדרה, תספקו מעט הקשר על הפרויקט שלכם (מה הוא עושה, למי הוא מיועד) ותבחרו את השפות שאליהן תרצו לתרגם.
3קבלו את טוקן ה־API שלכם.
בסיום ההגדרה, תקבלו טוקן API ייעודי לפרויקט. העתיקו ושמרו אותו במקום בטוח — תזדקקו לו כדי לאמת את כל הבקשות. תמיד תוכלו למצוא את אותו הטוקן שוב בלוח הבקרה של הפרויקט שלכם תחת Settings → PTC API tokens (הגדרות → טוקני API של PTC).
4הוסיפו את טוקן ה־API של PTC למאגר שלכם במיקום הנכון.
| ספק | היכן להוסיף את הטוקן |
|---|---|
| GitHub Actions | עברו אל Settings → Secrets and variables → Actions והוסיפו את PTC_API_TOKEN. לאחר מכן עברו אל Settings → Actions → General והפעילו את Workflow permissions כדי שה־workflow יוכל ליצור pull requests. |
| GitLab CI/CD | עברו אל Settings → CI/CD → Variables והוסיפו את PTC_API_TOKEN. |
| Bitbucket Pipelines | עברו אל Repository settings → Pipelines → Repository variables והוסיפו את PTC_API_TOKEN. |
5העתיקו את תצורת ה־CI/CD המוכנה מראש.
ב־GitHub Actions, הוסיפו את ה־PTC Translate action ל־workflow שלכם. טוקן ה־API שלכם הוא הקלט היחיד שעליכם להעביר. ה־action נושא בתוכו גרסה קבועה של ה־CLI, כך שה־build שלכם לעולם לא מוריד סקריפט בזמן ריצה, והוא פותח את ה־pull request של התרגום עבורכם.
ב־GitLab CI, ב־Bitbucket Pipelines, או בכל פלטפורמה אחרת, העתיקו את המשימה (job) הרלוונטית לפלטפורמה שלכם מתוך תבניות ה־CI/CD של ה־PTC CLI. כל תבנית מקבעת את ה־CLI לגרסה ספציפית ומפרסמת את ה־checksum לאימות מולו, כך שגרסת CLI מאוחרת יותר לא יכולה לשנות את מה שה־build שלכם מריץ.
6הריצו את ה־workflow.
תוכלו להפעיל את ה־workflow באופן ידני, ב־commits שמעדכנים קובצי משאבים, או על בסיס לוח זמנים. ראו טריגרים עבור GitHub, GitLab ו־Bitbucket.
כאשר הוא רץ, ה־CLI מעלה את הקבצים שלכם, ממתין לסיום התרגומים, וכותב את התרגומים המעודכנים בחזרה למאגר שלכם. אם אתם משתמשים בתצורות המוכנות מראש, ה־workflow גם יפתח create a merge request עם השינויים, כך שתוכלו לסקור ולמזג אותם כמו כל עדכון קוד אחר. מכאן ואילך, התרגומים שלכם נשארים מסונכרנים באופן אוטומטי.
דוגמאות ל־CI/CD
קריאה נוספת
- קלטים (inputs) של PTC Translate action
- תבניות CI/CD עבור GitHub ו־GitLab
- קובץ תצורה
- תהליך העיבוד
- פתרון בעיות
למה להשתמש ב־PTC עבור תרגומי תוכנה?
PTC היא מערכת תרגום שלמה למפתחים ולצוותי מוצר — שנבנתה כדי לשמור על סנכרון בין הקוד, המותג והקהל שלכם.
תרגומים מבוססי הקשר שמגנים על המותג שלכם
לפני התרגום, PTC לומדת על המוצר, הקהל והטרמינולוגיה שלכם. זו הסיבה ש־99.5% מהמשפטים עולים לאוויר ללא עריכות, ו־85% מהפרויקטים לא נערכים כלל.
כיצד התרגומים מבוססי הבינה המלאכותית של PTC מגנים על המותג שלכם →
תמיכה רחבה בפלטפורמות ובפורמטים של קבצים
PTC עובדת עם הפורמטים הפופולריים ביותר של קובצי משאבים ופלטפורמות, כולל: Android, iOS, React, Vue.js, Angular, Ruby on Rails, JavaScript, Adobe Commerce (Magento), Shopify ו־WordPress.
מידע נוסף על הפורמטים הנתמכים →
תרגמו יותר מסתם קובצי משאבים
צריכים לתרגם הערות גרסה, הודעות דוא"ל או תיעוד? PTC כוללת גם תכונת “Paste to translate” מהירה שמעניקה לכם את אותם תרגומים מבוססי הקשר עבור טקסט שנמצא מחוץ לקוד.
כיצד לתרגם טקסט מחוץ לקובצי משאבים →
הפכו את התרגומים לאוטומטיים ב־CI/CD שלכם
הגדירו את PTC פעם אחת, וקובצי המשאבים והתרגומים שלכם יישארו מעודכנים באופן אוטומטי בצינור ה־CI/CD שלכם.