i18n.lock Sperrdatei

i18n.lock ist eine Sperrdatei, die Inhalts-Prüfsummen verfolgt, um unnötige Neuübersetzungen zu verhindern und die Leistung der Lingo.dev CLI zu optimieren.

i18n.lock speichert Prüfsummen von Quellinhalten und Übersetzungsschlüsseln, um zu identifizieren, was sich zwischen Übersetzungsdurchläufen geändert hat. Infolgedessen werden nur neue oder modifizierte Inhalte übersetzt, was die Verarbeitungszeit und Übersetzungskosten reduziert.

Struktur der Sperrdatei

i18n.lock verwendet ein strukturiertes YAML-Format zur Speicherung von Inhalts-Prüfsummen:

version: 1
checksums:
  a07974ea09011daa56f9df706530e442:
    key: f8692d39317193acf0e2e47172703c46
  b18975fb19122ebb67g0ef817641f553:
    key: g9703e40428204bdf1f3f58283814d57

Konfigurationselemente:

  • version — Schema-Version der Lockdatei für Migrations-Kompatibilität
  • checksums — Zuordnung von Inhalts-Prüfsummen zu Schlüssel-Prüfsummen, die übersetzte Inhalte verfolgt
  • checksums.[content-hash] — SHA-256-Hash des Quellinhalts, der als eindeutiger Identifikator dient
  • checksums.[content-hash].key — SHA-256-Hash des Übersetzungsschlüssels, der die Erkennung von Schlüsselumbenennungen ermöglicht

Lingo.dev CLI behält bestehende Übersetzungen bei, wenn identische Inhalte mit unterschiedlichen Schlüssel-Prüfsummen erkannt werden. Es erfolgt keine erneute Übersetzung, wodurch die Übersetzungskonsistenz gewahrt bleibt, während Änderungen an der Schlüsselorganisation ermöglicht werden. Lesen Sie mehr über Schlüsselumbenennung.

Workflow-Integration

i18n.lock arbeitet automatisch während der Übersetzungs-Workflows:

Erster Durchlauf — Erstellt Sperrdatei mit initialen Inhalts-Prüfsummen:

npx lingo.dev@latest i18n

# Erstellt i18n.lock mit allen Quellinhalt-Prüfsummen

Sperrdatei neu erstellen — Erstellt die Sperrdatei von Grund auf neu:

npx lingo.dev@latest lockfile --force

# Erstellt i18n.lock mit allen Quellinhalt-Prüfsummen neu

Tipp: Sie können diesen Befehl sicher verwenden, um die Sperrdatei während der Lösung von Merge-Konflikten auf ihren wahren Zustand zurückzusetzen.

Nachfolgende Durchläufe — Verarbeitet nur geänderte Inhalte:

npx lingo.dev@latest i18n

# Vergleicht aktuellen Inhalt mit i18n.lock

# Übersetzt nur neue oder modifizierte Inhalte

Erzwungene Neuübersetzung — Umgeht die Lockfile-Optimierung und übersetzt alle Inhalte neu, wobei die Lockdatei neu erstellt wird:

npx lingo.dev@latest i18n --force

# Ignoriert i18n.lock und übersetzt alle Inhalte neu

Gefrorene Verifizierung — Validiert die Vollständigkeit der Übersetzung:

npx lingo.dev@latest i18n --frozen

# Schlägt fehl, wenn Inhalte übersetzt werden müssen

# Wird in CI/CD verwendet, um vollständige Übersetzungen sicherzustellen

Integration mit Versionskontrolle

i18n.lock muss zusammen mit den Übersetzungsdateien in die Versionskontrolle eingecheckt werden.

Die Lockdatei ist ein wesentlicher Bestandteil des inkrementellen Übersetzungssystems von Lingo.dev CLI, was es für Projekte jeder Größe praktikabel macht.