co-op-translator

Co-op Translator: Automatizujte preklad vzdelávacej dokumentácie bez námahy

Ľahko automatizujte preklad vašej dokumentácie do viacerých jazykov a oslovte tak globálne publikum.

Podpora jazykov poháňaná Co-op Translatorom

Francúzština | Španielčina | Nemčina | Ruština | Arabčina | Perzština (Farsi) | Urdu | Čínština (zjednodušená) | Čínština (tradičná, Macau) | Čínština (tradičná, Hongkong) | Čínština (tradičná, Taiwan) | Japončina | Kórejčina | Hindčina | Bengálčina | Maráthčina | Nepálčina | Pandžábčina (Gurmukhi) | Portugalčina (Portugalsko) | Portugalčina (Brazília) | Taliančina | Poľština | Turečtina | Gréčtina | Thajčina | Švédčina | Dánčina | Nórčina | Fínčina | Holandčina | Hebrejčina | Vietnamčina | Indonézština | Malajčina | Tagalog (Filipínčina) | Svahilčina | Maďarčina | Čeština | Slovenčina | Rumunčina | Bulharčina | Srbčina (cyrilika) | Chorvátčina | Slovinčina | Ukrajinčina | Barmčina (Myanmar)

[!NOTE] Toto sú aktuálne preklady obsahu tohto repozitára. Kompletný zoznam jazykov podporovaných Co-op Translator nájdete v sekcii Language Support.

Prehľad: Zjednodušte preklad svojho vzdelávacieho obsahu

Jazykové bariéry výrazne obmedzujú prístup k hodnotným vzdelávacím zdrojom a technickým poznatkom pre študentov a vývojárov po celom svete. To obmedzuje účasť a spomaľuje tempo globálnych inovácií a učenia sa.

Co-op Translator vznikol ako odpoveď na neefektívny manuálny preklad veľkých vzdelávacích sérií Microsoftu (napríklad príručky „For Beginners“). Vyvinul sa do ľahko použiteľného a výkonného nástroja, ktorý prelomí tieto bariéry pre každého. Poskytovaním kvalitných automatických prekladov cez CLI a GitHub Actions umožňuje Co-op Translator pedagógom, študentom, výskumníkom a vývojárom po celom svete zdieľať a získavať vedomosti bez jazykových obmedzení.

Pozrite sa, ako Co-op Translator organizuje preložený vzdelávací obsah:

Markdown súbory a texty na obrázkoch sa automaticky prekladajú a prehľadne ukladajú do jazykovo špecifických priečinkov.

Odomknite globálny prístup k vášmu vzdelávaciemu obsahu s Co-op Translator už dnes!

Podpora globálneho prístupu ku vzdelávacím zdrojom Microsoftu

Co-op Translator pomáha preklenúť jazykovú priepasť pre kľúčové vzdelávacie iniciatívy Microsoftu tým, že automatizuje prekladový proces pre repozitáre slúžiace globálnej komunite vývojárov. Príklady projektov, ktoré aktuálne využívajú Co-op Translator:

Kľúčové vlastnosti

• Automatizované preklady: Jednoducho prekladajte text do viacerých jazykov.
• Integrácia s GitHub Actions: Automatizujte preklady ako súčasť vášho CI/CD procesu.
• Zachovanie Markdown syntaxe: Počas prekladu sa správne zachováva Markdown formátovanie.
• Preklad textu na obrázkoch: Extrahujte a prekladajte text obsiahnutý v obrázkoch.
• Pokročilá LLM technológia: Využite najmodernejšie jazykové modely pre kvalitné preklady.
• Jednoduchá integrácia: Bezproblémovo sa zapojí do vášho existujúceho projektu.
• Zjednodušenie lokalizácie: Uľahčite proces lokalizácie vášho projektu pre medzinárodné trhy.

Ako to funguje

Co-op Translator spracováva Markdown súbory a obrázky z vášho projektového priečinka nasledovne:

1. Extrahovanie textu: Vyťahuje text z Markdown súborov a, ak je nakonfigurované (napr. s Azure AI Vision), aj text vložený v obrázkoch.
2. AI preklad: Posiela extrahovaný text do zvoleného LLM (Azure OpenAI, OpenAI a pod.) na preklad.
3. Ukladanie výsledkov: Ukladá preložené Markdown súbory a obrázky (s preloženým textom) do jazykovo špecifických priečinkov, pričom zachováva pôvodné formátovanie.

Začíname

Rýchlo začnite pomocou CLI alebo nastavte plnú automatizáciu s GitHub Actions. Vyberte si spôsob, ktorý najlepšie vyhovuje vášmu workflow:

1. Príkazový riadok (CLI) – pre jednorazové preklady alebo manuálnu kontrolu
2. GitHub Actions – pre automatizované preklady pri každom pushi

[!NOTE] Aj keď sa tento tutoriál zameriava na Azure zdroje, môžete použiť akýkoľvek podporovaný jazykový model.

Podpora jazykov

Co-op Translator podporuje širokú škálu jazykov, aby ste mohli osloviť globálne publikum. Tu sú základné informácie:

Rýchla referencia

Jazyk	Kód	Jazyk	Kód	Jazyk	Kód
Arabčina	ar	Bengalčina	bn	Bulharčina	bg
Barmský (Myanmar)	my	Čínština (zjednodušená)	zh	Čínština (tradičná, HK)	hk
Čínština (tradičná, Macau)	mo	Čínština (tradičná, TW)	tw	Chorvátčina	hr
Čeština	cs	Dánčina	da	Holandčina	nl
Fínčina	fi	Francúzština	fr	Nemčina	de
Gréčtina	el	Hebrejčina	he	Hindčina	hi
Maďarčina	hu	Indonézština	id	Taliančina	it
Japončina	ja	Kórejčina	ko	Malajčina	ms
Maráthčina	mr	Nepálčina	ne	Norčina	no
Perzština (Farsi)	fa	Poľština	pl	Portugalčina (Brazília)	br
Portugalčina (Portugalsko)	pt	Pandžábčina (Gurmukhi)	pa	Rumunčina	ro
Ruština	ru	Srbčina (cyrilika)	sr	Slovenčina	sk
Slovinčina	sl	Španielčina	es	Svahilčina	sw
Švédčina	sv	Tagalog (Filipínčina)	tl	Thajčina	th
Turečtina	tr	Ukrajinčina	uk	Urdu	ur
Vietnamčina	vi	—	—	—	—

Použitie jazykových kódov

Pri používaní Co-op Translator je potrebné špecifikovať jazyky pomocou ich kódov. Napríklad:

# Translate to French, Spanish, and German
translate -l "fr es de"

# Translate to Chinese (Simplified) and Japanese
translate -l "zh ja"

[!NOTE] Pre podrobné technické informácie o podpore jazykov, vrátane:

• Špecifikácií fontov pre jednotlivé jazyky
• Známych problémov
• Ako pridať nové jazyky

Pozrite si našu dokumentáciu Supported Languages Documentation.

Podporované modely a služby

Typ	Názov
Jazykový model
AI Vision

[!NOTE] Ak služba AI vision nie je dostupná, co-op translator automaticky prejde do Markdown-only režimu.

Počiatočné nastavenie

Pred začiatkom si pripravte tieto zdroje:

1. Jazykový model (povinné):
   • Azure OpenAI (odporúčané) – poskytuje kvalitné preklady s podnikovou spoľahlivosťou
   • OpenAI – alternatíva, ak nemáte prístup k Azure
   • Podrobnosti o podporovaných modeloch nájdete v sekcii Supported Models and Services
2. AI Vision (voliteľné):
   • Azure AI Vision – umožňuje preklad textu na obrázkoch
   • Ak nie je nakonfigurované, prekladač automaticky použije Markdown-only režim
   • Odporúčané pre projekty s obrázkami obsahujúcimi text na preklad
3. Konfiguračné kroky:
   • Postupujte podľa návodu Azure AI setup guide
   • Vytvorte .env súbor s API kľúčmi a endpointmi (pozri sekciu Quick Start)
   • Uistite sa, že máte potrebné oprávnenia a kvóty pre zvolené služby

Príprava projektu pred prekladom

Pred začatím prekladu vykonajte tieto kroky:

1. Pripravte README:
   • Pridajte do README.md tabuľku s prekladmi, ktorá bude odkazovať na preložené verzie

   • Príklad formátu:

     
     ### 🌐 Multi-Language Support
          
     [French](/co-op-translator/translations/fr/) | [Spanish](/co-op-translator/translations/es/) | [German](/co-op-translator/translations/de/) | [Russian](/co-op-translator/translations/ru/) | [Arabic](/co-op-translator/translations/ar/) | [Persian (Farsi)](/co-op-translator/translations/fa/) | [Urdu](/co-op-translator/translations/ur/) | [Chinese (Simplified)](/co-op-translator/translations/zh/) | [Chinese (Traditional, Macau)](/co-op-translator/translations/mo/) | [Chinese (Traditional, Hong Kong)](/co-op-translator/translations/hk/) | [Chinese (Traditional, Taiwan)](/co-op-translator/translations/tw/) | [Japanese](/co-op-translator/translations/ja/) | [Korean](/co-op-translator/translations/ko/) | [Hindi](/co-op-translator/translations/hi/) | [Bengali](/co-op-translator/translations/bn/) | [Marathi](/co-op-translator/translations/mr/) | [Nepali](/co-op-translator/translations/ne/) | [Punjabi (Gurmukhi)](/co-op-translator/translations/pa/) | [Portuguese (Portugal)](/co-op-translator/translations/pt/) | [Portuguese (Brazil)](/co-op-translator/translations/br/) | [Italian](/co-op-translator/translations/it/) | [Polish](/co-op-translator/translations/pl/) | [Turkish](/co-op-translator/translations/tr/) | [Greek](/co-op-translator/translations/el/) | [Thai](/co-op-translator/translations/th/) | [Swedish](/co-op-translator/translations/sv/) | [Danish](/co-op-translator/translations/da/) | [Norwegian](/co-op-translator/translations/no/) | [Finnish](/co-op-translator/translations/fi/) | [Dutch](/co-op-translator/translations/nl/) | [Hebrew](/co-op-translator/translations/he/) | [Vietnamese](/co-op-translator/translations/vi/) | [Indonesian](/co-op-translator/translations/id/) | [Malay](/co-op-translator/translations/ms/) | [Tagalog (Filipino)](/co-op-translator/translations/tl/) | [Swahili](/co-op-translator/translations/sw/) | [Hungarian](/co-op-translator/translations/hu/) | [Czech](/co-op-translator/translations/cs/) | [Slovak](/co-op-translator/translations/sk/) | [Romanian](/co-op-translator/translations/ro/) | [Bulgarian](/co-op-translator/translations/bg/) | [Serbian (Cyrillic)](/co-op-translator/translations/sr/) | [Croatian](/co-op-translator/translations/hr/) | [Slovenian](/co-op-translator/translations/sl/) | [Ukrainian](/co-op-translator/translations/uk/) | [Burmese (Myanmar)](/co-op-translator/translations/my/) 
         
     

2. Vyčistite existujúce preklady (ak je potrebné):
   • Odstráňte existujúce priečinky s prekladmi (napr. translations/)
   • Vymažte staré prekladové súbory, aby ste začali na čistom
   • Tým zabránite konfliktom s novým prekladovým procesom

Rýchly štart: Príkazový riadok

Pre rýchly štart s príkazovým riadkom:

1. Vytvorte virtuálne prostredie:

    python -m venv .venv
   

2. Aktivujte virtuálne prostredie:

   • Na Windows:

    .venv\scripts\activate
   

   • Na Linux/macOS:

    source .venv/bin/activate
   

3. Nainštalujte balík:

    pip install co-op-translator
   

4. Nakonfigurujte poverenia:

   • Vytvorte .env file in your project’s root directory.
   • Copy the contents from the .env.template file into your new .env file.
   • Fill in the required API keys and endpoint information in your .env file.

5. Run Translation:

   • Navigate to your project’s root directory in your terminal.
   • Execute the translate command, specifying target languages with the -l flag:

    translate -l "ko ja fr"
   

(Nahraďte "ko ja fr" with your desired space-separated language codes)

Detailed Usage Guides

Choose the approach that best fits your workflow:

1. Using the Command Line (CLI)

• Best for: One-time translations, manual control, or integration into custom scripts.
• Requires: Local installation of Python and the co-op-translator package.
• Guide: Command Line Guide

2. Using GitHub Actions (Automation)

• Best for: Automatically translating content whenever changes are pushed to your repository. Keeps translations consistently up-to-date.
• Requires: Setting up a workflow file (.github/workflows) vo vašom repozitári. Lokálna inštalácia nie je potrebná.
• Návody:
  • GitHub Actions Guide (verejné repozitáre & štandardné tajomstvá) – použite pre väčšinu verejných alebo osobných repozitárov, ktoré využívajú štandardné repozitárne tajomstvá.
  • GitHub Actions Guide (Microsoft organizácia & nastavenia na úrovni organizácie) – použite, ak pracujete v rámci Microsoft GitHub organizácie alebo potrebujete využívať tajomstvá či bežcov na úrovni organizácie.

Riešenie problémov a tipy

• Troubleshooting Guide

Ďalšie zdroje

• Command Reference: Podrobný prehľad všetkých dostupných príkazov a možností.
• Supported Languages: Zoznam podporovaných jazykov a návod na pridávanie nových.
• Markdown-Only Mode: Ako prekladať iba text bez prekladu obrázkov.

Video prezentácie

Zoznámte sa s Co-op Translator prostredníctvom našich prezentácií (kliknite na obrázok nižšie pre prehranie na YouTube):

• Open at Microsoft: Krátke 18-minútové predstavenie a rýchly návod na používanie Co-op Translator.

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 GitHube a podporte našu misiu prekonávať jazykové bariéry vo vzdelávaní a technológiách. Váš záujem a príspevky majú veľký význam! Kódové príspevky a návrhy na funkcie sú vždy vítané.

Príspevky

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

Prispievatelia

Kódex správania

Tento projekt prijal Microsoft Open Source Code of Conduct. Pre viac informácií si pozrite Code of Conduct FAQ alebo kontaktujte opencode@microsoft.com s ďalšími otázkami alebo pripomienkami.

Zodpovedná AI

Microsoft sa zaväzuje pomáhať svojim zákazníkom používať naše AI produkty zodpovedne, zdieľať naše poznatky a budovať dôveru 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 bezpečnosť, inkluzívnosť, transparentnosť a zodpovednosť.

Veľké modely pre spracovanie prirodzeného jazyka, obrazu a reči – ako tie použité v tomto príklade – môžu potenciálne vykazovať nespravodlivé, nespoľahlivé alebo urážlivé správanie, čo môže spôsobiť škody. Pre informácie o rizikách a obmedzeniach si prosím prečítajte Azure OpenAI service Transparency note.

Odporúčaný prístup na zmiernenie týchto rizík je zahrnúť do vašej architektúry bezpečnostný systém, ktorý dokáže detekovať a zabrániť škodlivému správaniu. Azure AI Content Safety poskytuje nezávislú vrstvu ochrany, schopnú detegovať škodlivý obsah vytvorený 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ú detegovať škodlivý materiál. Máme tiež interaktívne Content Safety Studio, kde si môžete prezrieť, preskúmať a vyskúšať ukážkový kód na detekciu škodlivého obsahu v rôznych formátoch. Nasledujúca rýchla dokumentácia vás prevedie tým, ako robiť požiadavky na službu.

Ďalším aspektom, ktorý treba zvážiť, je celkový výkon aplikácie. Pri multimodálnych a multimodelových aplikáciách považujeme výkon za to, že systém funguje 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.

Svoju AI aplikáciu môžete vyhodnotiť vo vývojovom prostredí pomocou prompt flow SDK. Na základe testovacej dátovej sady alebo cieľa sú generácie vašej generatívnej AI aplikácie kvantitatívne merané pomocou vstavaných alebo vlastných hodnotiacich nástrojov podľa vášho výberu. Ak chcete začať s prompt flow sdk na vyhodnotenie vášho systému, môžete sledovať rýchly návod. Po spustení hodnotiaceho behu môžete zobraziť 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ť Microsoft’s Trademark & Brand Guidelines. 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 Microsoftom. Použitie ochranných známok alebo log tretích strán podlieha pravidlám týchto tretích strán.

Vyhlásenie o zodpovednosti:
Tento dokument bol preložený pomocou AI prekladateľskej služby Co-op Translator. Hoci sa snažíme o presnosť, vezmite prosím na vedomie, že automatizované preklady môžu obsahovať chyby alebo nepresnosti. Originálny dokument v jeho pôvodnom jazyku by mal byť považovaný za autoritatívny zdroj. Pre dôležité 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žitia tohto prekladu.

This site is open source. Improve this page.