co-op-translator
Co-op Translator: Automatizza la Traduzione della Documentazione Educativa Senza Sforzo
Automatizza facilmente la traduzione della tua documentazione in più lingue per raggiungere un pubblico globale.
Supporto Linguistico Alimentato da Co-op Translator
[!NOTE] Queste sono le traduzioni attuali del contenuto di questo repository. Per un elenco completo delle lingue supportate da Co-op Translator, consulta la sezione Language Support.
Panoramica: semplifica la traduzione dei tuoi contenuti educativi
Le barriere linguistiche ostacolano notevolmente l’accesso a risorse educative preziose e conoscenze tecniche per studenti e sviluppatori in tutto il mondo. Questo limita la partecipazione e rallenta il ritmo dell’innovazione e dell’apprendimento globale.
Co-op Translator è nato dall’esigenza di migliorare il processo di traduzione manuale inefficiente utilizzato per le grandi serie educative di Microsoft (come le guide “For Beginners”). È diventato uno strumento potente e facile da usare, progettato per abbattere queste barriere per tutti. Fornendo traduzioni automatiche di alta qualità tramite CLI e GitHub Actions, Co-op Translator permette a educatori, studenti, ricercatori e sviluppatori di tutto il mondo di condividere e accedere alle conoscenze senza limiti linguistici.
Scopri come Co-op Translator organizza i contenuti educativi tradotti:
I file Markdown e i testi delle immagini vengono tradotti automaticamente e ordinatamente organizzati in cartelle specifiche per lingua.
Sblocca l’accesso globale ai tuoi contenuti educativi con Co-op Translator oggi stesso!
Supporto all’accesso globale per le risorse di apprendimento Microsoft
Co-op Translator aiuta a colmare il divario linguistico per importanti iniziative educative di Microsoft, automatizzando il processo di traduzione per repository che servono una comunità globale di sviluppatori. Ecco alcuni esempi che attualmente utilizzano Co-op Translator:
Caratteristiche principali
- Traduzioni automatiche: traduci testi in più lingue senza sforzo.
- Integrazione con GitHub Actions: automatizza le traduzioni come parte della tua pipeline CI/CD.
- Preservazione del Markdown: mantieni la sintassi Markdown corretta durante la traduzione.
- Traduzione del testo nelle immagini: estrai e traduci i testi contenuti nelle immagini.
- Tecnologia LLM avanzata: utilizza modelli linguistici all’avanguardia per traduzioni di alta qualità.
- Integrazione semplice: integra facilmente con la configurazione esistente del tuo progetto.
- Semplifica la localizzazione: snellisci il processo di localizzazione per i mercati internazionali.
Come funziona
Co-op Translator prende i file Markdown e le immagini dalla cartella del progetto e li elabora come segue:
- Estrazione del testo: estrae il testo dai file Markdown e, se configurato (ad esempio con Azure AI Vision), anche il testo incorporato nelle immagini.
- Traduzione AI: invia il testo estratto al modello LLM configurato (Azure OpenAI, OpenAI, ecc.) per la traduzione.
- Salvataggio del risultato: salva i file Markdown e le immagini tradotti (con testo tradotto) in cartelle specifiche per lingua, mantenendo la formattazione originale.
Come iniziare
Inizia rapidamente con la CLI o configura l’automazione completa con GitHub Actions. Scegli l’approccio più adatto al tuo flusso di lavoro:
- Command Line (CLI) - per traduzioni una tantum o controllo manuale
- GitHub Actions - per traduzioni automatiche ad ogni push
[!NOTE] Anche se questo tutorial si concentra sulle risorse Azure, puoi usare qualsiasi modello linguistico supportato.
Supporto linguistico
Co-op Translator supporta un’ampia gamma di lingue per aiutarti a raggiungere un pubblico globale. Ecco cosa devi sapere:
Riferimento rapido
| Lingua | Codice | Lingua | Codice | Lingua | Codice |
|---|---|---|---|---|---|
| Arabo | ar | Bengali | bn | Bulgaro | bg |
| Birmano (Myanmar) | my | Cinese (semplificato) | zh | Cinese (tradizionale, HK) | hk |
| Cinese (tradizionale, Macao) | mo | Cinese (tradizionale, TW) | tw | Croato | hr |
| Ceco | cs | Danese | da | Olandese | nl |
| Finlandese | fi | Francese | fr | Tedesco | de |
| Greco | el | Ebraico | he | Hindi | hi |
| Ungherese | hu | Indonesiano | id | Italiano | it |
| Giapponese | ja | Coreano | ko | Malese | ms |
| Marathi | mr | Nepalese | ne | Norvegese | no |
| Persiano (Farsi) | fa | Polacco | pl | Portoghese (Brasile) | br |
| Portoghese (Portogallo) | pt | Punjabi (Gurmukhi) | pa | Rumeno | ro |
| Russo | ru | Serbo (Cirillico) | sr | Slovacco | sk |
| Sloveno | sl | Spagnolo | es | Swahili | sw |
| Svedese | sv | Tagalog (Filippino) | tl | Thailandese | th |
| Turco | tr | Ucraino | uk | Urdu | ur |
| Vietnamita | vi | — | — | — | — |
Uso dei codici lingua
Quando usi Co-op Translator, devi specificare le lingue tramite i loro codici. Per esempio:
# Translate to French, Spanish, and German
translate -l "fr es de"
# Translate to Chinese (Simplified) and Japanese
translate -l "zh ja"
[!NOTE] Per informazioni tecniche dettagliate sul supporto linguistico, inclusi:
- Specifiche dei font per ogni lingua
- Problemi noti
- Come aggiungere nuove lingue
consulta la nostra documentazione sulle lingue supportate.
Modelli e servizi supportati
| Tipo | Nome |
|---|---|
| Modello linguistico |   |
| AI Vision |  |
[!NOTE] Se un servizio AI vision non è disponibile, co-op translator passerà alla modalità solo Markdown.
Configurazione iniziale
Prima di iniziare, devi configurare le seguenti risorse:
- Risorsa Modello Linguistico (obbligatoria):
- Azure OpenAI (consigliato) - offre traduzioni di alta qualità con affidabilità enterprise
- OpenAI - opzione alternativa se non hai accesso ad Azure
- Per dettagli sui modelli supportati, consulta Supported Models and Services
- Risorsa AI Vision (opzionale):
- Azure AI Vision - consente la traduzione del testo contenuto nelle immagini
- Se non configurata, il traduttore userà automaticamente la modalità solo Markdown
- Consigliata per progetti con immagini contenenti testo da tradurre
- Passaggi di configurazione:
- Segui la nostra guida di configurazione Azure AI per istruzioni dettagliate
- Crea un file
.envcon le tue chiavi API e endpoint (vedi la sezione Quick Start) - Assicurati di avere i permessi e le quote necessarie per i servizi scelti
Preparazione del progetto prima della traduzione
Prima di avviare il processo di traduzione, segui questi passaggi per preparare il tuo progetto:
- Prepara il tuo README:
- Aggiungi una tabella delle traduzioni al README.md per collegare le versioni tradotte
-
Esempio di formato:
### 🌐 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/)
- Pulisci eventuali traduzioni esistenti (se necessario):
- Rimuovi eventuali cartelle di traduzioni esistenti (es.
translations/) - Elimina vecchi file di traduzione per partire da zero
- Questo evita conflitti con il nuovo processo di traduzione
- Rimuovi eventuali cartelle di traduzioni esistenti (es.
Avvio rapido: Command Line
Per iniziare velocemente con la riga di comando:
-
Crea un ambiente virtuale:
python -m venv .venv -
Attiva l’ambiente virtuale:
- Su Windows:
.venv\scripts\activate- Su Linux/macOS:
source .venv/bin/activate -
Installa il pacchetto:
pip install co-op-translator -
Configura le credenziali:
- Crea un file
.envfile in your project’s root directory. - Copy the contents from the .env.template file into your new
.envfile. - Fill in the required API keys and endpoint information in your
.envfile.
- Crea un file
-
Run Translation:
- Navigate to your project’s root directory in your terminal.
- Execute the translate command, specifying target languages with the
-lflag:
translate -l "ko ja fr"(Sostituisci
"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-translatorpackage. - 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) nel tuo repository. Nessuna installazione locale necessaria. - Guide:
- GitHub Actions Guide (Public Repositories & Standard Secrets) - Usa questa guida per la maggior parte dei repository pubblici o personali che si affidano ai segreti standard del repository.
- GitHub Actions Guide (Microsoft Organization Repos & Org-Level Setups) - Usa questa guida se lavori all’interno dell’organizzazione GitHub Microsoft o se devi utilizzare segreti o runner a livello di organizzazione.
Risoluzione problemi e suggerimenti
Risorse aggiuntive
- Riferimento comandi: guida dettagliata a tutti i comandi e opzioni disponibili.
- Lingue supportate: verifica l’elenco delle lingue supportate e le istruzioni per aggiungerne di nuove.
- Modalità solo Markdown: come tradurre solo il testo, senza tradurre le immagini.
Presentazioni video
Scopri di più su Co-op Translator attraverso le nostre presentazioni (clicca sull’immagine qui sotto per guardare su YouTube):
- Open at Microsoft: una breve introduzione di 18 minuti e guida rapida su come usare Co-op Translator.
Supportaci e Favorisci l’Apprendimento Globale
Unisciti a noi nella rivoluzione del modo in cui i contenuti educativi vengono condivisi a livello globale! Dai una ⭐ a Co-op Translator su GitHub e supporta la nostra missione di abbattere le barriere linguistiche nell’apprendimento e nella tecnologia. Il tuo interesse e i tuoi contributi fanno una grande differenza! Contributi di codice e suggerimenti per nuove funzionalità sono sempre benvenuti.
Contributi
Questo progetto accoglie contributi e suggerimenti. Sei interessato a contribuire ad Azure Co-op Translator? Consulta il nostro CONTRIBUTING.md per le linee guida su come puoi aiutare a rendere Co-op Translator più accessibile.
Collaboratori
Codice di Condotta
Questo progetto ha adottato il Microsoft Open Source Code of Conduct. Per maggiori informazioni consulta le FAQ sul Codice di Condotta o contatta opencode@microsoft.com per domande o commenti aggiuntivi.
AI Responsabile
Microsoft è impegnata ad aiutare i nostri clienti a utilizzare i nostri prodotti di AI in modo responsabile, condividendo le nostre esperienze e costruendo partnership basate sulla fiducia tramite strumenti come Transparency Notes e Impact Assessments. Molte di queste risorse sono disponibili su https://aka.ms/RAI. L’approccio di Microsoft all’AI responsabile si basa sui nostri principi di AI: equità, affidabilità e sicurezza, privacy e protezione, inclusività, trasparenza e responsabilità.
Modelli di linguaggio naturale, immagini e voce su larga scala - come quelli usati in questo esempio - possono potenzialmente comportarsi in modo ingiusto, inaffidabile o offensivo, causando danni. Consulta la Transparency note del servizio Azure OpenAI per essere informato sui rischi e le limitazioni.
L’approccio consigliato per mitigare questi rischi è includere un sistema di sicurezza nella tua architettura che possa rilevare e prevenire comportamenti dannosi. Azure AI Content Safety offre un livello indipendente di protezione, in grado di identificare contenuti dannosi generati dagli utenti o dall’AI in applicazioni e servizi. Azure AI Content Safety include API per testo e immagini che permettono di individuare materiale dannoso. Disponiamo inoltre di un Content Safety Studio interattivo che consente di visualizzare, esplorare e provare esempi di codice per rilevare contenuti dannosi in diverse modalità. La seguente documentazione quickstart ti guida nell’invio di richieste al servizio.
Un altro aspetto da considerare è la performance complessiva dell’applicazione. Con applicazioni multi-modali e multi-modello, per performance intendiamo che il sistema funzioni come tu e i tuoi utenti vi aspettate, incluso il non generare output dannosi. È importante valutare le performance della tua applicazione complessiva usando metriche di qualità di generazione e di rischio e sicurezza.
Puoi valutare la tua applicazione AI nel tuo ambiente di sviluppo usando il prompt flow SDK. Fornendo un dataset di test o un obiettivo, le generazioni della tua AI generativa vengono misurate quantitativamente con valutatori integrati o personalizzati a tua scelta. Per iniziare con il prompt flow sdk e valutare il tuo sistema, puoi seguire la guida quickstart. Una volta eseguita una valutazione, puoi visualizzare i risultati in Azure AI Studio.
Marchi
Questo progetto può contenere marchi o loghi di progetti, prodotti o servizi. L’uso autorizzato dei marchi o loghi Microsoft è soggetto e deve seguire le Microsoft’s Trademark & Brand Guidelines. L’uso di marchi o loghi Microsoft in versioni modificate di questo progetto non deve causare confusione né implicare sponsorizzazione da parte di Microsoft. Qualsiasi uso di marchi o loghi di terze parti è soggetto alle politiche di tali terze parti.
Disclaimer:
Questo documento è stato tradotto utilizzando il servizio di traduzione AI Co-op Translator. Pur impegnandoci per l’accuratezza, si prega di considerare che le traduzioni automatiche possono contenere errori o inesattezze. Il documento originale nella sua lingua nativa deve essere considerato la fonte autorevole. Per informazioni critiche, si raccomanda la traduzione professionale umana. Non siamo responsabili per eventuali malintesi o interpretazioni errate derivanti dall’uso di questa traduzione.