Игнорирование ключей

Обновлено: в прошлом квартале · 1 мин чтения

Устаревшее

Эта документация охватывает устаревший CLI (v0). Актуальная версия — CLI v1. Перейти к актуальной документации CLI

Игнорируемые ключи полностью исключаются из процесса перевода. Они не появляются в целевых файлах — 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

Что дальше#