lingo purge

Sieh dir vorab an, welche Zieldateien gelöscht und welche Lockfile-Einträge dabei entfernt werden.

lingo purge dient dazu, abgeleitete Zieldateien gezielt zu entfernen. Im normalen Dateimodus werden die ausgewählten Pfade als Vorschau angezeigt; --yes führt die Löschung aus. Mit --file oder --locale werden nur die ausgewählten Ziele und ihre Lockfile-Einträge entfernt. Die Ausgangsstände der Quellen und die Einträge anderer Ziele bleiben erhalten. Ohne Filter wird auch das gesamte Projekt-Lockfile entfernt.

Vorschau für ein reguläres Ziel #

Bei einer JSON-Struktur mit separaten Dateien:

sh
lingo purge --locale de --file locales/en.json

Vergewissere dich, dass das angezeigte Ziel tatsächlich die Datei ist, die du löschen möchtest und nicht mehr benötigst. Sichere akzeptierte Ergebnisse, bevor du --yes hinzufügst. Falls die erneute Generierung später fehlschlägt, sind die Dateien bereits gelöscht.

OptionVerhalten
--locale <locale>Mehrfach verwendbarer Zielfilter; verwendet standardmäßig die konfigurierten Ziele. Die Quellsprache wird nicht zugelassen.
--file <value>Mehrfach verwendbarer Quellpfadfilter oder konkreter Quellpfad für Glob-Einträge.
--lockfile-onlyEntfernt nur .lingo/lock.json; erfordert --yes und kann nicht mit --file oder --locale kombiniert werden.
--yes, -yFührt die Löschung aus, statt eine Vorschau im Dateimodus anzuzeigen.

Abgeleitete Pfade außerhalb des Projektstammverzeichnisses werden nicht zugelassen. Das gilt auch für Pfade, die über einen symbolischen Link aus diesem Verzeichnis heraus oder in .git führen; purge meldet sie auch ohne --yes. Auch Dateien innerhalb des Projektstammverzeichnisses können wertvolle Quelldaten oder gemeinsam genutzte Daten enthalten. Sieh dir daher nicht nur ihren Speicherort an, sondern auch, wofür sie verwendet werden.

Dateiauswahl #

Purge leitet Pfade aus konkreten konfigurierten Quellen und konkreten --file-Werten ab. Konfigurierte Glob-Muster werden übersprungen, sofern keine konkreten Quellpfade angegeben werden. Bei konkreten Konfigurationseinträgen filtert --file nach Teilzeichenfolgen; eine allgemeine Glob-Auflösung findet nicht statt.

Purge überspringt Ziele, deren Pfad mit dem Quellpfad identisch ist, und meldet, dass ihre Übersetzungen in der Quelldatei liegen. Gemeinsam genutzte XCStrings-Kataloge verwenden diese Struktur, daher kann purge keine einzelne Sprache daraus entfernen. Verwende stattdessen den Workflow zur Korrektur von String-Katalogen.

Lockfile-Änderungen #

Ein gefilterter purge-Aufruf entfernt die ausgewählten Zieleinträge auch dann, wenn die entsprechenden Zieldateien bereits fehlen. Die Quell-Hashes bleiben erhalten, sodass ausstehende Quelländerungen bei einem späteren Push weiterhin in andere Sprachen übernommen werden können. Ist das Lockfile fehlerhaft, stoppt der gefilterte purge-Aufruf, bevor Ziele gelöscht werden. Stelle das Lockfile wieder her oder repariere es, bevor du den Aufruf erneut ausführst.

Ungefilterte Aufrufe von lingo purge --yes und lingo purge --lockfile-only --yes entfernen das gesamte Lockfile. Wenn nur das Lockfile entfernt werden soll, ist ohne --yes eine Bestätigung erforderlich; die normale Dateivorschau wird dann nicht angezeigt.

Ein fehlendes Lockfile verändert die Planung inkrementeller Aktualisierungen, garantiert aber keine neu generierten Modellergebnisse: Die serverseitige Wiederverwendung erfolgt unabhängig davon. Verwende bei gewöhnlichen fehlenden Dateien backfill. Verwende für veraltete React-Einträge clean. Beginne bei unterbrochenen Arbeiten mit recovery und behalte dabei den noch verfügbaren Zustand bei.