Uzamykání klíčů

Aktualizováno: minulé čtvrtletí · 1 min čtení

Zastaralé

Tato dokumentace pokrývá starší CLI (v0). Aktuální CLI je v1. Zobrazit aktuální dokumentaci CLI

Uzamčené klíče se bez překladu kopírují ze zdrojového souboru do všech cílových souborů. Lingo.dev CLI je z procesu překladu úplně vynechá a ve všech jazycích zachová jejich původní zdrojové hodnoty.

Konfigurace#

Přidejte lockedKeys do bucketu v souboru i18n.json:

json
{
  "buckets": {
    "json": {
      "include": ["locales/[locale].json"],
      "lockedKeys": ["brand/name", "config/apiUrl", "system/version"]
    }
  }
}

Jak to funguje#

Mějme tento zdrojový soubor:

json
{
  "welcome": "Welcome to our platform",
  "brand": {
    "name": "Lingo.dev"
  },
  "config": {
    "apiUrl": "https://api.example.com"
  }
}

S "lockedKeys": ["brand/name", "config/apiUrl"] bude španělský cílový soubor vypadat takto:

json
{
  "welcome": "Bienvenido a nuestra plataforma",
  "brand": {
    "name": "Lingo.dev"
  },
  "config": {
    "apiUrl": "https://api.example.com"
  }
}

Překládá se jen welcome. Uzamčené klíče si přesně zachovají své zdrojové hodnoty.

Notace cest klíčů#

Pro zacílení vnořených klíčů použijte lomítko (/):

json
{ "lockedKeys": ["system/engine/component"] }

Pro shodu s více klíči použijte hvězdičku (*):

json
{ "lockedKeys": ["navigation/menuItems/*"] }

Klíče s tečkami v názvu fungují přirozeně – modules/ai.translation cílí na klíč "ai.translation" uvnitř "modules".

Uzamykání klíčů vs. ignorování klíčů#

Uzamykání klíčůIgnorování klíčů
Objeví se v cílových souborechAno – se zdrojovou hodnotouNe
PoužitíNázvy značek, technická ID, URLLadicí řetězce, interní příznaky, testovací data

Další kroky#