admin/Azure-co-op-translator

Fork 0

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

18 KiB

Raw Permalink Blame History

Co-op Translator

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

Začnite tu: Vyberte svoj pracovný postup | Konfigurácia | CLI | Python API | MCP Server

🌐 Podpora viacerých jazykov

Podporované Co-op Translator

Preferujete klonovanie lokálne?

Tento repozitár obsahuje 50+ jazykových prekladov, čo výrazne zväčšuje veľkosť sťahovania. Ak chcete klonovať bez prekladov, použite 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"
Toto vám poskytne všetko, čo potrebujete na dokončenie kurzu s omnoho rýchlejším stiahnutím.

Prehľad

Co-op Translator vám pomáha lokalizovať váš vzdelávací obsah na GitHub-e do viacerých jazykov bez námahy. Keď aktualizujete svoje súbory Markdown, obrázky alebo notebooky, preklady zostávajú automaticky synchronizované, čo zaisťuje, že váš obsah zostane presný a aktuálny pre študentov po celom svete.

Používajte ho z CLI pre preklad repozitára, z Python API pre automatizáciu, alebo cez MCP server pre pracovné postupy s agentmi a editormi.

Príklad toho, ako je preložený obsah organizovaný:

Prečo Co-op Translator?

Preložiť jeden súbor je jednoduché. Udržiavať celý dokumentačný repozitár preložený, prepojený a aktuálny je náročné.

Problém	Ako vám Co-op Translator pomôže
Dlhé dokumenty nie sú jeden prompt	Veľké Markdown súbory sú rozdelené na časti, takže dlhé README nie je závislé od jednej krehkej odpovede modelu. Ak časť zlyhá, Co-op Translator môže skúsiť znova a znovu rozčleniť len neúspešnú časť.
Neúplné preklady by nemali byť označené ako aktuálne	Skrátený preklad by nikdy nemal byť uzavretý ako aktuálny. Co-op Translator kontroluje integritu prekladu pred uložením a dokáže zistiť štruktúrne neúplné existujúce preklady.
Odkazy by mali zodpovedať preloženej štruktúre repozitára	Manuálne preklady často nechávajú relatívne odkazy smerujúce späť do zdrojového stromu. Co-op Translator prepíše odkazy v Markdown, notebookoch, obrázkoch a README tak, aby zodpovedali štruktúre `translations/<lang>/...`.
Preklad by mal fungovať v celom repozitári	Co-op Translator spracováva súbory README, dokumentáciu, notebooky a text v obrázkoch ako súčasť jedného pracovného postupu repozitára, namiesto prekladu súborov jeden po druhom.
Udržiavanie prekladov je dôležitejšie než ich jednorazové vytvorenie	Hashy zdrojov a metadáta prekladov umožňujú Co-op Translatoru nájsť zastarané súbory, preskočiť nezmenené súbory a udržiavať preložený obsah synchronizovaný, keď sa zdrojový repozitár vyvíja.

Ako je spravovaný stav prekladu

Co-op Translator spravuje preložený obsah ako verziované softvérové artefakty,
nie ako statické súbory.

Nástroj sleduje stav preloženého Markdownu, obrázkov a notebookov pomocou metadát viazaných na jazyk.

Tento dizajn umožňuje Co-op Translatoru:

Spoľahlivo zistiť zastarané preklady
Zaobchádzať s Markdownom, obrázkami a notebookmi konzistentne
Bezpečne škálovať naprieč veľkými, rýchlo sa meniacimi, viacjazyčnými repozitármi

Tým, že modeluje preklady ako spravované artefakty, pracovné postupy prekladov sa prirodzene zladia s modernými praktikami správy závislostí a artefaktov softvéru.

→ Ako sa spravuje stav prekladu

Súvisiace podrobné články

Oprava poškodeného Markdownu v AI preklade: Spevnenie produkčnej pipeline

Začnite

Co-op Translator sa dá používať z CLI, Python API alebo MCP servera. Začnite s príručkou pracovného postupu, ak si vyberáte medzi lokálnym prekladom, automatizáciou, CI a integráciou s agentom/editorem.

Minimálny príklad použitia CLI po konfigurácii:

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"

Pre prvé spustenia na veľkých repozitároch používajte --dry-run pred zápisom preložených súborov. Pozrite si CLI Reference pre príznaky typov obsahu, logy, kontrolu a migráciu odkazov.

Rýchle spustenie v kontajneri s Bash/Zsh:

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

Rýchle spustenie v kontajneri s PowerShell:

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

Funkcie

Automatizovaný preklad pre Markdown, notebooky a obrázky
Udržiava preklady synchronizované so zdrojovými zmenami
Funguje lokálne (CLI) alebo v CI (GitHub Actions)
Zverejňuje nástroje pre Markdown, notebooky, obrázky, recenzie a projektové preklady cez MCP
Používa Azure OpenAI alebo OpenAI ako poskytovateľa prekladov
Umožňuje, aby MCP hosťoval agentov, ktorí prekladajú časti Markdownu a notebookov bez poverení LLM Co-op Translatora
Používa Azure AI Vision pre extrakciu textu z obrázkov a jeho preklad
Kontroluje štruktúru a čerstvosť prekladu pomocou deterministických kontrol
Zachováva formátovanie a štruktúru Markdownu

Dokumentácia

Microsoft-špecifický sprievodca

Note

Len pre správcov repozitárov Microsoft “For Beginners”.

Aktualizácia zoznamu „other courses“ (len pre repozitáre MS Beginners)

Podporte nás a podporujte globálne vzdelávanie

Pridajte sa k nám v revolúcii zdieľania vzdelávacieho obsahu po celom svete! Dajte Co-op Translator ⭐ na GitHub-e a podporte našu misiu odbúravať jazykové bariéry vo vzdelávaní a technológiách. Váš záujem a príspevky majú významný dopad! Kódové príspevky a návrhy funkcií sú vždy vítané.

Objavte vzdelávací obsah Microsoftu vo vašom jazyku

Video presentations

👉 Kliknite na obrázok nižšie a pozrite si ho na YouTube.

Open at Microsoft: Krátke 18-minútové predstavenie a rýchly sprievodca, ako používať Co-op Translator.

Contributing

Tento projekt víta príspevky a návrhy. Máte záujem prispieť k Azure Co-op Translator? Pozrite si, prosím, náš CONTRIBUTING.md pre pokyny, ako môžete pomôcť sprístupniť Co-op Translator.

Contributors

Code of Conduct

Tento projekt prijal Microsoft Open Source Code of Conduct. Pre viac informácií si pozrite Code of Conduct FAQ alebo kontaktujte opencode@microsoft.com v prípade ďalších otázok alebo pripomienok.

Responsible AI

Microsoft sa zaväzuje pomáhať našim zákazníkom používať naše AI produkty zodpovedne, zdieľať naše poznatky a budovať partnerstvá založené na dôvere prostredníctvom nástrojov ako Transparency Notes a Impact Assessments. Mnohé z týchto zdrojov nájdete na https://aka.ms/RAI. Prístup Microsoftu k zodpovednej AI je založený na našich princípoch AI: spravodlivosť, spoľahlivosť a bezpečnosť, súkromie a ochrana, inkluzívnosť, transparentnosť a zodpovednosť.

Modely veľkého rozsahu pre prirodzený jazyk, obraz a reč — ako tie použité v tomto príklade — sa môžu potenciálne správať spôsobmi, ktoré sú nespravodlivé, nespolehlivé alebo urážlivé, čo môže spôsobiť škodu. Pre informácie o rizikách a obmedzeniach si pozrite Azure OpenAI service Transparency note.

Odporúčaným prístupom na zmiernenie týchto rizík je zahrnúť do svojej architektúry bezpečnostný systém, ktorý dokáže detegovať a zabrániť škodlivému správaniu. Azure AI Content Safety poskytuje nezávislú ochrannú vrstvu, schopnú detegovať škodlivý obsah vytváraný používateľmi aj AI v aplikáciách a službách. Azure AI Content Safety obsahuje textové a obrazové API, ktoré vám umožnia detegovať materiál, ktorý je škodlivý. Máme tiež interaktívne Content Safety Studio, ktoré vám umožní prezerať, skúmať a vyskúšať vzorový kód na detekciu škodlivého obsahu naprieč rôznymi modalitami. Nasledujúca quickstart dokumentácia vás prevedie, ako robiť požiadavky na službu.

Ďalším aspektom, ktorý treba brať do úvahy, je celkový výkon aplikácie. Pri multimodálnych a viacmodelových aplikáciách považujeme výkon za to, že systém funguje tak, ako vy a vaši používatelia očakávate, vrátane toho, že negeneruje škodlivé výstupy. Je dôležité hodnotiť výkon celej aplikácie pomocou generation quality and risk and safety metrics.

Svoju AI aplikáciu môžete vyhodnotiť vo vývojovom prostredí pomocou prompt flow SDK. S testovacím datasetom alebo cieľom sú generácie vašej generatívnej AI aplikácie kvantitatívne merané pomocou vstavaných evaluátorov alebo vlastných evaluátorov podľa vášho výberu. Ak chcete začať s prompt flow SDK na vyhodnotenie vášho systému, môžete postupovať podľa quickstart guide. Po vykonaní hodnotiaceho behu môžete vizualizovať výsledky v Azure AI Studio.

Trademarks

Tento projekt môže obsahovať ochranné známky alebo logá k projektom, produktom alebo službám. Autorizované použitie obchodných značiek alebo log Microsoftu podlieha a musí byť v súlade s Microsoft's Trademark & Brand Guidelines. Použitie obchodných značiek alebo log Microsoftu v upravených verziách tohto projektu nesmie spôsobovať zmätok alebo naznačovať, že Microsoft projekt sponzoruje. Akékoľvek použitie ochranných známok alebo log tretích strán podlieha pravidlám týchto tretích strán.

Getting Help

Ak sa zaseknete alebo máte otázky týkajúce sa vytvárania AI aplikácií, pripojte sa:

Ak máte spätnú väzbu k produktu alebo sa vyskytli chyby počas vývoja, navštívte:

18 KiB Raw Permalink Blame History