Unterstützte Formate

Die Lingo.dev CLI verwendet Bucket-Typen, um unterschiedliche Dateiformate zu parsen und zu übersetzen. Jeder Bucket-Typ ist ein eigener Parser für ein bestimmtes Format. Konfiguriere einen oder mehrere Buckets in deiner i18n.json, um festzulegen, welche Dateien die CLI übersetzen soll.

Bucket-Typen#

Ausgabemodi#

Buckets arbeiten in einem von zwei Ausgabemodi:

Separate Dateien pro Sprache – die CLI erstellt für jede Zielsprache eine eigene Datei. Include-Muster müssen den Platzhalter [locale] enthalten:

{
  "buckets": {
    "json": {
      "include": ["locales/[locale].json"]
    }
  }
}

So entstehen locales/en.json, locales/es.json, locales/fr.json usw.

Ändert die Quelldatei – die CLI schreibt Übersetzungen zurück in dieselbe Datei, die auch den Quellinhalt enthält. Der Platzhalter [locale] wird dabei nicht verwendet:

{
  "buckets": {
    "csv": {
      "include": ["translations.csv"]
    }
  }
}

CSV-Dateien speichern in der Regel alle Sprachen als Spalten in einer einzigen Datei. Xcode-.xcstrings-Kataloge und YAML mit Root-Keys funktionieren ähnlich.

Konfigurationsbeispiele#

Web-App mit JSON#

{
  "buckets": {
    "json": {
      "include": ["src/locales/[locale].json"],
      "lockedKeys": ["brand/name"]
    }
  }
}

Dokumentationswebsite mit Markdown#

{
  "buckets": {
    "markdown": {
      "include": ["docs/[locale]/*.md"],
      "exclude": ["docs/[locale]/drafts/*.md"]
    }
  }
}

Mobile App (iOS + Android)#

{
  "buckets": {
    "xcode-xcstrings": {
      "include": ["ios/Localizable.xcstrings"]
    },
    "android": {
      "include": ["android/app/src/main/res/values-[locale]/strings.xml"]
    }
  }
}

Monorepo mit mehreren Formaten#

{
  "buckets": {
    "json": {
      "include": ["apps/web/locales/[locale].json"]
    },
    "mdx": {
      "include": ["packages/docs/content/[locale]/*.mdx"]
    },
    "flutter": {
      "include": ["apps/mobile/lib/l10n/app_[locale].arb"]
    }
  }
}

Bucket-spezifische Funktionen#

Einige Buckets unterstützen zusätzliche Funktionen, die über Include-/Exclude-Muster hinausgehen:

Regeln für Include-Muster#

• Muster sind relativ zum Speicherort der Datei i18n.json
• Verwende [locale] als Platzhalter für Sprachcodes (erforderlich für Buckets mit „separaten Dateien“)
• Ein Sternchen (*) steht für jeden Dateinamen: locales/[locale]/*.json
• Rekursive Muster (**) erfassen Dateien in beliebiger Tiefe: src/**/[locale].json, config/locales/**/[locale].yml. Wenn ein Muster ** verwendet, werden node_modules, .git, dist, build, .next und .turbo standardmäßig ausgeschlossen — ergänze bei Bedarf eigene exclude-Einträge (erfordert CLI 0.135.0+)
• Dateiendungen haben keinen Einfluss auf das Parsing – der Bucket-Typ bestimmt den Parser

Nächste Schritte#