Einen unterbrochenen Lokalisierungslauf wiederherstellen

Ermitteln Sie, was der übermittelte Lauf tatsächlich abgeschlossen hat, rufen Sie verfügbare Ergebnisse ab und bewahren Sie lokale Korrekturen, während Sie die verbleibenden Probleme beheben.

Das Schließen des Terminals während lingo push --wait stoppt den Server nicht automatisch. Die Übersetzung kann noch laufen, auf eine Prüfung warten oder bereits abgeschlossen sein. Ermitteln Sie den Status, bevor Sie denselben Inhalt erneut übermitteln.

Diese Anleitung setzt voraus, dass die Arbeit bereits übermittelt wurde. Verwenden Sie für eine neue Korrektur eine gezielte Aktualisierung. Sollen akzeptierte Zielübersetzungen bei regulären Änderungen erhalten bleiben, folgen Sie den Hinweisen zum Erhalt von Übersetzungen.

Nachweise und lokalen Zustand sichern #

Notieren Sie die ausgegebene Lauf-ID, die Quellrevision, die ausgewählten Dateien und Sprachen sowie den letzten bekannten Status. Bewahren Sie den im checkout gespeicherten Laufzustand, das Lockfile und alle lokalen Änderungen an Zielübersetzungen auf. Wenn Sie diese Aufzeichnungen zuerst löschen, können Informationen verloren gehen, die Sie zur Wiederherstellung der Arbeit benötigen.

Untersuchen Sie bei einem Lauf mit zwei Zielsprachen jede Zielübersetzung einzeln. Gehen Sie nicht davon aus, dass der Verlust der Terminalverbindung beide am selben Punkt unterbrochen hat.

Den Abruf vor einem erneuten Start untersuchen #

Verwenden Sie den aufgezeichneten Lauf im checkout, von dem aus Sie die Arbeit übermittelt haben:

bash
lingo pull --dry-run

Damit werden die vorgesehenen lokalen Schreibvorgänge kontrolliert, ohne Dateien zu ändern. Der Befehl kann den Status laufender Arbeit abfragen und melden, ob eine Prüfung aussteht, ein Fehler vorliegt oder Ergebnisse verfügbar sind. Pull schreibt jedes Dokument, sobald alle zugehörigen Sprachen fertig sind. Dokumente, die auf eine menschliche Prüfung warten, bleiben unverändert. Führen Sie den Befehl erneut aus, sobald die Bewerter fertig sind. Führen Sie erforderliche Prüfungen im dafür vorgesehenen Workflow durch, statt den Quellinhalt wiederholt zu übermitteln.

Wenn Ergebnisse bereitstehen, sehen Sie sich zunächst die Konflikte an und rufen Sie die Ergebnisse anschließend ab:

bash
lingo pull

Pull verwendet den lokal aufgezeichneten Zustand und sucht nicht nach beliebigen Läufen von einem anderen Rechner. Übernehmen Sie Übersetzungen, die andernorts per Commit gespeichert wurden, über die Versionsverwaltung. Die Referenz zum Laufzustand und Pull erläutern, welche Dateien die installierte CLI genau verwendet und welche Konfliktregeln gelten.

Fehlgeschlagene Arbeit mit push erneut anstoßen #

Beheben Sie die gemeldete Ursache und wiederholen Sie anschließend den ursprünglichen push mit denselben Argumenten im checkout, von dem aus Sie die Arbeit übermittelt haben. Für eine reguläre Aktualisierung des Quellinhalts:

bash
lingo push --wait

Wenn die Ergebnisse des vorherigen push noch nicht abgerufen wurden und die Anfrage unverändert ist, verwendet push den vorherigen Auftrag erneut, statt dieselbe Arbeit zweimal zu übermitteln. Die Verbindung zu einem noch laufenden Auftrag wird wiederhergestellt, die Ergebnisse eines abgeschlossenen Auftrags werden abgerufen und ein fehlgeschlagener Auftrag wird durch einen neuen Auftrag mit einer neuen ID ersetzt. Dokumente, deren Ergebnisse vor einem Fehler abgerufen wurden, sind bereits im Lockfile verzeichnet. Der erneute Versuch fordert daher nur Arbeit an, die noch fehlt oder sich geändert hat.

Sehen Sie sich nach dem erneuten Versuch die Ergebnisse für die Zielsprachen und die abgerufenen Dateien an. Ermitteln Sie anschließend, was noch offen ist. Bevor Sie fehlende Zieldateien in einem bestehenden Projekt ergänzen, schließen Sie reguläre Aktualisierungen des Quellinhalts für vorhandene Zielübersetzungen ab, rufen Sie die Ergebnisse ab und sehen Sie sie durch. Halten Sie diese Quellrevision unverändert, während Sie fehlende Dateien mit lingo push --backfill-missing --wait ergänzen. Eine Sprache hinzufügen erläutert die Reihenfolge. Geänderte Schlüssel in vorhandenen Dateien benötigen stattdessen die passende reguläre oder gezielte Aktualisierung.

Die Behebung auf den Fehler abstimmen #

Eine fehlende lokale Aufzeichnung ist etwas anderes als ein fehlgeschlagener Serverlauf. Ungültige Inhalte müssen korrigiert werden, bei verweigerter Berechtigung ist Zugriff erforderlich und eine ausstehende Prüfung braucht eine Entscheidung. Stellen Sie bei einer unklaren Netzwerkantwort vor einer erneuten Übermittlung fest, ob der Server die Arbeit angenommen hat.

Ändern Sie den Quellinhalt nicht allein, um einen fehlgeschlagenen Lauf erneut anzustoßen. Bewahren Sie die alte Lauf-ID auf und stellen Sie sicher, dass sich die neu ausgegebene Auftrags-ID davon unterscheidet. Das CLI-Wiederherstellungsverfahren beschreibt, wie Sie die Ergebnisse verifizieren und den Support erreichen, falls derselbe fehlgeschlagene Auftrag zurückgegeben wird.

Bewahren Sie bei Teilergebnissen erfolgreiche Zielübersetzungen auf, deren Prüfung abgeschlossen ist, und führen Sie fehlgeschlagene Zielübersetzungen separat auf. Wenn ein neuer Lauf nötig ist, halten Sie fest, warum er auf den vorherigen folgt oder ihn ersetzt und welche Quellrevision er verwendet. So verhindern Sie, dass ein verspätetes Ergebnis mit einem aktuellen verwechselt wird.

Lokale Abweichungen abgleichen #

Pull kann das Ersetzen einer Zielübersetzung verweigern, wenn sie seit der aufgezeichneten Version geändert wurde. Vergleichen Sie die lokale Änderung und das eingehende Ergebnis anhand ihrer jeweiligen Quellrevisionen. Legen Sie anschließend im Rahmen einer Prüfung die akzeptierte Formulierung fest.

lingo pull --force umgeht diesen Schutz und überschreibt abweichende Zielübersetzungen. Sichern Sie zuerst Ihre lokale Arbeit und entscheiden Sie sich bewusst für das Ersetzen. Schützen Sie bei gemeinsam genutzten Katalogen die gesamte Datei, einschließlich des Quellinhalts und der unveränderten Sprachen.

Mit nutzbaren Ergebnissen abschließen #

Vergleichen Sie die abgerufenen Pfade, Sprachen, Variablen und den Diff. Laden Sie das Ergebnis in der zugehörigen Anwendung oder im Renderer und sehen Sie sich die Bedeutung der Inhalte an. Eine Datei kann abrufbar sein, ohne für die Verwendung freigegeben zu sein.

Bewahren Sie die wiederhergestellte Lauf-ID, die akzeptierte Revision, das Lockfile und die Zielübersetzungen als nächste Ausgangsbasis auf. Die Wiederherstellung ist abgeschlossen, wenn die verbleibenden Fehler geklärt sind und die akzeptierten Ergebnisse dem vorgesehenen Quellinhalt entsprechen – nicht schon dann, wenn ein einzelner Befehl erfolgreich beendet wird.