co-op-translator

مترجم التعاون: أتمتة ترجمة الوثائق التعليمية بسهولة

قم بأتمتة ترجمة وثائقك إلى عدة لغات بسهولة للوصول إلى جمهور عالمي.

دعم اللغات مدعوم بواسطة Co-op Translator

الفرنسية | الإسبانية | الألمانية | الروسية | العربية | الفارسية (الفارسية) | الأردية | الصينية (المبسطة) | الصينية (التقليدية، ماكاو) | الصينية (التقليدية، هونغ كونغ) | الصينية (التقليدية، تايوان) | اليابانية | الكورية | الهندية | البنغالية | الماراثية | النيبالية | البنجابية (جورموخي) | البرتغالية (البرتغال) | البرتغالية (البرازيل) | الإيطالية | البولندية | التركية | اليونانية | التايلاندية | السويدية | الدنماركية | النرويجية | الفنلندية | الهولندية | العبرية | الفيتنامية | الإندونيسية | الماليزية | التاغالوغ (الفلبينية) | السواحيلية | الهنغارية | التشيكية | السلوفاكية | الرومانية | البلغارية | الصربية (السيريلية) | الكرواتية | السلوفينية | الأوكرانية | البورمية (ميانمار) الرجاء كتابة المخرجات من اليمين إلى اليسار، مع احترام أن هذه لغة تُكتب من اليمين إلى اليسار.

[!NOTE] هذه هي الترجمات الحالية لمحتوى هذا المستودع. للحصول على قائمة كاملة باللغات المدعومة من Co-op Translator، يرجى الاطلاع على قسم Language Support.

نظرة عامة: تبسيط ترجمة المحتوى التعليمي الخاص بك

تشكل حواجز اللغة عائقًا كبيرًا أمام الوصول إلى الموارد التعليمية القيمة والمعرفة التقنية للمتعلمين والمطورين حول العالم. هذا يحد من المشاركة ويبطئ من وتيرة الابتكار والتعلم على الصعيد العالمي.

وُلد Co-op Translator من الحاجة إلى معالجة عملية الترجمة اليدوية غير الفعالة لسلسلة تعليمية كبيرة خاصة بمايكروسوفت (مثل أدلة “للمبتدئين”). تطور ليصبح أداة سهلة الاستخدام وقوية تهدف إلى إزالة هذه الحواجز للجميع. من خلال توفير ترجمات آلية عالية الجودة عبر واجهة الأوامر و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 والصور من مجلد مشروعك ويعالجها كما يلي:

1. استخراج النصوص: استخراج النصوص من ملفات Markdown، وإذا تم التكوين (مثل Azure AI Vision)، استخراج النصوص المضمنة داخل الصور.
2. الترجمة باستخدام الذكاء الاصطناعي: إرسال النص المستخرج إلى نموذج اللغة المكون (Azure OpenAI، OpenAI، إلخ) للترجمة.
3. حفظ النتائج: حفظ ملفات Markdown والصور المترجمة (مع النصوص المترجمة) في مجلدات خاصة بكل لغة مع الحفاظ على التنسيق الأصلي.

البدء

ابدأ بسرعة باستخدام CLI أو قم بإعداد الأتمتة الكاملة باستخدام GitHub Actions. اختر الطريقة التي تناسب سير عملك:

1. سطر الأوامر (CLI) - للترجمات لمرة واحدة أو التحكم اليدوي
2. GitHub Actions - للترجمات الآلية عند كل دفع

[!NOTE] بينما يركز هذا الدليل على موارد Azure، يمكنك استخدام أي نموذج لغة مدعوم.

دعم اللغات

يدعم Co-op Translator مجموعة واسعة من اللغات لمساعدتك في الوصول إلى جمهور عالمي. إليك ما تحتاج معرفته:

مرجع سريع

اللغة	الرمز	اللغة	الرمز	اللغة	الرمز
العربية	ar	البنغالية	bn	البلغارية	bg
البورمية (ميانمار)	my	الصينية (المبسطة)	zh	الصينية (التقليدية، هونغ كونغ)	hk
الصينية (التقليدية، ماكاو)	mo	الصينية (التقليدية، تايوان)	tw	الكرواتية	hr
التشيكية	cs	الدنماركية	da	الهولندية	nl
الفنلندية	fi	الفرنسية	fr	الألمانية	de
اليونانية	el	العبرية	he	الهندية	hi
الهنغارية	hu	الإندونيسية	id	الإيطالية	it
اليابانية	ja	الكورية	ko	الملايوية	ms
الماراثية	mr	النيبالية	ne	النرويجية	no
الفارسية (الفارسية)	fa	البولندية	pl	البرتغالية (البرازيل)	br
البرتغالية (البرتغال)	pt	البنجابية (غورموخي)	pa	الرومانية	ro
الروسية	ru	الصربية (السيريلية)	sr	السلوفاكية	sk
السلوفينية	sl	الإسبانية	es	السواحيلية	sw
السويدية	sv	التاغالوغ (الفلبينية)	tl	التايلاندية	th
التركية	tr	الأوكرانية	uk	الأردية	ur
الفيتنامية	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 فقط.

الإعداد الأولي

قبل البدء، ستحتاج إلى إعداد الموارد التالية:

1. مورد نموذج اللغة (مطلوب):
   • Azure OpenAI (موصى به) - يوفر ترجمات عالية الجودة مع موثوقية على مستوى المؤسسات
   • OpenAI - خيار بديل إذا لم يكن لديك وصول إلى Azure
   • لمعلومات مفصلة عن النماذج المدعومة، راجع النماذج والخدمات المدعومة
2. مورد AI Vision (اختياري):
   • Azure AI Vision - يتيح ترجمة النصوص داخل الصور
   • إذا لم يتم التكوين، سيستخدم المترجم تلقائيًا وضع Markdown فقط
   • موصى به للمشاريع التي تحتوي على صور بها نصوص بحاجة للترجمة
3. خطوات التكوين:
   • اتبع دليلنا إعداد Azure AI للحصول على تعليمات مفصلة
   • أنشئ ملف .env يحتوي على مفاتيح API ونقاط النهاية الخاصة بك (راجع قسم البدء السريع)
   • تأكد من أن لديك الأذونات والحصص اللازمة للخدمات التي اخترتها

إعداد المشروع قبل الترجمة

قبل بدء عملية الترجمة، اتبع هذه الخطوات لتحضير مشروعك:

1. جهز ملف 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/) 
         
     

2. نظف الترجمات الحالية (إذا لزم الأمر):
   • احذف أي مجلدات ترجمة موجودة (مثل translations/)
   • امسح أي ملفات ترجمة قديمة للبدء من جديد
   • هذا يضمن عدم وجود تعارضات مع عملية الترجمة الجديدة

البدء السريع: سطر الأوامر

لبداية سريعة باستخدام سطر الأوامر:

1. أنشئ بيئة افتراضية:

    python -m venv .venv
   

2. فعّل البيئة الافتراضية:

   • على ويندوز:

    .venv\scripts\activate
   

   • على لينكس/ماك:

    source .venv/bin/activate
   

3. ثبّت الحزمة:

    pip install co-op-translator
   

4. قم بتكوين بيانات الاعتماد:

   • أنشئ ملف .env file in your project’s root directory.
   • Copy the contents from the .env.template file into your new .env file.
   • Fill in the required API keys and endpoint information in your .env file.

5. 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-translator package.
• 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 (المستودعات العامة والأسرار القياسية) - استخدم هذا لمعظم المستودعات العامة أو الشخصية التي تعتمد على أسرار المستودع القياسية.
  • دليل GitHub Actions (مستودعات منظمة Microsoft وإعدادات على مستوى المنظمة) - استخدم هذا الدليل إذا كنت تعمل ضمن منظمة Microsoft على GitHub أو تحتاج إلى استخدام أسرار أو مشغلات على مستوى المنظمة.

استكشاف الأخطاء والنصائح

• دليل استكشاف الأخطاء

موارد إضافية

• مرجع الأوامر: دليل مفصل لجميع الأوامر والخيارات المتاحة.
• اللغات المدعومة: تحقق من قائمة اللغات المدعومة وتعليمات إضافة لغات جديدة.
• وضع Markdown فقط: كيفية ترجمة النصوص فقط دون ترجمة الصور.

العروض التقديمية بالفيديو

تعرف أكثر على Co-op Translator من خلال عروضنا التقديمية (انقر على الصورة أدناه للمشاهدة على YouTube):

• 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 لأي أسئلة أو تعليقات إضافية.

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

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

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

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

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

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

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

قد يحتوي هذا المشروع على علامات تجارية أو شعارات لمشاريع أو منتجات أو خدمات. يخضع الاستخدام المصرح به لعلامات Microsoft التجارية أو شعاراتها إلى Microsoft’s Trademark & Brand Guidelines. يجب ألا يسبب استخدام علامات Microsoft التجارية أو شعاراتها في نسخ معدلة من هذا المشروع أي لبس أو يوحي برعاية Microsoft. أي استخدام لعلامات تجارية أو شعارات تابعة لأطراف ثالثة يخضع لسياسات تلك الأطراف.

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

This site is open source. Improve this page.