README.md

Co-op Translator

Easy automatishe na mantenua tafsiri za maudhui yako ya kielimu ya GitHub katika lugha nyingi kadri mradi wako unavyoendelea.

🌐 Msaada wa Lugha Nyingi

Inasaidiwa na Co-op Translator

Arabic | Bengali | Bulgarian | Burmese (Myanmar) | Chinese (Simplified) | Chinese (Traditional, Hong Kong) | Chinese (Traditional, Macau) | Chinese (Traditional, Taiwan) | Croatian | Czech | Danish | Dutch | Estonian | Finnish | French | German | Greek | Hebrew | Hindi | Hungarian | Indonesian | Italian | Japanese | Kannada | Khmer | Korean | Lithuanian | Malay | Malayalam | Marathi | Nepali | Nigerian Pidgin | Norwegian | Persian (Farsi) | Polish | Portuguese (Brazil) | Portuguese (Portugal) | Punjabi (Gurmukhi) | Romanian | Russian | Serbian (Cyrillic) | Slovak | Slovenian | Spanish | Swahili | Swedish | Tagalog (Filipino) | Tamil | Telugu | Thai | Turkish | Ukrainian | Urdu | Vietnamese

Unapendelea Kukopa Kwenye Kompyuta?

Hifadhi hii ina tafsiri za lugha zaidi ya 50 ambazo huongeza kwa kiasi kikubwa ukubwa wa upakuaji. Ili kukopa bila tafsiri, tumia sparse checkout:

Bash / macOS / Linux:

git clone --filter=blob:none --sparse https://github.com/Azure/co-op-translator.git
cd co-op-translator
git sparse-checkout set --no-cone '/*' '!translations' '!translated_images'

CMD (Windows):

git clone --filter=blob:none --sparse https://github.com/Azure/co-op-translator.git
cd co-op-translator
git sparse-checkout set --no-cone "/*" "!translations" "!translated_images"

Hii inakupa kila unachohitaji kukamilisha kozi na upakuaji wa haraka zaidi.

Muhtasari

Co-op Translator inasaidia kuweka maudhui yako ya kielimu ya GitHub katika lugha nyingi kwa urahisi.
Unapoboresha faili zako za Markdown, picha, au daftari (notebooks), tafsiri hubaki kusasishwa moja kwa moja, kuhakikisha maudhui yako yanabaki sahihi na ya kisasa kwa wanafunzi duniani kote.

Mfano wa jinsi maudhui yaliyotafsiriwa yanavyopangwa:

Jinsi hali ya tafsiri inavyosimamiwa

Co-op Translator inasimamia maudhui yaliyotafsiriwa kama vifaa vya programu vilivyo na toleo,
si kama faili zisizobadilika.

Zana hii inafuatilia hali ya Markdown iliyotafsiriwa, picha, na daftari
kwa kutumia metadata inayozingatia lugha.

Muundo huu unamruhusu Co-op Translator:

• Kugundua kwa uhakika tafsiri zilizochakaa
• Kutendea Markdown, picha, na daftari kwa usawa
• Kupanua salama katika maktaba kubwa, yenye mabadiliko haraka, za lugha nyingi

Kwa kutumia mfano wa tafsiri kama vitu vinavyosimamiwa,
miradi ya tafsiri inaendana kiasili na mbinu za kisasa
za kusimamia utegemezi wa programu na vifaa.

→ Jinsi hali ya tafsiri inavyosimamiwa

Anza haraka

# Unda na wezesha mazingira ya mtandao (inapendekezwa)
python -m venv .venv
# Windows
.venv\Scripts\activate
# macOS/Linux
source .venv/bin/activate
# Sakinisha kifurushi
pip install co-op-translator
# Tafsiri
translate -l "ko ja fr" -md

Docker:

# Vuta picha ya umma kutoka GHCR
docker pull ghcr.io/azure/co-op-translator:latest
# Endesha na folda ya sasa imewekwa na .env imeambatanishwa (Bash/Zsh)
docker run --rm -it --env-file .env -v "${PWD}:/work" ghcr.io/azure/co-op-translator:latest -l "ko ja fr" -md

Usanidi mdogo

1. Thibitisha kuwa una toleo linaloungwa mkono la Python (kwa sasa 3.10-3.12). Katika poetry (pyproject.toml) hili hufanywa moja kwa moja.
2. Tengeneza faili .env kwa kutumia kiolezo: .env.template
3. Sanidi mtoa huduma mmoja wa LLM (Azure OpenAI au OpenAI)
4. (Hiari) Kwa tafsiri ya picha (-img), sanidi Azure AI Vision
5. (Hiari) Unaweza kusanidi seti nyingi za vibali kwa kunakili vigezo kwa viambishi kama _1, _2, n.k. Vigezo vyote katika seti lazima viwe na kiambishi sawa.
6. (Inapendekezwa) Safisha tafsiri yoyote ya awali ili kuepuka mgongano (mfano, translations/)
7. (Inapendekezwa) Ongeza sehemu ya tafsiri kwenye README yako kwa kutumia kiolezo cha lugha za README
8. Angalia: Sanidi Azure AI

Matumizi

Tafsiri aina zote zinazounga mkono:

translate -l "ko ja"

Markdown pekee:

translate -l "de" -md

Markdown + picha:

translate -l "pt" -md -img

Notebooks pekee:

translate -l "zh" -nb

Bendera zaidi: Marejeleo ya amri

Sifa

• Tafsiri za kiotomatiki za Markdown, daftari, na picha
• Huweka tafsiri zikilingana na mabadiliko ya chanzo
• Hufanya kazi ndani ya kompyuta (CLI) au katika CI (GitHub Actions)
• Inatumia Azure OpenAI au OpenAI; chaguo la Azure AI Vision kwa picha
• Huhifadhi muundo na usanifu wa Markdown

Nyaraka

• Mwongozo wa amri ya mstari wa amri
• Mwongozo wa GitHub Actions (Maktaba za umma & siri za kawaida)
• Mwongozo wa GitHub Actions (Maktaba za shirika la Microsoft & usanidi wa ngazi ya shirika)
• Kiolezo cha lugha za README
• Lugha zinazounga mkono
• Kushiriki michango
• Matatizo na ufumbuzi

Mwongozo wa Microsoft pekee

Note

Kwa watunzaji wa maktaba za Microsoft “Kwa Waanzilishi” tu.

• Kusasisha orodha ya “kozi nyingine” (kwa maktaba za MS Beginners tu)

Tuunge mkono na kuendeleza elimu duniani kote

Jiunge nasi katika mapinduzi ya jinsi maudhui ya kielimu yanavyoshirikiwa duniani kote! Mpa Co-op Translator ⭐ kwenye GitHub na saidia dhamira yetu ya kuvunja vizingiti vya lugha katika elimu na teknolojia. Maslahi na michango yako vina athari kubwa! Michango ya msimbo na mapendekezo ya vipengele hikaribishwa kila wakati.

Chunguza maudhui ya kielimu ya Microsoft kwa lugha yako

• LangChain4j-for-Beginners
• AZD for Beginners
• Edge AI for Beginners
• Model Context Protocol (MCP) For Beginners
• AI Agents for Beginners
• Generative AI for Beginners using .NET
• Generative AI for Beginners
• Generative AI for Beginners using Java
• ML for Beginners
• Data Science for Beginners
• AI for Beginners
• Cybersecurity for Beginners
• Web Dev for Beginners
• IoT for Beginners
• PhiCookBook

Video za mawasilisho

👉 Bonyeza picha hapo chini kutazama kwenye YouTube.

• Open at Microsoft: Utangulizi mfupi wa dakika 18 na mwongozo wa haraka jinsi ya kutumia Co-op Translator.

  

Kuchangia

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

Michangiaji

Kanuni za Maadili

Mradi huu umeitikia Kanuni za Maadili za Vyanzo Huria za Microsoft. Kwa maelezo zaidi angalia Maswali Yanayoulizwa Mara kwa Mara ya Kanuni za Maadili au wasiliana na opencode@microsoft.com kwa maswali au maoni zaidi.

AI Inayowajibika

Microsoft imejizatiti kusaidia wateja wetu kutumia bidhaa zetu za AI kwa kuwajibika, kushiriki maarifa yetu, na kujenga ushirikiano unaotegemea imani kupitia zana kama Vidokezo vya Uwazi na Tathmini za Mwelekeo. Rasilimali nyingi za aina hii zinaweza kupatikana kwenye https://aka.ms/RAI. Mbinu ya Microsoft kuhusu AI inayowajibika ina msingi katika kanuni zetu za AI za haki, uaminifu na usalama, faragha na usalama, ujumuishaji, uwazi, na uwajibikaji.

Mifano kubwa ya lugha za asili, picha, na sauti - kama ile inayotumika katika mfano huu - inaweza kuonyesha tabia ambazo si za haki, zisizotegemewa, au za kumkosea mtu heshima, na hivyo kusababisha madhara. Tafadhali angalia Kidokezo cha Uwaz SSA cha Huduma ya Azure OpenAI ili kujifunza kuhusu hatari na vizuizi.

Njia inayopendekezwa ya kukabiliana na hatari hizi ni kujumuisha mfumo wa usalama katika usanifu wako unaoweza kugundua na kuzuia tabia hatarishi. Azure AI Content Safety hutoa tabaka huru la ulinzi, linaloweza kugundua maudhui hatarishi yanayotengenezwa na watumiaji na AI katika programu na huduma. Azure AI Content Safety inajumuisha APIs za maandishi na picha zinazokuwezesha kugundua nyenzo hatarishi. Pia tuna Studio ya Maudhui ya Usalama yenye mwingiliano inayokuwezesha kuona, kuchunguza na kujaribu msimbo wa mfano wa kugundua maudhui hatarishi katika njia mbalimbali. Hati hii ya quickstart itakuongoza jinsi ya kufanya maombi kwa huduma.

Pia, sehemu nyingine ya kuzingatia ni utendaji wa jumla wa programu. Kwa matumizi ya programu zenye aina nyingi na mifano mingi, tunazingatia utendaji kama mfumo unavyofanya kama unavyotarajiwa na wewe na watumiaji wako, ikiwa ni pamoja na kutotengeneza matokeo hatarishi. Ni muhimu kutathmini utendaji wa programu yako kwa kutumia viwango vya ubora wa uzalishaji na hatari na usalama.

Unaweza kutathmini programu yako ya AI katika mazingira yako ya maendeleo kwa kutumia prompt flow SDK. Imetolewa seti ya data ya majaribio au lengo, uzalishaji wa programu yako ya AI huwekewa alama kwa kiasi tukitumia wachambuzi waliotakiwa au maalum wa uchaguzi wako. Ili kuanza kutumia prompt flow sdk kutathmini mfumo wako, unaweza kufuata mwongozo wa quickstart. Baada ya kuendesha tathmini, unaweza kuonesha matokeo katika Azure AI Studio.

Alama za Biashara

Mradi huu unaweza kuwa na alama za biashara au nembo za miradi, bidhaa, au huduma. Matumizi yaliyoruhusiwa ya alama za biashara au nembo za Microsoft yanapaswa kufuata na kuzingatia Mwongozo wa Alama za Biashara na Brand wa Microsoft. Matumizi ya alama za biashara au nembo za Microsoft katika matoleo yaliyobadilishwa ya mradi huu hayapaswi kusababisha mkanganyiko au kuashiria udhamini wa Microsoft. Matumizi yoyote ya alama za biashara au nembo za watu wengine yanatawaliwa na sera za wamiliki hao wa alama.

Kupata Msaada

Ukikumbwa na shida au una maswali kuhusu kujenga programu za AI, jiunge na:

Kama una mrejesho wa bidhaa au makosa wakati wa kujenga tembelea:

---

Maelezo ya kukanusha: Hati hii imetafsiriwa kwa kutumia huduma ya tafsiri ya AI Co-op Translator. Ingawa tunajitahidi kwa usahihi, tafadhali fahamu kwamba tafsiri za kiotomatiki zinaweza kuwa na makosa au upungufu wa usahihi. Hati ya asili katika lugha yake ya asili inapaswa kuchukuliwa kama chanzo cha uhakika. Kwa taarifa muhimu, tafsiri ya mtaalamu wa binadamu inashauriwa. Sisi hatubebwi lawama kwa kutoelewana au tafsiri potofu zinazotokana na matumizi ya tafsiri hii.