README.md

Co-op Translator

אוטומציה ותחזוקה קלה של תרגומים לתוכן החינוכי שלך ב-GitHub במספר שפות ככל שהפרויקט שלך מתפתח.

🌐 תמיכה בריבוי שפות

נתמך על ידי Co-op Translator

ערבית | בנגלית | בולגרית | בורמזית (מיאנמר) | סינית (מפושטת) | סינית (מסורתית, הונג קונג) | סינית (מסורתית, מקאו) | סינית (מסורתית, טאיוואן) | קרואטית | צ'כית | דנית | הולנדית | אסטונית | פינית | צרפתית | גרמנית | יוונית | עברית | הינדי | הונגרית | אינדונזית | איטלקית | יפנית | קנאדה | קמרית | קוריאנית | ליטאית | מלאית | מלאיאלאם | מרטהית | נפאלית | פידג'ין ניגרי | נורווגית | פרסית (פארסי) | פולנית | פורטוגזית (ברזיל) | פורטוגזית (פורטוגל) | פונג'אבית (גורמוכי) | רומנית | רוסית | סרבית (קירילית) | סלובקית | סלובנית | ספרדית | סווהילית | שוודית | טגלוג (פיליפינית) | טמילית | טלוגו | תאית | טורקית | אוקראינית | אורדו | וייטנאמית

מעדיפים לשכפל מקומית?

מאגר זה כולל יותר מ-50 תרגומים לשפות שמגדילים משמעותית את גודל ההורדה. כדי לשכפל ללא התרגומים, השתמש ב-sparse checkout:

Bash / macOS / Linux:

git clone --filter=blob:none --sparse https://github.com/Azure/co-op-translator.git
cd co-op-translator
git sparse-checkout set --no-cone '/*' '!translations' '!translated_images'

CMD (Windows):

git clone --filter=blob:none --sparse https://github.com/Azure/co-op-translator.git
cd co-op-translator
git sparse-checkout set --no-cone "/*" "!translations" "!translated_images"

זה מספק לך את כל מה שאתה צריך כדי להשלים את הקורס בהורדה מהירה הרבה יותר.

סקירה כללית

Co-op Translator עוזר לך ללוקלזציה של התוכן החינוכי שלך ב-GitHub למספר שפות בקלות. כאשר אתה מעדכן את קבצי Markdown, תמונות או מחברות, התרגומים נשארים מסונכרנים אוטומטית, ומבטיחים שהתוכן שלך יהיה מדויק ועדכני ללומדים בכל העולם.

דוגמה לאופן שבו התוכן המתורגם מאורגן:

איך מצב התרגום מנוהל

Co-op Translator מנהל את התוכן המתורגם כ-ארטיפקטים תוכנתיים בגרסאות,
ולא כקבצים סטטיים.

הכלי עוקב אחר מצב תרגום ה-Markdown, התמונות והמחברות באמצעות מטא-דאטה בהיקף שפה.

עיצוב זה מאפשר ל-Co-op Translator:

• לזהות באופן אמין תרגומים מיושנים
• להתייחס ל-Markdown, תמונות ומחברות בצורה עקבית
• להתרחב בצורה בטוחה ברחבי מאגרים גדולים, מהירים ובריבוי שפות

על ידי מיצוב התרגומים כארטיפקטים מנוהלים, זרימות עבודה של תרגום מתיישרות באופן טבעי עם הפרקטיקות המודרניות של ניהול תלות בתוכנה וארטיפקטים.

→ איך מצב התרגום מנוהל

התחלת עבודה מהירה

# צור והפעל סביבה וירטואלית (מומלץ)
python -m venv .venv
# חלונות
.venv\Scripts\activate
# macOS/לינוקס
source .venv/bin/activate
# התקן את החבילה
pip install co-op-translator
# תתרגם
translate -l "ko ja fr" -md

Docker:

# משוך את התמונה הציבורית מ-GHCR
docker pull ghcr.io/azure/co-op-translator:latest
# הרץ עם התיקייה הנוכחית מותקנת ו-.env מסופק (Bash/Zsh)
docker run --rm -it --env-file .env -v "${PWD}:/work" ghcr.io/azure/co-op-translator:latest -l "ko ja fr" -md

הגדרה מינימלית

1. ודא שברשותך גרסת פייתון נתמכת (כרגע 3.10-3.12). ב-poetry (pyproject.toml) זה מטופל אוטומטית.
2. צור קובץ .env באמצעות התבנית: .env.template
3. הגדר ספק LLM אחד (Azure OpenAI או OpenAI)
4. (אופציונלי) לתרגום תמונות (-img), הגדר Azure AI Vision
5. (אופציונלי) ניתן להגדיר מערכות קרדנציאל מרובות על ידי שכפול משתנים עם סיומות כמו _1, _2 וכו'. כל המשתנים בקבוצה חייבים לשתף את אותה הסיומת.
6. (מומלץ) נקו את כל התרגומים הקודמים כדי למנוע התנגשויות (למשל, translations/)
7. (מומלץ) הוסף קטע תרגום ל-README שלך באמצעות תבנית שפות README
8. עיין ב: הגדרת Azure AI

שימוש

תרגם את כל הסוגים הנתמכים:

translate -l "ko ja"

רק Markdown:

translate -l "de" -md

Markdown + תמונות:

translate -l "pt" -md -img

רק מחברות:

translate -l "zh" -nb

דגלים נוספים: מדריך פקודות

תכונות

• תרגום אוטומטי ל-Markdown, מחברות ותמונות
• שומר על סנכרון בין התרגומים לשינויים במקור
• פועל מקומית (CLI) או ב-CI (GitHub Actions)
• משתמש ב-Azure OpenAI או OpenAI; אופציונלי Azure AI Vision לתמונות
• שומר על פורמט ומבנה Markdown

תיעוד

• מדריך שורת פקודה
• מדריך GitHub Actions (מאגרי קוד ציבוריים וסודות סטנדרטיים)
• מדריך GitHub Actions (מאגרים בארגון Microsoft והגדרות ארגוניות)
• תבנית שפות README
• שפות נתמכות
• תרומה לקוד
• פתרון בעיות

מדריך ייחודי ל-Microsoft

Note

עבור משמרי מאגרי ה-"למתחילים" של Microsoft בלבד.

• עדכון רשימת "קורסים אחרים" (עבור מאגרי מתחילים בלבד)

תמכו בנו וקידמו למידה גלובלית

הצטרפו אלינו במהפכה בתחום שיתוף התוכן החינוכי ברחבי העולם! תנו ל-Co-op Translator ⭐ ב-GitHub ותמכו במשימתנו לשבור מחסומי שפה בלמידה וטכנולוגיה. ההתעניינות והתרומות שלכם יוצרות השפעה משמעותית! תרומות בקוד והצעות לפיצ'רים תמיד מתקבלות בברכה.

חקרו תוכן חינוכי של Microsoft בשפה שלכם

• LangChain4j-for-Beginners
• AZD for Beginners
• Edge AI for Beginners
• Model Context Protocol (MCP) For Beginners
• AI Agents for Beginners
• Generative AI for Beginners using .NET
• Generative AI for Beginners
• Generative AI for Beginners using Java
• ML for Beginners
• Data Science for Beginners
• AI for Beginners
• Cybersecurity for Beginners
• Web Dev for Beginners
• IoT for Beginners
• PhiCookBook

מצגות וידאו

👉 לחץ על התמונה למטה לצפייה ב-YouTube.

• Open at Microsoft: הקדמה קצרה של 18 דקות ומדריך מהיר לשימוש ב-Co-op Translator.

  

תרומה

פרויקט זה מקבל בברכה תרומות והצעות. מעוניין לתרום ל-Azure Co-op Translator? נא עיין ב-CONTRIBUTING.md שלנו לקבלת הנחיות כיצד תוכל לעזור להפוך את Co-op Translator לנגיש יותר.

תורמים

קוד התנהגות

פרויקט זה אימץ את קוד ההתנהגות בקוד הפתוח של מיקרוסופט. למידע נוסף ראו את שאלות נפוצות על קוד ההתנהגות או צרו קשר בכתובת opencode@microsoft.com עם כל שאלה או הערה נוספת.

בינה מלאכותית אחראית

מיקרוסופט מחויבת לעזור ללקוחותיה להשתמש במוצרי ה-AI שלנו באחריות, לשתף את הלימודים שלנו ולבנות שותפויות מבוססות אמון דרך כלים כמו הערות שקיפות והערכות השפעה. משאבים רבים אלו נמצאים בכתובת https://aka.ms/RAI. הגישה של מיקרוסופט לבינה מלאכותית אחראית נשענת על עקרונות ה-AI שלנו: הוגנות, אמינות ובטיחות, פרטיות ואבטחה, הכללה, שקיפות ואחריות.

מודלי שפה, תמונה ודיבור בקנה מידה גדול - כמו אלו המשמשים בדוגמה זו - עלולים לפעול בדרכים שאינן הוגנות, אמינות או עלולות להיות פוגעניות, ולגרום נזקים. אנא בדקו את הערת השקיפות של שירות Azure OpenAI כדי להיות מודעים לסיכונים ולמגבלות.

הגישה המומלצת למתן מענה לסיכונים אלה היא לכלול מערכת בטיחות בארכיטקטורה שלכם שיכולה לזהות ולמנוע התנהגות מזיקה. Azure AI Content Safety מספק שכבת הגנה עצמאית, המסוגלת לזהות תוכן מזיק שנוצר על ידי משתמשים או על ידי AI באפליקציות ובשירותים. Azure AI Content Safety כוללת APIs לטקסט ותמונה שמאפשרים לזהות חומר מזיק. יש לנו גם סטודיו אינטראקטיבי לבטיחות תוכן שמאפשר לצפות, לחקור ולנסות קוד לדוגמה לזיהוי תוכן מזיק במודאליות שונות. תיעוד מהיר להתחלה הבא מדריך אתכם כיצד לבצע בקשות לשירות.

היבט נוסף שיש לקחת בחשבון הוא ביצועי האפליקציה הכוללים. עם אפליקציות רב-מודאליות ורב-מודליות, אנו מחשיבים ביצועים כעובדה שהמערכת מתפקדת כפי שאתם והמשתמשים שלכם מצפים, כולל אי יצירת פלטים מזיקים. חשוב להעריך את ביצועי האפליקציה הכוללים שלכם באמצעות מדדי איכות יצירה, סיכון ובטיחות.

ניתן להעריך את אפליקציית ה-AI שלכם בסביבת הפיתוח באמצעות prompt flow SDK. נתון מערך בדיקה או יעד, יצירות האפליקציה הגנרטיבית שלכם נמדדות כמותית עם מעריכים מובנים או מעריכים מותאמים אישית לבחירתכם. כדי להתחיל עם ה-prompt flow sdk להערכת המערכת, ניתן לעקוב אחרי מדריך התחלה מהירה. לאחר ביצוע ריצה להערכה, ניתן להציג את התוצאות ב-Azure AI Studio.

סימני מסחר

פרויקט זה עלול לכלול סימני מסחר או לוגואים של פרויקטים, מוצרים או שירותים. השימוש המורשה בסימני המסחר או הלוגואים של מיקרוסופט כפוף ל- הנחיות לסימני המסחר ומותג של מיקרוסופט. שימוש בסימני המסחר או לוגואים של מיקרוסופט בגרסאות מותאמות של פרויקט זה אסור לגרום לבלבול או לרמוז לספונסרשיפ של מיקרוסופט. שימוש בכל סימני מסחר או לוגואים של צד שלישי כפוף למדיניות של אותו צד שלישי.

קבלת עזרה

אם אתם נתקעים או יש לכם שאלות על בניית אפליקציות AI, הצטרפו ל:

אם יש לכם משוב על המוצר או שגיאות במהלך הבנייה בקרו ב:

---

כתב ויתור:
מסמך זה תורגם באמצעות שירות תרגום בינה מלאכותית Co-op Translator. למרות שאנו שואפים לדייק, יש לקחת בחשבון שתרגומים אוטומטיים עלולים להכיל שגיאות או אי דיוקים. המסמך המקורי בשפת המקור שלו נחשב למקור הסמכותי. למידע קריטי, מומלץ להיעזר בתרגום מקצועי על ידי בני אדם. אנו לא נושאים באחריות לכל אי הבנות או פרשנויות שגויות הנובעות משימוש בתרגום זה.