lingo extract

Создавайте исходный JSONC и объявления TypeScript из явных вызовов перевода.

lingo extract присваивает явно заданным сообщениям React идентификаторы в каталоге. Команда сканирует вызовы в TypeScript/TSX, локально записывает исходный JSONC и объявления и сохраняет метаданные, которые связывают каждую запись с исходным кодом. Она не переписывает произвольный JSX и не запрашивает переводы.

В настроенном компоненте React поддерживаемый вызов выглядит так:

tsx
const l = useLingo();
const label = l.text("Place order", { context: "Checkout submit button" });

Запустите извлечение из корня проекта:

sh
lingo extract --src src --source-locale en

Если вы используете пути по умолчанию, проверьте locales/en.jsonc и lingo.d.ts. Исходный каталог хранит значения сообщений, контекст и расположение в исходном коде. В кратком руководстве по React приведены импорты и инструкции по настройке провайдера для компонента.

Параметры #

ПараметрЗначение по умолчанию или действие
--src <path>Каталог для сканирования. По умолчанию src.
--source-locale <locale>Исходная локаль для вывода. По умолчанию en.
--out <path>Задаёт значение вместо i18n.messagesPath из настроек или значения по умолчанию locales.
--types <path>Задаёт значение вместо i18n.typesPath из настроек или значения по умолчанию lingo.d.ts.
--checkПобайтово сравнивает сгенерированные данные с данными на диске без записи.

Пути определяются относительно ближайшего корня проекта. Исходная локаль не наследует sourceLocale из настроек локализации. Чтобы использовать другой язык, укажите его явно. При обычной записи создаются каталоги для объявлений.

Что распознаёт сканер #

Сканер распознаёт text, rich, plural и select у переменных, которым присвоен результат useLingo или createLingo, а также у стандартных получателей вызова l и .l. Он принимает строковые литералы, шаблонные строки без выражений и статические объекты форм.

У динамических сообщений нет стабильного исходного текста для извлечения. При деструктуризации результата фабрики теряется отслеживаемая структура получателя вызова, и сканер выдаёт предупреждение. Файлы объявлений, файлы и каталоги с именами, начинающимися с точки, а также node_modules исключаются. Если файлов TS/TSX нет, команда сообщает об этом и завершается без результата. Успешное завершение процесса ещё не означает, что сообщения найдены.

Проверьте идентификаторы и правила объединения #

Ключи формируются на основе исходного текста и контекста. Изменение формулировки или контекста может привести к созданию нового идентификатора, а подстановка значений во время выполнения — нет. При конфликте ключей извлечение завершается ошибкой. Чтобы устранить конфликт, уточните контекст.

При извлечении данные объединяются с существующим исходным каталогом: текущие значения сохраняются, метаданные контекста и исходного кода обновляются, новые записи добавляются, а отсутствующие сообщения помечаются как осиротевшие. Вывод сортируется, и при одинаковых входных данных результат всегда один и тот же. Проверьте предупреждения, прежде чем считать, что осиротевшее сообщение намеренно удалили из приложения.

Проверьте или переведите каталог #

lingo extract --check побайтово сравнивает каталог и объявления без записи. lingo check дополнительно проверяет контекст, осиротевшие записи и найденные целевые файлы.

Для перевода добавьте фактический путь .jsonc в files[], пройдите аутентификацию, свяжите проект и выполните начальный lingo push --backfill-missing --wait. Для последующих изменений используйте обычный push. Изменение путей извлечения не обновляет конфигурацию файлов автоматически.

Загрузите результат с помощью загрузчика с поддержкой JSONC, соблюдая политику метаданных каталога. Провайдер ожидает набор пар «ключ — строка». Ни сам путь к файлу, ни обычный импорт JSON не выполняют нужное преобразование.