co-op-translator

Logo

Co-op Translator: Automatizirajte prijevod obrazovne dokumentacije bez napora

Lako automatizirajte prijevod svoje dokumentacije na više jezika kako biste dosegli globalnu publiku.

Python package License: MIT Downloads Downloads Code style: black

GitHub contributors GitHub issues GitHub pull-requests PRs Welcome

Podrška za jezike pokreće Co-op Translator

[!NOTE] Ovo su trenutni prijevodi sadržaja ovog repozitorija. Za potpuni popis jezika koje podržava Co-op Translator, pogledajte odjeljak Language Support.

GitHub watchers GitHub forks GitHub stars

Azure AI Community Discord

Open in GitHub Codespaces Open in Dev Containers

Pregled: Pojednostavite Prijevod Vašeg Edukativnog Sadržaja

Jezične barijere znatno otežavaju pristup vrijednim edukativnim materijalima i tehničkom znanju za učenike i developere širom svijeta. To ograničava sudjelovanje i usporava tempo globalnih inovacija i učenja.

Co-op Translator je nastao iz potrebe za rješavanjem neučinkovitog ručnog procesa prevođenja Microsoftovih velikih edukativnih serija (poput vodiča “For Beginners”). Razvio se u jednostavan i moćan alat dizajniran da sruši te barijere za sve. Omogućavajući visokokvalitetne automatske prijevode putem CLI-a i GitHub Actions, Co-op Translator osnažuje edukatore, studente, istraživače i developere širom svijeta da dijele i pristupaju znanju bez jezičnih ograničenja.

Pogledajte kako Co-op Translator organizira prevedeni edukativni sadržaj:

Example

Markdown datoteke i tekst na slikama automatski se prevode i uredno organiziraju u mape specifične za jezik.

Omogućite globalni pristup svom edukativnom sadržaju već danas uz Co-op Translator!

Podrška Globalnom Pristupu Microsoftovim Resursima za Učenje

Co-op Translator pomaže premostiti jezičnu barijeru za ključne Microsoftove edukativne inicijative, automatizirajući proces prevođenja repozitorija koji služe globalnoj zajednici developera. Primjeri koji trenutno koriste Co-op Translator uključuju:

Generative-AI-for-beginners ML-For-Beginners AI-For-Beginners ai-agents-for-beginners PhiCookBook Generative-AI-for-beginners-dotnet

Ključne Značajke

Kako Radi

Architecture

Co-op Translator uzima Markdown datoteke i slike iz vaše projektne mape i obrađuje ih na sljedeći način:

  1. Ekstrakcija Teksta: Izvlači tekst iz Markdown datoteka i, ako je konfigurirano (npr. s Azure AI Vision), tekst ugrađen u slike.
  2. AI Prijevod: Šalje izvučeni tekst na konfigurirani LLM (Azure OpenAI, OpenAI itd.) na prijevod.
  3. Spremanje Rezultata: Sprema prevedene Markdown datoteke i slike (s prevedenim tekstom) u mape specifične za jezik, pritom čuvajući originalni format.

Početak Rada

Započnite brzo s CLI-jem ili postavite potpunu automatizaciju pomoću GitHub Actions. Odaberite pristup koji najbolje odgovara vašem načinu rada:

  1. Command Line (CLI) - Za jednokratne prijevode ili ručnu kontrolu
  2. GitHub Actions - Za automatske prijevode pri svakom pushu

[!NOTE] Iako se ovaj vodič fokusira na Azure resurse, možete koristiti bilo koji podržani jezični model.

Podrška za Jezike

Co-op Translator podržava širok raspon jezika kako biste dosegli globalnu publiku. Evo što trebate znati:

Brzi Pregled

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

Korištenje Kodova Jezika

Kod korištenja Co-op Translatora, potrebno je navesti jezike koristeći njihove kodove. Na primjer:

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

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

[!NOTE] Za detaljne tehničke informacije o podršci jezika, uključujući:

Pogledajte našu Supported Languages Documentation.

Podržani Modeli i Usluge

Tip Naziv
Language Model Azure OpenAI OpenAI
AI Vision Azure AI Vision

[!NOTE] Ako AI vision usluga nije dostupna, co-op translator će preći u Markdown-only mode.

Početna Postavka

Prije nego što počnete, trebate postaviti sljedeće resurse:

  1. Language Model Resource (obavezno):
    • Azure OpenAI (preporučeno) - pruža visokokvalitetne prijevode s pouzdanošću na razini poduzeća
    • OpenAI - alternativa ako nemate pristup Azureu
    • Za detaljne informacije o podržanim modelima, pogledajte Supported Models and Services
  2. AI Vision Resource (opcionalno):
    • Azure AI Vision - omogućuje prijevod teksta unutar slika
    • Ako nije konfigurirano, prevoditelj će automatski koristiti Markdown-only mode
    • Preporučeno za projekte sa slikama koje sadrže tekst koji treba prevesti
  3. Koraci konfiguracije:
    • Slijedite naš Azure AI setup guide za detaljne upute
    • Kreirajte .env datoteku s vašim API ključevima i endpointima (pogledajte odjeljak Quick Start)
    • Provjerite imate li potrebne dozvole i kvote za odabrane usluge

Priprema Projekta Prije Prijevoda

Prije nego što započnete s prijevodom, slijedite ove korake za pripremu projekta:

  1. Pripremite svoj README:
    • Dodajte tablicu prijevoda u README.md za povezivanje prevedenih verzija

    • Primjer formata:

      
### 🌐 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. Očistite postojeće prijevode (ako je potrebno):
    • Uklonite postojeće mape s prijevodima (npr. translations/)
    • Izbrišite stare prijevodne datoteke kako biste započeli svježe
    • Ovo osigurava da nema sukoba s novim procesom prijevoda

Brzi Početak: Command Line

Za brz početak s korištenjem komandne linije:

  1. Kreirajte virtualno okruženje:

     python -m venv .venv

  2. Aktivirajte virtualno okruženje:

    • Na Windowsu:
     .venv\scripts\activate
    • Na Linux/macOS-u:
     source .venv/bin/activate

  3. Instalirajte paket:

     pip install co-op-translator

  4. Konfigurirajte vjerodajnice:

    • Kreirajte .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 zastavicu:
     translate -l "ko ja fr"

    (Zamijenite "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)

2. Using GitHub Actions (Automation)

Rješavanje Problema i Savjeti

Dodatni Resursi

Video Prezentacije

Saznajte više o Co-op Translatoru kroz naše prezentacije (kliknite na sliku ispod za gledanje na YouTubeu):

Podržite nas i potaknite globalno učenje

Pridružite nam se u revoluciji dijeljenja obrazovnog sadržaja širom svijeta! Dajte Co-op Translator ⭐ na GitHubu i podržite našu misiju uklanjanja jezičnih barijera u učenju i tehnologiji. Vaš interes i doprinosi imaju veliki značaj! Kod i prijedlozi za nove značajke su uvijek dobrodošli.

Doprinos

Ovaj projekt rado prima doprinose i prijedloge. Zanima vas doprinos Azure Co-op Translatoru? Molimo pogledajte naš CONTRIBUTING.md za smjernice kako možete pomoći da Co-op Translator postane pristupačniji.

Suradnici

co-op-translator contributors

Kodeks ponašanja

Ovaj projekt usvojio je Microsoft Open Source Code of Conduct. Za više informacija pogledajte Code of Conduct FAQ ili kontaktirajte opencode@microsoft.com za dodatna pitanja ili komentare.

Odgovorni AI

Microsoft je posvećen pomaganju korisnicima da odgovorno koriste naše AI proizvode, dijeleći svoja saznanja i gradeći partnerstva temeljena na povjerenju kroz alate poput Transparency Notes i Impact Assessments. Mnoge od ovih resursa možete pronaći na https://aka.ms/RAI. Microsoftov pristup odgovornom AI temelji se na našim AI načelima pravednosti, pouzdanosti i sigurnosti, privatnosti i sigurnosti, uključivosti, transparentnosti i odgovornosti.

Veliki modeli za prirodni jezik, slike i govor - poput onih korištenih u ovom primjeru - mogu se potencijalno ponašati na nepravedan, nepouzdan ili uvredljiv način, što može uzrokovati štetu. Molimo konzultirajte Azure OpenAI service Transparency note kako biste bili informirani o rizicima i ograničenjima.

Preporučeni pristup ublažavanju ovih rizika je uključivanje sigurnosnog sustava u vašu arhitekturu koji može otkriti i spriječiti štetno ponašanje. Azure AI Content Safety pruža neovisni sloj zaštite, sposoban otkriti štetni sadržaj generiran od korisnika i AI-ja u aplikacijama i uslugama. Azure AI Content Safety uključuje tekstualne i slikovne API-je koji vam omogućuju otkrivanje štetnog materijala. Također imamo interaktivni Content Safety Studio koji vam omogućuje pregled, istraživanje i isprobavanje primjera koda za otkrivanje štetnog sadržaja u različitim modalitetima. Sljedeća quickstart dokumentacija vodi vas kroz slanje zahtjeva servisu.

Još jedan aspekt koji treba uzeti u obzir je ukupna izvedba aplikacije. Kod višemodalnih i višemodelskih aplikacija, izvedba znači da sustav radi onako kako vi i vaši korisnici očekujete, uključujući i ne generiranje štetnih rezultata. Važno je procijeniti izvedbu vaše aplikacije koristeći generacijske kvalitete i metrike rizika i sigurnosti.

Možete ocijeniti svoju AI aplikaciju u razvojnom okruženju koristeći prompt flow SDK. Bilo s testnim skupom podataka ili ciljem, generacije vaše generativne AI aplikacije kvantitativno se mjere ugrađenim ili prilagođenim evaluatorima po vašem izboru. Za početak s prompt flow sdk za evaluaciju vašeg sustava, možete slijediti quickstart vodič. Nakon izvršavanja evaluacije, možete vizualizirati rezultate u Azure AI Studio.

Zaštićeni znakovi

Ovaj projekt može sadržavati zaštitne znakove ili logotipe za projekte, proizvode ili usluge. Ovlaštena upotreba Microsoftovih zaštićenih znakova ili logotipa podliježe i mora slijediti Microsoftove smjernice za zaštitne znakove i brendiranje. Upotreba Microsoftovih zaštićenih znakova ili logotipa u izmijenjenim verzijama ovog projekta ne smije izazvati zabunu niti sugerirati Microsoftovu sponzorstvo. Svaka upotreba zaštitnih znakova ili logotipa trećih strana podliježe pravilima tih trećih strana.

Odricanje od odgovornosti:
Ovaj dokument preveden je korištenjem AI usluge za prevođenje Co-op Translator. Iako težimo točnosti, imajte na umu da automatski prijevodi mogu sadržavati pogreške ili netočnosti. Izvorni dokument na izvornom jeziku treba smatrati autoritativnim izvorom. Za kritične informacije preporučuje se profesionalni ljudski prijevod. Ne snosimo odgovornost za bilo kakva nesporazumevanja ili pogrešne interpretacije koje proizlaze iz korištenja ovog prijevoda.

This site is open source. Improve this page.