lingo init

Создайте конфигурацию локализации с явно заданными исходной и целевыми локалями и путями к каталогам.

lingo init записывает настройки локализации в .lingo/config.json. Используйте эту команду, чтобы впервые задать для проекта исходную локаль, список целевых локалей и шаблоны файлов. Исходные файлы, учётные данные и привязка к движку локализации настраиваются отдельно: инициализация не создаёт и не переводит эти ресурсы.

sh
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. Изменение путей к каталогам не меняет шаблоны файлов перевода автоматически.

Пошаговая инструкция для первого файла описывает путь от настройки до первоначального заполнения переводов и получения файлов целевых локалей. В разделе Конфигурация вы найдёте справочную информацию о расширенных настройках записей файлов.