CLI

Переводите файлы проекта, получайте результаты и поддерживайте исходные каталоги сообщений для приложений React.

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

@lingo.dev/cli устанавливает исполняемый файл lingo. Начните с раздела «Ваш первый файл» — в нём описаны все шаги от настройки до получения перевода.

Установите актуальную версию @lingo.dev/cli и используйте lingo --version, чтобы зафиксировать версию для проекта. Для lingo.dev@0.138.10 и связанных с ним проектов i18n.json используйте справочник CLI v0.

Выберите удобный способ установки #

Для установки в качестве зависимости проекта с фиксацией в системе контроля версий:

sh
npm install --save-dev @lingo.dev/cli
npx lingo --help
npx lingo --version

Чтобы исполняемый файл был доступен во всей командной оболочке:

sh
npm install --global @lingo.dev/cli
lingo --help

В этом руководстве lingo вызывается напрямую. При локальной установке вызывайте его через менеджер пакетов. npx @lingo.dev/cli@latest и pnpm dlx @lingo.dev/cli@latest запускают последнюю версию без постоянной установки. Зафиксируйте версию, если CLI должен работать одинаково локально и в CI. В примерах для CI используется Node.js 22.

lingo update автоматически определяет способ установки и использует его. Если нужна конкретная версия, способ установки не распознан или установка временная, используйте менеджер пакетов.

Переводите файлы или извлекайте сообщения #

Для существующих ресурсов настройте файлы, пройдите аутентификацию и подключите движок локализации. Перевод выполняется на сервере. push --wait дожидается результата и скачивает его. Отдельные команды push и pull позволяют получить результат позже.

Для вызовов в исходном коде React команда извлечения локально создаёт JSONC и объявления TypeScript. Она не переводит контент и не устанавливает среду выполнения. Добавьте извлечённый каталог в конфигурацию файлов для перевода, затем загрузите его, следуя рабочему процессу с каталогами React.

Сохраняйте состояние, необходимое для обновлений #

Первая обычная отправка сохраняет исходные файлы побайтово. Дозаполнение создаёт недостающие файлы перевода, а последующие обычные отправки переводят изменения в исходных файлах. Храните .lingo/config.json, .lingo/lock.json и принятые переводы вместе в системе контроля версий. Учётные данные и указатель на последний запуск остаются в домашнем каталоге.

В разделах «Отправка», «Получение» и «Lockfile и кэш» описаны режимы работы и варианты восстановления. В разделе «Команды» перечислены команды для настройки, перевода и поддержки каталогов.