localize.dev

Docs / Traduire / Extension messages.json

Traduire les fichiers messages.json des extensions

Traduisez _locales/en/messages.json pour les extensions Chrome, Edge et Firefox dans chaque langue, en conservant les tokens $PLACEHOLDER$ et en utilisant les descriptions comme contexte.

Comment ça marche

localize-dev translate lit _locales/en/messages.json, envoie pour chaque message son description comme contexte, et écrit _locales/es/messages.json, _locales/pt_BR/messages.json et ainsi de suite, avec les noms de localisation en underscore utilisés par les extensions.

Les tokens nommés $COUNT$ et positionnels $1 sont conservés, et chaque bloc placeholders de chaque message est copié dans chaque langue, car chaque fichier de langue déclare le sien.

Avant et après

Sortie réelle de localize-dev translate --locales es sur le premier fichier. Le nom de l’extension reste tel qu’il est écrit, et le bloc placeholders accompagne le message traduit.

_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 · espagnol
{
  "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"
      }
    }
  }
}

Ce qui reste intact

  • Jetons $NAME$ et $1, vérifiés
  • Le bloc placeholders de chaque message qui en a un
  • Dossiers de locales avec underscore (pt_BR, zh_CN)
  • L'indentation du fichier source

Erreurs courantes et comment elles sont évitées

Traductions sans leurs espaces réservés

$COUNT$ est rempli à partir de placeholders déclaré dans le même fichier de langue. Sans eux, le navigateur ne peut pas le remplir, donc le bloc est copié avec chaque traduction.

Dossiers de locales avec tiret

Les extensions utilisent pt_BR, pas pt-BR, pour les noms de dossiers. Les nouvelles langues sont créées avec l’orthographe attendue par les extensions.

Listes de magasins

Le nom et la description dans messages.json sont ce que la Chrome Web Store affiche dans chaque langue. Donnez-leur un description pour que les noms de marque restent tels quels et que le résumé s'adapte à la boutique.

Exécuter

Dans le dossier qui contient vos fichiers de langue. Les langues sans fichier en obtiennent un. --dry-run montre ce qui changerait en premier.

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

Ensuite, gardez-le complet dans la CI. Cela ne nécessite pas de clé API et échoue lorsqu'une langue manque de traductions :

npx localize-dev check --only translations

Gratuit pour 1 000 chaînes par mois. Une chaîne compte une fois, peu importe dans combien de langues elle va. Créez un compte gratuit