co-op-translator

Logo

Co-op Translator: Z lahkoto avtomatizirajte prevajanje izobraževalne dokumentacije

Preprosto avtomatizirajte prevajanje vaše dokumentacije v več jezikov, da dosežete globalno občinstvo.

Python package License: MIT Downloads Downloads Code style: black

GitHub contributors GitHub issues GitHub pull-requests PRs Welcome

Podpora jezikom, ki jo omogoča Co-op Translator

[!NOTE] Ti so trenutni prevodi vsebine tega repozitorija. Za celoten seznam jezikov, ki jih podpira Co-op Translator, si oglejte razdelek Language Support.

GitHub watchers GitHub forks GitHub stars

Azure AI Community Discord

Open in GitHub Codespaces Open in Dev Containers

Pregled: Poenostavite prevajanje vaših izobraževalnih vsebin

Jezikovne ovire močno omejujejo dostop do dragocenih izobraževalnih virov in tehničnega znanja za učence in razvijalce po vsem svetu. To omejuje sodelovanje in upočasnjuje globalno inovacijo ter učenje.

Co-op Translator je nastal iz potrebe po učinkovitejšem postopku prevajanja za Microsoftove obsežne izobraževalne serije (kot so vodiči “For Beginners”). Razvil se je v enostavno in zmogljivo orodje, ki razbija te ovire za vse. Z zagotavljanjem kakovostnih avtomatiziranih prevodov prek CLI in GitHub Actions Co-op Translator omogoča izobraževalcem, študentom, raziskovalcem in razvijalcem po svetu, da delijo in dostopajo do znanja brez jezikovnih omejitev.

Oglejte si, kako Co-op Translator organizira prevedene izobraževalne vsebine:

Example

Markdown datoteke in besedilo na slikah se samodejno prevajajo in lepo razvrstijo v mape po jezikih.

Odprite globalni dostop do svojih izobraževalnih vsebin z Co-op Translator že danes!

Podpora globalnemu dostopu do Microsoftovih učnih virov

Co-op Translator pomaga premostiti jezikovne ovire za ključne Microsoftove izobraževalne pobude in avtomatizira prevajanje repozitorijev, ki služijo globalni skupnosti razvijalcev. Primeri, ki trenutno uporabljajo Co-op Translator:

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

Ključne funkcije

Kako deluje

Architecture

Co-op Translator vzame Markdown datoteke in slike iz vaše projektne mape ter jih obdela tako:

  1. Izvleček besedila: Izvleče besedilo iz Markdown datotek in, če je konfigurirano (npr. z Azure AI Vision), tudi besedilo znotraj slik.
  2. AI prevajanje: Pošlje izvlečeno besedilo konfiguriranemu LLM-ju (Azure OpenAI, OpenAI itd.) v prevod.
  3. Shranjevanje rezultatov: Shrani prevedene Markdown datoteke in slike (s prevedenim besedilom) v mape po jezikih, pri čemer ohrani izvirno oblikovanje.

Začnite

Hitro začnite z uporabo CLI ali nastavite popolno avtomatizacijo z GitHub Actions. Izberite način, ki vam najbolj ustreza:

  1. Ukazna vrstica (CLI) – za enkratne prevode ali ročni nadzor
  2. GitHub Actions – za avtomatske prevode ob vsakem pushu

[!NOTE] Čeprav se ta vodič osredotoča na Azure vire, lahko uporabite kateri koli podprt jezikovni model.

Podpora jezikov

Co-op Translator podpira širok nabor jezikov, da dosežete globalno občinstvo. Tukaj je nekaj osnovnih informacij:

Hiter pregled

Jezik Koda Jezik Koda Jezik Koda
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 — — — —

Uporaba jezikovnih kod

Pri uporabi Co-op Translator morate jezike določiti z njihovimi kodami. Na primer:

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

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

[!NOTE] Za podrobne tehnične informacije o podpori jezikov, vključno z:

si oglejte našo dokumentacijo o podprtih jezikih.

Podprti modeli in storitve

Tip Ime
Jezikovni model Azure OpenAI OpenAI
AI Vision Azure AI Vision

[!NOTE] Če AI vision storitev ni na voljo, bo co-op translator preklopil v Markdown-only način.

Začetna nastavitev

Preden začnete, nastavite naslednje vire:

  1. Jezikovni model (obvezen):
    • Azure OpenAI (priporočeno) – zagotavlja kakovostne prevode z zanesljivostjo na ravni podjetja
    • OpenAI – alternativa, če nimate dostopa do Azure
    • Za podrobnosti o podprtih modelih glejte Supported Models and Services
  2. AI Vision (opcijsko):
    • Azure AI Vision – omogoča prevajanje besedila na slikah
    • Če ni konfigurirano, bo prevajalnik samodejno uporabil Markdown-only način
    • Priporočeno za projekte s slikami, ki vsebujejo besedilo za prevod
  3. Koraki konfiguracije:
    • Sledite našemu vodniku za nastavitev Azure AI za podrobna navodila
    • Ustvarite .env datoteko z vašimi API ključi in končnimi točkami (glejte razdelek Quick Start)
    • Poskrbite, da imate potrebna dovoljenja in kvote za izbrane storitve

Priprava projekta pred prevajanjem

Pred začetkom prevajanja pripravite svoj projekt tako:

  1. Pripravite README:
    • Dodajte tabelo prevodov v README.md, ki povezuje na prevedene različice

    • Primer oblikovanja:

      
### 🌐 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. Počistite obstoječe prevode (če je potrebno):
    • Odstranite obstoječe mape s prevodi (npr. translations/)
    • Izbrišite stare prevodne datoteke, da začnete znova
    • Tako preprečite konflikte z novim prevajalskim postopkom

Hiter začetek: Ukazna vrstica

Za hiter začetek z ukazno vrstico:

  1. Ustvarite virtualno okolje:

     python -m venv .venv

  2. Aktivirajte virtualno okolje:

    • Na Windows:
     .venv\scripts\activate
    • Na Linux/macOS:
     source .venv/bin/activate

  3. Namestite paket:

     pip install co-op-translator

  4. Nastavite poverilnice:

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

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

Reševanje težav in nasveti

Dodatni viri

Video predstavitve

Spoznajte Co-op Translator skozi naše predstavitve (kliknite na sliko spodaj za ogled na YouTube):

Podprite nas in spodbujajte globalno učenje

Pridružite se nam pri revoluciji deljenja izobraževalnih vsebin po celem svetu! Dajte Co-op Translator ⭐ na GitHubu in podprite našo misijo odstranjevanja jezikovnih ovir pri učenju in tehnologiji. Vaše zanimanje in prispevki imajo velik vpliv! Prispevki kode in predlogi za nove funkcije so vedno dobrodošli.

Prispevanje

Ta projekt sprejema prispevke in predloge. Vas zanima prispevati k Azure Co-op Translatorju? Oglejte si naš CONTRIBUTING.md za navodila, kako lahko pomagate narediti Co-op Translator bolj dostopen.

Prispevalci

co-op-translator contributors

Kodeks ravnanja

Ta projekt je sprejel Microsoft Open Source Code of Conduct. Za več informacij si oglejte Code of Conduct FAQ ali kontaktirajte opencode@microsoft.com za dodatna vprašanja ali komentarje.

Odgovorna umetna inteligenca

Microsoft se zavezuje, da bo pomagal svojim strankam odgovorno uporabljati naše AI izdelke, delil naše izkušnje in gradil partnerstva, ki temeljijo na zaupanju, z orodji, kot so Transparency Notes in Impact Assessments. Veliko teh virov najdete na https://aka.ms/RAI. Microsoftov pristop k odgovorni umetni inteligenci temelji na naših AI načelih pravičnosti, zanesljivosti in varnosti, zasebnosti in varnosti, vključevanju, preglednosti in odgovornosti.

Veliki modeli za naravni jezik, slike in govor – kot tisti, uporabljeni v tem vzorcu – se lahko obnašajo na načine, ki so nepravični, nezanesljivi ali žaljivi, kar lahko povzroči škodo. Prosimo, preglejte Azure OpenAI service Transparency note, da se seznanite z tveganji in omejitvami.

Priporočeni pristop za zmanjšanje teh tveganj je vključitev varnostnega sistema v vašo arhitekturo, ki lahko zazna in prepreči škodljivo vedenje. Azure AI Content Safety nudi neodvisno zaščitno plast, ki lahko zaznava škodljivo vsebino, ki jo ustvarijo uporabniki ali AI, v aplikacijah in storitvah. Azure AI Content Safety vključuje API-je za besedilo in slike, ki omogočajo zaznavanje škodljivega materiala. Na voljo imamo tudi interaktivno Content Safety Studio, kjer lahko pregledate, raziskujete in preizkusite vzorčno kodo za zaznavanje škodljive vsebine v različnih modalitetah. Naslednja quickstart dokumentacija vas vodi skozi pošiljanje zahtevkov storitvi.

Drugi vidik, ki ga je treba upoštevati, je splošna zmogljivost aplikacije. Pri aplikacijah z večmodalnimi in večmodelnimi pristopi razumemo zmogljivost kot to, da sistem deluje tako, kot vi in vaši uporabniki pričakujete, vključno s tem, da ne ustvarja škodljivih izhodov. Pomembno je oceniti zmogljivost vaše celotne aplikacije z uporabo generation quality and risk and safety metrics.

Vašo AI aplikacijo lahko ocenite v razvojnih okoljih z uporabo prompt flow SDK. Ob testnem naboru podatkov ali cilju se generacije vaše generativne AI aplikacije kvantitativno merijo z vgrajenimi ali lastnimi ocenjevalci po vaši izbiri. Za začetek z prompt flow SDK za ocenjevanje vašega sistema sledite quickstart vodniku. Ko izvedete ocenjevalno izvedbo, lahko vizualizirate rezultate v Azure AI Studio.

Trademarks

This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow Microsoft’s Trademark & Brand Guidelines. Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos are subject to those third-party’s policies.

Omejitev odgovornosti:
Ta dokument je bil preveden z uporabo storitve za prevajanje z umetno inteligenco Co-op Translator. Čeprav si prizadevamo za natančnost, vas prosimo, da upoštevate, da lahko avtomatizirani prevodi vsebujejo napake ali netočnosti. Izvirni dokument v njegovem izvorni jezik velja za avtoritativni vir. Za kritične informacije priporočamo strokovni človeški prevod. Za kakršnekoli nesporazume ali napačne interpretacije, ki izhajajo iz uporabe tega prevoda, ne odgovarjamo.

This site is open source. Improve this page.