Skip to content

Latest commit

 

History

History
248 lines (176 loc) · 17 KB

File metadata and controls

248 lines (176 loc) · 17 KB

Co-op Translator

Automatizează și menține cu ușurință traducerile pentru conținutul educațional GitHub în mai multe limbi pe măsură ce proiectul tău evoluează.

Python 3.10–3.12 Python package License: MIT Downloads Downloads Container: GHCR Code style: black

GitHub contributors GitHub issues GitHub pull-requests PRs Welcome

🌐 Suport multilingv

Suportat de 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

Preferi să clonezi local?

Acest depozit include peste 50 de traduceri în limbi care cresc semnificativ dimensiunea descărcării. Pentru a clona fără traduceri, folosește 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"

Aceasta îți oferă tot ce ai nevoie pentru a finaliza cursul cu o descărcare mult mai rapidă.

GitHub watchers GitHub forks GitHub stars

Microsoft Foundry Discord

Open in GitHub Codespaces

Prezentare generală

Co-op Translator te ajută să localizezi cu ușurință conținutul educațional GitHub în mai multe limbi. Când actualizezi fișierele Markdown, imaginile sau caietele, traducerile rămân automat sincronizate, asigurând că materialul tău este întotdeauna exact și actualizat pentru cursanții din întreaga lume.

Exemplu despre cum este organizat conținutul tradus:

Example

Cum este gestionată starea traducerii

Co-op Translator gestionează conținutul tradus ca artefacte software versionate,
nu ca fișiere statice.

Instrumentul urmărește starea traducerilor pentru Markdown, imagini și caiete folosind metadate cu scop pe limbă.

Această arhitectură permite Co-op Translator să:

  • Detecteze în mod fiabil traducerile învechite
  • Trateze Markdown, imaginile și caietele în mod consecvent
  • Se scaleze în siguranță pe depozite mari, dinamice, multi-lingvistice

Prin modelarea traducerilor ca artefacte gestionate, fluxurile de lucru pentru traducere se aliniază natural cu practicile moderne de gestionare a dependențelor și artefactelor software.

Cum este gestionată starea traducerii

Început rapid

# Creează și activează un mediu virtual (recomandat)
python -m venv .venv
# Windows
.venv\Scripts\activate
# macOS/Linux
source .venv/bin/activate
# Instalează pachetul
pip install co-op-translator
# Traduce
translate -l "ko ja fr" -md

Docker:

# Preia imaginea publică de la GHCR
docker pull ghcr.io/azure/co-op-translator:latest
# Rulează cu folderul curent montat și .env furnizat (Bash/Zsh)
docker run --rm -it --env-file .env -v "${PWD}:/work" ghcr.io/azure/co-op-translator:latest -l "ko ja fr" -md

Configurare minimală

  1. Asigură-te că ai o versiune Python suportată (în prezent 3.10-3.12). În poetry (pyproject.toml) acest lucru este gestionat automat.
  2. Creează un fișier .env folosind șablonul: .env.template
  3. Configurează un furnizor LLM (Azure OpenAI sau OpenAI)
  4. (Opțional) Pentru traducerea imaginilor (-img), configurează Azure AI Vision
  5. (Opțional) Poți configura mai multe seturi de credențiale duplicând variabilele cu sufixe precum _1, _2, etc. Toate variabilele dintr-un set trebuie să aibă același sufix.
  6. (Recomandat) Curăță orice traduceri anterioare pentru a evita conflictele (ex.: translations/)
  7. (Recomandat) Adaugă o secțiune pentru traduceri în README folosind șablonul README languages
  8. Vezi: Configurare Azure AI

Utilizare

Tradu toate tipurile suportate:

translate -l "ko ja"

Doar Markdown:

translate -l "de" -md

Markdown + imagini:

translate -l "pt" -md -img

Doar caiete:

translate -l "zh" -nb

Mai multe opțiuni: Referință comenzi

Caracteristici

  • Traducere automată pentru Markdown, caiete și imagini
  • Menține traducerile sincronizate cu modificările sursă
  • Funcționează local (CLI) sau în CI (GitHub Actions)
  • Folosește Azure OpenAI sau OpenAI; opțional Azure AI Vision pentru imagini
  • Păstrează formatul și structura Markdown

Documentație

Ghid specific Microsoft

Note

Pentru întreținătorii depozitelor „For Beginners” Microsoft numai.

Susține-ne și promovează învățarea globală

Alătură-te revoluției în modul în care conținutul educațional este distribuit la nivel global! Dă un ⭐ pe GitHub proiectului Co-op Translator și susține misiunea noastră de a elimina barierele lingvistice în învățare și tehnologie. Interesul și contribuțiile tale au un impact semnificativ! Contribuțiile de cod și sugestiile de funcționalități sunt întotdeauna binevenite.

Explorează conținutul educațional Microsoft în limba ta

Prezentări video

👉 Click pe imaginea de mai jos pentru a viziona pe YouTube.

  • Open at Microsoft: O introducere scurtă de 18 minute și un ghid rapid despre cum să folosești Co-op Translator.

    Open at Microsoft

Contribuții

Acest proiect este deschis pentru contribuții și sugestii. Ești interesat să contribui la Azure Co-op Translator? Te rugăm să consulți CONTRIBUTING.md pentru ghiduri despre cum poți ajuta la creșterea accesibilității Co-op Translator.

Contributori

co-op-translator contributors

Codul de conduită

Acest proiect a adoptat Microsoft Open Source Code of Conduct. Pentru mai multe informații vedeți Code of Conduct FAQ sau contactați [email protected] pentru orice întrebări sau comentarii suplimentare.

Inteligență Artificială Responsabilă

Microsoft este angajată să ajute clienții noștri să utilizeze responsabil produsele noastre AI, împărtășind experiențele noastre și construind parteneriate bazate pe încredere prin instrumente precum Transparency Notes și Impact Assessments. Multe dintre aceste resurse pot fi găsite la https://aka.ms/RAI. Abordarea Microsoft privind inteligența artificială responsabilă se bazează pe principiile noastre AI de echitate, fiabilitate și siguranță, confidențialitate și securitate, incluziune, transparență și responsabilitate.

Modelele de limbaj natural, imagine și vorbire la scară largă - cum sunt cele folosite în acest exemplu - pot avea comportamente care sunt nedrepte, nesigure sau ofensatoare, cauzând astfel prejudicii. Vă rugăm să consultați Notă de transparență a serviciului Azure OpenAI pentru a fi informat despre riscuri și limitări.

Abordarea recomandată pentru atenuarea acestor riscuri este să includeți un sistem de siguranță în arhitectura dvs. care poate detecta și preveni comportamentele dăunătoare. Azure AI Content Safety oferă un strat independent de protecție, capabil să detecteze conținutul generat de utilizatori și de AI care este dăunător în aplicații și servicii. Azure AI Content Safety include API-uri de text și imagine care vă permit să detectați materiale dăunătoare. De asemenea, avem un Content Safety Studio interactiv care vă permite să vizualizați, să explorați și să încercați coduri de probă pentru detectarea conținutului dăunător în diferite modalități. Următoarea documentație quickstart vă ghidează cum să faceți solicitări către serviciu.

Un alt aspect de luat în calcul este performanța generală a aplicației. În cazul aplicațiilor multi-modale și multi-model, considerăm performanța ca fiind faptul că sistemul funcționează așa cum vă așteptați dvs. și utilizatorii dvs., inclusiv evitând generarea de rezultate dăunătoare. Este important să evaluați performanța aplicației dvs. globale folosind metrici de calitate a generării și de risc și siguranță.

Puteți evalua aplicația AI în mediul dvs. de dezvoltare folosind prompt flow SDK. Având un set de date de testare sau un obiectiv, generațiile aplicației dvs. generative AI sunt măsurate cantitativ cu evaluatori încorporați sau evaluatori personalizați la alegere. Pentru a începe cu prompt flow sdk pentru a evalua sistemul, puteți urma ghidul quickstart. După ce executați o rulare de evaluare, puteți vizualiza rezultatele în Azure AI Studio.

Mărci comerciale

Acest proiect poate conține mărci comerciale sau logo-uri pentru proiecte, produse sau servicii. Utilizarea autorizată a mărcilor comerciale sau logo-urilor Microsoft este supusă și trebuie să respecte Microsoft's Trademark & Brand Guidelines. Utilizarea mărcilor comerciale sau logo-urilor Microsoft în versiuni modificate ale acestui proiect nu trebuie să creeze confuzie sau să sugereze sponsorizarea Microsoft. Orice utilizare a mărcilor sau logo-urilor unor terți este supusă politicilor acelorași terți.

Obținerea ajutorului

Dacă vă blocați sau aveți întrebări despre dezvoltarea aplicațiilor AI, alăturați-vă:

Microsoft Foundry Discord

Dacă aveți feedback despre produs sau erori în timpul dezvoltării vizitați:

Microsoft Foundry Developer Forum


Declinare a responsabilității: Acest document a fost tradus folosind serviciul de traducere AI Co-op Translator. Deși ne străduim pentru acuratețe, vă rugăm să rețineți că traducerile automate pot conține erori sau inexactități. Documentul original în limba sa nativă trebuie considerat sursa autorizată. Pentru informații critice, se recomandă traducerea profesională realizată de un specialist uman. Nu suntem responsabili pentru eventualele neînțelegeri sau interpretări greșite care decurg din utilizarea acestei traduceri.