Files

24 KiB
Raw Permalink Blame History

Co-op Translator

Лако аутоматизујте и одржавајте преводе за ваш едукативни GitHub садржај на више језика како ваш пројекат расте.

Python 3.10–3.12 Python package License: MIT Downloads Downloads Container: GHCR Code style: black

GitHub contributors GitHub issues GitHub pull-requests PRs Welcome

Почните овде: Choose your workflow | Configuration | CLI | Python API | MCP Server

🌐 Подршка за више језика

Подржано од стране Co-op Translator

Арапски | Бенгалски | Бугарски | Бирмански (Мјанмар) | Кинески (поједностављени) | Кинески (традиционални, Хонг Конг) | Кинески (традиционални, Макао) | Кинески (традиционални, Тајван) | Хрватски | Чешки | Дански | Холандски | Естонски | Фински | Француски | Немачки | Грчки | Хебрејски | Хинди | Мађарски | Индонежански | Италијански | Јапански | Каннада | Кмерски | Корејски | Литвански | Малајски | Малајалам | Марати | Непалски | Нигеријски пидгин | Норвешки | Персијски (фарси) | Пољски | Португалски (Бразил) | Португалски (Португалија) | Пуњаби (Гурумки) | Румунски | Руски | Српски (ћирилица) | Словачки | Словеначки | Шпански | Свахили | Шведски | Тагалог (Филипински) | Тамилски | Телугу | Тајландски | Турски | Украјински | Урду | Вијетнамски

Преферирате да клонирате локално?

Овај репозиторјум садржи преко 50 превода што значајно повећава величину преузимања. Да бисте клонирали без превода, користите sparse checkout:

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"

Ово вам даје све што вам је потребно да завршите курс уз знатно брже преузимање.

GitHub watchers GitHub forks GitHub stars

Microsoft Foundry Discord

Open in GitHub Codespaces

Преглед

Co-op Translator вам помаже да локализујете ваш едукативни GitHub садржај на више језика без напора. Када ажурирате Markdown датотеке, слике или бележнице, преводи остају аутоматски синхронизовани, осигуравајући да ваш садржај буде тачан и ажуран за ученике широм света.

Користите га из CLI за превод репозиторијума, из Python API за аутоматизацију или кроз MCP сервер за агентске и уређивачке токове рада.

Example of how translated content is organized:

Example

Зашто Co-op Translator?

Превођење једне датотеке је лако. Одржавање целог репозиторијума документације преведеног, повезаног и ажурног је тешки део.

Problem How Co-op Translator helps
Дуге документације нису један промпт Велике Markdown датотеке се деле на делове, тако да дуг README не зависи од једног крхког одговора модела. Ако део не успе, Co-op Translator може поново покушати и поново протумачити само неуспели део.
Непотпуни преводи не би требало да буду означени као тренутни Скраћени превод никада не би требало да буде означен као ажуран. Co-op Translator проверава интегритет превода пре чувања и може открити структурно непотпуне постојеће преводе.
Линкови треба да одговарају преведеном структури репозиторијума Ручни преводи често остављају релативне линкове који упућују на изворно дрво. Co-op Translator преписује Markdown, бележнице, слике и README линкове да одговарају структури translations/<lang>/....
Превод треба да функционише кроз цео репозиторијум Co-op Translator обрађује README датотеке, документе, бележнице и текст на сликама као део једног радног тока репозиторијума, уместо да преводи датотеке једну по једну.
Одржавање превода је важније од једнократног креирања Хешеви извора и метаподаци о преводу омогућавају Co-op Translator-у да пронађе застареле датотеке, прескочи непромењене датотеке и одржава преведени садржај синхронизован како се изворни репо развија.

Како се управља статусом превода

Co-op Translator управља преведеним садржајем као верзионисаним софтверским артефактима,
а не као статичним датотекама.

Алат прати статус преведеног Markdown-а, слика и бележница користећи метаподаце по језику.

Овај дизајн омогућава Co-op Translator-у да:

  • Поуздано открије застареле преводе
  • Третира Markdown, слике и бележнице доследно
  • Безбедно скалира преко великих, брзо мењајућих се, вишечланских репозиторијума

Моделирањем превода као управљаних артефаката, токови рада за превод природно се усклађују са модерним практикама управљања зависностима и артефактима софтвера.

→ Како се управља статусом превода

Повезани детаљније анализе

Почните

Co-op Translator се може користити из CLI-а, Python API-ја или MCP сервера. Почните са водичем за ток рада ако бирате између локалног превода, аутоматизације, CI и интеграције агената/уредника.

Минималан пример из CLI-а након конфигурације:

python -m venv .venv
# Виндоус
.venv\Scripts\activate
# макОС/Линукс
source .venv/bin/activate

pip install co-op-translator
translate -l "ko" -md
co-op-review -l "ko"

За прва покретања на великим репозиторијумима, користите --dry-run пре него што се преведене датотеке запишу. Погледајте CLI Reference за ознаке типова садржаја, логове, преглед и миграцију линкова.

Брзо покретање у контејнеру са Bash/Zsh:

docker run --rm -it --env-file .env -v "${PWD}:/work" ghcr.io/azure/co-op-translator:latest -l "ko" -md

Брзо покретање у контејнеру са PowerShell-ом:

docker run --rm -it --env-file .env -v ${PWD}:/work ghcr.io/azure/co-op-translator:latest -l "ko" -md

Карактеристике

  • Аутоматизован превод за Markdown, бележнице и слике
  • Одржава преводе синхронизованим са променама извора
  • Ради локално (CLI) или у CI-у (GitHub Actions)
  • Обезбеђује алате за превођење Markdown-а, бележница, слика, прегледа и пројекта кроз MCP
  • Користи Azure OpenAI или OpenAI као провајдере за превод
  • Омогућава MCP-у да хостује агенте који преводе делове Markdown-а и бележница без Co-op Translator LLM акредитива
  • Користи Azure AI Vision за екстраховање текста са слика и превод
  • Прегледа структуру и свежину превода детерминистичким проверама
  • Чува Markdown форматирање и структуру

Документација

Водич специфичан за Microsoft

Note

Само за одржаваоце Microsoft „For Beginners“ репозиторијума.

Подржите нас и подржите глобално учење

Придружите нам се у револуционисању начина на који се едукативни садржај дели глобално! Дајте Co-op Translator ⭐ на GitHub-у и подржите нашу мисију смањења језичких баријера у учењу и технологији. Ваш интерес и доприноси имају значајан утицај! Кодни доприноси и предлози функција су увек добродошли.

Истражите Microsoft едукативни садржај на вашем језику

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

👉 Кликните на слику испод да гледате на YouTube.

  • Отворено у Microsoft-у: Кратак 18-минутни увод и брзи водич како да користите Co-op Translator.

    Отворено у Microsoft-у

Доприноси

Овај пројекат поздравља доприносе и предлоге. Желите да допринесете Azure Co-op Translator-у? Погледајте наш CONTRIBUTING.md за смернице о томе како можете помоћи да Co-op Translator буде приступачнији.

Сарадници

co-op-translator contributors

Кодекс понашања

Овај пројекат је усвојио Microsoft-ов кодекс понашања за отворени код. За више информација погледајте Често постављана питања о кодексу понашања или контактирајте opencode@microsoft.com за додатна питања или коментаре.

Одговорна вештачка интелигенција

Microsoft је посвећен помагању нашим купцима да користе наше AI производе на одговоран начин, дељењу наших сазнања и изградњи партнерстава заснованих на поверењу кроз алате као што су Transparency Notes и Impact Assessments. Многи од ових ресурса могу се пронаћи на https://aka.ms/RAI. Microsoft-ов приступ одговорној вештачкој интелигенцији заснован је на нашим AI принципима праведности, поузданости и безбедности, приватности и сигурности, инклузивности, транспарентности и одговорности.

Великомасивни модели природног језика, слика и говора — као они који се користе у овом примеру — потенцијално могу да се понашају на начине који су неправедни, непоуздани или увредљиви, што може проузроковати штету. Молимо вас да консултујете Напомену о транспарентности услуге Azure OpenAI како бисте били информисани о ризицима и ограничењима.

Препоручени приступ за ублажавање ових ризика је укључивање безбедносног система у вашу архитектуру који може да открије и спречи штетно понашање. 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 апликација, придружите се:

Microsoft Foundry Discord

Ако имате повратне информације о производу или грешке током развоја посетите:

Форум програмера Microsoft Foundry