.XLSX - Excel-Tabellenkalkulation (Strings)

Inhalte werden von Phrase Language AI maschinell aus dem Englischen übersetzt.

Dateierweiterungen	.xlsx
API-Erweiterung	xlsx
Importieren	Ja
Exportieren	Ja
Unterstützung für Pluralformen	Ja
Unterstützung für Beschreibungen	Ja
Format-Optionen Diese Optionen können beim Hochladen und/oder Herunterladen einer Datei angegeben werden. Je nach Methode zum hochladen/Herunterladen (API, CLI, Repo-Sync usw.) können diese in Query-Parametern `hochladen`, `Herunterladen` oder in der Konfigurationsdatei `phrase.yml` angegeben werden.	key_name_column comment_column tag_column first_content_row enable_pluralization export_tags export_max_characters_allowed custom_metadata_columns translation_columns

.XLSX ist ein weit verbreitetes Format für die Lokalisierung. Obwohl das Layout einer .XLSX-Datei je nach spezifischen Einstellungen variieren kann, folgt es im Allgemeinen der Konvention „eine Spalte pro Sprache“. Um .XLSX zu übersetzen, stellen Sie mindestens die Spalte für den Key-Namen und eine Spalte für die Übersetzung bereit. Standardmäßig wird davon ausgegangen, dass der Content in der ersten Zeile beginnt. Zusammen mit den Keys und der Übersetzung können Metainformationen wie Kommentare, Tags und die maximal zulässige Anzahl an Zeichen für die Übersetzungen importiert werden.

Wenn eine Datei mit mehreren Tabellenblättern oder Reitern hochgeladen wird, wird nur das erste Tabellenblatt erkannt. Speichern Sie Tabellen oder Reiter als einzelne Dateien, wenn der Content für die Lokalisierung benötigt wird

Der Parameter locale_mapping (vom Typ Hashmap) ist erforderlich, um anzugeben, welche Spalte im Dokument welcher Sprache entspricht. Beispiele finden Sie in der Konfigurationsdatei und in der API-Dokumentation für Uploads.

Format-Optionen

Identifikator	key_name_column
Typ	Zeichenfolge
Hochladen	Ja
Herunterladen	Nein
Standard	[leer]
Beschreibung	Spalte, die den Key-Namen/die Identifikation enthält.

Identifikator	comment_column
Typ	Zeichenfolge
Hochladen	Ja
Herunterladen	Nein
Standard	[leer]
Beschreibung	Spalte, die einen Kommentar/eine Beschreibung für einen Key enthält.

Identifikator	tag_column
Typ	Zeichenfolge
Hochladen	Ja
Herunterladen	Nein
Standard	[leer]
Beschreibung	Index der Spalte, die ein Tag für den Key enthält.

Identifikator	first_content_row
Typ	integer
Hochladen	Ja
Herunterladen	Nein
Standard	1
Beschreibung	Index der ersten Zeile, die Content für die Übersetzung enthält.

Identifikator	enable_pluralization
Typ	Boolean
Hochladen	Ja
Herunterladen	Nein
Standard	true
Beschreibung	Ermöglicht die Erkennung von pluralisierten Keys. Alle passenden Keys werden als pluralisierte Keys beibehalten.

Identifikator	export_tags
Typ	Boolean
Upload	Nein
Download	Ja
Standard	false
Beschreibung	Exportiert Tags zusammen mit Keys und Übersetzungen.

Identifikator	export_max_characters_allowed
Typ	Boolean
Upload	Nein
Download	Ja
Standard	false
Beschreibung	Exportiert das Zeichenlimit für den Key zusammen mit Keys und Übersetzungen.

Identifikator	custom_metadata_columns
Typ	Hash
Hochladen	Ja
Herunterladen	Ja
Standard	[leer]
Beschreibung	Eine Hashmap von Individuell Metadaten-Werten, die importiert oder exportiert werden müssen: Key = Name der individuellen Metadaten-Eigenschaft, wie in Phrase Strings definiert. Value = Spalten-ID (A, B, C usw.), in der sich die Eigenschaft in der importierten Datei befindet/in der sich die Eigenschaft in der exportierten Datei befinden sollte.

Identifikator	translation_columns
Typ	Hash
Hochladen	Ja
Herunterladen	Ja
Standard	[leer]
Beschreibung	Sprache ID/Name = Spalte der individuellen Metadaten-Eigenschaft, wie in Phrase Strings definiert. Value = Spalten-ID (A, B, C usw.), in der sich die Eigenschaft in der importierten Datei befindet/in der sich die Eigenschaft in der exportierten Datei befinden sollte.

Beispiel für Struktur

key_name	en_US	de-DE*	Kommentar*	Tags*	max_characters*
app_title	Mein Projekt	Mein Projekt	Dies ist der Haupttitel	app, title	30
greeting	Hi 'User'!	Hallo 'User'!	Seien Sie höflich

*optionale Spalten

Die Tabellenkalkulationsdatei benötigt mindestens die Key-Spalte und eine Sprache, um hochgeladen werden zu können. Neben zusätzlichen Sprachen können die folgenden Spalten hinzugefügt werden, um Metainformationen hinzuzufügen:

Kommentar: um dem Key eine Beschreibung hinzuzufügen
Tags: um individuellen Keys in der Datei Tags hinzuzufügen
max_Zeichen: um ein Zeichenlimit für einen Key durch das hochladen festzulegen

Konfigurationsbeispiel

Ein Beispiel für den push Abschnitt in einer .phraseapp.yml für XLSX-Dateien.

push:
    sources:
        - file: \"./en.xlsx\"
          params:
              file_format: xlsx
              update_translations: true
              format_options:
                  key_name_column: A
                  comment_column: C
                  first_content_row: 2
                  tag_column: D
              locale_mapping:
                  en: B