CLI-Befehle

tyndale init

Initialisiert ein neues Tyndale-Projekt. Erstellt tyndale.config.json mit sinnvollen Standardwerten.

npx tyndale init

tyndale auth

Konfiguriert die Zugangsdaten für deinen AI-Provider.

npx tyndale auth

tyndale translate

Extrahiert übersetzbare Strings und erzeugt Übersetzungen für alle konfigurierten Locales.

npx tyndale translate [options]

Flag	Beschreibung
--locale <code>	Übersetzt nur ein bestimmtes Locale
--force	Übersetzt alle Strings erneut, nicht nur Änderungen
--dry-run	Zeigt, was übersetzt würde, ohne Dateien zu schreiben
--token-budget <n>	Token-Budget pro AI-Batch (Standard: 50000)
--concurrency <n>	Maximale Anzahl paralleler Übersetzungssitzungen (automatisch erkannt)

tyndale validate

Prüft, ob alle Locales vollständige, korrekt formatierte Übersetzungen haben. Es werden keine AI-Aufrufe ausgeführt.

npx tyndale validate

Beendet sich mit Code 1, wenn Probleme gefunden werden. Ideal für CI-Pipelines.

tyndale extract

Extrahiert übersetzbare Strings, ohne sie zu übersetzen. Nützlich, um zu prüfen, was an den AI-Provider gesendet wird.

npx tyndale extract

tyndale translate-docs

Übersetzt Dokumentationsdateien (MDX/MD) für jedes unterstützte Framework. Erkennt dein Doku-Framework automatisch oder verwendet die Konfiguration aus tyndale.config.json.

npx tyndale translate-docs [options]

Flag	Beschreibung
--content-dir <path>	Überschreibt das Content-Verzeichnis der Doku
--force	Übersetzt alle Doku-Dateien erneut, nicht nur fehlende Dateien
--concurrency <n>	Maximale Anzahl paralleler Übersetzungssitzungen (automatisch erkannt)

Unterstützte Frameworks: Starlight, Docusaurus, VitePress, MkDocs, Nextra.

translate-docs schreibt .tyndale-docs-state.json im Stammverzeichnis deines Projekts, um Hashes der Quelldokumente zu verfolgen. Committe diese Datei, damit frische Klone unveränderte Doku ohne erneute Übersetzung überspringen können.

tyndale translate-docs setup

Erkennt dein Dokumentations-Framework und speichert die Konfiguration in tyndale.config.json.

npx tyndale translate-docs setup

Durchsucht dein Projekt nach Framework-Hinweisen (Paketabhängigkeiten und Konfigurationsdateien), bestätigt das erkannte Framework und schreibt den Abschnitt docs in deine Konfiguration.

tyndale model

Ändert das für Übersetzungen verwendete AI-Modell.

npx tyndale model