|Labs
Заказать демоПлатформа
React (Lingo Compiler)
Альфа
React (MCP)React (i18n)CLI прежней версии (v0)
Устаревшее

Lingo.dev CLI

  • Как это работает
  • Настройка
  • Быстрый старт
  • Монорепозитории

Конфигурация

  • Поддерживаемые форматы
  • i18n.json
  • i18n.lock
  • Поддерживаемые локали

Возможности

  • Существующие переводы
  • Добавление языков
  • Переопределения
  • Примечания для переводчика
  • Ключи перевода
  • Переименование ключей
  • Блокировка ключей
  • Игнорирование ключей
  • Сохранение ключей
  • Извлечение ключей с помощью ИИ

Производительность

  • Крупные проекты
  • Параллельная обработка
  • Оценка стоимости

Повторный перевод

  • Автоматический повторный перевод
  • Повторный перевод
  • Удаление переводов

Эта документация посвящена CLI прежней версии (v0) и считается устаревшей. Текущая версия CLI — v1. См. документацию по текущей версии CLI

Переопределения

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

Как работают переопределения#

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

1

CLI генерирует перевод

json
// locales/es.json (generated)
{ "greeting": "Bienvenido a nuestra plataforma" }
2

Вы переопределяете его вручную

json
// locales/es.json (manually edited)
{ "greeting": "¡Bienvenido a nuestro espacio digital!" }
3

При следующих запусках переопределение сохраняется

bash
npx lingo.dev@latest run
# Your custom translation remains unchanged

Когда переопределения заменяются#

Если исходный контент меняется, CLI определяет новый отпечаток и заново переводит ключ, заменяя ваше переопределение:

json
// locales/en.json (source updated)
{ "greeting": "Welcome to our new platform" }

Новый отпечаток не совпадает с записью в lockfile, поэтому CLI создаёт для этого ключа новый перевод.

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

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

Что дальше#

Переименование ключей
Переименовывайте ключи без потери переводов
Повторный перевод
Запускайте повторный перевод, когда это нужно
i18n.lock
Как lockfile отслеживает состояние
Существующие переводы
Интеграция с существующими файлами переводов

Эта страница была полезной?

Max PrilutskiyMax Prilutskiy·Обновлено 6 дней назад·1 минута чтения