.JSON – Phrase Strings

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

Přípony souborů	.json
Rozšíření API	strings_json
Import	Ano
Export	Ano
Podpora plurálových tvarů	Ano
Podpora pro popis	Ano
Podpora stavu	Ano
Podpora metadat	Ano
Možnosti formátu	ignore_translation_state export_translation_state export_description export_tags export_system_tags export_max_characters_allowed custom_metadata_columns export_use_ordinal_rules

Formát JSON pro Phrase Strings poskytuje strukturovaný způsob ukládání a správy překladů, zahrnující metadata, sledování stavu a integraci pracovních postupů pro lepší funkčnost.

Tento formát zahrnuje metadata, jako jsou podrobnosti o lokalizaci, limity znaků, popisy, typ tvar množného čísla a stavy překladu. Funkce podpory stavu umožňuje lepší sledování průběhu překladu a integraci s automatizovanými pracovními postupy.

Definice polí

Objekt klíče

Objekt klíče obsahuje metadata a nastavení pro každý překladový klíč.

Pole	Požadováno	Typ	Popis
`název`	Ano	Řetězec	Jedinečný identifikátor pro klíč.
`description`	Ne	Řetězec	Stručné vysvětlení účelu klíče.
`plural`	Ne	Booleovský typ	Určuje, zda klíč podporuje plurál.
`use_ordinal_rules`	Ne	Booleovský typ	Indikuje, zda jsou tvary plurálu klíče řadové. Pokud je vynecháno, výchozí hodnota je `false`. Používá se během importu a exportu.
`max_characters_allowed`	Ne	Integer/Null	Maximální povolený počet znaků. `null` znamená bez omezení.
`tags`	Ne	Pole	Kategorizace tags pro filtrování a organizaci.
`metadata`	Ne	Objekt	Ukládá dodatečná metadata jako páry klíč-hodnota. Lze je přidat nebo aktualizovat, ale nelze je odebrat. Chcete-li odebrat metadata, nastavte jejich hodnotu na prázdný řetězec.

Translations Object

Objekt překladů obsahuje lokalizované překlady pro daný klíč.

Pole	Požadováno	Typ	Popis
`kód jazyka`	Ano	Řetězec	Název nebo identifikátor locale, jak je nakonfigurován v Project/Languages. Tato hodnota určuje shodu během importu. Pokud se přesně neshoduje s existujícím názvem jazyka, překlad nebude importován.
`locale_code`	Ne	Řetězec	Kód jazyka daného locale (např. en-US, fr-FR).
`obsah`	Ano	Řetězec/Objekt	Přeložený obsah. Pokud je v množném čísle, objekt mapující tvary množného čísla na základě nastavení `use_ordinal_rules` klíče.
`state`	Ne	Řetězec	Stav překladu. Podporované stavy překladu: nepřeloženo neověřeno přeloženo zkontrolováno

Možnosti formátu

Identifikátor	ignore_translation_state
Typ	boolean
Nahrání	Ano
Stažení	Ne
Výchozí	false
Popis	Pokud je true, ignoruje hodnoty stavu v importovaných překladech, což znamená, že nahraný soubor nepřepíše existující stavy překladů.

Identifikátor	export_translation_state
Typ	boolean
Nahrát	Ne
Stáhnout	Ano
Výchozí	true
Popis	Zahrnuje hodnoty stavu v exportovaných překladech; pokud je nastaveno na false, informace o stavu budou z exportovaného souboru vynechány.

Identifikátor	export_system_tags
Typ	boolean
Nahrát	Ne
Stáhnout	Ano
Výchozí	false
Popis	Identifier export_system_tags Type boolean Upload No Download Yes Default false Description Pokud je true, exportuje systémové tagy spolu s klíči a překlady.

Identifikátor	export_tags
Typ	boolean
Nahrát	Ne
Stáhnout	Ano
Výchozí	false
Popis	Pokud je true, exportuje tagy společně s klíči a překlady.

Identifikátor	export_description
Typ	boolean
Nahrát	Ne
Stáhnout	Ano
Výchozí	true
Popis	Exportuje popis klíče.

Identifikátor	export_max_characters_allowed
Typ	boolean
Nahrát	Ne
Stáhnout	Ano
Výchozí	true
Popis	Exportuje limit znaků klíče společně s klíči a překlady.

Identifikátor	custom_metadata_columns
Typ	hash
Nahrání	Ne
Stáhnout	Ano
Výchozí	[prázdné]
Popis	HashMap hodnot vlastní metadata, které je třeba importovat nebo exportovat: 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 v exportovaném souboru.

Identifikátor	export_use_ordinal_rules
Typ	boolean
Nahrát	Ne
Stáhnout	Ano
Výchozí	false
Popis	Pokud je true, pole `use_ordinal_rules` se zobrazí ve staženém souboru. Pokud stahujete soubory přes UI, použijte odpovídající možnost Přidat typ množného čísla pro každý klíč.

Vzor kódu

{
  "welcome_message": {
    "key": {
      "description": "Zpráva zobrazená na uvítací obrazovce",
      "plural": false,
      "max_characters_allowed": 100,
      "tags": ["UI", "greeting"],
      "metadata": {
        "created_by": "admin",
        "created_at": "2024-06-20T12:34:56Z"
      }
    },
    "translations": [
      {
        "locale": "Angličtina (Spojené státy)",
        "locale_code": "en-US",
        "content": "Vítejte v naší aplikaci!",
        "state": "reviewed"
      },
      {
        "locale": "French (France)",
        "locale_code": "fr-FR",
        "content": "Bienvenue dans notre application !",
        "state": "translated"
      }
    ]
  }
}

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

Použití množného čísla se konfiguruje prostřednictvím pole use_ordinal_rules. Pokud je use_ordinal_rules false nebo není nastaveno, použijí se kardinální pravidla pro množné číslo.

Příklad vstupu

{
  "rank": {
    "use_ordinal_rules": true,
    "values": {
      "one": "1. místo",
      "two": "2. místo",
      "few": "3. místo",
      "other": "%d. místo"
    }
  }