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:
{
"buckets": {
"json": {
"include": ["locales/[locale].json"],
"lockedKeys": ["brand/name", "config/apiUrl", "system/version"]
}
}
}Jak to funguje#
Mějme tento zdrojový soubor:
{
"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:
{
"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 (/):
{ "lockedKeys": ["system/engine/component"] }Pro shodu s více klíči použijte hvězdičku (*):
{ "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 |
