localize.dev

Dokumentation / Übersetzen / Extension messages.json

Übersetzen Sie die Dateien extension messages.json

Übersetzen Sie _locales/en/messages.json für Chrome-, Edge- und Firefox-Erweiterungen in jede Sprache, wobei die $PLACEHOLDER$-Tokens erhalten bleiben und die Beschreibungen als Kontext verwendet werden.

Funktionsweise

localize-dev translate liest _locales/en/messages.json, sendet für jede Nachricht deren description als Kontext und schreibt _locales/es/messages.json, _locales/pt_BR/messages.json usw., mit den Unterstrich-Lokalnamen, die Erweiterungen verwenden.

Benannte $COUNT$- und positionale $1-Tokens werden beibehalten, und jeder Nachrichtens placeholders-Block wird in jede Sprache kopiert, weil jede Sprachendatei ihre eigene erklärt.

Vorher und nachher

Reale Ausgabe von localize-dev translate --locales es in der ersten Datei. Der Name der Erweiterung bleibt wie geschrieben, und der placeholders-Block geht mit der übersetzten Nachricht einher.

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

Was intakt bleibt

  • $NAME$ und $1 Tokens, überprüft
  • Der placeholders-Block jeder Nachricht, die einen hat
  • Unterstrich-Lokale Ordner (pt_BR, zh_CN)
  • Einrückung der Quelldatei

Häufige Fehler und wie sie vermieden werden

Übersetzungen ohne ihre Platzhalter

$COUNT$ wird aus placeholders ausgefüllt, das in derselben Sprachdatei deklariert ist. Ohne sie kann der Browser sie nicht ausfüllen, daher wird der Block bei jeder Übersetzung kopiert.

Getrennte Locale-Ordner mit Bindestrich

Erweiterungen verwenden pt_BR, nicht pt-BR, für Ordnernamen. Neue Sprachen werden mit der Schreibweise erstellt, die Erweiterungen erwarten.

Shop-Listings

Der Name und die Beschreibung in messages.json sind das, was im Chrome Web Store in jeder Sprache angezeigt wird. Geben Sie ihnen ein description, damit Markennamen so bleiben, wie sie geschrieben sind, und die Zusammenfassung in den Store passt.

Ausführen

In dem Ordner, der Ihre Lokalisierungsdateien enthält. Sprachen ohne eine Datei erhalten eine. --dry-run zeigt, was sich zuerst ändern würde.

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

Dann halten Sie es in der CI vollständig. Dies erfordert keinen API-Schlüssel und schlägt fehl, wenn eine Sprache Übersetzungen vermisst:

npx localize-dev check --only translations

Kostenlos für 1.000 Strings pro Monat. Ein String zählt einmal, egal in wie viele Sprachen er übersetzt wird. Erstellen Sie ein kostenloses Konto