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

Как работают ключи перевода в Lingo.dev CLI

Введение

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

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

В некоторых форматах файлов ключи перевода должны быть явно определены. Например, в следующем 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 автоматически определяет, что контент остался тем же, и сохраняет существующие переводы. Это предотвращает ненужную работу по повторному переводу, если изменяется только идентификатор ключа, а не сам контент.

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

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

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

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

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

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

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