Skip to content

Latest commit

 

History

History
244 lines (173 loc) · 19 KB

File metadata and controls

244 lines (173 loc) · 19 KB

Co-op Translator

Easily automate and maintain translations for your educational GitHub content across multiple languages as your project evolves.

Python 3.10–3.12 Pakete ng Python Lisensya: MIT Mga pag-download Mga pag-download Container: GHCR Estilo ng code: black

Mga contributor ng GitHub Mga isyu sa GitHub Mga pull request sa GitHub Tinatanggap ang PRs

Magsimula rito: Piliin ang iyong workflow | Kumpigurasyon | CLI | Python API | MCP Server

🌐 Multi-Language Support

Sinusuportahan ng 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

Prefer to Clone Locally?

This repository includes 50+ language translations which significantly increases the download size. To clone without translations, use 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"

This gives you everything you need to complete the course with a much faster download.

GitHub watchers GitHub forks GitHub stars

Microsoft Foundry Discord

Open in GitHub Codespaces

Pangkalahatang-ideya

Co-op Translator tumutulong sa iyo na i-localize ang iyong pang-edukasyong GitHub na nilalaman sa maraming wika nang walang kahirap-hirap. Kapag na-update mo ang iyong mga Markdown file, mga larawan, o mga notebook, ang mga pagsasalin ay awtomatikong nananatiling naka-synchronize, tinitiyak na ang iyong nilalaman ay nananatiling tama at napapanahon para sa mga nag-aaral sa buong mundo.

Gamitin ito mula sa CLI para sa pagsasalin ng repositoryo, mula sa Python API para sa automation, o sa pamamagitan ng MCP server para sa mga workflow ng agent at editor.

Example of how translated content is organized:

Example

Bakit Co-op Translator?

Madaling isalin ang isang file. Ang pagpapanatili ng buong dokumentasyon ng repositoryong isinalin, naka-link, at napapanahon ang mahirap na bahagi.

Problem How Co-op Translator helps
Long docs are not one prompt Hindi sapat ang isang prompt para sa mahahabang Markdown; hinahati ang malalaking Markdown file sa mga bahagi, kaya ang isang mahabang README ay hindi nakadepende sa isang madaling masira na tugon mula sa modelo. Kung mabigo ang isang bahagi, maaaring subukan muli ng Co-op Translator at muling hatiin ang nabigong bahagi lamang.
Incomplete translations should not be marked current Hindi dapat ituring na kasalukuyan ang isang pinutol na pagsasalin. Sinusuri ng Co-op Translator ang integridad ng pagsasalin bago mag-save at maaaring matukoy ang mga estrukturang hindi kumpletong umiiral na pagsasalin.
Links should match the translated repo structure Madalas na iniiwan ng manu-manong mga pagsasalin ang mga relative link pabalik sa source tree. Isinusulat muli ng Co-op Translator ang mga link sa Markdown, notebook, imahe, at README upang tumugma sa translations/<lang>/... na istruktura.
Translation should work across an entire repo Pinangangasiwaan ng Co-op Translator ang mga README file, docs, notebook, at teksto ng larawan bilang bahagi ng isang repository workflow, sa halip na isalin ang mga file isa-isa.
Maintaining translations matters more than creating them once Pinapayagan ka ng mga source hash at metadata ng pagsasalin ng Co-op Translator na mahanap ang mga lipas na file, laktawan ang mga hindi nagbago, at panatilihing naka-synchronize ang isinaling nilalaman habang umuunlad ang source repo.

Paano pinamamahalaan ang estado ng pagsasalin

Pinamamahalaan ng Co-op Translator ang isinaling nilalaman bilang mga versioned software artifact,
hindi bilang mga static na file.

Sinusubaybayan ng tool ang estado ng isinaling Markdown, mga larawan, at mga notebook gamit ang language-scoped metadata.

Ang disenyo na ito ay nagpapahintulot sa Co-op Translator na:

  • Maaasahang matukoy ang mga lipas na pagsasalin
  • Tratuhin nang pare-pareho ang Markdown, mga larawan, at mga notebook
  • Lumaki nang ligtas sa malalaking, mabilis na umuusad, multi-wika na mga repositoryo

Sa pamamagitan ng pagmomodelo ng mga pagsasalin bilang mga pinangangasiwaang artifact, ang mga workflow ng pagsasalin ay natural na naka-align sa moderno na mga gawi sa pamamahala ng dependency at artifact ng software.

Paano pinamamahalaan ang estado ng pagsasalin

Mga Kaugnay na Malalim na Artikulo

Magsimula

Maaaring gamitin ang Co-op Translator mula sa CLI, ang Python API, o ang MCP server. Magsimula sa gabay ng workflow kung pumipili ka sa pagitan ng lokal na pagsasalin, automation, CI, at integrasyon ng agent/editor.

Minimal na halimbawa ng CLI pagkatapos ng konfigurasyon:

python -m venv .venv
# Windows
.venv\Scripts\activate
# macOS o Linux
source .venv/bin/activate

pip install co-op-translator
translate -l "ko" -md
co-op-review -l "ko"

For first runs on large repositories, use --dry-run before writing translated files. See the Sanggunian ng CLI for content type flags, logs, review, and link migration.

Container quick run with Bash/Zsh:

docker run --rm -it --env-file .env -v "${PWD}:/work" ghcr.io/azure/co-op-translator:latest -l "ko" -md

Container quick run with PowerShell:

docker run --rm -it --env-file .env -v ${PWD}:/work ghcr.io/azure/co-op-translator:latest -l "ko" -md

Mga Tampok

  • Awtomatikong pagsasalin para sa Markdown, mga notebook, at mga larawan
  • Pinananatiling naka-sync ang mga pagsasalin sa mga pagbabago sa source
  • Gumagana nang lokal (CLI) o sa CI (GitHub Actions)
  • Inilalantad ang mga tool sa pagsasalin ng Markdown, notebook, imahe, review, at proyekto sa pamamagitan ng MCP
  • Gumagamit ng Azure OpenAI o OpenAI para sa provider-backed na pagsasalin
  • Pinapayagan ang MCP na mag-host ng mga agent upang isalin ang mga chunk ng Markdown at notebook nang walang Co-op Translator LLM credentials
  • Gumagamit ng Azure AI Vision para sa pagkuha at pagsasalin ng teksto sa larawan
  • Nirerepaso ang estruktura at pagiging sariwa ng pagsasalin gamit ang deterministikong mga tsek
  • Pinapanatili ang format at estruktura ng Markdown

Dokumentasyon

Gabay na partikular sa Microsoft

Note

For maintainers of the Microsoft “For Beginners” repositories only.

Suportahan kami at pagyamanin ang pandaigdigang pagkatuto

Sumali sa amin sa pagbabago ng paraan ng pagbabahagi ng pang-edukasyong nilalaman sa buong mundo! Bigyan ang Co-op Translator ng ⭐ sa GitHub at suportahan ang aming misyon na gibaing ang mga hadlang sa wika sa pagkatuto at teknolohiya. Malaki ang epekto ng iyong interes at mga kontribusyon! Laging tinatanggap ang mga kontribusyon sa code at mga mungkahi sa tampok.

Tuklasin ang nilalamang pang-edukasyon ng Microsoft sa iyong wika

Presentasyon sa Video

👉 I-click ang larawan sa ibaba upang panoorin sa YouTube.

  • Open at Microsoft: Isang maikling 18-minutong pagpapakilala at mabilis na gabay kung paano gamitin ang Co-op Translator.

    Open at Microsoft

Pag-aambag

Malugod na tinatanggap ng proyektong ito ang mga ambag at mungkahi. Interesado kang mag-ambag sa Azure Co-op Translator? Mangyaring tingnan ang aming CONTRIBUTING.md para sa mga alituntunin kung paano ka makakatulong gawing mas accessible ang Co-op Translator.

Mga Nag-ambag

co-op-translator contributors

Kodigo ng Pag-uugali

Inampon ng proyektong ito ang Microsoft Open Source Code of Conduct. Para sa karagdagang impormasyon tingnan ang Code of Conduct FAQ o kontakin ang opencode@microsoft.com kung may karagdagang mga tanong o komento.

Responsable na AI

Ang Microsoft ay nakatuon sa pagtulong sa aming mga customer na gamitin ang aming mga produktong AI nang may pananagutan, pagbabahagi ng aming mga natutunan, at pagbuo ng mga pakikipagtulungan na nakabatay sa tiwala sa pamamagitan ng mga tool tulad ng Transparency Notes at Impact Assessments. Marami sa mga kabansang ito ay matatagpuan sa https://aka.ms/RAI. Ang pamamaraan ng Microsoft sa responsable na AI ay nakaugat sa aming mga prinsipyo ng AI ng pagiging patas, pagiging maaasahan at kaligtasan, privacy at seguridad, pagiging inklusibo, pagiging malinaw, at pananagutan.

Ang malakihang mga modelong natural na wika, imahe, at pagsasalita - tulad ng mga ginamit sa sample na ito - ay maaaring kumilos sa mga paraan na hindi patas, hindi maaasahan, o nakakasakit, na maaaring magdulot ng pinsala. Mangyaring sumangguni sa Azure OpenAI service Transparency note upang maging alam sa mga panganib at limitasyon.

Ang inirerekomendang pamamaraan upang mabawasan ang mga panganib na ito ay isama ang isang safety system sa iyong arkitektura na maaaring makatuklas at maiwasan ang mapanganib na pag-uugali. Nagbibigay ang Azure AI Content Safety ng isang independiyenteng layer ng proteksyon, na kayang matukoy ang mapanganib na nilikha ng gumagamit at nilikha ng AI na nilalaman sa mga aplikasyon at serbisyo. Kasama sa Azure AI Content Safety ang mga text at image API na nagpapahintulot sa iyo na matukoy ang materyal na nakasasama. Mayroon din kaming interactive na Content Safety Studio na nagpapahintulot sa iyo na tingnan, galugarin, at subukan ang sample code para sa pagtuklas ng mapanganib na nilalaman sa iba't ibang modality. Ang sumusunod na quickstart documentation ay gagabay sa iyo sa paggawa ng mga request sa serbisyo.

Isa pang aspeto na dapat isaalang-alang ay ang pangkalahatang pagganap ng aplikasyon. Sa mga multi-modal at multi-model na aplikasyon, itinuturing namin ang pagganap bilang ang sistema ay gumaganap ayon sa iyong at ng iyong mga gumagamit na inaasahan, kabilang ang hindi pagbuo ng mapanganib na output. Mahalaga na suriin ang pagganap ng iyong pangkalahatang aplikasyon gamit ang generation quality and risk and safety metrics.

Maaari mong suriin ang iyong AI application sa iyong development environment gamit ang prompt flow SDK. Sa pamamagitan ng isang test dataset o isang target, ang mga generative AI na output ng iyong aplikasyon ay nasusukat nang kwantitatibo gamit ang mga built-in na evaluator o mga custom evaluator na iyong pipiliin. Upang makapagsimula gamit ang prompt flow sdk upang suriin ang iyong sistema, maaari mong sundan ang quickstart guide. Kapag pinatakbo mo ang isang evaluation run, maaari mong visualize the results in Azure AI Studio.

Mga Trademark

Maaaring maglaman ang proyektong ito ng mga trademark o logo para sa mga proyekto, produkto, o serbisyo. Ang awtorisadong paggamit ng mga trademark o logo ng Microsoft ay nakasalalay at dapat sumunod sa Microsoft's Trademark & Brand Guidelines. Ang paggamit ng mga trademark o logo ng Microsoft sa mga binagong bersyon ng proyektong ito ay hindi dapat magdulot ng kalituhan o magpahiwatig ng pagsuporta ng Microsoft. Anumang paggamit ng mga trademark o logo ng third-party ay nakasalalay sa mga patakaran ng nasabing third-party.

Pagkuha ng Tulong

Kung ikaw ay maipit o may mga tanong tungkol sa paggawa ng mga AI app, sumali sa:

Microsoft Foundry Discord

Kung mayroon kang puna sa produkto o mga error habang nagtatayo, bisitahin:

Microsoft Foundry Developer Forum