Documentación / Traducir / Extension messages.json
Traducir archivos messages.json de extensiones
Traduzca _locales/en/messages.json para extensiones de Chrome, Edge y Firefox a cada idioma, manteniendo los tokens $PLACEHOLDER$ y usando las descripciones como contexto.
Cómo funciona
localize-dev translate lee _locales/en/messages.json, envía el description de cada mensaje con él como contexto y escribe _locales/es/messages.json, _locales/pt_BR/messages.json y así sucesivamente, usando los nombres de idioma con guión bajo que usan las extensiones.
Se mantienen los tokens nombrados $COUNT$ y posicionales $1, y cada bloque placeholders de cada mensaje se copia a cada idioma, porque cada archivo de idioma declara el suyo propio.
Antes y después
Salida real de localize-dev translate --locales es en el primer archivo. El nombre de la extensión permanece tal cual, y el bloque placeholders acompaña al mensaje traducido.
{
"extName": { "message": "Tab Tidy", "description": "Extension name in the Chrome Web Store" },
"popupTitle": { "message": "Tidy your tabs" },
"closedTabs": {
"message": "Closed $COUNT$ tabs in $WINDOW$",
"description": "Shown after the user tidies a window",
"placeholders": {
"count": { "content": "$1", "example": "12" },
"window": { "content": "$2", "example": "Work" }
}
}
}{
"extName": {
"message": "Tab Tidy"
},
"popupTitle": {
"message": "Organiza tus pestañas"
},
"closedTabs": {
"message": "Cerradas $COUNT$ pestañas en $WINDOW$",
"placeholders": {
"count": {
"content": "$1",
"example": "12"
},
"window": {
"content": "$2",
"example": "Work"
}
}
}
}Lo que se mantiene intacto
- Tokens
$NAME$y$1, verificados - El bloque
placeholdersde cada mensaje que tenga uno - Carpetas de locales con guiones bajos (
pt_BR,zh_CN) - La sangría del archivo fuente
Errores comunes y cómo se evitan
Traducciones sin sus marcadores de posición
$COUNT$ se llena a partir de placeholders declarado en el mismo archivo de idioma. Sin ellos, el navegador no puede llenarlo, por lo que el bloque se copia en cada traducción.
Carpetas de locales con guiones
Las extensiones usan pt_BR, no pt-BR, para los nombres de las carpetas. Los nuevos idiomas se crean con la ortografía que esperan las extensiones.
Listados de tiendas
El nombre y la descripción en messages.json son lo que muestra la Chrome Web Store en cada idioma. Dales un description para que los nombres de marca permanezcan como están y el resumen quepa en la tienda.
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