Schlüssel werden verwendet, um übersetzbare Textzeichenfolgen innerhalb des Softwarecodes zu identifizieren. Dies ermöglicht die Verwendung eines Schlüssels (als Codebezeichnung für eine übersetzbare Zeichenfolge), der von Phrase nur einmal anstelle für jede erforderliche Übersetzung der Zeichenfolge referenziert wird.
Ein Schlüssel kann mehrere Übersetzungen haben, die jeweils einer anderen Sprache des Projekts entsprechen. Die Funktion ist ähnlich der des Primärschlüssels in relationalen Datenbanken, wobei die Übersetzungen ein Attribut des Schlüssels sind. Schlüssel werden in Ressourcen-Dateien gespeichert und dienen zur Identifizierung von Quell- und Zielsprache.
Die Verwendung von Schlüsseln ermöglicht es Lokalisierungsmanagement-Plattformen, übersetzbare Texte den Übersetzern zu präsentieren, ohne den Code präsentieren zu müssen.
Schlüssel müssen normalerweise nicht zu einem Projekt hinzugefügt werden, da sie idealerweise erstellt werden, wenn eine Ressourcen-Datei über den Tab einer Projektseite hochgeladen wird.
Um zu verhindern, dass Schlüssel hochgeladen oder erstellt werden, verwenden Sie die Blockierungs-Schlüssel Funktionalität. Wenn ein blockierter Schlüssel bereits existiert, kann er im Editor nicht übersetzt werden.
Um Schlüssel vom Export auszuschließen, verwenden Sie die Schlüssel ausschließen Funktionalität. Ausgeschlossene Schlüssel können ebenfalls nicht im Editor übersetzt werden.
Schlüssel in einem Projekt können dupliziert werden, indem Sie Mehr/Duplikat Schlüssel im Abschnitt einer Projektseite oder oben im Strings-Editor-Bereich auswählen.
Verschiedene Übersetzungsschlüssel mit denselben Werten über ein oder mehrere Projekte hinweg können verknüpft werden, um Inhaltsaktualisierungen zu automatisieren. Verknüpfte Schlüssel werden verwendet, um Konsistenz über Projekte hinweg sicherzustellen und wiederholte Arbeiten an identischem Inhalt zu vermeiden.
Änderungen an Schlüsseln können im Seitenleisten Aktivitätsfenster im Strings-Editor zurückgesetzt werden.
Hinweis
Beim Arbeiten mit Repositories (GitHub, GitLab usw.) und dem Löschen von Schlüsseln müssen die Schlüssel sowohl aus Phrase als auch aus dem Repository gelöscht werden, um dauerhaft gelöscht zu werden. Dies soll die versehentliche Löschung von Schlüsseln aufgrund von Fehlern oder Unfällen in Phrase oder im Repository verhindern.
In Zeichenfolgen können Schlüssel je nach Format der hochgeladenen Datei unterschiedliche Typen haben:
-
Zeichenfolge (Standard)
Hinweis
Übersetzer können nur Zeichenfolgen-Schlüssel bearbeiten, es sei denn, die -Option ist in den erweiterten Projekt-Einstellungen aktiviert.
-
Array
-
Boolean
-
Markdown
-
Nummer
Der Schlüsseltype wird im -Bereich der Editor-Seitenleiste angezeigt.
Schlüsselnamen müssen innerhalb eines Projekts eindeutig sein.
Es gibt mehrere Strategien zur Benennung von Schlüsseln:
-
Beschreibend
Der Originaltext wird nach Funktion identifiziert. Das kann es schwieriger machen, den Text beim Lesen des Codes zu identifizieren, bleibt jedoch konstant.
Beispiel:
-
Quell-Strings (nicht empfohlen)
Der ursprüngliche Text selbst wird als Schlüssel verwendet, was es einfach macht, die Verwendung des Textes zu identifizieren. Das ist problematisch, da eine Änderung des ursprünglichen Textes die Beziehung zu den Übersetzungen unterbricht.
Beispiel:
Wenn Schlüssel nicht hochgeladen werden, können sie manuell erstellt werden.
Um einen Schlüssel zu erstellen, befolge diese Schritte:
-
Klicke im Tab auf Schlüssel hinzufügen.
Das Fenster Schlüssel hinzufügen öffnet sich.
-
Gib im Tab einen , eine , alle verfügbaren und eine an.
-
Wenn erforderlich, aktiviere Pluralformen im Tab und wähle den Pluralformtyp aus.
-
Wähle bei Bedarf ausgeschlossene Sprachen im Tab aus.
-
Geben Sie technische Details im Tab an, falls erforderlich.
Zum Beispiel ist es möglich, ein Zeichenlimit für Übersetzungen im Feld festzulegen. Wenn festgelegt, wird das Zeichenlimit durch einen Indikator im Strings Editor angezeigt, wenn die Übersetzungen des entsprechenden Schlüssels bearbeitet werden.
-
Klicken Sie auf Speichern.
Der Schlüssel wird dem Projekt hinzugefügt und kann im Tab angezeigt werden.
Das Löschen eines Schlüssels aus dem Editor oder dem Tab löscht alle zugehörigen Übersetzungen dieses Schlüssels und kann nicht rückgängig gemacht werden.
In Projekten mit mehr als 10.000 Schlüsseln werden nicht erwähnte Schlüssel bei weiteren Uploads nicht berechnet. Nicht erwähnte Schlüssel sind Schlüssel, die nicht im aktuellen Upload enthalten sind, aber weiterhin im Projekt existieren.
Das Blockieren verhindert, dass ganze Schlüssel zu einem Projekt hinzugefügt werden; wenn der Name eines blockierten Schlüssels in einer hochgeladenen Datei erscheint, wird dieser Schlüssel weggelassen und nicht zum Projekt hinzugefügt.
Das Blockieren wird verwendet, um Schlüssel aus einem Projekt auszuschließen, sodass sie überhaupt nicht verwaltet werden.
Typischerweise blockierte Schlüssel:
-
Datum- und Zeitformat-Strings.
-
Schlüssel einschließlich Konfigurationen.
-
Schlüssel, die Probleme verursachen, wenn sie mit dem Phrase-Gem verwaltet werden.
Verwalten Sie blockierte Schlüssel in einer separaten Sprachdatei, die nicht verarbeitet oder gewartet wird.
Diese Schlüssel können Probleme verursachen und sollten, wenn sie verwendet werden, beim Erstellen eines Projekts blockiert werden.
-
activemodel.errors* -
number.format* -
nummer.währung* -
number.percentage* -
datetime.prompts*
Um einen Schlüssel zu blockieren, befolgen Sie diese Schritte:
-
Wählen Sie auf einer Projektseite den Tab aus.
-
Klicken Sie auf Schlüssel zur Liste der blockierten Schlüssel hinzufügen.
Das Fenster öffnet sich.
-
Geben Sie einen Namen für den Schlüssel oder einen regulären Ausdruck (Regex) ein und klicken Sie auf Speichern.
Der Schlüssel wird zur Liste hinzugefügt.
Tipp
AI-Chatbots können sehr effektiv beim Generieren und Überprüfen von Regex sein.
Verwenden Sie Tools wie Regex101, um Regex mit verschiedenen Eingaben zu testen.
Schlüssel können später durch Klicken auf geändert oder
gelöscht werden.
Einige Schlüssel müssen möglicherweise von bestimmten Sprachen ausgeschlossen werden und können als ausgeschlossen markiert werden. Diese Schlüssel werden hochgeladen und existieren innerhalb eines Projekts, werden jedoch ignoriert.
Ausgeschlossene Übersetzungen sind:
-
Von dem Export der betreffenden Sprache ausgeschlossen.
-
Von den Berichten der betreffenden Sprache ausgeschlossen.
Wenn der Inhalt leer ist, wird er nicht als nicht übersetzt gezählt.
-
Sichtbar, aber nicht im Übersetzungseditor bearbeitbar.
Ausschlussoptionen:
-
Eine einzelne Übersetzung in einer Sprache im Übersetzungseditor ausschließen.
-
Mehrere Übersetzungen in einer Sprache im Übersetzungseditor ausschließen.
-
Mehrere Übersetzungen ausschließen, indem Sie die Sprachen beim Erstellen oder Bearbeiten des Schlüssels auswählen.
Um einen Schlüssel auszuschließen, befolgen Sie diese Schritte:
-
Klicken Sie auf der Schlüssel-Seite auf
für den Schlüssel, der ausgeschlossen werden soll.
Das Fenster öffnet sich.
-
Wählen Sie die Registerkarte aus.
-
Sprachen für den Ausschluss auswählen.
-
Klicken Sie auf Speichern.
Die Auswahl wird im angegebenen Schlüssel ausgeschlossen.
Schlüssel können auch einzeln oder in großen Mengen aus der Editor-Schlüsselliste ausgeschlossen werden, indem die Schlüssel ausgewählt und das Menü verwendet wird.