Инструменты разработчика

Переводите файлы, вызывайте API с сервера и отображайте многоязычные приложения с помощью пакетов JavaScript.

Локализация связывает два вида кода: тот, который создаёт переводы, и тот, который их использует. Сервер может запрашивать перевод контента при изменении записи. Процесс сборки может собирать переведённые файлы. А компонент React — читать готовый каталог сообщений вообще без запросов на перевод.

Начните с той части, над которой работаете. В каждом разделе есть пошаговое решение первой задачи, а затем — описание контрактов для дальнейшей работы.

API #

Используйте API, если контент уже хранится на сервере и именно сервер должен решать, когда запрашивать перевод, где его хранить и когда использовать. Отправьте контент в JSON или загруженные файлы как задание на перевод, запустите его и получайте результаты для каждой целевой локали по мере готовности. Движок управляет этапами перевода и проверки.

В руководстве «Как отправить первый запрос» вы отправите небольшой объём данных и сохраните перевод локально. В нём разобраны учётные данные, выбор движка локализации, поля ответа и проверки перед подключением к хранилищу приложения.

CLI #

Используйте CLI, если контент хранится в файлах. Настройте пути к исходным файлам и целевые локали, отправьте выбранные материалы на перевод и загрузите переведённые файлы в проект. CLI сохраняет исходное состояние файлов, чтобы при следующих запусках обрабатывать изменения, а не считать каждый файл новым.

Руководство «Как перевести первый файл» охватывает установку, аутентификацию, настройку и получение перевода. Этот же CLI позволяет извлекать явно заданные сообщения React в каталоги. Извлечение выполняется локально, без запросов на перевод.

JavaScript #

Пакеты JavaScript включают серверные клиенты, средства отображения сообщений в React и маршрутизацию по локалям. Выберите клиент для запросов на перевод или библиотеку для отображения сообщений, которые уже доступны приложению. Для отображения в браузере ключ API перевода не нужен.

В документации по React есть пример локального отображения первого сообщения, а также разделы о загрузке каталогов, грамматических вариантах, форматированном тексте и интеграции с конкретными фреймворками. Согласование локали через URL и отображение переведённого текста — разные задачи. Поэтому справочники по маршрутизации объясняют, как поддерживать соответствие между выбранной локалью и загруженными сообщениями.

Как подключить существующий проект #

В разделе «Форматы» описано, что переводит и восстанавливает каждый обработчик. Проверьте и список форматов инструмента, который вызывает обработчик: если обработчик доступен серверной интеграции, это ещё не значит, что соответствующий формат файлов настроен в CLI.

Для проектов, использующих i18n.json или LingoDotDevEngine, доступны справочники для версий CLI v0 и SDK v0. Пока планируете миграцию, оставайтесь на установленной версии: конфигурация, сохраняемое состояние и возвращаемые значения могут различаться между поколениями.

Для ассистента, который работает с локальными файлами или настройками учётной записи, используйте MCP. Для перевода с подключением к репозиторию, CMS или справочному центру используйте интеграции. Каждое подключение определяет, как запускается работа, какие права используются и куда возвращаются результаты.