Zachované klíče se jednou inicializují zdrojovými hodnotami a pak jsou chráněné před automatickými aktualizacemi. CLI je nikdy nepřepíše – slouží jako zástupné hodnoty pro obsah, který vyžaduje ruční překlad, například právní texty, compliance obsah nebo marketingové slogany.
Konfigurace#
Přidejte preservedKeys do bucketu v souboru i18n.json:
json
{
"buckets": {
"json": {
"include": ["locales/[locale].json"],
"preservedKeys": ["legal/privacy", "legal/terms"]
}
}
}Jak to funguje#
Mějme tento zdrojový soubor:
json
{
"welcome": "Welcome to our platform",
"legal": {
"privacy": "We respect your privacy and protect your data.",
"terms": "By using this service, you agree to our terms."
}
}Při prvním spuštění CLI zkopíruje zachované klíče beze změny a vše ostatní přeloží:
json
// locales/es.json (first run)
{
"welcome": "Bienvenido a nuestra plataforma",
"legal": {
"privacy": "We respect your privacy and protect your data.",
"terms": "By using this service, you agree to our terms."
}
}Jakmile právní část přeložíte ručně, při dalších spuštěních CLI zůstanou vaše překlady beze změny.
Zachování klíčů vs. uzamčení klíčů#
| Zachování klíčů | Uzamčení klíčů | |
|---|---|---|
| Počáteční hodnota | Zdrojová hodnota jako zástupná hodnota | Zdrojová hodnota (vždy) |
| Ruční úpravy | Trvale zachované | Při každém spuštění přepsané zdrojem |
| Případ použití | Právní texty, compliance, ruční překlad | Názvy značek, technická ID |
Notace cesty ke klíči#
Pro vnořené klíče použijte lomítko (/) a pro zástupné znaky hvězdičku (*):
json
{ "preservedKeys": ["legal/*", "marketing/tagline"] }