localize.dev

Documentación / Traducir / JSON

Traducir archivos de localización JSON

Rellena las traducciones que faltan en archivos JSON de i18next, react-intl, vue-i18n, ngx-translate y Transloco, con marcadores de posición, mensajes ICU y cada forma plural que cada idioma necesita.

Cómo funciona

localize-dev translate lee el archivo JSON en su idioma de origen, encuentra las claves que faltan en cada idioma y las escribe, en el orden de claves del archivo de origen para que los archivos difieran limpiamente. Las traducciones que ya tiene no se tocan.

Conoce las convenciones de cada biblioteca: anidación {{name}}, $t(key) de i18next y sufijos plurales _one / _other, mensajes ICU de react-intl y next-intl, plurales | de vue-i18n, enlaces @:key y literales {'@'}, y Laravel :name.

Antes y después

Salida real de localize-dev translate --locales pl en el primer archivo. El inglés tiene dos formas plurales. El polaco tiene cuatro, por lo que se agregan _few y _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 · polaco
{
  "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>"
  }
}

Lo que se mantiene intacto

  • Marcadores de posición, comprobados: se rechaza una traducción que agrega, elimina o renombra uno
  • Marcas como <1>…</1> para <Trans>
  • Cada forma plural que usa el idioma: _few y _many en polaco, seis formas en árabe
  • El orden de claves y la indentación del archivo de origen

Errores comunes y cómo se evitan

Copiando solo _one y _other

El inglés necesita dos formas plurales, por lo que un archivo con _one y _other parece completo. El polaco, el ruso y el árabe necesitan más, y i18next recurre silenciosamente a _other. Se escribe cada forma que utiliza el idioma de destino, y un plural solo se considera traducido una vez que están todas presentes.

Marcadores de posición que se traducen

Al pedir que se traduzca Welcome back, {{name}}, un modelo a veces también traduce name. Los marcadores de posición se enmascaran antes de la traducción y se comprueban después. Una traducción que los cambia se vuelve a intentar, luego se omite y se informa, pero nunca se escribe.

Plurales dentro de una oración más larga

Un plural o select de ICU anidado dentro de otro texto no se puede dividir de forma segura. Los plurales y selects de nivel superior se traducen rama por rama; los anidados se informan para que pueda traducirlos manualmente.

Ejecutar

En la carpeta que contiene tus archivos de localización. Los idiomas que aún no tienen archivo obtienen uno. --dry-run muestra qué cambiaría primero.

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

Luego mantenlo completo en CI. Esto no necesita una clave API y falla cuando a un idioma le faltan traducciones:

npx localize-dev check --only translations

Gratis para 1000 cadenas al mes. Una cadena cuenta una vez sin importar en cuántos idiomas se incluya. Crea una cuenta gratuita

Guías para aplicaciones que usan este formato

Cuando el texto todavía está codificado en tu código, localize-dev run lo mueve a este formato primero.