שלבו לוקליזציה בצינור ה־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. במהלך ההגדרה, תספקו מעט הקשר על הפרויקט שלכם (מה הוא עושה, למי הוא מיועד) ותבחרו את השפות שאליהן תרצו לתרגם.
3קבלו את טוקן ה־API שלכם.
בסיום ההגדרה, תקבלו טוקן API ייעודי לפרויקט. העתיקו אותו ושמרו אותו במקום בטוח — תזדקקו לו כדי לאמת את כל הבקשות. תמיד תוכלו למצוא את אותו הטוקן שוב בלוח הבקרה של הפרויקט תחת הגדרות → אסימוני API של PTC.
4הוסיפו את טוקן ה־API של PTC למאגר שלכם במיקום הנכון.
| ספק | היכן להוסיף את הטוקן |
|---|---|
| GitHub Actions | עברו אל Settings → Secrets and variables → Actions והוסיפו את PTC_API_TOKEN. לאחר מכן עברו אל Settings → Actions → General → Workflow permissions והפעילו את Allow GitHub Actions to create and approve pull requests. קובץ ה־workflow כבר מבקש את הרשאות הכתיבה שהוא זקוק להן; תיבת סימון זו היא הדבר היחיד שהוא אינו יכול להעניק לעצמו. |
| 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 או בכל פלטפורמה אחרת, העתיקו את המשימה עבור הפלטפורמה שלכם מתוך תבניות ה־CI/CD של PTC CLI. כל תבנית נועלת את ה־CLI לגרסה מסוימת ומפרסמת את ה־checksum כדי לאמת אותו מולו, כך שגרסת CLI מאוחרת יותר לא תוכל לשנות את מה שה־build שלכם מריץ.
6הריצו את ה־workflow.
תוכלו להפעיל את ה־workflow באופן ידני, ב־commits שמעדכנים קובצי משאבים, או לפי לוח זמנים. ראו טריגרים עבור GitHub, GitLab ו־Bitbucket. כל pull request זקוקה לענף כדי להיפתח מולו, לכן ב־GitHub Actions ה־PTC Translate action פותח אחת ב־push, לפי לוח זמנים, ובריצה ידנית מתוך ענף. באירוע pull_request, pull_request_target או merge_group, או ב־tag או ב־release, הוא עוצר עם הסבר במקום זאת - תרגמו ב־push לענף המקור שלכם, או הגדירו create-pr: false עבור אותה הרצה.
כשהוא רץ, ה־CLI מעלה את הקבצים שלכם, ממתין לסיום התרגומים, וכותב את התרגומים המעודכנים בחזרה למאגר שלכם. אם אתם משתמשים בתצורות המוכנות מראש וההרצה הפיקה תרגומים חדשים, ה־workflow גם create a merge request עם השינויים, כך שתוכלו לסקור ולמזג אותם כמו כל עדכון קוד אחר. הרצה שלא מוצאת שום דבר לתרגם לא כותבת כלום ולא פותחת 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 שלכם.