Ключи переводов

Введение

Ключ перевода — это уникальный идентификатор, который связывает фрагмент контента с его переводами на разные языки. При настройке некоторых типов бакетов вы можете использовать эти ключи для включения специальных функций бакета, таких как блокировка ключей или игнорирование ключей.

Пользовательские ключи

В некоторых форматах файлов ключи переводов нужно указывать явно. Например, в следующем JSON-файле title, description и version являются ключами переводов:

{
  "title": "Hello, world!",
  "description": "A simple demo app",
  "version": "1.0.0"
}

Вы полностью контролируете, как называются эти ключи.

Автоматически сгенерированные ключи

В некоторых форматах файлов ключи переводов генерируются автоматически на основе структуры файла. Вот примеры таких ключей для HTML-файла:

• head/0/0
• head/1#content
• body/0/0
• body/1/0
• body/1/1/0

Чтобы найти автоматически сгенерированный ключ для определённого контента, посмотрите файл проекта i18n.lock.

Переименование ключей

Когда вы рефакторите код и переименовываете ключи для лучшей организации, Lingo.dev CLI автоматически определяет, что контент остался тем же, и сохраняет существующие переводы. Это избавляет от лишней работы по переводу, если меняется только идентификатор ключа, а не сам контент.

Подробнее см. в разделе Переименование ключей.

Блокировка ключей

Некоторые данные, например технические идентификаторы, имена компонентов или брендовые термины, должны оставаться одинаковыми на всех языках. Блокировка ключей позволяет исключить определённые ключи из процесса перевода, копируя исходные значения во все целевые файлы.

Подробнее см. в разделе Блокировка ключей.

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

Контент для разработки, тестирования или внутреннего использования часто не требует перевода и не должен попадать в продакшн-файлы. Игнорирование ключей полностью исключает такие ключи из процесса перевода, чтобы они не попадали в целевые файлы.

Чтобы узнать больше, смотрите Игнорирование ключей.