.XLSX - Tabulka Excel (Strings)

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

Přípony souborů	.xlsx
Rozšíření API	xlsx
Import	Ano
Export	Ano
Podpora plurálových tvarů	Ano
Podpora pro popis	Ano
Možnosti formátu Tyto možnosti mohou být specifikovány při nahrávání a/nebo stahování souboru. V závislosti na metodě nahrávání/stahování (API, CLI, synchronizace repozitáře atd.) mohou být specifikovány v dotazových parametrech `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 souboru pro lokalizaci. I když se rozložení souboru .XLSX může lišit na základě specifických nastavení, obvykle dodržuje konvenci jednoho sloupce 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. Spolu s klíči a překladem mohou být importovány meta-informace jako komentáře, štítky 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 povinný pro 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ězec
Nahrát	Ano
Stáhnout	Ne
Výchozí	[prázdný]
Popis	Sloupec, který obsahuje název/identifikaci klíče.

Identifikátor	comment_column
Typ	řetězec
Nahrát	Ano
Stáhnout	Ne
Výchozí	[prázdný]
Popis	Sloupec, který obsahuje komentář/popis pro klíč.

Identifikátor	tag_column
Typ	řetězec
Nahrát	Ano
Stáhnout	Ne
Výchozí	[prázdný]
Popis	Index sloupce obsahujícího tag pro klíč.

Identifikátor	first_content_row
Typ	integer
Nahrát	Ano
Stáhnout	Ne
Výchozí	1
Popis	Index první řady, která obsahuje obsah překladu.

Identifikátor	enable_pluralization
Typ	boolean
Nahrát	Ano
Stáhnout	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é klíče.

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át	Ano
Stáhnout	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 ve 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át	Ano
Stáhnout	Ano
Výchozí	[prázdný]
Popis	ID/jméno jazyka = Sloupec vlastnosti vlastních metadat, jak je definováno ve 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ář*	tagy*	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

Soubor tabulky potřebuje alespoň sloupec klíče a jeden jazyk, aby mohl být nahrán. Kromě dalších jazyků mohou být přidány následující sloupce pro přidání meta informací:

komentář: pro přidání popisu ke klíči
tagy: pro přidání tagů k jednotlivým klíčům v souboru
max_znaky: 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:
    zdroje:
        - soubor: "./en.xlsx"
          parametry:
              file_format: xlsx
              update_translations: true
              možnosti_formátu:
                  key_name_column: A
                  comment_column: C
                  first_content_row: 2
                  tag_column: D
              locale_mapping:
                  en: B