Uzamykání klíčů
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 souborech | Ano – se zdrojovou hodnotou | Ne |
| Použití | Názvy značek, technická ID, URL | Ladicí řetězce, interní příznaky, testovací data |