co-op-translator

Co-op Translator

سهّل عملية أتمتة وصيانة الترجمات لمحتوى GitHub التعليمي الخاص بك عبر عدة لغات مع تطور مشروعك.

🌐 دعم متعدد اللغات

مدعوم بواسطة 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 ترجمة للغات مما يزيد بشكل كبير من حجم التنزيل. لاستنساخ المستودع بدون الترجمات، استخدم 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
# ماك أو إس/لينكس
source .venv/bin/activate
# تثبيت الحزمة
pip install co-op-translator
# ترجم
translate -l "ko ja fr" -md

دوكر:

# سحب الصورة العامة من 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 التعليمية “للمبتدئين”.

• تحديث قائمة “الدورات الأخرى” (لمستودعات MS Beginners فقط)

ادعمنا وعزز التعليم العالمي

انضم إلينا في ثورة كيفية مشاركة المحتوى التعليمي عالميًا! امنح 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

عروض الفيديو

👉 انقر على الصورة أدناه للمشاهدة على يوتيوب.

• Open at Microsoft: مقدمة سريعة مدتها 18 دقيقة ودليل سريع عن كيفية استخدام Co-op Translator.

  

المساهمة

يرحب هذا المشروع بالمساهمات والاقتراحات. هل ترغب في المساهمة في Azure Co-op Translator؟ يرجى مراجعة CONTRIBUTING.md لدينا للحصول على إرشادات حول كيفية المساعدة في جعل Co-op Translator أكثر سهولة في الوصول.

المساهمون

قواعد السلوك

لقد تبنى هذا المشروع قواعد السلوك مفتوحة المصدر من مايكروسوفت. لمزيد من المعلومات، راجع الأسئلة الشائعة حول قواعد السلوك أو تواصل مع opencode@microsoft.com لأي أسئلة أو تعليقات إضافية.

الذكاء الاصطناعي المسؤول

تلتزم مايكروسوفت بمساعدة عملائنا على استخدام منتجات الذكاء الاصطناعي لدينا بمسؤولية، ومشاركة ما تعلمناه، وبناء شراكات قائمة على الثقة من خلال أدوات مثل ملاحظات الشفافية وتقييمات الأثر. يمكن العثور على العديد من هذه الموارد على https://aka.ms/RAI. تستند مقاربة مايكروسوفت للذكاء الاصطناعي المسؤول إلى مبادئ الذكاء الاصطناعي لدينا المتعلقة بالإنصاف، والموثوقية والسلامة، والخصوصية والأمان، والشمولية، والشفافية، والمساءلة.

يمكن أن تتصرف نماذج اللغة الطبيعية والصورة والصوت واسعة النطاق - مثل تلك المستخدمة في هذا المثال - بطرق غير عادلة أو غير موثوقة أو مسيئة، مما قد يسبب أضرارًا. يرجى الرجوع إلى مذكرة الشفافية لخدمة Azure OpenAI لتكون على علم بالمخاطر والقيود.

النهج الموصى به لتخفيف هذه المخاطر هو تضمين نظام أمان في بنيتك يمكنه اكتشاف ومنع السلوك الضار. يوفر Azure AI Content Safety طبقة حماية مستقلة، قادرة على اكتشاف المحتوى الضار الذي يولده المستخدم أو الذكاء الاصطناعي في التطبيقات والخدمات. تتضمن خدمة Azure AI Content Safety واجهات برمجة تطبيقات للنص والصورة تسمح لك بالكشف عن المواد الضارة. كما لدينا استوديو تفاعلي لـ Content Safety يسمح لك بعرض واستكشاف وتجربة رمز برمجي نموذجي لاكتشاف المحتوى الضار عبر أوضاع مختلفة. يوجهك وثائق البدء السريع التالية للقيام بالطلبات إلى الخدمة.

هناك جانب آخر يجب أخذه في الاعتبار وهو أداء التطبيق العام. مع التطبيقات متعددة الأوضاع والنماذج، نعتبر الأداء يعني أن النظام يعمل كما تتوقع أنت والمستخدمون، بما في ذلك عدم إنتاج مخرجات ضارة. من المهم تقييم أداء تطبيقك العام باستخدام مقاييس جودة التوليد والمخاطر والسلامة.

يمكنك تقييم تطبيق الذكاء الاصطناعي الخاص بك في بيئة التطوير الخاصة بك باستخدام prompt flow SDK. سواء كان لديك مجموعة بيانات اختبار أو هدف معين، يتم قياس توليدات تطبيق الذكاء الاصطناعي التوليدي الخاص بك كميًا باستخدام مقيمين مدمجين أو مقيمين مخصصين تختارهم. للبدء باستخدام prompt flow sdk لتقييم نظامك، يمكنك اتباع دليل البدء السريع. بمجرد تنفيذ تشغيل التقييم، يمكنك عرض النتائج في Azure AI Studio.

العلامات التجارية

قد يحتوي هذا المشروع على علامات تجارية أو شعارات لمشاريع أو منتجات أو خدمات. يخضع الاستخدام المصرح به لعلامات مايكروسوفت التجارية أو شعاراتها إلى ويجب أن يتبع إرشادات العلامات التجارية والعلامات التجارية لمايكروسوفت. لا يجب أن يسبب استخدام علامات مايكروسوفت التجارية أو شعاراتها في نسخ معدلة من هذا المشروع لبسًا أو يوحي برعاية مايكروسوفت. أي استخدام لعلامات تجارية أو شعارات لأطراف ثالثة يخضع لسياسات تلك الجهات.

الحصول على المساعدة

إذا واجهتك مشكلة أو كان لديك أي أسئلة حول بناء تطبيقات الذكاء الاصطناعي، انضم إلى:

إذا كان لديك ملاحظات على المنتج أو أخطاء أثناء البناء قم بزيارة:

---

تنويه:
تمت ترجمة هذا المستند باستخدام خدمة الترجمة الآلية Co-op Translator. بينما نسعى جاهدين لتحقيق الدقة، يُرجى العلم أن الترجمات الآلية قد تحتوي على أخطاء أو عدم دقة. يجب اعتبار المستند الأصلي بلغته الأصلية المصدر الموثوق به. للمعلومات الحساسة، يُنصح بالاستعانة بالترجمة البشرية المحترفة. نحن غير مسؤولين عن أي سوء فهم أو تفسير خاطئ ناتج عن استخدام هذه الترجمة.

This site is open source. Improve this page.