localize.dev

Documenti / Traduci / JSON

Traduci file di localizzazione JSON

Compila le traduzioni mancanti nei file JSON di i18next, react-intl, vue-i18n, ngx-translate e Transloco, con segnaposto, messaggi ICU e ogni forma plurale di cui ogni lingua ha bisogno.

Come funziona

localize-dev translate legge il file JSON nella tua lingua di origine, trova le chiavi mancanti in ogni altra lingua e le scrive, nell'ordine delle chiavi del file sorgente in modo che i file vengano confrontati in modo pulito. Le traduzioni che hai già non vengono toccate.

Conosce le convenzioni di ogni libreria: i18next {{name}}, annidamento $t(key) e suffissi plurali _one / _other, messaggi ICU di react-intl e next-intl, plurali | di vue-i18n, link @:key e letterali {'@'}, e Laravel :name.

Prima e dopo

Output effettivo di localize-dev translate --locales pl sul primo file. L'inglese ha due forme plurali. Il polacco ne ha quattro, quindi vengono aggiunti _few e _many.

locales/en.json
{
  "inbox": {
    "title": "Inbox",
    "welcome": "Welcome back, {{name}}",
    "unread_one": "{{count}} unread message",
    "unread_other": "{{count}} unread messages",
    "empty": "Nothing here yet. <1>Write a message</1>"
  }
}
locales/pl.json · polacco
{
  "inbox": {
    "title": "Skrzynka odbiorcza",
    "welcome": "Witaj ponownie, {{name}}",
    "unread_one": "{{count}} nieprzeczytana wiadomość",
    "unread_few": "{{count}} nieprzeczytane wiadomości",
    "unread_many": "{{count}} nieprzeczytanych wiadomości",
    "unread_other": "{{count}} nieprzeczytanych wiadomości",
    "empty": "Nic tu jeszcze nie ma. <1>Napisz wiadomość</1>"
  }
}

Cosa rimane intatto

  • Segnaposto, controllati: viene rifiutata una traduzione che ne aggiunge, elimina o rinomina uno
  • Markup come <1>…</1> per <Trans>
  • Ogni forma plurale utilizzata dalla lingua: _few e _many in polacco, sei forme in arabo
  • L'ordine delle chiavi e l'indentazione del file sorgente

Errori comuni e come vengono evitati

Copia solo _one e _other

L'inglese richiede due forme plurali, quindi un file con _one e _other sembra completo. Il polacco, il russo e l'arabo ne richiedono di più, e i18next ripiega silenziosamente su _other. Ogni forma utilizzata dalla lingua di destinazione viene scritta, e un plurale viene considerato tradotto solo una volta che sono tutte presenti.

Segnaposto che vengono tradotti

Quando viene chiesto di tradurre Welcome back, {{name}}, un modello a volte traduce anche name. I segnaposto vengono mascherati prima della traduzione e controllati dopo. Una traduzione che li modifica viene ritentata, quindi omessa e segnalata, mai scritta.

Plurali all'interno di una frase più lunga

Un plurale o un select ICU annidato all'interno di altro testo non può essere separato in modo sicuro. I plurali e i select di primo livello vengono tradotti ramo per ramo; quelli annidati vengono segnalati in modo da poterli tradurre manualmente.

Esegui

Nella cartella che contiene i file di localizzazione. Le lingue senza un file ne ottengono uno. --dry-run mostra cosa cambierebbe per primo.

npx localize-dev login

# Preview, then write the missing translations
npx localize-dev translate --dry-run -l es,fr,de
npx localize-dev translate -l es,fr,de

Quindi tienilo completo in CI. Non richiede alcuna chiave API e fallisce quando a una lingua mancano le traduzioni:

npx localize-dev check --only translations

Gratuito per 1000 stringhe al mese. Una stringa conta una volta, indipendentemente da quante lingue includa. Crea un account gratuito

Guide per le app che utilizzano questo formato

Quando il testo è ancora hardcoded nel tuo codice, localize-dev run lo sposta prima in questo formato.