Быстрый старт

Обновлено: в прошлом квартале · 2 мин чтения

Устаревшее

Эта документация охватывает устаревший CLI (v0). Актуальная версия — CLI v1. Перейти к актуальной документации CLI

Начните работать с CLI всего за 5 минут.

Что понадобится

Убедитесь, что у вас установлен Node.js 18.0 или выше. Для проверки выполните node --version.

Установка#

Установите CLI глобально с помощью любого удобного менеджера пакетов:

bash
npm install -g lingo.dev

Проверка установки#

Убедитесь, что CLI установлен корректно:

bash
lingo --version

Вы увидите примерно такой вывод:

plaintext
lingo.dev v0.133.9
Node.js v20.10.0

Инициализация проекта#

Перейдите в директорию проекта и выполните:

bash
cd my-project
lingo init

Эта интерактивная команда поможет:

  1. Подключить аккаунт — авторизоваться с помощью API-ключа
  2. Выбрать проект — использовать существующий или создать новый
  3. Настроить локали — выбрать языки, которые вы хотите поддерживать
  4. Настроить структуру файлов — указать, где хранить файлы переводов

Конфигурация создана

CLI создаст файл i18n.json с вашими настройками. При необходимости его можно изменить позже.

Первый перевод#

Создайте простой файл перевода:

json
{
  "welcome": {
    "title": "Welcome to Lingo.dev",
    "subtitle": "The Localization Engineering Platform"
  },
  "auth": {
    "login": "Log in",
    "logout": "Log out"
  }
}

Запуск перевода#

Переведите контент на все настроенные целевые языки:

bash
lingo run

CLI выполнит следующее:

  • ✅ Найдёт исходные файлы
  • ✅ Вычислит изменения относительно lockfile
  • ✅ Отправит изменённый контент в ваш бэкенд перевода
  • ✅ Сохранит переводы на диск

Режим отслеживания (разработка)#

Во время активной разработки включите режим отслеживания, чтобы автоматически запускать повторный перевод при изменении исходных файлов:

bash
lingo run --watch

Нажмите Ctrl+C, чтобы выйти из режима отслеживания.

Как получить помощь#

Нужна помощь?

bash
# Show help for all commands
lingo --help

# Show help for a specific command
lingo run --help

Присоединяйтесь к нашему сообществу в Discord, чтобы получить поддержку в реальном времени!

Что дальше#