co-op-translator
Co-op Translator: לתרגם בקלות תיעוד חינוכי באופן אוטומטי
אוטומציה פשוטה של תרגום התיעוד שלך למספר שפות כדי להגיע לקהל עולמי.
תמיכה בשפות מופעלת על ידי Co-op Translator
[!NOTE] אלה התרגומים הנוכחיים של תוכן המאגר הזה. לרשימה מלאה של השפות הנתמכות על ידי Co-op Translator, ראה את הסעיף Language Support.
סקירה כללית: הפשט את תהליך תרגום התוכן החינוכי שלך
מחסומי שפה מקשים משמעותית על הגישה למשאבים חינוכיים חשובים ולידע טכני עבור לומדים ומפתחים ברחבי העולם. זה מגביל את ההשתתפות ומאט את קצב החדשנות והלמידה הגלובלית.
Co-op Translator נולד מתוך הצורך לטפל בתהליך התרגום הידני הבלתי יעיל לסדרות החינוך הרחבות של מיקרוסופט (כמו מדריכי “למתחילים”). הוא התפתח לכלי חזק ונוח לשימוש שנועד לפרוץ את המחסומים האלה עבור כולם. באמצעות תרגומים אוטומטיים איכותיים דרך CLI ו-GitHub Actions, Co-op Translator מאפשר למורים, תלמידים, חוקרים ומפתחים ברחבי העולם לשתף ולקבל ידע ללא מגבלות שפה.
ראה כיצד Co-op Translator מארגן תוכן חינוכי מתורגם:
קבצי Markdown וטקסט בתמונות מתורגמים אוטומטית ומאורגנים באופן מסודר בתיקיות לפי שפה.
פתח גישה גלובלית לתוכן החינוכי שלך עם Co-op Translator כבר היום!
תמיכה בגישה גלובלית למשאבי הלמידה של מיקרוסופט
Co-op Translator עוזר לגשר על פער השפה ביוזמות החינוך המרכזיות של מיקרוסופט, ומאוטומט את תהליך התרגום עבור מאגרים שמשרתים קהילת מפתחים גלובלית. דוגמאות שמשתמשות כיום ב-Co-op Translator כוללות:
תכונות מרכזיות
- תרגומים אוטומטיים: תרגום טקסט למספר שפות בקלות.
- אינטגרציה עם GitHub Actions: אוטומציה של תרגומים כחלק מצינור ה-CI/CD שלך.
- שימור Markdown: שמירה על תחביר Markdown תקין במהלך התרגום.
- תרגום טקסט בתמונות: חילוץ ותרגום טקסט מתוך תמונות.
- טכנולוגיית LLM מתקדמת: שימוש במודלי שפה חדישים לתרגומים איכותיים.
- אינטגרציה פשוטה: שילוב חלק עם תצורת הפרויקט הקיימת שלך.
- פישוט לוקליזציה: הפשטת תהליך הלוקליזציה של הפרויקט לשווקים בינלאומיים.
איך זה עובד
Co-op Translator לוקח קבצי Markdown ותמונות מתיקיית הפרויקט שלך ומעבד אותם כך:
- חילוץ טקסט: מחלץ טקסט מקבצי Markdown ואם מוגדר (למשל עם Azure AI Vision), גם מטקסט המוטמע בתוך תמונות.
- תרגום בינה מלאכותית: שולח את הטקסט שחולץ למודל השפה המוגדר (Azure OpenAI, OpenAI וכו’) לתרגום.
- שמירת תוצאות: שומר את קבצי Markdown המתורגמים והתמונות (עם הטקסט המתורגם) בתיקיות לפי שפה, תוך שמירה על הפורמט המקורי.
התחלה מהירה
התחל במהירות עם CLI או הגדר אוטומציה מלאה עם GitHub Actions. בחר את הגישה שהכי מתאימה לך:
- שורת פקודה (CLI) - לתרגומים חד-פעמיים או שליטה ידנית
- GitHub Actions - לתרגומים אוטומטיים בכל דחיפה
[!NOTE] מדריך זה מתמקד במשאבי Azure, אך ניתן להשתמש בכל מודל שפה נתמך.
תמיכת שפות
Co-op Translator תומך במגוון רחב של שפות כדי לעזור לך להגיע לקהל גלובלי. הנה מה שחשוב לדעת:
התייחסות מהירה
| שפה | קוד | שפה | קוד | שפה | קוד |
|---|---|---|---|---|---|
| Arabic | ar | Bengali | bn | Bulgarian | bg |
| Burmese (Myanmar) | my | Chinese (Simplified) | zh | Chinese (Traditional, HK) | hk |
| Chinese (Traditional, Macau) | mo | Chinese (Traditional, TW) | tw | Croatian | hr |
| Czech | cs | Danish | da | Dutch | nl |
| Finnish | fi | French | fr | German | de |
| Greek | el | Hebrew | he | Hindi | hi |
| Hungarian | hu | Indonesian | id | Italian | it |
| Japanese | ja | Korean | ko | Malay | ms |
| Marathi | mr | Nepali | ne | Norwegian | no |
| Persian (Farsi) | fa | Polish | pl | Portuguese (Brazil) | br |
| Portuguese (Portugal) | pt | Punjabi (Gurmukhi) | pa | Romanian | ro |
| Russian | ru | Serbian (Cyrillic) | sr | Slovak | sk |
| Slovenian | sl | Spanish | es | Swahili | sw |
| Swedish | sv | Tagalog (Filipino) | tl | Thai | th |
| Turkish | tr | Ukrainian | uk | Urdu | ur |
| Vietnamese | vi | — | — | — | — |
שימוש בקודי שפה
כשמשתמשים ב-Co-op Translator, יש לציין את השפות באמצעות הקודים שלהן. לדוגמה:
# Translate to French, Spanish, and German
translate -l "fr es de"
# Translate to Chinese (Simplified) and Japanese
translate -l "zh ja"
[!NOTE] למידע טכני מפורט על תמיכת שפות, כולל:
- מפרטי פונטים לכל שפה
- בעיות ידועות
- איך להוסיף שפות חדשות
דגמים ושירותים נתמכים
| סוג | שם |
|---|---|
| מודל שפה |   |
| AI Vision |  |
[!NOTE] אם שירות AI Vision אינו זמין, Co-op Translator יעבור למצב Markdown-only mode.
הגדרה ראשונית
לפני שמתחילים, יש להגדיר את המשאבים הבאים:
- משאב מודל שפה (חובה):
- Azure OpenAI (מומלץ) - מספק תרגומים איכותיים עם אמינות ברמת ארגון
- OpenAI - אופציה חלופית אם אין לך גישה ל-Azure
- למידע מפורט על דגמים נתמכים, ראה Supported Models and Services
- משאב AI Vision (אופציונלי):
- Azure AI Vision - מאפשר תרגום טקסט בתוך תמונות
- אם לא מוגדר, התרגום יעבור אוטומטית למצב Markdown-only mode
- מומלץ לפרויקטים עם תמונות המכילות טקסט שצריך לתרגם
- שלבי קונפיגורציה:
- עקוב אחרי מדריך ההגדרה של Azure AI לקבלת הוראות מפורטות
- צור קובץ
.envעם מפתחות API וכתובות ה-endpoints (ראה את הסעיף Quick Start) - ודא שיש לך הרשאות ומכסים מתאימים לשירותים שבחרת
הכנת הפרויקט לפני תרגום
לפני התחלת תהליך התרגום, בצע את השלבים הבאים להכנת הפרויקט:
- הכנת README:
- הוסף טבלה של תרגומים ל-README.md שלך כדי לקשר לגרסאות המתורגמות
-
דוגמה לפורמט:
### 🌐 Multi-Language Support [French](/co-op-translator/translations/fr/) | [Spanish](/co-op-translator/translations/es/) | [German](/co-op-translator/translations/de/) | [Russian](/co-op-translator/translations/ru/) | [Arabic](/co-op-translator/translations/ar/) | [Persian (Farsi)](/co-op-translator/translations/fa/) | [Urdu](/co-op-translator/translations/ur/) | [Chinese (Simplified)](/co-op-translator/translations/zh/) | [Chinese (Traditional, Macau)](/co-op-translator/translations/mo/) | [Chinese (Traditional, Hong Kong)](/co-op-translator/translations/hk/) | [Chinese (Traditional, Taiwan)](/co-op-translator/translations/tw/) | [Japanese](/co-op-translator/translations/ja/) | [Korean](/co-op-translator/translations/ko/) | [Hindi](/co-op-translator/translations/hi/) | [Bengali](/co-op-translator/translations/bn/) | [Marathi](/co-op-translator/translations/mr/) | [Nepali](/co-op-translator/translations/ne/) | [Punjabi (Gurmukhi)](/co-op-translator/translations/pa/) | [Portuguese (Portugal)](/co-op-translator/translations/pt/) | [Portuguese (Brazil)](/co-op-translator/translations/br/) | [Italian](/co-op-translator/translations/it/) | [Polish](/co-op-translator/translations/pl/) | [Turkish](/co-op-translator/translations/tr/) | [Greek](/co-op-translator/translations/el/) | [Thai](/co-op-translator/translations/th/) | [Swedish](/co-op-translator/translations/sv/) | [Danish](/co-op-translator/translations/da/) | [Norwegian](/co-op-translator/translations/no/) | [Finnish](/co-op-translator/translations/fi/) | [Dutch](/co-op-translator/translations/nl/) | [Hebrew](/co-op-translator/translations/he/) | [Vietnamese](/co-op-translator/translations/vi/) | [Indonesian](/co-op-translator/translations/id/) | [Malay](/co-op-translator/translations/ms/) | [Tagalog (Filipino)](/co-op-translator/translations/tl/) | [Swahili](/co-op-translator/translations/sw/) | [Hungarian](/co-op-translator/translations/hu/) | [Czech](/co-op-translator/translations/cs/) | [Slovak](/co-op-translator/translations/sk/) | [Romanian](/co-op-translator/translations/ro/) | [Bulgarian](/co-op-translator/translations/bg/) | [Serbian (Cyrillic)](/co-op-translator/translations/sr/) | [Croatian](/co-op-translator/translations/hr/) | [Slovenian](/co-op-translator/translations/sl/) | [Ukrainian](/co-op-translator/translations/uk/) | [Burmese (Myanmar)](/co-op-translator/translations/my/)
- ניקוי תרגומים קיימים (אם נדרש):
- הסר תיקיות תרגום קיימות (כגון
translations/) - מחק קבצי תרגום ישנים כדי להתחיל מחדש
- כך תימנע התנגשויות עם תהליך התרגום החדש
- הסר תיקיות תרגום קיימות (כגון
התחלה מהירה: שורת פקודה
להתחלה מהירה עם שורת הפקודה:
-
צור סביבה וירטואלית:
python -m venv .venv -
הפעל את הסביבה הווירטואלית:
- ב-Windows:
.venv\scripts\activate- בלינוקס/macOS:
source .venv/bin/activate -
התקן את החבילה:
pip install co-op-translator -
הגדר הרשאות:
- צור קובץ
.envfile in your project’s root directory. - Copy the contents from the .env.template file into your new
.envfile. - Fill in the required API keys and endpoint information in your
.envfile.
- צור קובץ
-
Run Translation:
- Navigate to your project’s root directory in your terminal.
- Execute the translate command, specifying target languages with the
-lעם הדגל:
translate -l "ko ja fr"(החלף את
"ko ja fr"with your desired space-separated language codes)
Detailed Usage Guides
Choose the approach that best fits your workflow:
1. Using the Command Line (CLI)
- Best for: One-time translations, manual control, or integration into custom scripts.
- Requires: Local installation of Python and the
co-op-translatorpackage. - Guide: Command Line Guide
2. Using GitHub Actions (Automation)
- Best for: Automatically translating content whenever changes are pushed to your repository. Keeps translations consistently up-to-date.
- Requires: Setting up a workflow file (
.github/workflows) במאגר שלך. אין צורך בהתקנה מקומית. - מדריכים:
- GitHub Actions Guide (Public Repositories & Standard Secrets) - השתמש בזה עבור רוב המאגרי הקוד הציבוריים או האישיים המשתמשים בסודות סטנדרטיים של המאגר.
- GitHub Actions Guide (Microsoft Organization Repos & Org-Level Setups) - השתמש במדריך זה אם אתה עובד בתוך ארגון Microsoft ב-GitHub או צריך לנצל סודות או ראנרים ברמת הארגון.
פתרון תקלות וטיפים
משאבים נוספים
- מדריך פקודות: מדריך מפורט לכל הפקודות והאפשרויות הזמינות.
- שפות נתמכות: בדוק את רשימת השפות הנתמכות והוראות להוספת שפות חדשות.
- מצב Markdown בלבד: איך לתרגם רק טקסט, בלי תרגום תמונות.
מצגות וידאו
למד עוד על Co-op Translator דרך המצגות שלנו (לחץ על התמונה למטה לצפייה ביוטיוב):
- Open at Microsoft: מבוא קצר של 18 דקות ומדריך מהיר לשימוש ב-Co-op Translator.
תמכו בנו וטפחו למידה גלובלית
הצטרפו אלינו למהפכה בדרך שבה תוכן חינוכי משותף ברחבי העולם! תנו ל-Co-op Translator ⭐ ב-GitHub ותמכו במשימתנו לפרוץ מחסומי שפה בלמידה ובטכנולוגיה. העניין שלכם והתרומות שלכם עושים שינוי משמעותי! תרומות קוד והצעות לפיצ’רים תמיד מתקבלות בברכה.
תרומה לפרויקט
הפרויקט הזה מקבל בברכה תרומות והצעות. מעוניינים לתרום ל-Azure Co-op Translator? אנא עיינו ב-CONTRIBUTING.md לקבלת הנחיות כיצד תוכלו לעזור להפוך את Co-op Translator לנגיש יותר.
תורמים
קוד התנהגות
הפרויקט אימץ את Microsoft Open Source Code of Conduct. למידע נוסף ראו את ה-Code of Conduct FAQ או צרו קשר ב-opencode@microsoft.com עם שאלות או הערות נוספות.
בינה מלאכותית אחראית
מיקרוסופט מחויבת לסייע ללקוחותינו להשתמש במוצרי הבינה המלאכותית שלנו באחריות, לשתף את הלקחים שלנו ולבנות שותפויות מבוססות אמון באמצעות כלים כמו Transparency Notes ו-Impact Assessments. משאבים רבים אלה זמינים ב-https://aka.ms/RAI. הגישה של מיקרוסופט לבינה מלאכותית אחראית מבוססת על עקרונות הבינה המלאכותית שלנו: הוגנות, אמינות ובטיחות, פרטיות ואבטחה, הכללה, שקיפות ואחריות.
מודלים רחבי היקף של שפה טבעית, תמונות ודיבור – כמו אלו שבדוגמה זו – עלולים לפעול בצורה לא הוגנת, לא אמינה או פוגענית, ולגרום נזקים. אנא עיינו ב-Azure OpenAI service Transparency note כדי להתעדכן בסיכונים ובמגבלות.
הגישה המומלצת להפחתת סיכונים אלו היא לכלול במערכת שלכם מערכת בטיחות שיכולה לזהות ולמנוע התנהגות מזיקה. Azure AI Content Safety מספק שכבת הגנה עצמאית, היכולה לזהות תוכן מזיק שנוצר על ידי משתמשים או על ידי בינה מלאכותית באפליקציות ושירותים. Azure AI Content Safety כוללת APIs לטקסט ותמונות המאפשרים לזהות חומר מזיק. בנוסף, יש לנו Content Safety Studio אינטראקטיבי המאפשר לכם לצפות, לחקור ולנסות דוגמאות קוד לזיהוי תוכן מזיק במגוון מודאליות. תיעוד התחלה מהירה מדריך אתכם כיצד לבצע בקשות לשירות.
היבט נוסף שיש לקחת בחשבון הוא ביצועי האפליקציה הכוללים. באפליקציות רב-מודאליות ורב-מודליות, אנו מגדירים ביצועים כהתנהגות המערכת בהתאם לציפיות שלכם ושל המשתמשים, כולל אי יצירת תוצרים מזיקים. חשוב להעריך את ביצועי האפליקציה הכוללת באמצעות מדדי איכות יצירה וסיכון ובטיחות.
ניתן להעריך את אפליקציית הבינה המלאכותית שלכם בסביבת הפיתוח באמצעות prompt flow SDK. עם קובץ נתוני בדיקה או יעד, היצירות של אפליקציית הבינה המלאכותית שלכם נמדדות כמותית באמצעות מעריכים מובנים או מותאמים אישית לבחירתכם. כדי להתחיל עם ה-prompt flow SDK להערכת המערכת, ניתן לעקוב אחרי מדריך התחלה מהירה. לאחר הרצת הערכה, ניתן להציג את התוצאות ב-Azure AI Studio.
סימני מסחר
פרויקט זה עשוי להכיל סימני מסחר או לוגואים של פרויקטים, מוצרים או שירותים. השימוש המורשה בסימני המסחר או בלוגואים של מיקרוסופט כפוף ל-Microsoft’s Trademark & Brand Guidelines. שימוש בסימני המסחר או בלוגואים של מיקרוסופט בגרסאות מותאמות של פרויקט זה אסור שיגרום לבלבול או ייתן רושם של חסות מצד מיקרוסופט. שימוש בסימני מסחר או לוגואים של צד שלישי כפוף למדיניות אותם צדדים.
כתב ויתור:
מסמך זה תורגם באמצעות שירות תרגום מבוסס בינה מלאכותית Co-op Translator. למרות שאנו שואפים לדיוק, יש לקחת בחשבון שתרגומים אוטומטיים עלולים להכיל שגיאות או אי-דיוקים. יש להסתמך על המסמך המקורי בשפת המקור כמקור הסמכותי. למידע קריטי מומלץ להשתמש בתרגום מקצועי של אדם. אנו לא נושאים באחריות לכל אי-הבנה או פרשנות שגויה הנובעת משימוש בתרגום זה.