mirror of https://github.com/Azure/co-op-translator synced 2026-08-09 12:00:08 +00:00

Files

T

Minseok Song 2416083413 Docs: Globalize documentation navigation (#473 )

2026-07-01 16:22:43 +09:00

Co-op Translator

Easily automate and maintain translations for your educational GitHub content across multiple languages as your project evolves.

Alusta siit: Choose your workflow | Configuration | CLI | Python API | MCP Server

🌐 Multi-Language Support

Supported by Co-op Translator

Prefer to Clone Locally?

This repository includes 50+ language translations which significantly increases the download size. To clone without translations, use 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"
This gives you everything you need to complete the course with a much faster download.

Ülevaade

Co-op Translator aitab sul hõlpsalt lokaliseerida oma hariduslikku GitHub-sisu mitmesse keelde. Kui uuendad oma Markdown-faile, pilte või notebook'e, jäävad tõlked automaatselt sünkroonis, tagades, et sinu sisu on õppijatele üle maailma täpne ja ajakohane.

Kasuta seda CLI kaudu hoidla tõlkimiseks, Python API-st automaatika jaoks või MCP serveri kaudu agentide ja toimetajate töövoogude jaoks.

Näide sellest, kuidas tõlgitud sisu on organiseeritud:

Miks Co-op Translator?

Ühe faili tõlkimine on lihtne. Kogu dokumentatsioonihoidla tõlkimine, linkimine ja ajakohasena hoidmine on keeruline.

Problem	How Co-op Translator helps
Long docs are not one prompt	Suured Markdown-failid jagatakse tükkideks, nii et pikk README ei sõltu ühest habrasest mudeli vastusest. Kui mõni tükk ebaõnnestub, saab Co-op Translator katsetada uuesti ja ümberjaotada ainult ebaõnnestunud osa.
Incomplete translations should not be marked current	Lõhkemata tõlgitud versioon ei tohiks kunagi olla märgitud ajakohasena. Co-op Translator kontrollib tõlke terviklikkust enne salvestamist ja suudab tuvastada struktuurselt mittetäielikke olemasolevaid tõlkeid.
Links should match the translated repo structure	Käsitsi tehtud tõlked jätavad tihti suhtelised lingid viitama tagasi lähtepuule. Co-op Translator üm kirjutab Markdowni, notebooki, pildi- ja README-lingid nii, et need vastavad `translations/<lang>/...` struktuurile.
Translation should work across an entire repo	Co-op Translator käsitleb README-faile, dokumente, notebook'e ja pilditekste kui osa ühest hoidla töövoost, selle asemel et tõlkida faile ükshaaval.
Maintaining translations matters more than creating them once	Allika räsid ja tõlke metaandmed võimaldavad Co-op Translatoril leida aegunud faile, vahele jätta muutumatuid faile ja hoida tõlgitud sisu sünkroonis, kui lähtehoidla areneb.

Kuidas tõlkeolekut hallatakse

Co-op Translator haldab tõlgitud sisu kui versioonitud tarkvaraartefakte,
mitte kui staatilisi faile.

Tööriist jälgib tõlgitud Markdowni, piltide ja notebook'ide olekut kasutades keele-spetsiifilisi metaandmeid.

See disain võimaldab Co-op Translatoril:

Usaldusväärselt tuvastada aegunud tõlkeid
Käsitleda Markdowni, pilte ja notebook'e järjepidevalt
Skaleeruda turvaliselt suuretes, kiiresti muutuvates mitmekeelsel hoidlates

Tõlkeid modelleerides hallatavate artefaktidena, seostuvad tõlke töövood loomulikult kaasaegsete tarkvara sõltuvus- ja artefaktihalduse praktikatega.

→ Kuidas tõlkeolekut hallatakse

Seotud põhjalikud artiklid

Fixing Broken Markdown in AI Translation: Hardening a Production Pipeline

Alustamine

Co-op Translatorit saab kasutada CLI-st, Python API-st või MCP serverist. Alusta töövoo juhendiga, kui valid lokaalse tõlke, automaatika, CI või agent/toimetaja integratsiooni vahel.

Minimaalne CLI-näide pärast seadistamist:

python -m venv .venv
# Windows
.venv\Scripts\activate
# macOS/Linux
source .venv/bin/activate

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

Suuremate hoidlate esimeste käivituste puhul kasuta enne tõlgitud failide kirjutamist --dry-run. Vaata CLI Reference sisu tüüpide lippude, logide, ülevaatuse ja linkide migratsiooni kohta.

Konteineri kiire käivitamine Bash/Zsh-iga:

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

Konteineri kiire käivitamine PowerShelliga:

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

Funktsioonid

Automatiseeritud tõlge Markdownile, notebook'idele ja piltidele
Hoiab tõlked sünkroonis lähtemuudatustega
Töötab lokaalselt (CLI) või CI-s (GitHub Actions)
Avaldab Markdowni, notebook'i, pildi, ülevaatuse ja projekti tõlke tööriistad MCP kaudu
Kasutab Azure OpenAI või OpenAI pakkujapõhist tõlget
Lubab MCP-l majutada agente, kes tõlgivad Markdowni ja notebook'i tükke ilma Co-op Translatori LLM-i mandaatideta
Kasutab Azure AI Visioni pilditeksti eraldamiseks ja tõlkimiseks
Kontrollib tõlke struktuuri ja ajakohasust deterministlike kontrollidega
Säilitab Markdowni vormingu ja struktuuri

Dokumentatsioon

Microsoft-spetsiifiline juhend

Note

Ainult Microsofti “For Beginners” hoidlate hooldajatele.

Updating the “other courses” list (for MS Beginners repositories only)

Toeta meid ja edenda ülemaailmset õppimist

Liitu meiega, et muuta see, kuidas hariduslikku sisu maailmas jagatakse! Anna Co-op Translator projektile GitHubis ⭐ ja toeta meie missiooni murda keelebarjäärid õppimises ja tehnoloogias. Sinu huvi ja panused avaldavad märkimisväärset mõju! Koodipanused ja funktsioonisoovid on alati teretulnud.

Avasta Microsofti hariduslikku sisu oma keeles

Videopresentatsioonid

👉 Klõpsake alloleval pildil, et vaadata YouTube'is.

Open at Microsoft: Lühike 18-minutiline sissejuhatus ja kiire juhend, kuidas kasutada Co-op Translatorit.

Panustamine

See projekt tervitab panuseid ja ettepanekuid. Kas tunnete huvi Azure Co-op Translatorisse panustamise vastu? Palun vaadake meie CONTRIBUTING.md, et saada juhiseid, kuidas saate aidata muuta Co-op Translatori kättesaadavamaks.

Panustajad

Käitumiskoodeks

See projekt on võtnud kasutusele Microsoft Open Source Code of Conduct. Lisateabe saamiseks vaadake Käitumiskoodeksi KKK või pöörduge lisaküsimuste või kommentaaride korral aadressile opencode@microsoft.com.

Vastutustundlik tehisintellekt

Microsoft on pühendunud aitama meie kliente kasutada meie AI-tooteid vastutustundlikult, jagama oma õppetunde ja ehitama usaldusel põhinevaid partnerlusi tööriistade abil, nagu Transparency Notes ja Impact Assessments. Paljusid neist ressurssidest leiate aadressilt https://aka.ms/RAI. Microsofti lähenemine vastutustundlikule tehisintellektile põhineb meie tehisintellekti põhimõtetel: õigluses, usaldusväärsuses ja turvalisuses, privaatsuses ja turvalisuses, kaasatuses, läbipaistvuses ja vastutuses.

Suurte süsteemide loomuliku keele, pildi ja kõne mudelid - nagu need, mida selles näites kasutatakse - võivad potentsiaalselt käituda ebaõiglaselt, ebakindlalt või solvavalt, mis omakorda võib põhjustada kahju. Palun tutvuge Azure OpenAI service Transparency note, et saada teavet riskide ja piirangute kohta.

Soovitatav lähenemine nende riskide leevendamiseks on lisada oma arhitektuuri turvasüsteem, mis suudab tuvastada ja takistada kahjulikku käitumist. Azure AI Content Safety pakub sõltumatut kaitsekihi, mis suudab rakendustes ja teenustes tuvastada kasutaja- ja AI-tekkelist kahjulikku sisu. Azure AI Content Safety sisaldab teksti- ja pildi-API-sid, mis võimaldavad tuvastada kahjulikku materjali. Samuti on meil interaktiivne Content Safety Studio, mis võimaldab vaadata, uurida ja proovida näitekoodi kahjuliku sisu tuvastamiseks erinevates modaliteetides. Järgmine quickstart documentation juhendab teid teenusele päringute tegemisel.

Teine aspekt, mida arvesse võtta, on kogu rakenduse jõudlus. Mitme-modaliteedi ja mitme-mudeliga rakenduste puhul tähendab jõudlus seda, et süsteem toimib nii, nagu teie ja teie kasutajad ootavad, sealhulgas mitte genereerides kahjulikke väljundeid. Oluline on hinnata kogu teie rakenduse jõudlust, kasutades generation quality and risk and safety metrics.

Saate hinnata oma AI-rakendust arenduskeskkonnas, kasutades prompt flow SDK. Olenevalt kas testandmestikust või eesmärgist, mõõdetakse teie generatiivse AI-rakenduse genereeringud kvantitatiivselt sisseehitatud hindajate või teie valitud kohandatud hindajate abil. Alustamiseks, et hinnata oma süsteemi prompt flow SDK abil, võite järgida quickstart guide. Kui olete hindamisprotsessi läbi viinud, saate visualize the results in Azure AI Studio.

Kaubamärgid

See projekt võib sisaldada projektide, toodete või teenuste kaubamärke või logosid. Microsofti kaubamärkide või logode autoriseeritud kasutamine peab toimuma vastavalt ja järgima Microsoft's Trademark & Brand Guidelines. Microsofti kaubamärkide või logode kasutamine muudetud versioonides sellest projektist ei tohi tekitada segadust ega jätta muljet Microsofti toetusest. Kolmandate osapoolte kaubamärkide või logode kasutamine allub vastavate kolmandate osapoolte poliitikatele.

Abi

Kui takerdute või teil on küsimusi AI-rakenduste loomise kohta, liituge:

Kui teil on toodet puudutavat tagasisidet või ehitamise käigus ilmnevaid vigu, külastage:

18 KiB Raw Blame History