.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

.XLSX je široce používaný formát souborů pro lokalizaci. Ačkoli se rozložení souboru .XLSX může lišit v závislosti na konkrétním nastavení, obecně se řídí konvencí jeden sloupec na jazyk. Chcete-li přeložit .XLSX, zadejte aspoň jeden sloupec s názvem klíče 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áře, tags a maximální povolený počet znaků pro překlady.

Parametr kód jazyka_mapping (typu hashmap) je vyžadován k určení sloupce v dokumentu, který odpovídá jednotlivým kódům jazyka. Viz například příklad konfiguračního souboru a dokumentace API pro uploads.

Možnosti formátu

Identifikátor	key_name_column
Typ	řetěz\|ec
Nahrání	Ano
Stažení	Ne
Výchozí	[empty]
Popis	Sloupec obsahující název/identifikaci klíče.

Identifikátor	comment_column
Typ	řetěz\|ec
Nahrání	Ano
Stažení	Ne
Výchozí	[empty]
Popis	Sloupec obsahující komentář/popis klíče.

Identifikátor	tag_column
Typ	řetěz\|ec
Nahrání	Ano
Stažení	Ne
Výchozí	[empty]
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 obsahujícího 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 tags 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 počtu 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í	[empty]
Popis	Hashmapa hodnot vlastních metadat, které je třeba importovat nebo exportovat: Klíč = Název vlastnosti vlastních metadat definované ve Phrase Strings. Hodnota = identifikátor sloupce (A, B, C atd.), kde je vlastnost v importovaném souboru/kde by měla být ve vyexportovaném souboru.

Příklad struktury

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

*volitelné sloupce

Objednávka nahrání souboru s tabulkou vyžaduje aspoň sloupec s klíčem a jeden jazyk. Kromě přidat dalších jazyků lze přidat následující sloupce a přidat meta informace:

komentář: přidat ke klíči popis
tags: přidat tagy k jednotlivým klíčům v souboru
max_znaky: nastavit limit počtu znaků pro klíč tak, že se nahraje

Příklad konfigurace

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

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