|
Dokumentation
Demo buchenPlattform
PlattformMCPCLI
APIWorkflows
LeitfädenChangelog

Überblick

  • @lingo.dev/cli

Erste Schritte

  • Schnellstart
  • Konfiguration

Referenz

  • lingo push
  • lingo pull
  • Weitere Befehle
  • lingo purge

Konfiguration

  • Schlüsselsteuerung
  • Formate
  • Sprachen

Leitfäden

  • Eine Sprache hinzufügen
  • Bestehende Übersetzungen
  • Neuübersetzung
  • Hinweise für Übersetzer
  • Runs, Status und Wiederherstellung
  • CI/CD
  • Monorepos
  • Große Projekte

Suchst du die ältere CLI (v0)? Zur Dokumentation der Legacy CLI

Neuübersetzung

lingo push übersetzt nur Inhalte, die sich geändert haben: Jede Quelle wird mit dem Lockfile abgeglichen, und alles, was übereinstimmt, wird übersprungen. Das ist die richtige Standardeinstellung — manchmal willst du Inhalte aber trotzdem neu übersetzen, obwohl der Quelltext identisch ist: etwa nach einem Wechsel des Engine-Modells, nach aktualisierten Anweisungen oder Glossareinträgen oder nach dem Beheben eines Qualitätsproblems.

Dafür gibt es zwei Möglichkeiten: einen Scoped---force-Push oder purge mit anschließendem normalen Push.

Scoped Push erzwingen#

--force übersetzt jedes passende Ziel neu und ignoriert dabei vorhandene Übersetzungen sowie den serverseitigen Cache. Dafür ist ein Scope erforderlich — ein reines lingo push --force wird abgelehnt, damit du nicht versehentlich das gesamte Projekt neu übersetzt.

Eine Datei#

bash
lingo push content/en/landing.mdx --force

Ein Teilbaum#

bash
lingo push 'content/en/**/*.md' --force

Alles#

bash
lingo push --backfill-missing --force --yes

--force fragt vor dem Überschreiben nach; mit --yes überspringst du die Abfrage (CI). Die vollständige Flag-Referenz findest du unter lingo push.

Eine einzelne Sprache neu übersetzen#

push hat kein Flag pro Sprache. Wenn du nur eine Sprache neu erstellen willst, lösche ihre Dateien und fülle sie anschließend wieder auf:

bash
lingo purge --locale fr
lingo push --backfill-missing

purge entfernt die fr-Ziele; --backfill-missing erzeugt danach nur die fehlenden Inhalte neu — die anderen Sprachen bleiben unberührt. Das ist außerdem günstiger als --force, weil alles außer fr ein Cache-Treffer bleibt. Siehe Purge.

Kosten abschätzen, bevor du loslegst#

Jeder Push akzeptiert --estimate: Damit werden die Kosten für den Lauf geschätzt und der Vorgang beendet, ohne zu übersetzen:

bash
lingo push 'content/en/**/*.md' --force --estimate

Schätzungen sind heuristisch und kein verbindliches Angebot — die tatsächlichen Kosten können abweichen.

Wann du neu übersetzen solltest#

SituationAuszuführen
Quelltext geändertNichts — ein normales lingo push übernimmt das
Engine-Modell gewechseltlingo push <scope> --force
Anweisungen / Glossar aktualisiertlingo push <scope> --force oder Purge + Backfill pro Sprache
Schlechte Qualität in einer Sprachelingo purge --locale <code> und danach lingo push --backfill-missing
Komplett neu startenlingo push --backfill-missing --force --yes

War diese Seite hilfreich?

Max PrilutskiyMax Prilutskiy·Aktualisiert vor 10 Tagen·2 Min. Lesezeit