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.
{
"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>"
}
}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:
_fewy_manyen 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,deLuego mantenlo completo en CI. Esto no necesita una clave API y falla cuando a un idioma le faltan traducciones:
npx localize-dev check --only translationsGratis 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.