co-op-translator

Co-op Translator: Автоматизирайте превода на образователна документация без усилия

Лесно автоматизирайте превода на вашата документация на множество езици, за да достигнете до глобална аудитория.

Поддръжка на езици, захранвана от Co-op Translator

Френски | Испански | Немски | Руски | Арабски | Персийски (фарси) | Урду | Китайски (опростен) | Китайски (традиционен, Макао) | Китайски (традиционен, Хонконг) | Китайски (традиционен, Тайван) | Японски | Корейски | Хинди | Бенгалски | Маратхи | Непалски | Пенджабски (Гурмукхи) | Португалски (Португалия) | Португалски (Бразилия) | Италиански | Полски | Турски | Гръцки | Тайски | Шведски | Датски | Норвежки | Фински | Холандски | Иврит | Виетнамски | Индонезийски | Малайски | Тагалог (филипински) | Суахили | Унгарски | Чешки | Словашки | Румънски | Български | Сръбски (кирилица) | Хърватски | Словенски | Украински | Бирмански (Мианмар) Моля, напишете изхода от ляво на дясно.

[!NOTE] Това са текущите преводи на съдържанието на това хранилище. За пълен списък с езици, поддържани от Co-op Translator, моля, вижте секцията Language Support.

Обзор: Оптимизирайте превода на вашето образователно съдържание

Езиковите бариери сериозно затрудняват достъпа до ценни образователни ресурси и технически знания за учащи и разработчици по целия свят. Това ограничава участието и забавя темпото на глобалните иновации и учене.

Co-op Translator възникна от нуждата да се подобри неефективният ръчен превод на големи образователни серии на Microsoft (като ръководствата „За начинаещи“). Той се превърна в лесен за ползване и мощен инструмент, който премахва тези бариери за всички. Чрез предоставяне на висококачествени автоматични преводи чрез CLI и GitHub Actions, Co-op Translator дава възможност на преподаватели, студенти, изследователи и разработчици по целия свят да споделят и получават знания без езикови ограничения.

Вижте как Co-op Translator организира преведеното образователно съдържание:

Markdown файловете и текстът в изображенията се превеждат автоматично и се подреждат в папки, специфични за езика.

Отключете глобален достъп до вашето образователно съдържание с Co-op Translator още днес!

Подкрепа за глобален достъп до образователните ресурси на Microsoft

Co-op Translator помага да се преодолее езиковата бариера за ключови образователни инициативи на Microsoft, автоматизирайки процеса на превод за хранилища, обслужващи глобална общност от разработчици. Примери за проекти, които вече използват Co-op Translator:

Основни характеристики

• Автоматични преводи: Превеждайте текст на множество езици без усилие.
• Интеграция с GitHub Actions: Автоматизирайте преводите като част от вашия CI/CD процес.
• Запазване на Markdown: Поддържа правилния Markdown синтаксис по време на превода.
• Превод на текст в изображения: Извлича и превежда текст в изображения.
• Модерна LLM технология: Използва най-новите езикови модели за висококачествени преводи.
• Лесна интеграция: Безпроблемно се включва във вашата текуща проектна среда.
• Оптимизиране на локализацията: Улеснява процеса на локализиране за международни пазари.

Как работи

Co-op Translator взема Markdown файлове и изображения от вашата проектна папка и ги обработва по следния начин:

1. Извличане на текст: Извлича текст от Markdown файловете и, ако е конфигурирано (например с Azure AI Vision), текст, вграден в изображенията.
2. AI превод: Изпраща извлечения текст към конфигурирания LLM (Azure OpenAI, OpenAI и др.) за превод.
3. Запис на резултата: Записва преведените Markdown файлове и изображения (с преведен текст) в папки, специфични за езика, като запазва оригиналното форматиране.

Започване

Започнете бързо с CLI или настройте пълна автоматизация с GitHub Actions. Изберете подхода, който най-добре пасва на вашия работен процес:

1. Команден ред (CLI) – за еднократни преводи или ръчен контрол
2. GitHub Actions – за автоматични преводи при всяко качване

[!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-only режим.

Първоначална настройка

Преди да започнете, трябва да осигурите следните ресурси:

1. Ресурс за езиков модел (задължително):
   • Azure OpenAI (препоръчително) – осигурява висококачествени преводи с надеждност на корпоративно ниво
   • OpenAI – алтернативен вариант, ако нямате достъп до Azure
   • За подробна информация за поддържаните модели вижте Supported Models and Services
2. AI Vision ресурс (по избор):
   • Azure AI Vision – позволява превод на текст в изображения
   • Ако не е конфигуриран, преводачът автоматично ще използва Markdown-only режим
   • Препоръчва се за проекти с изображения, съдържащи текст, който трябва да се преведе
3. Стъпки за конфигурация:
   • Следвайте нашето ръководство за настройка на Azure AI за подробни инструкции
   • Създайте .env файл с вашите API ключове и крайни точки (вижте секцията Quick Start)
   • Уверете се, че имате необходимите разрешения и квоти за избраните услуги

Подготовка на проекта преди превод

Преди да започнете превода, следвайте тези стъпки за подготовка на проекта:

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. Активирайте виртуалната среда:

   • В Windows:

    .venv\scripts\activate
   

   • В Linux/macOS:

    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 Guide (Public Repositories & Standard Secrets) – използвайте това за повечето публични или лични хранилища, които разчитат на стандартни секрети на хранилището.
  • GitHub Actions Guide (Microsoft Organization Repos & Org-Level Setups) – използвайте това, ако работите в GitHub организацията на Microsoft или трябва да използвате секрети или изпълнители на ниво организация.

Отстраняване на проблеми и съвети

• Ръководство за отстраняване на проблеми

Допълнителни ресурси

• Справочник с команди: Подробно ръководство за всички налични команди и опции.
• Поддържани езици: Проверете списъка с поддържани езици и инструкции за добавяне на нови.
• Markdown-only режим: Как да превеждате само текст, без превод на изображения.

Видео презентации

Научете повече за 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. За повече информация вижте Често задавани въпроси за Кодекса на поведение или се свържете с opencode@microsoft.com при допълнителни въпроси или коментари.

Отговорен изкуствен интелект

Microsoft се ангажира да помага на клиентите си да използват нашите AI продукти отговорно, като споделя наученото и изгражда партньорства, базирани на доверие, чрез инструменти като Transparency Notes и Impact Assessments. Много от тези ресурси могат да бъдат намерени на https://aka.ms/RAI. Подходът на Microsoft към отговорния изкуствен интелект се основава на нашите AI принципи за справедливост, надеждност и безопасност, поверителност и сигурност, приобщаване, прозрачност и отчетност.

Големи модели за естествен език, изображения и реч – като тези, използвани в този пример – могат потенциално да се държат несправедливо, ненадеждно или обидно, което може да причини вреди. Моля, консултирайте се с Transparency note на Azure OpenAI service, за да се информирате за рисковете и ограниченията.

Препоръчителният подход за намаляване на тези рискове е да включите система за безопасност във вашата архитектура, която може да открива и предотвратява вредно поведение. Azure AI Content Safety предоставя независим слой защита, способен да открива вредно съдържание, генерирано от потребители и AI, в приложения и услуги. Azure AI Content Safety включва текстови и графични API-та, които ви позволяват да откривате вредно съдържание. Имаме и интерактивно Content Safety Studio, което ви позволява да разглеждате, изследвате и тествате примерен код за откриване на вредно съдържание в различни модалности. Следващата документация за бърз старт ще ви преведе през изпращането на заявки към услугата.

Друг аспект, който трябва да имате предвид, е цялостната производителност на приложението. При мулти-модални и мулти-моделни приложения, производителността означава, че системата работи според очакванията на вас и вашите потребители, включително и да не генерира вредни изходи. Важно е да оцените производителността на цялото приложение, използвайки метрики за качество на генериране и рискове и безопасност.

Можете да оцените вашето AI приложение в средата за разработка, използвайки prompt flow SDK. С помощта на тестов набор от данни или цел, вашите генерации от генеративното AI приложение се измерват количествено с вградени оценители или потребителски оценители по ваш избор. За да започнете с prompt flow sdk за оценка на вашата система, можете да следвате бързия старт. След като изпълните оценка, можете да визуализирате резултатите в Azure AI Studio.

Търговски марки

Този проект може да съдържа търговски марки или лога на проекти, продукти или услуги. Разрешената употреба на Microsoft търговски марки или лога е подчинена на и трябва да следва Microsoft’s Trademark & Brand Guidelines. Употребата на Microsoft търговски марки или лога в модифицирани версии на този проект не трябва да създава объркване или да предполага спонсорство от Microsoft. Всяка употреба на търговски марки или лога на трети страни е подчинена на правилата на съответните трети страни.

Отказ от отговорност:
Този документ е преведен с помощта на AI преводаческа услуга Co-op Translator. Въпреки че се стремим към точност, моля, имайте предвид, че автоматизираните преводи могат да съдържат грешки или неточности. Оригиналният документ на неговия роден език трябва да се счита за авторитетен източник. За критична информация се препоръчва професионален човешки превод. Ние не носим отговорност за каквито и да е недоразумения или неправилни тълкувания, произтичащи от използването на този превод.

This site is open source. Improve this page.