.XLSX - Spreadsheet Excel (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 angegeben werden, wenn eine Datei hochgeladen und/oder heruntergeladen wird. Je nach Upload-/Download-Methode (API, CLI, Repo-Synchronisierung usw.) können sie in Abfrageparametern `Hochladen`, `Herunterladen` oder in der `phrase.yml` Konfigurationsdatei angegeben werden.	key_name_column comment_column tag_spalte first_content_row enable_pluralization export_tags export_max_characters_allowed custom_metadata_columns übersetzungs_spalten

.XLSX ist ein weit verbreitetes Dateiformat für die Lokalisierung. Obwohl das Layout einer .XLSX-Datei je nach spezifischen Einstellungen variieren kann, folgt es im Allgemeinen der Konvention einer Spalte pro Sprache. Um .XLSX zu übersetzen, geben Sie mindestens die Schlüsselname-Spalte und eine Übersetzungsspalte an. Standardmäßig wird angenommen, dass der Inhalt in der ersten Zeile beginnt. Neben den Schlüsseln und der Übersetzung können auch Metainformationen wie Kommentare, Tags und die maximal zulässige Zeichenanzahl für die Übersetzungen importiert werden.

Wenn eine Datei mit mehreren Blättern oder Registerkarten hochgeladen wird, wird nur das erste Blatt erkannt. Speichern Sie Blätter oder Registerkarten in einzelnen Dateien, wenn der Inhalt für die Lokalisierung erforderlich ist.

Der locale_mapping Parameter (vom Typ Hashmap) ist erforderlich, um anzugeben, welche Spalte im Dokument jeder Locale entspricht. Für Beispiele siehe die Konfigurationsdatei und die API-Dokumentation für Uploads.

Format-Optionen

Identifikator	key_name_column
Typ	Zeichenfolge
Hochladen	Ja
Herunterladen	Nein
Standard	[leer]
Beschreibung	Spalte, die den Schlüsselname/Identifikation enthält.

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

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

Identifikator	first_content_row
Typ	integer
Hochladen	Ja
Herunterladen	Nein
Standard	1
Beschreibung	Index der ersten Zeile, die Übersetzungsinhalt 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 Schlüsseln und Übersetzungen.

Identifikator	export_max_characters_allowed
Typ	Boolean
Upload	Nein
Download	Ja
Standard	false
Beschreibung	Exportiert das Schlüsselzeichenlimit zusammen mit Schlüsseln und Übersetzungen.

Identifikator	custom_metadata_columns
Typ	Hash
Hochladen	Ja
Herunterladen	Ja
Standard	[leer]
Beschreibung	Eine Hashmap von benutzerdefinierten Metadaten Werten, die importiert oder exportiert werden müssen: Schlüssel = Name der benutzerdefinierten Metadaten-Eigenschaft, wie in Phrase Strings definiert. Wert = Spaltenbezeichner (A, B, C usw.), wo sich die Eigenschaft in der importierten Datei befindet/wo die Eigenschaft in der exportierten Datei sein sollte.

Identifikator	übersetzungs_spalten
Typ	Hash
Hochladen	Ja
Herunterladen	Ja
Standard	[leer]
Beschreibung	Sprache ID/Name = Spalte der benutzerdefinierten Metadaten-Eigenschaft, wie in Phrase Strings definiert. Wert = Spaltenbezeichner (A, B, C usw.), wo sich die Eigenschaft in der importierten Datei befindet/wo die Eigenschaft in der exportierten Datei sein sollte.

Strukturbeispiel

key_name	en_US	de-DE*	Kommentar*	Tags*	max_characters*
app_title	Mein Projekt	Mein Projekt	Dies ist der Haupttitel	app, title	30
Begrüßung	Hallo 'User'!	Hallo 'User'!	Sei höflich

*optionale Spalten

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

kommentieren: um eine Beschreibung zum Schlüssel hinzuzufügen
tags: um Tags zu einzelnen Schlüsseln in der Datei hinzuzufügen
max_characters: um ein Zeichenlimit für einen Schlüssel beim 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