.XLSX – Tabulka Excel (Strings)

Obsah je strojově přeložen z angličtiny s použitím Phrase Language AI.

Přípony souborů	.xlsx
API rozšíření	xlsx
Import	Ano
Export	Ano
Podpora plurálových tvarů	Ano
Podpora pro popis	Ano
Možnosti formátu Tyto možnosti lze specifikovat při nahrávání a/nebo Stáhnout souboru. V závislosti na metodě nahrát/Stáhnout (API, CLI, Repo sync atd.) je lze specifikovat v parametrech dotaz `nahrát`, `Stáhnout` nebo v konfiguračním souboru `phrase.yml`.	key_name_column comment_column tag_column first_content_row enable_pluralization export_tags export_max_characters_allowed custom_metadata_columns translation_columns

.XLSX je široce používaný formát souborů pro lokalizaci. Ačkoliv se rozvržení souboru .XLSX může lišit na základě konkrétního nastavení, obecně se řídí konvencí jeden sloupec na jazyk. Pro překlad .XLSX poskytněte alespoň sloupec s názvem klíč a jeden sloupec s překladem. Ve výchozím nastavení se předpokládá, že obsah začíná na prvním řádku. Spolu s klíči a překladem lze importovat meta-informace, jako jsou komentář, tag a maximální povolený počet znak pro překlady.

Pokud je nahrán soubor s více listy nebo kartami, bude detekován pouze první list. Uložte listy nebo karty do jednotlivých souborů, pokud je obsah vyžadován pro lokalizaci

Parametr locale_mapping (typu hashmap) je vyžadován k určení, který sloupec v dokumentu odpovídá každému kódu jazyka. Příklady naleznete v příkladu konfiguračního souboru a v dokumentaci API pro nahrávání.

Možnosti formátu

Identifikátor	key_name_column
Typ	řetěz\|ec
Nahrání	Ano
Stažení	Ne
Výchozí	[prázdné]
Popis	Sloupec, který obsahuje název/identifikaci klíč.

Identifikátor	comment_column
Typ	řetěz\|ec
Nahrání	Ano
Stažení	Ne
Výchozí	[prázdné]
Popis	Sloupec, který obsahuje komentář/popis pro klíč.

Identifikátor	tag_column
Typ	řetěz\|ec
Nahrání	Ano
Stažení	Ne
Výchozí	[prázdné]
Popis	Index sloupce obsahujícího tag pro klíč.

Identifikátor	first_content_row
Typ	integer
Nahrání	Ano
Stažení	Ne
Výchozí	1
Popis	Index prvního řádku, který obsahuje obsah překladu.

Identifikátor	enable_pluralization
Typ	boolean
Nahrání	Ano
Stažení	Ne
Výchozí	true
Popis	Umožňuje detekci plurálových klíčů. Všechny odpovídající klíče budou zachovány jako plurálové.

Identifikátor	export_tags
Typ	boolean
Nahrát	Ne
Stáhnout	Ano
Výchozí	false
Popis	Exportuje tagy spolu s klíči a překlady.

Identifikátor	export_max_characters_allowed
Typ	boolean
Nahrát	Ne
Stáhnout	Ano
Výchozí	false
Popis	Exportuje limit znaků klíče spolu s klíči a překlady.

Identifikátor	custom_metadata_columns
Typ	hash
Nahrání	Ano
Stažení	Ano
Výchozí	[prázdné]
Popis	Hashmapa hodnot Vlastní metadata, které je třeba importovat nebo exportovat: Klíč = Název vlastnosti Vlastní metadata, jak je definován v Phrase Strings. Hodnota = Identifikátor sloupce (A, B, C atd.), kde se vlastnost nachází v importovaném souboru/kde by se vlastnost měla nacházet v exportovaném souboru.

Identifikátor	translation_columns
Typ	hash
Nahrání	Ano
Stažení	Ano
Výchozí	[prázdné]
Popis	ID/název jazyk = Sloupec vlastnosti Vlastní metadata, jak je definován v Phrase Strings. Hodnota = Identifikátor sloupce (A, B, C atd.), kde se vlastnost nachází v importovaném souboru/kde by se vlastnost měla nacházet v exportovaném souboru.

Příklad struktury

key_name	en_US	de-DE*	komentář*	Tagy*	max_characters*
app_title	Můj projekt	Mein Projekt	Toto je hlavní název	app, title	30
greeting	Ahoj 'uživatel'!	Hallo 'User'!	Buďte zdvořilí

*nepovinné sloupce

Soubor tabulky potřebuje alespoň sloupec klíč a jeden jazyk, aby jej bylo možné nahrát. Kromě dalších jazyků lze přidat následující sloupce pro přidání metainformací:

komentář: pro přidání popisu ke klíči
tagy: pro přidání tagů k jednotlivým klíčům v souboru
max_characters: pro nastavení limitu znaků pro klíč při nahrání

Příklad konfigurace

Příklad sekce push v souboru .phraseapp.yml pro soubory XLSX.

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