lingo init

Erstelle eine Lokalisierungskonfiguration mit expliziten Angaben zu Quellsprache, Zielsprachen und Katalogpfaden.

lingo init schreibt die Lokalisierungseinstellungen in .lingo/config.json. Verwende den Befehl, um für ein Projekt erstmals die Quellsprache, die Liste der Zielsprachen und die Dateimuster festzulegen. Quelldateien, Zugangsdaten und die Verknüpfung mit der Lokalisierungs-Engine sind davon unabhängig: Die Initialisierung erstellt oder übersetzt diese Ressourcen nicht.

sh
lingo init --source en --targets de,fr --files 'locales/en.json,docs/en/**/*.md' --yes

Öffne die erzeugte Datei und stelle sicher, dass sie nur die vorgesehenen Quellinhalte auswählt. Erstelle anschließend bei Bedarf die entsprechenden Dateien, melde dich an und führe vor der Remote-Übersetzung link aus.

Optionen #

OptionStandardwert oder Wirkung
--source <locale>en bei Übernahme der Standardwerte.
--targets <list>Kommagetrennte Sprachen; de,fr,es mit --yes.
--files <list>Durch Kommas getrennte Muster: locales/<source>.json mit --yes, zum Beispiel locales/en.json.
--messages-path <path>Legt den React-Katalog i18n.messagesPath fest; Standardwert locales.
--types-path <path>Legt die Deklaration i18n.typesPath fest; Standardwert lingo.d.ts.
--forceErsetzt vorhandene Lokalisierungseinstellungen.
--no-agents-mdÜberspringt den Lingo.dev-Block in AGENTS.md und CLAUDE.md.
--yes, -yVerwendet angegebene Werte bzw. Standardwerte ohne Rückfragen.

Ohne --yes werden fehlende Angaben interaktiv abgefragt. Listen werden an Kommas und Leerzeichen aufgeteilt. Wenn ein Muster ein Leerzeichen enthält, füge es daher direkt in .lingo/config.json hinzu. Doppelte Zielsprachen und die Sprache, die exakt der Quellsprache entspricht, werden entfernt. Ist die Zielsprachenliste danach leer, wird sie abgelehnt. Setze Muster in Anführungszeichen, damit die Shell sie nicht expandiert, bevor sie an die CLI übergeben werden.

Init schreibt außerdem einen Lingo.dev-Block in die Datei AGENTS.md des Projekts und erstellt sie, falls sie noch nicht vorhanden ist. Der Block wird auch in eine vorhandene CLAUDE.md geschrieben, es sei denn, diese importiert eine AGENTS.md, die den Block aufnimmt. Der Block weist Coding-Agenten an, vor Lokalisierungsarbeiten npx @lingo.dev/cli agent-guide auszuführen. Text außerhalb der Blockmarkierungen bleibt erhalten. Bei einem späteren Durchlauf wird nur der Text zwischen den Markierungen ersetzt.

Ein bestehendes Projekt neu initialisieren #

Ohne Force bleibt die vorhandene Lokalisierungskonfiguration erhalten: Die Initialisierung schlägt fehl, statt sie zu überschreiben. Mit Force erstellt der Befehl files[] anhand der Muster neu. Erweiterte Eintragsoptionen wie Ausschlüsse, explizite Formate, Ausgabevorlagen und Einstellungen für Schlüssel gehen dabei verloren. Sichere diese Optionen, bevor du Force verwendest, oder bearbeite bei kleineren Änderungen die vorhandene Konfiguration.

Andere Abschnitte auf oberster Ebene bleiben erhalten, einschließlich der Verknüpfung mit der Organisation und der Lokalisierungs-Engine. Standardwerte für Katalogpfade werden nicht in der gespeicherten Konfiguration abgelegt. Ein Force-Durchlauf, der die Standardwerte wiederherstellt, kann daher frühere i18n-Überschreibungen entfernen. Änderungen an Katalogpfaden passen die Muster für Übersetzungsdateien nicht automatisch an.

Die Anleitung für die erste Datei führt von der Konfiguration über die erstmalige Übersetzung bestehender Inhalte bis zu den abgerufenen Zieldateien. Konfiguration dient als Referenz für erweiterte Dateieinträge.