שלבו לוקליזציה בצינור ה־CI/CD שלכם באמצעות ה־API של PTC
למדו איך לשלב את ה־API של PTC בצינור ה־CI/CD שלכם כדי לספק תרגומים בבינה מלאכותית באיכות אנושית כחלק מתהליך ה-Build.
אבטחה כערך עליון — אין צורך בהרשאות קריאה או כתיבה למאגר (Repository).- תאימות לכל מערכת CI/CD, כולל הגדרות מוכנות מראש.
- גישה מבוקרת באמצעות טוקני API ספציפיים לפרויקט.
- תרגומים באיכות אנושית המועברים תוך דקות, ישירות בתוך ה-Build שלכם.
איך עובד שילוב ה־CI/CD
לפני שתגדירו את PTC במערכת ה־CI שלכם, הנה שלושת העקרונות שעומדים מאחורי ה־API וה־CLI של PTC:
1. קובצי משאבים קשורים לענף (Branch)
כל קובץ שאתם שולחים ל־PTC מקושר לשם של ענף (למשל main או feature/new-checkout). זה שומר על הפרדה בין התרגומים, כך שעבודה על פיצ'רים שונים לא דורסת זו את זו.
כשמשתמשים בהגדרות ה־CI/CD המוכנות מראש, המיפוי הזה כבר מטופל באופן אוטומטי.
2. התרגומים מעובדים בצורה אסינכרונית
PTC לא מחזירה תרגומים באופן מיידי. במקום זאת, המערכת:
- מעלה את הקבצים המעודכנים
- מזהה רק את המחרוזות החדשות או אלו ששונו
- מתרגמת את המחרוזות
- מכינה את הקבצים המתורגמים להורדה
3. סקריפט CLI אחד שעובד בכל מקום
במקום לקרוא ל־API בעצמכם, השתמשו ב־PTC CLI:
סקריפט אחד מטפל בכל התהליך (העלאה ← בדיקת סטטוס ← הורדה). ה־CLI מתארח ב־GitHub אבל עובד על Linux, macOS, GitHub Actions, GitLab, Bitbucket או כל פלטפורמת CI/CD אחרת.
זרימת עבודה כללית: הגדרת ה־API של PTC בצינור ה־CI/CD שלכם
1הירשמו לתקופת ניסיון חינם.
קבלו גישה מלאה לכל הפיצ'רים ותרגמו עד 20,000 מילים לכל שתי שפות שתבחרו.
2צרו פרויקט חדש.
כשאתם בוחרים איך להשתמש ב־PTC, בחרו ב־API integration. במהלך ההגדרה, תתבקשו לספק מעט הקשר על הפרויקט שלכם (מה הוא עושה, למי הוא מיועד) ותבחרו את השפות שאליהן תרצו לתרגם.
3קבלו את טוקן ה־API שלכם.
בסיום ההגדרה, תקבלו טוקן API ספציפי לפרויקט. העתיקו אותו ושמרו אותו במקום בטוח — תזדקקו לו כדי לאמת את כל הבקשות. תמיד תוכלו למצוא את אותו טוקן שוב בלוח הבקרה של הפרויקט תחת Settings ← PTC API tokens.
4הוסיפו את טוקן ה־API של PTC למאגר שלכם במיקום הנכון.
| ספק | איפה להוסיף את הטוקן |
|---|---|
| GitHub Actions | עברו אל Settings ← Secrets and variables ← Actions והוסיפו את PTC_API_TOKEN. לאחר מכן עברו אל Settings ← Actions ← General ואפשרו את Workflow permissions כדי שזרימת העבודה תוכל ליצור 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 המוכנה מראש.
תוכלו לקבל את הגדרת ה־CI/CD המוכנה עבור הפלטפורמה שלכם מה־Wiki של PTC CLI. התבניות הללו כבר כוללות את השלבים להורדה והרצה של ה־CLI.
6הריצו את זרימת העבודה (Workflow).
תוכלו להפעיל את זרימת העבודה באופן ידני, בביצוע commits שמעדכנים קובצי משאבים, או לפי לוח זמנים. ראו טריגרים עבור GitHub, GitLab, ו־Bitbucket.
בזמן ההרצה, ה־CLI מעלה את הקבצים שלכם, מחכה לסיום התרגומים, וכותב את התרגומים המעודכנים בחזרה לתוך המאגר שלכם. אם אתם משתמשים בהגדרות המוכנות מראש, זרימת העבודה גם תיצור pull/merge request עם השינויים, כך שתוכלו לסקור ולמזג אותם כמו כל עדכון קוד אחר. מכאן ואילך, התרגומים שלכם יישארו מסונכרנים באופן אוטומטי.
דוגמאות ל־CI/CD
WordPress
Ruby on Rails
קובצי JSON (אפליקציות React)קריאה נוספת
למה להשתמש ב־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 שלכם.