שילוב לוקליזציה בצינור ה־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 רץ על 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 המוכנות עבור הפלטפורמה שלכם מה־PTC CLI wiki. התבניות הללו כבר כוללות את השלבים להורדה והרצה של ה־CLI.
6הריצו את ה־workflow.
תוכלו להפעיל את ה־workflow ידנית, בעת commit שמעדכן קובצי משאבים, או לפי לוח זמנים. ראו טריגרים עבור GitHub, GitLab, ו־Bitbucket.
כשהוא רץ, ה־CLI מעלה את הקבצים שלכם, מחכה לסיום התרגומים, וכותב את התרגומים המעודכנים בחזרה למאגר שלכם. אם אתם משתמשים בהגדרות המוכנות מראש, ה־workflow גם ייצור pull request או merge request עם השינויים, כך שתוכלו לסקור ולמזג אותם כמו כל עדכון קוד אחר. מכאן ואילך, התרגומים שלכם יישארו מסונכרנים באופן אוטומטי.
דוגמאות ל־CI/CD
קריאה נוספת
- קובץ הגדרות (Configuration File)
- זרימת עבודת העיבוד (Processing Workflow)
- פתרון בעיות (Troubleshooting)
למה להשתמש ב־PTC לתרגום תוכנה?
PTC היא מערכת תרגום מלאה למפתחים ולצוותי מוצר — שנבנתה כדי לשמור על סנכרון בין הקוד, המותג והקהל שלכם.
תרגומים תלויי־הקשר השומרים על טון המותג שלכם
לפני התרגום, PTC לומדת על המוצר שלכם, על הקהל שלכם ועל הטרמינולוגיה שלכם. זו הסיבה ש־99.5% מהמשפטים עולים לאוויר ללא עריכה, ו־85% מהפרויקטים אינם נערכים כלל.
איך תרגומים בבינה מלאכותית של PTC שומרים על המותג שלכם ←
תמיכה רחבה בפלטפורמות ובפורמטים של קבצים
PTC עובדת עם הפורמטים הפופולריים ביותר של קובצי משאבים ופלטפורמות, כולל: Android, iOS, React, Vue.js, Angular, Ruby on Rails, JavaScript, Adobe Commerce (Magento), Shopify, ו־WordPress.
עוד על פורמטים נתמכים של קבצים ←
תרגמו יותר מאשר רק קובצי משאבים
צריכים לתרגם הערות גרסה, אימיילים או תיעוד? PTC כוללת גם פיצ'ר מהיר של "הדבקה לתרגום" המעניק לכם את אותם תרגומים תלויי־הקשר עבור טקסט שאינו חלק מהקוד.
איך לתרגם טקסט שאינו בתוך קובצי משאבים ←
אוטומציה של תרגומים ב־CI/CD שלכם
הגדירו את PTC פעם אחת, וקובצי המשאבים והתרגומים שלכם יישארו מעודכנים אוטומטית בצינור ה־CI/CD שלכם.