co-op-translator

Co-op Translator

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

Python 3.10–3.12 Python package License: MIT Downloads Downloads Container: GHCR Code style: black

GitHub contributors GitHub issues GitHub pull-requests PRs Welcome

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

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

Arabic | Bengali | Bulgarian | Burmese (Myanmar) | Chinese (Simplified) | Chinese (Traditional, Hong Kong) | Chinese (Traditional, Macau) | Chinese (Traditional, Taiwan) | Croatian | Czech | Danish | Dutch | Estonian | Finnish | French | German | Greek | Hebrew | Hindi | Hungarian | Indonesian | Italian | Japanese | Kannada | Khmer | Korean | Lithuanian | Malay | Malayalam | Marathi | Nepali | Nigerian Pidgin | Norwegian | Persian (Farsi) | Polish | Portuguese (Brazil) | Portuguese (Portugal) | Punjabi (Gurmukhi) | Romanian | Russian | Serbian (Cyrillic) | Slovak | Slovenian | Spanish | Swahili | Swedish | Tagalog (Filipino) | Tamil | Telugu | Thai | Turkish | Ukrainian | Urdu | Vietnamese

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

מאגר זה כולל למעלה מ-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"

זה נותן לכם את כל מה שצריך כדי להשלים את הקורס עם הורדה מהירה משמעותית.

GitHub watchers GitHub forks GitHub stars

Microsoft Foundry Discord

Open in GitHub Codespaces

סקירה כללית

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

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

Example

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

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

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

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

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

כיצד ניהול מצב התרגום מתבצע

התחלה מהירה

# צור והפעל סביבה וירטואלית (מומלץ)
python -m venv .venv
# חלונות
.venv\Scripts\activate
# מק או לינוקס
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. וודא שיש לך גרסת Python נתמכת (כרגע 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

עוד דגלים: הפנייה לפקודות

תכונות

תיעוד

מדריך ספציפי למיקרוסופט

[!NOTE] מיועד למתחזקים של מאגרי Microsoft “למתחילים” בלבד.

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

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

חקרו תוכן חינוכי של מיקרוסופט בשפה שלכם

מצגות וידאו

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

תרומה

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

תורמים

co-op-translator contributors

קוד ההתנהגות

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

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

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

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

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

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

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

סימני מסחר

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

קבלת עזרה

אם נתקלת בקשיים או יש לך שאלות בנוגע לבניית אפליקציות בינה מלאכותית, הצטרף/י ל:

Microsoft Foundry Discord

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

Microsoft Foundry Developer Forum


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