co-op-translator

Logo

Mfasiri wa Co-op: Fanya Tafsiri ya Nyaraka za Elimu Kwa Urahisi

Tumia kiotomatiki kutafsiri nyaraka zako katika lugha nyingi ili kufikia hadhira ya kimataifa.

Python package License: MIT Downloads Downloads Code style: black

GitHub contributors GitHub issues GitHub pull-requests PRs Welcome

Usaidizi wa Lugha Unaotolewa na Co-op Translator

Franska | Spanska | Tyska | Ryska | Arabiska | Persiska (Farsi) | Urdu | Kinesiska (Förenklad) | Kinesiska (Traditionell, Macau) | Kinesiska (Traditionell, Hong Kong) | Kinesiska (Traditionell, Taiwan) | Japanska | Koreanska | Hindi | Bengali | Marathi | Nepali | Punjabi (Gurmukhi) | Portugisiska (Portugal) | Portugisiska (Brasilien) | Italienska | Polska | Turkiska | Grekiska | Thailändska | Svenska | Danska | Norska | Finska | Holländska | Hebreiska | Vietnamesiska | Indonesiska | Malajiska | Tagalog (Filippinska) | Swahili | Ungerska | Tjeckiska | Slovakiska | Rumänska | Bulgariska | Serbiska (Kyrilliska) | Kroatiska | Slovenska | Ukrainska | Burmese (Myanmar)

[!NOTE] Hizi ni tafsiri za sasa za maudhui ya hifadhidata hii. Kwa orodha kamili ya lugha zinazoungwa mkono na Co-op Translator, tafadhali angalia sehemu ya Language Support.

GitHub watchers GitHub forks GitHub stars

Azure AI Community Discord

Open in GitHub Codespaces Open in Dev Containers

Muhtasari: Rahisisha Tafsiri ya Maudhui Yako ya Elimu

Vizingiti vya lugha vinaathiri sana upatikanaji wa rasilimali muhimu za elimu na maarifa ya kiufundi kwa wanafunzi na waendelezaji duniani kote. Hii hupunguza ushiriki na kupunguza kasi ya ubunifu na kujifunza duniani.

Co-op Translator ilizaliwa kutokana na hitaji la kuboresha mchakato usiofaa wa tafsiri ya mikono kwa mfululizo mkubwa wa elimu wa Microsoft (kama vile mwongozo wa “Kwa Waanzilishi”). Sasa ni chombo rahisi kutumia, chenye nguvu, kilichoundwa kuvunja vizingiti hivi kwa kila mtu. Kwa kutoa tafsiri za ubora wa juu kwa njia ya CLI na GitHub Actions, Co-op Translator huwapa walimu, wanafunzi, watafiti, na waendelezaji duniani kote uwezo wa kushiriki na kupata maarifa bila vizuizi vya lugha.

Tazama jinsi Co-op Translator inavyopanga maudhui ya elimu yaliyotafsiriwa:

Example

Faili za Markdown na maandishi ya picha hutafsiriwa moja kwa moja na kuandaliwa kwa mpangilio mzuri kwenye folda za lugha maalum.

Fungua upatikanaji wa kimataifa kwa maudhui yako ya elimu kwa kutumia Co-op Translator leo!

Kusaidia Upatikanaji wa Kimataifa kwa Rasilimali za Kujifunza za Microsoft

Co-op Translator husaidia kuziba pengo la lugha kwa miradi muhimu ya elimu ya Microsoft, kwa kuendesha mchakato wa tafsiri kwa hifadhidata zinazohudumia jumuiya ya waendelezaji duniani. Mifano inayotumia Co-op Translator kwa sasa ni:

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

Sifa Muhimu

Jinsi Inavyofanya Kazi

Architecture

Co-op Translator huchukua faili za Markdown na picha kutoka kwenye folda ya mradi wako na kuziendesha kama ifuatavyo:

  1. Uchukuaji wa Maandishi: Huchukua maandishi kutoka kwa faili za Markdown na, ikiwa imewekwa (mfano, kwa Azure AI Vision), maandishi yaliyomo ndani ya picha.
  2. Tafsiri kwa AI: Huutuma maandishi yaliyochukuliwa kwa LLM iliyowekwa (Azure OpenAI, OpenAI, nk) kwa ajili ya tafsiri.
  3. Hifadhi Matokeo: Huhifadhi faili za Markdown zilizotafsiriwa na picha (zilizo na maandishi yaliyotafsiriwa) kwenye folda za lugha maalum, huku ikihifadhi muundo wa awali.

Anza Haraka

Anza haraka kwa kutumia CLI au weka kiotomatiki kamili na GitHub Actions. Chagua njia inayofaa zaidi kwa mtiririko wako wa kazi:

  1. Command Line (CLI) - Kwa tafsiri za mara moja au udhibiti wa mikono
  2. GitHub Actions - Kwa tafsiri zinazoendeshwa kiotomatiki kila unapobeba mabadiliko

[!NOTE] Ingawa mafunzo haya yanazingatia rasilimali za Azure, unaweza kutumia mfano wowote wa lugha unaoungwa mkono.

Msaada wa Lugha

Co-op Translator inaunga mkono lugha nyingi ili kukusaidia kufikia hadhira ya kimataifa. Hapa ni mambo unayopaswa kujua:

Marejeleo ya Haraka

Lugha Msimbo Lugha Msimbo Lugha Msimbo
Kiarabu ar Kibenwali bn Kibulgaria bg
Kiburma (Myanmar) my Kichina (Rahisi) zh Kichina (Asili, HK) hk
Kichina (Asili, Macau) mo Kichina (Asili, TW) tw Kikroeshia hr
Kicheki cs Kidenmaki da Kiholanzi nl
Kifini fi Kifaransa fr Kijerumani de
Kigiriki el Kiebrania he Kihindi hi
Kihungari hu Kiindonesia id Kiitaliano it
Kijapani ja Kikorea ko Kimelayu ms
Kimarathi mr Kinepali ne Kinorwe no
Kiajemi (Farsi) fa Kipolishi pl Kireno (Brazil) br
Kireno (Ureno) pt Kipunjabi (Gurmukhi) pa Kiromania ro
Kirusi ru Kiserbia (Cyrillic) sr Kislovakia sk
Kislovenia sl Kihispania es Kiswahili sw
Kiswidi sv Kitagalog (Kifilipino) tl Kithai th
Kituruki tr Kiukraini uk Kiurdu ur
Kivietinamu vi

Kutumia Msimbo wa Lugha

Unapotumia Co-op Translator, utahitaji kubainisha lugha kwa kutumia misimbo yao. Kwa mfano:

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

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

[!NOTE] Kwa maelezo ya kina ya kiufundi kuhusu msaada wa lugha, ikijumuisha:

Angalia Supported Languages Documentation.

Mifano na Huduma Zinazoungwa Mkono

Aina Jina
Mfano wa Lugha Azure OpenAI OpenAI
AI Vision Azure AI Vision

[!NOTE] Ikiwa huduma ya AI vision haipatikani, co-op translator itabadilisha hadi Markdown-only mode.

Usanidi wa Awali

Kabla hujaanza, utahitaji kuanzisha rasilimali zifuatazo:

  1. Rasilimali ya Mfano wa Lugha (Inahitajika):
    • Azure OpenAI (Inapendekezwa) - Hutoa tafsiri bora zenye uhakika wa kiwango cha biashara
    • OpenAI - Chaguo mbadala ikiwa huna ufikiaji wa Azure
    • Kwa maelezo ya kina kuhusu mifano inayoungwa mkono, angalia Supported Models and Services
  2. Rasilimali ya AI Vision (Hiari):
    • Azure AI Vision - Inaruhusu tafsiri ya maandishi yaliyomo ndani ya picha
    • Ikiwa haijasanidiwa, tafsiri itatumia moja kwa moja Markdown-only mode
    • Inapendekezwa kwa miradi yenye picha zilizo na maandishi yanayohitaji kutafsiriwa
  3. Hatua za Usanidi:
    • Fuata Azure AI setup guide kwa maelekezo ya kina
    • Unda faili .env yenye API keys na endpoints zako (tazama sehemu ya Quick Start)
    • Hakikisha una ruhusa na vikwazo vinavyohitajika kwa huduma ulizochagua

Usanidi wa Mradi Kabla ya Tafsiri

Kabla ya kuanza mchakato wa tafsiri, fuata hatua hizi kuandaa mradi wako:

  1. Andaa README Yako:
    • Ongeza jedwali la tafsiri kwenye README.md yako kuunganisha matoleo yaliyotafsiriwa
    • Mfano wa muundo:

      
      ### 🌐 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. Ondoa Tafsiri Zilizopo (ikiwa inahitajika):
    • Futa folda zozote za tafsiri zilizopo (mfano, translations/)
    • Futa faili zozote za tafsiri za zamani ili kuanza upya
    • Hii inahakikisha hakuna migongano na mchakato mpya wa tafsiri

Anza Haraka: Command Line

Kwa kuanza haraka kwa kutumia mstari wa amri:

  1. Unda mazingira ya virtual:

     python -m venv .venv
    
  2. Washa mazingira ya virtual:

    • Kwa Windows:
     .venv\scripts\activate
    
    • Kwa Linux/macOS:
     source .venv/bin/activate
    
  3. Sakinisha kifurushi:

     pip install co-op-translator
    
  4. Sanidi Vibali:

    • Unda faili .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 alama:
     translate -l "ko ja fr"
    

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

Usuluhishi na Vidokezo

Rasilimali Zaidi

Maonyesho ya Video

Jifunze zaidi kuhusu Co-op Translator kupitia maonyesho yetu (Bonyeza picha hapa chini kuangalia YouTube.):

Tusaidie na Kuendeleza Kujifunza Duniani

Jiunge nasi katika mapinduzi ya jinsi maudhui ya elimu yanavyoshirikiwa duniani kote! Toa ⭐ kwa Co-op Translator kwenye GitHub na saidia dhamira yetu ya kuvunja vizuizi vya lugha katika kujifunza na teknolojia. Mchango wako na ushiriki wako unaleta athari kubwa! Michango ya msimbo na mapendekezo ya vipengele ni karibu daima.

Kuchangia

Mradi huu unakaribisha michango na mapendekezo. Unavutiwa kuchangia Azure Co-op Translator? Tafadhali angalia CONTRIBUTING.md kwa miongozo ya jinsi unavyoweza kusaidia kufanya Co-op Translator ipatikane kwa urahisi zaidi.

Wachangiaji

co-op-translator contributors

Kanuni za Maadili

Mradi huu umekubali Microsoft Open Source Code of Conduct. Kwa taarifa zaidi tazama Code of Conduct FAQ au wasiliana na opencode@microsoft.com kwa maswali au maoni zaidi.

AI Inayowajibika

Microsoft imejizatiti kusaidia wateja wetu kutumia bidhaa zetu za AI kwa uwajibikaji, kushiriki mafunzo yetu, na kujenga ushirikiano unaotegemea imani kupitia zana kama Transparency Notes na Impact Assessments. Rasilimali nyingi za aina hii zinaweza kupatikana kwenye https://aka.ms/RAI. Mbinu ya Microsoft kuhusu AI inayowajibika inatokana na kanuni zetu za AI za haki, kuaminika na usalama, faragha na usalama, ujumuishaji, uwazi, na uwajibikaji.

Mifano mikubwa ya lugha asilia, picha, na sauti - kama ile inayotumika katika mfano huu - inaweza kuonyesha tabia zisizo za haki, zisizo za kuaminika, au za kuudhi, na kusababisha madhara. Tafadhali rejea Azure OpenAI service Transparency note ili ujue kuhusu hatari na vikwazo.

Njia inayopendekezwa kupunguza hatari hizi ni kujumuisha mfumo wa usalama katika usanifu wako unaoweza kugundua na kuzuia tabia hatari. Azure AI Content Safety hutoa safu huru ya ulinzi, inayoweza kugundua maudhui hatari yaliyotengenezwa na watumiaji na AI katika programu na huduma. Azure AI Content Safety ina API za maandishi na picha zinazokuwezesha kugundua nyenzo hatari. Pia tuna Studio ya Content Safety inayoshirikisha ambayo inakuwezesha kuona, kuchunguza, na kujaribu mifano ya msimbo wa kugundua maudhui hatari katika aina tofauti. Hati ya quickstart documentation inakuongoza jinsi ya kutuma maombi kwa huduma hii.

Jambo jingine la kuzingatia ni utendaji wa jumla wa programu. Kwa programu zenye modal na mifano mingi, tunazingatia utendaji kama mfumo unavyofanya kazi kama unavyotarajia wewe na watumiaji wako, ikijumuisha kutozalisha matokeo hatari. Ni muhimu kutathmini utendaji wa programu yako kwa kutumia generation quality and risk and safety metrics.

Unaweza kutathmini programu yako ya AI katika mazingira ya maendeleo kwa kutumia prompt flow SDK. Kwa dataset ya majaribio au lengo, matokeo ya programu yako ya AI yanapimwa kwa kiasi kwa kutumia wachambuzi waliopo au wachambuzi maalum wa chaguo lako. Ili kuanza na prompt flow sdk kutathmini mfumo wako, unaweza kufuata quickstart guide. Mara utakapotekeleza mtihani wa tathmini, unaweza kuona matokeo katika Azure AI Studio.

Alama za Biashara

Mradi huu unaweza kuwa na alama za biashara au nembo za miradi, bidhaa, au huduma. Matumizi ya alama za biashara au nembo za Microsoft yanayoruhusiwa yanategemea na lazima yafuatilie Microsoft’s Trademark & Brand Guidelines. Matumizi ya alama za biashara au nembo za Microsoft katika matoleo yaliyorekebishwa ya mradi huu hayapaswi kusababisha mkanganyiko au kuonyesha udhamini wa Microsoft. Matumizi yoyote ya alama za biashara au nembo za watu wengine yanategemea sera za wale wa tatu.

Kikomo cha lawama:
Hati hii imetafsiriwa kwa kutumia huduma ya tafsiri ya AI Co-op Translator. Ingawa tunajitahidi kuwa sahihi, tafadhali fahamu kuwa tafsiri za kiotomatiki zinaweza kuwa na makosa au upungufu wa usahihi. Hati ya asili katika lugha yake ya asili inapaswa kuchukuliwa kama chanzo cha mamlaka. Kwa taarifa muhimu, tafsiri ya kitaalamu na ya binadamu inapendekezwa. Hatubebeki lawama kwa kutoelewana au tafsiri potofu zitokanazo na matumizi ya tafsiri hii.