.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	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 (čárkami oddělené hodnoty) je oblíbený formát souborů 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 na jednom řádku představujícím obsah zdroje, překlad a komentáře (volitelné).

Parametr kódu jazyka_mapping (typu hashmap) je vyžadován k určení sloupce, 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_index
Typ	Celé číslo
Nahrání	Ano
Stažení	Ne
Výchozí	[empty]
Popis	Index sloupce s názvy klíčů. Indexy sloupců začínají na 1.

Identifikátor	comment_index
Typ	Celé číslo
Nahrání	Ano
Stažení	Ne
Výchozí	[empty]
Popis	Index sloupce s popisem klíče. Indexy sloupců začínají na 1.

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

Identifikátor	max_characters_allowed_column
Typ	Celé číslo
Nahrání	Ano
Stažení	Ne
Výchozí	[empty]
Popis	Index sloupce s maximálním počtem 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žije k cenové nabídce 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	Označuje, zda první řádek obsahuje pouze informace v hlavičce, a zda má 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 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	HashMap vlastních metadat, která je třeba importovat nebo exportovat: Klíč = Název vlastnosti vlastních metadat, jak je definována ve Phrase Strings. Hodnota = index sloupce (1, 2, 3 atd.), kde je vlastnost v importovaném souboru/kde by měla být v exportovaném souboru.

Identifikátor	export_key_id
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	key_id_column
Typ	Celé číslo
Nahrání	Ne
Stáhnout	Ano
Výchozí	[empty]
Popis	Index sloupce s ID klíče. Indexy sloupců začínají na 1.

Vzorek 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).To je úžasný popis tohoto klíče!
key_with_line-break,"Tyto překlady obsahují
a line-break."
nested.deeply.key,"Wow, tento klíč je vnořen ještě hlouběji.""nested.deeply.key": "Wow, tento klíč je vnořen ještě hlouběji.",
nested.key,Tento klíč je vnořen do jmenného prostoru.
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,"---
- první položka
- druhá položka
- třetí položka
"
simple_key,Jen jednoduchý klíč s jednoduchou zprávou.
ověřeno_key,Tento překlad ještě není ověřený a čeká na něj.„Tento překlad ještě není ověřený a čeká na něj. (V některých formátech tento stav také stáhnout)

Struktura souboru

Typická struktura souboru .CSV:

1 (sloupec s klíčem), 2 (sloupec s překladem), 3 (sloupec s komentářem)
app_title, Můj softwarový projekt, Toto je hlavní název
apples.zero, jedno jablko, můj komentář
...

Příklad konfigurace

Příklad push sekce souboru .phrase.yml pro soubory ve formátu .CSV:

push:
    sources:
        - soubor: "./multi.csv"
          params:
              update_translations: true
              locale_mapping:
                  cs: 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 mít tuto strukturu:

1 (sloupec s klíčem), 2 (sloupec s překladem), 3 (sloupec s komentářem)
message.zero: "No messages receive,"
message.one, Jedna zpráva přijata,
message.other: %s messages received,