.TXT (Strings)

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

Přípony souborů	.txt, .tsv
Rozšíření API	.txt, .tsv
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 stahování souboru. V závislosti na metodě nahrávání/stahování (API, CLI, Repo sync atd.) mohou být specifikovány v parametrech dotazu `Upload`, `Download` 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

TXT ukládá informace ve formátu prostého textu bez jakýchkoli vložených možností formátování, jako je tučné písmo, kurzíva nebo obrázky.

Parametr locale_mapping (typu hashmap) je vyžadován pro určení, který sloupec v dokumentu odpovídá jednotlivým jazykovým verzím. 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í	\t
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 vložení uvozovek kolem znaků nového řádku 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 uloženy jako klíče v množném čísle.

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 počtu znaků pro 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ích metadat, které je třeba importovat nebo exportovat: Klíč = Název vlastnosti vlastních metadat, jak je definováno v 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.

Vzor kódu

boolean_key    "--- true
"
empty_string_translation    ""
key_with_description    Podívejte se na to! This key has a description! (Alespoň v některých formátech),Toto je úžasný popis pro tento klíč!
key_with_line-break    "Tento překlad obsahuje
a line-break."
nested.deeply.key    "Páni, tento klíč je vnořen ještě hlouběji."
nested.key    Tento klíč je vnořen uvnitř jmenného prostoru.
null_translation    
pluralized_key.one    "Nalezeno pouze jedno kotě."
pluralized_key.other    "Páni, máte %s koťat!"
pluralized_key.zero    "Nemáte žádná koťata."
sample_collection    "---
- first item
- second item
- third item
"
simple_key    Jen jednoduchý klíč s jednoduchou zprávou.
Tento překlad ještě nebyl ověřen a čeká na ověření. (V některých formátech také exportujeme tento stav)

Struktura souboru

Typická struktura souboru .TXT:

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

Příklad konfigurace

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

push:
    sources:
        - file: "./multi.txt"
          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 následovat tuto strukturu:

1 (sloupec klíč)    2 (sloupec překlad)    3 (sloupec komentář)
messages.zero    Žádné zprávy nebyly přijaty,
messages.one    Jedna zpráva byla přijata,
messages.other    %s zpráv bylo přijato,