Skip to content

Latest commit

 

History

History
249 lines (177 loc) · 16.7 KB

File metadata and controls

249 lines (177 loc) · 16.7 KB

Co-op Translator

Ľahko automatizujte a udržiavajte preklady vášho vzdelávacieho obsahu na GitHub v rôznych jazykoch počas vývoja vášho projektu.

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

🌐 Podpora viacerých jazykov

Podporované Co-op Translator

Arabic | Bengali | Bulgarian | Burmese (Myanmar) | Chinese (Simplified) | Chinese (Traditional, Hong Kong) | Chinese (Traditional, Macau) | Chinese (Traditional, Taiwan) | Croatian | Czech | Danish | Dutch | Estonian | Finnish | French | German | Greek | Hebrew | Hindi | Hungarian | Indonesian | Italian | Japanese | Kannada | Khmer | Korean | Lithuanian | Malay | Malayalam | Marathi | Nepali | Nigerian Pidgin | Norwegian | Persian (Farsi) | Polish | Portuguese (Brazil) | Portuguese (Portugal) | Punjabi (Gurmukhi) | Romanian | Russian | Serbian (Cyrillic) | Slovak | Slovenian | Spanish | Swahili | Swedish | Tagalog (Filipino) | Tamil | Telugu | Thai | Turkish | Ukrainian | Urdu | Vietnamese

Preferujete klonovanie lokálne?

Toto repozitár obsahuje viac ako 50 jazykových prekladov, čo výrazne zvyšuje veľkosť stiahnutia. 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"

Takto získate všetko potrebné pre dokončenie kurzu s oveľa rýchlejším stiahnutím.

GitHub watchers GitHub forks GitHub stars

Microsoft Foundry Discord

Open in GitHub Codespaces

Prehľad

Co-op Translator vám pomáha jednoducho lokalizovať váš vzdelávací obsah na GitHub do viacerých jazykov.
Keď aktualizujete svoje Markdown súbory, obrázky alebo poznámkové bloky, preklady zostávajú automaticky synchronizované, aby bol váš obsah presný a aktuálny pre študentov po celom svete.

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

Example

Ako sa spravuje stav prekladu

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

Nástroj sleduje stav preložených Markdown súborov, obrázkov a poznámkových blokov
pomocou metaúdajov viazaných na jazyk.

Tento dizajn umožňuje Co-op Translator-u:

  • Spoľahlivo odhaliť zastarané preklady
  • Konzistentne spracovávať Markdown, obrázky a poznámkové bloky
  • Bezpečne škálovať vo veľkých, rýchlo sa meniacich multi-jazykových repozitároch

Modelovaním prekladov ako spravovaných artefaktov
sú pracovné postupy prekladu prirodzene zosúladené s modernými
praktikami správy softvérových závislostí a artefaktov.

Ako sa spravuje stav prekladu

Rýchly štart

# Vytvorte a aktivujte virtuálne prostredie (odporúčané)
python -m venv .venv
# Windows
.venv\Scripts\activate
# macOS/Linux
source .venv/bin/activate
# Nainštalujte balík
pip install co-op-translator
# Preložiť
translate -l "ko ja fr" -md

Docker:

# Stiahnuť verejný obraz z GHCR
docker pull ghcr.io/azure/co-op-translator:latest
# Spustiť s pripojenou aktuálnou zložkou a poskytnutým súborom .env (Bash/Zsh)
docker run --rm -it --env-file .env -v "${PWD}:/work" ghcr.io/azure/co-op-translator:latest -l "ko ja fr" -md

Minimálne nastavenie

  1. Uistite sa, že máte podporovanú verziu Pythonu (momentálne 3.10-3.12). V poetry (pyproject.toml) je to riešené automaticky.
  2. Vytvorte súbor .env podľa šablóny: .env.template
  3. Nakonfigurujte jedného poskytovateľa LLM (Azure OpenAI alebo OpenAI)
  4. (Voliteľné) Pre preklad obrázkov (-img) nakonfigurujte Azure AI Vision
  5. (Voliteľné) Môžete konfigurovať viacero sád prihlasovacích údajov duplikovaním premenných s príponami ako _1, _2 atď. Všetky premenne v sade musia mať rovnakú príponu.
  6. (Odporúčané) Vyčistite predchádzajúce preklady, aby ste sa vyhli konfliktom (napr. translations/)
  7. (Odporúčané) Pridajte sekciu o preklade do vášho README podľa README languages template
  8. Pozrite: Nastavenie Azure AI

Použitie

Preložte všetky podporované typy:

translate -l "ko ja"

Len Markdown:

translate -l "de" -md

Markdown + obrázky:

translate -l "pt" -md -img

Len poznámkové bloky:

translate -l "zh" -nb

Viac príznakov: Referenčný manuál príkazov

Funkcie

  • Automatizovaný preklad Markdown, poznámkových blokov a obrázkov
  • Udržiava preklady synchronizované so zdrojovými zmenami
  • Funguje lokálne (CLI) alebo v CI (GitHub Actions)
  • Používa Azure OpenAI alebo OpenAI; voliteľne Azure AI Vision pre obrázky
  • Zachováva formátovanie a štruktúru Markdown

Dokumentácia

Microsoft špecifická príručka

Note

Len pre správcov repozitárov Microsoft "For Beginners".

Podporte nás a napomôžte globálnemu vzdelávaniu

Pridajte sa k nám v revolúcii spôsobu, akým sa vzdelávací obsah zdieľa globálne! Dajte Co-op Translator ⭐ na GitHub a podporte našu misiu rozbiť jazykové bariéry vo vzdelávaní a technológiách. Vaša angažovanosť a príspevky majú veľký význam! Kódové príspevky a návrhy funkcií sú vždy vítané.

Preskúmajte vzdelávací obsah Microsoft vo vašom jazyku

Video prezentácie

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

  • Open at Microsoft: Krátka 18-minútová úvodná prezentácia a rýchly návod, ako používať Co-op Translator.

    Open at Microsoft

Kontribúcia

Tento projekt vítá príspevky a návrhy. Zaujíma vás prispievanie do Azure Co-op Translator? Pozrite si prosím náš CONTRIBUTING.md, kde nájdete smernice, ako môžete pomôcť sprístupniť Co-op Translator širšej verejnosti.

Prispievatelia

co-op-translator contributors

Kód správania

Tento projekt prijal Microsoft Open Source Kód správania. Pre viac informácií pozri Často kladené otázky kódu správania alebo kontaktujte opencode@microsoft.com s akýmikoľvek ďalšími otázkami alebo pripomienkami.

Zodpovedná AI

Microsoft sa zaväzuje pomáhať našim zákazníkom zodpovedne používať naše AI produkty, zdieľať naše poznatky a budovať dôveryhodné partnerstvá prostredníctvom nástrojov, ako sú Poznámky o transparentnosti a Hodnotenia dopadov. Mnohé z týchto zdrojov nájdete na https://aka.ms/RAI. Prístup Microsoftu k zodpovednej AI vychádza z našich princípov AI spravodlivosti, spoľahlivosti a bezpečnosti, ochrany súkromia a zabezpečenia, inkluzívnosti, transparentnosti a zodpovednosti.

Veľkorozsahové modely prírodného jazyka, obrazu a reči – ako tie použité v tomto príklade – sa potenciálne môžu správať nespravodlivo, nespoľahlivo alebo urážlivo, čo môže viesť k škodám. Informujte sa o rizikách a obmedzeniach v Poznámke o transparentnosti služby Azure OpenAI.

Odporúčaný prístup na zmiernenie týchto rizík je zahrnúť do vašej 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 zahŕňa textové a obrazové API, ktoré umožňujú detekciu škodlivého materiálu. Tiež máme interaktívne Content Safety Studio, ktoré vám umožní zobraziť, preskúmať a otestovať ukážkové kódy na detekciu škodlivého obsahu v rôznych modalitách. Nasledujúca rýchla dokumentácia vás prevedie tým, ako komunikovať so službou.

Ďalším aspektom, ktorý treba vziať do úvahy, je celkový výkon aplikácie. Pri multi-modálnych a multi-modelových aplikáciách považujeme výkon za schopnosť systému pracovať tak, ako očakávate vy a vaši používatelia, vrátane toho, že nevytvára škodlivé výstupy. Je dôležité vyhodnotiť výkon vašej aplikácie pomocou metrik kvality generovania a rizika a bezpečnosti.

Vašu AI aplikáciu môžete vyhodnocovať vo vašom vývojovom prostredí pomocou prompt flow SDK. Na základe testovacej dátovej sady alebo cieľa sú vaše generatívne AI výstupy kvantitatívne merané pomocou zabudovaných alebo vlastných hodnotiacich nástrojov podľa vášho výberu. Na začiatok s prompt flow sdk na vyhodnocovanie vášho systému môžete použiť rýchleho sprievodcu. Po vykonaní vyhodnotenia môžete vizualizovať výsledky v Azure AI Studio.

Ochranné známky

Tento projekt môže obsahovať ochranné známky alebo logá projektov, produktov alebo služieb. Autorizované použitie ochranných známok alebo log Microsoftu podlieha a musí dodržiavať Pravidlá používania ochranných známok a značiek Microsoftu. Použitie ochranných známok alebo log Microsoftu v upravených verziách tohto projektu nesmie spôsobovať zmätok ani naznačovať sponzorstvo spoločnosťou Microsoft. Akékoľvek použitie ochranných známok alebo log tretích strán podlieha zásadám týchto tretích strán.

Získanie pomoci

Ak sa zaseknete alebo máte otázky ohľadom budovania AI aplikácií, pridajte sa:

Microsoft Foundry Discord

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

Microsoft Foundry Developer Forum


Zrieknutie sa zodpovednosti: Tento dokument bol preložený pomocou AI prekladačskej služby Co-op Translator. Aj keď sa usilujeme o presnosť, majte prosím na pamäti, že automatické preklady môžu obsahovať chyby alebo nepresnosti. Pôvodný dokument v jeho rodnom jazyku by mal byť považovaný za autoritatívny zdroj. Pre kritické informácie sa odporúča profesionálny ľudský preklad. Nie sme zodpovední za akékoľvek nedorozumenia alebo nesprávne výklady vyplývajúce z používania tohto prekladu.