co-op-translator

Logo

Co-op Translator: Automatisoi koulutusdokumentaation käännökset vaivattomasti

Automatisoi helposti dokumentaatiosi kääntäminen useille kielille ja tavoita maailmanlaajuinen yleisö.

Python package License: MIT Downloads Downloads Code style: black

GitHub contributors GitHub issues GitHub pull-requests PRs Welcome

Kielituki Co-op Translatorin voimin

[!NOTE] Nämä ovat tämän arkiston sisällön nykyiset käännökset. Täydellinen lista Co-op Translatorin tukemista kielistä löytyy kohdasta Language Support.

GitHub watchers GitHub forks GitHub stars

Azure AI Community Discord

Open in GitHub Codespaces Open in Dev Containers

Yleiskatsaus: Tehosta opetussisältöjesi kääntämistä

Kielimuurit vaikeuttavat merkittävästi arvokkaiden opetussisältöjen ja teknisen tiedon saatavuutta oppijoille ja kehittäjille ympäri maailmaa. Tämä rajoittaa osallistumista ja hidastaa globaalin innovaation ja oppimisen vauhtia.

Co-op Translator syntyi tarpeesta tehostaa Microsoftin omien laajamittaisten opetussarjojen (kuten “For Beginners” -oppaat) manuaalista käännösprosessia. Se on kehittynyt helppokäyttöiseksi ja tehokkaaksi työkaluksi, joka murtaa kielimuurit kaikille. Tarjoamalla laadukkaita automaattisia käännöksiä komentorivin ja GitHub Actionsin kautta, Co-op Translator antaa opettajille, opiskelijoille, tutkijoille ja kehittäjille maailmanlaajuisesti mahdollisuuden jakaa ja käyttää tietoa ilman kielirajoituksia.

Katso, miten Co-op Translator järjestää käännetyn opetussisällön:

Example

Markdown-tiedostot ja kuvien tekstit käännetään automaattisesti ja järjestetään siististi kielikohtaisiin kansioihin.

Avaa opetussisältösi globaaliin käyttöön Co-op Translatorin avulla jo tänään!

Tuemme Microsoftin oppimateriaalien maailmanlaajuista saavutettavuutta

Co-op Translator auttaa ylittämään kielimuurit tärkeissä Microsoftin opetushankkeissa automatisoimalla käännösprosessin kehittäjäyhteisölle, joka toimii globaalisti. Esimerkkejä projekteista, jotka käyttävät Co-op Translatoria tällä hetkellä:

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

Keskeiset ominaisuudet

Miten se toimii

Architecture

Co-op Translator ottaa projektikansiostasi Markdown-tiedostot ja kuvat ja käsittelee ne seuraavasti:

  1. Tekstin poiminta: Poimii tekstiä Markdown-tiedostoista ja tarvittaessa (esim. Azure AI Visionilla) kuvien sisältä.
  2. AI-käännös: Lähettää poimitun tekstin määritettyyn LLM:ään (Azure OpenAI, OpenAI jne.) käännettäväksi.
  3. Tuloksen tallennus: Tallentaa käännetyt Markdown-tiedostot ja kuvat (käännetty teksti mukana) kielikohtaisiin kansioihin säilyttäen alkuperäisen muotoilun.

Aloittaminen

Aloita nopeasti komentoriviltä tai ota käyttöön täysi automaatio GitHub Actionsin avulla. Valitse työskentelytapa, joka sopii parhaiten sinulle:

  1. Komentorivi (CLI) – kertakäyttöisiin käännöksiin tai manuaaliseen hallintaan
  2. GitHub Actions – automaattisiin käännöksiin jokaisella pushilla

[!NOTE] Vaikka tämä opas keskittyy Azure-resursseihin, voit käyttää mitä tahansa tuettua kielimallia.

Kielituki

Co-op Translator tukee laajaa valikoimaa kieliä, jotta tavoitat globaalin yleisön. Tässä tärkeimmät tiedot:

Pikakatsaus

Kieli Koodi Kieli Koodi Kieli Koodi
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 — — — —

Kielikoodien käyttö

Co-op Translatorissa kielet määritetään niiden koodeilla. Esimerkiksi:

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

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

[!NOTE] Tarkempia teknisiä tietoja kielituesta, mukaan lukien:

löydät dokumentaatiostamme Supported Languages Documentation.

Tuetut mallit ja palvelut

Tyyppi Nimi
Language Model Azure OpenAI OpenAI
AI Vision Azure AI Vision

[!NOTE] Jos AI Vision -palvelua ei ole käytettävissä, co-op translator vaihtaa automaattisesti Markdown-only modeen.

Alustava käyttöönotto

Ennen aloittamista sinun tulee määrittää seuraavat resurssit:

  1. Language Model -resurssi (pakollinen):
    • Azure OpenAI (suositeltu) – tarjoaa laadukkaita käännöksiä yritystason luotettavuudella
    • OpenAI – vaihtoehto, jos Azureen ei ole pääsyä
    • Tarkemmat tiedot tuetuista malleista löytyvät kohdasta Supported Models and Services
  2. AI Vision -resurssi (valinnainen):
    • Azure AI Vision – mahdollistaa kuvien sisällön tekstin kääntämisen
    • Jos tätä ei ole määritetty, kääntäjä käyttää automaattisesti Markdown-only modea
    • Suositellaan projekteihin, joissa on kuvia, joissa on käännettävää tekstiä
  3. Konfigurointivaiheet:
    • Seuraa Azure AI setup guidea tarkkojen ohjeiden saamiseksi
    • Luo .env-tiedosto API-avaimilla ja päätepisteillä (katso Quick Start -osio)
    • Varmista, että sinulla on tarvittavat oikeudet ja käyttökiintiöt valitsemillesi palveluille

Projektin valmistelu ennen käännöstä

Ennen käännösprosessin aloittamista valmistele projektisi seuraavasti:

  1. Valmistele README:
    • Lisää README.md-tiedostoon käännöstaulukko, josta pääsee käännettyihin versioihin

    • Esimerkkimuoto:

      
### 🌐 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. Siivoa olemassa olevat käännökset (tarvittaessa):
    • Poista vanhat käännöskansiot (esim. translations/)
    • Poista vanhat käännöstiedostot aloittaaksesi puhtaalta pöydältä
    • Tämä estää ristiriidat uuden käännösprosessin kanssa

Pikakäynnistys: Komentorivi

Nopea aloitus komentoriviltä:

  1. Luo virtuaaliympäristö:

     python -m venv .venv

  2. Aktivoi virtuaaliympäristö:

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

  3. Asenna paketti:

     pip install co-op-translator

  4. Määritä tunnistetiedot:

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

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

Vianmääritys ja vinkit

Lisäresurssit

Videopresentaatiot

Tutustu Co-op Translatoriin esitystemme kautta (klikkaa alla olevaa kuvaa katsoaksesi YouTubessa):

Tue meitä ja edistä globaalia oppimista

Liity mukaan mullistamaan tapa, jolla opetussisältöä jaetaan maailmanlaajuisesti! Anna Co-op Translatorille ⭐ GitHubissa ja tue missiotamme poistaa kielimuurit oppimisessa ja teknologiassa. Kiinnostuksesi ja panoksesi ovat erittäin arvokkaita! Koodin parannukset ja ominaisuusehdotukset ovat aina tervetulleita.

Osallistuminen

Tämä projekti toivottaa tervetulleiksi panokset ja ehdotukset. Haluatko osallistua Azure Co-op Translatorin kehittämiseen? Katso ohjeet CONTRIBUTING.md-tiedostosta, miten voit auttaa tekemään Co-op Translatorista entistä saavutettavamman.

Tekijät

co-op-translator contributors

Käyttäytymissäännöt

Tämä projekti on ottanut käyttöön Microsoft Open Source Code of Conductin. Lisätietoja löydät Code of Conduct FAQ -sivulta tai ota yhteyttä osoitteeseen opencode@microsoft.com, jos sinulla on lisäkysymyksiä tai kommentteja.

Vastuullinen tekoäly

Microsoft sitoutuu auttamaan asiakkaitamme käyttämään tekoälytuotteitamme vastuullisesti, jakamaan oppejamme ja rakentamaan luottamukseen perustuvia kumppanuuksia esimerkiksi Transparency Notes- ja Impact Assessments -työkalujen avulla. Monet näistä resursseista löytyvät osoitteesta https://aka.ms/RAI. Microsoftin vastuullisen tekoälyn lähestymistapa perustuu tekoälyn periaatteisiimme, jotka ovat oikeudenmukaisuus, luotettavuus ja turvallisuus, yksityisyys ja tietoturva, osallisuus, läpinäkyvyys sekä vastuullisuus.

Laajamittaiset luonnollisen kielen, kuvan ja puheen mallit – kuten tässä esimerkissä käytetyt – voivat käyttäytyä tavoilla, jotka ovat epäoikeudenmukaisia, epäluotettavia tai loukkaavia, ja aiheuttaa haittaa. Tutustu Azure OpenAI -palvelun Transparency noteen saadaksesi tietoa riskeistä ja rajoituksista.

Suositeltu tapa vähentää näitä riskejä on sisällyttää arkkitehtuuriisi turvajärjestelmä, joka pystyy havaitsemaan ja estämään haitallisen toiminnan. Azure AI Content Safety tarjoaa itsenäisen suojakerroksen, joka pystyy tunnistamaan haitallisen käyttäjien ja tekoälyn tuottaman sisällön sovelluksissa ja palveluissa. Azure AI Content Safety sisältää tekstin ja kuvien API:t, joiden avulla voit tunnistaa haitallista materiaalia. Meillä on myös interaktiivinen Content Safety Studio, jossa voit tarkastella, tutkia ja kokeilla esimerkkikoodeja haitallisen sisällön havaitsemiseksi eri muodoissa. Seuraava aloitusopas opastaa sinua palvelun käyttöönotossa.

Toinen huomioon otettava seikka on sovelluksen kokonaisvaltainen suorituskyky. Monimodaalisissa ja monimallipohjaisissa sovelluksissa suorituskyvyllä tarkoitetaan sitä, että järjestelmä toimii odotetusti sinulta ja käyttäjiltäsi, mukaan lukien haitallisten tulosten välttäminen. On tärkeää arvioida sovelluksesi suorituskykyä käyttämällä generoinnin laatua sekä riski- ja turvallisuusmittareita.

Voit arvioida tekoälysovellustasi kehitysympäristössäsi käyttämällä prompt flow SDK:ta. Olipa käytössäsi testiaineisto tai tavoite, generatiivisen tekoälysovelluksesi tuotokset mitataan määrällisesti sisäänrakennetuilla arvioijilla tai valinnaisilla mukautetuilla arvioijilla. Aloittaaksesi prompt flow SDK:n käytön järjestelmäsi arviointiin, voit seurata aloitusopasta. Kun suoritat arviointikierroksen, voit visualisoida tulokset Azure AI Studiossa.

Tavara- ja palvelumerkit

Tässä projektissa voi olla tavara- tai palvelumerkkejä projekteille, tuotteille tai palveluille. Microsoftin tavara- ja palvelumerkkien valtuutettu käyttö edellyttää Microsoftin tavara- ja brändiohjeiden noudattamista. Microsoftin tavara- ja palvelumerkkien käyttö muokatuissa versioissa tästä projektista ei saa aiheuttaa sekaannusta eikä antaa ymmärtää Microsoftin sponsorointia. Kolmansien osapuolten tavara- ja palvelumerkkien käyttö on näiden osapuolten sääntöjen alaista.

Vastuuvapauslauseke:
Tämä asiakirja on käännetty käyttämällä tekoälypohjaista käännöspalvelua Co-op Translator. Pyrimme tarkkuuteen, mutta huomioithan, että automaattiset käännökset saattavat sisältää virheitä tai epätarkkuuksia. Alkuperäistä asiakirjaa sen alkuperäiskielellä tulee pitää auktoritatiivisena lähteenä. Tärkeissä tiedoissa suositellaan ammattimaista ihmiskäännöstä. Emme ole vastuussa tämän käännöksen käytöstä aiheutuvista väärinymmärryksistä tai tulkinnoista.

This site is open source. Improve this page.