Beim Hochladen einer Datei in ein Projekt werden alle neuen Ressourcen aus dieser Datei extrahiert und in einem Projekt gespeichert. Das Format der hochgeladenen Datei muss nicht dem ursprünglichen Format entsprechen, das für das Projekt festlegen wurde. Wenn Tags für die Gruppierung von Ressourcen bereitgestellt werden, werden diese Tags auf neue Schlüssel angewendet.
Einige Formate, wie z. B. Gettext, bieten zusätzliche wertvolle Meta-Informationen wie Kommentare, Beschreibungen oder Informationen zu Pluralformen. Diese Informationen werden wann und wo immer möglich extrahiert und zusammen mit den zugewiesenen Ressourcen gespeichert, sodass alle wertvollen Informationen aus Lokalisierungsdateien für die weitere Verwendung gespeichert werden können.
Es gibt verschiedene Methoden zum Hochladen von Dateien:
Beim Hochladen via API oder CLI wird bei Dateiformaten, die mehrere Sprachen in einer einzigen Datei enthalten (z. B. Phrase Strings .JSON, .YAML, mehrsprachige .XLSX/.CSV, .XLIFF, .TMX, Genesys JSON), der Sprachbezeichner jeder Übersetzung in der Datei mit einer Projekt-Sprache anhand des Sprachnamens abgeglichen, genau wie auf dem -Tab des Projekts konfiguriert. Sprachcodes (z. B. „en-US“) werden für diesen Match nicht verwendet, es sei denn, diese exakte Zeichenfolge ist auch der konfigurierte Name der Sprache. Wenn der Sprachbezeichner einer Übersetzung mit keinem Sprachnamen im Projekt übereinstimmt, wird der Import ihrer Übersetzungen ohne Fehlermeldung abgebrochen.
-
Standardmäßig wird nur neuer Content extrahiert und vorhandene Schlüssel in einem Lokalisierungsprojekt werden nicht gelöscht oder aktualisiert; durch das Hochladen von Dateien können keine Daten verloren gehen. Wenn das Überschreiben vorhandener Daten erforderlich ist, ersetzen Sie die Projekt-Ressourcen durch Content aus der Lokalisierungsdatei, indem Sie die Option auswählen. Vorhandene Übersetzungen werden mit dem Content der hochgeladenen Lokalisierungsdatei überschrieben.
Diese Option ist auch in der API verfügbar.
Hinweis
Um Datenverlust zu vermeiden, stellen Sie sicher, dass die neuesten Änderungen von Phrase in die Lokalisierungsdatei heruntergeladen werden, bevor Sie diese ändern und erneut mit der Option hochladen.
-
Geben Sie einen eindeutigen Bezeichner (z. B. den Dateipfad) ein, der den hochgeladenen Key-Namen vorangestellt wird. Verwenden Sie ein aussagekräftiges Präfix, das sich auf das Projekt oder die Datei bezieht, um Key-Namen organisiert zu halten.
Zum Beispiel führt ein importierter Key
hello_worldmit dem Präfixproject_zu dem Keyproject_hello_world.Das Key-Präfix stellt sicher, dass Keys mit vorhandenen abgeglichen werden, um Kollisionen zwischen verschiedenen Projekten oder Dateien zu vermeiden.
Diese Option ist auch in der API- und CLI-Schnittstelle verfügbar.
-
Fügen Sie neue Keys hinzu und überschreiben Sie vorhandene mit dem Content aus der hochgeladenen Datei.
-
Aktualisieren Sie Zielsprachen-Übersetzungen nur, wenn der vorhandene Ausgangssprachen-Text in der Standardsprache des Projekts mit dem Ausgangssprachen-Text in der hochgeladenen mehrsprachigen Datei übereinstimmt.
-
Wählen Sie diese Option, wenn das Aktualisieren aller Beschreibungen der Keys aus der hochgeladenen Datei erforderlich ist. Leere Beschreibungen überschreiben vorhandene. Beschreibungen können zusätzliche Informationen für Übersetzer enthalten und helfen dabei, einzelne Keys im Editor zu identifizieren.
-
Um Übersetzungen organisiert zu halten, fügen Sie Keys mehrere Tags mit aussagekräftigen Bezeichnungen hinzu. Wählen Sie diese Option, um zu verhindern, dass neue Keys automatisch mit einem Upload-Tag versehen werden.
-
Wählen Sie diese Option, um neue Keys und Keys mit aktualisierten Übersetzungen beim Hochladen automatisch mit einem Tag zu versehen. Dies hilft dabei, zwischen neuen, aktualisierten und alten Übersetzungs-Strings zu unterscheiden, und stellt sicher, dass nur die relevanten Keys weiterverarbeitet werden.
Diese Option ist auch in der API verfügbar.
-
Geben Sie die Kodierung (z. B. UTF-8) der Datei an oder lassen Sie sie automatisch auswählen (eine automatisch ausgewählte Kodierung kann zu einer falschen Kodierung führen und durch Rückgängigmachen des Uploads rückgängig gemacht werden).
-
-
verhindert, dass Übersetzungen in Nicht-Hauptsprachen beim Aktualisieren von Übersetzungen erneut überprüft werden müssen.
-
behandelt alle hochgeladenen Übersetzungen als geprüft. Diese Option ist verfügbar, wenn der erweiterte Prüf-Workflow aktiviert wurde. Es zeigt an, dass die Keys bereit sind, in die Produktion gesendet zu werden.
-
behandelt alle hochgeladenen Übersetzungen als überprüft.
-
Um Dateien in Strings hochzuladen, folgen Sie diesen Schritten:
-
Stellen Sie vor dem hochladen sicher, dass die Datei basierend auf Typ korrekt formatiert ist.
-
Wählen Sie in einem Projekt Datei hochladen aus dem -Menü aus.
Die Seite öffnet sich.
-
Klicken Sie auf Datei auswählen und wählen Sie eine Datei aus einem Verzeichnis aus.
Die ausgewählte Datei wird dem Feld hinzugefügt.
-
Wählen Sie ein für die Datei aus.
Vorgeschlagene Formate werden basierend auf dem Dateityp zuerst angezeigt.
-
Wählen Sie eine Sprache für den Content der Datei aus der Dropdown-Liste aus.
Wenn diese Information nicht in der Datei selbst enthalten ist, erstellen Sie eine neue Sprache für den Content oder verwenden Sie eine bestehende.
-
Geben Sie optional Tags an, die den neuen Keys zugewiesen werden sollen, sowie weitere Optionen.
-
Klicke auf Speichern.
Der Content wird importiert und in Keys konvertiert.
-
Fehlgeschlagenes hochladen
Wenn eine Datei nicht ordnungsgemäß verarbeitet werden konnte, werden Fehlerdetails bereitgestellt, um bei der Behebung des Fehlers zu helfen.
-
Erfolgreiches hochladen
Nach der erfolgreichen Verarbeitung einer Übersetzungsdatei wird eine Zusammenfassungsseite angezeigt, die einen Überblick über das hochladen gibt, mit Schaltflächen, die zu den nächsten Schritten führen. Klicken Sie auf den hochladen-Tag, um die Datei im Editor zu öffnen.
-
Keys entfernen
Um ein versehentliches Löschen von Keys beim Entfernen von Keys aus einer Lokalisierungsdatei und erneutem hochladen zu verhindern, werden diese Keys nicht automatisch gelöscht.
Um diese Keys zu entfernen, führen Sie diese Schritte aus:
Nicht erwähnte Keys sind Keys, die nicht im aktuellen hochladen enthalten sind, aber noch im Projekt existieren. Durch deren Löschen werden alle Keys und zugehörigen Übersetzungen, die nicht in der hochgeladenen Datei enthalten waren, aus dem Projekt entfernt.
Das Limit für das Löschen nicht erwähnter Keys liegt bei 100.000 Keys. In Projekten, die dieses Limit überschreiten, ist die Option nicht verfügbar.
-
Einen hochladen rückgängig machen
Jedes hochladen löst mehrere Aktionen aus und kann viele Daten innerhalb von Projekten ändern; es ist nicht möglich, ein hochladen zurückzuziehen.
Um Keys zu entfernen, die (fälschlicherweise) durch eine hochgeladene Datei eingeführt wurden, führen Sie diese Schritte aus:
-
Klicken Sie in der hochladen-Zusammenfassung des betroffenen hochladen auf Löschen und wählen Sie aus.
-
Bestätigen Sie die Auswahl.
Alle Keys und zugehörigen Übersetzungen, die durch dieses hochladen erstellt wurden, werden entfernt. Übersetzungen für Keys, die vor dem hochladen existierten, werden nicht entfernt. Um einzelne Übersetzungen zu entfernen, verwenden Sie den Versionsverlauf für jede Übersetzung.
-
Wählen Sie von einer beliebigen Projektseite aus aus dem Menü , um auf das hochladen-Archiv zuzugreifen.
Das Hochlade-Archiv listet alle historischen Uploads in allen möglichen Status auf. Klicken Sie auf das Dropdown , um Uploads nach Status zu filtern (, und/oder ). Um einen bestimmten Upload zu finden, verwenden Sie das Suchfeld oben, um nach Namen zu suchen.
Zugreifen Sie auf detaillierte Upload-Zusammenfassungen betroffener Ressourcen, indem Sie auf einen aufgelisteten Upload klicken. Alle erfolgreichen Uploads werden auch im Aktivitäts-Stream eines Projekt angezeigt.
Sprachdateien können jederzeit aus einem Projekt und in jedes unterstützte Format exportiert werden.
Dateien können aus der Anwendung über API oder CLI exportiert werden.
Dateien können aus dem -Tab eines jeden Projekt heruntergeladen werden, indem Sie diese auswählen und auf Herunterladen (mehrere Dateien) oder die Schaltfläche Weitere Optionen /Herunterladen einer Sprache klicken.
Herunterladen-Optionen werden beim Herunterladen einer Datei im -Fenster mit Tabs für , und angezeigt.
Das Auswählen verschiedener e bietet unterschiedliche Optionen. Weitere Details finden Sie im entsprechenden Artikel über das spezifische Format.
Verwenden Sie optional das Feld im -Tab, um einen individuellen Export-Dateinamen festzulegen, oder lassen Sie es leer, um einen systemdefinierten Namen zu generieren.
-
Wenn beim Hochladen der Datei ein Übersetzungs-Key-Präfix hinzugefügt wurde, wählen Sie diese Option im -Tab, um das Präfix aus den Namen der exportierten Keys zu entfernen:
-
Geben Sie das Präfix ein, um alle Keys herunterzuladen und das angegebene Präfix nach Möglichkeit zu entfernen.
Wichtig
Dies kann zu doppelten Key-Namen führen, wenn andere Keys nach dem Entfernen des Präfixes denselben Namen haben.
-
Wählen Sie bei Bedarf , um nur die Übersetzungs-Keys herunterzuladen, die das angegebene Präfix enthalten, und das Präfix aus der heruntergeladenen Datei zu entfernen.
Diese Option ist auch in der API und der CLI-Schnittstelle verfügbar.
-
Standardmäßig werden übersetzbare Ressourcen als Keys und Werte gespeichert, anstatt die ursprüngliche Dateistruktur beizubehalten. Dies ermöglicht austauschbare Format, ohne an ein Format gebunden zu sein, sowie eine flexible Gruppierung unter Verwendung von Tag.
Einige Frameworks oder Setups erfordern mehrere Ausgangssprache-Dateien, was auch eine zusätzliche Konfiguration erfordert.
Separate Dateien beibehalten
Behalten Sie im Allgemeinen alle Übersetzungen für jede Sprache in einer Datei. Dies macht das Herunterladen von Ressourcen schneller und robuster. Übersetzungen werden in Projekten organisiert gehalten, sodass keine separaten kleinen Dateien erforderlich sind.
Wenn Lokalisierungsdateien in separaten Dateien gepflegt werden müssen, kann ein dateibasierter Workflow verwendet werden, indem die Keys beim hochladen mit Tags versehen werden und die Tags als Referenz beim Herunterladen der übersetzten Keys zurück in die ursprünglichen Dateien verwendet werden. Keys können mehrere Tags tragen und in mehreren Dateien enthalten sein, was Wiederverwendung und Konsistenz sicherstellt. Ein tagbasierter Workflow ist flexibel und ermöglicht die Neuorganisation von Übersetzungsressourcen, ohne dass diese in Projekte hochgeladen werden müssen.
Vergeben Sie für Keys über alle Dateien hinweg eindeutige Namen, um einen reibungslosen Workflow zu gewährleisten. Bei einem Key-Value-basierten Ansatz muss einem Key in jedem Kontext dieselben Werte zugewiesen sein. Einige Frameworks erlauben die Verwendung von nicht eindeutigen Keys über mehrere Dateien hinweg. Einige Formate, wie Symfony, unterstützen Nachrichten-Fachbereiche. Diese Fachbereiche werden anhand des Dateinamens erkannt. Keys werden nicht automatisch durch dateinamenbasierte Fachbereiche begrenzt, aber dies kann durch die Verwendung eines eindeutigen Fachbereich-Präfixes für Keys innerhalb der Datei gelöst werden.
Beispiel für CLI-Konfiguration
Wenn Sie mit CLI arbeiten oder ein Projekt mit einem Repository (z. B. GitHub, GitLab oder Bitbucket) verbinden, legen Sie eine Konfigurationsdatei fest, um Uploads und Downloads zu verwalten.
Für das Beispiel hat ein Projekt mehrere semantisch benannte Übersetzungsdateien für die Ausgangssprache. Zum Beispiel: accounts.en.yml, emails.en.yml usw. Diese semantischen Namen werden über Tags verwaltet.
Konfigurieren Sie die .phrase.yml, um die Organisation der Dateien im Lokalisierungsprojekt widerzuspiegeln und diese mit Tags im Strings Projekt zu verknüpfen, indem Sie den Tag-Platzhalter in den Dateipfad einfügen:
phrase:
access_token: "3d7e6598d955bfcab104c45c40af1b9459df5692ac4c28a17793"
project_id: "23485c9c5dfb15d85b32d9c5f3d2hl54"
file_format: yml
push:
sources:
- file: ./path/to/locales/<tag>.en.yml
params:
locale_id: "abcd1234cdef1234abcd1234cdef1234"
pull:
targets:
# Konten
- file: ./path/to/locales/accounts.<locale_name>.yml
params:
tags: accounts
# E-Mails
- file: ./path/to/locales/emails.<locale_name>.yml
params:
tags: emails
Wichtig
Obwohl dies unterstützt wird, wird es aus Sicherheitsgründen nicht empfohlen, Zugriff-Token innerhalb der Datei zu speichern.
Das Festlegen einer PHRASE_ACCESS_TOKEN Umgebungsvariablen ist sicherer.
Parameter-Tags können im Push-Abschnitt auch anstelle des <tag> Platzhalters verwendet werden.
Die Konfiguration erstellt beim Ausführen eines Push oder beim Auslösen einer Synchronisierung aus einem Repository Schlüssel mit Tags, die auf der Datei basieren, aus der sie stammen. Beim Ausführen von Pull oder beim Auslösen des Export in das Repository werden Schlüssel basierend auf ihren Tags in Dateien gruppiert.
Ein Produkt, eine Website oder eine App wird in eine Reihe verschiedener Sprachen übersetzt, aber in einigen Fällen ist Lokalisierung nicht nur die gewählte Sprache, sondern verschiedene Versionen innerhalb einer Sprache.
Eine weitere Unterscheidung ist erforderlich, wenn:
-
Ein Produkt hat ein anderes Branding in Regionen, in denen dieselbe Sprache gesprochen wird.
-
Ein Produkt wird von verschiedenen Kunden verwendet, die eine White-Label-Lösung verwenden möchten.
-
Sprachvarianten wie einfach, formell oder informell sind erforderlich.
Lokalisierung eines statischen Produkts
Wenn ein Produkt vollständig entwickelt und selten aktualisiert wird, kann eine separate Version des Produkts innerhalb eines Projekts existieren.
-
Bei einem einzelnen Output oder einem kurzfristigen Projekt:
Erstellen Sie einen Branch, arbeiten Sie für die Dauer des Projekts ausschließlich an diesem Branch und Löschen Sie den Branch, wenn Sie fertig sind.
-
Bei einem langfristigen Projekt:
Pflegen Sie ein Duplizieren des bestehenden Projekts. Dies ermöglicht das Einladen und Arbeiten mit Kunden in derselben Organisation, indem ihnen nur Zugriff auf ihr(e) Projekt(e) gewährt wird, während andere Projekte für sie verborgen bleiben.
Lokalisierung eines Projekts mit kontinuierlichen Updates
Wenn ein Produkt ständig mit neuem Content (Keys) aktualisiert wird, ist es schwierig, diese Updates auf mehrere Projekte anzuwenden und sie synchron zu halten. Verwenden Sie dedizierte Sprachen innerhalb eines Projekts, um diese zu pflegen.
Sprachcodes gemäß dem ISO-Standard (z. B. en-US) müssen nicht eindeutig sein, daher können viele Versionen derselben Sprache innerhalb eines Projekts erstellt werden. Unterscheiden Sie zwischen Regionen, Kunden oder Zielgruppen durch die Verwendung eines eindeutigen Sprachnamens.
Nach dem Setup würde jeder neu eingeführte Key in der Standardsprache als nicht übersetzt in den anderen Sprachen erscheinen und entsprechend lokalisiert werden. Wenn Sie mit einem Kunden und dessen Übersetzer(n) zusammenarbeiten, weisen Sie diese gezielt so zu, dass sie nur ihre Sprachversionen bearbeiten können, indem Sie den Sprachzugriff in ihrem User Profil oder der Projekt-User-Verwaltung aktualisieren.
Legen Sie parallele Lokalisierungsprozesse mit Jobs und Review-Workflows innerhalb desselben Projekts fest. Diese Flexibilität erstreckt sich auch auf das Hoch- und Herunterladen von Sprachdateien oder automatisierte Prozesse via API.