Начните работать с CLI всего за 5 минут.
Что понадобится
Убедитесь, что у вас установлен Node.js 18.0 или выше. Для проверки выполните node --version.
Установка#
Установите CLI глобально с помощью любого удобного менеджера пакетов:
npm install -g lingo.devПроверка установки#
Убедитесь, что CLI установлен корректно:
lingo --versionВы увидите примерно такой вывод:
lingo.dev v0.133.9
Node.js v20.10.0Инициализация проекта#
Перейдите в директорию проекта и выполните:
cd my-project
lingo initЭта интерактивная команда поможет:
- Подключить аккаунт — авторизоваться с помощью API-ключа
- Выбрать проект — использовать существующий или создать новый
- Настроить локали — выбрать языки, которые вы хотите поддерживать
- Настроить структуру файлов — указать, где хранить файлы переводов
Конфигурация создана
CLI создаст файл i18n.json с вашими настройками. При необходимости его можно изменить позже.
Первый перевод#
Создайте простой файл перевода:
{
"welcome": {
"title": "Welcome to Lingo.dev",
"subtitle": "The Localization Engineering Platform"
},
"auth": {
"login": "Log in",
"logout": "Log out"
}
}Запуск перевода#
Переведите контент на все настроенные целевые языки:
lingo runCLI выполнит следующее:
- ✅ Найдёт исходные файлы
- ✅ Вычислит изменения относительно lockfile
- ✅ Отправит изменённый контент в ваш бэкенд перевода
- ✅ Сохранит переводы на диск
Режим отслеживания (разработка)#
Во время активной разработки включите режим отслеживания, чтобы автоматически запускать повторный перевод при изменении исходных файлов:
lingo run --watchНажмите Ctrl+C, чтобы выйти из режима отслеживания.
Как получить помощь#
Нужна помощь?
# Show help for all commands
lingo --help
# Show help for a specific command
lingo run --helpПрисоединяйтесь к нашему сообществу в Discord, чтобы получить поддержку в реальном времени!
