CLI Lingo.dev nabízí čtyři nastavení na úrovni klíčů, která určují, jak se jednotlivé překladové klíče během zpracování chovají. Každé slouží k jinému účelu:
| Nastavení | Konfigurační pole | Chování |
|---|---|---|
| Uzamčení klíče | lockedKeys | Zkopíruje zdrojové hodnoty do všech cílových jazyků bez překladu. V cílových souborech se klíče objeví se stejnými hodnotami. |
| Ignorování klíče | ignoredKeys | Klíče úplně vyloučí ze zpracování. V cílových souborech se neobjeví. |
| Zachování klíče | preservedKeys | Jednou inicializuje klíče ze zdroje a pak je chrání před automatickými aktualizacemi. Hodí se pro obsah, který vyžaduje ruční překlad. |
| Přejmenování klíče | Automatické | Rozpozná, kdy došlo k přejmenování klíčů, a zachová existující překlady. Není potřeba žádná konfigurace. |
Kdy použít co#
Uzamkněte klíč, když hodnota musí zůstat stejná ve všech jazycích – názvy značek, technické identifikátory, konfigurační hodnoty:
{ "lockedKeys": ["brand/name", "config/apiUrl"] }Ignorujte klíč, když se v cílových souborech nemá vůbec objevit – ladicí řetězce, interní příznaky, testovací data:
{ "ignoredKeys": ["internal/debug", "dev/testData"] }Zachovejte klíč, když vyžaduje ruční překlad – právní texty, obsah související se souladem s předpisy, marketingové texty, které vyžadují lidskou kontrola:
{ "preservedKeys": ["legal/privacy", "legal/terms"] }Přejmenování je automatické – CLI rozpozná, když se klíč změní, ale jeho obsah zůstane stejný, a zachová stávající překlad bez nutnosti přeložit ho znovu.
Zápis cest ke klíčům#
Všechna pole klíčů používají pro vnořené cesty lomítko (/) a pro zástupné znaky hvězdičku (*):
{
"lockedKeys": ["brand/name"],
"ignoredKeys": ["internal/*"],
"preservedKeys": ["legal/privacy/full"]
}S klíči, které obsahují tečky v názvu, se pracuje přirozeně – lomítko odděluje úrovně hierarchie, takže modules/ai.translation správně cílí na klíč "ai.translation" uvnitř objektu "modules".
