Übersetzungsschlüssel - Lingo.dev CLI

Einführung

Ein Übersetzungsschlüssel ist eine eindeutige Kennung, die ein Inhaltselement mit den entsprechenden Übersetzungen in verschiedenen Sprachen verbindet. Bei der Konfiguration bestimmter Bucket-Typen können Sie diese Schlüssel verwenden, um bucket-spezifische Funktionen wie Key Locking oder Key Ignoring zu aktivieren.

Benutzerdefinierte Schlüssel

In einigen Dateiformaten müssen Übersetzungsschlüssel explizit definiert werden. Beispielsweise sind in der folgenden JSON-Datei title, description und version die Übersetzungsschlüssel:

{
  "title": "Hello, world!",
  "description": "A simple demo app",
  "version": "1.0.0"
}

Sie haben die vollständige Kontrolle über die Benennung dieser Schlüssel.

Automatisch generierte Schlüssel

In einigen Dateiformaten werden Übersetzungsschlüssel automatisch basierend auf der Struktur der Datei generiert. Dies sind beispielsweise Beispiele für automatisch generierte Schlüssel für eine HTML-Datei:

head/0/0
head/1#content
body/0/0
body/1/0
body/1/1/0

Um einen automatisch generierten Schlüssel für ein bestimmtes Inhaltselement zu identifizieren, durchsuchen Sie die i18n.lock-Datei des Projekts.

Umbenennen von Schlüsseln

Wenn Sie Ihren Code refaktorieren und Schlüssel für eine bessere Organisation umbenennen, erkennt Lingo.dev CLI automatisch, dass der Inhalt identisch ist, und bewahrt vorhandene Übersetzungen. Dies verhindert unnötige Neuübersetzungsarbeit, wenn sich nur die Schlüsselkennung ändert, nicht aber der tatsächliche Inhalt.

Weitere Informationen finden Sie unter Key Renaming.

Sperren von Schlüsseln

Einige Inhalte wie technische Kennungen, Komponentennamen oder Markenbegriffe sollten in allen Sprachen identisch bleiben. Key Locking ermöglicht es Ihnen, bestimmte Schlüssel von der Übersetzungsverarbeitung auszuschließen und stattdessen die Quellwerte direkt in alle Zieldateien zu kopieren.

Weitere Informationen finden Sie unter Key Locking.

Ignorieren von Schlüsseln

Entwicklungs-, Test- oder interne Inhalte müssen oft nicht übersetzt werden und sollten nicht in Produktionsdateien erscheinen. Key Ignoring schließt diese Schlüssel vollständig von der Übersetzungsverarbeitung aus und hält sie vollständig aus den Zieldateien heraus.

Weitere Informationen finden Sie unter Key ignoring.