Lokalisierung statischer Inhalte

Die Lingo.dev CLI übersetzt statische Dateien in deinem Repository – Markdown, MDX, Markdoc, JSON, YAML, Untertitel und mehr – über eine konfigurierte Lokalisierungs-Engine. Zeige einfach auf deine Inhalte, führe sie einmal aus, und du erhältst die übersetzten Dateien direkt neben den Quelldateien.

Unterstützte Inhaltstypen#

Voraussetzungen#

Jeder CLI-Durchlauf schickt Inhalte durch eine Lokalisierungs-Engine – die Konfiguration, die festlegt, welches LLM-Modell, Glossar, welche Markenstimme und welche Anweisungen verwendet werden. Erstelle sie im Lingo.dev-Dashboard und generiere einen API-Schlüssel.

Dokumentationssites#

Die meisten Dokumentations-Frameworks organisieren übersetzte Inhalte in sprachspezifischen Verzeichnissen. Die CLI-Buckets markdown, mdx und markdoc übersetzen diese Dateien und erhalten dabei Frontmatter, Codeblöcke und Komponenten-Syntax.

{
  "$schema": "https://lingo.dev/schema/i18n.json",
  "version": "1.15",
  "locale": {
    "source": "en",
    "targets": ["es", "fr", "de", "ja"]
  },
  "buckets": {
    "markdown": {
      "include": ["docs/[locale]/getting-started.md"]
    },
    "mdx": {
      "include": ["docs/[locale]/setup.mdx"]
    }
  }
}

Passe das Muster include an die Verzeichnisstruktur deines Frameworks an:

Strukturierte Daten#

JSON- und YAML-Dateien werden mit den Buckets json und yaml übersetzt. Verwende gesperrte Schlüssel, damit nicht übersetzbare Werte (IDs, URLs, Konfigurations-Flags) nicht verändert werden.

{
  "$schema": "https://lingo.dev/schema/i18n.json",
  "version": "1.15",
  "locale": {
    "source": "en",
    "targets": ["es", "fr", "de", "ja"]
  },
  "buckets": {
    "json": {
      "include": ["content/[locale].json"],
      "lockedKeys": ["id", "slug", "url"]
    },
    "yaml": {
      "include": ["data/[locale].yaml"]
    }
  }
}

Für YAML-Dateien, die den Sprachcode als Root-Key verwenden (häufig in Rails und Hugo), nutze stattdessen den Bucket yaml-root-key – er liest aus dem Schlüssel der Ausgangssprache und schreibt in die Schlüssel der Zielsprachen innerhalb derselben Datei.

Untertitel#

SRT- und VTT-Untertiteldateien werden mit den Buckets srt und vtt übersetzt. Die CLI erhält alle Zeitangaben, Cue-Indizes und Formatierungs-Tags – übersetzt wird nur der Textinhalt.

{
  "$schema": "https://lingo.dev/schema/i18n.json",
  "version": "1.15",
  "locale": {
    "source": "en",
    "targets": ["es", "fr", "de", "ja"]
  },
  "buckets": {
    "srt": {
      "include": ["subs/[locale]/intro.srt"]
    }
  }
}

Arbeiten mit großen Inhaltsmengen#

Repositories mit statischen Inhalten können Tausende von Dateien enthalten. Die CLI bewältigt das effizient mit drei Mechanismen:

Nächste Schritte#