co-op-translator
مترجم Co-op: أتمتة ترجمة الوثائق التعليمية بسهولة
قم بأتمتة ترجمة وثائقك إلى عدة لغات بسهولة للوصول إلى جمهور عالمي.
دعم اللغات مدعوم من Co-op Translator
Perancis | Sepanyol | Jerman | Rusia | Arab | Parsi (Farsi) | Urdu | Cina (Ringkas) | Cina (Tradisional, Macau) | Cina (Tradisional, Hong Kong) | Cina (Tradisional, Taiwan) | Jepun | Korea | Hindi | Bengali | Marathi | Nepali | Punjabi (Gurmukhi) | Portugis (Portugal) | Portugis (Brazil) | Itali | Poland | Turki | Greek | Thai | Sweden | Denmark | Norway | Finland | Belanda | Ibrani | Vietnam | Indonesia | Melayu | Tagalog (Filipino) | Swahili | Hungary | Czech | Slovak | Romania | Bulgaria | Serbia (Cyrillic) | Croatia | Slovenia | Ukraine | Burma (Myanmar)
[!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 والصور من مجلد مشروعك ويعالجها كما يلي:
- استخراج النصوص: استخراج النص من ملفات Markdown، وإذا تم التكوين (مثل استخدام Azure AI Vision)، النصوص المضمنة داخل الصور.
- الترجمة بالذكاء الاصطناعي: إرسال النصوص المستخرجة إلى نموذج اللغة المحدد (Azure OpenAI، OpenAI، إلخ) للترجمة.
- حفظ النتائج: حفظ ملفات Markdown المترجمة والصور (مع النصوص المترجمة) داخل مجلدات مخصصة لكل لغة مع الحفاظ على التنسيق الأصلي.
البدء
ابدأ بسرعة باستخدام واجهة الأوامر (CLI) أو قم بإعداد الأتمتة الكاملة مع GitHub Actions. اختر الطريقة التي تناسب سير عملك:
- سطر الأوامر (CLI) - لترجمات لمرة واحدة أو تحكم يدوي
- GitHub Actions - لترجمات آلية عند كل عملية دفع (push)
[!NOTE] رغم أن هذا الدليل يركز على موارد Azure، يمكنك استخدام أي نموذج لغة مدعوم.
دعم اللغات
يدعم Co-op Translator مجموعة واسعة من اللغات لمساعدتك على الوصول إلى جمهور عالمي. إليك ما تحتاج معرفته:
مرجع سريع
| اللغة | الرمز | اللغة | الرمز | اللغة | الرمز |
|---|---|---|---|---|---|
| Arabic | ar | Bengali | bn | Bulgarian | bg |
| Burmese (Myanmar) | my | Chinese (Simplified) | zh | Chinese (Traditional, HK) | hk |
| Chinese (Traditional, Macau) | mo | Chinese (Traditional, TW) | tw | Croatian | hr |
| Czech | cs | Danish | da | Dutch | nl |
| Finnish | fi | French | fr | German | de |
| Greek | el | Hebrew | he | Hindi | hi |
| Hungarian | hu | Indonesian | id | Italian | it |
| Japanese | ja | Korean | ko | Malay | ms |
| Marathi | mr | Nepali | ne | Norwegian | no |
| Persian (Farsi) | fa | Polish | pl | Portuguese (Brazil) | br |
| Portuguese (Portugal) | pt | Punjabi (Gurmukhi) | pa | Romanian | ro |
| Russian | ru | Serbian (Cyrillic) | sr | Slovak | sk |
| Slovenian | sl | Spanish | es | Swahili | sw |
| Swedish | sv | Tagalog (Filipino) | tl | Thai | th |
| Turkish | tr | Ukrainian | uk | Urdu | ur |
| Vietnamese | 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 فقط.
الإعداد الأولي
قبل البدء، ستحتاج إلى إعداد الموارد التالية:
- مورد نموذج اللغة (مطلوب):
- Azure OpenAI (موصى به) - يوفر ترجمات عالية الجودة مع موثوقية على مستوى المؤسسات
- OpenAI - خيار بديل إذا لم يكن لديك وصول إلى Azure
- للمزيد من التفاصيل حول النماذج المدعومة، راجع Supported Models and Services
- مورد AI Vision (اختياري):
- Azure AI Vision - يمكّن ترجمة النص داخل الصور
- إذا لم يتم التكوين، سيستخدم المترجم تلقائيًا وضع Markdown فقط
- يُنصح به للمشاريع التي تحتوي على صور بها نص يحتاج إلى ترجمة
- خطوات التكوين:
- اتبع دليلنا لإعداد Azure AI Azure AI setup guide للحصول على تعليمات مفصلة
- أنشئ ملف
.envيحتوي على مفاتيح API ونقاط النهاية الخاصة بك (راجع قسم Quick Start) - تأكد من أن لديك الأذونات والحصص اللازمة للخدمات التي اخترتها
إعداد المشروع قبل الترجمة
قبل بدء عملية الترجمة، اتبع هذه الخطوات لتحضير مشروعك:
- إعداد 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/)
- تنظيف الترجمات الحالية (إذا لزم الأمر):
- احذف أي مجلدات ترجمة موجودة (مثل
translations/) - احذف أي ملفات ترجمة قديمة للبدء من جديد
- هذا يضمن عدم وجود تعارضات مع عملية الترجمة الجديدة
- احذف أي مجلدات ترجمة موجودة (مثل
بدء سريع: سطر الأوامر
للبدء السريع باستخدام سطر الأوامر:
-
أنشئ بيئة افتراضية:
python -m venv .venv -
فعّل البيئة الافتراضية:
- على ويندوز:
.venv\scripts\activate- على لينكس/ماك:
source .venv/bin/activate -
ثبّت الحزمة:
pip install co-op-translator -
إعداد بيانات الاعتماد:
- أنشئ ملف
.envfile in your project’s root directory. - Copy the contents from the .env.template file into your new
.envfile. - Fill in the required API keys and endpoint information in your
.envfile.
- أنشئ ملف
-
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-translatorpackage. - 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 Guide (Public Repositories & Standard Secrets) - استخدم هذا لمعظم المستودعات العامة أو الشخصية التي تعتمد على أسرار المستودع القياسية.
- GitHub Actions Guide (Microsoft Organization Repos & Org-Level Setups) - استخدم هذا الدليل إذا كنت تعمل ضمن منظمة مايكروسوفت على GitHub أو تحتاج لاستخدام أسرار المنظمة أو مشغلاتها.
استكشاف الأخطاء والنصائح
موارد إضافية
- مرجع الأوامر: دليل مفصل لجميع الأوامر والخيارات المتاحة.
- اللغات المدعومة: تحقق من قائمة اللغات المدعومة وتعليمات إضافة لغات جديدة.
- وضع Markdown فقط: كيفية ترجمة النص فقط، بدون ترجمة الصور.
عروض فيديو
تعرف أكثر على Co-op Translator من خلال عروضنا التقديمية (انقر على الصورة أدناه للمشاهدة على يوتيوب):
- Open at Microsoft: مقدمة مختصرة مدتها 18 دقيقة ودليل سريع حول كيفية استخدام Co-op Translator.
Support Us and Foster Global Learning
Join us in transforming how educational content is shared worldwide! Give Co-op Translator a ⭐ on GitHub and help us break down language barriers in learning and technology. Your interest and contributions make a real difference! Code contributions and feature suggestions are always welcome.
Contributing
This project welcomes contributions and suggestions. Interested in helping with Azure Co-op Translator? Please see our CONTRIBUTING.md for guidelines on how you can help make Co-op Translator more accessible.
Contributors
Code of Conduct
This project follows the Microsoft Open Source Code of Conduct. For more details, see the Code of Conduct FAQ or contact opencode@microsoft.com with any questions or comments.
Responsible AI
Microsoft is dedicated to helping customers use our AI products responsibly, sharing insights, and building trust through tools like Transparency Notes and Impact Assessments. Many of these resources are available at https://aka.ms/RAI.
Microsoft’s approach to responsible AI is based on principles of fairness, reliability and safety, privacy and security, inclusiveness, transparency, and accountability.
Large-scale natural language, image, and speech models—like those used in this sample—may sometimes behave unfairly, unreliably, or offensively, potentially causing harm. Please review the Azure OpenAI service Transparency note to understand the risks and limitations.
The recommended way to reduce these risks is to include a safety system in your architecture that can detect and block harmful behavior. Azure AI Content Safety offers an independent protection layer that detects harmful user-generated and AI-generated content in apps and services. Azure AI Content Safety includes text and image APIs to identify harmful material. There’s also an interactive Content Safety Studio where you can explore and test sample code for detecting harmful content across different types. The following quickstart documentation guides you through making requests to the service.
Another important factor is overall application performance. For multi-modal and multi-model applications, performance means the system behaves as expected by you and your users, including avoiding harmful outputs. It’s important to evaluate your application’s performance using generation quality and risk and safety metrics.
You can test your AI application in your development environment with the prompt flow SDK. Using a test dataset or target, your generative AI outputs are quantitatively measured with built-in or custom evaluators. To get started with the prompt flow SDK for evaluation, follow the quickstart guide. After running an evaluation, you can visualize the results in Azure AI Studio.
Trademarks
This project may include trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos must comply with Microsoft’s Trademark & Brand Guidelines.
Using Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.
Any use of third-party trademarks or logos is subject to the policies of those third parties.
Penafian:
Dokumen ini telah diterjemahkan menggunakan perkhidmatan terjemahan AI Co-op Translator. Walaupun kami berusaha untuk ketepatan, sila ambil perhatian bahawa terjemahan automatik mungkin mengandungi kesilapan atau ketidaktepatan. Dokumen asal dalam bahasa asalnya harus dianggap sebagai sumber yang sahih. Untuk maklumat penting, terjemahan profesional oleh manusia adalah disyorkan. Kami tidak bertanggungjawab atas sebarang salah faham atau salah tafsir yang timbul daripada penggunaan terjemahan ini.