Übersetzungsschlüssel - Lingo.dev CLI

Einführung

Ein Übersetzungsschlüssel ist eine eindeutige Kennung, die einen Inhaltsteil mit seinen entsprechenden Übersetzungen in verschiedenen Sprachen verbindet. Bei der Konfiguration bestimmter Bucket-Typen können Sie diese Schlüssel verwenden, um bucket-spezifische Funktionen wie Schlüsselsperrung oder Schlüsselignorierung zu aktivieren.

Benutzerdefinierte Schlüssel

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

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

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

Automatisch generierte Schlüssel

In einigen Dateiformaten werden Übersetzungsschlüssel basierend auf der Struktur der Datei automatisch generiert. Dies sind beispielsweise 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 einen bestimmten Inhaltsteil 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 die Lingo.dev CLI automatisch, dass der Inhalt derselbe ist, und behält bestehende Übersetzungen bei. Dies verhindert unnötige Neuübersetzungsarbeit, wenn sich nur die Schlüsselkennung ändert, nicht der eigentliche Inhalt.

Weitere Informationen finden Sie unter Schlüsselumbenennung.

Sperren von Schlüsseln

Einige Inhalte wie technische Kennungen, Komponentennamen oder Markenbezeichnungen sollten in allen Sprachen identisch bleiben. Die Schlüsselsperrung 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 Schlüsselsperrung.

Ignorieren von Schlüsseln

Entwicklungs-, Test- oder interne Inhalte benötigen oft keine Übersetzung und sollten nicht in Produktionsdateien erscheinen. Das Ignorieren von Schlüsseln schließt diese Schlüssel vollständig von der Übersetzungsverarbeitung aus und hält sie gänzlich aus Zieldateien heraus.

Weitere Informationen finden Sie unter Schlüsselignorierung.