Игнорируемые ключи полностью исключаются из процесса перевода. Они не появляются в целевых файлах — CLI пропускает их при поиске контента и никогда не отправляет в систему перевода.
Конфигурация#
Добавьте ignoredKeys в бакет в i18n.json:
json
{
"buckets": {
"json": {
"include": ["locales/[locale].json"],
"ignoredKeys": ["internal/debug", "dev/testData"]
}
}
}Как это работает#
Возьмём такой исходный файл:
json
{
"welcome": "Welcome to our platform",
"internal": {
"debug": "Debug mode enabled",
"testData": "Sample test content"
}
}С "ignoredKeys": ["internal/debug", "internal/testData"] целевой файл на испанском будет выглядеть так:
json
{
"welcome": "Bienvenido a nuestra plataforma"
}Весь раздел internal в целевом файле отсутствует.
Нотация путей ключей#
Используйте прямой слеш (/) для вложенных ключей и звёздочку (*) для шаблонов:
json
{ "ignoredKeys": ["internal/*", "dev/settings"] }Ключи с точками работают естественным образом — dev/api.mock указывает на "api.mock" внутри "dev".
Игнорирование ключей vs. блокировка ключей#
| Игнорирование ключей | Блокировка ключей | |
|---|---|---|
| Появляется в целевых файлах | Нет | Да — с исходным значением |
| Сценарий использования | Отладочный, тестовый и внутренний контент | Названия брендов, технические ID |
