Zurück

gt@2.11.0

Fernando Aviles avatarFernando Aviles
gt-clicdnpublishfilesjsonmdxyamli18n

Überblick

Die GT CLI kann jetzt beliebige übersetzte Dateitypen im GT CDN veröffentlichen. JSON, MDX, YAML und alle anderen unterstützten Dateitypen können jetzt direkt mit den Befehlen translate, upload und save-local veröffentlicht werden.

Konfiguration

Globales Publish-Flag

Fügen Sie --publish zu jedem unterstützten Befehl hinzu:

npx gt translate --publish

Oder legen Sie dies in gt.config.json fest:

{
  "publish": true
}

Dadurch werden alle übersetzten Dateien (einschließlich GT JSON) im CDN veröffentlicht.

Veröffentlichungssteuerung pro Datei

Sie können einzelne Dateien über die include-Mustersyntax ein- oder ausschließen. Verwenden Sie anstelle einer einfachen Glob-Zeichenfolge ein Objekt mit einem publish-Flag:

{
  "defaultLocale": "en",
  "locales": ["fr", "es"],
  "files": {
    "json": {
      "include": [
        { "pattern": "locales/[locale]/*.json", "publish": true },
        { "pattern": "locales/[locale]/internal/**/*.json", "publish": false }
      ]
    }
  }
}

In diesem Beispiel werden alle JSON-Dateien unter locales/[locale]/ im CDN veröffentlicht, mit Ausnahme der Dateien im Unterverzeichnis internal/.

GT JSON-Veröffentlichungssteuerung

Das interne Format von GT verfügt über ein eigenes Veröffentlichungs-Flag unter dem gt-Schlüssel:

{
  "files": {
    "gt": {
      "output": "public/i18n/[locale].json",
      "publish": true
    }
  }
}

Auflösungsreihenfolge

Für jede Datei ermittelt die CLI in dieser Reihenfolge, ob sie veröffentlicht werden soll:

  1. Explizites Opt-out — die Datei entspricht einem include-Eintrag mit "publish": false → wird nicht veröffentlicht oder aus dem CDN entfernt
  2. Explizites Opt-in — die Datei entspricht einem include-Eintrag mit "publish": true → wird im CDN veröffentlicht
  3. Globaler Fallback — verwendet die publish-Einstellung auf oberster Ebene (standardmäßig false, wenn sie nicht gesetzt ist)

Wenn auf keiner Ebene eine Veröffentlichungskonfiguration gesetzt ist, wird der Veröffentlichungsschritt vollständig übersprungen — es werden keine API-Aufrufe ausgeführt.

Befehle mit Veröffentlichungsfunktion

BefehlVerhalten
gt translateVeröffentlicht nach dem Herunterladen von Übersetzungen
gt uploadVeröffentlicht nach dem Hochladen von Quelldateien
gt save-localVeröffentlicht nach dem Speichern lokaler Änderungen