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.
{
"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>"
}
}{
"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:
_fewe_manyin 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,deQuindi tienilo completo in CI. Non richiede alcuna chiave API e fallisce quando a una lingua mancano le traduzioni:
npx localize-dev check --only translationsGratuito 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.