Come tradurre file YAML online

Tradurre file di localizzazione YAML è semplice con il nostro strumento basato su IA. Segui questi passaggi per ottenere un file YAML completamente tradotto in pochi minuti:

1. Incolla il contenuto del tuo file .yaml o .yml nell'editor qui sopra.
2. Imposta la lingua di origine (o lasciala vuota per il rilevamento automatico) e inserisci il codice della lingua di destinazione (es. es, de, ja, zh).
3. Fai clic su Traduci e attendi mentre l'IA elabora il tuo contenuto YAML. La traduzione può richiedere fino a pochi minuti per file di grandi dimensioni.
4. Copia l'output tradotto o scaricalo come file .yaml pronto per essere inviato al tuo repository.

Cos'è un file YAML?

YAML (YAML Ain't Markup Language) è un formato di serializzazione dati leggibile dall'uomo ampiamente utilizzato per file di configurazione e localizzazione nello sviluppo software moderno. La sua sintassi pulita basata sull'indentazione lo rende facile da leggere e scrivere rispetto a JSON o XML.

I file YAML usano l'estensione .yaml o .yml e sono il formato di localizzazione standard per Ruby on Rails, Symfony (PHP), Vue i18n, Flutter ARB, Spring Boot e molti altri framework. Un singolo file YAML solitamente contiene tutte le stringhe tradotte per una lingua.

Poiché YAML supporta chiavi nidificate, elenchi e commenti in linea, è particolarmente adatto per organizzare grandi set di stringhe dell'interfaccia utente in una struttura gerarchica che rispecchia l'albero dei componenti dell'applicazione.

Struttura file YAML per la localizzazione

Un tipico file di localizzazione YAML utilizza coppie chiave-valore nidificate per organizzare le stringhe per funzionalità o componente. Ecco un esempio di una struttura YAML comune:

# Application configuration
app:
  name: "My Application"
  version: "2.0.0"
  description: "A powerful tool for managing your workflow"

navigation:
  home: "Home"
  about: "About Us"
  contact: "Contact"
  login: "Sign In"
  logout: "Sign Out"

messages:
  welcome: "Welcome back, {{name}}!"
  error: "An unexpected error occurred. Please try again."
  success: "Your changes have been saved successfully."

buttons:
  save: "Save"
  cancel: "Cancel"
  delete: "Delete"
  confirm: "Confirm"

• Coppie chiave-valore — la base di YAML: chiave: "Stringa tradotta".
• Chiavi nidificate — raggruppa stringhe correlate sotto un genitore comune: pulsante.salva: "Salva".
• Elenchi — sequenze ordinate di valori che utilizzano il prefisso -.
• Commenti — le righe che iniziano con # forniscono contesto per i traduttori e sono opzionalmente preservate.
• Segnaposto di interpolazione — variabili come {{name}} o %{count} vengono preservate così come sono e mai tradotte.

Esempio di file di localizzazione YAML

Di seguito è riportato un file di localizzazione YAML realistico che mostra chiavi nidificate, interpolazione e uso dei commenti come si trova nei progetti di produzione Rails e Vue i18n:

# en/messages.yaml
user:
  greeting: "Hello, {{name}}!"
  farewell: "Goodbye, {{name}}. See you soon!"
  profile:
    title: "Your Profile"
    subtitle: "Manage your account settings"
    avatar: "Profile Picture"

errors:
  notFound: "The page you are looking for does not exist."
  unauthorized: "You are not authorized to view this page."
  serverError: "A server error occurred. Please contact support."

forms:
  required: "This field is required."
  email: "Please enter a valid email address."
  minLength: "Must be at least {{min}} characters."

La nostra IA traduce tutti i valori delle stringhe lasciando chiavi, variabili di interpolazione e indentazione strutturale completamente invariate. Il risultato è un file sostitutivo immediato per la tua lingua di destinazione.

File YAML nella localizzazione software

YAML è uno dei formati più popolari per la localizzazione software perché trova il giusto equilibrio tra leggibilità umana e parsabilità della macchina. Gli sviluppatori possono modificare i file YAML direttamente senza strumenti speciali, mentre le pipeline automatizzate possono elaborarli in modo affidabile.

In un tipico flusso di lavoro di localizzazione, mantieni un file YAML per lingua (es. en.yml, de.yml, ja.yml) all'interno di una directory locales o i18n. Il file della lingua di origine viene trattato come riferimento e vengono generate copie tradotte per ogni locale di destinazione.

Framework e strumenti che utilizzano YAML per la localizzazione

I file di localizzazione YAML sono supportati da una vasta gamma di framework popolari su più linguaggi e piattaforme:

• Ruby on Rails — utilizza YAML come formato i18n nativo (config/locales/en.yml). La gemma i18n di Rails supporta chiavi nidificate, pluralizzazione e interpolazione nativamente.
• Symfony (PHP) — supporta file di traduzione YAML insieme a XLIFF. I file YAML in translations/messages.en.yaml alimentano il componente di traduzione di Symfony.
• Spring Boot (Java) — sebbene Spring utilizzi solitamente file .properties, il supporto YAML di Spring in application.yml e librerie della community come i18n4java estendono YAML alla localizzazione.
• Flutter / Dart — il pacchetto easy_localization e librerie i18n Flutter simili utilizzano file YAML per gestire le traduzioni per app mobile e desktop.
• Vue i18n — il plugin ufficiale di internazionalizzazione di Vue.js supporta file di messaggi YAML. Vite-plugin-vue-i18n consente di importare file .yaml direttamente come componenti Vue.
• React / Next.js — librerie come next-i18next e react-i18next possono caricare file di traduzione YAML tramite backend personalizzati, rendendoli una scelta popolare per la localizzazione Next.js.

Generazione glossario IA per traduzioni YAML

La nostra funzione di generazione glossario IA ti aiuta a mantenere una terminologia coerente in tutti i tuoi file di localizzazione YAML. Abilita il salvataggio e il riutilizzo attivando Genera e salva glossario nelle opzioni di traduzione:

• Terminologia coerente — l'IA analizza il tuo YAML di origine e le traduzioni di destinazione esistenti per creare un glossario di termini chiave, assicurando che nomi prodotto, etichette UI e termini tecnici siano tradotti allo stesso modo in tutta la tua app.
• Termini specifici del dominio — fornisci un campione di contenuto YAML già tradotto nel campo delle stringhe di destinazione. L'IA apprende la tua terminologia preferita e la applica automaticamente alle nuove stringhe.
• Come usarlo — incolla il tuo contenuto YAML tradotto nel campo opzionale delle stringhe di destinazione che appare quando la generazione del glossario è abilitata. L'IA estrarrà i termini ricorrenti e li userà come guida alla traduzione. Se non vengono fornite stringhe di destinazione, l'IA genera voci del glossario solo dal contenuto di origine, il che può comunque migliorare la coerenza.

Perché usare L10n.dev per la traduzione YAML?

• Accuratezza basata su IA — il nostro motore di traduzione comprende il contesto di localizzazione YAML, non solo il testo grezzo. Traduce stringhe leggibili dall'uomo ignorando chiavi, ancore, alias e sintassi strutturale.
• Preservazione della struttura — indentazione, nidificazione e gerarchia YAML sono sempre preservate. Il file tradotto è un documento YAML valido che può essere analizzato senza modifiche.
• Supporto all'interpolazione — segnaposto come {{name}}, %{count}, :variable e variabili del formato messaggio ICU vengono rilevati e lasciati intatti durante la traduzione.
• Consapevolezza delle chiavi nidificate — l'IA comprende la struttura gerarchica di file YAML profondamente nidificati e mantiene un contesto accurato per ogni stringa in base alla sua posizione nell'albero.
• Compatibilità multi-framework — l'output è compatibile con Ruby on Rails, Symfony, Vue i18n, Flutter, Spring Boot e qualsiasi altro framework che consuma file di localizzazione YAML standard.
• Traduci fino a 10,000 caratteri gratuitamente. I piani a pagamento offrono prezzi scalabili per progetti più grandi. Visualizza prezzi
• Ottimizzato per file di grandi dimensioni — per file YAML molto grandi (centinaia di kilobyte), utilizza la pagina Traduzione file I18N che supporta caricamenti di file fino a 5 MB.

Casi d'uso comuni per la traduzione YAML

La traduzione YAML è utilizzata in una vasta gamma di tipi di applicazioni e flussi di lavoro di sviluppo:

• App Ruby on Rails — traduci config/locales/en.yml in file di lingua aggiuntivi per applicazioni Rails multilingue.
• Progetti Symfony PHP — localizza translations/messages.en.yaml e file di traduzione specifici del dominio per siti web e API basati su Symfony.
• App Vue.js / Nuxt.js — traduci file di messaggi YAML Vue i18n per aggiungere il supporto linguistico ad applicazioni Vue a pagina singola e siti statici Nuxt.js.
• App mobile Flutter — traduci file di localizzazione assets/lang/en.yaml per app Flutter multipiattaforma rivolte a più mercati.
• Configurazione e contenuti CMS — traduci file di configurazione YAML utilizzati da generatori di siti statici come Jekyll, Hugo o Gatsby per contenuti di siti multilingue.
• Generatori di siti statici — Jekyll usa file YAML _data/ per stringhe a livello di sito, Hugo usa file YAML i18n/ e Gatsby supporta YAML tramite gatsby-plugin-react-i18next.
• Pipeline CI/CD e DevOps — integra la traduzione YAML nella tua pipeline di distribuzione utilizzando l'API REST di L10n.dev per automatizzare la localizzazione come parte del tuo flusso di lavoro di rilascio.

YAML vs JSON per la localizzazione

Sia YAML che JSON sono ampiamente utilizzati per i file di localizzazione, ma hanno punti di forza diversi. La sintassi leggibile dall'uomo di YAML, il supporto per i commenti e le stringhe multiriga compatte lo rendono preferito in community come Ruby e PHP dove gli sviluppatori modificano frequentemente i file di traduzione a mano.

JSON è più universalmente supportato negli ecosistemi JavaScript (React, Angular, Vue) ed è più facile da analizzare programmaticamente. Se il tuo progetto utilizza entrambi i formati, L10n.dev li supporta entrambi — puoi tradurre file JSON nella pagina Traduzione JSON e file YAML qui.

Per la maggior parte dei progetti la scelta del formato è dettata dal framework che utilizzi. Se usi Rails, Symfony o Vue i18n, YAML è la scelta naturale. Se usi Angular i18next, React i18next o Next.js, JSON è più comune. L10n.dev gestisce entrambi ugualmente bene.

Domande frequenti

Quali parti del mio file YAML vengono preservate durante la traduzione?

Tutti gli elementi strutturali YAML vengono preservati: chiavi, indentazione, nidificazione, ancore (&), alias (*), commenti (#) e sintassi degli elenchi (-). I segnaposto di interpolazione come {{variable}}, %{name} e :symbol vengono sempre lasciati invariati. Vengono tradotti solo i valori delle stringhe leggibili dall'uomo.

Le variabili di interpolazione e i segnaposto sono sicuri durante la traduzione?

Sì. La nostra IA rileva i modelli di interpolazione comuni utilizzati da Rails (%{name}), Vue i18n ({name}), Symfony (%variable%), Flutter ({name}) e formato messaggio ICU. Queste variabili vengono preservate esattamente come scritte e non vengono mai tradotte o modificate.

Come traduco un file YAML?

Incolla il contenuto del tuo file .yaml o .yml nell'editor qui sopra, imposta il codice della lingua di destinazione (es. fr, de, ja, zh) e fai clic su Traduci. L'IA restituisce un file YAML completamente tradotto con tutte le chiavi e la struttura preservate. Scarica il risultato come file .yaml.

In che modo la generazione del glossario IA aiuta con la traduzione YAML?

Abilitare Genera e salva glossario ti consente di incollare il contenuto YAML tradotto esistente insieme al tuo file di origine. L'IA estrae i termini ricorrenti e li usa come guida alla traduzione, assicurando che nomi prodotto, etichette delle funzionalità e termini di dominio siano tradotti in modo coerente in tutto il file e nelle traduzioni future.

Posso tradurre file di localizzazione YAML di grandi dimensioni?

Questa pagina funziona bene per singoli file YAML fino a poche centinaia di kilobyte. Per la traduzione YAML in blocco o file molto grandi, utilizza la pagina Traduzione file I18N che supporta caricamenti di file fino a 5 MB e fornisce una consegna più affidabile per progetti di localizzazione su larga scala.