co-op-translator

Co-op Translator: Automatizează traducerea documentației educaționale fără efort

Automatizează cu ușurință traducerea documentației tale în mai multe limbi pentru a ajunge la un public global.

Suport pentru limbi oferit de Co-op Translator

Franceză | Spaniolă | Germană | Rusă | Arabă | Persană (Farsi) | Urdu | Chineză (Simplificată) | Chineză (Tradițională, Macau) | Chineză (Tradițională, Hong Kong) | Chineză (Tradițională, Taiwan) | Japoneză | Coreeană | Hindi | Bengaleză | Marathi | Nepaleză | Punjabi (Gurmukhi) | Portugheză (Portugalia) | Portugheză (Brazilia) | Italiană | Poloneză | Turcă | Greacă | Thailandeză | Suedeză | Daneză | Norvegiană | Finlandeză | Olandeză | Ebraică | Vietnameză | Indoneziană | Malay | Tagalog (Filipineză) | Swahili | Maghiară | Cehă | Slovacă | Română | Bulgară | Sârbă (Chirilică) | Croată | Slovenă | Ucraineană | Burmese (Myanmar)

[!NOTE] Acestea sunt traducerile curente ale conținutului acestui depozit. Pentru o listă completă a limbilor suportate de Co-op Translator, vă rugăm să consultați secțiunea Language Support.

Prezentare generală: Simplifică traducerea conținutului educațional

Barierele lingvistice împiedică semnificativ accesul la resurse educaționale valoroase și la cunoștințe tehnice pentru cursanți și dezvoltatori din întreaga lume. Acest lucru limitează participarea și încetinește ritmul inovației și al învățării la nivel global.

Co-op Translator a luat naștere din nevoia de a rezolva procesul ineficient de traducere manuală pentru propriile serii educaționale ample ale Microsoft (precum ghidurile „Pentru Începători”). A evoluat într-un instrument puternic și ușor de folosit, conceput să elimine aceste bariere pentru toată lumea. Oferind traduceri automate de înaltă calitate prin CLI și GitHub Actions, Co-op Translator le permite educatorilor, studenților, cercetătorilor și dezvoltatorilor din întreaga lume să partajeze și să acceseze cunoștințe fără constrângeri lingvistice.

Vezi cum organizează Co-op Translator conținutul educațional tradus:

Fișierele Markdown și textele din imagini sunt traduse automat și organizate ordonat în foldere specifice fiecărei limbi.

Deschide astăzi accesul global la conținutul tău educațional cu Co-op Translator!

Susținerea accesului global la resursele educaționale Microsoft

Co-op Translator ajută la eliminarea barierei lingvistice pentru inițiativele educaționale cheie Microsoft, automatizând procesul de traducere pentru depozitele care deservesc o comunitate globală de dezvoltatori. Exemple de proiecte care folosesc în prezent Co-op Translator includ:

Caracteristici cheie

• Traduceri automate: Traduce textul în mai multe limbi fără efort.
• Integrare GitHub Actions: Automatizează traducerile ca parte din pipeline-ul tău CI/CD.
• Păstrarea formatului Markdown: Menține sintaxa corectă Markdown în timpul traducerii.
• Traducerea textului din imagini: Extrage și traduce textul din imagini.
• Tehnologie avansată LLM: Folosește modele lingvistice de ultimă generație pentru traduceri de calitate superioară.
• Integrare ușoară: Se integrează fără probleme cu configurația ta actuală de proiect.
• Simplifică localizarea: Simplifică procesul de localizare a proiectului pentru piețele internaționale.

Cum funcționează

Co-op Translator preia fișiere Markdown și imagini din folderul proiectului tău și le procesează astfel:

1. Extracția textului: Extrage textul din fișierele Markdown și, dacă este configurat (de exemplu, cu Azure AI Vision), și textul încorporat în imagini.
2. Traducerea AI: Trimite textul extras către modelul LLM configurat (Azure OpenAI, OpenAI etc.) pentru traducere.
3. Salvarea rezultatului: Salvează fișierele Markdown traduse și imaginile (cu text tradus) în foldere specifice limbilor, păstrând formatul original.

Începe rapid

Începe rapid folosind CLI sau configurează automatizarea completă cu GitHub Actions. Alege metoda care se potrivește cel mai bine fluxului tău de lucru:

1. Linia de comandă (CLI) - Pentru traduceri ocazionale sau control manual
2. GitHub Actions - Pentru traduceri automate la fiecare push

[!NOTE] Deși acest tutorial se concentrează pe resursele Azure, poți folosi orice model lingvistic suportat.

Suport pentru limbi

Co-op Translator suportă o gamă largă de limbi pentru a te ajuta să ajungi la un public global. Iată ce trebuie să știi:

Referință rapidă

Limbă	Cod	Limbă	Cod	Limbă	Cod
Arabică	ar	Bengali	bn	Bulgară	bg
Birmaneză (Myanmar)	my	Chineză (Simplificată)	zh	Chineză (Tradițională, HK)	hk
Chineză (Tradițională, Macau)	mo	Chineză (Tradițională, TW)	tw	Croată	hr
Cehă	cs	Daneză	da	Olandeză	nl
Finlandeză	fi	Franceză	fr	Germană	de
Greacă	el	Ebraică	he	Hindi	hi
Maghiară	hu	Indoneziană	id	Italiană	it
Japoneză	ja	Coreeană	ko	Malay	ms
Marathi	mr	Nepaleză	ne	Norvegiană	no
Persană (Farsi)	fa	Poloneză	pl	Portugheză (Brazilia)	br
Portugheză (Portugalia)	pt	Punjabi (Gurmukhi)	pa	Română	ro
Rusă	ru	Sârbă (Chirilică)	sr	Slovacă	sk
Slovenă	sl	Spaniolă	es	Swahili	sw
Suedeză	sv	Tagalog (Filipineză)	tl	Thailandeză	th
Turcă	tr	Ucraineană	uk	Urdu	ur
Vietnameză	vi	—	—	—	—

Utilizarea codurilor de limbă

Când folosești Co-op Translator, trebuie să specifici limbile folosind codurile lor. De exemplu:

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

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

[!NOTE] Pentru informații tehnice detaliate despre suportul pentru limbi, inclusiv:

• Specificații de font pentru fiecare limbă
• Probleme cunoscute
• Cum să adaugi limbi noi

Consultă documentația noastră Supported Languages Documentation.

Modele și servicii suportate

Tip	Nume
Model lingvistic
AI Vision

[!NOTE] Dacă un serviciu AI Vision nu este disponibil, co-op translator va trece automat în modul Markdown-only.

Configurare inițială

Înainte de a începe, va trebui să configurezi următoarele resurse:

1. Resursă Model Lingvistic (Obligatoriu):
   • Azure OpenAI (Recomandat) - Oferă traduceri de înaltă calitate cu fiabilitate la nivel enterprise
   • OpenAI - Opțiune alternativă dacă nu ai acces la Azure
   • Pentru informații detaliate despre modelele suportate, vezi Supported Models and Services
2. Resursă AI Vision (Opțional):
   • Azure AI Vision - Permite traducerea textului din imagini
   • Dacă nu este configurat, translatorul va folosi automat modul Markdown-only
   • Recomandat pentru proiecte cu imagini care conțin text ce trebuie tradus
3. Pași de configurare:
   • Urmează ghidul nostru Azure AI setup guide pentru instrucțiuni detaliate
   • Creează un fișier .env cu cheile API și endpoint-urile tale (vezi secțiunea Quick Start)
   • Asigură-te că ai permisiunile și cotele necesare pentru serviciile alese

Pregătirea proiectului înainte de traducere

Înainte de a începe procesul de traducere, urmează acești pași pentru a-ți pregăti proiectul:

1. Pregătește README-ul:
   • Adaugă un tabel cu traduceri în README.md pentru a lega versiunile traduse

   • Format exemplu:

     
     ### 🌐 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. Curățarea traducerilor existente (dacă este necesar):
   • Șterge orice foldere de traduceri existente (ex: translations/)
   • Elimină fișierele vechi de traducere pentru a începe de la zero
   • Acest lucru previne conflictele cu noul proces de traducere

Pornire rapidă: Linia de comandă

Pentru un start rapid folosind linia de comandă:

1. Creează un mediu virtual:

    python -m venv .venv
   

2. Activează mediul virtual:

   • Pe Windows:

    .venv\scripts\activate
   

   • Pe Linux/macOS:

    source .venv/bin/activate
   

3. Instalează pachetul:

    pip install co-op-translator
   

4. Configurează acreditările:

   • Creează un fișier .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 flag:

    translate -l "ko ja fr"
   

   (Înlocuiește "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)

• Best for: One-time translations, manual control, or integration into custom scripts.
• Requires: Local installation of Python and the co-op-translator package.
• Guide: Command Line Guide

2. Using GitHub Actions (Automation)

• Best for: Automatically translating content whenever changes are pushed to your repository. Keeps translations consistently up-to-date.
• Requires: Setting up a workflow file (.github/workflows) în depozitul tău. Nu este necesară instalarea locală.
• Ghiduri:
  • GitHub Actions Guide (Public Repositories & Standard Secrets) - Folosește acest ghid pentru majoritatea depozitelor publice sau personale care se bazează pe secrete standard ale depozitului.
  • GitHub Actions Guide (Microsoft Organization Repos & Org-Level Setups) - Folosește acest ghid dacă lucrezi în organizația GitHub Microsoft sau ai nevoie să folosești secrete sau runneri la nivel de organizație.

Depanare și sfaturi

• Ghid de depanare

Resurse suplimentare

• Referință comandă: Ghid detaliat pentru toate comenzile și opțiunile disponibile.
• Limbi suportate: Verifică lista limbilor suportate și instrucțiuni pentru adăugarea altora noi.
• Modul Markdown-only: Cum să traduci doar textul, fără traducerea imaginilor.

Prezentări video

Află mai multe despre Co-op Translator prin prezentările noastre (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.

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

Alătură-te nouă în revoluționarea modului în care conținutul educațional este distribuit la nivel global! Oferă Co-op Translator un ⭐ pe GitHub ș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.

Contribuții

Acest proiect primește cu plăcere 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.

Contribuitori

Cod de conduită

Acest proiect a adoptat Microsoft Open Source Code of Conduct. Pentru mai multe informații, vezi Code of Conduct FAQ sau contactează opencode@microsoft.com pentru întrebări sau comentarii suplimentare.

Inteligență Artificială Responsabilă

Microsoft se angajează să ajute clienții să utilizeze produsele noastre AI în mod responsabil, î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 pentru AI responsabilă se bazează pe principiile noastre de corectitudine, fiabilitate și siguranță, confidențialitate și securitate, incluziune, transparență și responsabilitate.

Modelele de limbaj natural, imagine și voce la scară largă – precum cele folosite în acest exemplu – pot avea comportamente care sunt nedrepte, nesigure sau ofensatoare, cauzând astfel prejudicii. Te rugăm să consulți Azure OpenAI service Transparency note pentru a fi informat despre riscuri și limitări.

Abordarea recomandată pentru a reduce aceste riscuri este să incluzi în arhitectura ta un sistem de siguranță care să poată detecta și preveni comportamentele dăunătoare. Azure AI Content Safety oferă un strat independent de protecție, capabil să detecteze conținut dăunător generat de utilizatori sau de AI în aplicații și servicii. Azure AI Content Safety include API-uri pentru text și imagine care permit detectarea materialelor dăunătoare. De asemenea, avem un Content Safety Studio interactiv care îți permite să vizualizezi, să explorezi și să testezi coduri exemplu pentru detectarea conținutului dăunător în diverse modalități. Următoarea documentație quickstart te ghidează pas cu pas în realizarea cererilor către serviciu.

Un alt aspect de luat în considerare este performanța generală a aplicației. În cazul aplicațiilor multimodale și cu mai multe modele, performanța înseamnă că sistemul funcționează așa cum te aștepți tu și utilizatorii tăi, inclusiv să nu genereze rezultate dăunătoare. Este important să evaluezi performanța aplicației tale folosind metrici de calitate a generării și de risc și siguranță.

Poți evalua aplicația ta AI în mediul de dezvoltare folosind prompt flow SDK. Fie că ai un set de date de test sau un obiectiv, generațiile aplicației tale AI generative sunt măsurate cantitativ cu evaluatori încorporați sau evaluatori personalizați la alegere. Pentru a începe să folosești prompt flow SDK pentru a evalua sistemul tău, poți urma ghidul quickstart. După ce rulezi o evaluare, poț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 de către Microsoft.
Orice utilizare a mărcilor comerciale sau logo-urilor unor terțe părți este supusă politicilor acelor terțe părți.

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ă țineți cont că traducerile automate pot conține erori sau inexactități. Documentul original, în limba sa nativă, trebuie considerat sursa autoritară. Pentru informații critice, se recomandă traducerea profesională realizată de un specialist uman. Nu ne asumăm răspunderea pentru eventualele neînțelegeri sau interpretări greșite rezultate din utilizarea acestei traduceri.

This site is open source. Improve this page.