localize.dev

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.

_locales/en/messages.json
{
  "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" }
    }
  }
}
_locales/es/messages.json · español
{
  "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 placeholders de 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,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