lingo init
Создайте конфигурацию локализации с явно заданными исходной и целевыми локалями и путями к каталогам.
lingo init записывает настройки локализации в .lingo/config.json. Используйте эту команду, чтобы впервые задать для проекта исходную локаль, список целевых локалей и шаблоны файлов. Исходные файлы, учётные данные и привязка к движку локализации настраиваются отдельно: инициализация не создаёт и не переводит эти ресурсы.
lingo init --source en --targets de,fr --files 'locales/en.json,docs/en/**/*.md' --yesОткройте созданный файл и убедитесь, что он выбирает только нужный исходный контент. Затем при необходимости создайте исходные файлы, войдите в систему и выполните link перед удалённым переводом.
Параметры #
| Параметр | Значение по умолчанию или действие |
|---|---|
--source <locale> | en при выборе значений по умолчанию. |
--targets <list> | Локали через запятую. С --yes — de,fr,es. |
--files <list> | Шаблоны, разделённые запятыми: locales/<source>.json с --yes, например locales/en.json. |
--messages-path <path> | Задаёт каталог React i18n.messagesPath. По умолчанию — locales. |
--types-path <path> | Задаёт объявление i18n.typesPath. По умолчанию — lingo.d.ts. |
--force | Заменяет существующие настройки локализации. |
--no-agents-md | Пропускает блок Lingo.dev в AGENTS.md и CLAUDE.md. |
--yes, -y | Использует переданные значения или значения по умолчанию без запросов. |
Без --yes CLI запрашивает недостающие параметры. Элементы списков разделяются запятыми и пробелами, поэтому шаблон с пробелом нужно добавить вручную в .lingo/config.json. Повторяющиеся целевые локали и локаль, точно совпадающая с исходной, удаляются. Если после этого список целевых локалей пуст, CLI его отклоняет. Заключайте шаблоны в кавычки, чтобы оболочка не раскрывала их до передачи в CLI.
Команда инициализации также записывает блок Lingo.dev в AGENTS.md проекта. Если файла нет, команда создаёт его. Блок добавляется и в существующий CLAUDE.md, кроме случаев, когда этот файл импортирует AGENTS.md, куда и записывается блок. В блоке агентам для работы с кодом даётся указание запускать npx @lingo.dev/cli agent-guide перед локализацией. Текст за пределами маркеров блока сохраняется, а при повторном запуске заменяется только текст между ними.
Повторная инициализация существующего проекта #
Без принудительного режима команда сохраняет существующую конфигурацию локализации и завершает инициализацию с ошибкой, не перезаписывая её. В принудительном режиме команда заново создаёт files[] на основе шаблонов. При этом расширенные параметры записей — исключения, явно заданные форматы, шаблоны вывода и настройки ключей — теряются. Сохраните их перед принудительным запуском. Если изменения небольшие, отредактируйте существующую конфигурацию.
Другие корневые разделы, в том числе привязка к организации и движку локализации, сохраняются. Пути к каталогам не записываются в конфигурацию, если используются значения по умолчанию. Поэтому принудительный запуск с возвратом к этим значениям может удалить ранее заданные переопределения i18n. Изменение путей к каталогам не меняет шаблоны файлов перевода автоматически.
Пошаговая инструкция для первого файла описывает путь от настройки до первоначального заполнения переводов и получения файлов целевых локалей. В разделе Конфигурация вы найдёте справочную информацию о расширенных настройках записей файлов.