24 KiB
Co-op Translator
Лако аутоматизујте и одржавајте преводе за ваш едукативни GitHub садржај на више језика како ваш пројекат расте.
Почните овде: 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"Ово вам даје све што вам је потребно да завршите курс уз знатно брже преузимање.
Преглед
Co-op Translator вам помаже да локализујете ваш едукативни GitHub садржај на више језика без напора. Када ажурирате Markdown датотеке, слике или бележнице, преводи остају аутоматски синхронизовани, осигуравајући да ваш садржај буде тачан и ажуран за ученике широм света.
Користите га из CLI за превод репозиторијума, из Python API за аутоматизацију или кроз MCP сервер за агентске и уређивачке токове рада.
Example of how translated content is organized:
Зашто 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 API-јем
- Повежите се са MCP сервером
- Покрените у GitHub Actions
Минималан пример из 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 форматирање и структуру
Документација
- Документациони сајт
- Одаберите ваш ток рада
- Конфигурација
- Azure AI Подешавање
- CLI Reference
- Python API
- MCP Server
- GitHub Actions
- README шаблон за језике
- Подржани језици
- Учествовање
- Отстрањавање проблема
Водич специфичан за Microsoft
Note
Само за одржаваоце Microsoft „For Beginners“ репозиторијума.
Подржите нас и подржите глобално учење
Придружите нам се у револуционисању начина на који се едукативни садржај дели глобално! Дајте Co-op Translator ⭐ на GitHub-у и подржите нашу мисију смањења језичких баријера у учењу и технологији. Ваш интерес и доприноси имају значајан утицај! Кодни доприноси и предлози функција су увек добродошли.
Истражите Microsoft едукативни садржај на вашем језику
- LangChain4j за почетнике
- AZD за почетнике
- Edge AI за почетнике
- Model Context Protocol (MCP) за почетнике
- AI агенти за почетнике
- Generative AI за почетнике користећи .NET
- Generative AI за почетнике
- Generative AI за почетнике користећи Java
- ML за почетнике
- Data Science за почетнике
- AI за почетнике
- Кибербезбедност за почетнике
- Веб развој за почетнике
- IoT за почетнике
- PhiCookBook
Видеопрезентације
👉 Кликните на слику испод да гледате на YouTube.
Доприноси
Овај пројекат поздравља доприносе и предлоге. Желите да допринесете Azure Co-op Translator-у? Погледајте наш CONTRIBUTING.md за смернице о томе како можете помоћи да Co-op Translator буде приступачнији.
Сарадници
Кодекс понашања
Овај пројекат је усвојио 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 апликација, придружите се:
Ако имате повратне информације о производу или грешке током развоја посетите:
