.XLSX - Spreadsheet 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	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 souboru pro lokalizaci. Ačkoli se rozložení souboru .XLSX může lišit na základě specifických nastavení, obvykle dodržuje konvenci jeden sloupec na jazyk. Pro překlad .XLSX poskytněte alespoň sloupec s názvem klíče a jeden sloupec pro překlad. Ve výchozím nastavení se předpokládá, že obsah začíná v prvním řádku. Kromě klíčů a překladů mohou být importovány také meta-informace, jako jsou komentáře, tagy a maximální povolený počet znaků pro překlady.

Pokud je nahrán soubor s více listy nebo záložkami, bude detekován pouze první list. Uložte listy nebo záložky do jednotlivých souborů, pokud je obsah potřebný 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. Pro příklady se podívejte na příklad konfiguračního souboru a API dokumentaci 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 klíče/identifikaci.

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	celé číslo
Nahrání	Ano
Stažení	Ne
Výchozí	1
Popis	Index prvního řádku, který obsahuje překladový obsah.

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ích metadat, které je třeba importovat nebo exportovat: Klíč = Název vlastnosti vlastních metadat, jak je definováno v Phrase Strings. Hodnota = Identifikátor sloupce (A, B, C, atd.), kde se vlastnost nachází v importovaném souboru/kde by měla být vlastnost v exportovaném souboru.

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

Příklad struktury

key_name	en_US	de-DE*	komentář*	tags*	max_characters*
app_title	Můj projekt	Můj projekt	Toto je hlavní název	aplikace, název	30
pozdrav	Ahoj 'uživateli'!	Ahoj 'uživateli'!	Buďte zdvořilí

*volitelné sloupce

Tabulka musí mít alespoň sloupec klíč a jeden jazyk, aby mohla být nahrána. Kromě dalších jazyků lze přidat následující sloupce pro přidání meta informací:

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

Příklad konfigurace

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

push:
    sources:
        - soubor: "./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