.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 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.) mohou být specifikovány v parametrech dotaz `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é čárkou) je populární formát souboru používaný primárně pro přenos dat v různých aplikacích a programech. V souboru CSV je každý řádek datový záznam. Každý záznam se skládá z několika polí oddělených čárkami. Před import zajistěte, aby soubory CSV měly tři pole pro jeden řádek představující zdroj obsah, překlad a komentáře (volitelné).

Parametr locale_mapping (typu hashmap) je vyžadován pro určení, který sloupec v dokument odpovídá každému kód 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_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í od 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í od 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í od 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í od 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á pro cenová nabídka 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	Indikuje, zda první řádek obsahuje pouze informace 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	Stáhne ID klíč 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 stáhnout: klíč = Název vlastnosti Vlastní metadata, jak je definováno v Phrase Strings. Hodnota = Index sloupce (1, 2, 3 atd.), kde se vlastnost nachází v importovaném souboru/kde by vlastnost měla být ve staženém souboru.

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

Identifikátor	key_id_column
Typ	integer
Nahrát	Ne
Stáhnout	Ano
Výchozí	[prázdné]
Popis	Index sloupce obsahujícího ID pro klíč. Indexy sloupců začínají od 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. (In some formats we also export this status)

Struktura souboru

Typická struktura souboru .CSV:

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
...

Vzor konfigurace

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

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,