README.md

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 ترجمة لغة مما يزيد حجم التنزيل بشكل كبير. للاستنساخ بدون الترجمات، استخدم السحب الضيق:

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 (باش/زِش)
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

مزيد من الأعلام: مرجع الأوامر

الميزات

• الترجمة الآلية لملفات 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 طبقة حماية مستقلة، قادرة على اكتشاف المحتوى الضار الناتج عن المستخدم والذكاء الاصطناعي في التطبيقات والخدمات. تتضمن سلامة المحتوى في Azure AI واجهات برمجة التطبيقات للنص والصورة التي تتيح لك اكتشاف المواد الضارة. كما لدينا استوديو تفاعلي لسلامة المحتوى يسمح لك بعرض واستكشاف وتجربة كود عينة لاكتشاف المحتوى الضار عبر وسائط مختلفة. يوجهك مستند الدليل السريع خلال كيفية تقديم الطلبات إلى الخدمة.

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

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

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

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

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

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

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

---

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