.CSV (Strings)

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

Přípony souborů	.csv
API rozšíření	csv
Import	Ano
Export	Ano
Podpora plurálových tvarů	Ano
Podpora pro popis	Ano
Možnosti formátu Tyto možnosti, které lze specifikovat 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 parametrech dotazu `Nahrát`, `Stáhnout` nebo v konfiguračním souboru `phrase.yml`.	key_index comment_index tag_column max_characters_allowed_column column_separator quote_char header_content_row enable_pluralization export_tags export_max_characters_allowed custom_metadata_columns export_key_id key_id_column

CSV (hodnoty oddělené čárkami) je populární formát souboru používaný především pro přenos dat v různých aplikacích a programech. V CSV souboru je každý řádek datovým záznamem. Každý záznam se skládá z několika polí oddělených čárkami. Před importem se ujistěte, že CSV soubory mají tři pole pro jeden řádek představující zdrojový obsah, překlad a komentáře (volitelné).

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

Možnosti formátu

Identifikátor	key_index
Typ	integer
Nahrání	Ano
Stažení	Ne
Výchozí	[prázdné]
Popis	Index sloupce obsahujícího názvy klíčů. Indexy sloupců začínají na 1.

Identifikátor	comment_index
Typ	integer
Nahrání	Ano
Stažení	Ne
Výchozí	[prázdné]
Popis	Index sloupce obsahujícího popis pro klíč. Indexy sloupců začínají na 1.

Identifikátor	tag_column
Typ	integer
Nahrání	Ano
Stažení	Ne
Výchozí	[prázdné]
Popis	Index sloupce obsahujícího tag pro klíč. Indexy sloupců začínají na 1.

Identifikátor	max_characters_allowed_column
Typ	integer
Nahrání	Ano
Stažení	Ne
Výchozí	[prázdné]
Popis	Index sloupce obsahujícího maximální počet znaků pro klíč. Indexy sloupců začínají na 1.

Identifikátor	column_separator
Typ	řetěz\|ec
Nahrání	Ano
Stažení	Ne
Výchozí	,
Popis	Znak, který se používá k oddělení sloupců.

Identifikátor	quote_char
Typ	řetěz\|ec
Nahrání	Ano
Stažení	Ne
Výchozí	"
Popis	Znak, který se používá k citaci nových řádků a oddělovače sloupců.

Identifikátor	header_content_row
Typ	boolean
Nahrání	Ano
Stažení	Ne
Výchozí	false
Popis	Naznačuje, zda první řádek obsahuje pouze informace o záhlaví a měl by být přeskočen.

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 ID 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	HashMap hodnot vlastní metadata, které je třeba importovat nebo exportovat: Klíč = Název vlastnosti vlastních metadat, jak je definováno ve frázi Strings. Hodnota = Index sloupce (1, 2, 3, atd.), kde se vlastnost nachází v importovaném souboru/kde by měla být vlastnost v exportovaném souboru.

Identifikátor	export_key_id
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	key_id_column
Typ	integer
Nahrání	Ne
Stáhnout	Ano
Výchozí	[prázdné]
Popis	Index sloupce obsahujícího ID pro klíč. Indexy sloupců začínají na 1.

Vzor kódu

boolean_key,"--- true
"
empty_string_translation,""
key_with_description,Check it out! This key has a description! (Alespoň v některých formátech), Toto je úžasný popis pro tento klíč!
key_with_line-break,"This translations contains
a line-break."
nested.deeply.key,"Wow, this key is nested even deeper."
nested.key,This key is nested inside a namespace.
null_translation,
pluralized_key.one, "Only one kitten found."
pluralized_key.other,"Wow, you have %s kittens!"
pluralized_key.zero,"You have no kittens."
sample_collection,"---
- first item
- second item
- third item
"
simple_key,Just a simple key with a simple message.
unverified_key,This translation is not yet verified and waits for it. (V některých formátech také exportujeme tento stav)

Struktura souboru

Typická struktura .CSV souboru:

1 (Key column), 2 (Translation column), 3 (Comment column)
app_title,      My Software Project,    This is the main title
apples.zero,    one apple,              my comment
...

Příklad konfigurace

Příklad pro sekci push v .phrase.yml pro .CSV soubory:

push:
    sources:
        - file: "./multi.csv"
          params:
              update_translations: true
              locale_mapping:
                  en: 2
                  de: 3
              format_options:
                  comment_index: 4
                  tag_column: 5

Plurálové tvary

Tento formát používá pojmenované kategorie k identifikaci různých plurálových tvarů klíče. Pro plurálové tvary jsou vyhrazeny následující kategorie:

.zero | .one | .two | .few | .many | .other

Příklady názvů správně identifikovaných, přetrvávajících a označených plurálových klíčů:

inbox.messages.notification.one
inbox.messages.notification.other

Soubory by měly dodržovat tuto strukturu:

1 (Key column), 2 (Translation column), 3 (Comment column)
messages.zero,  No messages received,
messages.one,   One message received,
messages.other,  %s messages received,