CLI
Переводите файлы проекта, получайте результаты и поддерживайте исходные каталоги сообщений для приложений React.
CLI Lingo.dev связывает файлы проекта с движком локализации. Вы задаёте пути к исходным файлам и языки перевода, отправляете выбранный контент и получаете переведённые файлы. При следующих запусках CLI обрабатывает изменения, сверяясь с сохранённым исходным состоянием.
@lingo.dev/cli устанавливает исполняемый файл lingo. Начните с раздела «Ваш первый файл» — в нём описаны все шаги от настройки до получения перевода.
Установите актуальную версию @lingo.dev/cli и используйте lingo --version, чтобы зафиксировать версию для проекта. Для lingo.dev@0.138.10 и связанных с ним проектов i18n.json используйте справочник CLI v0.
Выберите удобный способ установки #
Для установки в качестве зависимости проекта с фиксацией в системе контроля версий:
npm install --save-dev @lingo.dev/cli
npx lingo --help
npx lingo --versionЧтобы исполняемый файл был доступен во всей командной оболочке:
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 и кэш» описаны режимы работы и варианты восстановления. В разделе «Команды» перечислены команды для настройки, перевода и поддержки каталогов.