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:
lingo purge --locale de --file locales/en.jsonVergewissere 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.
| Option | Verhalten |
|---|---|
--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-only | Entfernt nur .lingo/lock.json; erfordert --yes und kann nicht mit --file oder --locale kombiniert werden. |
--yes, -y | Fü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.