co-op-translator
Co-op Translator: ترجمه خودکار مستندات آموزشی به‌سادگی
ترجمه مستندات خود را به چند زبان به‌راحتی خودکار کنید تا به مخاطبان جهانی دسترسی پیدا کنید.
پشتیبانی زبان با قدرت Co-op Translator
فرانسوی | اسپانیایی | آلمانی | روسی | عربی | فارسی | اردو | چینی (ساده شده) | چینی (سنتی، ماکائو) | چینی (سنتی، هنگ کنگ) | چینی (سنتی، تایوان) | ژاپنی | کره‌ای | هندی | بنگالی | مراتی | نپالی | پنجابی (گورمخی) | پرتغالی (پرتغال) | پرتغالی (برزیل) | ایتالیایی | لهستانی | ترکی | یونانی | تایلندی | سوئدی | دانمارکی | نروژی | فنلاندی | هلندی | عبری | ویتنامی | اندونزیایی | مالایی | تاگالوگ (فیلیپینی) | سواحیلی | مجارستانی | چکی | اسلواکی | رومانیایی | بلغاری | صربی (سیریلیک) | کرواتی | اسلوونیایی | اوکراینی | برمه‌ای (میانمار)لطفاً خروجی را از راست به چپ بنویسید، با رعایت اینکه این زبان راست به چپ است.
[!NOTE] این‌ها ترجمه‌های فعلی محتوای این مخزن هستند. برای مشاهده فهرست کامل زبان‌های پشتیبانی‌شده توسط Co-op Translator، لطفاً به بخش Language Support مراجعه کنید.
مرور کلی: روند ترجمه محتوای آموزشی خود را ساده کنید
موانع زبانی به‌طور چشمگیری دسترسی به منابع آموزشی ارزشمند و دانش فنی را برای یادگیرندگان و توسعه‌دهندگان در سراسر جهان محدود می‌کند. این موضوع باعث کاهش مشارکت و کند شدن روند نوآوری و یادگیری در سطح جهانی می‌شود.
Co-op Translator از نیاز به رفع روند ناکارآمد ترجمه دستی برای مجموعه‌های آموزشی گسترده مایکروسافت (مانند راهنماهای “برای مبتدیان”) شکل گرفته است. این ابزار به یک راهکار قدرتمند و ساده برای استفاده تبدیل شده که هدفش شکستن این موانع برای همه است. با ارائه ترجمه‌های خودکار با کیفیت بالا از طریق CLI و 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 از طیف وسیعی از زبان‌ها پشتیبانی می‌کند تا به شما کمک کند به مخاطبان جهانی دسترسی داشته باشید. نکات مهم:
مرجع سریع
| زبان | کد | زبان | کد | زبان | کد |
|---|---|---|---|---|---|
| عربی | 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] برای اطلاعات فنی دقیق درباره پشتیبانی زبان‌ها، شامل:
- مشخصات قلم برای هر زبان
- مشکلات شناخته‌شده
- نحوه افزودن زبان‌های جدید
به مستندات زبان‌های پشتیبانی‌شده مراجعه کنید.
مدل‌ها و سرویس‌های پشتیبانی‌شده
| نوع | نام |
|---|---|
| مدل زبان |   |
| بینایی هوش مصنوعی |  |
[!NOTE] اگر سرویس بینایی هوش مصنوعی در دسترس نباشد، co-op translator به حالت فقط Markdown تغییر خواهد کرد.
تنظیمات اولیه
قبل از شروع، باید منابع زیر را تنظیم کنید:
- منبع مدل زبان (الزامی):
- Azure OpenAI (توصیه‌شده) - ترجمه‌های با کیفیت بالا با قابلیت اطمینان سازمانی
- OpenAI - گزینه جایگزین در صورت عدم دسترسی به Azure
- برای اطلاعات دقیق درباره مدل‌های پشتیبانی‌شده، به مدل‌ها و سرویس‌های پشتیبانی‌شده مراجعه کنید
- منبع بینایی هوش مصنوعی (اختیاری):
- Azure AI Vision - امکان ترجمه متن داخل تصاویر
- اگر تنظیم نشود، ترجمه‌گر به‌طور خودکار از حالت فقط Markdown استفاده می‌کند
- برای پروژه‌هایی با تصاویر حاوی متن که نیاز به ترجمه دارند توصیه می‌شود
- مراحل پیکربندی:
- دستورالعمل‌های دقیق را در راهنمای راه‌اندازی Azure AI دنبال کنید
- یک فایل
.envبا کلیدهای API و نقاط پایان خود ایجاد کنید (بخش شروع سریع را ببینید) - مطمئن شوید مجوزها و سهمیه‌های لازم برای سرویس‌های انتخابی خود را دارید
آماده‌سازی پروژه پیش از ترجمه
قبل از شروع فرآیند ترجمه، مراحل زیر را برای آماده‌سازی پروژه خود دنبال کنید:
- آماده‌سازی 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 (مخازن عمومی و اسرار استاندارد) - برای بیشتر مخازن عمومی یا شخصی که از اسرار استاندارد مخزن استفاده می‌کنند.
- راهنمای GitHub Actions (مخازن سازمانی مایکروسافت و تنظیمات سطح سازمان) - اگر در سازمان GitHub مایکروسافت فعالیت می‌کنید یا نیاز به استفاده از اسرار یا رانرهای سطح سازمان دارید، این راهنما را ببینید.
عیب‌یابی و نکات
منابع اضافی
- مرجع دستورات: راهنمای کامل دستورات و گزینه‌های موجود.
- زبان‌های پشتیبانی‌شده: فهرست زبان‌های پشتیبانی‌شده و نحوه افزودن زبان جدید.
- حالت فقط Markdown: نحوه ترجمه فقط متن بدون ترجمه تصاویر.
ویدیوهای معرفی
برای آشنایی بیشتر با Co-op Translator، ارائه‌های ما را ببینید (برای مشاهده در یوتیوب روی تصویر زیر کلیک کنید):
- Open at Microsoft: معرفی کوتاه ۱۸ دقیقه‌ای و راهنمای سریع استفاده از Co-op Translator.
از ما حمایت کنید و یادگیری جهانی را تقویت کنید
به ما بپیوندید تا نحوه اشتراک‌گذاری محتوای آموزشی در سطح جهان را متحول کنیم! به Co-op Translator در گیت‌هاب ⭐ بدهید و از مأموریت ما برای از بین بردن موانع زبانی در یادگیری و فناوری حمایت کنید. علاقه و مشارکت‌های شما تأثیر قابل توجهی دارد! مشارکت در کد و پیشنهاد ویژگی‌ها همیشه خوش‌آمد است.
مشارکت
این پروژه از مشارکت‌ها و پیشنهادات استقبال می‌کند. علاقه‌مند به مشارکت در Azure Co-op Translator هستید؟ لطفاً برای راهنمایی درباره نحوه کمک به دسترسی‌پذیرتر کردن Co-op Translator، به CONTRIBUTING.md مراجعه کنید.
مشارکت‌کنندگان
قوانین رفتاری
این پروژه Microsoft Open Source Code of Conduct را پذیرفته است. برای اطلاعات بیشتر به Code of Conduct FAQ مراجعه کنید یا در صورت داشتن سوال یا نظر اضافی با opencode@microsoft.com تماس بگیرید.
هوش مصنوعی مسئولانه
مایکروسافت متعهد است به مشتریان خود کمک کند تا محصولات هوش مصنوعی ما را به‌صورت مسئولانه استفاده کنند، تجربیات خود را به اشتراک بگذارد و از طریق ابزارهایی مانند Transparency Notes و Impact Assessments، شراکت‌های مبتنی بر اعتماد بسازد. بسیاری از این منابع را می‌توانید در https://aka.ms/RAI بیابید. رویکرد مایکروسافت به هوش مصنوعی مسئولانه بر اصولی چون عدالت، قابلیت اطمینان و ایمنی، حریم خصوصی و امنیت، فراگیری، شفافیت و پاسخگویی استوار است.
مدل‌های بزرگ زبان طبیعی، تصویر و گفتار - مانند مدل‌هایی که در این نمونه استفاده شده‌اند - ممکن است رفتارهایی ناعادلانه، غیرقابل اطمینان یا توهین‌آمیز داشته باشند که به نوبه خود می‌تواند آسیب‌زا باشد. لطفاً برای آگاهی از خطرات و محدودیت‌ها، به Azure OpenAI service Transparency note مراجعه کنید.
رویکرد پیشنهادی برای کاهش این خطرات، گنجاندن یک سیستم ایمنی در معماری شما است که بتواند رفتارهای مضر را شناسایی و جلوگیری کند. Azure AI Content Safety لایه‌ای مستقل از حفاظت ارائه می‌دهد که قادر است محتوای مضر تولید شده توسط کاربران و هوش مصنوعی را در برنامه‌ها و خدمات تشخیص دهد. Azure AI Content Safety شامل APIهای متنی و تصویری است که امکان شناسایی محتوای مضر را فراهم می‌کنند. همچنین یک Content Safety Studio تعاملی داریم که به شما اجازه می‌دهد نمونه کدهای تشخیص محتوای مضر در حالت‌های مختلف را مشاهده، بررسی و آزمایش کنید. مستندات quickstart زیر شما را در ارسال درخواست به سرویس راهنمایی می‌کند.
یکی دیگر از جنبه‌های مهم، عملکرد کلی برنامه است. در برنامه‌های چندرسانه‌ای و چندمدلی، عملکرد به معنای اجرای سیستم مطابق انتظار شما و کاربران است، از جمله عدم تولید خروجی‌های مضر. ارزیابی عملکرد کلی برنامه با استفاده از معیارهای کیفیت تولید و ریسک و ایمنی اهمیت دارد.
شما می‌توانید برنامه هوش مصنوعی خود را در محیط توسعه با استفاده از prompt flow SDK ارزیابی کنید. با داشتن یک مجموعه داده آزمایشی یا هدف، تولیدات برنامه هوش مصنوعی شما به صورت کمی با ارزیاب‌های داخلی یا سفارشی اندازه‌گیری می‌شود. برای شروع با prompt flow sdk و ارزیابی سیستم خود، می‌توانید راهنمای quickstart را دنبال کنید. پس از اجرای ارزیابی، می‌توانید نتایج را در Azure AI Studio مشاهده کنید.
علائم تجاری
این پروژه ممکن است شامل علائم تجاری یا لوگوهایی برای پروژه‌ها، محصولات یا خدمات باشد. استفاده مجاز از علائم تجاری یا لوگوهای مایکروسافت مشروط به رعایت Microsoft’s Trademark & Brand Guidelines است. استفاده از علائم تجاری یا لوگوهای مایکروسافت در نسخه‌های تغییر یافته این پروژه نباید باعث سردرگمی شود یا حمایت مایکروسافت را القا کند. هرگونه استفاده از علائم تجاری یا لوگوهای شخص ثالث مشمول سیاست‌های آن شخص ثالث است.
سلب مسئولیت:
این سند با استفاده از سرویس ترجمه هوش مصنوعی Co-op Translator ترجمه شده است. در حالی که ما در تلاش برای دقت هستیم، لطفاً توجه داشته باشید که ترجمه‌های خودکار ممکن است حاوی اشتباهات یا نادرستی‌هایی باشند. سند اصلی به زبان بومی خود باید به عنوان منبع معتبر در نظر گرفته شود. برای اطلاعات حیاتی، ترجمه حرفه‌ای انسانی توصیه می‌شود. ما مسئول هیچ گونه سوءتفاهم یا برداشت نادرستی که از استفاده از این ترجمه ناشی شود، نیستیم.